././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.9681354 Sphinx-4.3.2/0000755000076600000240000000000000000000000012333 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/AUTHORS0000644000076600000240000000773100000000000013413 0ustar00tkomiyastaffSphinx is written and maintained by Georg Brandl . Substantial parts of the templates were written by Armin Ronacher . Other co-maintainers: * Takayuki Shimizukawa * Daniel Neuhäuser <@DasIch> * Jon Waltman <@jonwaltman> * Rob Ruana <@RobRuana> * Robert Lehmann <@lehmannro> * Roland Meister <@rolmei> * Takeshi Komiya <@tk0miya> * Jean-François Burnol <@jfbu> * Yoshiki Shibukawa <@shibu_jp> * Timotheus Kampik - <@TimKam> Other contributors, listed alphabetically, are: * Alastair Houghton -- Apple Help builder * Alexander Todorov -- inheritance_diagram tests and improvements * Andi Albrecht -- agogo theme * Jakob Lykke Andersen -- Rewritten C++ domain * Henrique Bastos -- SVG support for graphviz extension * Daniel Bültmann -- todo extension * Marco Buttu -- doctest extension (pyversion option) * Nathan Damon -- bugfix in validation of static paths in html builders * Etienne Desautels -- apidoc module * Michael Droettboom -- inheritance_diagram extension * Charles Duffy -- original graphviz extension * Kevin Dunn -- MathJax extension * Josip Dzolonga -- coverage builder * Buck Evan -- dummy builder * Matthew Fernandez -- todo extension fix * Hernan Grecco -- search improvements * Horst Gutmann -- internationalization support * Martin Hans -- autodoc improvements * Zac Hatfield-Dodds -- doctest reporting improvements, intersphinx performance * Doug Hellmann -- graphviz improvements * Tim Hoffmann -- theme improvements * Antti Kaihola -- doctest extension (skipif option) * Dave Kuhlman -- original LaTeX writer * Blaise Laflamme -- pyramid theme * Chris Lamb -- reproducibility fixes * Thomas Lamb -- linkcheck builder * Łukasz Langa -- partial support for autodoc * Martin Larralde -- additional napoleon admonitions * Ian Lee -- quickstart improvements * Robert Lehmann -- gettext builder (GSOC project) * Dan MacKinlay -- metadata fixes * Martin Mahner -- nature theme * Will Maier -- directory HTML builder * Jacob Mason -- websupport library (GSOC project) * Glenn Matthews -- python domain signature improvements * Kurt McKee -- documentation updates * Roland Meister -- epub builder * Ezio Melotti -- collapsible sidebar JavaScript * Bruce Mitchener -- Minor epub improvement * Daniel Neuhäuser -- JavaScript domain, Python 3 support (GSOC) * Julien Palard -- Colspan and rowspan in text builder * Christopher Perkins -- autosummary integration * Benjamin Peterson -- unittests * \T. Powers -- HTML output improvements * Jeppe Pihl -- literalinclude improvements * Rob Ruana -- napoleon extension * Vince Salvino -- JavaScript search improvements * Stefan Seefeld -- toctree improvements * Gregory Szorc -- performance improvements * Taku Shimizu -- epub3 builder * Antonio Valentino -- qthelp builder, docstring inheritance * Filip Vavera -- napoleon todo directive * Pauli Virtanen -- autodoc improvements, autosummary extension * Eric N. Vander Weele -- autodoc improvements * Stefan van der Walt -- autosummary extension * Thomas Waldmann -- apidoc module fixes * John Waltman -- Texinfo builder * Barry Warsaw -- setup command improvements * Sebastian Wiesner -- image handling, distutils support * Michael Wilson -- Intersphinx HTTP basic auth support * Matthew Woodcraft -- text output improvements * Joel Wurtz -- cellspanning support in LaTeX * Hong Xu -- svg support in imgmath extension and various bug fixes * Stephen Finucane -- setup command improvements and documentation * Daniel Pizetta -- inheritance diagram improvements * KINEBUCHI Tomohiko -- typing Sphinx as well as docutils * Adrián Chaves (Gallaecio) -- coverage builder improvements * Lars Hupfeldt Nielsen - OpenSSL FIPS mode md5 bug fix Many thanks for all contributions! There are also a few modules or functions incorporated from other authors and projects: * sphinx.util.jsdump uses the basestring encoding from simplejson, written by Bob Ippolito, released under the MIT license * sphinx.util.stemmer was written by Vivake Gupta, placed in the Public Domain ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1639903081.0 Sphinx-4.3.2/CHANGES0000644000076600000240000107356300000000000013345 0ustar00tkomiyastaffRelease 4.3.2 (released Dec 19, 2021) ===================================== Bugs fixed ---------- * #9917: C and C++, parse fundamental types no matter the order of simple type specifiers. Release 4.3.1 (released Nov 28, 2021) ===================================== Features added -------------- * #9864: mathjax: Support chnaging the loading method of MathJax to "defer" via :confval:`mathjax_options` Bugs fixed ---------- * #9838: autodoc: AttributeError is raised on building document for functions decorated by functools.lru_cache * #9879: autodoc: AttributeError is raised on building document for an object having invalid __doc__ atribute * #9844: autodoc: Failed to process a function wrapped with functools.partial if :confval:`autodoc_preserve_defaults` enabled * #9872: html: Class namespace collision between autodoc signatures and docutils-0.17 * #9868: imgmath: Crashed if the dvisvgm command failed to convert equation * #9864: mathjax: Failed to render equations via MathJax v2. The loading method of MathJax is back to "async" method again Release 4.3.0 (released Nov 11, 2021) ===================================== Dependencies ------------ * Support Python 3.10 Incompatible changes -------------------- * #9649: ``searchindex.js``: the embedded data has changed format to allow objects with the same name in different domains. * #9672: The rendering of Python domain declarations is implemented with more docutils nodes to allow better CSS styling. It may break existing styling. * #9672: the signature of :py:meth:`domains.py.PyObject.get_signature_prefix` has changed to return a list of nodes instead of a plain string. * #9695: ``domains.js.JSObject.display_prefix`` has been changed into a method ``get_display_prefix`` which now returns a list of nodes instead of a plain string. * #9695: The rendering of Javascript domain declarations is implemented with more docutils nodes to allow better CSS styling. It may break existing styling. * #9450: mathjax: Load MathJax via "defer" strategy Deprecated ---------- * ``sphinx.ext.autodoc.AttributeDocumenter._datadescriptor`` * ``sphinx.writers.html.HTMLTranslator._fieldlist_row_index`` * ``sphinx.writers.html.HTMLTranslator._table_row_index`` * ``sphinx.writers.html5.HTML5Translator._fieldlist_row_index`` * ``sphinx.writers.html5.HTML5Translator._table_row_index`` Features added -------------- * #9639: autodoc: Support asynchronous generator functions * #9664: autodoc: ``autodoc-process-bases`` supports to inject reST snippet as a base class * #9691: C, added new info-field ``retval`` for :rst:dir:`c:function` and :rst:dir:`c:macro`. * C++, added new info-field ``retval`` for :rst:dir:`cpp:function`. * #9618: i18n: Add :confval:`gettext_allow_fuzzy_translations` to allow "fuzzy" messages for translation * #9672: More CSS classes on Python domain descriptions * #9695: More CSS classes on Javascript domain descriptions * #9683: Revert the removal of ``add_stylesheet()`` API. It will be kept until the Sphinx-6.0 release * #2068, add :confval:`intersphinx_disabled_reftypes` for disabling interphinx resolution of cross-references that do not have an explicit inventory specification. Specific types of cross-references can be disabled, e.g., ``std:doc`` or all cross-references in a specific domain, e.g., ``std:*``. * #9623: Allow to suppress "toctree contains reference to excluded document" warnings using :confval:`suppress_warnings` Bugs fixed ---------- * #9630: autodoc: Failed to build cross references if :confval:`primary_domain` is not 'py' * #9644: autodoc: Crashed on getting source info from problematic object * #9655: autodoc: mocked object having doc comment is warned unexpectedly * #9651: autodoc: return type field is not generated even if :confval:`autodoc_typehints_description_target` is set to "documented" when its info-field-list contains ``:returns:`` field * #9657: autodoc: The base class for a subclass of mocked object is incorrect * #9607: autodoc: Incorrect base class detection for the subclasses of the generic class * #9755: autodoc: memory addresses are shown for aliases * #9752: autodoc: Failed to detect type annotation for slots attribute * #9756: autodoc: Crashed if classmethod does not have __func__ attribute * #9757: autodoc: :confval:`autodoc_inherit_docstrings` does not effect to overriden classmethods * #9781: autodoc: :confval:`autodoc_preserve_defaults` does not support hexadecimal numeric * #9630: autosummary: Failed to build summary table if :confval:`primary_domain` is not 'py' * #9670: html: Fix download file with special characters * #9710: html: Wrong styles for even/odd rows in nested tables * #9763: html: parameter name and its type annotation are not separated in HTML * #9649: HTML search: when objects have the same name but in different domains, return all of them as result instead of just one. * #7634: intersphinx: references on the file in sub directory are broken * #9737: LaTeX: hlist is rendered as a list containing "aggedright" text * #9678: linkcheck: file extension was shown twice in warnings * #9697: py domain: An index entry with parens was registered for ``py:method`` directive with ``:property:`` option * #9775: py domain: Literal typehint was converted to a cross reference when :confval:`autodoc_typehints='description'` * #9708: needs_extension failed to check double-digit version correctly * #9688: Fix :rst:dir:`code`` does not recognize ``:class:`` option * #9733: Fix for logging handler flushing warnings in the middle of the docs build * #9656: Fix warnings without subtype being incorrectly suppressed * Intersphinx, for unresolved references with an explicit inventory, e.g., ``proj:myFunc``, leave the inventory prefix in the unresolved text. Release 4.2.0 (released Sep 12, 2021) ===================================== Features added -------------- * #9445: autodoc: Support class properties * #9479: autodoc: Emit a warning if target is a mocked object * #9560: autodoc: Allow to refer NewType instances with module name in Python 3.10 or above * #9447: html theme: Expose the version of Sphinx in the form of tuple as a template variable ``sphinx_version_tuple`` * #9594: manpage: Suppress the title of man page if description is empty * #9445: py domain: ``:py:property:`` directive supports ``:classmethod:`` option to describe the class property * #9524: test: SphinxTestApp can take ``builddir`` as an argument * #9535: C and C++, support more fundamental types, including GNU extensions. Bugs fixed ---------- * #9608: apidoc: apidoc does not generate a module definition for implicit namespace package * #9504: autodoc: generate incorrect reference to the parent class if the target class inherites the class having ``_name`` attribute * #9537, #9589: autodoc: Some objects under ``typing`` module are not displayed well with the HEAD of 3.10 * #9487: autodoc: typehint for cached_property is not shown * #9509: autodoc: AttributeError is raised on failed resolving typehints * #9518: autodoc: autodoc_docstring_signature does not effect to ``__init__()`` and ``__new__()`` * #9522: autodoc: PEP 585 style typehints having arguments (ex. ``list[int]``) are not displayed well * #9481: autosummary: some warnings contain non-existing filenames * #9568: autosummary: summarise overlined sectioned headings correctly * #9600: autosummary: Type annotations which contain commas in autosummary table are not removed completely * #9481: c domain: some warnings contain non-existing filenames * #9481: cpp domain: some warnings contain non-existing filenames * #9456: html search: abbreation marks are inserted to the search result if failed to fetch the content of the page * #9617: html search: The JS requirement warning is shown if browser is slow * #9267: html theme: CSS and JS files added by theme were loaded twice * #9585: py domain: ``:type:`` option for :rst:dir:`py:property` directive does not create a hyperlink * #9576: py domain: Literal typehint was converted to a cross reference * #9535 comment: C++, fix parsing of defaulted function parameters that are function pointers. * #9564: smartquotes: don't adjust typography for text with language-highlighted ``:code:`` role. * #9512: sphinx-build: crashed with the HEAD of Python 3.10 Release 4.1.2 (released Jul 27, 2021) ===================================== Incompatible changes -------------------- * #9435: linkcheck: Disable checking automatically generated anchors on github.com (ex. anchors in reST/Markdown documents) Bugs fixed ---------- * #9489: autodoc: Custom types using ``typing.NewType`` are not displayed well with the HEAD of 3.10 * #9490: autodoc: Some objects under ``typing`` module are not displayed well with the HEAD of 3.10 * #9436, #9471: autodoc: crashed if ``autodoc_class_signature = "separated"`` * #9456: html search: html_copy_source can't control the search summaries * #9500: LaTeX: Failed to build Japanese document on Windows * #9435: linkcheck: Failed to check anchors in github.com Release 4.1.1 (released Jul 15, 2021) ===================================== Dependencies ------------ * #9434: sphinxcontrib-htmlhelp-2.0.0 or above * #9434: sphinxcontrib-serializinghtml-1.1.5 or above Bugs fixed ---------- * #9438: html: HTML logo or Favicon specified as file not being found on output Release 4.1.0 (released Jul 12, 2021) ===================================== Dependencies ------------ * Support jinja2-3.0 Deprecated ---------- * The ``app`` argument of ``sphinx.environment.BuildEnvironment`` becomes required * ``sphinx.application.Sphinx.html_theme`` * ``sphinx.ext.autosummary._app`` * ``sphinx.util.docstrings.extract_metadata()`` Features added -------------- * #8107: autodoc: Add ``class-doc-from`` option to :rst:dir:`autoclass` directive to control the content of the specific class like :confval:`autoclass_content` * #8588: autodoc: :confval:`autodoc_type_aliases` now supports dotted name. It allows you to define an alias for a class with module name like ``foo.bar.BazClass`` * #9175: autodoc: Special member is not documented in the module * #9195: autodoc: The arguments of ``typing.Literal`` are wrongly rendered * #9185: autodoc: :confval:`autodoc_typehints` allows ``'both'`` setting to allow typehints to be included both in the signature and description * #4257: autodoc: Add :confval:`autodoc_class_signature` to separate the class entry and the definition of ``__init__()`` method * #8061, #9218: autodoc: Support variable comment for alias classes * #3014: autodoc: Add :event:`autodoc-process-bases` to modify the base classes of the class definitions * #9272: autodoc: Render enum values for the default argument value better * #9384: autodoc: ``autodoc_typehints='none'`` now erases typehints for variables, attributes and properties * #3257: autosummary: Support instance attributes for classes * #9358: html: Add "heading" role to the toctree items * #9225: html: Add span tag to the return typehint of method/function * #9129: html search: Show search summaries when html_copy_source = False * #9307: html search: Prevent corrections and completions in search field * #9120: html theme: Eliminate prompt characters of code-block from copyable text * #9176: i18n: Emit a debug message if message catalog file not found under :confval:`locale_dirs` * #9414: LaTeX: Add xeCJKVerbAddon to default fvset config for Chinese documents * #9016: linkcheck: Support checking anchors on github.com * #9016: linkcheck: Add a new event :event:`linkcheck-process-uri` to modify URIs before checking hyperlinks * #6525: linkcheck: Add :confval:`linkcheck_allowed_redirects` to mark hyperlinks that are redirected to expected URLs as "working" * #1874: py domain: Support union types using ``|`` in info-field-list * #9268: py domain: :confval:`python_use_unqualified_type_names` supports type field in info-field-list * #9097: Optimize the parallel build * #9131: Add :confval:`nitpick_ignore_regex` to ignore nitpicky warnings using regular expressions * #9174: Add ``Sphinx.set_html_assets_policy`` to tell extensions to include HTML assets in all the pages. Extensions can check this via ``Sphinx.registry.html_assets_policy`` * C++, add support for - ``inline`` variables, - ``consteval`` functions, - ``constinit`` variables, - ``char8_t``, - ``explicit()`` specifier, - digit separators in literals, and - constraints in placeholder type specifiers, aka. adjective syntax (e.g., ``Sortable auto &v``). * C, add support for digit separators in literals. * #9166: LaTeX: support containers in LaTeX output Bugs fixed ---------- * #8872: autodoc: stacked singledispatches are wrongly rendered * #8597: autodoc: a docsting having metadata only should be treated as undocumented * #9185: autodoc: typehints for overloaded functions and methods are inaccurate * #9250: autodoc: The inherited method not having docstring is wrongly parsed * #9283: autodoc: autoattribute directive failed to generate document for an attribute not having any comment * #9364: autodoc: single element tuple on the default argument value is wrongly rendered * #9362: autodoc: AttributeError is raised on processing a subclass of Tuple[()] * #9404: autodoc: TypeError is raised on processing dict-like object (not a class) via autoclass directive * #9317: html: Pushing left key causes visiting the next page at the first page * #9381: html: URL for html_favicon and html_log does not work * #9270: html theme : pyramid theme generates incorrect logo links * #9217: manpage: The name of manpage directory that is generated by :confval:`man_make_section_directory` is not correct * #9350: manpage: Fix font isn't reset after keyword at the top of samp role * #9306: Linkcheck reports broken link when remote server closes the connection on HEAD request * #9280: py domain: "exceptions" module is not displayed * #9418: py domain: a Callable annotation with no parameters (e.g. ``Callable[[], None])`` will be rendered with a bracket missing (``Callable[], None]``) * #9319: quickstart: Make sphinx-quickstart exit when conf.py already exists * #9387: xml: XML Builder ignores custom visitors * #9224: ``:param:`` and ``:type:`` fields does not support a type containing whitespace (ex. ``Dict[str, str]``) * #8945: when transforming typed fields, call the specified role instead of making an single xref. For C and C++, use the ``expr`` role for typed fields. Release 4.0.3 (released Jul 05, 2021) ===================================== Features added -------------- * C, add C23 keywords ``_Decimal32``, ``_Decimal64``, and ``_Decimal128``. * #9354: C, add :confval:`c_extra_keywords` to allow user-defined keywords during parsing. * Revert the removal of ``sphinx.util:force_decode()`` to become some 3rd party extensions available again during 5.0 Bugs fixed ---------- * #9330: changeset domain: :rst:dir:`versionchanged` with contents being a list will cause error during pdf build * #9313: LaTeX: complex table with merged cells broken since 4.0 * #9305: LaTeX: backslash may cause Improper discretionary list pdf build error with Japanese engines * #9354: C, remove special macro names from the keyword list. See also :confval:`c_extra_keywords`. * #9322: KeyError is raised on PropagateDescDomain transform Release 4.0.2 (released May 20, 2021) ===================================== Dependencies ------------ * #9216: Support jinja2-3.0 Incompatible changes -------------------- * #9222: Update Underscore.js to 1.13.1 * #9217: manpage: Stop creating a section directory on build manpage by default (see :confval:`man_make_section_directory`) Bugs fixed ---------- * #9210: viewcode: crashed if non importable modules found on parallel build * #9240: Unknown node error for pending_xref_condition is raised if an extension that does not support the node installs a missing-reference handler Release 4.0.1 (released May 11, 2021) ===================================== Bugs fixed ---------- * #9189: autodoc: crashed when ValueError is raised on generating signature from a property of the class * #9188: autosummary: warning is emitted if list value is set to autosummary_generate * #8380: html search: tags for search result are broken * #9198: i18n: Babel emits errors when running compile_catalog * #9205: py domain: The :canonical: option causes "more than one target for cross-reference" warning * #9201: websupport: UndefinedError is raised: 'css_tag' is undefined Release 4.0.0 (released May 09, 2021) ===================================== Dependencies ------------ 4.0.0b1 * Drop python 3.5 support * Drop docutils 0.12 and 0.13 support * LaTeX: add ``tex-gyre`` font dependency 4.0.0b2 * Support docutils-0.17. Please notice it changes the output of HTML builder. Some themes do not support it, and you need to update your custom CSS to upgrade it. Incompatible changes -------------------- 4.0.0b1 * #8539: autodoc: info-field-list is generated into the class description when ``autodoc_typehints='description'`` and ``autoclass_content='class'`` set * #8898: extlinks: "%s" becomes required keyword in the link caption string * domain: The ``Index`` class becomes subclasses of ``abc.ABC`` to indicate methods that must be overridden in the concrete classes * #4826: py domain: The structure of python objects is changed. A boolean value is added to indicate that the python object is canonical one * #7425: MathJax: The MathJax was changed from 2 to 3. Users using a custom MathJax configuration may have to set the old MathJax path or update their configuration for version 3. See :mod:`sphinx.ext.mathjax`. * #7784: i18n: The msgid for alt text of image is changed * #5560: napoleon: :confval:`napoleon_use_param` also affect "other parameters" section * #7996: manpage: Make a section directory on build manpage by default (see :confval:`man_make_section_directory`) * #7849: html: Change the default setting of :confval:`html_codeblock_linenos_style` to ``'inline'`` * #8380: html search: search results are wrapped with ``

`` instead of ``

`` * html theme: Move a script tag for documentation_options.js in basic/layout.html to ``script_files`` variable * html theme: Move CSS tags in basic/layout.html to ``css_files`` variable * #8915: html theme: Emit a warning for sphinx_rtd_theme-0.2.4 or older * #8508: LaTeX: uplatex becomes a default setting of latex_engine for Japanese documents * #5977: py domain: ``:var:``, ``:cvar:`` and ``:ivar:`` fields do not create cross-references * #4550: The ``align`` attribute of ``figure`` and ``table`` nodes becomes ``None`` by default instead of ``'default'`` * #8769: LaTeX refactoring: split sphinx.sty into multiple files and rename some auxiliary files created in ``latex`` build output repertory * #8937: Use explicit title instead of * #8487: The :file: option for csv-table directive now recognizes an absolute path as a relative path from source directory 4.0.0b2 * #9023: Change the CSS classes on :rst:role:`cpp:expr` and :rst:role:`cpp:texpr`. Deprecated ---------- * :confval:`html_codeblock_linenos_style` * ``favicon`` and ``logo`` variable in HTML templates * ``sphinx.directives.patches.CSVTable`` * ``sphinx.directives.patches.ListTable`` * ``sphinx.directives.patches.RSTTable`` * ``sphinx.ext.autodoc.directive.DocumenterBridge.filename_set`` * ``sphinx.ext.autodoc.directive.DocumenterBridge.warn()`` * ``sphinx.registry.SphinxComponentRegistry.get_source_input()`` * ``sphinx.registry.SphinxComponentRegistry.source_inputs`` * ``sphinx.transforms.FigureAligner`` * ``sphinx.util.pycompat.convert_with_2to3()`` * ``sphinx.util.pycompat.execfile_()`` * ``sphinx.util.smartypants`` * ``sphinx.util.typing.DirectiveOption`` Features added -------------- 4.0.0b1 * #8924: autodoc: Support ``bound`` argument for TypeVar * #7383: autodoc: Support typehints for properties * #5603: autodoc: Allow to refer to a python class using its canonical name when the class has two different names; a canonical name and an alias name * #8539: autodoc: Add :confval:`autodoc_typehints_description_target` to control the behavior of ``autodoc_typehints=description`` * #8841: autodoc: :confval:`autodoc_docstring_signature` will continue to look for multiple signature lines without backslash character * #7549: autosummary: Enable :confval:`autosummary_generate` by default * #8898: extlinks: Allow %s in link caption string * #4826: py domain: Add ``:canonical:`` option to python directives to describe the location where the object is defined * #7199: py domain: Add :confval:`python_use_unqualified_type_names` to suppress the module name of the python reference if it can be resolved (experimental) * #7068: py domain: Add :rst:dir:`py:property` directive to describe a property * #7784: i18n: The alt text for image is translated by default (without :confval:`gettext_additional_targets` setting) * #2018: html: :confval:`html_favicon` and :confval:`html_logo` now accept URL for the image * #8070: html search: Support searching for 2characters word * #9036: html theme: Allow to inherite the search page * #8938: imgconverter: Show the error of the command availability check * #7830: Add debug logs for change detection of sources and templates * #8201: Emit a warning if toctree contains duplicated entries * #8326: ``master_doc`` is now renamed to :confval:`root_doc` * #8942: C++, add support for the C++20 spaceship operator, ``<=>``. * #7199: A new node, ``sphinx.addnodes.pending_xref_condition`` has been added. It can be used to choose appropriate content of the reference by conditions. 4.0.0b2 * #8818: autodoc: Super class having ``Any`` arguments causes nit-picky warning * #9095: autodoc: TypeError is raised on processing broken metaclass * #9110: autodoc: metadata of GenericAlias is not rendered as a reference in py37+ * #9098: html: copy-range protection for doctests doesn't work in Safari * #9103: LaTeX: imgconverter: conversion runs even if not needed * #8127: py domain: Ellipsis in info-field-list causes nit-picky warning * #9121: py domain: duplicated warning is emitted when both canonical and its alias objects are defined on the document * #9023: More CSS classes on domain descriptions, see :ref:`nodes` for details. * #8195: mathjax: Rename :confval:`mathjax_config` to :confval:`mathjax2_config` and add :confval:`mathjax3_config` Bugs fixed ---------- 4.0.0b1 * #8917: autodoc: Raises a warning if function has wrong __globals__ value * #8415: autodoc: a TypeVar imported from other module is not resolved (in Python 3.7 or above) * #8992: autodoc: Failed to resolve types.TracebackType type annotation * #8905: html: html_add_permalinks=None and html_add_permalinks="" are ignored * #8380: html search: Paragraphs in search results are not identified as ``

`` * #8915: html theme: The translation of sphinx_rtd_theme does not work * #8342: Emit a warning if a unknown domain is given for directive or role (ex. ``:unknown:doc:``) * #7241: LaTeX: No wrapping for ``cpp:enumerator`` * #8711: LaTeX: backticks in code-blocks trigger latexpdf build warning (and font change) with late TeXLive 2019 * #8253: LaTeX: Figures with no size defined get overscaled (compared to images with size explicitly set in pixels) (fixed for ``'pdflatex'/'lualatex'`` only) * #8881: LaTeX: The depth of bookmarks panel in PDF is not enough for navigation * #8874: LaTeX: the fix to two minor Pygments LaTeXFormatter output issues ignore Pygments style * #8925: LaTeX: 3.5.0 ``verbatimmaxunderfull`` setting does not work as expected * #8980: LaTeX: missing line break in ``\pysigline`` * #8995: LaTeX: legacy ``\pysiglinewithargsret`` does not compute correctly available horizontal space and should use a ragged right style * #9009: LaTeX: "release" value with underscore leads to invalid LaTeX * #8911: C++: remove the longest matching prefix in :confval:`cpp_index_common_prefix` instead of the first that matches. * C, properly reject function declarations when a keyword is used as parameter name. * #8933: viewcode: Failed to create back-links on parallel build * #8960: C and C++, fix rendering of (member) function pointer types in function parameter lists. * C++, fix linking of names in array declarators, pointer to member (function) declarators, and in the argument to ``sizeof...``. * C, fix linking of names in array declarators. 4.0.0b2 * C, C++, fix ``KeyError`` when an ``alias`` directive is the first C/C++ directive in a file with another C/C++ directive later. 4.0.0b3 * #9167: html: Failed to add CSS files to the specific page Release 3.5.5 (in development) ============================== Release 3.5.4 (released Apr 11, 2021) ===================================== Dependencies ------------ * #9071: Restrict docutils to 0.16 Bugs fixed ---------- * #9078: autodoc: Async staticmethods and classmethods are considered as non async coroutine-functions with Python3.10 * #8870, #9001, #9051: html theme: The style are not applied with docutils-0.17 - toctree captions - The content of ``sidebar`` directive - figures Release 3.5.3 (released Mar 20, 2021) ===================================== Features added -------------- * #8959: using UNIX path separator in image directive confuses Sphinx on Windows Release 3.5.2 (released Mar 06, 2021) ===================================== Bugs fixed ---------- * #8943: i18n: Crashed by broken translation messages in ES, EL and HR * #8936: LaTeX: A custom LaTeX builder fails with unknown node error * #8952: Exceptions raised in a Directive cause parallel builds to hang Release 3.5.1 (released Feb 16, 2021) ===================================== Bugs fixed ---------- * #8883: autodoc: AttributeError is raised on assigning __annotations__ on read-only class * #8884: html: minified js stemmers not included in the distributed package * #8885: html: AttributeError is raised if CSS/JS files are installed via :confval:`html_context` * #8880: viewcode: ExtensionError is raised on incremental build after unparsable python module found Release 3.5.0 (released Feb 14, 2021) ===================================== Dependencies ------------ * LaTeX: ``multicol`` (it is anyhow a required part of the official latex2e base distribution) Incompatible changes -------------------- * Update Underscore.js to 1.12.0 * #6550: html: The config variable ``html_add_permalinks`` is replaced by :confval:`html_permalinks` and :confval:`html_permalinks_icon` Deprecated ---------- * pending_xref node for viewcode extension * ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.anchors_ignore`` * ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.auth`` * ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.broken`` * ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.good`` * ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.redirected`` * ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.rqueue`` * ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.to_ignore`` * ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.workers`` * ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.wqueue`` * ``sphinx.builders.linkcheck.node_line_or_0()`` * ``sphinx.ext.autodoc.AttributeDocumenter.isinstanceattribute()`` * ``sphinx.ext.autodoc.directive.DocumenterBridge.reporter`` * ``sphinx.ext.autodoc.importer.get_module_members()`` * ``sphinx.ext.autosummary.generate._simple_info()`` * ``sphinx.ext.autosummary.generate._simple_warn()`` * ``sphinx.writers.html.HTMLTranslator.permalink_text`` * ``sphinx.writers.html5.HTML5Translator.permalink_text`` Features added -------------- * #8022: autodoc: autodata and autoattribute directives does not show right-hand value of the variable if docstring contains ``:meta hide-value:`` in info-field-list * #8514: autodoc: Default values of overloaded functions are taken from actual implementation if they're ellipsis * #8775: autodoc: Support type union operator (PEP-604) in Python 3.10 or above * #8297: autodoc: Allow to extend :confval:`autodoc_default_options` via directive options * #759: autodoc: Add a new configuration :confval:`autodoc_preserve_defaults` as an experimental feature. It preserves the default argument values of functions in source code and keep them not evaluated for readability. * #8619: html: kbd role generates customizable HTML tags for compound keys * #8634: html: Allow to change the order of JS/CSS via ``priority`` parameter for :meth:`Sphinx.add_js_file()` and :meth:`Sphinx.add_css_file()` * #6241: html: Allow to add JS/CSS files to the specific page when an extension calls ``app.add_js_file()`` or ``app.add_css_file()`` on :event:`html-page-context` event * #6550: html: Allow to use HTML permalink texts via :confval:`html_permalinks_icon` * #1638: html: Add permalink icons to glossary terms * #8868: html search: performance issue with massive lists * #8867: html search: Update JavaScript stemmer code to the latest version of Snowball (v2.1.0) * #8852: i18n: Allow to translate heading syntax in MyST-Parser * #8649: imgconverter: Skip availability check if builder supports the image type * #8573: napoleon: Allow to change the style of custom sections using :confval:`napoleon_custom_styles` * #8004: napoleon: Type definitions in Google style docstrings are rendered as references when :confval:`napoleon_preprocess_types` enabled * #6241: mathjax: Include mathjax.js only on the document using equations * #8775: py domain: Support type union operator (PEP-604) * #8651: std domain: cross-reference for a rubric having inline item is broken * #7642: std domain: Optimize case-insensitive match of term * #8681: viewcode: Support incremental build * #8132: Add :confval:`project_copyright` as an alias of :confval:`copyright` * #207: Now :confval:`highlight_language` supports multiple languages * #2030: :rst:dir:`code-block` and :rst:dir:`literalinclude` supports automatic dedent via no-argument ``:dedent:`` option * C++, also hyperlink operator overloads in expressions and alias declarations. * #8247: Allow production lists to refer to tokens from other production groups * #8813: Show what extension (or module) caused it on errors on event handler * #8213: C++: add ``maxdepth`` option to :rst:dir:`cpp:alias` to insert nested declarations. * C, add ``noroot`` option to :rst:dir:`c:alias` to render only nested declarations. * C++, add ``noroot`` option to :rst:dir:`cpp:alias` to render only nested declarations. Bugs fixed ---------- * #8727: apidoc: namespace module file is not generated if no submodules there * #741: autodoc: inherited-members doesn't work for instance attributes on super class * #8592: autodoc: ``:meta public:`` does not effect to variables * #8594: autodoc: empty __all__ attribute is ignored * #8315: autodoc: Failed to resolve struct.Struct type annotation * #8652: autodoc: All variable comments in the module are ignored if the module contains invalid type comments * #8693: autodoc: Default values for overloaded functions are rendered as string * #8134: autodoc: crashes when mocked decorator takes arguments * #8800: autodoc: Uninitialized attributes in superclass are recognized as undocumented * #8655: autodoc: Failed to generate document if target module contains an object that raises an exception on ``hasattr()`` * #8306: autosummary: mocked modules are documented as empty page when using :recursive: option * #8232: graphviz: Image node is not rendered if graph file is in subdirectory * #8618: html: kbd role produces incorrect HTML when compound-key separators (-, + or ^) are used as keystrokes * #8629: html: A type warning for html_use_opensearch is shown twice * #8714: html: kbd role with "Caps Lock" rendered incorrectly * #8123: html search: fix searching for terms containing + (Requires a custom search language that does not split on +) * #8665: html theme: Could not override globaltoc_maxdepth in theme.conf * #8446: html: consecutive spaces are displayed as single space * #8745: i18n: crashes with KeyError when translation message adds a new auto footnote reference * #4304: linkcheck: Fix race condition that could lead to checking the availability of the same URL twice * #8791: linkcheck: The docname for each hyperlink is not displayed * #7118: sphinx-quickstart: questionare got Mojibake if libreadline unavailable * #8094: texinfo: image files on the different directory with document are not copied * #8782: todo: Cross references in todolist get broken * #8720: viewcode: module pages are generated for epub on incremental build * #8704: viewcode: anchors are generated in incremental build after singlehtml * #8756: viewcode: highlighted code is generated even if not referenced * #8671: :confval:`highlight_options` is not working * #8341: C, fix intersphinx lookup types for names in declarations. * C, C++: in general fix intersphinx and role lookup types. * #8683: :confval:`html_last_updated_fmt` does not support UTC offset (%z) * #8683: :confval:`html_last_updated_fmt` generates wrong time zone for %Z * #1112: ``download`` role creates duplicated copies when relative path is specified * #2616 (fifth item): LaTeX: footnotes from captions are not clickable, and for manually numbered footnotes only first one with same number is an hyperlink * #7576: LaTeX with French babel and memoir crash: "Illegal parameter number in definition of ``\FNH@prefntext``" * #8055: LaTeX (docs): A potential display bug with the LaTeX generation step in Sphinx (how to generate one-column index) * #8072: LaTeX: Directive :rst:dir:`hlist` not implemented in LaTeX * #8214: LaTeX: The :rst:role:`index` role and the glossary generate duplicate entries in the LaTeX index (if both used for same term) * #8735: LaTeX: wrong internal links in pdf to captioned code-blocks when :confval:`numfig` is not True * #8442: LaTeX: some indexed terms are ignored when using xelatex engine (or pdflatex and :confval:`latex_use_xindy` set to True) with memoir class * #8750: LaTeX: URLs as footnotes fail to show in PDF if originating from inside function type signatures * #8780: LaTeX: long words in narrow columns may not be hyphenated * #8788: LaTeX: ``\titleformat`` last argument in sphinx.sty should be bracketed, not braced (and is anyhow not needed) * #8849: LaTex: code-block printed out of margin (see the opt-in LaTeX syntax boolean :ref:`verbatimforcewraps ` for use via the :ref:`'sphinxsetup' ` key of ``latex_elements``) * #8183: LaTeX: Remove substitution_reference nodes from doctree only on LaTeX builds * #8865: LaTeX: Restructure the index nodes inside title nodes only on LaTeX builds * #8796: LaTeX: potentially critical low level TeX coding mistake has gone unnoticed so far * C, :rst:dir:`c:alias` skip symbols without explicit declarations instead of crashing. * C, :rst:dir:`c:alias` give a warning when the root symbol is not declared. * C, ``expr`` role should start symbol lookup in the current scope. Release 3.4.3 (released Jan 08, 2021) ===================================== Bugs fixed ---------- * #8655: autodoc: Failed to generate document if target module contains an object that raises an exception on ``hasattr()`` Release 3.4.2 (released Jan 04, 2021) ===================================== Bugs fixed ---------- * #8164: autodoc: Classes that inherit mocked class are not documented * #8602: autodoc: The ``autodoc-process-docstring`` event is emitted to the non-datadescriptors unexpectedly * #8616: autodoc: AttributeError is raised on non-class object is passed to autoclass directive Release 3.4.1 (released Dec 25, 2020) ===================================== Bugs fixed ---------- * #8559: autodoc: AttributeError is raised when using forward-reference type annotations * #8568: autodoc: TypeError is raised on checking slots attribute * #8567: autodoc: Instance attributes are incorrectly added to Parent class * #8566: autodoc: The ``autodoc-process-docstring`` event is emitted to the alias classes unexpectedly * #8583: autodoc: Unnecessary object comparison via ``__eq__`` method * #8565: linkcheck: Fix PriorityQueue crash when link tuples are not comparable Release 3.4.0 (released Dec 20, 2020) ===================================== Incompatible changes -------------------- * #8105: autodoc: the signature of class constructor will be shown for decorated classes, not a signature of decorator Deprecated ---------- * The ``follow_wrapped`` argument of ``sphinx.util.inspect.signature()`` * The ``no_docstring`` argument of ``sphinx.ext.autodoc.Documenter.add_content()`` * ``sphinx.ext.autodoc.Documenter.get_object_members()`` * ``sphinx.ext.autodoc.DataDeclarationDocumenter`` * ``sphinx.ext.autodoc.GenericAliasDocumenter`` * ``sphinx.ext.autodoc.InstanceAttributeDocumenter`` * ``sphinx.ext.autodoc.SlotsAttributeDocumenter`` * ``sphinx.ext.autodoc.TypeVarDocumenter`` * ``sphinx.ext.autodoc.importer._getannotations()`` * ``sphinx.ext.autodoc.importer._getmro()`` * ``sphinx.pycode.ModuleAnalyzer.parse()`` * ``sphinx.util.osutil.movefile()`` * ``sphinx.util.requests.is_ssl_error()`` Features added -------------- * #8119: autodoc: Allow to determine whether a member not included in ``__all__`` attribute of the module should be documented or not via :event:`autodoc-skip-member` event * #8219: autodoc: Parameters for generic class are not shown when super class is a generic class and show-inheritance option is given (in Python 3.7 or above) * autodoc: Add ``Documenter.config`` as a shortcut to access the config object * autodoc: Add Optional[t] to annotation of function and method if a default value equal to None is set. * #8209: autodoc: Add ``:no-value:`` option to :rst:dir:`autoattribute` and :rst:dir:`autodata` directive to suppress the default value of the variable * #8460: autodoc: Support custom types defined by typing.NewType * #8285: napoleon: Add :confval:`napoleon_attr_annotations` to merge type hints on source code automatically if any type is specified in docstring * #8236: napoleon: Support numpydoc's "Receives" section * #6914: Add a new event :event:`warn-missing-reference` to custom warning messages when failed to resolve a cross-reference * #6914: Emit a detailed warning when failed to resolve a ``:ref:`` reference * #6629: linkcheck: The builder now handles rate limits. See :confval:`linkcheck_retry_on_rate_limit` for details. Bugs fixed ---------- * #7613: autodoc: autodoc does not respect __signature__ of the class * #4606: autodoc: the location of the warning is incorrect for inherited method * #8105: autodoc: the signature of class constructor is incorrect if the class is decorated * #8434: autodoc: :confval:`autodoc_type_aliases` does not effect to variables and attributes * #8443: autodoc: autodata directive can't create document for PEP-526 based type annotated variables * #8443: autodoc: autoattribute directive can't create document for PEP-526 based uninitialized variables * #8480: autodoc: autoattribute could not create document for __slots__ attributes * #8503: autodoc: autoattribute could not create document for a GenericAlias as class attributes correctly * #8534: autodoc: autoattribute could not create document for a commented attribute in alias class * #8452: autodoc: autodoc_type_aliases doesn't work when autodoc_typehints is set to "description" * #8541: autodoc: autodoc_type_aliases doesn't work for the type annotation to instance attributes * #8460: autodoc: autodata and autoattribute directives do not display type information of TypeVars * #8493: autodoc: references to builtins not working in class aliases * #8522: autodoc: ``__bool__`` method could be called * #8067: autodoc: A typehint for the instance variable having type_comment on super class is not displayed * #8545: autodoc: a __slots__ attribute is not documented even having docstring * #741: autodoc: inherited-members doesn't work for instance attributes on super class * #8477: autosummary: non utf-8 reST files are generated when template contains multibyte characters * #8501: autosummary: summary extraction splits text after "el at." unexpectedly * #8524: html: Wrong url_root has been generated on a document named "index" * #8419: html search: Do not load ``language_data.js`` in non-search pages * #8549: i18n: ``-D gettext_compact=0`` is no longer working * #8454: graphviz: The layout option for graph and digraph directives don't work * #8131: linkcheck: Use GET when HEAD requests cause Too Many Redirects, to accommodate infinite redirect loops on HEAD * #8437: Makefile: ``make clean`` with empty BUILDDIR is dangerous * #8365: py domain: ``:type:`` and ``:rtype:`` gives false ambiguous class lookup warnings * #8352: std domain: Failed to parse an option that starts with bracket * #8519: LaTeX: Prevent page brake in the middle of a seealso * #8520: C, fix copying of AliasNode. Release 3.3.1 (released Nov 12, 2020) ===================================== Bugs fixed ---------- * #8372: autodoc: autoclass directive became slower than Sphinx-3.2 * #7727: autosummary: raise PycodeError when documenting python package without __init__.py * #8350: autosummary: autosummary_mock_imports causes slow down builds * #8364: C, properly initialize attributes in empty symbols. * #8399: i18n: Put system locale path after the paths specified by configuration Release 3.3.0 (released Nov 02, 2020) ===================================== Deprecated ---------- * ``sphinx.builders.latex.LaTeXBuilder.usepackages`` * ``sphinx.builders.latex.LaTeXBuilder.usepackages_afger_hyperref`` * ``sphinx.ext.autodoc.SingledispatchFunctionDocumenter`` * ``sphinx.ext.autodoc.SingledispatchMethodDocumenter`` Features added -------------- * #8100: html: Show a better error message for failures on copying html_static_files * #8141: C: added a ``maxdepth`` option to :rst:dir:`c:alias` to insert nested declarations. * #8081: LaTeX: Allow to add LaTeX package via ``app.add_latex_package()`` until just before writing .tex file * #7996: manpage: Add :confval:`man_make_section_directory` to make a section directory on build man page * #8289: epub: Allow to suppress "duplicated ToC entry found" warnings from epub builder using :confval:`suppress_warnings`. * #8298: sphinx-quickstart: Add :option:`sphinx-quickstart --no-sep` option * #8304: sphinx.testing: Register public markers in sphinx.testing.fixtures * #8051: napoleon: use the obj role for all See Also items * #8050: napoleon: Apply :confval:`napoleon_preprocess_types` to every field * C and C++, show line numbers for previous declarations when duplicates are detected. * #8183: Remove substitution_reference nodes from doctree only on LaTeX builds Bugs fixed ---------- * #8085: i18n: Add support for having single text domain * #6640: i18n: Failed to override system message translation * #8143: autodoc: AttributeError is raised when False value is passed to autodoc_default_options * #8103: autodoc: functools.cached_property is not considered as a property * #8190: autodoc: parsing error is raised if some extension replaces docstring by string not ending with blank lines * #8142: autodoc: Wrong constructor signature for the class derived from typing.Generic * #8157: autodoc: TypeError is raised when annotation has invalid __args__ * #7964: autodoc: Tuple in default value is wrongly rendered * #8200: autodoc: type aliases break type formatting of autoattribute * #7786: autodoc: can't detect overloaded methods defined in other file * #8294: autodoc: single-string __slots__ is not handled correctly * #7785: autodoc: autodoc_typehints='none' does not effect to overloaded functions * #8192: napoleon: description is disappeared when it contains inline literals * #8142: napoleon: Potential of regex denial of service in google style docs * #8169: LaTeX: pxjahyper loaded even when latex_engine is not platex * #8215: LaTeX: 'oneside' classoption causes build warning * #8175: intersphinx: Potential of regex denial of service by broken inventory * #8277: sphinx-build: missing and redundant spacing (and etc) for console output on building * #7973: imgconverter: Check availability of imagemagick many times * #8255: py domain: number in default argument value is changed from hexadecimal to decimal * #8316: html: Prevent arrow keys changing page when button elements are focused * #8343: html search: Fix unnecessary load of images when parsing the document * #8254: html theme: Line numbers misalign with code lines * #8093: The highlight warning has wrong location in some builders (LaTeX, singlehtml and so on) * #8215: Eliminate Fancyhdr build warnings for oneside documents * #8239: Failed to refer a token in productionlist if it is indented * #8268: linkcheck: Report HTTP errors when ``linkcheck_anchors`` is ``True`` * #8245: linkcheck: take source directory into account for local files * #8321: linkcheck: ``tel:`` schema hyperlinks are detected as errors * #8323: linkcheck: An exit status is incorrect when links having unsupported schema found * #8188: C, add missing items to internal object types dictionary, e.g., preventing intersphinx from resolving them. * C, fix anon objects in intersphinx. * #8270, C++, properly reject functions as duplicate declarations if a non-function declaration of the same name already exists. * C, fix references to function parameters. Link to the function instead of a non-existing anchor. * #6914: figure numbers are unexpectedly assigned to uncaptioned items * #8320: make "inline" line numbers un-selectable Testing -------- * #8257: Support parallel build in sphinx.testing Release 3.2.1 (released Aug 14, 2020) ===================================== Features added -------------- * #8095: napoleon: Add :confval:`napoleon_preprocess_types` to enable the type preprocessor for numpy style docstrings * #8114: C and C++, parse function attributes after parameters and qualifiers. Bugs fixed ---------- * #8074: napoleon: Crashes during processing C-ext module * #8088: napoleon: "Inline literal start-string without end-string" warning in Numpy style Parameters section * #8084: autodoc: KeyError is raised on documenting an attribute of the broken class * #8091: autodoc: AttributeError is raised on documenting an attribute on Python 3.5.2 * #8099: autodoc: NameError is raised when target code uses ``TYPE_CHECKING`` * C++, fix parsing of template template parameters, broken by the fix of #7944 Release 3.2.0 (released Aug 08, 2020) ===================================== Deprecated ---------- * ``sphinx.ext.autodoc.members_set_option()`` * ``sphinx.ext.autodoc.merge_special_members_option()`` * ``sphinx.writers.texinfo.TexinfoWriter.desc`` * C, parsing of pre-v3 style type directives and roles, along with the options :confval:`c_allow_pre_v3` and :confval:`c_warn_on_allowed_pre_v3`. Features added -------------- * #2076: autodoc: Allow overriding of exclude-members in skip-member function * #8034: autodoc: ``:private-member:`` can take an explicit list of member names to be documented * #2024: autosummary: Add :confval:`autosummary_filename_map` to avoid conflict of filenames between two object with different case * #8011: autosummary: Support instance attributes as a target of autosummary directive * #7849: html: Add :confval:`html_codeblock_linenos_style` to change the style of line numbers for code-blocks * #7853: C and C++, support parameterized GNU style attributes. * #7888: napoleon: Add aliases Warn and Raise. * #7690: napoleon: parse type strings and make them hyperlinks as possible. The conversion rule can be updated via :confval:`napoleon_type_aliases` * #8049: napoleon: Create a hyperlink for each the type of parameter when :confval:`napoleon_use_params` is False * C, added :rst:dir:`c:alias` directive for inserting copies of existing declarations. * #7745: html: inventory is broken if the docname contains a space * #7991: html search: Allow searching for numbers * #7902: html theme: Add a new option :confval:`globaltoc_maxdepth` to control the behavior of globaltoc in sidebar * #7840: i18n: Optimize the dependencies check on bootstrap * #7768: i18n: :confval:`figure_language_filename` supports ``docpath`` token * #5208: linkcheck: Support checks for local links * #5090: setuptools: Link verbosity to distutils' -v and -q option * #6698: doctest: Add ``:trim-doctest-flags:`` and ``:no-trim-doctest-flags:`` options to doctest, testcode and testoutput directives * #7052: add ``:noindexentry:`` to the Python, C, C++, and Javascript domains. Update the documentation to better reflect the relationship between this option and the ``:noindex:`` option. * #7899: C, add possibility of parsing of some pre-v3 style type directives and roles and try to convert them to equivalent v3 directives/roles. Set the new option :confval:`c_allow_pre_v3` to ``True`` to enable this. The warnings printed from this functionality can be suppressed by setting :confval:`c_warn_on_allowed_pre_v3`` to ``True``. The functionality is immediately deprecated. * #7999: C, add support for named variadic macro arguments. * #8071: Allow to suppress "self referenced toctrees" warning Bugs fixed ---------- * #7886: autodoc: TypeError is raised on mocking generic-typed classes * #7935: autodoc: function signature is not shown when the function has a parameter having ``inspect._empty`` as its default value * #7901: autodoc: type annotations for overloaded functions are not resolved * #904: autodoc: An instance attribute cause a crash of autofunction directive * #1362: autodoc: ``private-members`` option does not work for class attributes * #7983: autodoc: Generator type annotation is wrongly rendered in py36 * #8030: autodoc: An uninitialized annotated instance variable is not documented when ``:inherited-members:`` option given * #8032: autodoc: A type hint for the instance variable defined at parent class is not shown in the document of the derived class * #8041: autodoc: An annotated instance variable on super class is not documented when derived class has other annotated instance variables * #7839: autosummary: cannot handle umlauts in function names * #7865: autosummary: Failed to extract summary line when abbreviations found * #7866: autosummary: Failed to extract correct summary line when docstring contains a hyperlink target * #7469: autosummary: "Module attributes" header is not translatable * #7940: apidoc: An extra newline is generated at the end of the rst file if a module has submodules * #4258: napoleon: decorated special methods are not shown * #7799: napoleon: parameters are not escaped for combined params in numpydoc * #7780: napoleon: multiple parameters declaration in numpydoc was wrongly recognized when napoleon_use_params=True * #7715: LaTeX: ``numfig_secnum_depth > 1`` leads to wrong figure links * #7846: html theme: XML-invalid files were generated * #7894: gettext: Wrong source info is shown when using rst_epilog * #7691: linkcheck: HEAD requests are not used for checking * #4888: i18n: Failed to add an explicit title to ``:ref:`` role on translation * #7928: py domain: failed to resolve a type annotation for the attribute * #8008: py domain: failed to parse a type annotation containing ellipsis * #7994: std domain: option directive does not generate old node_id compatible with 2.x or older * #7968: i18n: The content of ``math`` directive is interpreted as reST on translation * #7768: i18n: The ``root`` element for :confval:`figure_language_filename` is not a path that user specifies in the document * #7993: texinfo: TypeError is raised for nested object descriptions * #7993: texinfo: a warning not supporting desc_signature_line node is shown * #7869: :rst:role:`abbr` role without an explanation will show the explanation from the previous abbr role * #8048: graphviz: graphviz.css was copied on building non-HTML document * C and C++, removed ``noindex`` directive option as it did nothing. * #7619: Duplicated node IDs are generated if node has multiple IDs * #2050: Symbols sections are appeared twice in the index page * #8017: Fix circular import in sphinx.addnodes * #7986: CSS: make "highlight" selector more robust * #7944: C++, parse non-type template parameters starting with a dependent qualified name. * C, don't deepcopy the entire symbol table and make a mess every time an enumerator is handled. Release 3.1.2 (released Jul 05, 2020) ===================================== Incompatible changes -------------------- * #7650: autodoc: the signature of base function will be shown for decorated functions, not a signature of decorator Bugs fixed ---------- * #7844: autodoc: Failed to detect module when relative module name given * #7856: autodoc: AttributeError is raised when non-class object is given to the autoclass directive * #7850: autodoc: KeyError is raised for invalid mark up when autodoc_typehints is 'description' * #7812: autodoc: crashed if the target name matches to both an attribute and module that are same name * #7650: autodoc: function signature becomes ``(*args, **kwargs)`` if the function is decorated by generic decorator * #7812: autosummary: generates broken stub files if the target code contains an attribute and module that are same name * #7806: viewcode: Failed to resolve viewcode references on 3rd party builders * #7838: html theme: List items have extra vertical space * #7878: html theme: Undesired interaction between "overflow" and "float" Release 3.1.1 (released Jun 14, 2020) ===================================== Incompatible changes -------------------- * #7808: napoleon: a type for attribute are represented as typed field Features added -------------- * #7807: autodoc: Show detailed warning when type_comment is mismatched with its signature Bugs fixed ---------- * #7808: autodoc: Warnings raised on variable and attribute type annotations * #7802: autodoc: EOFError is raised on parallel build * #7821: autodoc: TypeError is raised for overloaded C-ext function * #7805: autodoc: an object which descriptors returns is unexpectedly documented * #7807: autodoc: wrong signature is shown for the function using contextmanager * #7812: autosummary: generates broken stub files if the target code contains an attribute and module that are same name * #7808: napoleon: Warnings raised on variable and attribute type annotations * #7811: sphinx.util.inspect causes circular import problem Release 3.1.0 (released Jun 08, 2020) ===================================== Dependencies ------------ * #7746: mathjax: Update to 2.7.5 Incompatible changes -------------------- * #7477: imgconverter: Invoke "magick convert" command by default on Windows Deprecated ---------- * The first argument for sphinx.ext.autosummary.generate.AutosummaryRenderer has been changed to Sphinx object * ``sphinx.ext.autosummary.generate.AutosummaryRenderer`` takes an object type as an argument * The ``ignore`` argument of ``sphinx.ext.autodoc.Documenter.get_doc()`` * The ``template_dir`` argument of ``sphinx.ext.autosummary.generate. AutosummaryRenderer`` * The ``module`` argument of ``sphinx.ext.autosummary.generate. find_autosummary_in_docstring()`` * The ``builder`` argument of ``sphinx.ext.autosummary.generate. generate_autosummary_docs()`` * The ``template_dir`` argument of ``sphinx.ext.autosummary.generate. generate_autosummary_docs()`` * The ``ignore`` argument of ``sphinx.util.docstring.prepare_docstring()`` * ``sphinx.ext.autosummary.generate.AutosummaryRenderer.exists()`` * ``sphinx.util.rpartition()`` Features added -------------- * LaTeX: Make the ``toplevel_sectioning`` setting optional in LaTeX theme * LaTeX: Allow to override papersize and pointsize from LaTeX themes * LaTeX: Add :confval:`latex_theme_options` to override theme options * #7410: Allow to suppress "circular toctree references detected" warnings using :confval:`suppress_warnings` * C, added scope control directives, :rst:dir:`c:namespace`, :rst:dir:`c:namespace-push`, and :rst:dir:`c:namespace-pop`. * #2044: autodoc: Suppress default value for instance attributes * #7473: autodoc: consider a member public if docstring contains ``:meta public:`` in info-field-list * #7487: autodoc: Allow to generate docs for singledispatch functions by py:autofunction * #7143: autodoc: Support final classes and methods * #7384: autodoc: Support signatures defined by ``__new__()``, metaclasses and builtin base classes * #2106: autodoc: Support multiple signatures on docstring * #4422: autodoc: Support GenericAlias in Python 3.7 or above * #3610: autodoc: Support overloaded functions * #7722: autodoc: Support TypeVar * #7466: autosummary: headings in generated documents are not translated * #7490: autosummary: Add ``:caption:`` option to autosummary directive to set a caption to the toctree * #7469: autosummary: Support module attributes * #248, #6040: autosummary: Add ``:recursive:`` option to autosummary directive to generate stub files recursively * #4030: autosummary: Add :confval:`autosummary_context` to add template variables for custom templates * #7530: html: Support nested elements * #7481: html theme: Add right margin to footnote/citation labels * #7482, #7717: html theme: CSS spacing for code blocks with captions and line numbers * #7443: html theme: Add new options :confval:`globaltoc_collapse` and :confval:`globaltoc_includehidden` to control the behavior of globaltoc in sidebar * #7484: html theme: Avoid clashes between sidebar and other blocks * #7476: html theme: Relbar breadcrumb should contain current page * #7506: html theme: A canonical URL is not escaped * #7533: html theme: Avoid whitespace at the beginning of genindex.html * #7541: html theme: Add a "clearer" at the end of the "body" * #7542: html theme: Make admonition/topic/sidebar scrollable * #7543: html theme: Add top and bottom margins to tables * #7695: html theme: Add viewport meta tag for basic theme * #7721: html theme: classic: default codetextcolor/codebgcolor doesn't override Pygments * C and C++: allow semicolon in the end of declarations. * C++, parse parameterized noexcept specifiers. * #7294: C++, parse expressions with user-defined literals. * C++, parse trailing return types. * #7143: py domain: Add ``:final:`` option to :rst:dir:`py:class:`, :rst:dir:`py:exception:` and :rst:dir:`py:method:` directives * #7596: py domain: Change a type annotation for variables to a hyperlink * #7770: std domain: :rst:dir:`option` directive support arguments in the form of ``foo[=bar]`` * #7582: napoleon: a type for attribute are represented like type annotation * #7734: napoleon: overescaped trailing underscore on attribute * #7247: linkcheck: Add :confval:`linkcheck_request_headers` to send custom HTTP headers for specific host * #7792: setuptools: Support ``--verbosity`` option * #7683: Add ``allowed_exceptions`` parameter to ``Sphinx.emit()`` to allow handlers to raise specified exceptions * #7295: C++, parse (trailing) requires clauses. Bugs fixed ---------- * #6703: autodoc: incremental build does not work for imported objects * #7564: autodoc: annotations not to be shown for descriptors * #6588: autodoc: Decorated inherited method has no documentation * #7469: autodoc: The change of autodoc-process-docstring for variables is cached unexpectedly * #7559: autodoc: misdetects a sync function is async * #6857: autodoc: failed to detect a classmethod on Enum class * #7562: autodoc: a typehint contains spaces is wrongly rendered under autodoc_typehints='description' mode * #7551: autodoc: failed to import nested class * #7362: autodoc: does not render correct signatures for built-in functions * #7654: autodoc: ``Optional[Union[foo, bar]]`` is presented as ``Union[foo, bar, None]`` * #7629: autodoc: autofunction emits an unfriendly warning if an invalid object specified * #7650: autodoc: undecorated signature is shown for decorated functions * #7676: autodoc: typo in the default value of autodoc_member_order * #7676: autodoc: wrong value for :member-order: option is ignored silently * #7676: autodoc: member-order="bysource" does not work for C module * #3673: autodoc: member-order="bysource" does not work for a module having __all__ * #7668: autodoc: wrong retann value is passed to a handler of autodoc-process-signature * #7711: autodoc: fails with ValueError when processing numpy objects * #7791: autodoc: TypeError is raised on documenting singledispatch function * #7551: autosummary: a nested class is indexed as non-nested class * #7661: autosummary: autosummary directive emits warnings twices if failed to import the target module * #7685: autosummary: The template variable "members" contains imported members even if :confval:`autossummary_imported_members` is False * #7671: autosummary: The location of import failure warning is missing * #7535: sphinx-autogen: crashes when custom template uses inheritance * #7536: sphinx-autogen: crashes when template uses i18n feature * #7781: sphinx-build: Wrong error message when outdir is not directory * #7653: sphinx-quickstart: Fix multiple directory creation for nested relpath * #2785: html: Bad alignment of equation links * #7718: html theme: some themes does not respect background color of Pygments style (agogo, haiku, nature, pyramid, scrolls, sphinxdoc and traditional) * #7544: html theme: inconsistent padding in admonitions * #7581: napoleon: bad parsing of inline code in attribute docstrings * #7628: imgconverter: runs imagemagick once unnecessary for builders not supporting images * #7610: incorrectly renders consecutive backslashes for docutils-0.16 * #7646: handle errors on event handlers * #4187: LaTeX: EN DASH disappears from PDF bookmarks in Japanese documents * #7701: LaTeX: Anonymous indirect hyperlink target causes duplicated labels * #7723: LaTeX: pdflatex crashed when URL contains a single quote * #7756: py domain: The default value for positional only argument is not shown * #7760: coverage: Add :confval:`coverage_show_missing_items` to show coverage result to console * C++, fix rendering and xrefs in nested names explicitly starting in global scope, e.g., ``::A::B``. * C, fix rendering and xrefs in nested names explicitly starting in global scope, e.g., ``.A.B``. * #7763: C and C++, don't crash during display stringification of unary expressions and fold expressions. Release 3.0.4 (released May 27, 2020) ===================================== Bugs fixed ---------- * #7567: autodoc: parametrized types are shown twice for generic types * #7637: autodoc: system defined TypeVars are shown in Python 3.9 * #7696: html: Updated jQuery version from 3.4.1 to 3.5.1 for security reasons * #7611: md5 fails when OpenSSL FIPS is enabled * #7626: release package does not contain ``CODE_OF_CONDUCT`` Release 3.0.3 (released Apr 26, 2020) ===================================== Features added -------------- * C, parse array declarators with static, qualifiers, and VLA specification. Bugs fixed ---------- * #7516: autodoc: crashes if target object raises an error on accessing its attributes Release 3.0.2 (released Apr 19, 2020) ===================================== Features added -------------- * C, parse attributes and add :confval:`c_id_attributes` and :confval:`c_paren_attributes` to support user-defined attributes. Bugs fixed ---------- * #7461: py domain: fails with IndexError for empty tuple in type annotation * #7510: py domain: keyword-only arguments are documented as having a default of None * #7418: std domain: :rst:role:`term` role could not match case-insensitively * #7461: autodoc: empty tuple in type annotation is not shown correctly * #7479: autodoc: Sphinx builds has been slower since 3.0.0 on mocking * C++, fix spacing issue in east-const declarations. * #7414: LaTeX: Xindy language options were incorrect * sphinx crashes with ImportError on python3.5.1 Release 3.0.1 (released Apr 11, 2020) ===================================== Incompatible changes -------------------- * #7418: std domain: :rst:dir:`term` role becomes case sensitive Bugs fixed ---------- * #7428: py domain: a reference to class ``None`` emits a nitpicky warning * #7445: py domain: a return annotation ``None`` in the function signature is not converted to a hyperlink when using intersphinx * #7418: std domain: duplication warning for glossary terms is case insensitive * #7438: C++, fix merging overloaded functions in parallel builds. * #7422: autodoc: fails with ValueError when using autodoc_mock_imports * #7435: autodoc: ``autodoc_typehints='description'`` doesn't suppress typehints in signature for classes/methods * #7451: autodoc: fails with AttributeError when an object returns non-string object as a ``__doc__`` member * #7423: crashed when giving a non-string object to logger * #7479: html theme: Do not include xmlns attribute with HTML 5 doctype * #7426: html theme: Escape some links in HTML templates Release 3.0.0 (released Apr 06, 2020) ===================================== Dependencies ------------ 3.0.0b1 * LaTeX: drop dependency on :program:`extractbb` for image inclusion in Japanese documents as ``.xbb`` files are unneeded by :program:`dvipdfmx` since TeXLive2015 (refs: #6189) * babel-2.0 or above is available (Unpinned) Incompatible changes -------------------- 3.0.0b1 * Drop features and APIs deprecated in 1.8.x * #247: autosummary: stub files are overwritten automatically by default. see :confval:`autosummary_generate_overwrite` to change the behavior * #5923: autodoc: the members of ``object`` class are not documented by default when ``:inherited-members:`` and ``:special-members:`` are given. * #6830: py domain: ``meta`` fields in info-field-list becomes reserved. They are not displayed on output document now * #6417: py domain: doctree of desc_parameterlist has been changed. The argument names, annotations and default values are wrapped with inline node * The structure of ``sphinx.events.EventManager.listeners`` has changed * Due to the scoping changes for :rst:dir:`productionlist` some uses of :rst:role:`token` must be modified to include the scope which was previously ignored. * #6903: Internal data structure of Python, reST and standard domains have changed. The node_id is added to the index of objects and modules. Now they contains a pair of docname and node_id for cross reference. * #7276: C++ domain: Non intended behavior is removed such as ``say_hello_`` links to ``.. cpp:function:: say_hello()`` * #7210: js domain: Non intended behavior is removed such as ``parseInt_`` links to ``.. js:function:: parseInt`` * #7229: rst domain: Non intended behavior is removed such as ``numref_`` links to ``.. rst:role:: numref`` * #6903: py domain: Non intended behavior is removed such as ``say_hello_`` links to ``.. py:function:: say_hello()`` * #7246: py domain: Drop special cross reference helper for exceptions, functions and methods * The C domain has been rewritten, with additional directives and roles. The existing ones are now more strict, resulting in new warnings. * The attribute ``sphinx_cpp_tagname`` in the ``desc_signature_line`` node has been renamed to ``sphinx_line_type``. * #6462: double backslashes in domain directives are no longer replaced by single backslashes as default. A new configuration value :confval:`strip_signature_backslash` can be used by users to re-enable it. 3.0.0 final * #7222: ``sphinx.util.inspect.unwrap()`` is renamed to ``unwrap_all()`` Deprecated ---------- 3.0.0b1 * ``desc_signature['first']`` * ``sphinx.directives.DescDirective`` * ``sphinx.domains.std.StandardDomain.add_object()`` * ``sphinx.domains.python.PyDecoratorMixin`` * ``sphinx.ext.autodoc.get_documenters()`` * ``sphinx.ext.autosummary.process_autosummary_toc()`` * ``sphinx.parsers.Parser.app`` * ``sphinx.testing.path.Path.text()`` * ``sphinx.testing.path.Path.bytes()`` * ``sphinx.util.inspect.getargspec()`` * ``sphinx.writers.latex.LaTeXWriter.format_docclass()`` Features added -------------- 3.0.0b1 * #247: autosummary: Add :confval:`autosummary_generate_overwrite` to overwrite old stub file * #5923: autodoc: ``:inherited-members:`` option takes a name of anchestor class not to document inherited members of the class and uppers * #6830: autodoc: consider a member private if docstring contains ``:meta private:`` in info-field-list * #7165: autodoc: Support Annotated type (PEP-593) * #2815: autodoc: Support singledispatch functions and methods * #7079: autodoc: :confval:`autodoc_typehints` accepts ``"description"`` configuration. It shows typehints as object description * #7314: apidoc: Propagate ``--maxdepth`` option through package documents * #6558: glossary: emit a warning for duplicated glossary entry * #3106: domain: Register hyperlink target for index page automatically * #6558: std domain: emit a warning for duplicated generic objects * #6830: py domain: Add new event: :event:`object-description-transform` * #6895: py domain: Do not emit nitpicky warnings for built-in types * py domain: Support lambda functions in function signature * #6417: py domain: Allow to make a style for arguments of functions and methods * #7238, #7239: py domain: Emit a warning on describing a python object if the entry is already added as the same name * #7341: py domain: type annotations in signature are converted to cross refs * Support priority of event handlers. For more detail, see :py:meth:`.Sphinx.connect()` * #3077: Implement the scoping for :rst:dir:`productionlist` as indicated in the documentation. * #1027: Support backslash line continuation in :rst:dir:`productionlist`. * #7108: config: Allow to show an error message from conf.py via ``ConfigError`` * #7032: html: :confval:`html_scaled_image_link` will be disabled for images having ``no-scaled-link`` class * #7144: Add CSS class indicating its domain for each desc node * #7211: latex: Use babel for Chinese document when using XeLaTeX * #6672: LaTeX: Support LaTeX Theming (experimental) * #7005: LaTeX: Add LaTeX styling macro for :rst:role:`kbd` role * #7220: genindex: Show "main" index entries at first * #7103: linkcheck: writes all links to ``output.json`` * #7025: html search: full text search can be disabled for individual document using ``:nosearch:`` file-wide metadata * #7293: html search: Allow to override JavaScript splitter via ``SearchLanguage.js_splitter_code`` * #7142: html theme: Add a theme option: ``pygments_dark_style`` to switch the style of code-blocks in dark mode * The C domain has been rewritten adding for example: - Cross-referencing respecting the current scope. - Possible to document anonymous entities. - More specific directives and roles for each type of entity, e.g., handling scoping of enumerators. - New role :rst:role:`c:expr` for rendering expressions and types in text. * Added ``SphinxDirective.get_source_info()`` and ``SphinxRole.get_source_info()``. * #7324: sphinx-build: Emit a warning if multiple files having different file extensions for same document found 3.0.0 final * Added ``ObjectDescription.transform_content()``. Bugs fixed ---------- 3.0.0b1 * C++, fix cross reference lookup in certain cases involving function overloads. * #5078: C++, fix cross reference lookup when a directive contains multiple declarations. * C++, suppress warnings for directly dependent typenames in cross references generated automatically in signatures. * #5637: autodoc: Incorrect handling of nested class names on show-inheritance * #7267: autodoc: error message for invalid directive options has wrong location * #7329: autodoc: info-field-list is wrongly generated from type hints into the class description even if ``autoclass_content='class'`` set * #7331: autodoc: a cython-function is not recognized as a function * #5637: inheritance_diagram: Incorrect handling of nested class names * #7139: ``code-block:: guess`` does not work * #7325: html: source_suffix containing dot leads to wrong source link * #7357: html: Resizing SVG image fails with ValueError * #7278: html search: Fix use of ``html_file_suffix`` instead of ``html_link_suffix`` in search results * #7297: html theme: ``bizstyle`` does not support ``sidebarwidth`` * #3842: singlehtml: Path to images broken when master doc is not in source root * #7179: std domain: Fix whitespaces are suppressed on referring GenericObject * #7289: console: use bright colors instead of bold * #1539: C, parse array types. * #2377: C, parse function pointers even in complex types. * #7345: sphinx-build: Sphinx crashes if output directory exists as a file * #7290: sphinx-build: Ignore bdb.BdbQuit when handling exceptions * #6240: napoleon: Attributes and Methods sections ignore :noindex: option 3.0.0 final * #7364: autosummary: crashed when :confval:`autosummary_generate` is False * #7370: autosummary: raises UnboundLocalError when unknown module given * #7367: C++, alternate operator spellings are now supported. * C, alternate operator spellings are now supported. * #7368: C++, comma operator in expressions, pack expansion in template argument lists, and more comprehensive error messages in some cases. * C, C++, fix crash and wrong duplicate warnings related to anon symbols. * #6477: Escape first "!" in a cross reference linking no longer possible * #7219: py domain: The index entry generated by ``py:function`` directive is different with one from ``index`` directive with "builtin" type * #7301: capital characters are not allowed for node_id * #7301: epub: duplicated node_ids are generated * #6564: html: a width of table was ignored on HTML builder * #7401: Incorrect argument is passed for :event:`env-get-outdated` handlers * #7355: autodoc: a signature of cython-function is not recognized well * #7222: autodoc: ``__wrapped__`` functions are not documented correctly * #7409: intersphinx: ValueError is raised when an extension sets up :confval:`intersphinx_mapping` on :event:`config-inited` event * #7343: Sphinx builds has been slower since 2.4.0 on debug mode Release 2.4.4 (released Mar 05, 2020) ===================================== Bugs fixed ---------- * #7197: LaTeX: platex cause error to build image directive with target url * #7223: Sphinx builds has been slower since 2.4.0 Release 2.4.3 (released Feb 22, 2020) ===================================== Bugs fixed ---------- * #7184: autodoc: ``*args`` and ``**kwarg`` in type comments are not handled properly * #7189: autodoc: classmethod coroutines are not detected * #7183: intersphinx: ``:attr:`` reference to property is broken * #6244, #6387: html search: Search breaks/hangs when built with dirhtml builder * #7195: todo: emit doctree-resolved event with non-document node incorrectly Release 2.4.2 (released Feb 19, 2020) ===================================== Bugs fixed ---------- * #7138: autodoc: ``autodoc.typehints`` crashed when variable has unbound object as a value * #7156: autodoc: separator for keyword only arguments is not shown * #7146: autodoc: IndexError is raised on suppressed type_comment found * #7161: autodoc: typehints extension does not support parallel build * #7178: autodoc: TypeError is raised on fetching type annotations * #7151: crashed when extension assigns a value to ``env.indexentries`` * #7170: text: Remove debug print * #7137: viewcode: Avoid to crash when non-python code given Release 2.4.1 (released Feb 11, 2020) ===================================== Bugs fixed ---------- * #7120: html: crashed when on scaling SVG images which have float dimensions * #7126: autodoc: TypeError: 'getset_descriptor' object is not iterable Release 2.4.0 (released Feb 09, 2020) ===================================== Deprecated ---------- * The ``decode`` argument of ``sphinx.pycode.ModuleAnalyzer()`` * ``sphinx.directives.other.Index`` * ``sphinx.environment.temp_data['gloss_entries']`` * ``sphinx.environment.BuildEnvironment.indexentries`` * ``sphinx.environment.collectors.indexentries.IndexEntriesCollector`` * ``sphinx.ext.apidoc.INITPY`` * ``sphinx.ext.apidoc.shall_skip()`` * ``sphinx.io.FiletypeNotFoundError`` * ``sphinx.io.get_filetype()`` * ``sphinx.pycode.ModuleAnalyzer.encoding`` * ``sphinx.roles.Index`` * ``sphinx.util.detect_encoding()`` * ``sphinx.util.get_module_source()`` * ``sphinx.util.inspect.Signature`` * ``sphinx.util.inspect.safe_getmembers()`` * ``sphinx.writers.latex.LaTeXTranslator.settings.author`` * ``sphinx.writers.latex.LaTeXTranslator.settings.contentsname`` * ``sphinx.writers.latex.LaTeXTranslator.settings.docclass`` * ``sphinx.writers.latex.LaTeXTranslator.settings.docname`` * ``sphinx.writers.latex.LaTeXTranslator.settings.title`` * ``sphinx.writers.latex.ADDITIONAL_SETTINGS`` * ``sphinx.writers.latex.DEFAULT_SETTINGS`` * ``sphinx.writers.latex.LUALATEX_DEFAULT_FONTPKG`` * ``sphinx.writers.latex.PDFLATEX_DEFAULT_FONTPKG`` * ``sphinx.writers.latex.XELATEX_DEFAULT_FONTPKG`` * ``sphinx.writers.latex.XELATEX_GREEK_DEFAULT_FONTPKG`` Features added -------------- * #6910: inheritance_diagram: Make the background of diagrams transparent * #6446: duration: Add ``sphinx.ext.durations`` to inspect which documents slow down the build * #6837: LaTeX: Support a nested table * #7115: LaTeX: Allow to override LATEXOPTS and LATEXMKOPTS via environment variable * #6966: graphviz: Support ``:class:`` option * #6696: html: ``:scale:`` option of image/figure directive not working for SVG images (imagesize-1.2.0 or above is required) * #6994: imgconverter: Support illustrator file (.ai) to .png conversion * autodoc: Support Positional-Only Argument separator (PEP-570 compliant) * autodoc: Support type annotations for variables * #2755: autodoc: Add new event: :event:`autodoc-before-process-signature` * #2755: autodoc: Support type_comment style (ex. ``# type: (str) -> str``) annotation (python3.8+ or `typed_ast `_ is required) * #7051: autodoc: Support instance variables without defaults (PEP-526) * #6418: autodoc: Add a new extension ``sphinx.ext.autodoc.typehints``. It shows typehints as object description if ``autodoc_typehints = "description"`` set. This is an experimental extension and it will be integrated into autodoc core in Sphinx-3.0 * SphinxTranslator now calls visitor/departure method for super node class if visitor/departure method for original node class not found * #6418: Add new event: :event:`object-description-transform` * py domain: :rst:dir:`py:data` and :rst:dir:`py:attribute` take new options named ``:type:`` and ``:value:`` to describe its type and initial value * #6785: py domain: ``:py:attr:`` is able to refer properties again * #6772: apidoc: Add ``-q`` option for quiet mode Bugs fixed ---------- * #6925: html: Remove redundant type="text/javascript" from {%- endif %} {% endblock %} {% block rootrellink %}

  • Sphinx home |
  • Documentation »
    • {% endblock %} {% block header %}
    {% endblock %} ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.4005163 Sphinx-4.3.2/doc/_themes/sphinx13/static/0000755000076600000240000000000000000000000017470 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/doc/_themes/sphinx13/static/bodybg.png0000644000076600000240000000065500000000000021452 0ustar00tkomiyastaffPNG  IHDRW?iPLTEIDATx] `,Zcm#}78f]-+# ޓ௳{8Y?-9RkPFw4!in'[7=R=>RWN&)N4==QQu*Jʕ4$4oIFbhhx BQn9I@ BC3eB\$,]!$gHTHh)c!Bx?ߜfC[%?$SIIW؟>RGp+IENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/doc/_themes/sphinx13/static/footerbg.png0000644000076600000240000000026400000000000022007 0ustar00tkomiyastaffPNG  IHDR>PLTE,D.G/H0K2L3N3OղB=ZIDATxNC1}J>] ૃ`'DXs@~5&tLȥ/a/}ոbā@d"E:1IENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/doc/_themes/sphinx13/static/headerbg.png0000644000076600000240000000027500000000000021743 0ustar00tkomiyastaffPNG  IHDR>PLTEDhDiDj Gm Io Ks Mu Px Py PzmГZIDATxc`lf̜&`1À$-8,-͙MQP"I(a DLdQZd+2 RMӜM҂ÐM@0 Q9!;nIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/doc/_themes/sphinx13/static/listitem.png0000644000076600000240000000022500000000000022027 0ustar00tkomiyastaffPNG  IHDR \\IDATxcX ԍ8)-XaluFUUnV3,F[Alln) # +ԍON3#zIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/doc/_themes/sphinx13/static/relbg.png0000644000076600000240000000026700000000000021276 0ustar00tkomiyastaffPNG  IHDR>PLTE7T7U9X;Y<]>^@a@b%MLZIDATxc`JOb/eP+S`P Vr Q2 5bHMS`J d c(e`-S`J`GEE6)-1,U@-M!DI%H9IYBUJ,NIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/doc/_themes/sphinx13/static/sphinx13.css0000644000076600000240000001745200000000000021670 0ustar00tkomiyastaff/* * sphinx13.css * ~~~~~~~~~~~~ * * Sphinx stylesheet -- sphinx13 theme. * * :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS. * :license: BSD, see LICENSE for details. * */ @import url("basic.css"); /* -- page layout ----------------------------------------------------------- */ body { font-family: 'Open Sans', 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva', 'Verdana', sans-serif; font-size: 14px; text-align: center; background-image: url(bodybg.png); color: black; padding: 0; border-right: 1px solid #0a507a; border-left: 1px solid #0a507a; margin: 0 auto; min-width: 780px; max-width: 1080px; } .pageheader { background-image: url(headerbg.png); text-align: left; padding: 10px 15px; } .pageheader ul { float: right; color: white; list-style-type: none; padding-left: 0; margin-top: 30px; margin-right: 10px; } .pageheader li { float: left; margin: 0 0 0 10px; } .pageheader li a { border-radius: 1px; padding: 8px 12px; color: #f9f9f0; text-shadow: 0 0 5px rgba(0, 0, 0, 0.5); } .pageheader li a:hover { background-color: #f9f9f0; color: #0a507a; text-shadow: none; } div.document { background-color: white; text-align: left; } div.bodywrapper { margin: 0 240px 0 0; border-right: 1px solid #0a507a; } div.body { margin: 0; padding: 0.5em 20px 20px 20px; } div.related { font-size: 1em; color: white; } div.related ul { background-image: url(relbg.png); height: 1.9em; border-top: 1px solid #002e50; border-bottom: 1px solid #002e50; } div.related ul li { margin: 0 5px 0 0; padding: 0; float: left; } div.related ul li.right { float: right; margin-right: 5px; } div.related ul li a { margin: 0; padding: 0 5px 0 5px; line-height: 1.75em; color: #f9f9f0; text-shadow: 0px 0px 1px rgba(0, 0, 0, 0.5); } div.related ul li a:hover { color: white; /*text-decoration: underline;*/ text-shadow: 0px 0px 1px rgba(255, 255, 255, 0.5); } div.sphinxsidebarwrapper { position: relative; top: 0px; padding: 0; } div.sphinxsidebar { margin: 0; padding: 0 15px 15px 0; width: 210px; float: right; font-size: 1em; text-align: left; max-height: 0px; } div.sphinxsidebar .logo { font-size: 1.8em; color: #0A507A; font-weight: 300; text-align: center; } div.sphinxsidebar .logo img { vertical-align: middle; } div.sphinxsidebar .download a img { vertical-align: middle; } div.subscribeformwrapper { display: block; overflow: auto; margin-bottom: 1.2em; } div.sphinxsidebar input { border: 1px solid #aaa; font-family: 'Open Sans', 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva', 'Verdana', sans-serif; } div.sphinxsidebar .subscribeform { margin-top: 0; } div.sphinxsidebar .subscribeform input { border: 1px solid #aaa; font-size: 0.9em; float: left; padding: 0.25em 0.5em; box-sizing: border-box; } div.sphinxsidebar .subscribeform input[type="text"] { width: 60%; } div.sphinxsidebar .subscribeform input[type="submit"] { width: 40%; border-left: none; } div.sphinxsidebar h3 { font-size: 1.5em; border-top: 1px solid #0a507a; margin-top: 1em; margin-bottom: 0.5em; padding-top: 0.5em; } div.sphinxsidebar h4 { font-size: 1.2em; margin-bottom: 0; } div.sphinxsidebar h3, div.sphinxsidebar h4 { margin-right: -15px; margin-left: -15px; padding-right: 14px; padding-left: 14px; color: #333; font-weight: 300; /*text-shadow: 0px 0px 0.5px rgba(0, 0, 0, 0.4);*/ } div.sphinxsidebarwrapper > h3:first-child { margin-top: 0.5em; border: none; } div.sphinxsidebar h3 a { color: #333; } div.sphinxsidebar ul { color: #444; margin-top: 7px; padding: 0; line-height: 130%; } div.sphinxsidebar ul ul { margin-left: 20px; list-style-image: url(listitem.png); } div.footer { background-image: url(footerbg.png); color: #ccc; text-shadow: 0 0 .2px rgba(255, 255, 255, 0.8); padding: 3px 8px 3px 0; clear: both; font-size: 0.8em; text-align: right; } /* no need to make a visible link to Sphinx on the Sphinx page */ div.footer a { color: #ccc; } /* -- body styles ----------------------------------------------------------- */ p { margin: 0.8em 0 0.5em 0; } a { color: #A2881D; text-decoration: none; } a:hover { color: #E1C13F; } div.body a { text-decoration: underline; } h1 { margin: 10px 0 0 0; font-size: 2.4em; color: #0A507A; font-weight: 300; } h2 { margin: 1.em 0 0.2em 0; font-size: 1.5em; font-weight: 300; padding: 0; color: #174967; } h3 { margin: 1em 0 -0.3em 0; font-size: 1.3em; font-weight: 300; } div.body h1 a, div.body h2 a, div.body h3 a, div.body h4 a, div.body h5 a, div.body h6 a { text-decoration: none; } div.body h1 a tt, div.body h2 a tt, div.body h3 a tt, div.body h4 a tt, div.body h5 a tt, div.body h6 a tt { color: #0A507A !important; font-size: inherit !important; } a.headerlink { color: #0A507A !important; font-size: 12px; margin-left: 6px; padding: 0 4px 0 4px; text-decoration: none !important; float: right; } a.headerlink:hover { background-color: #ccc; color: white!important; } /* avoid font-size when :mod: role in headings */ h1 code, h2 code, h3 code, h4 code { font-size: inherit; } cite, code, tt { font-family: 'Consolas', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; font-size: 14px; letter-spacing: -0.02em; } table.deprecated code.literal { word-break: break-all; } tt { background-color: #f2f2f2; border: 1px solid #ddd; border-radius: 2px; color: #333; padding: 1px 0.2em; } tt.descname, tt.descclassname, tt.xref { border: 0; } hr { border: 1px solid #abc; margin: 2em; } a tt { border: 0; color: #a2881d; } a tt:hover { color: #e1c13f; } pre { font-family: 'Consolas', 'Courier New', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; font-size: 13px; letter-spacing: 0.015em; line-height: 120%; padding: 0.5em; border: 1px solid #ccc; border-radius: 2px; background-color: #f8f8f8; } pre a { color: inherit; text-decoration: underline; } td.linenos pre { padding: 0.5em 0; } div.quotebar { background-color: #f8f8f8; max-width: 250px; float: right; padding: 0px 7px; border: 1px solid #ccc; margin-left: 1em; } div.topic { background-color: #f8f8f8; } table { border-collapse: collapse; margin: 0 -0.5em 0 -0.5em; } table td, table th { padding: 0.2em 0.5em 0.2em 0.5em; } div.admonition, div.warning { font-size: 0.9em; margin: 1em 0 1em 0; border: 1px solid #86989B; border-radius: 2px; background-color: #f7f7f7; padding: 0; } div.admonition > p, div.warning > p { margin: 0.5em 1em 0.5em 1em; padding: 0; } div.admonition > pre, div.warning > pre { margin: 0.4em 1em 0.4em 1em; } div.admonition > p.admonition-title, div.warning > p.admonition-title { margin-top: 0.5em; font-weight: bold; } div.warning { border: 1px solid #940000; } div.admonition > ul, div.admonition > ol, div.warning > ul, div.warning > ol { margin: 0.1em 0.5em 0.5em 3em; padding: 0; } div.admonition div.highlight { background: none; } .viewcode-back { font-family: 'Open Sans', 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva', 'Verdana', sans-serif; } div.viewcode-block:target { background-color: #f4debf; border-top: 1px solid #ac9; border-bottom: 1px solid #ac9; } .contentstable { margin-left: 30px; margin: 0 auto; table-layout: fixed; } ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/doc/_themes/sphinx13/static/sphinxheader.png0000644000076600000240000002670700000000000022674 0ustar00tkomiyastaffPNG  IHDRKt ;-IDATx%Aq~N 'iG\#F]W 93v' ۧ;$IQdo2, -fs麯׼|˗G= ӡ]:T9I" Tퟖ,y̙#ϟuժ<(;x;L{WuP5mU.a;]{1;Ҿ]hv }'2RymT>4Pۯ];?٣o'y/iqlLww7D"ATP2̽5kĹE~{ٲ-wPQ,M@bA&X{ٻh){;{(;5}?sx̰ x=twv^"#$Z]3#כ7ѹ] _^ek j kk+E}JBccҢ%$N~˘x,c*\2"_/E/+O#==6J*M3%- 331p.M:ݻüys58s-Z46%٣0kU@K{Gѱr===vsƑhaú=46&&d~ h!n ̩>>M>;mU][t:r䰟aY\FQv={vFq?zTSGϞ=coFgӁ֣+pݜ1cF_ǏB 2r ;\vZ+/C:f_Tr+y<ˢѣ7%5 7sڠ]|Hi:`оe˦B|ʕ2ϗqCR[SP[\^cdQ PKw+M6KNoːoMON>.욒!W) ̰efMךukQQUŋ-ԒxE\Eeb?L&CkK` Xhր0]Oݻw\wntN} qDW+ET f͏+y+@Aa$#rr!Gn]|KrjNN:U|>=Ƭb}'`> 4"(^< 4V++d ^løY0ް\za?2d9g!}s;!!!S\NUTxM*ߪe:Nd6PPL~IZHz=r #Ĝhgtl[e/T{})B^=E,*~ I0ܶ6K_`BBTOɃ4Wc@oumYJ\?S9;BzȔ4qVkxVrS^=p\Ƙf'O6yӧ~E'm_En\?*m}2LNʄEC>ٙ*@4T33B§2>|["7N0iי3ǜȒhnfV~`ϞKfϞu .yٳgO" /׮k;r KmŜQ/s\}xE]1߰zQn`^vu3s{jP0jժegb Dfcn߾9 Cӂ7$tO,@\nRRd& #;嶛䞘X'6o^!0X A`ӺO0,|(fO%:W[;<ͣy/Cy|e2030Jd~;߰磬ÈiӺ?S*\*vG/ׯ_k0nذn;zIuR0@(+pTVsH!ڪCwXY"m  X )g}>@;WUb9XW0( ,E42^0hD)16}5%PF'}`eN y]ho߼'tl,ZD@#U]/ @]twwY͕6,[^Z1CHw'nܸ0 {?f'w)r`Jk޼jj4CZ]n< YL\Am]͡$5zt sCGnh2KewuWe7X!ׯ_ ƍkϙ3s}?9;ҒgVd;o-G.Q 6&È0Ȩ^gJ_"Ԣ)tq=0KJ` @أB_+7EW*iA\0()c>E`Hg\cǖL2rv%j)ZTFby e5Q6z5A<#T|.C,C,CC7b0V̒b9_:F{2&P@UͨՅ5B֟=f,Bdu'S9Ya U}TQz,jBw6&֣(T0v_G HP8_}k n+#G]=zJu(Rji44 d2n߾;n7Z)CfIVkT@Ԋך>@)oDt?,ϝ;.8]GRK^l-eT_Ge+% Ij,suDc` th] aB4⹜\ l^09Ƕ D212!iOLIY Y$윸f7X<;D{ -j1/lB"S^h2fŀD7j[õk|*Tz|$' I0hngq[DjyD4t#t[ _/X0KNFp6WP@y@=KHZZF`p+/܋ʭXд!#p/ #DZkqלϟV֦MUq&KedE@fkr`6K,'S `P:,}21Dj9F/jGP0]{q_6pLYWȲ2ׅt2;An:thWUSG46(UVG`}.1"V I0@)s&5ScR;vlFYJ7"eMAIʕ+ qph>+;J>:Svb}8 xzH4=AAA̡Y?O>NwM g>'7 Y(xOh|16d%J$XM0\ьPoCsUd F#WoK%t腲 D!&#SƿRC "7yf_H) f9~M)/j)k (ұc\=g>PInphb I0PL9q}Ji{G،&a~rіVD/ !VA?Rf>k$ t!'ʮU JM 'KciD->dyu)~V] :wP|OVǚnA(B 5, ##4&>O^A8Fqy2DOh*j9Y>`CY2'B|ڥR=~|{e.˖TkX0U۷oZI--g,JK)m:}. -EVJĜ۷nbŽy`T% XGV3fo O|2HA HȘ#zHōWED$^ֹsjI73()):FЕj`4E@',cbI1˛6#bIk?T?s^/^xVh] =mĬ Tc~`R}V ZÇ@h3 jшB9NxJA eN;_bŘFZ%Pd9}l(1i?X&5UZ[+!-09kPemmŬ!@e1h}O[Úp:PAg@zh'Rj F`8@ߞePVtp2G3.Jͩor!^IDBphYq#>_` ])kJ"d$H) H\Uy@KK[ $LV=h=dܙJq<~lS.fS7-}f+ 3iHY 8}A,gMk`/eN¥ӈUڹJcp#$1XfE`sְ}L1 bBBѢb8砘8ytTJH Z /"`Zf*1\IW$ `g7Pp'KZa=t*!< 10_L_+Q~@ $@dXd0؅䓳Cv˽ gǮVfj q `PEn!8t>Xl5-Ąӧp'XMI(H eɯa7&1и@&#`MbEÀ-VBRQ2ӷ@kEbVhi{I $ BffɓPC4BҦ*p錪.pP2EO%>CC,4[CaElB/(m4G* 3J ={XЕDSQFr3ja8|!p86hB#)7_\U+~$F@ 2](4us?CGJ_R|a<)$@ ,H^`'5jk86(lf͚v@ez/V`}a:9+RH.P3<qPOe J w\c.̟|XvU 9u!ħssE>[-f! ljCuYo!r,[Bswոx [h{xnf.G ,K|J\h?ԩ")'Ny5DAvfC{{ι%eK}`!6x_!1U5}i;7!B#8ӝ6S%eW# Jǃ.`]t9޺rwWQǓ.IxZݻ:٢6mb}I* LENZܻyo܀ 4JI"$"JiC&rEe17*c5WbLfKzeUՎ :7M(X<T^ϥJ ׵sU\IӖOLJa9=Hxv={ ơӼc!yZӰ{e2gg73r<ddjÿ.KJ`aJ ̝Ov*W\Ǐo]a{1Y<{w78ڲt*J3{a `%2QPdoD].8ʕ+NN]bEMTI?e΅?YQ{m~Rk#b X ]J۰amkXytSOqaƆB NKxZAA`G`EU4I.t'OR-DRq3\hv-GBH;}3(6ݺug!w4#1h=r܌wd,g%LAB{o_z]~Mg.;?dxy=F>|R6F;::fU8d~a8%h>11&&&w)) tťA=D3zFsoٲ֔膵&o߮ Æ #F_R`اOry+~0\ ;p]S7Zn J`bcc@˾um0kYXsTeBy`yN GgΜ2=hJȎm,)S&D}NG9#А?Y)vtBw95и0 !#b%:v ?2ҏ4ҞNEҍ\k~̸tǨ>-. Jv#g?0&x+/:q0%&F2XNA @Ç?u6çOf3du~ϧXmY\`lb4gF#TE?ehaܸ1;hMoĉÿX0+\:FvDM xar~}eG?ߙf':ߔ|" zd*Z<܀?h Yq)e3:zk4cd}MZg8+1X;L4f9*R0P 3g);v*X9} NjպL:.絹)[}$ZƮͬa^^BCHn[kIhukpq3x#v)9dɓGNߙB*^L$1{G)bcu!ʕK),c$B`ŠnGCSjGF '*/ 8|L N^xY؂sףmD~NXG܋}aV2s&DXǻb5&ܽu=/E#t>mQu8Y?\e2`taV؟%cQƠசEym E`?zx#cmۈ)&8>+i&@+"<&N40#"{ {*σ!]ѣK,t{egWcD񴪠•. } 1,M*KSSS^zL?thic )Zxvɩ/.$se5Ik:SR-"i'l)>G#'%E.%<<<Ρ`e/͹s'\), cx_Yi<X~aBe>fZAYlo_:\L LǞcGo k;-^剻\N/H7('0Djq 7MDEi&t]hl|؏g,c6/?x:u-̢ol_CZ͸)6z+61E…SSTEW/LR\ӷ0?Pj|$]6[Pv_뗭[7x=z2|q];x;vm?t]vZMLd85G;&@Tc)5."JehRECzN'`,t?G9tN _U $`uX{3*&:thա*xB3xp]'[h: ƨwXd yW/{֗CtKCgWPD*][]cԟLQ ]?\K*2 oDYewsbta<[s@#.#mR˕ZlJ l@,vbHDZm21SVd0<8D<3gΘIHYZFIHZWZ.FA¿=.\s~Pg]pd52h.B` #aڈڬcUM'(n;ZG-i x{J248րD1Ͼt͡BX:5&t+гD6꩐~6ʟKy XV2jd3@Z59@^ +bv$AhkH$4u0QCѕv?\&[ac8\&^43 ]K>sFzly]S`x o\0>%\X}5;:/E>X @)k_4 E>SoQ*TA_s(OS J$)1srRR_x4*[ Hǫ^,k`Dy=En4)[t@ $3 qH H H H 콗#IENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1595520462.0 Sphinx-4.3.2/doc/_themes/sphinx13/theme.conf0000644000076600000240000000011000000000000020142 0ustar00tkomiyastaff[theme] inherit = basic stylesheet = sphinx13.css pygments_style = trac ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/changes.rst0000644000076600000240000000026500000000000015245 0ustar00tkomiyastaff:tocdepth: 1 .. default-role:: any .. _changes: ========= Changelog ========= .. raw:: latex \addtocontents{toc}{\protect\setcounter{tocdepth}{1}}% .. include:: ../CHANGES ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/conf.py0000644000076600000240000001340100000000000014376 0ustar00tkomiyastaff# Sphinx documentation build configuration file import re import sphinx extensions = ['sphinx.ext.autodoc', 'sphinx.ext.doctest', 'sphinx.ext.todo', 'sphinx.ext.autosummary', 'sphinx.ext.extlinks', 'sphinx.ext.intersphinx', 'sphinx.ext.viewcode', 'sphinx.ext.inheritance_diagram'] root_doc = 'contents' templates_path = ['_templates'] exclude_patterns = ['_build'] project = 'Sphinx' copyright = '2007-2021, Georg Brandl and the Sphinx team' version = sphinx.__display_version__ release = version show_authors = True html_theme = 'sphinx13' html_theme_path = ['_themes'] modindex_common_prefix = ['sphinx.'] html_static_path = ['_static'] html_sidebars = {'index': ['indexsidebar.html', 'searchbox.html']} html_title = 'Sphinx documentation' html_additional_pages = {'index': 'index.html'} html_use_opensearch = 'https://www.sphinx-doc.org/en/master' html_baseurl = 'https://www.sphinx-doc.org/en/master/' html_favicon = '_static/favicon.svg' htmlhelp_basename = 'Sphinxdoc' epub_theme = 'epub' epub_basename = 'sphinx' epub_author = 'Georg Brandl' epub_publisher = 'https://www.sphinx-doc.org/' epub_uid = 'web-site' epub_scheme = 'url' epub_identifier = epub_publisher epub_pre_files = [('index.xhtml', 'Welcome')] epub_post_files = [('usage/installation.xhtml', 'Installing Sphinx'), ('develop.xhtml', 'Sphinx development')] epub_exclude_files = ['_static/opensearch.xml', '_static/doctools.js', '_static/jquery.js', '_static/searchtools.js', '_static/underscore.js', '_static/basic.css', '_static/language_data.js', 'search.html', '_static/websupport.js'] epub_fix_images = False epub_max_image_width = 0 epub_show_urls = 'inline' epub_use_index = False epub_guide = (('toc', 'contents.xhtml', 'Table of Contents'),) epub_description = 'Sphinx documentation generator system manual' latex_documents = [('contents', 'sphinx.tex', 'Sphinx Documentation', 'Georg Brandl', 'manual', 1)] latex_logo = '_static/sphinx.png' latex_elements = { 'fontenc': r'\usepackage[LGR,X2,T1]{fontenc}', 'passoptionstopackages': r''' \PassOptionsToPackage{svgnames}{xcolor} ''', 'preamble': r''' \DeclareUnicodeCharacter{229E}{\ensuremath{\boxplus}} \setcounter{tocdepth}{3}% depth of what main TOC shows (3=subsubsection) \setcounter{secnumdepth}{1}% depth of section numbering ''', # fix missing index entry due to RTD doing only once pdflatex after makeindex 'printindex': r''' \IfFileExists{\jobname.ind} {\footnotesize\raggedright\printindex} {\begin{sphinxtheindex}\end{sphinxtheindex}} ''', } latex_show_urls = 'footnote' latex_use_xindy = True autodoc_member_order = 'groupwise' autosummary_generate = False todo_include_todos = True extlinks = {'duref': ('https://docutils.sourceforge.io/docs/ref/rst/' 'restructuredtext.html#%s', ''), 'durole': ('https://docutils.sourceforge.io/docs/ref/rst/' 'roles.html#%s', ''), 'dudir': ('https://docutils.sourceforge.io/docs/ref/rst/' 'directives.html#%s', '')} man_pages = [ ('contents', 'sphinx-all', 'Sphinx documentation generator system manual', 'Georg Brandl', 1), ('man/sphinx-build', 'sphinx-build', 'Sphinx documentation generator tool', '', 1), ('man/sphinx-quickstart', 'sphinx-quickstart', 'Sphinx documentation ' 'template generator', '', 1), ('man/sphinx-apidoc', 'sphinx-apidoc', 'Sphinx API doc generator tool', '', 1), ('man/sphinx-autogen', 'sphinx-autogen', 'Generate autodoc stub pages', '', 1), ] texinfo_documents = [ ('contents', 'sphinx', 'Sphinx Documentation', 'Georg Brandl', 'Sphinx', 'The Sphinx documentation builder.', 'Documentation tools', 1), ] intersphinx_mapping = { 'python': ('https://docs.python.org/3/', None), 'requests': ('https://requests.readthedocs.io/en/master', None), } # Sphinx document translation with sphinx gettext feature uses these settings: locale_dirs = ['locale/'] gettext_compact = False # -- Extension interface ------------------------------------------------------- from sphinx import addnodes # noqa event_sig_re = re.compile(r'([a-zA-Z-]+)\s*\((.*)\)') def parse_event(env, sig, signode): m = event_sig_re.match(sig) if not m: signode += addnodes.desc_name(sig, sig) return sig name, args = m.groups() signode += addnodes.desc_name(name, name) plist = addnodes.desc_parameterlist() for arg in args.split(','): arg = arg.strip() plist += addnodes.desc_parameter(arg, arg) signode += plist return name def setup(app): from sphinx.ext.autodoc import cut_lines from sphinx.util.docfields import GroupedField app.connect('autodoc-process-docstring', cut_lines(4, what=['module'])) app.add_object_type('confval', 'confval', objname='configuration value', indextemplate='pair: %s; configuration value') app.add_object_type('setuptools-confval', 'setuptools-confval', objname='setuptools configuration value', indextemplate='pair: %s; setuptools configuration value') fdesc = GroupedField('parameter', label='Parameters', names=['param'], can_collapse=True) app.add_object_type('event', 'event', 'pair: %s; event', parse_event, doc_field_types=[fdesc]) # workaround for RTD from sphinx.util import logging logger = logging.getLogger(__name__) app.info = lambda *args, **kwargs: logger.info(*args, **kwargs) app.warn = lambda *args, **kwargs: logger.warning(*args, **kwargs) app.debug = lambda *args, **kwargs: logger.debug(*args, **kwargs) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/contents.rst0000644000076600000240000000075600000000000015477 0ustar00tkomiyastaff.. _contents: Sphinx documentation contents ============================= .. toctree:: :maxdepth: 2 usage/index tutorial/index development/index man/index templating latex extdev/index internals/index faq glossary changes examples Indices and tables ================== .. only:: builder_html * :ref:`genindex` * :ref:`modindex` * :ref:`search` * :ref:`glossary` .. only:: not builder_html * :ref:`modindex` * :ref:`glossary` ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.4026616 Sphinx-4.3.2/doc/development/0000755000076600000240000000000000000000000015422 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/doc/development/builders.rst0000644000076600000240000000217700000000000017774 0ustar00tkomiyastaffConfiguring builders ==================== Discover builders by entry point -------------------------------- .. versionadded:: 1.6 :term:`builder` extensions can be discovered by means of `entry points`_ so that they do not have to be listed in the :confval:`extensions` configuration value. Builder extensions should define an entry point in the ``sphinx.builders`` group. The name of the entry point needs to match your builder's :attr:`~.Builder.name` attribute, which is the name passed to the :option:`sphinx-build -b` option. The entry point value should equal the dotted name of the extension module. Here is an example of how an entry point for 'mybuilder' can be defined in the extension's ``setup.py`` .. code-block:: python setup( # ... entry_points={ 'sphinx.builders': [ 'mybuilder = my.extension.module', ], } ) Note that it is still necessary to register the builder using :meth:`~.Sphinx.add_builder` in the extension's :func:`setup` function. .. _entry points: https://setuptools.readthedocs.io/en/latest/setuptools.html#dynamic-discovery-of-services-and-plugins ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/doc/development/index.rst0000644000076600000240000000114300000000000017262 0ustar00tkomiyastaff================ Extending Sphinx ================ This guide is aimed at giving a quick introduction for those wishing to develop their own extensions for Sphinx. Sphinx possesses significant extensibility capabilities including the ability to hook into almost every point of the build process. If you simply wish to use Sphinx with existing extensions, refer to :doc:`/usage/index`. For a more detailed discussion of the extension interface see :doc:`/extdev/index`. .. toctree:: :maxdepth: 2 overview tutorials/index builders .. toctree:: :caption: Theming :maxdepth: 2 theming ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/doc/development/overview.rst0000644000076600000240000000201000000000000020013 0ustar00tkomiyastaffDeveloping extensions overview ============================== This page contains general information about developing Sphinx extensions. Make an extension depend on another extension --------------------------------------------- Sometimes your extension depends on the functionality of another Sphinx extension. Most Sphinx extensions are activated in a project's :file:`conf.py` file, but this is not available to you as an extension developer. .. module:: sphinx.application :noindex: To ensure that another extension is activated as a part of your own extension, use the :meth:`Sphinx.setup_extension` method. This will activate another extension at run-time, ensuring that you have access to its functionality. For example, the following code activates the ``recommonmark`` extension: .. code-block:: python def setup(app): app.setup_extension("recommonmark") .. note:: Since your extension will depend on another, make sure to include it as a part of your extension's installation requirements. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/development/theming.rst0000644000076600000240000002762400000000000017622 0ustar00tkomiyastaffHTML theme development ====================== .. versionadded:: 0.6 .. note:: This document provides information about creating your own theme. If you simply wish to use a pre-existing HTML themes, refer to :doc:`/usage/theming`. Sphinx supports changing the appearance of its HTML output via *themes*. A theme is a collection of HTML templates, stylesheet(s) and other static files. Additionally, it has a configuration file which specifies from which theme to inherit, which highlighting style to use, and what options exist for customizing the theme's look and feel. Themes are meant to be project-unaware, so they can be used for different projects without change. .. note:: See :ref:`dev-extensions` for more information that may be helpful in developing themes. Creating themes --------------- Themes take the form of either a directory or a zipfile (whose name is the theme name), containing the following: * A :file:`theme.conf` file. * HTML templates, if needed. * A ``static/`` directory containing any static files that will be copied to the output static directory on build. These can be images, styles, script files. The :file:`theme.conf` file is in INI format [1]_ (readable by the standard Python :mod:`ConfigParser` module) and has the following structure: .. sourcecode:: ini [theme] inherit = base theme stylesheet = main CSS name pygments_style = stylename sidebars = localtoc.html, relations.html, sourcelink.html, searchbox.html [options] variable = default value * The **inherit** setting gives the name of a "base theme", or ``none``. The base theme will be used to locate missing templates (most themes will not have to supply most templates if they use ``basic`` as the base theme), its options will be inherited, and all of its static files will be used as well. If you want to also inherit the stylesheet, include it via CSS' ``@import`` in your own. * The **stylesheet** setting gives the name of a CSS file which will be referenced in the HTML header. If you need more than one CSS file, either include one from the other via CSS' ``@import``, or use a custom HTML template that adds ```` tags as necessary. Setting the :confval:`html_style` config value will override this setting. * The **pygments_style** setting gives the name of a Pygments style to use for highlighting. This can be overridden by the user in the :confval:`pygments_style` config value. * The **pygments_dark_style** setting gives the name of a Pygments style to use for highlighting when the CSS media query ``(prefers-color-scheme: dark)`` evaluates to true. It is injected into the page using :meth:`~Sphinx.add_css_file()`. * The **sidebars** setting gives the comma separated list of sidebar templates for constructing sidebars. This can be overridden by the user in the :confval:`html_sidebars` config value. * The **options** section contains pairs of variable names and default values. These options can be overridden by the user in :confval:`html_theme_options` and are accessible from all templates as ``theme_``. .. versionadded:: 1.7 sidebar settings .. _distribute-your-theme: Distribute your theme as a Python package ----------------------------------------- As a way to distribute your theme, you can use Python package. Python package brings to users easy setting up ways. To distribute your theme as a Python package, please define an entry point called ``sphinx.html_themes`` in your ``setup.py`` file, and write a ``setup()`` function to register your themes using ``add_html_theme()`` API in it:: # 'setup.py' setup( ... entry_points = { 'sphinx.html_themes': [ 'name_of_theme = your_package', ] }, ... ) # 'your_package.py' from os import path def setup(app): app.add_html_theme('name_of_theme', path.abspath(path.dirname(__file__))) If your theme package contains two or more themes, please call ``add_html_theme()`` twice or more. .. versionadded:: 1.2 'sphinx_themes' entry_points feature. .. deprecated:: 1.6 ``sphinx_themes`` entry_points has been deprecated. .. versionadded:: 1.6 ``sphinx.html_themes`` entry_points feature. Templating ---------- The :doc:`guide to templating ` is helpful if you want to write your own templates. What is important to keep in mind is the order in which Sphinx searches for templates: * First, in the user's ``templates_path`` directories. * Then, in the selected theme. * Then, in its base theme, its base's base theme, etc. When extending a template in the base theme with the same name, use the theme name as an explicit directory: ``{% extends "basic/layout.html" %}``. From a user ``templates_path`` template, you can still use the "exclamation mark" syntax as described in the templating document. .. _theming-static-templates: Static templates ~~~~~~~~~~~~~~~~ Since theme options are meant for the user to configure a theme more easily, without having to write a custom stylesheet, it is necessary to be able to template static files as well as HTML files. Therefore, Sphinx supports so-called "static templates", like this: If the name of a file in the ``static/`` directory of a theme (or in the user's static path, for that matter) ends with ``_t``, it will be processed by the template engine. The ``_t`` will be left from the final file name. For example, the *classic* theme has a file ``static/classic.css_t`` which uses templating to put the color options into the stylesheet. When a documentation is built with the classic theme, the output directory will contain a ``_static/classic.css`` file where all template tags have been processed. Use custom page metadata in HTML templates ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Any key / value pairs in :doc:`field lists ` that are placed *before* the page's title will be available to the Jinja template when building the page within the :data:`meta` attribute. For example, if a page had the following text before its first title: .. code-block:: rst :mykey: My value My first title -------------- Then it could be accessed within a Jinja template like so: .. code-block:: jinja {%- if meta is mapping %} {{ meta.get("mykey") }} {%- endif %} Note the check that ``meta`` is a dictionary ("mapping" in Jinja terminology) to ensure that using it in this way is valid. Defining custom template functions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Sometimes it is useful to define your own function in Python that you wish to then use in a template. For example, if you'd like to insert a template value with logic that depends on the user's configuration in the project, or if you'd like to include non-trivial checks and provide friendly error messages for incorrect configuration in the template. To define your own template function, you'll need to define two functions inside your module: * A **page context event handler** (or **registration**) function. This is connected to the :class:`.Sphinx` application via an event callback. * A **template function** that you will use in your Jinja template. First, define the registration function, which accepts the arguments for :event:`html-page-context`. Within the registration function, define the template function that you'd like to use within Jinja. The template function should return a string or Python objects (lists, dictionaries) with strings inside that Jinja uses in the templating process .. note:: The template function will have access to all of the variables that are passed to the registration function. At the end of the registration function, add the template function to the Sphinx application's context with ``context['template_func'] = template_func``. Finally, in your extension's ``setup()`` function, add your registration function as a callback for :event:`html-page-context`. .. code-block:: python # The registration function def setup_my_func(app, pagename, templatename, context, doctree): # The template function def my_func(mystring): return "Your string is %s" % mystring # Add it to the page's context context['my_func'] = my_func # Your extension's setup function def setup(app): app.connect("html-page-context", setup_my_func) Now, you will have access to this function in jinja like so: .. code-block:: jinja
    {{ my_func("some string") }}
    Add your own static files to the build assets ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you are packaging your own build assets with an extension (e.g., a CSS or JavaScript file), you need to ensure that they are placed in the ``_static/`` folder of HTML outputs. To do so, you may copy them directly into a build's ``_static/`` folder at build time, generally via an event hook. Here is some sample code to accomplish this: .. code-block:: python from os import path from sphinx.util.fileutil import copy_asset_file def copy_custom_files(app, exc): if app.builder.format == 'html' and not exc: staticdir = path.join(app.builder.outdir, '_static') copy_asset_file('path/to/myextension/_static/myjsfile.js', staticdir) def setup(app): app.connect('builder-inited', copy_custom_files) Inject JavaScript based on user configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If your extension makes use of JavaScript, it can be useful to allow users to control its behavior using their Sphinx configuration. However, this can be difficult to do if your JavaScript comes in the form of a static library (which will not be built with Jinja). There are two ways to inject variables into the JavaScript space based on user configuration. First, you may append ``_t`` to the end of any static files included with your extension. This will cause Sphinx to process these files with the templating engine, allowing you to embed variables and control behavior. For example, the following JavaScript structure: .. code-block:: bash mymodule/ ├── _static │   └── myjsfile.js_t └── mymodule.py Will result in the following static file placed in your HTML's build output: .. code-block:: bash _build/ └── html └── _static    └── myjsfile.js See :ref:`theming-static-templates` for more information. Second, you may use the :meth:`Sphinx.add_js_file` method without pointing it to a file. Normally, this method is used to insert a new JavaScript file into your site. However, if you do *not* pass a file path, but instead pass a string to the "body" argument, then this text will be inserted as JavaScript into your site's head. This allows you to insert variables into your project's JavaScript from Python. For example, the following code will read in a user-configured value and then insert this value as a JavaScript variable, which your extension's JavaScript code may use: .. code-block:: python # This function reads in a variable and inserts it into JavaScript def add_js_variable(app): # This is a configuration that you've specified for users in `conf.py` js_variable = app.config['my_javascript_variable'] js_text = "var my_variable = '%s';" % js_variable app.add_js_file(None, body=js_text) # We connect this function to the step after the builder is initialized def setup(app): # Tell Sphinx about this configuration variable app.add_config_value('my_javascript_variable') # Run the function after the builder is initialized app.connect('builder-inited', add_js_variable) As a result, in your theme you can use code that depends on the presence of this variable. Users can control the variable's value by defining it in their :file:`conf.py` file. .. [1] It is not an executable Python file, as opposed to :file:`conf.py`, because that would pose an unnecessary security risk if themes are shared. ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1639903107.404758 Sphinx-4.3.2/doc/development/tutorials/0000755000076600000240000000000000000000000017450 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/development/tutorials/autodoc_ext.rst0000644000076600000240000000762300000000000022530 0ustar00tkomiyastaff.. _autodoc_ext_tutorial: Developing autodoc extension for IntEnum ======================================== The objective of this tutorial is to create an extension that adds support for new type for autodoc. This autodoc extension will format the ``IntEnum`` class from Python standard library. (module ``enum``) Overview -------- We want the extension that will create auto-documentation for IntEnum. ``IntEnum`` is the integer enum class from standard library ``enum`` module. Currently this class has no special auto documentation behavior. We want to add following to autodoc: * A new ``autointenum`` directive that will document the ``IntEnum`` class. * The generated documentation will have all the enum possible values with names. * The ``autointenum`` directive will have an option ``:hex:`` which will cause the integers be printed in hexadecimal form. Prerequisites ------------- We need the same setup as in :doc:`the previous extensions `. This time, we will be putting out extension in a file called :file:`autodoc_intenum.py`. The :file:`my_enums.py` will contain the sample enums we will document. Here is an example of the folder structure you might obtain: .. code-block:: text └── source    ├── _ext │   └── autodoc_intenum.py    ├── conf.py    ├── index.rst    └── my_enums.py Writing the extension --------------------- Start with ``setup`` function for the extension. .. literalinclude:: examples/autodoc_intenum.py :language: python :linenos: :pyobject: setup The :meth:`~Sphinx.setup_extension` method will pull the autodoc extension because our new extension depends on autodoc. :meth:`~Sphinx.add_autodocumenter` is the method that registers our new auto documenter class. We want to import certain objects from the autodoc extension: .. literalinclude:: examples/autodoc_intenum.py :language: python :linenos: :lines: 1-7 There are several different documenter classes such as ``MethodDocumenter`` or ``AttributeDocumenter`` available in the autodoc extension but our new class is the subclass of ``ClassDocumenter`` which a documenter class used by autodoc to document classes. This is the definition of our new the auto-documenter class: .. literalinclude:: examples/autodoc_intenum.py :language: python :linenos: :pyobject: IntEnumDocumenter Important attributes of the new class: **objtype** This attribute determines the ``auto`` directive name. In this case the auto directive will be ``autointenum``. **directivetype** This attribute sets the generated directive name. In this example the generated directive will be ``.. :py:class::``. **priority** the larger the number the higher is the priority. We want our documenter be higher priority than the parent. **option_spec** option specifications. We copy the parent class options and add a new option *hex*. Overridden members: **can_document_member** This member is important to override. It should return *True* when the passed object can be documented by this class. **add_directive_header** This method generates the directive header. We add **:final:** directive option. Remember to call **super** or no directive will be generated. **add_content** This method generates the body of the class documentation. After calling the super method we generate lines for enum description. Using the extension ------------------- You can now use the new autodoc directive to document any ``IntEnum``. For example, you have the following ``IntEnum``: .. code-block:: python :caption: my_enums.py class Colors(IntEnum): """Colors enumerator""" NONE = 0 RED = 1 GREEN = 2 BLUE = 3 This will be the documentation file with auto-documentation directive: .. code-block:: rst :caption: index.rst .. autointenum:: my_enums.Colors ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.4064553 Sphinx-4.3.2/doc/development/tutorials/examples/0000755000076600000240000000000000000000000021266 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163739.0 Sphinx-4.3.2/doc/development/tutorials/examples/README.rst0000644000076600000240000000066600000000000022765 0ustar00tkomiyastaff:orphan: Tutorial examples ================= This directory contains a number of examples used in the tutorials. These are intended to be increasingly complex to demonstrate the various features of Sphinx, but should aim to be as complicated as necessary but no more. Individual sections are referenced by line numbers, meaning if you make changes to the source files, you should update the references in the documentation accordingly. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/development/tutorials/examples/autodoc_intenum.py0000644000076600000240000000323700000000000025042 0ustar00tkomiyastafffrom enum import IntEnum from typing import Any, Optional from docutils.statemachine import StringList from sphinx.application import Sphinx from sphinx.ext.autodoc import ClassDocumenter, bool_option class IntEnumDocumenter(ClassDocumenter): objtype = 'intenum' directivetype = 'class' priority = 10 + ClassDocumenter.priority option_spec = dict(ClassDocumenter.option_spec) option_spec['hex'] = bool_option @classmethod def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any) -> bool: return isinstance(member, IntEnum) def add_directive_header(self, sig: str) -> None: super().add_directive_header(sig) self.add_line(' :final:', self.get_sourcename()) def add_content(self, more_content: Optional[StringList], no_docstring: bool = False ) -> None: super().add_content(more_content, no_docstring) source_name = self.get_sourcename() enum_object: IntEnum = self.object use_hex = self.options.hex self.add_line('', source_name) for enum_value in enum_object: the_value_name = enum_value.name the_value_value = enum_value.value if use_hex: the_value_value = hex(the_value_value) self.add_line( f"**{the_value_name}**: {the_value_value}", source_name) self.add_line('', source_name) def setup(app: Sphinx) -> None: app.setup_extension('sphinx.ext.autodoc') # Require autodoc extension app.add_autodocumenter(IntEnumDocumenter) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163739.0 Sphinx-4.3.2/doc/development/tutorials/examples/helloworld.py0000644000076600000240000000062000000000000024011 0ustar00tkomiyastafffrom docutils import nodes from docutils.parsers.rst import Directive class HelloWorld(Directive): def run(self): paragraph_node = nodes.paragraph(text='Hello World!') return [paragraph_node] def setup(app): app.add_directive("helloworld", HelloWorld) return { 'version': '0.1', 'parallel_read_safe': True, 'parallel_write_safe': True, } ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/development/tutorials/examples/recipe.py0000644000076600000240000001172700000000000023117 0ustar00tkomiyastafffrom collections import defaultdict from docutils.parsers.rst import directives from sphinx import addnodes from sphinx.directives import ObjectDescription from sphinx.domains import Domain, Index from sphinx.roles import XRefRole from sphinx.util.nodes import make_refnode class RecipeDirective(ObjectDescription): """A custom directive that describes a recipe.""" has_content = True required_arguments = 1 option_spec = { 'contains': directives.unchanged_required, } def handle_signature(self, sig, signode): signode += addnodes.desc_name(text=sig) return sig def add_target_and_index(self, name_cls, sig, signode): signode['ids'].append('recipe' + '-' + sig) if 'contains' in self.options: ingredients = [ x.strip() for x in self.options.get('contains').split(',')] recipes = self.env.get_domain('recipe') recipes.add_recipe(sig, ingredients) class IngredientIndex(Index): """A custom index that creates an ingredient matrix.""" name = 'ingredient' localname = 'Ingredient Index' shortname = 'Ingredient' def generate(self, docnames=None): content = defaultdict(list) recipes = {name: (dispname, typ, docname, anchor) for name, dispname, typ, docname, anchor, _ in self.domain.get_objects()} recipe_ingredients = self.domain.data['recipe_ingredients'] ingredient_recipes = defaultdict(list) # flip from recipe_ingredients to ingredient_recipes for recipe_name, ingredients in recipe_ingredients.items(): for ingredient in ingredients: ingredient_recipes[ingredient].append(recipe_name) # convert the mapping of ingredient to recipes to produce the expected # output, shown below, using the ingredient name as a key to group # # name, subtype, docname, anchor, extra, qualifier, description for ingredient, recipe_names in ingredient_recipes.items(): for recipe_name in recipe_names: dispname, typ, docname, anchor = recipes[recipe_name] content[ingredient].append( (dispname, 0, docname, anchor, docname, '', typ)) # convert the dict to the sorted list of tuples expected content = sorted(content.items()) return content, True class RecipeIndex(Index): """A custom index that creates an recipe matrix.""" name = 'recipe' localname = 'Recipe Index' shortname = 'Recipe' def generate(self, docnames=None): content = defaultdict(list) # sort the list of recipes in alphabetical order recipes = self.domain.get_objects() recipes = sorted(recipes, key=lambda recipe: recipe[0]) # generate the expected output, shown below, from the above using the # first letter of the recipe as a key to group thing # # name, subtype, docname, anchor, extra, qualifier, description for name, dispname, typ, docname, anchor, _ in recipes: content[dispname[0].lower()].append( (dispname, 0, docname, anchor, docname, '', typ)) # convert the dict to the sorted list of tuples expected content = sorted(content.items()) return content, True class RecipeDomain(Domain): name = 'recipe' label = 'Recipe Sample' roles = { 'ref': XRefRole() } directives = { 'recipe': RecipeDirective, } indices = { RecipeIndex, IngredientIndex } initial_data = { 'recipes': [], # object list 'recipe_ingredients': {}, # name -> object } def get_full_qualified_name(self, node): return '{}.{}'.format('recipe', node.arguments[0]) def get_objects(self): for obj in self.data['recipes']: yield(obj) def resolve_xref(self, env, fromdocname, builder, typ, target, node, contnode): match = [(docname, anchor) for name, sig, typ, docname, anchor, prio in self.get_objects() if sig == target] if len(match) > 0: todocname = match[0][0] targ = match[0][1] return make_refnode(builder, fromdocname, todocname, targ, contnode, targ) else: print('Awww, found nothing') return None def add_recipe(self, signature, ingredients): """Add a new recipe to the domain.""" name = '{}.{}'.format('recipe', signature) anchor = 'recipe-{}'.format(signature) self.data['recipe_ingredients'][name] = ingredients # name, dispname, type, docname, anchor, priority self.data['recipes'].append( (name, signature, 'Recipe', self.env.docname, anchor, 0)) def setup(app): app.add_domain(RecipeDomain) return { 'version': '0.1', 'parallel_read_safe': True, 'parallel_write_safe': True, } ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/doc/development/tutorials/examples/todo.py0000644000076600000240000000757300000000000022621 0ustar00tkomiyastafffrom docutils import nodes from docutils.parsers.rst import Directive from sphinx.locale import _ from sphinx.util.docutils import SphinxDirective class todo(nodes.Admonition, nodes.Element): pass class todolist(nodes.General, nodes.Element): pass def visit_todo_node(self, node): self.visit_admonition(node) def depart_todo_node(self, node): self.depart_admonition(node) class TodolistDirective(Directive): def run(self): return [todolist('')] class TodoDirective(SphinxDirective): # this enables content in the directive has_content = True def run(self): targetid = 'todo-%d' % self.env.new_serialno('todo') targetnode = nodes.target('', '', ids=[targetid]) todo_node = todo('\n'.join(self.content)) todo_node += nodes.title(_('Todo'), _('Todo')) self.state.nested_parse(self.content, self.content_offset, todo_node) if not hasattr(self.env, 'todo_all_todos'): self.env.todo_all_todos = [] self.env.todo_all_todos.append({ 'docname': self.env.docname, 'lineno': self.lineno, 'todo': todo_node.deepcopy(), 'target': targetnode, }) return [targetnode, todo_node] def purge_todos(app, env, docname): if not hasattr(env, 'todo_all_todos'): return env.todo_all_todos = [todo for todo in env.todo_all_todos if todo['docname'] != docname] def merge_todos(app, env, docnames, other): if not hasattr(env, 'todo_all_todos'): env.todo_all_todos = [] if hasattr(other, 'todo_all_todos'): env.todo_all_todos.extend(other.todo_all_todos) def process_todo_nodes(app, doctree, fromdocname): if not app.config.todo_include_todos: for node in doctree.traverse(todo): node.parent.remove(node) # Replace all todolist nodes with a list of the collected todos. # Augment each todo with a backlink to the original location. env = app.builder.env if not hasattr(env, 'todo_all_todos'): env.todo_all_todos = [] for node in doctree.traverse(todolist): if not app.config.todo_include_todos: node.replace_self([]) continue content = [] for todo_info in env.todo_all_todos: para = nodes.paragraph() filename = env.doc2path(todo_info['docname'], base=None) description = ( _('(The original entry is located in %s, line %d and can be found ') % (filename, todo_info['lineno'])) para += nodes.Text(description, description) # Create a reference newnode = nodes.reference('', '') innernode = nodes.emphasis(_('here'), _('here')) newnode['refdocname'] = todo_info['docname'] newnode['refuri'] = app.builder.get_relative_uri( fromdocname, todo_info['docname']) newnode['refuri'] += '#' + todo_info['target']['refid'] newnode.append(innernode) para += newnode para += nodes.Text('.)', '.)') # Insert into the todolist content.append(todo_info['todo']) content.append(para) node.replace_self(content) def setup(app): app.add_config_value('todo_include_todos', False, 'html') app.add_node(todolist) app.add_node(todo, html=(visit_todo_node, depart_todo_node), latex=(visit_todo_node, depart_todo_node), text=(visit_todo_node, depart_todo_node)) app.add_directive('todo', TodoDirective) app.add_directive('todolist', TodolistDirective) app.connect('doctree-resolved', process_todo_nodes) app.connect('env-purge-doc', purge_todos) app.connect('env-merge-info', merge_todos) return { 'version': '0.1', 'parallel_read_safe': True, 'parallel_write_safe': True, } ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/development/tutorials/helloworld.rst0000644000076600000240000001224600000000000022362 0ustar00tkomiyastaffDeveloping a "Hello world" extension ==================================== The objective of this tutorial is to create a very basic extension that adds a new directive. This directive will output a paragraph containing "hello world". Only basic information is provided in this tutorial. For more information, refer to the :doc:`other tutorials ` that go into more details. .. warning:: For this extension, you will need some basic understanding of docutils_ and Python. Overview -------- We want the extension to add the following to Sphinx: * A ``helloworld`` directive, that will simply output the text "hello world". Prerequisites ------------- We will not be distributing this plugin via `PyPI`_ and will instead include it as part of an existing project. This means you will need to use an existing project or create a new one using :program:`sphinx-quickstart`. We assume you are using separate source (:file:`source`) and build (:file:`build`) folders. Your extension file could be in any folder of your project. In our case, let's do the following: #. Create an :file:`_ext` folder in :file:`source` #. Create a new Python file in the :file:`_ext` folder called :file:`helloworld.py` Here is an example of the folder structure you might obtain: .. code-block:: text └── source    ├── _ext │   └── helloworld.py    ├── _static    ├── conf.py    ├── somefolder    ├── index.rst    ├── somefile.rst    └── someotherfile.rst Writing the extension --------------------- Open :file:`helloworld.py` and paste the following code in it: .. literalinclude:: examples/helloworld.py :language: python :linenos: Some essential things are happening in this example, and you will see them for all directives. .. rubric:: The directive class Our new directive is declared in the ``HelloWorld`` class. .. literalinclude:: examples/helloworld.py :language: python :linenos: :lines: 5-9 This class extends the docutils_' ``Directive`` class. All extensions that create directives should extend this class. .. seealso:: `The docutils documentation on creating directives `_ This class contains a ``run`` method. This method is a requirement and it is part of every directive. It contains the main logic of the directive and it returns a list of docutils nodes to be processed by Sphinx. These nodes are docutils' way of representing the content of a document. There are many types of nodes available: text, paragraph, reference, table, etc. .. seealso:: `The docutils documentation on nodes `_ The ``nodes.paragraph`` class creates a new paragraph node. A paragraph node typically contains some text that we can set during instantiation using the ``text`` parameter. .. rubric:: The ``setup`` function .. currentmodule:: sphinx.application This function is a requirement. We use it to plug our new directive into Sphinx. .. literalinclude:: examples/helloworld.py :language: python :linenos: :lines: 12- The simplest thing you can do it call the :meth:`~Sphinx.add_directive` method, which is what we've done here. For this particular call, the first argument is the name of the directive itself as used in a reST file. In this case, we would use ``helloworld``. For example: .. code-block:: rst Some intro text here... .. helloworld:: Some more text here... We also return the :ref:`extension metadata ` that indicates the version of our extension, along with the fact that it is safe to use the extension for both parallel reading and writing. Using the extension ------------------- The extension has to be declared in your :file:`conf.py` file to make Sphinx aware of it. There are two steps necessary here: #. Add the :file:`_ext` directory to the `Python path`_ using ``sys.path.append``. This should be placed at the top of the file. #. Update or create the :confval:`extensions` list and add the extension file name to the list For example: .. code-block:: python import os import sys sys.path.append(os.path.abspath("./_ext")) extensions = ['helloworld'] .. tip:: We're not distributing this extension as a `Python package`_, we need to modify the `Python path`_ so Sphinx can find our extension. This is why we need the call to ``sys.path.append``. You can now use the extension in a file. For example: .. code-block:: rst Some intro text here... .. helloworld:: Some more text here... The sample above would generate: .. code-block:: text Some intro text here... Hello World! Some more text here... Further reading --------------- This is the very basic principle of an extension that creates a new directive. For a more advanced example, refer to :doc:`todo`. .. _docutils: https://docutils.sourceforge.io/ .. _docutils directives: https://docutils.sourceforge.io/docs/howto/rst-directives.html .. _docutils nodes: https://docutils.sourceforge.io/docs/ref/doctree.html .. _PyPI: https://pypi.org/ .. _Python package: https://packaging.python.org/ .. _Python path: https://docs.python.org/3/using/cmdline.html#envvar-PYTHONPATH ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/development/tutorials/index.rst0000644000076600000240000000040600000000000021311 0ustar00tkomiyastaff.. _extension-tutorials-index: Extension tutorials =================== Refer to the following tutorials to get started with extension development. .. toctree:: :caption: Directive tutorials :maxdepth: 1 helloworld todo recipe autodoc_ext ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/development/tutorials/recipe.rst0000644000076600000240000001766600000000000021471 0ustar00tkomiyastaffDeveloping a "recipe" extension =============================== The objective of this tutorial is to illustrate roles, directives and domains. Once complete, we will be able to use this extension to describe a recipe and reference that recipe from elsewhere in our documentation. .. note:: This tutorial is based on a guide first published on `opensource.com`_ and is provided here with the original author's permission. .. _opensource.com: https://opensource.com/article/18/11/building-custom-workflows-sphinx Overview -------- We want the extension to add the following to Sphinx: * A ``recipe`` :term:`directive`, containing some content describing the recipe steps, along with a ``:contains:`` option highlighting the main ingredients of the recipe. * A ``ref`` :term:`role`, which provides a cross-reference to the recipe itself. * A ``recipe`` :term:`domain`, which allows us to tie together the above role and domain, along with things like indices. For that, we will need to add the following elements to Sphinx: * A new directive called ``recipe`` * New indexes to allow us to reference ingredient and recipes * A new domain called ``recipe``, which will contain the ``recipe`` directive and ``ref`` role Prerequisites ------------- We need the same setup as in :doc:`the previous extensions `. This time, we will be putting out extension in a file called :file:`recipe.py`. Here is an example of the folder structure you might obtain: .. code-block:: text └── source    ├── _ext │   └── recipe.py    ├── conf.py    └── index.rst Writing the extension --------------------- Open :file:`recipe.py` and paste the following code in it, all of which we will explain in detail shortly: .. literalinclude:: examples/recipe.py :language: python :linenos: Let's look at each piece of this extension step-by-step to explain what's going on. .. rubric:: The directive class The first thing to examine is the ``RecipeDirective`` directive: .. literalinclude:: examples/recipe.py :language: python :linenos: :pyobject: RecipeDirective Unlike :doc:`helloworld` and :doc:`todo`, this directive doesn't derive from :class:`docutils.parsers.rst.Directive` and doesn't define a ``run`` method. Instead, it derives from :class:`sphinx.directives.ObjectDescription` and defines ``handle_signature`` and ``add_target_and_index`` methods. This is because ``ObjectDescription`` is a special-purpose directive that's intended for describing things like classes, functions, or, in our case, recipes. More specifically, ``handle_signature`` implements parsing the signature of the directive and passes on the object's name and type to its superclass, while ``add_taget_and_index`` adds a target (to link to) and an entry to the index for this node. We also see that this directive defines ``has_content``, ``required_arguments`` and ``option_spec``. Unlike the ``TodoDirective`` directive added in the :doc:`previous tutorial `, this directive takes a single argument, the recipe name, and an option, ``contains``, in addition to the nested reStructuredText in the body. .. rubric:: The index classes .. currentmodule:: sphinx.domains .. todo:: Add brief overview of indices .. literalinclude:: examples/recipe.py :language: python :linenos: :pyobject: IngredientIndex .. literalinclude:: examples/recipe.py :language: python :linenos: :pyobject: RecipeIndex Both ``IngredientIndex`` and ``RecipeIndex`` are derived from :class:`Index`. They implement custom logic to generate a tuple of values that define the index. Note that ``RecipeIndex`` is a simple index that has only one entry. Extending it to cover more object types is not yet part of the code. Both indices use the method :meth:`Index.generate` to do their work. This method combines the information from our domain, sorts it, and returns it in a list structure that will be accepted by Sphinx. This might look complicated but all it really is is a list of tuples like ``('tomato', 'TomatoSoup', 'test', 'rec-TomatoSoup',...)``. Refer to the :doc:`domain API guide ` for more information on this API. These index pages can be referred by combination of domain name and its ``name`` using :rst:role:`ref` role. For example, ``RecipeIndex`` can be referred by ``:ref:`recipe-recipe```. .. rubric:: The domain A Sphinx domain is a specialized container that ties together roles, directives, and indices, among other things. Let's look at the domain we're creating here. .. literalinclude:: examples/recipe.py :language: python :linenos: :pyobject: RecipeDomain There are some interesting things to note about this ``recipe`` domain and domains in general. Firstly, we actually register our directives, roles and indices here, via the ``directives``, ``roles`` and ``indices`` attributes, rather than via calls later on in ``setup``. We can also note that we aren't actually defining a custom role and are instead reusing the :class:`sphinx.roles.XRefRole` role and defining the :class:`sphinx.domains.Domain.resolve_xref` method. This method takes two arguments, ``typ`` and ``target``, which refer to the cross-reference type and its target name. We'll use ``target`` to resolve our destination from our domain's ``recipes`` because we currently have only one type of node. Moving on, we can see that we've defined ``initial_data``. The values defined in ``initial_data`` will be copied to ``env.domaindata[domain_name]`` as the initial data of the domain, and domain instances can access it via ``self.data``. We see that we have defined two items in ``initial_data``: ``recipes`` and ``recipe2ingredient``. These contain a list of all objects defined (i.e. all recipes) and a hash that maps a canonical ingredient name to the list of objects. The way we name objects is common across our extension and is defined in the ``get_full_qualified_name`` method. For each object created, the canonical name is ``recipe.``, where ```` is the name the documentation writer gives the object (a recipe). This enables the extension to use different object types that share the same name. Having a canonical name and central place for our objects is a huge advantage. Both our indices and our cross-referencing code use this feature. .. rubric:: The ``setup`` function .. currentmodule:: sphinx.application :doc:`As always `, the ``setup`` function is a requirement and is used to hook the various parts of our extension into Sphinx. Let's look at the ``setup`` function for this extension. .. literalinclude:: examples/recipe.py :language: python :linenos: :pyobject: setup This looks a little different to what we're used to seeing. There are no calls to :meth:`~Sphinx.add_directive` or even :meth:`~Sphinx.add_role`. Instead, we have a single call to :meth:`~Sphinx.add_domain` followed by some initialization of the :ref:`standard domain `. This is because we had already registered our directives, roles and indexes as part of the directive itself. Using the extension ------------------- You can now use the extension throughout your project. For example: .. code-block:: rst :caption: index.rst Joe's Recipes ============= Below are a collection of my favourite recipes. I highly recommend the :recipe:ref:`TomatoSoup` recipe in particular! .. toctree:: tomato-soup .. code-block:: rst :caption: tomato-soup.rst The recipe contains `tomato` and `cilantro`. .. recipe:recipe:: TomatoSoup :contains: tomato, cilantro, salt, pepper This recipe is a tasty tomato soup, combine all ingredients and cook. The important things to note are the use of the ``:recipe:ref:`` role to cross-reference the recipe actually defined elsewhere (using the ``:recipe:recipe:`` directive. Further reading --------------- For more information, refer to the `docutils`_ documentation and :doc:`/extdev/index`. .. _docutils: https://docutils.sourceforge.io/docs/ ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/development/tutorials/todo.rst0000644000076600000240000003216300000000000021154 0ustar00tkomiyastaffDeveloping a "TODO" extension ============================= The objective of this tutorial is to create a more comprehensive extension than that created in :doc:`helloworld`. Whereas that guide just covered writing a custom :term:`directive`, this guide adds multiple directives, along with custom nodes, additional config values and custom event handlers. To this end, we will cover a ``todo`` extension that adds capabilities to include todo entries in the documentation, and to collect these in a central place. This is similar the ``sphinxext.todo`` extension distributed with Sphinx. Overview -------- .. note:: To understand the design of this extension, refer to :ref:`important-objects` and :ref:`build-phases`. We want the extension to add the following to Sphinx: * A ``todo`` directive, containing some content that is marked with "TODO" and only shown in the output if a new config value is set. Todo entries should not be in the output by default. * A ``todolist`` directive that creates a list of all todo entries throughout the documentation. For that, we will need to add the following elements to Sphinx: * New directives, called ``todo`` and ``todolist``. * New document tree nodes to represent these directives, conventionally also called ``todo`` and ``todolist``. We wouldn't need new nodes if the new directives only produced some content representable by existing nodes. * A new config value ``todo_include_todos`` (config value names should start with the extension name, in order to stay unique) that controls whether todo entries make it into the output. * New event handlers: one for the :event:`doctree-resolved` event, to replace the todo and todolist nodes, one for :event:`env-merge-info` to merge intermediate results from parallel builds, and one for :event:`env-purge-doc` (the reason for that will be covered later). Prerequisites ------------- As with :doc:`helloworld`, we will not be distributing this plugin via PyPI so once again we need a Sphinx project to call this from. You can use an existing project or create a new one using :program:`sphinx-quickstart`. We assume you are using separate source (:file:`source`) and build (:file:`build`) folders. Your extension file could be in any folder of your project. In our case, let's do the following: #. Create an :file:`_ext` folder in :file:`source` #. Create a new Python file in the :file:`_ext` folder called :file:`todo.py` Here is an example of the folder structure you might obtain: .. code-block:: text └── source    ├── _ext │   └── todo.py    ├── _static    ├── conf.py    ├── somefolder    ├── index.rst    ├── somefile.rst    └── someotherfile.rst Writing the extension --------------------- Open :file:`todo.py` and paste the following code in it, all of which we will explain in detail shortly: .. literalinclude:: examples/todo.py :language: python :linenos: This is far more extensive extension than the one detailed in :doc:`helloworld`, however, we will will look at each piece step-by-step to explain what's happening. .. rubric:: The node classes Let's start with the node classes: .. literalinclude:: examples/todo.py :language: python :linenos: :lines: 8-21 Node classes usually don't have to do anything except inherit from the standard docutils classes defined in :mod:`docutils.nodes`. ``todo`` inherits from ``Admonition`` because it should be handled like a note or warning, ``todolist`` is just a "general" node. .. note:: Many extensions will not have to create their own node classes and work fine with the nodes already provided by `docutils `__ and :ref:`Sphinx `. .. attention:: It is important to know that while you can extend Sphinx without leaving your ``conf.py``, if you declare an inherited node right there, you'll hit an unobvious :py:class:`PickleError`. So if something goes wrong, please make sure that you put inherited nodes into a separate Python module. For more details, see: - https://github.com/sphinx-doc/sphinx/issues/6751 - https://github.com/sphinx-doc/sphinx/issues/1493 - https://github.com/sphinx-doc/sphinx/issues/1424 .. rubric:: The directive classes A directive class is a class deriving usually from :class:`docutils.parsers.rst.Directive`. The directive interface is also covered in detail in the `docutils documentation`_; the important thing is that the class should have attributes that configure the allowed markup, and a ``run`` method that returns a list of nodes. Looking first at the ``TodolistDirective`` directive: .. literalinclude:: examples/todo.py :language: python :linenos: :lines: 24-27 It's very simple, creating and returning an instance of our ``todolist`` node class. The ``TodolistDirective`` directive itself has neither content nor arguments that need to be handled. That brings us to the ``TodoDirective`` directive: .. literalinclude:: examples/todo.py :language: python :linenos: :lines: 30-53 Several important things are covered here. First, as you can see, we're now subclassing the :class:`~sphinx.util.docutils.SphinxDirective` helper class instead of the usual :class:`~docutils.parsers.rst.Directive` class. This gives us access to the :ref:`build environment instance ` using the ``self.env`` property. Without this, we'd have to use the rather convoluted ``self.state.document.settings.env``. Then, to act as a link target (from ``TodolistDirective``), the ``TodoDirective`` directive needs to return a target node in addition to the ``todo`` node. The target ID (in HTML, this will be the anchor name) is generated by using ``env.new_serialno`` which returns a new unique integer on each call and therefore leads to unique target names. The target node is instantiated without any text (the first two arguments). On creating admonition node, the content body of the directive are parsed using ``self.state.nested_parse``. The first argument gives the content body, and the second one gives content offset. The third argument gives the parent node of parsed result, in our case the ``todo`` node. Following this, the ``todo`` node is added to the environment. This is needed to be able to create a list of all todo entries throughout the documentation, in the place where the author puts a ``todolist`` directive. For this case, the environment attribute ``todo_all_todos`` is used (again, the name should be unique, so it is prefixed by the extension name). It does not exist when a new environment is created, so the directive must check and create it if necessary. Various information about the todo entry's location are stored along with a copy of the node. In the last line, the nodes that should be put into the doctree are returned: the target node and the admonition node. The node structure that the directive returns looks like this:: +--------------------+ | target node | +--------------------+ +--------------------+ | todo node | +--------------------+ \__+--------------------+ | admonition title | +--------------------+ | paragraph | +--------------------+ | ... | +--------------------+ .. rubric:: The event handlers Event handlers are one of Sphinx's most powerful features, providing a way to do hook into any part of the documentation process. There are many events provided by Sphinx itself, as detailed in :ref:`the API guide `, and we're going to use a subset of them here. Let's look at the event handlers used in the above example. First, the one for the :event:`env-purge-doc` event: .. literalinclude:: examples/todo.py :language: python :linenos: :lines: 56-61 Since we store information from source files in the environment, which is persistent, it may become out of date when the source file changes. Therefore, before each source file is read, the environment's records of it are cleared, and the :event:`env-purge-doc` event gives extensions a chance to do the same. Here we clear out all todos whose docname matches the given one from the ``todo_all_todos`` list. If there are todos left in the document, they will be added again during parsing. The next handler, for the :event:`env-merge-info` event, is used during parallel builds. As during parallel builds all threads have their own ``env``, there's multiple ``todo_all_todos`` lists that need to be merged: .. literalinclude:: examples/todo.py :language: python :linenos: :lines: 64-68 The other handler belongs to the :event:`doctree-resolved` event: .. literalinclude:: examples/todo.py :language: python :linenos: :lines: 71-113 The :event:`doctree-resolved` event is emitted at the end of :ref:`phase 3 (resolving) ` and allows custom resolving to be done. The handler we have written for this event is a bit more involved. If the ``todo_include_todos`` config value (which we'll describe shortly) is false, all ``todo`` and ``todolist`` nodes are removed from the documents. If not, ``todo`` nodes just stay where and how they are. ``todolist`` nodes are replaced by a list of todo entries, complete with backlinks to the location where they come from. The list items are composed of the nodes from the ``todo`` entry and docutils nodes created on the fly: a paragraph for each entry, containing text that gives the location, and a link (reference node containing an italic node) with the backreference. The reference URI is built by :meth:`sphinx.builders.Builder.get_relative_uri` which creates a suitable URI depending on the used builder, and appending the todo node's (the target's) ID as the anchor name. .. rubric:: The ``setup`` function .. currentmodule:: sphinx.application As noted :doc:`previously `, the ``setup`` function is a requirement and is used to plug directives into Sphinx. However, we also use it to hook up the other parts of our extension. Let's look at our ``setup`` function: .. literalinclude:: examples/todo.py :language: python :linenos: :lines: 116- The calls in this function refer to the classes and functions we added earlier. What the individual calls do is the following: * :meth:`~Sphinx.add_config_value` lets Sphinx know that it should recognize the new *config value* ``todo_include_todos``, whose default value should be ``False`` (this also tells Sphinx that it is a boolean value). If the third argument was ``'html'``, HTML documents would be full rebuild if the config value changed its value. This is needed for config values that influence reading (build :ref:`phase 1 (reading) `). * :meth:`~Sphinx.add_node` adds a new *node class* to the build system. It also can specify visitor functions for each supported output format. These visitor functions are needed when the new nodes stay until :ref:`phase 4 (writing) `. Since the ``todolist`` node is always replaced in :ref:`phase 3 (resolving) `, it doesn't need any. * :meth:`~Sphinx.add_directive` adds a new *directive*, given by name and class. * Finally, :meth:`~Sphinx.connect` adds an *event handler* to the event whose name is given by the first argument. The event handler function is called with several arguments which are documented with the event. With this, our extension is complete. Using the extension ------------------- As before, we need to enable the extension by declaring it in our :file:`conf.py` file. There are two steps necessary here: #. Add the :file:`_ext` directory to the `Python path`_ using ``sys.path.append``. This should be placed at the top of the file. #. Update or create the :confval:`extensions` list and add the extension file name to the list In addition, we may wish to set the ``todo_include_todos`` config value. As noted above, this defaults to ``False`` but we can set it explicitly. For example: .. code-block:: python import os import sys sys.path.append(os.path.abspath("./_ext")) extensions = ['todo'] todo_include_todos = False You can now use the extension throughout your project. For example: .. code-block:: rst :caption: index.rst Hello, world ============ .. toctree:: somefile.rst someotherfile.rst Hello world. Below is the list of TODOs. .. todolist:: .. code-block:: rst :caption: somefile.rst foo === Some intro text here... .. todo:: Fix this .. code-block:: rst :caption: someotherfile.rst bar === Some more text here... .. todo:: Fix that Because we have configured ``todo_include_todos`` to ``False``, we won't actually see anything rendered for the ``todo`` and ``todolist`` directives. However, if we toggle this to true, we will see the output described previously. Further reading --------------- For more information, refer to the `docutils`_ documentation and :doc:`/extdev/index`. .. _docutils: https://docutils.sourceforge.io/docs/ .. _Python path: https://docs.python.org/3/using/cmdline.html#envvar-PYTHONPATH .. _docutils documentation: https://docutils.sourceforge.io/docs/ref/rst/directives.html ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1575772786.0 Sphinx-4.3.2/doc/examples.rst0000644000076600000240000000006600000000000015452 0ustar00tkomiyastaff:tocdepth: 2 .. _examples: .. include:: ../EXAMPLES ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1639903107.411474 Sphinx-4.3.2/doc/extdev/0000755000076600000240000000000000000000000014377 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/extdev/appapi.rst0000644000076600000240000003341400000000000016410 0ustar00tkomiyastaff.. highlight:: rest Application API =============== .. module:: sphinx.application :synopsis: Application class and extensibility interface. Each Sphinx extension is a Python module with at least a :func:`setup` function. This function is called at initialization time with one argument, the application object representing the Sphinx process. .. class:: Sphinx This application object has the public API described in the following. Extension setup --------------- These methods are usually called in an extension's ``setup()`` function. Examples of using the Sphinx extension API can be seen in the :mod:`sphinx.ext` package. .. currentmodule:: sphinx.application .. automethod:: Sphinx.setup_extension .. automethod:: Sphinx.require_sphinx .. automethod:: Sphinx.connect .. automethod:: Sphinx.disconnect .. automethod:: Sphinx.add_builder .. automethod:: Sphinx.add_config_value .. automethod:: Sphinx.add_event .. automethod:: Sphinx.set_translator .. automethod:: Sphinx.add_node .. automethod:: Sphinx.add_enumerable_node .. automethod:: Sphinx.add_directive .. automethod:: Sphinx.add_role .. automethod:: Sphinx.add_generic_role .. automethod:: Sphinx.add_domain .. automethod:: Sphinx.add_directive_to_domain .. automethod:: Sphinx.add_role_to_domain .. automethod:: Sphinx.add_index_to_domain .. automethod:: Sphinx.add_object_type .. automethod:: Sphinx.add_crossref_type .. automethod:: Sphinx.add_transform .. automethod:: Sphinx.add_post_transform .. automethod:: Sphinx.add_js_file .. automethod:: Sphinx.add_css_file .. automethod:: Sphinx.add_latex_package .. automethod:: Sphinx.add_lexer .. automethod:: Sphinx.add_autodocumenter .. automethod:: Sphinx.add_autodoc_attrgetter .. automethod:: Sphinx.add_search_language .. automethod:: Sphinx.add_source_suffix .. automethod:: Sphinx.add_source_parser .. automethod:: Sphinx.add_env_collector .. automethod:: Sphinx.add_html_theme .. automethod:: Sphinx.add_html_math_renderer .. automethod:: Sphinx.add_message_catalog .. automethod:: Sphinx.is_parallel_allowed .. exception:: ExtensionError All these methods raise this exception if something went wrong with the extension API. Emitting events --------------- .. class:: Sphinx :noindex: .. automethod:: emit .. automethod:: emit_firstresult Sphinx runtime information -------------------------- The application object also provides runtime information as attributes. .. attribute:: Sphinx.project Target project. See :class:`.Project`. .. attribute:: Sphinx.srcdir Source directory. .. attribute:: Sphinx.confdir Directory containing ``conf.py``. .. attribute:: Sphinx.doctreedir Directory for storing pickled doctrees. .. attribute:: Sphinx.outdir Directory for storing built document. .. _events: Sphinx core events ------------------ These events are known to the core. The arguments shown are given to the registered event handlers. Use :meth:`.Sphinx.connect` in an extension's ``setup`` function (note that ``conf.py`` can also have a ``setup`` function) to connect handlers to the events. Example: .. code-block:: python def source_read_handler(app, docname, source): print('do something here...') def setup(app): app.connect('source-read', source_read_handler) Below is an overview of each event that happens during a build. In the list below, we include the event name, its callback parameters, and the input and output type for that event: .. code-block:: none 1. event.config-inited(app,config) 2. event.builder-inited(app) 3. event.env-get-outdated(app, env, added, changed, removed) 4. event.env-before-read-docs(app, env, docnames) for docname in docnames: 5. event.env-purge-doc(app, env, docname) if doc changed and not removed: 6. source-read(app, docname, source) 7. run source parsers: text -> docutils.document - parsers can be added with the app.add_source_parser() API 8. apply transforms based on priority: docutils.document -> docutils.document - event.doctree-read(app, doctree) is called in the middle of transforms, transforms come before/after this event depending on their priority. 9. event.env-merge-info(app, env, docnames, other) - if running in parallel mode, this event will be emitted for each process 10. event.env-updated(app, env) 11. event.env-get-updated(app, env) 12. event.env-check-consistency(app, env) # The updated-docs list can be builder dependent, but generally includes all new/changed documents, # plus any output from `env-get-updated`, and then all "parent" documents in the ToC tree # For builders that output a single page, they are first joined into a single doctree before post-transforms # or the doctree-resolved event is emitted for docname in updated-docs: 13. apply post-transforms (by priority): docutils.document -> docutils.document 14. event.doctree-resolved(app, doctree, docname) - In the event that any reference nodes fail to resolve, the following may emit: - event.missing-reference(env, node, contnode) - event.warn-missing-reference(domain, node) 15. Generate output files 16. event.build-finished(app, exception) Here is a more detailed list of these events. .. event:: builder-inited (app) Emitted when the builder object has been created. It is available as ``app.builder``. .. event:: config-inited (app, config) Emitted when the config object has been initialized. .. versionadded:: 1.8 .. event:: env-get-outdated (app, env, added, changed, removed) Emitted when the environment determines which source files have changed and should be re-read. *added*, *changed* and *removed* are sets of docnames that the environment has determined. You can return a list of docnames to re-read in addition to these. .. versionadded:: 1.1 .. event:: env-purge-doc (app, env, docname) Emitted when all traces of a source file should be cleaned from the environment, that is, if the source file is removed or before it is freshly read. This is for extensions that keep their own caches in attributes of the environment. For example, there is a cache of all modules on the environment. When a source file has been changed, the cache's entries for the file are cleared, since the module declarations could have been removed from the file. .. versionadded:: 0.5 .. event:: env-before-read-docs (app, env, docnames) Emitted after the environment has determined the list of all added and changed files and just before it reads them. It allows extension authors to reorder the list of docnames (*inplace*) before processing, or add more docnames that Sphinx did not consider changed (but never add any docnames that are not in ``env.found_docs``). You can also remove document names; do this with caution since it will make Sphinx treat changed files as unchanged. .. versionadded:: 1.3 .. event:: source-read (app, docname, source) Emitted when a source file has been read. The *source* argument is a list whose single element is the contents of the source file. You can process the contents and replace this item to implement source-level transformations. For example, if you want to use ``$`` signs to delimit inline math, like in LaTeX, you can use a regular expression to replace ``$...$`` by ``:math:`...```. .. versionadded:: 0.5 .. event:: object-description-transform (app, domain, objtype, contentnode) Emitted when an object description directive has run. The *domain* and *objtype* arguments are strings indicating object description of the object. And *contentnode* is a content for the object. It can be modified in-place. .. versionadded:: 2.4 .. event:: doctree-read (app, doctree) Emitted when a doctree has been parsed and read by the environment, and is about to be pickled. The *doctree* can be modified in-place. .. event:: missing-reference (app, env, node, contnode) Emitted when a cross-reference to an object cannot be resolved. If the event handler can resolve the reference, it should return a new docutils node to be inserted in the document tree in place of the node *node*. Usually this node is a :class:`reference` node containing *contnode* as a child. If the handler can not resolve the cross-reference, it can either return ``None`` to let other handlers try, or raise :class:`NoUri` to prevent other handlers in trying and suppress a warning about this cross-reference being unresolved. :param env: The build environment (``app.builder.env``). :param node: The :class:`pending_xref` node to be resolved. Its attributes ``reftype``, ``reftarget``, ``modname`` and ``classname`` attributes determine the type and target of the reference. :param contnode: The node that carries the text and formatting inside the future reference and should be a child of the returned reference node. .. versionadded:: 0.5 .. event:: warn-missing-reference (app, domain, node) Emitted when a cross-reference to an object cannot be resolved even after :event:`missing-reference`. If the event handler can emit warnings for the missing reference, it should return ``True``. .. versionadded:: 3.4 .. event:: doctree-resolved (app, doctree, docname) Emitted when a doctree has been "resolved" by the environment, that is, all references have been resolved and TOCs have been inserted. The *doctree* can be modified in place. Here is the place to replace custom nodes that don't have visitor methods in the writers, so that they don't cause errors when the writers encounter them. .. event:: env-merge-info (app, env, docnames, other) This event is only emitted when parallel reading of documents is enabled. It is emitted once for every subprocess that has read some documents. You must handle this event in an extension that stores data in the environment in a custom location. Otherwise the environment in the main process will not be aware of the information stored in the subprocess. *other* is the environment object from the subprocess, *env* is the environment from the main process. *docnames* is a set of document names that have been read in the subprocess. .. versionadded:: 1.3 .. event:: env-updated (app, env) Emitted when the :meth:`update` method of the build environment has completed, that is, the environment and all doctrees are now up-to-date. You can return an iterable of docnames from the handler. These documents will then be considered updated, and will be (re-)written during the writing phase. .. versionadded:: 0.5 .. versionchanged:: 1.3 The handlers' return value is now used. .. event:: env-check-consistency (app, env) Emitted when Consistency checks phase. You can check consistency of metadata for whole of documents. .. versionadded:: 1.6 As a **experimental** event .. event:: html-collect-pages (app) Emitted when the HTML builder is starting to write non-document pages. You can add pages to write by returning an iterable from this event consisting of ``(pagename, context, templatename)``. .. versionadded:: 1.0 .. event:: html-page-context (app, pagename, templatename, context, doctree) Emitted when the HTML builder has created a context dictionary to render a template with -- this can be used to add custom elements to the context. The *pagename* argument is the canonical name of the page being rendered, that is, without ``.html`` suffix and using slashes as path separators. The *templatename* is the name of the template to render, this will be ``'page.html'`` for all pages from reST documents. The *context* argument is a dictionary of values that are given to the template engine to render the page and can be modified to include custom values. Keys must be strings. The *doctree* argument will be a doctree when the page is created from a reST documents; it will be ``None`` when the page is created from an HTML template alone. You can return a string from the handler, it will then replace ``'page.html'`` as the HTML template for this page. .. note:: You can install JS/CSS files for the specific page via :meth:`Sphinx.add_js_file` and :meth:`Sphinx.add_css_file` since v3.5.0. .. versionadded:: 0.4 .. versionchanged:: 1.3 The return value can now specify a template name. .. event:: linkcheck-process-uri (app, uri) Emitted when the linkcheck builder collects hyperlinks from document. *uri* is a collected URI. The event handlers can modify the URI by returning a string. .. versionadded:: 4.1 .. event:: build-finished (app, exception) Emitted when a build has finished, before Sphinx exits, usually used for cleanup. This event is emitted even when the build process raised an exception, given as the *exception* argument. The exception is reraised in the application after the event handlers have run. If the build process raised no exception, *exception* will be ``None``. This allows to customize cleanup actions depending on the exception status. .. versionadded:: 0.5 Checking the Sphinx version --------------------------- .. currentmodule:: sphinx Use this to adapt your extension to API changes in Sphinx. .. autodata:: version_info The Config object ----------------- .. currentmodule:: sphinx.config .. autoclass:: Config .. _template-bridge: The template bridge ------------------- .. currentmodule:: sphinx.application .. autoclass:: TemplateBridge :members: .. _exceptions: Exceptions ---------- .. module:: sphinx.errors .. autoexception:: SphinxError .. autoexception:: ConfigError .. autoexception:: ExtensionError .. autoexception:: ThemeError .. autoexception:: VersionRequirementError ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/extdev/builderapi.rst0000644000076600000240000000211700000000000017252 0ustar00tkomiyastaff.. _writing-builders: Builder API =========== .. todo:: Expand this. .. currentmodule:: sphinx.builders .. class:: Builder This is the base class for all builders. These attributes should be set on builder classes: .. autoattribute:: name .. autoattribute:: format .. autoattribute:: epilog .. autoattribute:: allow_parallel .. autoattribute:: supported_image_types .. autoattribute:: supported_remote_images .. autoattribute:: supported_data_uri_images .. autoattribute:: default_translator_class These methods are predefined and will be called from the application: .. automethod:: get_relative_uri .. automethod:: build_all .. automethod:: build_specific .. automethod:: build_update .. automethod:: build These methods can be overridden in concrete builder classes: .. automethod:: init .. automethod:: get_outdated_docs .. automethod:: get_target_uri .. automethod:: prepare_writing .. automethod:: write_doc .. automethod:: finish **Attributes** .. attribute:: events An :class:`.EventManager` object. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/doc/extdev/collectorapi.rst0000644000076600000240000000024500000000000017612 0ustar00tkomiyastaff.. _collector-api: Environment Collector API ------------------------- .. module:: sphinx.environment.collectors .. autoclass:: EnvironmentCollector :members: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/extdev/deprecated.rst0000644000076600000240000011263400000000000017240 0ustar00tkomiyastaff.. _dev-deprecated-apis: Deprecated APIs =============== On developing Sphinx, we are always careful to the compatibility of our APIs. But, sometimes, the change of interface are needed for some reasons. In such cases, we've marked them as deprecated. And they are kept during the two major versions (for more details, please see :ref:`deprecation-policy`). The following is a list of deprecated interfaces. .. tabularcolumns:: |>{\raggedright}\Y{.4}|>{\centering}\Y{.1}|>{\centering}\Y{.12}|>{\raggedright\arraybackslash}\Y{.38}| .. list-table:: deprecated APIs :header-rows: 1 :class: deprecated :widths: 40, 10, 10, 40 * - Target - Deprecated - (will be) Removed - Alternatives * - ``sphinx.ext.autodoc.AttributeDocumenter._datadescriptor`` - 4.3 - 6.0 - N/A * - ``sphinx.writers.html.HTMLTranslator._fieldlist_row_index`` - 4.3 - 6.0 - ``sphinx.writers.html.HTMLTranslator._fieldlist_row_indices`` * - ``sphinx.writers.html.HTMLTranslator._table_row_index`` - 4.3 - 6.0 - ``sphinx.writers.html.HTMLTranslator._table_row_indices`` * - ``sphinx.writers.html5.HTML5Translator._fieldlist_row_index`` - 4.3 - 6.0 - ``sphinx.writers.html5.HTML5Translator._fieldlist_row_indices`` * - ``sphinx.writers.html5.HTML5Translator._table_row_index`` - 4.3 - 6.0 - ``sphinx.writers.html5.HTML5Translator._table_row_indices`` * - The optional argument ``app`` for ``sphinx.environment.BuildEnvironment`` - 4.1 - 6.0 - The required argument * - ``sphinx.application.Sphinx.html_theme`` - 4.1 - 6.0 - ``sphinx.registry.SphinxComponentRegistry.html_themes`` * - ``sphinx.ext.autosummary._app`` - 4.1 - 6.0 - N/A * - ``sphinx.util.docstrings.extract_metadata()`` - 4.1 - 6.0 - ``sphinx.util.docstrings.separate_metadata()`` * - ``favicon`` variable in HTML templates - 4.0 - TBD - ``favicon_url`` * - ``logo`` variable in HTML templates - 4.0 - TBD - ``logo_url`` * - ``sphinx.directives.patches.ListTable`` - 4.0 - 6.0 - ``docutils.parsers.rst.directives.tables.ListSVTable`` * - ``sphinx.directives.patches.RSTTable`` - 4.0 - 6.0 - ``docutils.parsers.rst.directives.tables.RSTTable`` * - ``sphinx.ext.autodoc.directive.DocumenterBridge.filename_set`` - 4.0 - 6.0 - ``sphinx.ext.autodoc.directive.DocumenterBridge.record_dependencies`` * - ``sphinx.ext.autodoc.directive.DocumenterBridge.warn()`` - 4.0 - 6.0 - :ref:`logging-api` * - ``sphinx.registry.SphinxComponentRegistry.get_source_input()`` - 4.0 - 6.0 - N/A * - ``sphinx.registry.SphinxComponentRegistry.source_inputs`` - 4.0 - 6.0 - N/A * - ``sphinx.transforms.FigureAligner`` - 4.0 - 6.0 - N/A * - ``sphinx.util.pycompat.convert_with_2to3()`` - 4.0 - 6.0 - N/A * - ``sphinx.util.pycompat.execfile_()`` - 4.0 - 6.0 - N/A * - ``sphinx.util.smartypants`` - 4.0 - 6.0 - ``docutils.utils.smartquotes`` * - ``sphinx.util.typing.DirectiveOption`` - 4.0 - 6.0 - N/A * - pending_xref node for viewcode extension - 3.5 - 5.0 - ``sphinx.ext.viewcode.viewcode_anchor`` * - ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.anchors_ignore`` - 3.5 - 5.0 - N/A * - ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.auth`` - 3.5 - 5.0 - N/A * - ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.broken`` - 3.5 - 5.0 - N/A * - ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.good`` - 3.5 - 5.0 - N/A * - ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.redirected`` - 3.5 - 5.0 - N/A * - ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.rqueue`` - 3.5 - 5.0 - N/A * - ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.to_ignore`` - 3.5 - 5.0 - N/A * - ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.workers`` - 3.5 - 5.0 - N/A * - ``sphinx.builders.linkcheck.CheckExternalLinksBuilder.wqueue`` - 3.5 - 5.0 - N/A * - ``sphinx.builders.linkcheck.node_line_or_0()`` - 3.5 - 5.0 - ``sphinx.util.nodes.get_node_line()`` * - ``sphinx.ext.autodoc.AttributeDocumenter.isinstanceattribute()`` - 3.5 - 5.0 - N/A * - ``sphinx.ext.autodoc.importer.get_module_members()`` - 3.5 - 5.0 - ``sphinx.ext.autodoc.ModuleDocumenter.get_module_members()`` * - ``sphinx.ext.autosummary.generate._simple_info()`` - 3.5 - 5.0 - :ref:`logging-api` * - ``sphinx.ext.autosummary.generate._simple_warn()`` - 3.5 - 5.0 - :ref:`logging-api` * - ``sphinx.writers.html.HTMLTranslator.permalink_text`` - 3.5 - 5.0 - :confval:`html_permalinks_icon` * - ``sphinx.writers.html5.HTML5Translator.permalink_text`` - 3.5 - 5.0 - :confval:`html_permalinks_icon` * - The ``follow_wrapped`` argument of ``sphinx.util.inspect.signature()`` - 3.4 - 5.0 - N/A * - The ``no_docstring`` argument of ``sphinx.ext.autodoc.Documenter.add_content()`` - 3.4 - 5.0 - ``sphinx.ext.autodoc.Documenter.get_doc()`` * - ``sphinx.ext.autodoc.Documenter.get_object_members()`` - 3.4 - 6.0 - ``sphinx.ext.autodoc.ClassDocumenter.get_object_members()`` * - ``sphinx.ext.autodoc.DataDeclarationDocumenter`` - 3.4 - 5.0 - ``sphinx.ext.autodoc.DataDocumenter`` * - ``sphinx.ext.autodoc.GenericAliasDocumenter`` - 3.4 - 5.0 - ``sphinx.ext.autodoc.DataDocumenter`` * - ``sphinx.ext.autodoc.InstanceAttributeDocumenter`` - 3.4 - 5.0 - ``sphinx.ext.autodoc.AttributeDocumenter`` * - ``sphinx.ext.autodoc.SlotsAttributeDocumenter`` - 3.4 - 5.0 - ``sphinx.ext.autodoc.AttributeDocumenter`` * - ``sphinx.ext.autodoc.TypeVarDocumenter`` - 3.4 - 5.0 - ``sphinx.ext.autodoc.DataDocumenter`` * - ``sphinx.ext.autodoc.directive.DocumenterBridge.reporter`` - 3.5 - 5.0 - ``sphinx.util.logging`` * - ``sphinx.ext.autodoc.importer._getannotations()`` - 3.4 - 4.0 - ``sphinx.util.inspect.getannotations()`` * - ``sphinx.ext.autodoc.importer._getmro()`` - 3.4 - 4.0 - ``sphinx.util.inspect.getmro()`` * - ``sphinx.pycode.ModuleAnalyzer.parse()`` - 3.4 - 5.0 - ``sphinx.pycode.ModuleAnalyzer.analyze()`` * - ``sphinx.util.osutil.movefile()`` - 3.4 - 5.0 - ``os.replace()`` * - ``sphinx.util.requests.is_ssl_error()`` - 3.4 - 5.0 - N/A * - ``sphinx.builders.latex.LaTeXBuilder.usepackages`` - 3.3 - 5.0 - N/A * - ``sphinx.builders.latex.LaTeXBuilder.usepackages_afger_hyperref`` - 3.3 - 5.0 - N/A * - ``sphinx.ext.autodoc.SingledispatchFunctionDocumenter`` - 3.3 - 5.0 - ``sphinx.ext.autodoc.FunctionDocumenter`` * - ``sphinx.ext.autodoc.SingledispatchMethodDocumenter`` - 3.3 - 5.0 - ``sphinx.ext.autodoc.MethodDocumenter`` * - ``sphinx.ext.autodoc.members_set_option()`` - 3.2 - 5.0 - N/A * - ``sphinx.ext.autodoc.merge_special_members_option()`` - 3.2 - 5.0 - ``sphinx.ext.autodoc.merge_members_option()`` * - ``sphinx.writers.texinfo.TexinfoWriter.desc`` - 3.2 - 5.0 - ``sphinx.writers.texinfo.TexinfoWriter.descs`` * - The first argument for ``sphinx.ext.autosummary.generate.AutosummaryRenderer`` has been changed to Sphinx object - 3.1 - 5.0 - N/A * - ``sphinx.ext.autosummary.generate.AutosummaryRenderer`` takes an object type as an argument - 3.1 - 5.0 - N/A * - The ``ignore`` argument of ``sphinx.ext.autodoc.Documenter.get_doc()`` - 3.1 - 5.0 - N/A * - The ``template_dir`` argument of ``sphinx.ext.autosummary.generate.AutosummaryRenderer`` - 3.1 - 5.0 - N/A * - The ``module`` argument of ``sphinx.ext.autosummary.generate.find_autosummary_in_docstring()`` - 3.0 - 5.0 - N/A * - The ``builder`` argument of ``sphinx.ext.autosummary.generate.generate_autosummary_docs()`` - 3.1 - 5.0 - N/A * - The ``template_dir`` argument of ``sphinx.ext.autosummary.generate.generate_autosummary_docs()`` - 3.1 - 5.0 - N/A * - ``sphinx.ext.autosummary.generate.AutosummaryRenderer.exists()`` - 3.1 - 5.0 - N/A * - The ``ignore`` argument of ``sphinx.util.docstring.prepare_docstring()`` - 3.1 - 5.0 - N/A * - ``sphinx.util.rpartition()`` - 3.1 - 5.0 - ``str.rpartition()`` * - ``desc_signature['first']`` - - 3.0 - N/A * - ``sphinx.directives.DescDirective`` - 3.0 - 5.0 - ``sphinx.directives.ObjectDescription`` * - ``sphinx.domains.std.StandardDomain.add_object()`` - 3.0 - 5.0 - ``sphinx.domains.std.StandardDomain.note_object()`` * - ``sphinx.domains.python.PyDecoratorMixin`` - 3.0 - 5.0 - N/A * - ``sphinx.ext.autodoc.get_documenters()`` - 3.0 - 5.0 - ``sphinx.registry.documenters`` * - ``sphinx.ext.autosummary.process_autosummary_toc()`` - 3.0 - 5.0 - N/A * - ``sphinx.parsers.Parser.app`` - 3.0 - 5.0 - N/A * - ``sphinx.testing.path.Path.text()`` - 3.0 - 5.0 - ``sphinx.testing.path.Path.read_text()`` * - ``sphinx.testing.path.Path.bytes()`` - 3.0 - 5.0 - ``sphinx.testing.path.Path.read_bytes()`` * - ``sphinx.util.inspect.getargspec()`` - 3.0 - 5.0 - ``inspect.getargspec()`` * - ``sphinx.writers.latex.LaTeXWriter.format_docclass()`` - 3.0 - 5.0 - LaTeX Themes * - ``decode`` argument of ``sphinx.pycode.ModuleAnalyzer()`` - 2.4 - 4.0 - N/A * - ``sphinx.directives.other.Index`` - 2.4 - 4.0 - ``sphinx.domains.index.IndexDirective`` * - ``sphinx.environment.temp_data['gloss_entries']`` - 2.4 - 4.0 - ``documents.nameids`` * - ``sphinx.environment.BuildEnvironment.indexentries`` - 2.4 - 4.0 - ``sphinx.domains.index.IndexDomain`` * - ``sphinx.environment.collectors.indexentries.IndexEntriesCollector`` - 2.4 - 4.0 - ``sphinx.domains.index.IndexDomain`` * - ``sphinx.io.FiletypeNotFoundError`` - 2.4 - 4.0 - ``sphinx.errors.FiletypeNotFoundError`` * - ``sphinx.ext.apidoc.INITPY`` - 2.4 - 4.0 - N/A * - ``sphinx.ext.apidoc.shall_skip()`` - 2.4 - 4.0 - ``sphinx.ext.apidoc.is_skipped_package`` * - ``sphinx.io.get_filetype()`` - 2.4 - 4.0 - ``sphinx.util.get_filetype()`` * - ``sphinx.pycode.ModuleAnalyzer.encoding`` - 2.4 - 4.0 - N/A * - ``sphinx.roles.Index`` - 2.4 - 4.0 - ``sphinx.domains.index.IndexRole`` * - ``sphinx.util.detect_encoding()`` - 2.4 - 4.0 - ``tokenize.detect_encoding()`` * - ``sphinx.util.get_module_source()`` - 2.4 - 4.0 - N/A * - ``sphinx.util.inspect.Signature`` - 2.4 - 4.0 - ``sphinx.util.inspect.signature`` and ``sphinx.util.inspect.stringify_signature()`` * - ``sphinx.util.inspect.safe_getmembers()`` - 2.4 - 4.0 - ``inspect.getmembers()`` * - ``sphinx.writers.latex.LaTeXTranslator.settings.author`` - 2.4 - 4.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.settings.contentsname`` - 2.4 - 4.0 - ``document['contentsname']`` * - ``sphinx.writers.latex.LaTeXTranslator.settings.docclass`` - 2.4 - 4.0 - ``document['docclass']`` * - ``sphinx.writers.latex.LaTeXTranslator.settings.docname`` - 2.4 - 4.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.settings.title`` - 2.4 - 4.0 - N/A * - ``sphinx.writers.latex.ADDITIONAL_SETTINGS`` - 2.4 - 4.0 - ``sphinx.builders.latex.constants.ADDITIONAL_SETTINGS`` * - ``sphinx.writers.latex.DEFAULT_SETTINGS`` - 2.4 - 4.0 - ``sphinx.builders.latex.constants.DEFAULT_SETTINGS`` * - ``sphinx.writers.latex.LUALATEX_DEFAULT_FONTPKG`` - 2.4 - 4.0 - ``sphinx.builders.latex.constants.LUALATEX_DEFAULT_FONTPKG`` * - ``sphinx.writers.latex.PDFLATEX_DEFAULT_FONTPKG`` - 2.4 - 4.0 - ``sphinx.builders.latex.constants.PDFLATEX_DEFAULT_FONTPKG`` * - ``sphinx.writers.latex.XELATEX_DEFAULT_FONTPKG`` - 2.4 - 4.0 - ``sphinx.builders.latex.constants.XELATEX_DEFAULT_FONTPKG`` * - ``sphinx.writers.latex.XELATEX_GREEK_DEFAULT_FONTPKG`` - 2.4 - 4.0 - ``sphinx.builders.latex.constants.XELATEX_GREEK_DEFAULT_FONTPKG`` * - ``sphinx.builders.gettext.POHEADER`` - 2.3 - 4.0 - ``sphinx/templates/gettext/message.pot_t`` (template file) * - ``sphinx.io.SphinxStandaloneReader.app`` - 2.3 - 4.0 - ``sphinx.io.SphinxStandaloneReader.setup()`` * - ``sphinx.io.SphinxStandaloneReader.env`` - 2.3 - 4.0 - ``sphinx.io.SphinxStandaloneReader.setup()`` * - ``sphinx.util.texescape.tex_escape_map`` - 2.3 - 4.0 - ``sphinx.util.texescape.escape()`` * - ``sphinx.util.texescape.tex_hl_escape_map_new`` - 2.3 - 4.0 - ``sphinx.util.texescape.hlescape()`` * - ``sphinx.writers.latex.LaTeXTranslator.no_contractions`` - 2.3 - 4.0 - N/A * - ``sphinx.domains.math.MathDomain.add_equation()`` - 2.2 - 4.0 - ``sphinx.domains.math.MathDomain.note_equation()`` * - ``sphinx.domains.math.MathDomain.get_next_equation_number()`` - 2.2 - 4.0 - ``sphinx.domains.math.MathDomain.note_equation()`` * - The ``info`` and ``warn`` arguments of ``sphinx.ext.autosummary.generate.generate_autosummary_docs()`` - 2.2 - 4.0 - ``logging.info()`` and ``logging.warning()`` * - ``sphinx.ext.autosummary.generate._simple_info()`` - 2.2 - 4.0 - ``logging.info()`` * - ``sphinx.ext.autosummary.generate._simple_warn()`` - 2.2 - 4.0 - ``logging.warning()`` * - ``sphinx.ext.todo.merge_info()`` - 2.2 - 4.0 - ``sphinx.ext.todo.TodoDomain`` * - ``sphinx.ext.todo.process_todo_nodes()`` - 2.2 - 4.0 - ``sphinx.ext.todo.TodoDomain`` * - ``sphinx.ext.todo.process_todos()`` - 2.2 - 4.0 - ``sphinx.ext.todo.TodoDomain`` * - ``sphinx.ext.todo.purge_todos()`` - 2.2 - 4.0 - ``sphinx.ext.todo.TodoDomain`` * - ``sphinx.builders.latex.LaTeXBuilder.apply_transforms()`` - 2.1 - 4.0 - N/A * - ``sphinx.builders._epub_base.EpubBuilder.esc()`` - 2.1 - 4.0 - ``html.escape()`` * - ``sphinx.directives.Acks`` - 2.1 - 4.0 - ``sphinx.directives.other.Acks`` * - ``sphinx.directives.Author`` - 2.1 - 4.0 - ``sphinx.directives.other.Author`` * - ``sphinx.directives.Centered`` - 2.1 - 4.0 - ``sphinx.directives.other.Centered`` * - ``sphinx.directives.Class`` - 2.1 - 4.0 - ``sphinx.directives.other.Class`` * - ``sphinx.directives.CodeBlock`` - 2.1 - 4.0 - ``sphinx.directives.code.CodeBlock`` * - ``sphinx.directives.Figure`` - 2.1 - 4.0 - ``sphinx.directives.patches.Figure`` * - ``sphinx.directives.HList`` - 2.1 - 4.0 - ``sphinx.directives.other.HList`` * - ``sphinx.directives.Highlight`` - 2.1 - 4.0 - ``sphinx.directives.code.Highlight`` * - ``sphinx.directives.Include`` - 2.1 - 4.0 - ``sphinx.directives.other.Include`` * - ``sphinx.directives.Index`` - 2.1 - 4.0 - ``sphinx.directives.other.Index`` * - ``sphinx.directives.LiteralInclude`` - 2.1 - 4.0 - ``sphinx.directives.code.LiteralInclude`` * - ``sphinx.directives.Meta`` - 2.1 - 4.0 - ``sphinx.directives.patches.Meta`` * - ``sphinx.directives.Only`` - 2.1 - 4.0 - ``sphinx.directives.other.Only`` * - ``sphinx.directives.SeeAlso`` - 2.1 - 4.0 - ``sphinx.directives.other.SeeAlso`` * - ``sphinx.directives.TabularColumns`` - 2.1 - 4.0 - ``sphinx.directives.other.TabularColumns`` * - ``sphinx.directives.TocTree`` - 2.1 - 4.0 - ``sphinx.directives.other.TocTree`` * - ``sphinx.directives.VersionChange`` - 2.1 - 4.0 - ``sphinx.directives.other.VersionChange`` * - ``sphinx.domains.python.PyClassmember`` - 2.1 - 4.0 - ``sphinx.domains.python.PyAttribute``, ``sphinx.domains.python.PyMethod``, ``sphinx.domains.python.PyClassMethod``, ``sphinx.domains.python.PyObject`` and ``sphinx.domains.python.PyStaticMethod`` * - ``sphinx.domains.python.PyModulelevel`` - 2.1 - 4.0 - ``sphinx.domains.python.PyFunction``, ``sphinx.domains.python.PyObject`` and ``sphinx.domains.python.PyVariable`` * - ``sphinx.domains.std.StandardDomain._resolve_citation_xref()`` - 2.1 - 4.0 - ``sphinx.domains.citation.CitationDomain.resolve_xref()`` * - ``sphinx.domains.std.StandardDomain.note_citations()`` - 2.1 - 4.0 - ``sphinx.domains.citation.CitationDomain.note_citation()`` * - ``sphinx.domains.std.StandardDomain.note_citation_refs()`` - 2.1 - 4.0 - ``sphinx.domains.citation.CitationDomain.note_citation_reference()`` * - ``sphinx.domains.std.StandardDomain.note_labels()`` - 2.1 - 4.0 - ``sphinx.domains.std.StandardDomain.process_doc()`` * - ``sphinx.domains.js.JSObject.display_prefix`` - - 4.3 - ``sphinx.domains.js.JSObject.get_display_prefix()`` * - ``sphinx.environment.NoUri`` - 2.1 - 3.0 - ``sphinx.errors.NoUri`` * - ``sphinx.ext.apidoc.format_directive()`` - 2.1 - 4.0 - N/A * - ``sphinx.ext.apidoc.format_heading()`` - 2.1 - 4.0 - N/A * - ``sphinx.ext.apidoc.makename()`` - 2.1 - 4.0 - ``sphinx.ext.apidoc.module_join()`` * - ``sphinx.ext.autodoc.importer.MockFinder`` - 2.1 - 4.0 - ``sphinx.ext.autodoc.mock.MockFinder`` * - ``sphinx.ext.autodoc.importer.MockLoader`` - 2.1 - 4.0 - ``sphinx.ext.autodoc.mock.MockLoader`` * - ``sphinx.ext.autodoc.importer.mock()`` - 2.1 - 4.0 - ``sphinx.ext.autodoc.mock.mock()`` * - ``sphinx.ext.autosummary.autolink_role()`` - 2.1 - 4.0 - ``sphinx.ext.autosummary.AutoLink`` * - ``sphinx.ext.imgmath.DOC_BODY`` - 2.1 - 4.0 - N/A * - ``sphinx.ext.imgmath.DOC_BODY_PREVIEW`` - 2.1 - 4.0 - N/A * - ``sphinx.ext.imgmath.DOC_HEAD`` - 2.1 - 4.0 - N/A * - ``sphinx.transforms.CitationReferences`` - 2.1 - 4.0 - ``sphinx.domains.citation.CitationReferenceTransform`` * - ``sphinx.transforms.SmartQuotesSkipper`` - 2.1 - 4.0 - ``sphinx.domains.citation.CitationDefinitionTransform`` * - ``sphinx.util.docfields.DocFieldTransformer.preprocess_fieldtypes()`` - 2.1 - 4.0 - ``sphinx.directives.ObjectDescription.get_field_type_map()`` * - ``sphinx.util.node.find_source_node()`` - 2.1 - 4.0 - ``sphinx.util.node.get_node_source()`` * - ``sphinx.util.i18n.find_catalog()`` - 2.1 - 4.0 - ``sphinx.util.i18n.docname_to_domain()`` * - ``sphinx.util.i18n.find_catalog_files()`` - 2.1 - 4.0 - ``sphinx.util.i18n.CatalogRepository`` * - ``sphinx.util.i18n.find_catalog_source_files()`` - 2.1 - 4.0 - ``sphinx.util.i18n.CatalogRepository`` * - ``encoding`` argument of ``autodoc.Documenter.get_doc()``, ``autodoc.DocstringSignatureMixin.get_doc()``, ``autodoc.DocstringSignatureMixin._find_signature()``, and ``autodoc.ClassDocumenter.get_doc()`` - 2.0 - 4.0 - N/A * - arguments of ``EpubBuilder.build_mimetype()``, ``EpubBuilder.build_container()``, ``EpubBuilder.build_content()``, ``EpubBuilder.build_toc()`` and ``EpubBuilder.build_epub()`` - 2.0 - 4.0 - N/A * - arguments of ``Epub3Builder.build_navigation_doc()`` - 2.0 - 4.0 - N/A * - ``nodetype`` argument of ``sphinx.search.WordCollector.is_meta_keywords()`` - 2.0 - 4.0 - N/A * - ``suffix`` argument of ``BuildEnvironment.doc2path()`` - 2.0 - 4.0 - N/A * - string style ``base`` argument of ``BuildEnvironment.doc2path()`` - 2.0 - 4.0 - ``os.path.join()`` * - ``sphinx.addnodes.abbreviation`` - 2.0 - 4.0 - ``docutils.nodes.abbreviation`` * - ``sphinx.builders.applehelp`` - 2.0 - 4.0 - ``sphinxcontrib.applehelp`` * - ``sphinx.builders.devhelp`` - 2.0 - 4.0 - ``sphinxcontrib.devhelp`` * - ``sphinx.builders.epub3.Epub3Builder.validate_config_value()`` - 2.0 - 4.0 - ``sphinx.builders.epub3.validate_config_values()`` * - ``sphinx.builders.html.JSONHTMLBuilder`` - 2.0 - 4.0 - ``sphinx.builders.serializinghtml.JSONHTMLBuilder`` * - ``sphinx.builders.html.PickleHTMLBuilder`` - 2.0 - 4.0 - ``sphinx.builders.serializinghtml.PickleHTMLBuilder`` * - ``sphinx.builders.html.SerializingHTMLBuilder`` - 2.0 - 4.0 - ``sphinx.builders.serializinghtml.SerializingHTMLBuilder`` * - ``sphinx.builders.html.SingleFileHTMLBuilder`` - 2.0 - 4.0 - ``sphinx.builders.singlehtml.SingleFileHTMLBuilder`` * - ``sphinx.builders.html.WebHTMLBuilder`` - 2.0 - 4.0 - ``sphinx.builders.serializinghtml.PickleHTMLBuilder`` * - ``sphinx.builders.htmlhelp`` - 2.0 - 4.0 - ``sphinxcontrib.htmlhelp`` * - ``sphinx.builders.htmlhelp.HTMLHelpBuilder.open_file()`` - 2.0 - 4.0 - ``open()`` * - ``sphinx.builders.qthelp`` - 2.0 - 4.0 - ``sphinxcontrib.qthelp`` * - ``sphinx.cmd.quickstart.term_decode()`` - 2.0 - 4.0 - N/A * - ``sphinx.cmd.quickstart.TERM_ENCODING`` - 2.0 - 4.0 - ``sys.stdin.encoding`` * - ``sphinx.config.check_unicode()`` - 2.0 - 4.0 - N/A * - ``sphinx.config.string_classes`` - 2.0 - 4.0 - ``[str]`` * - ``sphinx.domains.cpp.DefinitionError.description`` - 2.0 - 4.0 - ``str(exc)`` * - ``sphinx.domains.cpp.NoOldIdError.description`` - 2.0 - 4.0 - ``str(exc)`` * - ``sphinx.domains.cpp.UnsupportedMultiCharacterCharLiteral.decoded`` - 2.0 - 4.0 - ``str(exc)`` * - ``sphinx.ext.autosummary.Autosummary.warn()`` - 2.0 - 4.0 - N/A * - ``sphinx.ext.autosummary.Autosummary.genopt`` - 2.0 - 4.0 - N/A * - ``sphinx.ext.autosummary.Autosummary.warnings`` - 2.0 - 4.0 - N/A * - ``sphinx.ext.autosummary.Autosummary.result`` - 2.0 - 4.0 - N/A * - ``sphinx.ext.doctest.doctest_encode()`` - 2.0 - 4.0 - N/A * - ``sphinx.ext.jsmath`` - 2.0 - 4.0 - ``sphinxcontrib.jsmath`` * - ``sphinx.roles.abbr_role()`` - 2.0 - 4.0 - ``sphinx.roles.Abbreviation`` * - ``sphinx.roles.emph_literal_role()`` - 2.0 - 4.0 - ``sphinx.roles.EmphasizedLiteral`` * - ``sphinx.roles.menusel_role()`` - 2.0 - 4.0 - ``sphinx.roles.GUILabel`` or ``sphinx.roles.MenuSelection`` * - ``sphinx.roles.index_role()`` - 2.0 - 4.0 - ``sphinx.roles.Index`` * - ``sphinx.roles.indexmarkup_role()`` - 2.0 - 4.0 - ``sphinx.roles.PEP`` or ``sphinx.roles.RFC`` * - ``sphinx.testing.util.remove_unicode_literal()`` - 2.0 - 4.0 - N/A * - ``sphinx.util.attrdict`` - 2.0 - 4.0 - N/A * - ``sphinx.util.force_decode()`` - 2.0 - 5.0 - N/A * - ``sphinx.util.get_matching_docs()`` - 2.0 - 4.0 - ``sphinx.util.get_matching_files()`` * - ``sphinx.util.inspect.Parameter`` - 2.0 - 3.0 - N/A * - ``sphinx.util.jsonimpl`` - 2.0 - 4.0 - ``sphinxcontrib.serializinghtml.jsonimpl`` * - ``sphinx.util.osutil.EEXIST`` - 2.0 - 4.0 - ``errno.EEXIST`` or ``FileExistsError`` * - ``sphinx.util.osutil.EINVAL`` - 2.0 - 4.0 - ``errno.EINVAL`` * - ``sphinx.util.osutil.ENOENT`` - 2.0 - 4.0 - ``errno.ENOENT`` or ``FileNotFoundError`` * - ``sphinx.util.osutil.EPIPE`` - 2.0 - 4.0 - ``errno.ENOENT`` or ``BrokenPipeError`` * - ``sphinx.util.osutil.walk()`` - 2.0 - 4.0 - ``os.walk()`` * - ``sphinx.util.pycompat.NoneType`` - 2.0 - 4.0 - ``sphinx.util.typing.NoneType`` * - ``sphinx.util.pycompat.TextIOWrapper`` - 2.0 - 4.0 - ``io.TextIOWrapper`` * - ``sphinx.util.pycompat.UnicodeMixin`` - 2.0 - 4.0 - N/A * - ``sphinx.util.pycompat.htmlescape()`` - 2.0 - 4.0 - ``html.escape()`` * - ``sphinx.util.pycompat.indent()`` - 2.0 - 4.0 - ``textwrap.indent()`` * - ``sphinx.util.pycompat.sys_encoding`` - 2.0 - 4.0 - ``sys.getdefaultencoding()`` * - ``sphinx.util.pycompat.terminal_safe()`` - 2.0 - 4.0 - ``sphinx.util.console.terminal_safe()`` * - ``sphinx.util.pycompat.u`` - 2.0 - 4.0 - N/A * - ``sphinx.util.PeekableIterator`` - 2.0 - 4.0 - N/A * - Omitting the ``filename`` argument in an overriddent ``IndexBuilder.feed()`` method. - 2.0 - 4.0 - ``IndexBuilder.feed(docname, filename, title, doctree)`` * - ``sphinx.writers.latex.ExtBabel`` - 2.0 - 4.0 - ``sphinx.builders.latex.util.ExtBabel`` * - ``sphinx.writers.latex.LaTeXTranslator.babel_defmacro()`` - 2.0 - 4.0 - N/A * - ``sphinx.application.Sphinx._setting_up_extension`` - 2.0 - 3.0 - N/A * - The ``importer`` argument of ``sphinx.ext.autodoc.importer._MockModule`` - 2.0 - 3.0 - N/A * - ``sphinx.ext.autodoc.importer._MockImporter`` - 2.0 - 3.0 - N/A * - ``sphinx.io.SphinxBaseFileInput`` - 2.0 - 3.0 - N/A * - ``sphinx.io.SphinxFileInput.supported`` - 2.0 - 3.0 - N/A * - ``sphinx.io.SphinxRSTFileInput`` - 2.0 - 3.0 - N/A * - ``sphinx.registry.SphinxComponentRegistry.add_source_input()`` - 2.0 - 3.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator._make_visit_admonition()`` - 2.0 - 3.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.collect_footnotes()`` - 2.0 - 4.0 - N/A * - ``sphinx.writers.texinfo.TexinfoTranslator._make_visit_admonition()`` - 2.0 - 3.0 - N/A * - ``sphinx.writers.text.TextTranslator._make_depart_admonition()`` - 2.0 - 3.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.generate_numfig_format()`` - 2.0 - 4.0 - N/A * - :rst:dir:`highlightlang` - 1.8 - 4.0 - :rst:dir:`highlight` * - :meth:`~sphinx.application.Sphinx.add_stylesheet()` - 1.8 - 6.0 - :meth:`~sphinx.application.Sphinx.add_css_file()` * - :meth:`~sphinx.application.Sphinx.add_javascript()` - 1.8 - 4.0 - :meth:`~sphinx.application.Sphinx.add_js_file()` * - :confval:`autodoc_default_flags` - 1.8 - 4.0 - :confval:`autodoc_default_options` * - ``content`` arguments of ``sphinx.util.image.guess_mimetype()`` - 1.8 - 3.0 - N/A * - ``gettext_compact`` arguments of ``sphinx.util.i18n.find_catalog_source_files()`` - 1.8 - 3.0 - N/A * - ``sphinx.io.SphinxI18nReader.set_lineno_for_reporter()`` - 1.8 - 3.0 - N/A * - ``sphinx.io.SphinxI18nReader.line`` - 1.8 - 3.0 - N/A * - ``sphinx.directives.other.VersionChanges`` - 1.8 - 3.0 - ``sphinx.domains.changeset.VersionChanges`` * - ``sphinx.highlighting.PygmentsBridge.unhighlight()`` - 1.8 - 3.0 - N/A * - ``trim_doctest_flags`` arguments of ``sphinx.highlighting.PygmentsBridge`` - 1.8 - 3.0 - N/A * - ``sphinx.ext.mathbase`` - 1.8 - 3.0 - N/A * - ``sphinx.ext.mathbase.MathDomain`` - 1.8 - 3.0 - ``sphinx.domains.math.MathDomain`` * - ``sphinx.ext.mathbase.MathDirective`` - 1.8 - 3.0 - ``sphinx.directives.patches.MathDirective`` * - ``sphinx.ext.mathbase.math_role()`` - 1.8 - 3.0 - ``docutils.parsers.rst.roles.math_role()`` * - ``sphinx.ext.mathbase.setup_math()`` - 1.8 - 3.0 - :meth:`~sphinx.application.Sphinx.add_html_math_renderer()` * - ``sphinx.ext.mathbase.is_in_section_title()`` - 1.8 - 3.0 - N/A * - ``sphinx.ext.mathbase.get_node_equation_number()`` - 1.8 - 3.0 - ``sphinx.util.math.get_node_equation_number()`` * - ``sphinx.ext.mathbase.wrap_displaymath()`` - 1.8 - 3.0 - ``sphinx.util.math.wrap_displaymath()`` * - ``sphinx.ext.mathbase.math`` (node) - 1.8 - 3.0 - ``docutils.nodes.math`` * - ``sphinx.ext.mathbase.displaymath`` (node) - 1.8 - 3.0 - ``docutils.nodes.math_block`` * - ``sphinx.ext.mathbase.eqref`` (node) - 1.8 - 3.0 - ``sphinx.builders.latex.nodes.math_reference`` * - ``viewcode_import`` (config value) - 1.8 - 3.0 - :confval:`viewcode_follow_imported_members` * - ``sphinx.writers.latex.Table.caption_footnotetexts`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.latex.Table.header_footnotetexts`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.footnotestack`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.in_container_literal_block`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.next_section_ids`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.next_hyperlink_ids`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.restrict_footnote()`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.unrestrict_footnote()`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.push_hyperlink_ids()`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.pop_hyperlink_ids()`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.bibitems`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.hlsettingstack`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.latex.ExtBabel.get_shorthandoff()`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.html.HTMLTranslator.highlightlang()`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.html.HTMLTranslator.highlightlang_base()`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.html.HTMLTranslator.highlightlangopts()`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.html.HTMLTranslator.highlightlinenothreshold()`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.html5.HTMLTranslator.highlightlang()`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.html5.HTMLTranslator.highlightlang_base()`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.html5.HTMLTranslator.highlightlangopts()`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.html5.HTMLTranslator.highlightlinenothreshold()`` - 1.8 - 3.0 - N/A * - ``sphinx.writers.latex.LaTeXTranslator.check_latex_elements()`` - 1.8 - 3.0 - Nothing * - ``sphinx.application.CONFIG_FILENAME`` - 1.8 - 3.0 - ``sphinx.config.CONFIG_FILENAME`` * - ``Config.check_unicode()`` - 1.8 - 3.0 - ``sphinx.config.check_unicode()`` * - ``Config.check_types()`` - 1.8 - 3.0 - ``sphinx.config.check_confval_types()`` * - ``dirname``, ``filename`` and ``tags`` arguments of ``Config.__init__()`` - 1.8 - 3.0 - ``Config.read()`` * - The value of :confval:`html_search_options` - 1.8 - 3.0 - see :confval:`html_search_options` * - ``sphinx.versioning.prepare()`` - 1.8 - 3.0 - ``sphinx.versioning.UIDTransform`` * - ``Sphinx.override_domain()`` - 1.8 - 3.0 - :meth:`~sphinx.application.Sphinx.add_domain()` * - ``Sphinx.import_object()`` - 1.8 - 3.0 - ``sphinx.util.import_object()`` * - ``suffix`` argument of :meth:`~sphinx.application.Sphinx.add_source_parser()` - 1.8 - 3.0 - :meth:`~sphinx.application.Sphinx.add_source_suffix()` * - ``BuildEnvironment.load()`` - 1.8 - 3.0 - ``pickle.load()`` * - ``BuildEnvironment.loads()`` - 1.8 - 3.0 - ``pickle.loads()`` * - ``BuildEnvironment.frompickle()`` - 1.8 - 3.0 - ``pickle.load()`` * - ``BuildEnvironment.dump()`` - 1.8 - 3.0 - ``pickle.dump()`` * - ``BuildEnvironment.dumps()`` - 1.8 - 3.0 - ``pickle.dumps()`` * - ``BuildEnvironment.topickle()`` - 1.8 - 3.0 - ``pickle.dump()`` * - ``BuildEnvironment._nitpick_ignore`` - 1.8 - 3.0 - :confval:`nitpick_ignore` * - ``BuildEnvironment.versionchanges`` - 1.8 - 3.0 - N/A * - ``BuildEnvironment.update()`` - 1.8 - 3.0 - ``Builder.read()`` * - ``BuildEnvironment.read_doc()`` - 1.8 - 3.0 - ``Builder.read_doc()`` * - ``BuildEnvironment._read_serial()`` - 1.8 - 3.0 - ``Builder.read()`` * - ``BuildEnvironment._read_parallel()`` - 1.8 - 3.0 - ``Builder.read()`` * - ``BuildEnvironment.write_doctree()`` - 1.8 - 3.0 - ``Builder.write_doctree()`` * - ``BuildEnvironment.note_versionchange()`` - 1.8 - 3.0 - ``ChangesDomain.note_changeset()`` * - ``warn()`` (template helper function) - 1.8 - 3.0 - ``warning()`` * - :confval:`source_parsers` - 1.8 - 3.0 - :meth:`~sphinx.application.Sphinx.add_source_parser()` * - ``sphinx.util.docutils.directive_helper()`` - 1.8 - 3.0 - ``Directive`` class of docutils * - ``sphinx.cmdline`` - 1.8 - 3.0 - ``sphinx.cmd.build`` * - ``sphinx.make_mode`` - 1.8 - 3.0 - ``sphinx.cmd.make_mode`` * - ``sphinx.locale.l_()`` - 1.8 - 3.0 - :func:`sphinx.locale._()` * - ``sphinx.locale.lazy_gettext()`` - 1.8 - 3.0 - :func:`sphinx.locale._()` * - ``sphinx.locale.mygettext()`` - 1.8 - 3.0 - :func:`sphinx.locale._()` * - ``sphinx.util.copy_static_entry()`` - 1.5 - 3.0 - ``sphinx.util.fileutil.copy_asset()`` * - ``sphinx.build_main()`` - 1.7 - 2.0 - ``sphinx.cmd.build.build_main()`` * - ``sphinx.ext.intersphinx.debug()`` - 1.7 - 2.0 - ``sphinx.ext.intersphinx.inspect_main()`` * - ``sphinx.ext.autodoc.format_annotation()`` - 1.7 - 2.0 - ``sphinx.util.inspect.Signature`` * - ``sphinx.ext.autodoc.formatargspec()`` - 1.7 - 2.0 - ``sphinx.util.inspect.Signature`` * - ``sphinx.ext.autodoc.AutodocReporter`` - 1.7 - 2.0 - ``sphinx.util.docutils.switch_source_input()`` * - ``sphinx.ext.autodoc.add_documenter()`` - 1.7 - 2.0 - :meth:`~sphinx.application.Sphinx.add_autodocumenter()` * - ``sphinx.ext.autodoc.AutoDirective._register`` - 1.7 - 2.0 - :meth:`~sphinx.application.Sphinx.add_autodocumenter()` * - ``AutoDirective._special_attrgetters`` - 1.7 - 2.0 - :meth:`~sphinx.application.Sphinx.add_autodoc_attrgetter()` * - ``Sphinx.warn()``, ``Sphinx.info()`` - 1.6 - 2.0 - :ref:`logging-api` * - ``BuildEnvironment.set_warnfunc()`` - 1.6 - 2.0 - :ref:`logging-api` * - ``BuildEnvironment.note_toctree()`` - 1.6 - 2.0 - ``Toctree.note()`` (in ``sphinx.environment.adapters.toctree``) * - ``BuildEnvironment.get_toc_for()`` - 1.6 - 2.0 - ``Toctree.get_toc_for()`` (in ``sphinx.environment.adapters.toctree``) * - ``BuildEnvironment.get_toctree_for()`` - 1.6 - 2.0 - ``Toctree.get_toctree_for()`` (in ``sphinx.environment.adapters.toctree``) * - ``BuildEnvironment.create_index()`` - 1.6 - 2.0 - ``IndexEntries.create_index()`` (in ``sphinx.environment.adapters.indexentries``) * - ``sphinx.websupport`` - 1.6 - 2.0 - `sphinxcontrib-websupport`_ .. _sphinxcontrib-websupport: https://pypi.org/project/sphinxcontrib-websupport/ * - ``StandaloneHTMLBuilder.css_files`` - 1.6 - 2.0 - :meth:`~sphinx.application.Sphinx.add_stylesheet()` * - ``document.settings.gettext_compact`` - 1.8 - 1.8 - :confval:`gettext_compact` * - ``Sphinx.status_iterator()`` - 1.6 - 1.7 - ``sphinx.util.status_iterator()`` * - ``Sphinx.old_status_iterator()`` - 1.6 - 1.7 - ``sphinx.util.old_status_iterator()`` * - ``Sphinx._directive_helper()`` - 1.6 - 1.7 - ``sphinx.util.docutils.directive_helper()`` * - ``sphinx.util.compat.Directive`` - 1.6 - 1.7 - ``docutils.parsers.rst.Directive`` * - ``sphinx.util.compat.docutils_version`` - 1.6 - 1.7 - ``sphinx.util.docutils.__version_info__`` .. note:: On deprecating on public APIs (internal functions and classes), we also follow the policy as much as possible. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/extdev/domainapi.rst0000644000076600000240000000071000000000000017070 0ustar00tkomiyastaff.. _domain-api: Domain API ========== .. module:: sphinx.domains .. autoclass:: Domain :members: .. autoclass:: ObjType .. autoclass:: Index :members: .. module:: sphinx.directives .. autoclass:: ObjectDescription :members: Python Domain ------------- .. module:: sphinx.domains.python .. autoclass:: PythonDomain .. autoattribute:: objects .. autoattribute:: modules .. automethod:: note_object .. automethod:: note_module ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163739.0 Sphinx-4.3.2/doc/extdev/envapi.rst0000644000076600000240000000202300000000000016410 0ustar00tkomiyastaffBuild environment API ===================== .. module:: sphinx.environment .. class:: BuildEnvironment **Attributes** .. attribute:: app Reference to the :class:`.Sphinx` (application) object. .. attribute:: config Reference to the :class:`.Config` object. .. attribute:: project Target project. See :class:`.Project`. .. attribute:: srcdir Source directory. .. attribute:: doctreedir Directory for storing pickled doctrees. .. attribute:: events An :class:`.EventManager` object. .. attribute:: found_docs A set of all existing docnames. .. attribute:: metadata Dictionary mapping docnames to "metadata" (see :ref:`metadata`). .. attribute:: titles Dictionary mapping docnames to the docutils node for their main title. .. autoattribute:: docname **Utility methods** .. automethod:: doc2path .. automethod:: relfn2path .. automethod:: note_dependency .. automethod:: new_serialno .. automethod:: note_reread ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/extdev/i18n.rst0000644000076600000240000000540100000000000015710 0ustar00tkomiyastaff.. _i18n-api: i18n API ======== .. currentmodule:: sphinx.locale .. autofunction:: init .. autofunction:: init_console .. autofunction:: get_translation .. autofunction:: _ .. autofunction:: __ .. _ext-i18n: Extension internationalization (`i18n`) and localization (`l10n`) using i18n API -------------------------------------------------------------------------------- .. versionadded:: 1.8 An extension may naturally come with message translations. This is briefly summarized in :func:`sphinx.locale.get_translation` help. In practice, you have to: #. Choose a name for your message catalog, which must be unique. Usually the name of your extension is used for the name of message catalog. #. Mark in your extension sources all messages as translatable, via :func:`sphinx.locale.get_translation` function, usually renamed ``_()``, e.g.: .. code-block:: python :caption: src/__init__.py from sphinx.locale import get_translation MESSAGE_CATALOG_NAME = 'myextension' _ = get_translation(MESSAGE_CATALOG_NAME) translated_text = _('Hello Sphinx!') #. Set up your extension to be aware of its dedicated translations: .. code-block:: python :caption: src/__init__.py def setup(app): package_dir = path.abspath(path.dirname(__file__)) locale_dir = os.path.join(package_dir, 'locales') app.add_message_catalog(MESSAGE_CATALOG_NAME, locale_dir) #. Generate message catalog template ``*.pot`` file, usually in ``locale/`` source directory, for example via `Babel`_: .. code-block:: console $ pybabel extract --output=src/locale/myextension.pot src/ #. Create message catalogs (``*.po``) for each language which your extension will provide localization, for example via `Babel`_: .. code-block:: console $ pybabel init --input-file=src/locale/myextension.pot --domain=myextension --output-dir=src/locale --locale=fr_FR #. Translate message catalogs for each language manually #. Compile message catalogs into ``*.mo`` files, for example via `Babel`_: .. code-block:: console $ pybabel compile --directory=src/locale --domain=myextension #. Ensure that message catalog files are distributed when your package will be installed, by adding equivalent line in your extension ``MANIFEST.in``: .. code-block:: ini :caption: MANIFEST.in recursive-include src *.pot *.po *.mo When the messages on your extension has been changed, you need to also update message catalog template and message catalogs, for example via `Babel`_: .. code-block:: console $ pybabel extract --output=src/locale/myextension.pot src/ $ pybabel update --input-file=src/locale/myextension.pot --domain=myextension --output-dir=src/locale .. _Babel: https://babel.pocoo.org/ ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/extdev/index.rst0000644000076600000240000002100000000000000016231 0ustar00tkomiyastaff.. _dev-extensions: Developing extensions for Sphinx ================================ Since many projects will need special features in their documentation, Sphinx is designed to be extensible on several levels. Here are a few things you can do in an extension: * Add new :term:`builder`\s to support new output formats or actions on the parsed documents. * Register custom reStructuredText roles and directives, extending the markup using the :doc:`markupapi`. * Add custom code to so-called "hook points" at strategic places throughout the build process, allowing you to register a hook and run specialized code. For example, see the :ref:`events`. An extension is simply a Python module with a ``setup()`` function. A user activates the extension by placing the extension's module name (or a sub-module) in their :confval:`extensions` configuration value. When :program:`sphinx-build` is executed, Sphinx will attempt to import each module that is listed, and execute ``yourmodule.setup(app)``. This function is used to prepare the extension (e.g., by executing Python code), linking resources that Sphinx uses in the build process (like CSS or HTML files), and notifying Sphinx of everything the extension offers (such as directive or role definitions). The ``app`` argument is an instance of :class:`.Sphinx` and gives you control over most aspects of the Sphinx build. .. note:: The configuration file itself can be treated as an extension if it contains a ``setup()`` function. All other extensions to load must be listed in the :confval:`extensions` configuration value. The rest of this page describes some high-level aspects of developing extensions and various parts of Sphinx's behavior that you can control. For some examples of how extensions can be built and used to control different parts of Sphinx, see the :ref:`extension-tutorials-index`. .. _important-objects: Important objects ----------------- There are several key objects whose API you will use while writing an extension. These are: **Application** The application object (usually called ``app``) is an instance of :class:`.Sphinx`. It controls most high-level functionality, such as the setup of extensions, event dispatching and producing output (logging). If you have the environment object, the application is available as ``env.app``. **Environment** The build environment object (usually called ``env``) is an instance of :class:`.BuildEnvironment`. It is responsible for parsing the source documents, stores all metadata about the document collection and is serialized to disk after each build. Its API provides methods to do with access to metadata, resolving references, etc. It can also be used by extensions to cache information that should persist for incremental rebuilds. If you have the application or builder object, the environment is available as ``app.env`` or ``builder.env``. **Builder** The builder object (usually called ``builder``) is an instance of a specific subclass of :class:`.Builder`. Each builder class knows how to convert the parsed documents into an output format, or otherwise process them (e.g. check external links). If you have the application object, the builder is available as ``app.builder``. **Config** The config object (usually called ``config``) provides the values of configuration values set in :file:`conf.py` as attributes. It is an instance of :class:`.Config`. The config is available as ``app.config`` or ``env.config``. To see an example of use of these objects, refer to :doc:`../development/tutorials/index`. .. _build-phases: Build Phases ------------ One thing that is vital in order to understand extension mechanisms is the way in which a Sphinx project is built: this works in several phases. **Phase 0: Initialization** In this phase, almost nothing of interest to us happens. The source directory is searched for source files, and extensions are initialized. Should a stored build environment exist, it is loaded, otherwise a new one is created. **Phase 1: Reading** In Phase 1, all source files (and on subsequent builds, those that are new or changed) are read and parsed. This is the phase where directives and roles are encountered by docutils, and the corresponding code is executed. The output of this phase is a *doctree* for each source file; that is a tree of docutils nodes. For document elements that aren't fully known until all existing files are read, temporary nodes are created. There are nodes provided by docutils, which are documented `in the docutils documentation `__. Additional nodes are provided by Sphinx and :ref:`documented here `. During reading, the build environment is updated with all meta- and cross reference data of the read documents, such as labels, the names of headings, described Python objects and index entries. This will later be used to replace the temporary nodes. The parsed doctrees are stored on the disk, because it is not possible to hold all of them in memory. **Phase 2: Consistency checks** Some checking is done to ensure no surprises in the built documents. **Phase 3: Resolving** Now that the metadata and cross-reference data of all existing documents is known, all temporary nodes are replaced by nodes that can be converted into output using components called transforms. For example, links are created for object references that exist, and simple literal nodes are created for those that don't. **Phase 4: Writing** This phase converts the resolved doctrees to the desired output format, such as HTML or LaTeX. This happens via a so-called docutils writer that visits the individual nodes of each doctree and produces some output in the process. .. note:: Some builders deviate from this general build plan, for example, the builder that checks external links does not need anything more than the parsed doctrees and therefore does not have phases 2--4. To see an example of application, refer to :doc:`../development/tutorials/todo`. .. _ext-metadata: Extension metadata ------------------ .. versionadded:: 1.3 The ``setup()`` function can return a dictionary. This is treated by Sphinx as metadata of the extension. Metadata keys currently recognized are: * ``'version'``: a string that identifies the extension version. It is used for extension version requirement checking (see :confval:`needs_extensions`) and informational purposes. If not given, ``"unknown version"`` is substituted. * ``'env_version'``: an integer that identifies the version of env data structure if the extension stores any data to environment. It is used to detect the data structure has been changed from last build. The extensions have to increment the version when data structure has changed. If not given, Sphinx considers the extension does not stores any data to environment. * ``'parallel_read_safe'``: a boolean that specifies if parallel reading of source files can be used when the extension is loaded. It defaults to ``False``, i.e. you have to explicitly specify your extension to be parallel-read-safe after checking that it is. .. note:: The *parallel-read-safe* extension must satisfy the following conditions: * The core logic of the extension is parallelly executable during the reading phase. * It has event handlers for :event:`env-merge-info` and :event:`env-purge-doc` events if it stores dataa to the build environment object (env) during the reading phase. * ``'parallel_write_safe'``: a boolean that specifies if parallel writing of output files can be used when the extension is loaded. Since extensions usually don't negatively influence the process, this defaults to ``True``. .. note:: The *parallel-write-safe* extension must satisfy the following conditions: * The core logic of the extension is parallelly executable during the writing phase. APIs used for writing extensions -------------------------------- These sections provide a more complete description of the tools at your disposal when developing Sphinx extensions. Some are core to Sphinx (such as the :doc:`appapi`) while others trigger specific behavior (such as the :doc:`i18n`) .. toctree:: :maxdepth: 2 appapi projectapi envapi builderapi collectorapi markupapi domainapi parserapi nodes logging i18n utils deprecated ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163739.0 Sphinx-4.3.2/doc/extdev/logging.rst0000644000076600000240000000452000000000000016560 0ustar00tkomiyastaff.. _logging-api: Logging API =========== .. currentmodule:: sphinx.util.logging .. autofunction:: getLogger(name) .. autoclass:: SphinxLoggerAdapter(logging.LoggerAdapter) .. method:: SphinxLoggerAdapter.error(msg, *args, **kwargs) .. method:: SphinxLoggerAdapter.critical(msg, *args, **kwargs) .. method:: SphinxLoggerAdapter.warning(msg, *args, **kwargs) Logs a message on this logger with the specified level. Basically, the arguments are as with python's logging module. In addition, Sphinx logger supports following keyword arguments: **type**, ***subtype*** Categories of warning logs. It is used to suppress warnings by :confval:`suppress_warnings` setting. **location** Where the warning happened. It is used to include the path and line number in each log. It allows docname, tuple of docname and line number and nodes:: logger = sphinx.util.logging.getLogger(__name__) logger.warning('Warning happened!', location='index') logger.warning('Warning happened!', location=('chapter1/index', 10)) logger.warning('Warning happened!', location=some_node) **color** The color of logs. By default, error level logs are colored as ``"darkred"``, critical level ones is not colored, and warning level ones are colored as ``"red"``. .. method:: SphinxLoggerAdapter.log(level, msg, *args, **kwargs) .. method:: SphinxLoggerAdapter.info(msg, *args, **kwargs) .. method:: SphinxLoggerAdapter.verbose(msg, *args, **kwargs) .. method:: SphinxLoggerAdapter.debug(msg, *args, **kwargs) Logs a message to this logger with the specified level. Basically, the arguments are as with python's logging module. In addition, Sphinx logger supports following keyword arguments: **nonl** If true, the logger does not fold lines at the end of the log message. The default is ``False``. **location** Where the message emitted. For more detail, see :meth:`SphinxLoggerAdapter.warning`. **color** The color of logs. By default, info and verbose level logs are not colored, and debug level ones are colored as ``"darkgray"``. .. autofunction:: pending_logging() .. autofunction:: pending_warnings() .. autofunction:: prefixed_warnings() ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/extdev/markupapi.rst0000644000076600000240000001127300000000000017126 0ustar00tkomiyastaffDocutils markup API =================== This section describes the API for adding ReST markup elements (roles and directives). Roles ----- Directives ---------- 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`. .. module:: docutils.parsers.rst .. class:: Directive The markup syntax of the new directive is determined by the follow five class attributes: .. autoattribute:: required_arguments .. autoattribute:: optional_arguments .. autoattribute:: final_argument_whitespace .. autoattribute:: option_spec 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. There are several predefined and possibly useful validators in the :mod:`docutils.parsers.rst.directives` module. .. autoattribute:: has_content New directives must implement the :meth:`run` method: .. method:: run() 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. Instance attributes that are always set on the directive are: .. attribute:: name The directive name (useful when registering the same directive class under multiple names). .. attribute:: arguments The arguments given to the directive, as a list. .. attribute:: options The options given to the directive, as a dictionary mapping option names to validated/converted values. .. attribute:: content The directive content, if given, as a :class:`.ViewList`. .. attribute:: lineno The absolute line number on which the directive appeared. This is not always a useful value; use :attr:`srcline` instead. .. attribute:: content_offset Internal offset of the directive content. Used when calling ``nested_parse`` (see below). .. attribute:: block_text The string containing the entire directive. .. attribute:: state state_machine The state and state machine which controls the parsing. Used for ``nested_parse``. ViewLists ^^^^^^^^^ 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. 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: * The constructor takes a list of strings (lines) and a source (document) name. * The ``.append()`` method takes a line and a source name as well. Parsing directive content as ReST ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 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: * ``self.state.nested_parse`` * :func:`sphinx.util.nodes.nested_parse_with_titles` -- this allows titles in the parsed content. Both APIs parse the content into a given node. They are used like this:: node = docutils.nodes.paragraph() # either nested_parse_with_titles(self.state, self.result, node) # or self.state.nested_parse(self.result, 0, node) .. note:: ``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:: from sphinx.util.docutils import switch_source_input # Switch source_input between parsing content. # Inside this context, all parsing errors and warnings are reported as # happened in new source_input (in this case, ``self.result``). with switch_source_input(self.state, self.result): node = docutils.nodes.paragraph() self.state.nested_parse(self.result, 0, node) .. deprecated:: 1.7 Until Sphinx-1.6, ``sphinx.ext.autodoc.AutodocReporter`` is used for this purpose. For now, it is replaced by ``switch_source_input()``. If you don't need the wrapping node, you can use any concrete node type and return ``node.children`` from the Directive. .. seealso:: `Creating directives`_ HOWTO of the Docutils documentation .. _Creating directives: https://docutils.sourceforge.io/docs/howto/rst-directives.html ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/extdev/nodes.rst0000644000076600000240000000305700000000000016246 0ustar00tkomiyastaff.. _nodes: Doctree node classes added by Sphinx ==================================== .. module:: sphinx.addnodes Nodes for domain-specific object descriptions --------------------------------------------- Top-level nodes ............... These nodes form the top-most levels of object descriptions. .. autoclass:: desc .. autoclass:: desc_signature .. autoclass:: desc_signature_line .. autoclass:: desc_content .. autoclass:: desc_inline Nodes for high-level structure in signatures ............................................ These nodes occur in in non-multiline :py:class:`desc_signature` nodes and in :py:class:`desc_signature_line` nodes. .. autoclass:: desc_name .. autoclass:: desc_addname .. autoclass:: desc_type .. autoclass:: desc_returns .. autoclass:: desc_parameterlist .. autoclass:: desc_parameter .. autoclass:: desc_optional .. autoclass:: desc_annotation New admonition-like constructs ------------------------------ .. autoclass:: versionmodified .. autoclass:: seealso Other paragraph-level nodes ------------------------------- .. autoclass:: compact_paragraph New inline nodes ---------------- .. autoclass:: index .. autoclass:: pending_xref .. autoclass:: pending_xref_condition .. autoclass:: literal_emphasis .. autoclass:: download_reference Special nodes ------------- .. autoclass:: only .. autoclass:: meta .. autoclass:: highlightlang You should not need to generate the nodes below in extensions. .. autoclass:: glossary .. autoclass:: toctree .. autoclass:: start_of_file .. autoclass:: productionlist .. autoclass:: production ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/extdev/parserapi.rst0000644000076600000240000000231600000000000017121 0ustar00tkomiyastaff.. _parser-api: Parser API ========== `The docutils documentation describes`__ parsers as follows: The Parser analyzes the input document and creates a node tree representation. __ https://docutils.sourceforge.io/docs/dev/hacking.html#parsing-the-document In Sphinx, the parser modules works as same as docutils. The parsers are registered to Sphinx by extensions using Application APIs; :meth:`.Sphinx.add_source_suffix()` and :meth:`.Sphinx.add_source_parser()`. The *source suffix* is a mapping from file suffix to file type. For example, ``.rst`` file is mapped to ``'restructuredtext'`` type. Sphinx uses the file type to looking for parsers from registered list. On searching, Sphinx refers to the ``Parser.supported`` attribute and picks up a parser which contains the file type in the attribute. The users can override the source suffix mappings using :confval:`source_suffix` like following:: # a mapping from file suffix to file types source_suffix = { '.rst': 'restructuredtext', '.md': 'markdown', } You should indicate file types your parser supports. This will allow users to configure their settings appropriately. .. module:: sphinx.parsers .. autoclass:: Parser ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163739.0 Sphinx-4.3.2/doc/extdev/projectapi.rst0000644000076600000240000000016200000000000017270 0ustar00tkomiyastaff.. _project-api: Project API =========== .. currentmodule:: sphinx.project .. autoclass:: Project :members: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163739.0 Sphinx-4.3.2/doc/extdev/utils.rst0000644000076600000240000000165700000000000016302 0ustar00tkomiyastaffUtilities ========= Sphinx provides utility classes and functions to develop extensions. Base classes for components --------------------------- These base classes are useful to allow your extensions to obtain Sphinx components (e.g. :class:`.Config`, :class:`.BuildEnvironment` and so on) easily. .. note:: The subclasses of them might not work with bare docutils because they are strongly coupled with Sphinx. .. autoclass:: sphinx.transforms.SphinxTransform :members: .. autoclass:: sphinx.transforms.post_transforms.SphinxPostTransform :members: .. autoclass:: sphinx.util.docutils.SphinxDirective :members: .. autoclass:: sphinx.util.docutils.SphinxRole :members: .. autoclass:: sphinx.util.docutils.ReferenceRole :members: .. autoclass:: sphinx.transforms.post_transforms.images.ImageConverter :members: Utility components ------------------ .. autoclass:: sphinx.events.EventManager :members: ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/faq.rst0000644000076600000240000003256600000000000014415 0ustar00tkomiyastaff.. _faq: Sphinx FAQ ========== This is a list of Frequently Asked Questions about Sphinx. Feel free to suggest new entries! How do I... ----------- ... create PDF files without LaTeX? `rinohtype`_ provides a PDF builder that can be used as a drop-in replacement for the LaTeX builder. .. _rinohtype: https://github.com/brechtm/rinohtype ... get section numbers? They are automatic in LaTeX output; for HTML, give a ``:numbered:`` option to the :rst:dir:`toctree` directive where you want to start numbering. ... customize the look of the built HTML files? Use themes, see :doc:`/usage/theming`. ... add global substitutions or includes? Add them in the :confval:`rst_prolog` or :confval:`rst_epilog` config value. ... display the whole TOC tree in the sidebar? Use the :data:`toctree` callable in a custom layout template, probably in the ``sidebartoc`` block. ... write my own extension? See the :doc:`/development/tutorials/index`. ... convert from my existing docs using MoinMoin markup? The easiest way is to convert to xhtml, then convert `xhtml to reST`_. You'll still need to mark up classes and such, but the headings and code examples come through cleanly. For many more extensions and other contributed stuff, see the sphinx-contrib_ repository. .. _sphinx-contrib: https://bitbucket.org/birkenfeld/sphinx-contrib/ .. _usingwith: Using Sphinx with... -------------------- Read the Docs `Read the Docs `_ is a documentation hosting service based around Sphinx. They will host sphinx documentation, along with supporting a number of other features including version support, PDF generation, and more. The `Getting Started`_ guide is a good place to start. Epydoc There's a third-party extension providing an `api role`_ which refers to Epydoc's API docs for a given identifier. Doxygen Michael Jones is developing a reST/Sphinx bridge to doxygen called `breathe `_. SCons Glenn Hutchings has written a SCons build script to build Sphinx documentation; it is hosted here: https://bitbucket.org/zondo/sphinx-scons PyPI Jannis Leidel wrote a `setuptools command `_ that automatically uploads Sphinx documentation to the PyPI package documentation area at https://pythonhosted.org/. GitHub Pages Please add :py:mod:`sphinx.ext.githubpages` to your project. It allows you to publish your document in GitHub Pages. It generates helper files for GitHub Pages on building HTML document automatically. MediaWiki See https://bitbucket.org/kevindunn/sphinx-wiki/wiki/Home, a project by Kevin Dunn. Google Analytics You can use a custom ``layout.html`` template, like this: .. code-block:: html+jinja {% extends "!layout.html" %} {%- block extrahead %} {{ super() }} {% endblock %} {% block footer %} {{ super() }}
    This page uses Google Analytics to collect statistics. You can disable it by blocking the JavaScript coming from www.google-analytics.com.
    {% endblock %} Google Search To replace Sphinx's built-in search function with Google Search, proceed as follows: 1. Go to https://cse.google.com/cse/all to create the Google Search code snippet. 2. Copy the code snippet and paste it into ``_templates/searchbox.html`` in your Sphinx project: .. code-block:: html+jinja

    {{ _('Quick search') }}

    3. Add ``searchbox.html`` to the :confval:`html_sidebars` configuration value. .. _Getting Started: https://docs.readthedocs.io/en/stable/intro/getting-started-with-sphinx.html .. _api role: https://git.savannah.gnu.org/cgit/kenozooid.git/tree/doc/extapi.py .. _xhtml to reST: https://docutils.sourceforge.io/sandbox/xhtml2rest/xhtml2rest.py Sphinx vs. Docutils ------------------- tl;dr: *docutils* converts reStructuredText to multiple output formats. Sphinx builds upon docutils to allow construction of cross-referenced and indexed bodies of documentation. `docutils`__ is a text processing system for converting plain text documentation into other, richer formats. As noted in the `docutils documentation`__, docutils uses *readers* to read a document, *parsers* for parsing plain text formats into an internal tree representation made up of different types of *nodes*, and *writers* to output this tree in various document formats. docutils provides parsers for one plain text format - `reStructuredText`__ - though other, *out-of-tree* parsers have been implemented including Sphinx's :doc:`Markdown parser `. On the other hand, it provides writers for many different formats including HTML, LaTeX, man pages, Open Document Format and XML. docutils exposes all of its functionality through a variety of `front-end tools`__, such as ``rst2html``, ``rst2odt`` and ``rst2xml``. Crucially though, all of these tools, and docutils itself, are concerned with individual documents. They don't support concepts such as cross-referencing, indexing of documents, or the construction of a document hierarchy (typically manifesting in a table of contents). Sphinx builds upon docutils by harnessing docutils' readers and parsers and providing its own :doc:`/usage/builders/index`. As a result, Sphinx wraps some of the *writers* provided by docutils. This allows Sphinx to provide many features that would simply not be possible with docutils, such as those outlined above. __ https://docutils.sourceforge.io/ __ https://docutils.sourceforge.io/docs/dev/hacking.html __ https://docutils.sourceforge.io/rst.html __ https://docutils.sourceforge.io/docs/user/tools.html .. _epub-faq: Epub info --------- The following list gives some hints for the creation of epub files: * Split the text into several files. The longer the individual HTML files are, the longer it takes the ebook reader to render them. In extreme cases, the rendering can take up to one minute. * Try to minimize the markup. This also pays in rendering time. * For some readers you can use embedded or external fonts using the CSS ``@font-face`` directive. This is *extremely* useful for code listings which are often cut at the right margin. The default Courier font (or variant) is quite wide and you can only display up to 60 characters on a line. If you replace it with a narrower font, you can get more characters on a line. You may even use `FontForge `_ and create narrow variants of some free font. In my case I get up to 70 characters on a line. You may have to experiment a little until you get reasonable results. * Test the created epubs. You can use several alternatives. The ones I am aware of are Epubcheck_, Calibre_, FBreader_ (although it does not render the CSS), and Bookworm_. For Bookworm, you can download the source from https://code.google.com/archive/p/threepress and run your own local server. * Large floating divs are not displayed properly. If they cover more than one page, the div is only shown on the first page. In that case you can copy the :file:`epub.css` from the ``sphinx/themes/epub/static/`` directory to your local ``_static/`` directory and remove the float settings. * Files that are inserted outside of the ``toctree`` directive must be manually included. This sometimes applies to appendixes, e.g. the glossary or the indices. You can add them with the :confval:`epub_post_files` option. * The handling of the epub cover page differs from the reStructuredText procedure which automatically resolves image paths and puts the images into the ``_images`` directory. For the epub cover page put the image in the :confval:`html_static_path` directory and reference it with its full path in the :confval:`epub_cover` config option. * kindlegen_ command can convert from epub3 resulting file to ``.mobi`` file for Kindle. You can get ``yourdoc.mobi`` under ``_build/epub`` after the following command: .. code-block:: bash $ make epub $ kindlegen _build/epub/yourdoc.epub The kindlegen command doesn't accept documents that have section titles surrounding ``toctree`` directive: .. code-block:: rst Section Title ============= .. toctree:: subdocument Section After Toc Tree ====================== kindlegen assumes all documents order in line, but the resulting document has complicated order for kindlegen:: ``parent.xhtml`` -> ``child.xhtml`` -> ``parent.xhtml`` If you get the following error, fix your document structure: .. code-block:: none Error(prcgen):E24011: TOC section scope is not included in the parent chapter:(title) Error(prcgen):E24001: The table of content could not be built. .. _Epubcheck: https://github.com/IDPF/epubcheck .. _Calibre: https://calibre-ebook.com/ .. _FBreader: https://fbreader.org/ .. _Bookworm: https://www.oreilly.com/bookworm/index.html .. _kindlegen: https://www.amazon.com/gp/feature.html?docId=1000765211 .. _texinfo-faq: Texinfo info ------------ There are two main programs for reading Info files, ``info`` and GNU Emacs. The ``info`` program has less features but is available in most Unix environments and can be quickly accessed from the terminal. Emacs provides better font and color display and supports extensive customization (of course). .. _texinfo-links: Displaying Links ~~~~~~~~~~~~~~~~ One noticeable problem you may encounter with the generated Info files is how references are displayed. If you read the source of an Info file, a reference to this section would look like:: * note Displaying Links: target-id In the stand-alone reader, ``info``, references are displayed just as they appear in the source. Emacs, on the other-hand, will by default replace ``*note:`` with ``see`` and hide the ``target-id``. For example: :ref:`texinfo-links` The exact behavior of how Emacs displays references is dependent on the variable ``Info-hide-note-references``. If set to the value of ``hide``, Emacs will hide both the ``*note:`` part and the ``target-id``. This is generally the best way to view Sphinx-based documents since they often make frequent use of links and do not take this limitation into account. However, changing this variable affects how all Info documents are displayed and most do take this behavior into account. If you want Emacs to display Info files produced by Sphinx using the value ``hide`` for ``Info-hide-note-references`` and the default value for all other Info files, try adding the following Emacs Lisp code to your start-up file, ``~/.emacs.d/init.el``. .. code-block:: elisp (defadvice info-insert-file-contents (after sphinx-info-insert-file-contents activate) "Hack to make `Info-hide-note-references' buffer-local and automatically set to `hide' iff it can be determined that this file was created from a Texinfo file generated by Docutils or Sphinx." (set (make-local-variable 'Info-hide-note-references) (default-value 'Info-hide-note-references)) (save-excursion (save-restriction (widen) (goto-char (point-min)) (when (re-search-forward "^Generated by \\(Sphinx\\|Docutils\\)" (save-excursion (search-forward "\x1f" nil t)) t) (set (make-local-variable 'Info-hide-note-references) 'hide))))) Notes ~~~~~ The following notes may be helpful if you want to create Texinfo files: - Each section corresponds to a different ``node`` in the Info file. - Colons (``:``) cannot be properly escaped in menu entries and xrefs. They will be replaced with semicolons (``;``). - Links to external Info files can be created using the somewhat official URI scheme ``info``. For example:: info:Texinfo#makeinfo_options - Inline markup The standard formatting for ``*strong*`` and ``_emphasis_`` can result in ambiguous output when used to markup parameter names and other values. Since this is a fairly common practice, the default formatting has been changed so that ``emphasis`` and ``strong`` are now displayed like ```literal'``\s. The standard formatting can be re-enabled by adding the following to your :file:`conf.py`:: texinfo_elements = {'preamble': """ @definfoenclose strong,*,* @definfoenclose emph,_,_ """} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/glossary.rst0000644000076600000240000001011200000000000015470 0ustar00tkomiyastaff.. _glossary: Glossary ======== .. glossary:: builder A class (inheriting from :class:`~sphinx.builders.Builder`) that takes parsed documents and performs an action on them. Normally, builders translate the documents to an output format, but it is also possible to use builders that e.g. check for broken links in the documentation, or build coverage information. See :doc:`/usage/builders/index` for an overview over Sphinx's built-in builders. configuration directory The directory containing :file:`conf.py`. By default, this is the same as the :term:`source directory`, but can be set differently with the **-c** command-line option. directive A reStructuredText markup element that allows marking a block of content with special meaning. Directives are supplied not only by docutils, but Sphinx and custom extensions can add their own. The basic directive syntax looks like this: .. sourcecode:: rst .. directivename:: argument ... :option: value Content of the directive. See :ref:`rst-directives` for more information. document name Since reST source files can have different extensions (some people like ``.txt``, some like ``.rst`` -- the extension can be configured with :confval:`source_suffix`) and different OSes have different path separators, Sphinx abstracts them: :dfn:`document names` are always relative to the :term:`source directory`, the extension is stripped, and path separators are converted to slashes. All values, parameters and such referring to "documents" expect such document names. Examples for document names are ``index``, ``library/zipfile``, or ``reference/datamodel/types``. Note that there is no leading or trailing slash. domain A domain is a collection of markup (reStructuredText :term:`directive`\ s and :term:`role`\ s) to describe and link to :term:`object`\ s belonging together, e.g. elements of a programming language. Directive and role names in a domain have names like ``domain:name``, e.g. ``py:function``. Having domains means that there are no naming problems when one set of documentation wants to refer to e.g. C++ and Python classes. It also means that extensions that support the documentation of whole new languages are much easier to write. For more information, refer to :doc:`/usage/restructuredtext/domains`. environment A structure where information about all documents under the root is saved, and used for cross-referencing. The environment is pickled after the parsing stage, so that successive runs only need to read and parse new and changed documents. extension A custom :term:`role`, :term:`directive` or other aspect of Sphinx that allows users to modify any aspect of the build process within Sphinx. For more information, refer to :doc:`/usage/extensions/index`. master document The document that contains the root :rst:dir:`toctree` directive. root document Same as :term:`master document`. object The basic building block of Sphinx documentation. Every "object directive" (e.g. :rst:dir:`function` or :rst:dir:`object`) creates such a block; and most objects can be cross-referenced to. RemoveInSphinxXXXWarning The feature which is warned will be removed in Sphinx-XXX version. It usually caused from Sphinx extensions which is using deprecated. See also :ref:`when-deprecation-warnings-are-displayed`. role A reStructuredText markup element that allows marking a piece of text. Like directives, roles are extensible. The basic syntax looks like this: ``:rolename:`content```. See :ref:`rst-inline-markup` for details. source directory The directory which, including its subdirectories, contains all source files for one Sphinx project. reStructuredText An easy-to-read, what-you-see-is-what-you-get plaintext markup syntax and parser system. ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.4137123 Sphinx-4.3.2/doc/internals/0000755000076600000240000000000000000000000015077 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/doc/internals/authors.rst0000644000076600000240000000014500000000000017316 0ustar00tkomiyastaff:tocdepth: 2 .. _authors: ============== Sphinx authors ============== .. include:: ../../AUTHORS ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/doc/internals/code-of-conduct.rst0000644000076600000240000000010700000000000020600 0ustar00tkomiyastaff:tocdepth: 2 .. _code_of_conduct: .. include:: ../../CODE_OF_CONDUCT ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/internals/contributing.rst0000644000076600000240000002446300000000000020351 0ustar00tkomiyastaff====================== Contributing to Sphinx ====================== There are many ways you can contribute to Sphinx, be it filing bug reports or feature requests, writing new documentation or submitting patches for new or fixed behavior. This guide serves to illustrate how you can get started with this. Getting help ------------ The Sphinx community maintains a number of mailing lists and IRC channels. Stack Overflow with tag `python-sphinx`_ Questions and answers about use and development. sphinx-users Mailing list for user support. sphinx-dev Mailing list for development related discussions. #sphinx-doc on irc.freenode.net IRC channel for development questions and user support. .. _python-sphinx: https://stackoverflow.com/questions/tagged/python-sphinx Bug Reports and Feature Requests -------------------------------- If you have encountered a problem with Sphinx or have an idea for a new feature, please submit it to the `issue tracker`_ on GitHub or discuss it on the `sphinx-dev`_ mailing list. For bug reports, please include the output produced during the build process and also the log file Sphinx creates after it encounters an unhandled exception. The location of this file should be shown towards the end of the error message. Including or providing a link to the source files involved may help us fix the issue. If possible, try to create a minimal project that produces the error and post that instead. .. _`issue tracker`: https://github.com/sphinx-doc/sphinx/issues .. _`sphinx-dev`: mailto:sphinx-dev@googlegroups.com Writing code ------------ The Sphinx source code is managed using Git and is hosted on `GitHub`__. The recommended way for new contributors to submit code to Sphinx is to fork this repository and submit a pull request after committing changes to their fork. The pull request will then need to be approved by one of the core developers before it is merged into the main repository. .. __: https://github.com/sphinx-doc/sphinx Getting started ~~~~~~~~~~~~~~~ Before starting on a patch, we recommend checking for open issues or open a fresh issue to start a discussion around a feature idea or a bug. If you feel uncomfortable or uncertain about an issue or your changes, feel free to email the *sphinx-dev* mailing list. These are the basic steps needed to start developing on Sphinx. #. Create an account on GitHub. #. Fork the main Sphinx repository (`sphinx-doc/sphinx `_) using the GitHub interface. #. Clone the forked repository to your machine. :: git clone https://github.com/USERNAME/sphinx cd sphinx #. Checkout the appropriate branch. Sphinx adopts Semantic Versioning 2.0.0 (refs: https://semver.org/ ). For changes that preserves backwards-compatibility of API and features, they should be included in the next MINOR release, use the ``A.x`` branch. :: git checkout A.x For incompatible or other substantial changes that should wait until the next MAJOR release, use the ``master`` branch. For urgent release, a new PATCH branch must be branched from the newest release tag (see :doc:`release-process` for detail). #. Setup a virtual environment. This is not necessary for unit testing, thanks to ``tox``, but it is necessary if you wish to run ``sphinx-build`` locally or run unit tests without the help of ``tox``:: virtualenv ~/.venv . ~/.venv/bin/activate pip install -e . #. Create a new working branch. Choose any name you like. :: git checkout -b feature-xyz #. Hack, hack, hack. Write your code along with tests that shows that the bug was fixed or that the feature works as expected. #. Add a bullet point to :file:`CHANGES` if the fix or feature is not trivial (small doc updates, typo fixes), then commit:: git commit -m '#42: Add useful new feature that does this.' GitHub recognizes certain phrases that can be used to automatically update the issue tracker. For example:: git commit -m 'Closes #42: Fix invalid markup in docstring of Foo.bar.' would close issue #42. #. Push changes in the branch to your forked repository on GitHub:: git push origin feature-xyz #. Submit a pull request from your branch to the respective branch (``master`` or ``A.x``). #. Wait for a core developer to review your changes. Coding style ~~~~~~~~~~~~ Please follow these guidelines when writing code for Sphinx: * Try to use the same code style as used in the rest of the project. * For non-trivial changes, please update the :file:`CHANGES` file. If your changes alter existing behavior, please document this. * New features should be documented. Include examples and use cases where appropriate. If possible, include a sample that is displayed in the generated output. * When adding a new configuration variable, be sure to document it and update :file:`sphinx/cmd/quickstart.py` if it's important enough. * Add appropriate unit tests. Style and type checks can be run using ``tox``:: tox -e mypy tox -e flake8 Unit tests ~~~~~~~~~~ Sphinx is tested using `pytest`__ for Python code and `Karma`__ for JavaScript. .. __: https://docs.pytest.org/en/latest/ .. __: https://karma-runner.github.io To run Python unit tests, we recommend using ``tox``, which provides a number of targets and allows testing against multiple different Python environments: * To list all possible targets:: tox -av * To run unit tests for a specific Python version, such as Python 3.6:: tox -e py36 * To run unit tests for a specific Python version and turn on deprecation warnings on so they're shown in the test output:: PYTHONWARNINGS=all tox -e py36 * Arguments to ``pytest`` can be passed via ``tox``, e.g. in order to run a particular test:: tox -e py36 tests/test_module.py::test_new_feature You can also test by installing dependencies in your local environment:: pip install .[test] To run JavaScript tests, use ``npm``:: npm install npm run test New unit tests should be included in the ``tests`` directory where necessary: * For bug fixes, first add a test that fails without your changes and passes after they are applied. * Tests that need a ``sphinx-build`` run should be integrated in one of the existing test modules if possible. New tests that to ``@with_app`` and then ``build_all`` for a few assertions are not good since *the test suite should not take more than a minute to run*. .. versionadded:: 1.8 Sphinx also runs JavaScript tests. .. versionadded:: 1.6 ``sphinx.testing`` is added as a experimental. .. versionchanged:: 1.5.2 Sphinx was switched from nose to pytest. .. todo:: The below belongs in the developer guide Utility functions and pytest fixtures for testing are provided in ``sphinx.testing``. If you are a developer of Sphinx extensions, you can write unit tests with using pytest. At this time, ``sphinx.testing`` will help your test implementation. How to use pytest fixtures that are provided by ``sphinx.testing``? You can require ``'sphinx.testing.fixtures'`` in your test modules or ``conftest.py`` files like this:: pytest_plugins = 'sphinx.testing.fixtures' If you want to know more detailed usage, please refer to ``tests/conftest.py`` and other ``test_*.py`` files under ``tests`` directory. Writing documentation --------------------- .. todo:: Add a more extensive documentation contribution guide. You can build documentation using ``tox``:: tox -e docs Translations ~~~~~~~~~~~~ The parts of messages in Sphinx that go into builds are translated into several locales. The translations are kept as gettext ``.po`` files translated from the master template :file:`sphinx/locale/sphinx.pot`. Sphinx uses `Babel `_ to extract messages and maintain the catalog files. It is integrated in ``setup.py``: * Use ``python setup.py extract_messages`` to update the ``.pot`` template. * Use ``python setup.py update_catalog`` to update all existing language catalogs in ``sphinx/locale/*/LC_MESSAGES`` with the current messages in the template file. * Use ``python setup.py compile_catalog`` to compile the ``.po`` files to binary ``.mo`` files and ``.js`` files. When an updated ``.po`` file is submitted, run compile_catalog to commit both the source and the compiled catalogs. When a new locale is submitted, add a new directory with the ISO 639-1 language identifier and put ``sphinx.po`` in there. Don't forget to update the possible values for :confval:`language` in ``doc/usage/configuration.rst``. The Sphinx core messages can also be translated on `Transifex `_. There ``tx`` client tool, which is provided by the ``transifex_client`` Python package, can be used to pull translations in ``.po`` format from Transifex. To do this, go to ``sphinx/locale`` and then run ``tx pull -f -l LANG`` where ``LANG`` is an existing language identifier. It is good practice to run ``python setup.py update_catalog`` afterwards to make sure the ``.po`` file has the canonical Babel formatting. Debugging tips -------------- * Delete the build cache before building documents if you make changes in the code by running the command ``make clean`` or using the :option:`sphinx-build -E` option. * Use the :option:`sphinx-build -P` option to run ``pdb`` on exceptions. * Use ``node.pformat()`` and ``node.asdom().toxml()`` to generate a printable representation of the document structure. * Set the configuration variable :confval:`keep_warnings` to ``True`` so warnings will be displayed in the generated output. * Set the configuration variable :confval:`nitpicky` to ``True`` so that Sphinx will complain about references without a known target. * Set the debugging options in the `Docutils configuration file `_. * JavaScript stemming algorithms in ``sphinx/search/*.py`` (except ``en.py``) are generated by this `modified snowballcode generator `_. Generated `JSX `_ files are in `this repository `_. You can get the resulting JavaScript files using the following command:: npm install node_modules/.bin/grunt build # -> dest/*.global.js ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/doc/internals/index.rst0000644000076600000240000000054000000000000016737 0ustar00tkomiyastaff================ Sphinx internals ================ This guide contains information about the Sphinx open source project itself. This is where you can find information about how Sphinx is managed and learn how to contribute to the project. .. toctree:: :maxdepth: 2 contributing release-process organization code-of-conduct authors ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/doc/internals/organization.rst0000644000076600000240000000365100000000000020342 0ustar00tkomiyastaff================================== Organization of the Sphinx project ================================== The guide explains how the Sphinx project is organized. Core developers --------------- The core developers of Sphinx have write access to the main repository. They can commit changes, accept/reject pull requests, and manage items on the issue tracker. Guidelines ~~~~~~~~~~ The following are some general guidelines for core developers: * Questionable or extensive changes should be submitted as a pull request instead of being committed directly to the main repository. The pull request should be reviewed by another core developer before it is merged. * Trivial changes can be committed directly but be sure to keep the repository in a good working state and that all tests pass before pushing your changes. * When committing code written by someone else, please attribute the original author in the commit message and any relevant :file:`CHANGES` entry. Membership ~~~~~~~~~~ Core membership is predicated on continued active contribution to the project. In general, prospective cores should demonstrate: - a good understanding of one of more components of Sphinx - a history of helpful, constructive contributions - a willingness to invest time improving Sphinx Refer to :doc:`contributing` for more information on how you can get started. Other contributors ------------------ You do not need to be a core developer or have write access to be involved in the development of Sphinx. You can submit patches or create pull requests from forked repositories and have a core developer add the changes for you. Similarly, contributions are not limited to code patches. We also welcome help triaging bugs, input on design decisions, reviews of existing patches and documentation improvements. More information can be found in :doc:`contributing`. A list of people that have contributed to Sphinx can be found in :doc:`authors`. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/doc/internals/release-process.rst0000644000076600000240000000772200000000000020735 0ustar00tkomiyastaff======================== Sphinx's release process ======================== Branch Model ------------ Sphinx project uses following branches for developing that conforms to Semantic Versioning 2.0.0 (refs: https://semver.org/ ). ``master`` Development for MAJOR version. All changes including incompatible behaviors and public API updates are allowed. ``A.x`` (ex. ``2.x``) Where ``A.x`` is the ``MAJOR.MINOR`` release. Used to maintain current MINOR release. All changes are allowed if the change preserves backwards-compatibility of API and features. Only the most recent ``MAJOR.MINOR`` branch is currently retained. When a new MAJOR version is released, the old ``MAJOR.MINOR`` branch will be deleted and replaced by an equivalent tag. ``A.B.x`` (ex. ``2.4.x``) Where ``A.B.x`` is the ``MAJOR.MINOR.PATCH`` release. Only backwards-compatible bug fixes are allowed. In Sphinx project, PATCH version is used for urgent bug fix. ``MAJOR.MINOR.PATCH`` branch will be branched from the ``v`` prefixed release tag (ex. make 2.3.1 that branched from v2.3.0) when a urgent release is needed. When new PATCH version is released, the branch will be deleted and replaced by an equivalent tag (ex. v2.3.1). Deprecating a feature --------------------- There are a couple reasons that code in Sphinx might be deprecated: * If a feature has been improved or modified in a backwards-incompatible way, the old feature or behavior will be deprecated. * Sometimes Sphinx will include a backport of a Python library that's not included in a version of Python that Sphinx currently supports. When Sphinx no longer needs to support the older version of Python that doesn't include the library, the library will be deprecated in Sphinx. As the :ref:`deprecation-policy` describes, the first release of Sphinx that deprecates a feature (``A.B``) should raise a ``RemovedInSphinxXXWarning`` (where ``XX`` is the Sphinx version where the feature will be removed) when the deprecated feature is invoked. Assuming we have good test coverage, these warnings are converted to errors when running the test suite with warnings enabled:: pytest -Wall Thus, when adding a ``RemovedInSphinxXXWarning`` you need to eliminate or silence any warnings generated when running the tests. .. _deprecation-policy: Deprecation policy ------------------ MAJOR and MINOR releases may deprecate certain features from previous releases. If a feature is deprecated in a release A.x, it will continue to work in all A.x.x versions (for all versions of x). It will continue to work in all B.x.x versions but raise deprecation warnings. Deprecated features will be removed at the C.0.0. It means the deprecated feature will work during 2 MAJOR releases at least. So, for example, if we decided to start the deprecation of a function in Sphinx 2.x: * Sphinx 2.x will contain a backwards-compatible replica of the function which will raise a ``RemovedInSphinx40Warning``. This is a subclass of :exc:`python:PendingDeprecationWarning`, i.e. it will not get displayed by default. * Sphinx 3.x will still contain the backwards-compatible replica, but ``RemovedInSphinx40Warning`` will be a subclass of :exc:`python:DeprecationWarning` then, and gets displayed by default. * Sphinx 4.0 will remove the feature outright. Deprecation warnings ~~~~~~~~~~~~~~~~~~~~ Sphinx will enable its ``RemovedInNextVersionWarning`` warnings by default, if :envvar:`python:PYTHONWARNINGS` is not set. Therefore you can disable them using: * ``PYTHONWARNINGS= make html`` (Linux/Mac) * ``export PYTHONWARNINGS=`` and do ``make html`` (Linux/Mac) * ``set PYTHONWARNINGS=`` and do ``make html`` (Windows) But you can also explicitly enable the pending ones using e.g. ``PYTHONWARNINGS=default`` (see the :ref:`Python docs on configuring warnings `) for more details. Release procedures ------------------ The release procedures are listed in ``utils/release-checklist``. ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/latex.rst0000644000076600000240000011743700000000000014764 0ustar00tkomiyastaffLaTeX customization =================== .. module:: latex :synopsis: LaTeX specifics. .. raw:: latex \begingroup \sphinxsetup{% verbatimwithframe=false, VerbatimColor={named}{OldLace}, TitleColor={named}{DarkGoldenrod}, hintBorderColor={named}{LightCoral}, attentionborder=3pt, attentionBorderColor={named}{Crimson}, attentionBgColor={named}{FloralWhite}, noteborder=2pt, noteBorderColor={named}{Olive}, cautionborder=3pt, cautionBorderColor={named}{Cyan}, cautionBgColor={named}{LightCyan}} \relax Unlike :ref:`the HTML builders `, the ``latex`` builder does not benefit from prepared themes. The :ref:`latex-options`, and particularly the :ref:`latex_elements ` variable, provides much of the interface for customization. For example: .. code-block:: python # inside conf.py latex_engine = 'xelatex' latex_elements = { 'fontpkg': r''' \setmainfont{DejaVu Serif} \setsansfont{DejaVu Sans} \setmonofont{DejaVu Sans Mono} ''', 'preamble': r''' \usepackage[titles]{tocloft} \cftsetpnumwidth {1.25cm}\cftsetrmarg{1.5cm} \setlength{\cftchapnumwidth}{0.75cm} \setlength{\cftsecindent}{\cftchapnumwidth} \setlength{\cftsecnumwidth}{1.25cm} ''', 'fncychap': r'\usepackage[Bjornstrup]{fncychap}', 'printindex': r'\footnotesize\raggedright\printindex', } latex_show_urls = 'footnote' .. note:: Keep in mind that backslashes must be doubled in Python string literals to avoid interpretation as escape sequences. Alternatively, you may use raw strings as is done above. .. _latex_elements_confval: The ``latex_elements`` configuration setting -------------------------------------------- A dictionary that contains LaTeX snippets overriding those Sphinx usually puts into the generated ``.tex`` files. Its ``'sphinxsetup'`` key is described :ref:`separately `. Keys that you may want to override include: ``'papersize'`` Paper size option of the document class (``'a4paper'`` or ``'letterpaper'``) Default: ``'letterpaper'`` ``'pointsize'`` Point size option of the document class (``'10pt'``, ``'11pt'`` or ``'12pt'``) Default: ``'10pt'`` ``'pxunit'`` The value of the ``px`` when used in image attributes ``width`` and ``height``. The default value is ``'0.75bp'`` which achieves ``96px=1in`` (in TeX ``1in = 72bp = 72.27pt``.) To obtain for example ``100px=1in`` use ``'0.01in'`` or ``'0.7227pt'`` (the latter leads to TeX computing a more precise value, due to the smaller unit used in the specification); for ``72px=1in``, simply use ``'1bp'``; for ``90px=1in``, use ``'0.8bp'`` or ``'0.803pt'``. Default: ``'0.75bp'`` .. versionadded:: 1.5 ``'passoptionstopackages'`` A string which will be positioned early in the preamble, designed to contain ``\\PassOptionsToPackage{options}{foo}`` commands. .. hint:: It may be also used for loading LaTeX packages very early in the preamble. For example package ``fancybox`` is incompatible with being loaded via the ``'preamble'`` key, it must be loaded earlier. Default: ``''`` .. versionadded:: 1.4 ``'babel'`` "babel" package inclusion, default ``'\\usepackage{babel}'`` (the suitable document language string is passed as class option, and ``english`` is used if no language.) For Japanese documents, the default is the empty string. With XeLaTeX and LuaLaTeX, Sphinx configures the LaTeX document to use `polyglossia`_, but one should be aware that current `babel`_ has improved its support for Unicode engines in recent years and for some languages it may make sense to prefer ``babel`` over ``polyglossia``. .. _`polyglossia`: https://ctan.org/pkg/polyglossia .. _`babel`: https://ctan.org/pkg/babel .. hint:: After modifiying a core LaTeX key like this one, clean up the LaTeX build repertory before next PDF build, else left-over auxiliary files are likely to break the build. Default: ``'\\usepackage{babel}'`` (``''`` for Japanese documents) .. versionchanged:: 1.5 For :confval:`latex_engine` set to ``'xelatex'``, the default is ``'\\usepackage{polyglossia}\n\\setmainlanguage{}'``. .. versionchanged:: 1.6 ``'lualatex'`` uses same default setting as ``'xelatex'`` .. versionchanged:: 1.7.6 For French, ``xelatex`` and ``lualatex`` default to using ``babel``, not ``polyglossia``. ``'fontpkg'`` Font package inclusion. The default is:: r"""\usepackage{tgtermes} \usepackage{tgheros} \renewcommand\ttdefault{txtt} """ For ``'xelatex'`` and ``'lualatex'`` however the default is to use the GNU FreeFont. .. versionchanged:: 1.2 Defaults to ``''`` when the :confval:`language` uses the Cyrillic script. .. versionchanged:: 2.0 Incorporates some font substitution commands to help support occasional Greek or Cyrillic in a document using ``'pdflatex'`` engine. .. versionchanged:: 4.0.0 - The font substitution commands added at ``2.0`` have been moved to the ``'fontsubstitution'`` key, as their presence here made it complicated for user to customize the value of ``'fontpkg'``. - The default font setting has changed: it still uses Times and Helvetica clones for serif and sans serif, but via better, more complete TeX fonts and associated LaTeX packages. The monospace font has been changed to better match the Times clone. ``'fncychap'`` Inclusion of the "fncychap" package (which makes fancy chapter titles), default ``'\\usepackage[Bjarne]{fncychap}'`` for English documentation (this option is slightly customized by Sphinx), ``'\\usepackage[Sonny]{fncychap}'`` for internationalized docs (because the "Bjarne" style uses numbers spelled out in English). Other "fncychap" styles you can try are "Lenny", "Glenn", "Conny", "Rejne" and "Bjornstrup". You can also set this to ``''`` to disable fncychap. Default: ``'\\usepackage[Bjarne]{fncychap}'`` for English documents, ``'\\usepackage[Sonny]{fncychap}'`` for internationalized documents, and ``''`` for Japanese documents. ``'preamble'`` Additional preamble content. One may move all needed macros into some file :file:`mystyle.tex.txt` of the project source repertory, and get LaTeX to import it at run time:: 'preamble': r'\input{mystyle.tex.txt}', # or, if the \ProvidesPackage LaTeX macro is used in a file mystyle.sty 'preamble': r'\usepackage{mystyle}', It is then needed to set appropriately :confval:`latex_additional_files`, for example: .. code-block:: python latex_additional_files = ["mystyle.sty"] Default: ``''`` ``'figure_align'`` Latex figure float alignment. Whenever an image doesn't fit into the current page, it will be 'floated' into the next page but may be preceded by any other text. If you don't like this behavior, use 'H' which will disable floating and position figures strictly in the order they appear in the source. Default: ``'htbp'`` (here, top, bottom, page) .. versionadded:: 1.3 ``'atendofbody'`` Additional document content (right before the indices). Default: ``''`` .. versionadded:: 1.5 ``'extrapackages'`` Additional LaTeX packages. For example: .. code-block:: python latex_elements = { 'packages': r'\usepackage{isodate}' } The specified LaTeX packages will be loaded before hyperref package and packages loaded from Sphinx extensions. .. hint:: If you'd like to load additional LaTeX packages after hyperref, use ``'preamble'`` key instead. Default: ``''`` .. versionadded:: 2.3 ``'footer'`` Additional footer content (before the indices). Default: ``''`` .. deprecated:: 1.5 Use ``'atendofbody'`` key instead. Keys that don't need to be overridden unless in special cases are: ``'extraclassoptions'`` The default is the empty string. Example: ``'extraclassoptions': 'openany'`` will allow chapters (for documents of the ``'manual'`` type) to start on any page. Default: ``''`` .. versionadded:: 1.2 .. versionchanged:: 1.6 Added this documentation. ``'maxlistdepth'`` LaTeX allows by default at most 6 levels for nesting list and quote-like environments, with at most 4 enumerated lists, and 4 bullet lists. Setting this key for example to ``'10'`` (as a string) will allow up to 10 nested levels (of all sorts). Leaving it to the empty string means to obey the LaTeX default. .. warning:: - Using this key may prove incompatible with some LaTeX packages or special document classes which do their own list customization. - The key setting is silently *ignored* if ``\usepackage{enumitem}`` is executed inside the document preamble. Use then rather the dedicated commands of this LaTeX package. Default: ``6`` .. versionadded:: 1.5 ``'inputenc'`` "inputenc" package inclusion. Default: ``'\\usepackage[utf8]{inputenc}'`` when using pdflatex, else ``''``. .. note:: If using ``utf8x`` in place of ``utf8`` it is mandatory to extend the LaTeX preamble with suitable ``\PreloadUnicodePage{}`` commands, as per the ``utf8x`` documentation (``texdoc ucs`` on a TeXLive based TeX installation). Else, unexpected and possibly hard-to-spot problems (i.e. not causing a build crash) may arise in the PDF, in particular regarding hyperlinks. Even if these precautions are taken, PDF build via ``pdflatex`` engine may crash due to upstream LaTeX not being fully compatible with ``utf8x``. For example, in certain circumstances related to code-blocks, or attempting to include images whose filenames contain Unicode characters. Indeed, starting in 2015, upstream LaTeX with ``pdflatex`` engine has somewhat enhanced native support for Unicode and is becoming more and more incompatible with ``utf8x``. In particular, since the October 2019 LaTeX release, filenames can use Unicode characters, and even spaces. At Sphinx level this means e.g. that the :dudir:`image` and :dudir:`figure` directives are now compatible with such filenames for PDF via LaTeX output. But this is broken if ``utf8x`` is in use. .. versionchanged:: 1.4.3 Previously ``'\\usepackage[utf8]{inputenc}'`` was used for all compilers. ``'cmappkg'`` "cmap" package inclusion. Default: ``'\\usepackage{cmap}'`` .. versionadded:: 1.2 ``'fontenc'`` Customize this from its default ``'\\usepackage[T1]{fontenc}'`` to: - ``'\\usepackage[X2,T1]{fontenc}'`` if you need occasional Cyrillic letters (физика частиц), - ``'\\usepackage[LGR,T1]{fontenc}'`` if you need occasional Greek letters (Σωματιδιακή φυσική). Use ``[LGR,X2,T1]`` rather if both are needed. .. attention:: - Do not use this key for a :confval:`latex_engine` other than ``'pdflatex'``. - If Greek is main language, do not use this key. Since Sphinx 2.2.1, ``xelatex`` will be used automatically as :confval:`latex_engine`. - The TeX installation may need some extra packages. For example, on Ubuntu xenial, packages ``texlive-lang-greek`` and ``cm-super`` are needed for ``LGR`` to work. And ``texlive-lang-cyrillic`` and ``cm-super`` are needed for support of Cyrillic. .. versionchanged:: 1.5 Defaults to ``'\\usepackage{fontspec}'`` when :confval:`latex_engine` is ``'xelatex'``. .. versionchanged:: 1.6 ``'lualatex'`` uses ``fontspec`` per default like ``'xelatex'``. .. versionchanged:: 2.0 ``'lualatex'`` executes ``\defaultfontfeatures[\rmfamily,\sffamily]{}`` to disable TeX ligatures transforming `<<` and `>>` as escaping working with ``pdflatex/xelatex`` failed with ``lualatex``. .. versionchanged:: 2.0 Detection of ``LGR``, ``T2A``, ``X2`` to trigger support of occasional Greek or Cyrillic letters (``'pdflatex'``). .. versionchanged:: 2.3.0 ``'xelatex'`` executes ``\defaultfontfeatures[\rmfamily,\sffamily]{}`` in order to avoid contractions of ``--`` into en-dash or transforms of straight quotes into curly ones in PDF (in non-literal text paragraphs) despite :confval:`smartquotes` being set to ``False``. ``'fontsubstitution'`` Ignored if ``'fontenc'`` was not configured to use ``LGR`` or ``X2`` (or ``T2A``). In case ``'fontpkg'`` key is configured for usage with some TeX fonts known to be available in the ``LGR`` or ``X2`` encodings, set this one to be the empty string. Else leave to its default. Ignored with :confval:`latex_engine` other than ``'pdflatex'``. .. versionadded:: 4.0.0 ``'textgreek'`` For the support of occasional Greek letters. It is ignored with ``'platex'``, ``'xelatex'`` or ``'lualatex'`` as :confval:`latex_engine` and defaults to either the empty string or to ``'\\usepackage{textalpha}'`` for ``'pdflatex'`` depending on whether the ``'fontenc'`` key was used with ``LGR`` or not. Only expert LaTeX users may want to customize this key. It can also be used as ``r'\usepackage{textalpha,alphabeta}'`` to let ``'pdflatex'`` support Greek Unicode input in :rst:dir:`math` context. For example ``:math:`α``` (U+03B1) will render as :math:`\alpha`. Default: ``'\\usepackage{textalpha}'`` or ``''`` if ``fontenc`` does not include the ``LGR`` option. .. versionadded:: 2.0 ``'geometry'`` "geometry" package inclusion, the default definition is: ``'\\usepackage{geometry}'`` with an additional ``[dvipdfm]`` for Japanese documents. The Sphinx LaTeX style file executes: ``\PassOptionsToPackage{hmargin=1in,vmargin=1in,marginpar=0.5in}{geometry}`` which can be customized via corresponding :ref:`'sphinxsetup' options `. Default: ``'\\usepackage{geometry}'`` (or ``'\\usepackage[dvipdfm]{geometry}'`` for Japanese documents) .. versionadded:: 1.5 .. versionchanged:: 1.5.2 ``dvipdfm`` option if :confval:`latex_engine` is ``'platex'``. .. versionadded:: 1.5.3 The :ref:`'sphinxsetup' keys for the margins `. .. versionchanged:: 1.5.3 The location in the LaTeX file has been moved to after ``\usepackage{sphinx}`` and ``\sphinxsetup{..}``, hence also after insertion of ``'fontpkg'`` key. This is in order to handle the paper layout options in a special way for Japanese documents: the text width will be set to an integer multiple of the *zenkaku* width, and the text height to an integer multiple of the baseline. See the :ref:`hmargin ` documentation for more. ``'hyperref'`` "hyperref" package inclusion; also loads package "hypcap" and issues ``\urlstyle{same}``. This is done after :file:`sphinx.sty` file is loaded and before executing the contents of ``'preamble'`` key. .. attention:: Loading of packages "hyperref" and "hypcap" is mandatory. .. versionadded:: 1.5 Previously this was done from inside :file:`sphinx.sty`. ``'maketitle'`` "maketitle" call. Override if you want to generate a differently styled title page. .. hint:: If the key value is set to ``r'\newcommand\sphinxbackoftitlepage{}\sphinxmaketitle'``, then ```` will be typeset on back of title page (``'manual'`` docclass only). Default: ``'\\sphinxmaketitle'`` .. versionchanged:: 1.8.3 Original ``\maketitle`` from document class is not overwritten, hence is re-usable as part of some custom setting for this key. .. versionadded:: 1.8.3 ``\sphinxbackoftitlepage`` optional macro. It can also be defined inside ``'preamble'`` key rather than this one. ``'releasename'`` Value that prefixes ``'release'`` element on title page. As for *title* and *author* used in the tuples of :confval:`latex_documents`, it is inserted as LaTeX markup. Default: ``'Release'`` ``'tableofcontents'`` "tableofcontents" call. The default of ``'\\sphinxtableofcontents'`` is a wrapper of unmodified ``\tableofcontents``, which may itself be customized by user loaded packages. Override if you want to generate a different table of contents or put content between the title page and the TOC. Default: ``'\\sphinxtableofcontents'`` .. versionchanged:: 1.5 Previously the meaning of ``\tableofcontents`` itself was modified by Sphinx. This created an incompatibility with dedicated packages modifying it also such as "tocloft" or "etoc". ``'transition'`` Commands used to display transitions. Override if you want to display transitions differently. Default: ``'\n\n\\bigskip\\hrule\\bigskip\n\n'`` .. versionadded:: 1.2 .. versionchanged:: 1.6 Remove unneeded ``{}`` after ``\\hrule``. ``'makeindex'`` "makeindex" call, the last thing before ``\begin{document}``. With ``'\\usepackage[columns=1]{idxlayout}\\makeindex'`` the index will use only one column. You may have to install ``idxlayout`` LaTeX package. Default: ``'\\makeindex'`` ``'printindex'`` "printindex" call, the last thing in the file. Override if you want to generate the index differently, append some content after the index, or change the font. As LaTeX uses two-column mode for the index it is often advisable to set this key to ``'\\footnotesize\\raggedright\\printindex'``. Or, to obtain a one-column index, use ``'\\def\\twocolumn[#1]{#1}\\printindex'`` (this trick may fail if using a custom document class; then try the ``idxlayout`` approach described in the documentation of the ``'makeindex'`` key). Default: ``'\\printindex'`` ``'fvset'`` Customization of ``fancyvrb`` LaTeX package. The default value is ``'\\fvset{fontsize=auto}'`` which means that the font size will adjust correctly if a code-block ends up in a footnote. You may need to modify this if you use custom fonts: ``'\\fvset{fontsize=\\small}'`` if the monospace font is Courier-like. Default: ``'\\fvset{fontsize=auto}'`` .. versionadded:: 1.8 .. versionchanged:: 2.0 For ``'xelatex'`` and ``'lualatex'`` defaults to ``'\\fvset{fontsize=\\small}'`` as this is adapted to the relative widths of the FreeFont family. .. versionchanged:: 4.0.0 Changed default for ``'pdflatex'``. Previously it was using ``'\\fvset{fontsize=\\small}'``. .. versionchanged:: 4.1.0 Changed default for Chinese documents to ``'\\fvset{fontsize=\\small,formatcom=\\xeCJKVerbAddon}'`` Keys that are set by other options and therefore should not be overridden are: ``'docclass'`` ``'classoptions'`` ``'title'`` ``'release'`` ``'author'`` .. _latexsphinxsetup: The ``sphinxsetup`` configuration setting ----------------------------------------- .. versionadded:: 1.5 The ``'sphinxsetup'`` key of :ref:`latex_elements ` provides a LaTeX-type customization interface:: latex_elements = { 'sphinxsetup': 'key1=value1, key2=value2, ...', } It defaults to empty. If non-empty, it will be passed as argument to the ``\sphinxsetup`` macro inside the document preamble, like this:: \usepackage{sphinx} \sphinxsetup{key1=value1, key2=value2,...} The colors used in the above are provided by the ``svgnames`` option of the "xcolor" package:: latex_elements = { 'passoptionstopackages': r'\PassOptionsToPackage{svgnames}{xcolor}', } It is possible to insert further uses of the ``\sphinxsetup`` LaTeX macro directly into the body of the document, via the help of the :rst:dir:`raw` directive. This chapter is styled in the PDF output using the following at the start of the chapter:: .. raw:: latex \begingroup \sphinxsetup{% verbatimwithframe=false, VerbatimColor={named}{OldLace}, TitleColor={named}{DarkGoldenrod}, hintBorderColor={named}{LightCoral}, attentionborder=3pt, attentionBorderColor={named}{Crimson}, attentionBgColor={named}{FloralWhite}, noteborder=2pt, noteBorderColor={named}{Olive}, cautionborder=3pt, cautionBorderColor={named}{Cyan}, cautionBgColor={named}{LightCyan}} The below is included at the end of the chapter:: .. raw:: latex \endgroup LaTeX syntax for boolean keys requires *lowercase* ``true`` or ``false`` e.g ``'sphinxsetup': "verbatimwrapslines=false"``. If setting the boolean key to ``true``, ``=true`` is optional. Spaces around the commas and equal signs are ignored, spaces inside LaTeX macros may be significant. Do not use quotes to enclose values, whether numerical or strings. ``bookmarksdepth`` Controls the depth of the collapsible bookmarks panel in the PDF. May be either a number (e.g. ``3``) or a LaTeX sectioning name (e.g. ``subsubsection``, i.e. without backslash). For details, refer to the ``hyperref`` LaTeX docs. Default: ``5`` .. versionadded:: 4.0.0 .. _latexsphinxsetuphmargin: ``hmargin, vmargin`` The dimensions of the horizontal (resp. vertical) margins, passed as ``hmargin`` (resp. ``vmargin``) option to the ``geometry`` package. Example:: 'sphinxsetup': 'hmargin={2in,1.5in}, vmargin={1.5in,2in}, marginpar=1in', Japanese documents currently accept only the one-dimension format for these parameters. The ``geometry`` package is then passed suitable options to get the text width set to an exact multiple of the *zenkaku* width, and the text height set to an integer multiple of the baselineskip, with the closest fit for the margins. Default: ``1in`` (equivalent to ``{1in,1in}``) .. hint:: For Japanese ``'manual'`` docclass with pointsize ``11pt`` or ``12pt``, use the ``nomag`` extra document class option (cf. ``'extraclassoptions'`` key of :confval:`latex_elements`) or so-called TeX "true" units:: 'sphinxsetup': 'hmargin=1.5truein, vmargin=1.5truein, marginpar=5zw', .. versionadded:: 1.5.3 ``marginpar`` The ``\marginparwidth`` LaTeX dimension. For Japanese documents, the value is modified to be the closest integer multiple of the *zenkaku* width. Default: ``0.5in`` .. versionadded:: 1.5.3 ``verbatimwithframe`` Boolean to specify if :rst:dir:`code-block`\ s and literal includes are framed. Setting it to ``false`` does not deactivate use of package "framed", because it is still in use for the optional background colour. Default: ``true``. ``verbatimwrapslines`` Boolean to specify if long lines in :rst:dir:`code-block`\ 's contents are wrapped. If ``true``, line breaks may happen at spaces (the last space before the line break will be rendered using a special symbol), and at ascii punctuation characters (i.e. not at letters or digits). Whenever a long string has no break points, it is moved to next line. If its length is longer than the line width it will overflow. Default: ``true`` .. _latexsphinxsetupforcewraps: ``verbatimforcewraps`` Boolean to specify if long lines in :rst:dir:`code-block`\ 's contents should be forcefully wrapped to never overflow due to long strings. .. note:: It is assumed that the Pygments_ LaTeXFormatter has not been used with its ``texcomments`` or similar options which allow additional (arbitrary) LaTeX mark-up. Also, in case of :confval:`latex_engine` set to ``'pdflatex'``, only the default LaTeX handling of Unicode code points, i.e. ``utf8`` not ``utf8x`` is allowed. .. _Pygments: https://pygments.org/ Default: ``false`` .. versionadded:: 3.5.0 ``verbatimmaxoverfull`` A number. If an unbreakable long string has length larger than the total linewidth plus this number of characters, and if ``verbatimforcewraps`` mode is on, the input line will be reset using the forceful algorithm which applies breakpoints at each character. Default: ``3`` .. versionadded:: 3.5.0 ``verbatimmaxunderfull`` A number. If ``verbatimforcewraps`` mode applies, and if after applying the line wrapping at spaces and punctuation, the first part of the split line is lacking at least that number of characters to fill the available width, then the input line will be reset using the forceful algorithm. As the default is set to a high value, the forceful algorithm is triggered only in overfull case, i.e. in presence of a string longer than full linewidth. Set this to ``0`` to force all input lines to be hard wrapped at the current available linewidth:: latex_elements = { 'sphinxsetup': "verbatimforcewraps, verbatimmaxunderfull=0", } This can be done locally for a given code-block via the use of raw latex directives to insert suitable ``\sphinxsetup`` (before and after) into the latex file. Default: ``100`` .. versionadded:: 3.5.0 ``verbatimhintsturnover`` Boolean to specify if code-blocks display "continued on next page" and "continued from previous page" hints in case of pagebreaks. Default: ``true`` .. versionadded:: 1.6.3 .. versionchanged:: 1.7 the default changed from ``false`` to ``true``. ``verbatimcontinuedalign``, ``verbatimcontinuesalign`` Horizontal position relative to the framed contents: either ``l`` (left aligned), ``r`` (right aligned) or ``c`` (centered). Default: ``r`` .. versionadded:: 1.7 ``parsedliteralwraps`` Boolean to specify if long lines in :dudir:`parsed-literal`\ 's contents should wrap. Default: ``true`` .. versionadded:: 1.5.2 set this option value to ``false`` to recover former behaviour. ``inlineliteralwraps`` Boolean to specify if line breaks are allowed inside inline literals: but extra potential break-points (additionally to those allowed by LaTeX at spaces or for hyphenation) are currently inserted only after the characters ``. , ; ? ! /`` and ``\``. Due to TeX internals, white space in the line will be stretched (or shrunk) in order to accommodate the linebreak. Default: ``true`` .. versionadded:: 1.5 set this option value to ``false`` to recover former behaviour. .. versionchanged:: 2.3.0 added potential breakpoint at ``\`` characters. ``verbatimvisiblespace`` When a long code line is split, the last space character from the source code line right before the linebreak location is typeset using this. Default: ``\textcolor{red}{\textvisiblespace}`` ``verbatimcontinued`` A LaTeX macro inserted at start of continuation code lines. Its (complicated...) default typesets a small red hook pointing to the right:: \makebox[2\fontcharwd\font`\x][r]{\textcolor{red}{\tiny$\hookrightarrow$}} .. versionchanged:: 1.5 The breaking of long code lines was added at 1.4.2. The default definition of the continuation symbol was changed at 1.5 to accommodate various font sizes (e.g. code-blocks can be in footnotes). ``TitleColor`` The colour for titles (as configured via use of package "titlesec".) Default: ``{rgb}{0.126,0.263,0.361}`` .. warning:: Colours set via ``'sphinxsetup'`` must obey the syntax of the argument of the ``color/xcolor`` packages ``\definecolor`` command. ``InnerLinkColor`` A colour passed to ``hyperref`` as value of ``linkcolor`` and ``citecolor``. Default: ``{rgb}{0.208,0.374,0.486}``. ``OuterLinkColor`` A colour passed to ``hyperref`` as value of ``filecolor``, ``menucolor``, and ``urlcolor``. Default: ``{rgb}{0.216,0.439,0.388}`` ``VerbatimColor`` The background colour for :rst:dir:`code-block`\ s. Default: ``{rgb}{1,1,1}`` (white) ``VerbatimBorderColor`` The frame color. Default: ``{rgb}{0,0,0}`` (black) ``VerbatimHighlightColor`` The color for highlighted lines. Default: ``{rgb}{0.878,1,1}`` .. versionadded:: 1.6.6 .. note:: Starting with this colour, and for all others following, the names declared to "color" or "xcolor" are prefixed with "sphinx". ``verbatimsep`` The separation between code lines and the frame. Default: ``\fboxsep`` ``verbatimborder`` The width of the frame around :rst:dir:`code-block`\ s. Default: ``\fboxrule`` ``shadowsep`` The separation between contents and frame for :dudir:`contents` and :dudir:`topic` boxes. Default: ``5pt`` ``shadowsize`` The width of the lateral "shadow" to the right. Default: ``4pt`` ``shadowrule`` The width of the frame around :dudir:`topic` boxes. Default: ``\fboxrule`` |notebdcolors| The colour for the two horizontal rules used by Sphinx in LaTeX for styling a :dudir:`note` type admonition. Default: ``{rgb}{0,0,0}`` (black) ``noteborder``, ``hintborder``, ``importantborder``, ``tipborder`` The width of the two horizontal rules. Default: ``0.5pt`` .. only:: not latex |warningbdcolors| The colour for the admonition frame. Default: ``{rgb}{0,0,0}`` (black) .. only:: latex |wgbdcolorslatex| The colour for the admonition frame. Default: ``{rgb}{0,0,0}`` (black) |warningbgcolors| The background colours for the respective admonitions. Default: ``{rgb}{1,1,1}`` (white) |warningborders| The width of the frame. Default: ``1pt`` ``AtStartFootnote`` LaTeX macros inserted at the start of the footnote text at bottom of page, after the footnote number. Default: ``\mbox{ }`` ``BeforeFootnote`` LaTeX macros inserted before the footnote mark. The default removes possible space before it (else, TeX could insert a line break there). Default: ``\leavevmode\unskip`` .. versionadded:: 1.5 ``HeaderFamily`` default ``\sffamily\bfseries``. Sets the font used by headings. .. |notebdcolors| replace:: ``noteBorderColor``, ``hintBorderColor``, ``importantBorderColor``, ``tipBorderColor`` .. |warningbdcolors| replace:: ``warningBorderColor``, ``cautionBorderColor``, ``attentionBorderColor``, ``dangerBorderColor``, ``errorBorderColor`` .. |wgbdcolorslatex| replace:: ``warningBorderColor``, and ``(caution|attention|danger|error)BorderColor`` .. else latex goes into right margin, as it does not hyphenate the names .. |warningbgcolors| replace:: ``warningBgColor``, ``cautionBgColor``, ``attentionBgColor``, ``dangerBgColor``, ``errorBgColor`` .. |warningborders| replace:: ``warningborder``, ``cautionborder``, ``attentionborder``, ``dangerborder``, ``errorborder`` LaTeX macros and environments ----------------------------- The "LaTeX package" file :file:`sphinx.sty` loads various components providing support macros (aka commands), and environments, which are used in the mark-up produced on output from the ``latex`` builder, before conversion to ``pdf`` via the LaTeX toolchain. Also the "LaTeX class" files :file:`sphinxhowto.cls` and :file:`sphinxmanual.cls` define or customize some environments. All of these files can be found in the latex build repertory. Some of these provide facilities not available from pre-existing LaTeX packages and work around LaTeX limitations with lists, table cells, verbatim rendering, footnotes, etc... Others simply define macros with public names to make overwriting their defaults easy via user-added contents to the preamble. We will survey most of those public names here, but defaults have to be looked at in their respective definition files. .. hint:: Sphinx LaTeX support code is split across multiple smaller-sized files. Rather than adding code to the preamble via `latex_elements `_\ [``'preamble'``] it is also possible to replace entirely one of the component files of Sphinx LaTeX code with a custom version, simply by including a modified copy in the project source and adding the filename to the :confval:`latex_additional_files` list. Check the LaTeX build repertory for the filenames and contents. .. versionchanged:: 4.0.0 split of :file:`sphinx.sty` into multiple smaller units, to facilitate customization of many aspects simultaneously. .. _latex-macros: Macros ~~~~~~ - Text styling commands: - ``\sphinxstrong``, - ``\sphinxbfcode``, - ``\sphinxemail``, - ``\sphinxtablecontinued``, - ``\sphinxtitleref``, - ``\sphinxmenuselection``, - ``\sphinxaccelerator``, - ``\sphinxcrossref``, - ``\sphinxtermref``, - ``\sphinxoptional``. .. versionadded:: 1.4.5 Use of ``\sphinx`` prefixed macro names to limit possibilities of conflict with LaTeX packages. - More text styling: - ``\sphinxstyleindexentry``, - ``\sphinxstyleindexextra``, - ``\sphinxstyleindexpageref``, - ``\sphinxstyletopictitle``, - ``\sphinxstylesidebartitle``, - ``\sphinxstyleothertitle``, - ``\sphinxstylesidebarsubtitle``, - ``\sphinxstyletheadfamily``, - ``\sphinxstyleemphasis``, - ``\sphinxstyleliteralemphasis``, - ``\sphinxstylestrong``, - ``\sphinxstyleliteralstrong``, - ``\sphinxstyleabbreviation``, - ``\sphinxstyleliteralintitle``, - ``\sphinxstylecodecontinued``, - ``\sphinxstylecodecontinues``. .. versionadded:: 1.5 These macros were formerly hard-coded as non customizable ``\texttt``, ``\emph``, etc... .. versionadded:: 1.6 ``\sphinxstyletheadfamily`` which defaults to ``\sffamily`` and allows multiple paragraphs in header cells of tables. .. versionadded:: 1.6.3 ``\sphinxstylecodecontinued`` and ``\sphinxstylecodecontinues``. .. versionadded:: 3.0 ``\sphinxkeyboard`` - ``\sphinxtableofcontents``: A wrapper (defined differently in :file:`sphinxhowto.cls` and in :file:`sphinxmanual.cls`) of standard ``\tableofcontents``. The macro ``\sphinxtableofcontentshook`` is executed during its expansion right before ``\tableofcontents`` itself. .. versionchanged:: 1.5 Formerly, the meaning of ``\tableofcontents`` was modified by Sphinx. .. versionchanged:: 2.0 Hard-coded redefinitions of ``\l@section`` and ``\l@subsection`` formerly done during loading of ``'manual'`` docclass are now executed later via ``\sphinxtableofcontentshook``. This macro is also executed by the ``'howto'`` docclass, but defaults to empty with it. - ``\sphinxmaketitle``: Used as the default setting of the ``'maketitle'`` :confval:`latex_elements` key. Defined in the class files :file:`sphinxmanual.cls` and :file:`sphinxhowto.cls`. .. versionchanged:: 1.8.3 Formerly, ``\maketitle`` from LaTeX document class was modified by Sphinx. - ``\sphinxbackoftitlepage``: For ``'manual'`` docclass, and if it is defined, it gets executed at end of ``\sphinxmaketitle``, before the final ``\clearpage``. Use either the ``'maketitle'`` key or the ``'preamble'`` key of :confval:`latex_elements` to add a custom definition of ``\sphinxbackoftitlepage``. .. versionadded:: 1.8.3 - ``\sphinxcite``: A wrapper of standard ``\cite`` for citation references. Environments ~~~~~~~~~~~~ - A :dudir:`figure` may have an optional legend with arbitrary body elements: they are rendered in a ``sphinxlegend`` environment. The default definition issues ``\small``, and ends with ``\par``. .. versionadded:: 1.5.6 Formerly, the ``\small`` was hardcoded in LaTeX writer and the ending ``\par`` was lacking. - Environments associated with admonitions: - ``sphinxnote``, - ``sphinxhint``, - ``sphinximportant``, - ``sphinxtip``, - ``sphinxwarning``, - ``sphinxcaution``, - ``sphinxattention``, - ``sphinxdanger``, - ``sphinxerror``. They may be ``\renewenvironment`` 'd individually, and must then be defined with one argument (it is the heading of the notice, for example ``Warning:`` for :dudir:`warning` directive, if English is the document language). Their default definitions use either the *sphinxheavybox* (for the last 5 ones) or the *sphinxlightbox* environments, configured to use the parameters (colours, border thickness) specific to each type, which can be set via ``'sphinxsetup'`` string. .. versionchanged:: 1.5 Use of public environment names, separate customizability of the parameters, such as ``noteBorderColor``, ``noteborder``, ``warningBgColor``, ``warningBorderColor``, ``warningborder``, ... - The :dudir:`contents` directive (with ``:local:`` option) and the :dudir:`topic` directive are implemented by environment ``sphinxShadowBox``. .. versionadded:: 1.4.2 Former code refactored into an environment allowing page breaks. .. versionchanged:: 1.5 Options ``shadowsep``, ``shadowsize``, ``shadowrule``. - The literal blocks (via ``::`` or :rst:dir:`code-block`), are implemented using ``sphinxVerbatim`` environment which is a wrapper of ``Verbatim`` environment from package ``fancyvrb.sty``. It adds the handling of the top caption and the wrapping of long lines, and a frame which allows pagebreaks. Inside tables the used environment is ``sphinxVerbatimintable`` (it does not draw a frame, but allows a caption). .. versionchanged:: 1.5 ``Verbatim`` keeps exact same meaning as in ``fancyvrb.sty`` (also under the name ``OriginalVerbatim``); ``sphinxVerbatimintable`` is used inside tables. .. versionadded:: 1.5 Options ``verbatimwithframe``, ``verbatimwrapslines``, ``verbatimsep``, ``verbatimborder``. .. versionadded:: 1.6.6 Support for ``:emphasize-lines:`` option .. versionadded:: 1.6.6 Easier customizability of the formatting via exposed to user LaTeX macros such as ``\sphinxVerbatimHighlightLine``. - The bibliography uses ``sphinxthebibliography`` and the Python Module index as well as the general index both use ``sphinxtheindex``; these environments are wrappers of the ``thebibliography`` and respectively ``theindex`` environments as provided by the document class (or packages). .. versionchanged:: 1.5 Formerly, the original environments were modified by Sphinx. Miscellany ~~~~~~~~~~ - Every text paragraph in document body starts with ``\sphinxAtStartPar``. Currently, this is used to insert a zero width horizontal skip which is a trick to allow TeX hyphenation of the first word of a paragraph in a narrow context (like a table cell). For ``'lualatex'`` which does not need the trick, the ``\sphinxAtStartPar`` does nothing. .. versionadded:: 3.5.0 - The section, subsection, ... headings are set using *titlesec*'s ``\titleformat`` command. - For the ``'manual'`` docclass, the chapter headings can be customized using *fncychap*'s commands ``\ChNameVar``, ``\ChNumVar``, ``\ChTitleVar``. File :file:`sphinx.sty` has custom re-definitions in case of *fncychap* option ``Bjarne``. .. versionchanged:: 1.5 Formerly, use of *fncychap* with other styles than ``Bjarne`` was dysfunctional. - Docutils :dudir:`container` directives are supported in LaTeX output: to let a container class with name ``foo`` influence the final PDF via LaTeX, it is only needed to define in the preamble an environment ``sphinxclassfoo``. A simple example would be: .. code-block:: latex \newenvironment{sphinxclassred}{\color{red}}{} Currently the class names must contain only ascii characters and avoid characters special to LaTeX such as ``\``. .. versionadded:: 4.1.0 .. hint:: As an experimental feature, Sphinx can use user-defined template file for LaTeX source if you have a file named ``_templates/latex.tex_t`` in your project. Additional files ``longtable.tex_t``, ``tabulary.tex_t`` and ``tabular.tex_t`` can be added to ``_templates/`` to configure some aspects of table rendering (such as the caption position). .. versionadded:: 1.6 currently all template variables are unstable and undocumented. .. raw:: latex \endgroup ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/make.bat0000644000076600000240000000142000000000000014502 0ustar00tkomiyastaff@ECHO OFF REM Command file for Sphinx documentation if "%SPHINXBUILD%" == "" ( set SPHINXBUILD=python ../sphinx/cmd/build.py ) set SOURCEDIR=. set BUILDDIR=_build if "%1" == "" goto help %SPHINXBUILD% 2> nul if errorlevel 9009 ( echo. echo.The 'sphinx-build' command was not found. Make sure you have Sphinx echo.installed, then set the SPHINXBUILD environment variable to point echo.to the full path of the 'sphinx-build' executable. Alternatively you echo.may add the Sphinx directory to PATH. echo. echo.If you don't have Sphinx installed, grab it from echo.https://www.sphinx-doc.org/ exit /b 1 ) %SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% goto end :help %SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% :end ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.4155674 Sphinx-4.3.2/doc/man/0000755000076600000240000000000000000000000013653 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/doc/man/index.rst0000644000076600000240000000045000000000000015513 0ustar00tkomiyastaffMan Pages ========= These are the applications provided as part of Sphinx. Core Applications ----------------- .. toctree:: :maxdepth: 3 sphinx-quickstart sphinx-build Additional Applications ----------------------- .. toctree:: :maxdepth: 3 sphinx-apidoc sphinx-autogen ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/man/sphinx-apidoc.rst0000644000076600000240000001054700000000000017162 0ustar00tkomiyastaffsphinx-apidoc ============= Synopsis -------- **sphinx-apidoc** [*OPTIONS*] -o <*OUTPUT_PATH*> <*MODULE_PATH*> [*EXCLUDE_PATTERN* ...] Description ----------- :program:`sphinx-apidoc` is a tool for automatic generation of Sphinx sources that, using the :rst:dir:`autodoc` extension, document a whole package in the style of other automatic API documentation tools. *MODULE_PATH* is the path to a Python package to document, and *OUTPUT_PATH* is the directory where the generated sources are placed. Any *EXCLUDE_PATTERN*\s given are `fnmatch-style`_ file and/or directory patterns that will be excluded from generation. .. _fnmatch-style: https://docs.python.org/3/library/fnmatch.html .. warning:: ``sphinx-apidoc`` generates source files that use :mod:`sphinx.ext.autodoc` to document all found modules. If any modules have side effects on import, these will be executed by ``autodoc`` when ``sphinx-build`` is run. If you document scripts (as opposed to library modules), make sure their main routine is protected by a ``if __name__ == '__main__'`` condition. Options ------- .. program:: sphinx-apidoc .. option:: -o Directory to place the output files. If it does not exist, it is created. .. option:: -q Do not output anything on standard output, only write warnings and errors to standard error. .. option:: -f, --force Force overwriting of any existing generated files. .. option:: -l, --follow-links Follow symbolic links. .. option:: -n, --dry-run Do not create any files. .. option:: -s Suffix for the source files generated. Defaults to ``rst``. .. option:: -d Maximum depth for the generated table of contents file. .. option:: --tocfile Filename for a table of contents file. Defaults to ``modules``. .. option:: -T, --no-toc Do not create a table of contents file. Ignored when :option:`--full` is provided. .. option:: -F, --full Generate a full Sphinx project (``conf.py``, ``Makefile`` etc.) using the same mechanism as :program:`sphinx-quickstart`. .. option:: -e, --separate Put documentation for each module on its own page. .. versionadded:: 1.2 .. option:: -E, --no-headings Do not create headings for the modules/packages. This is useful, for example, when docstrings already contain headings. .. option:: -P, --private Include "_private" modules. .. versionadded:: 1.2 .. option:: --implicit-namespaces By default sphinx-apidoc processes sys.path searching for modules only. Python 3.3 introduced :pep:`420` implicit namespaces that allow module path structures such as ``foo/bar/module.py`` or ``foo/bar/baz/__init__.py`` (notice that ``bar`` and ``foo`` are namespaces, not modules). Interpret paths recursively according to PEP-0420. .. option:: -M, --module-first Put module documentation before submodule documentation. These options are used when :option:`--full` is specified: .. option:: -a Append module_path to sys.path. .. option:: -H Sets the project name to put in generated files (see :confval:`project`). .. option:: -A Sets the author name(s) to put in generated files (see :confval:`copyright`). .. option:: -V Sets the project version to put in generated files (see :confval:`version`). .. option:: -R Sets the project release to put in generated files (see :confval:`release`). .. rubric:: Project templating .. versionadded:: 2.2 Project templating options for sphinx-apidoc .. option:: -t, --templatedir=TEMPLATEDIR Template directory for template files. You can modify the templates of sphinx project files generated by apidoc. Following Jinja2 template files are allowed: * ``module.rst_t`` * ``package.rst_t`` * ``toc.rst_t`` * ``root_doc.rst_t`` * ``conf.py_t`` * ``Makefile_t`` * ``Makefile.new_t`` * ``make.bat_t`` * ``make.bat.new_t`` In detail, please refer the system template files Sphinx provides. (``sphinx/templates/apidoc`` and ``sphinx/templates/quickstart``) Environment ----------- .. envvar:: SPHINX_APIDOC_OPTIONS A comma-separated list of option to append to generated ``automodule`` directives. Defaults to ``members,undoc-members,show-inheritance``. See also -------- :manpage:`sphinx-build(1)`, :manpage:`sphinx-autogen(1)` .. _fnmatch: https://docs.python.org/3/library/fnmatch.html ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1639902831.0 Sphinx-4.3.2/doc/man/sphinx-autogen.rst0000644000076600000240000000370500000000000017363 0ustar00tkomiyastaffsphinx-autogen ============== Synopsis -------- **sphinx-autogen** [*options*] ... Description ----------- :program:`sphinx-autogen` is a tool for automatic generation of Sphinx sources that, using the :rst:dir:`autodoc` extension, document items included in :rst:dir:`autosummary` listing(s). *sourcefile* is the path to one or more reStructuredText documents containing :rst:dir:`autosummary` entries with the ``:toctree::`` option set. *sourcefile* can be an :py:mod:`fnmatch`-style pattern. Options ------- .. program:: sphinx-autogen .. option:: -o Directory to place the output file. If it does not exist, it is created. Defaults to the value passed to the ``:toctree:`` option. .. option:: -s , --suffix Default suffix to use for generated files. Defaults to ``rst``. .. option:: -t , --templates Custom template directory. Defaults to ``None``. .. option:: -i, --imported-members Document imported members. Example ------- Given the following directory structure:: docs ├── index.rst └── ... foobar ├── foo │ └── __init__.py └── bar ├── __init__.py └── baz └── __init__.py and assuming ``docs/index.rst`` contained the following: .. code-block:: rst Modules ======= .. autosummary:: :toctree: modules foobar.foo foobar.bar foobar.bar.baz If you run the following: .. code-block:: bash $ PYTHONPATH=. sphinx-autogen docs/index.rst then the following stub files will be created in ``docs``:: docs ├── index.rst └── modules ├── foobar.bar.rst ├── foobar.bar.baz.rst └── foobar.foo.rst and each of those files will contain a :rst:dir:`autodoc` directive and some other information. See also -------- :manpage:`sphinx-build(1)`, :manpage:`sphinx-apidoc(1)` ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/man/sphinx-build.rst0000644000076600000240000002326200000000000017020 0ustar00tkomiyastaffsphinx-build ============ Synopsis -------- **sphinx-build** [*options*] <*sourcedir*> <*outputdir*> [*filenames* ...] Description ----------- :program:`sphinx-build` generates documentation from the files in ```` and places it in the ````. :program:`sphinx-build` looks for ``/conf.py`` for the configuration settings. :manpage:`sphinx-quickstart(1)` may be used to generate template files, including ``conf.py``. :program:`sphinx-build` can create documentation in different formats. A format is selected by specifying the builder name on the command line; it defaults to HTML. Builders can also perform other tasks related to documentation processing. For a list of available builders, refer to :option:`sphinx-build -b`. By default, everything that is outdated is built. Output only for selected files can be built by specifying individual filenames. Options ------- .. program:: sphinx-build .. option:: -b buildername The most important option: it selects a builder. The most common builders are: **html** Build HTML pages. This is the default builder. **dirhtml** Build HTML pages, but with a single directory per document. Makes for prettier URLs (no ``.html``) if served from a webserver. **singlehtml** Build a single HTML with the whole content. **htmlhelp**, **qthelp**, **devhelp**, **epub** Build HTML files with additional information for building a documentation collection in one of these formats. **applehelp** Build an Apple Help Book. Requires :program:`hiutil` and :program:`codesign`, which are not Open Source and presently only available on Mac OS X 10.6 and higher. **latex** Build LaTeX sources that can be compiled to a PDF document using :program:`pdflatex`. **man** Build manual pages in groff format for UNIX systems. **texinfo** Build Texinfo files that can be processed into Info files using :program:`makeinfo`. **text** Build plain text files. **gettext** Build gettext-style message catalogs (``.pot`` files). **doctest** Run all doctests in the documentation, if the :mod:`~sphinx.ext.doctest` extension is enabled. **linkcheck** Check the integrity of all external links. **xml** Build Docutils-native XML files. **pseudoxml** Build compact pretty-printed "pseudo-XML" files displaying the internal structure of the intermediate document trees. See :doc:`/usage/builders/index` for a list of all builders shipped with Sphinx. Extensions can add their own builders. .. _make_mode: .. option:: -M buildername Alternative to :option:`-b`. Uses the Sphinx :program:`make_mode` module, which provides the same build functionality as a default :ref:`Makefile or Make.bat `. In addition to all Sphinx :doc:`/usage/builders/index`, the following build pipelines are available: **latexpdf** Build LaTeX files and run them through :program:`pdflatex`, or as per :confval:`latex_engine` setting. If :confval:`language` is set to ``'ja'``, will use automatically the :program:`platex/dvipdfmx` latex to PDF pipeline. **info** Build Texinfo files and run them through :program:`makeinfo`. .. important:: Sphinx only recognizes the ``-M`` option if it is placed first. .. versionadded:: 1.2.1 .. option:: -a If given, always write all output files. The default is to only write output files for new and changed source files. (This may not apply to all builders.) .. option:: -E Don't use a saved :term:`environment` (the structure caching all cross-references), but rebuild it completely. The default is to only read and parse source files that are new or have changed since the last run. .. option:: -t tag Define the tag *tag*. This is relevant for :rst:dir:`only` directives that only include their content if this tag is set. .. versionadded:: 0.6 .. option:: -d path Since Sphinx has to read and parse all source files before it can write an output file, the parsed source files are cached as "doctree pickles". Normally, these files are put in a directory called :file:`.doctrees` under the build directory; with this option you can select a different cache directory (the doctrees can be shared between all builders). .. option:: -j N Distribute the build over *N* processes in parallel, to make building on multiprocessor machines more effective. Note that not all parts and not all builders of Sphinx can be parallelized. If ``auto`` argument is given, Sphinx uses the number of CPUs as *N*. .. versionadded:: 1.2 This option should be considered *experimental*. .. versionchanged:: 1.7 Support ``auto`` argument. .. option:: -c path Don't look for the :file:`conf.py` in the source directory, but use the given configuration directory instead. Note that various other files and paths given by configuration values are expected to be relative to the configuration directory, so they will have to be present at this location too. .. versionadded:: 0.3 .. option:: -C Don't look for a configuration file; only take options via the ``-D`` option. .. versionadded:: 0.5 .. option:: -D setting=value Override a configuration value set in the :file:`conf.py` file. The value must be a number, string, list or dictionary value. For lists, you can separate elements with a comma like this: ``-D html_theme_path=path1,path2``. For dictionary values, supply the setting name and key like this: ``-D latex_elements.docclass=scrartcl``. For boolean values, use ``0`` or ``1`` as the value. .. versionchanged:: 0.6 The value can now be a dictionary value. .. versionchanged:: 1.3 The value can now also be a list value. .. option:: -A name=value Make the *name* assigned to *value* in the HTML templates. .. versionadded:: 0.5 .. option:: -n Run in nit-picky mode. Currently, this generates warnings for all missing references. See the config value :confval:`nitpick_ignore` for a way to exclude some references as "known missing". .. option:: -N Do not emit colored output. .. option:: -v Increase verbosity (loglevel). This option can be given up to three times to get more debug logging output. It implies :option:`-T`. .. versionadded:: 1.2 .. option:: -q Do not output anything on standard output, only write warnings and errors to standard error. .. option:: -Q Do not output anything on standard output, also suppress warnings. Only errors are written to standard error. .. option:: -w file Write warnings (and errors) to the given file, in addition to standard error. .. option:: -W Turn warnings into errors. This means that the build stops at the first warning and ``sphinx-build`` exits with exit status 1. .. option:: --keep-going With -W option, keep going processing when getting warnings to the end of build, and ``sphinx-build`` exits with exit status 1. .. versionadded:: 1.8 .. option:: -T Display the full traceback when an unhandled exception occurs. Otherwise, only a summary is displayed and the traceback information is saved to a file for further analysis. .. versionadded:: 1.2 .. option:: -P (Useful for debugging only.) Run the Python debugger, :mod:`pdb`, if an unhandled exception occurs while building. .. option:: -h, --help, --version Display usage summary or Sphinx version. .. versionadded:: 1.2 You can also give one or more filenames on the command line after the source and build directories. Sphinx will then try to build only these output files (and their dependencies). Environment Variables --------------------- The :program:`sphinx-build` refers following environment variables: .. describe:: MAKE A path to make command. A command name is also allowed. :program:`sphinx-build` uses it to invoke sub-build process on make-mode. .. _makefile_options: .. rubric:: Makefile Options The :file:`Makefile` and :file:`make.bat` files created by :program:`sphinx-quickstart` usually run :program:`sphinx-build` only with the :option:`-b` and :option:`-d` options. However, they support the following variables to customize behavior: .. describe:: PAPER This sets the ``'papersize'`` key of :confval:`latex_elements`: i.e. ``PAPER=a4`` sets it to ``'a4paper'`` and ``PAPER=letter`` to ``'letterpaper'``. .. note:: Usage of this environment variable got broken at Sphinx 1.5 as ``a4`` or ``letter`` ended up as option to LaTeX document in place of the needed ``a4paper``, resp. ``letterpaper``. Fixed at 1.7.7. .. describe:: SPHINXBUILD The command to use instead of ``sphinx-build``. .. describe:: BUILDDIR The build directory to use instead of the one chosen in :program:`sphinx-quickstart`. .. describe:: SPHINXOPTS Additional options for :program:`sphinx-build`. These options can also be set via the shortcut variable **O** (capital 'o'). .. _when-deprecation-warnings-are-displayed: Deprecation Warnings -------------------- If any deprecation warning like ``RemovedInSphinxXXXWarning`` are displayed when building a user's document, some Sphinx extension is using deprecated features. In that case, please report it to author of the extension. To disable the deprecation warnings, please set ``PYTHONWARNINGS=`` environment variable to your environment. For example: * ``PYTHONWARNINGS= make html`` (Linux/Mac) * ``export PYTHONWARNINGS=`` and do ``make html`` (Linux/Mac) * ``set PYTHONWARNINGS=`` and do ``make html`` (Windows) * modify your Makefile/make.bat and set the environment variable See also -------- :manpage:`sphinx-quickstart(1)` ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/man/sphinx-quickstart.rst0000644000076600000240000000714400000000000020114 0ustar00tkomiyastaffsphinx-quickstart ================= Synopsis -------- **sphinx-quickstart** Description ----------- :program:`sphinx-quickstart` is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with :manpage:`sphinx-build(1)`. Options ------- .. program:: sphinx-quickstart .. option:: -q, --quiet Quiet mode that skips the interactive wizard for specifying options. This option requires `-p`, `-a` and `-v` options. .. option:: -h, --help, --version Display usage summary or Sphinx version. .. rubric:: Structure Options .. option:: --sep If specified, separate source and build directories. .. option:: --no-sep If specified, create build directory under source directory. .. option:: --dot=DOT Inside the root directory, two more directories will be created; "_templates" for custom HTML templates and "_static" for custom stylesheets and other static files. You can enter another prefix (such as ".") to replace the underscore. .. rubric:: Project Basic Options .. option:: -p PROJECT, --project=PROJECT Project name will be set. (see :confval:`project`). .. option:: -a AUTHOR, --author=AUTHOR Author names. (see :confval:`copyright`). .. option:: -v VERSION Version of project. (see :confval:`version`). .. option:: -r RELEASE, --release=RELEASE Release of project. (see :confval:`release`). .. option:: -l LANGUAGE, --language=LANGUAGE Document language. (see :confval:`language`). .. option:: --suffix=SUFFIX Source file suffix. (see :confval:`source_suffix`). .. option:: --master=MASTER Master document name. (see :confval:`root_doc`). .. rubric:: Extension Options .. option:: --ext-autodoc Enable `sphinx.ext.autodoc` extension. .. option:: --ext-doctest Enable `sphinx.ext.doctest` extension. .. option:: --ext-intersphinx Enable `sphinx.ext.intersphinx` extension. .. option:: --ext-todo Enable `sphinx.ext.todo` extension. .. option:: --ext-coverage Enable `sphinx.ext.coverage` extension. .. option:: --ext-imgmath Enable `sphinx.ext.imgmath` extension. .. option:: --ext-mathjax Enable `sphinx.ext.mathjax` extension. .. option:: --ext-ifconfig Enable `sphinx.ext.ifconfig` extension. .. option:: --ext-viewcode Enable `sphinx.ext.viewcode` extension. .. option:: --ext-githubpages Enable `sphinx.ext.githubpages` extension. .. option:: --extensions=EXTENSIONS Enable arbitrary extensions. .. rubric:: Makefile and Batchfile Creation Options .. option:: --use-make-mode (-m), --no-use-make-mode (-M) :file:`Makefile/make.bat` uses (or doesn't use) :ref:`make-mode `. Default is ``use``, which generates a more concise :file:`Makefile/make.bat`. .. versionchanged:: 1.5 make-mode is default. .. option:: --makefile, --no-makefile Create (or not create) makefile. .. option:: --batchfile, --no-batchfile Create (or not create) batchfile .. rubric:: Project templating .. versionadded:: 1.5 Project templating options for sphinx-quickstart .. option:: -t, --templatedir=TEMPLATEDIR Template directory for template files. You can modify the templates of sphinx project files generated by quickstart. Following Jinja2 template files are allowed: * ``root_doc.rst_t`` * ``conf.py_t`` * ``Makefile_t`` * ``Makefile.new_t`` * ``make.bat_t`` * ``make.bat.new_t`` In detail, please refer the system template files Sphinx provides. (``sphinx/templates/quickstart``) .. option:: -d NAME=VALUE Define a template variable See also -------- :manpage:`sphinx-build(1)` ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/doc/templating.rst0000644000076600000240000003523400000000000016005 0ustar00tkomiyastaff.. highlight:: html+jinja .. _templating: ========== Templating ========== Sphinx uses the `Jinja `_ templating engine for its HTML templates. Jinja is a text-based engine, inspired by Django templates, so anyone having used Django will already be familiar with it. It also has excellent documentation for those who need to make themselves familiar with it. Do I need to use Sphinx's templates to produce HTML? ---------------------------------------------------- No. You have several other options: * You can write a :class:`~sphinx.application.TemplateBridge` subclass that calls your template engine of choice, and set the :confval:`template_bridge` configuration value accordingly. * You can :ref:`write a custom builder ` that derives from :class:`~sphinx.builders.html.StandaloneHTMLBuilder` and calls your template engine of choice. * You can use the :class:`~sphinx.builders.html.PickleHTMLBuilder` that produces pickle files with the page contents, and postprocess them using a custom tool, or use them in your Web application. Jinja/Sphinx Templating Primer ------------------------------ The default templating language in Sphinx is Jinja. It's Django/Smarty inspired and easy to understand. The most important concept in Jinja is :dfn:`template inheritance`, which means that you can overwrite only specific blocks within a template, customizing it while also keeping the changes at a minimum. To customize the output of your documentation you can override all the templates (both the layout templates and the child templates) by adding files with the same name as the original filename into the template directory of the structure the Sphinx quickstart generated for you. Sphinx will look for templates in the folders of :confval:`templates_path` first, and if it can't find the template it's looking for there, it falls back to the selected theme's templates. A template contains **variables**, which are replaced with values when the template is evaluated, **tags**, which control the logic of the template and **blocks** which are used for template inheritance. Sphinx's *basic* theme provides base templates with a couple of blocks it will fill with data. These are located in the :file:`themes/basic` subdirectory of the Sphinx installation directory, and used by all builtin Sphinx themes. Templates with the same name in the :confval:`templates_path` override templates supplied by the selected theme. For example, to add a new link to the template area containing related links all you have to do is to add a new template called ``layout.html`` with the following contents:: {% extends "!layout.html" %} {% block rootrellink %}
  • Project Homepage »
    • {{ super() }} {% endblock %} By prefixing the name of the overridden template with an exclamation mark, Sphinx will load the layout template from the underlying HTML theme. .. important:: If you override a block, call ``{{ super() }}`` somewhere to render the block's original content in the extended template -- unless you don't want that content to show up. Working with the builtin templates ---------------------------------- The builtin **basic** theme supplies the templates that all builtin Sphinx themes are based on. It has the following elements you can override or use: Blocks ~~~~~~ The following blocks exist in the ``layout.html`` template: ``doctype`` The doctype of the output format. By default this is XHTML 1.0 Transitional as this is the closest to what Sphinx and Docutils generate and it's a good idea not to change it unless you want to switch to HTML 5 or a different but compatible XHTML doctype. ``linktags`` This block adds a couple of ```` tags to the head section of the template. ``extrahead`` This block is empty by default and can be used to add extra contents into the ```` tag of the generated HTML file. This is the right place to add references to JavaScript or extra CSS files. ``relbar1``, ``relbar2`` This block contains the *relation bar*, the list of related links (the parent documents on the left, and the links to index, modules etc. on the right). ``relbar1`` appears before the document, ``relbar2`` after the document. By default, both blocks are filled; to show the relbar only before the document, you would override `relbar2` like this:: {% block relbar2 %}{% endblock %} ``rootrellink``, ``relbaritems`` Inside the relbar there are three sections: The ``rootrellink``, the links from the documentation and the custom ``relbaritems``. The ``rootrellink`` is a block that by default contains a list item pointing to the root document by default, the ``relbaritems`` is an empty block. If you override them to add extra links into the bar make sure that they are list items and end with the :data:`reldelim1`. ``document`` The contents of the document itself. It contains the block "body" where the individual content is put by subtemplates like ``page.html``. .. note:: In order for the built-in JavaScript search to show a page preview on the results page, the document or body content should be wrapped in an HTML element containing the ``role="main"`` attribute. For example::
    {% block document %}{% endblock %}
    ``sidebar1``, ``sidebar2`` A possible location for a sidebar. ``sidebar1`` appears before the document and is empty by default, ``sidebar2`` after the document and contains the default sidebar. If you want to swap the sidebar location override this and call the ``sidebar`` helper:: {% block sidebar1 %}{{ sidebar() }}{% endblock %} {% block sidebar2 %}{% endblock %} (The ``sidebar2`` location for the sidebar is needed by the ``sphinxdoc.css`` stylesheet, for example.) ``sidebarlogo`` The logo location within the sidebar. Override this if you want to place some content at the top of the sidebar. ``footer`` The block for the footer div. If you want a custom footer or markup before or after it, override this one. The following four blocks are *only* used for pages that do not have assigned a list of custom sidebars in the :confval:`html_sidebars` config value. Their use is deprecated in favor of separate sidebar templates, which can be included via :confval:`html_sidebars`. ``sidebartoc`` The table of contents within the sidebar. .. deprecated:: 1.0 ``sidebarrel`` The relation links (previous, next document) within the sidebar. .. deprecated:: 1.0 ``sidebarsourcelink`` The "Show source" link within the sidebar (normally only shown if this is enabled by :confval:`html_show_sourcelink`). .. deprecated:: 1.0 ``sidebarsearch`` The search box within the sidebar. Override this if you want to place some content at the bottom of the sidebar. .. deprecated:: 1.0 Configuration Variables ~~~~~~~~~~~~~~~~~~~~~~~ Inside templates you can set a couple of variables used by the layout template using the ``{% set %}`` tag: .. data:: reldelim1 The delimiter for the items on the left side of the related bar. This defaults to ``' »'`` Each item in the related bar ends with the value of this variable. .. data:: reldelim2 The delimiter for the items on the right side of the related bar. This defaults to ``' |'``. Each item except of the last one in the related bar ends with the value of this variable. Overriding works like this:: {% extends "!layout.html" %} {% set reldelim1 = ' >' %} .. data:: script_files Add additional script files here, like this:: {% set script_files = script_files + ["_static/myscript.js"] %} .. deprecated:: 1.8.0 Please use ``.Sphinx.add_js_file()`` instead. Helper Functions ~~~~~~~~~~~~~~~~ Sphinx provides various Jinja functions as helpers in the template. You can use them to generate links or output multiply used elements. .. function:: pathto(document) Return the path to a Sphinx document as a URL. Use this to refer to built documents. .. function:: pathto(file, 1) :noindex: Return the path to a *file* which is a filename relative to the root of the generated output. Use this to refer to static files. .. function:: hasdoc(document) Check if a document with the name *document* exists. .. function:: sidebar() Return the rendered sidebar. .. function:: relbar() Return the rendered relation bar. .. function:: warning(message) Emit a warning message. Global Variables ~~~~~~~~~~~~~~~~ These global variables are available in every template and are safe to use. There are more, but most of them are an implementation detail and might change in the future. .. data:: builder The name of the builder (e.g. ``html`` or ``htmlhelp``). .. data:: copyright The value of :confval:`copyright`. .. data:: docstitle The title of the documentation (the value of :confval:`html_title`), except when the "single-file" builder is used, when it is set to ``None``. .. data:: embedded True if the built HTML is meant to be embedded in some viewing application that handles navigation, not the web browser, such as for HTML help or Qt help formats. In this case, the sidebar is not included. .. data:: favicon The path to the HTML favicon in the static path, or URL to the favicon, or ``''``. .. deprecated:: 4.0 Recommend to use ``favicon_url`` instead. .. data:: favicon_url The relative path to the HTML favicon image from the current document, or URL to the favicon, or ``''``. .. versionadded:: 4.0 .. data:: file_suffix The value of the builder's :attr:`~.SerializingHTMLBuilder.out_suffix` attribute, i.e. the file name extension that the output files will get. For a standard HTML builder, this is usually ``.html``. .. data:: has_source True if the reST document sources are copied (if :confval:`html_copy_source` is ``True``). .. data:: language The value of :confval:`language`. .. data:: last_updated The build date. .. data:: logo The path to the HTML logo image in the static path, or URL to the logo, or ``''``. .. deprecated:: 4.0 Recommend to use ``logo_url`` instead. .. data:: logo_url The relative path to the HTML logo image from the current document, or URL to the logo, or ``''``. .. versionadded:: 4.0 .. data:: master_doc Same as :data:`root_doc`. .. versionchanged:: 4.0 Renamed to ``root_doc``. .. data:: root_doc The value of :confval:`root_doc`, for usage with :func:`pathto`. .. versionchanged:: 4.0 Renamed from ``master_doc``. .. data:: pagename The "page name" of the current file, i.e. either the document name if the file is generated from a reST source, or the equivalent hierarchical name relative to the output directory (``[directory/]filename_without_extension``). .. data:: project The value of :confval:`project`. .. data:: release The value of :confval:`release`. .. data:: rellinks A list of links to put at the left side of the relbar, next to "next" and "prev". This usually contains links to the general index and other indices, such as the Python module index. If you add something yourself, it must be a tuple ``(pagename, link title, accesskey, link text)``. .. data:: shorttitle The value of :confval:`html_short_title`. .. data:: show_source True if :confval:`html_show_sourcelink` is ``True``. .. data:: sphinx_version The version of Sphinx used to build represented as a string for example "3.5.1". .. data:: sphinx_version_tuple The version of Sphinx used to build represented as a tuple of five elements. For Sphinx version 3.5.1 beta 3 this would be `(3, 5, 1, 'beta', 3)``. The fourth element can be one of: ``alpha``, ``beta``, ``rc``, ``final``. ``final`` always has 0 as the last element. .. versionadded:: 4.2 .. data:: style The name of the main stylesheet, as given by the theme or :confval:`html_style`. .. data:: title The title of the current document, as used in the ```` tag. .. data:: use_opensearch The value of :confval:`html_use_opensearch`. .. data:: version The value of :confval:`version`. In addition to these values, there are also all **theme options** available (prefixed by ``theme_``), as well as the values given by the user in :confval:`html_context`. In documents that are created from source files (as opposed to automatically-generated files like the module index, or documents that already are in HTML form), these variables are also available: .. data:: body A string containing the content of the page in HTML form as produced by the HTML builder, before the theme is applied. .. data:: display_toc A boolean that is True if the toc contains more than one entry. .. data:: meta Document metadata (a dictionary), see :ref:`metadata`. .. data:: metatags A string containing the page's HTML :dudir:`meta` tags. .. data:: next The next document for the navigation. This variable is either false or has two attributes `link` and `title`. The title contains HTML markup. For example, to generate a link to the next page, you can use this snippet:: {% if next %} <a href="{{ next.link|e }}">{{ next.title }}</a> {% endif %} .. data:: page_source_suffix The suffix of the file that was rendered. Since we support a list of :confval:`source_suffix`, this will allow you to properly link to the original source file. .. data:: parents A list of parent documents for navigation, structured like the :data:`next` item. .. data:: prev Like :data:`next`, but for the previous page. .. data:: sourcename The name of the copied source file for the current document. This is only nonempty if the :confval:`html_copy_source` value is ``True``. This has empty value on creating automatically-generated files. .. data:: toc The local table of contents for the current page, rendered as HTML bullet lists. .. data:: toctree A callable yielding the global TOC tree containing the current page, rendered as HTML bullet lists. Optional keyword arguments: ``collapse`` If true, all TOC entries that are not ancestors of the current page are collapsed. ``True`` by default. ``maxdepth`` The maximum depth of the tree. Set it to ``-1`` to allow unlimited depth. Defaults to the max depth selected in the toctree directive. ``titles_only`` If true, put only top-level document titles in the tree. ``False`` by default. ``includehidden`` If true, the ToC tree will also contain hidden entries. ``False`` by default. ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4180114 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/tutorial/��������������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�014743� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/tutorial/automatic-doc-generation.rst����������������������������������������������0000644�0000766�0000024�00000011627�00000000000�022366� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Automatic documentation generation from code ============================================ In the :ref:`previous section <tutorial-describing-objects>` of the tutorial you manually documented a Python function in Sphinx. However, the description was out of sync with the code itself, since the function signature was not the same. Besides, it would be nice to reuse `Python docstrings <https://www.python.org/dev/peps/pep-0257/#what-is-a-docstring>`_ in the documentation, rather than having to write the information in two places. Fortunately, :doc:`the autodoc extension </usage/extensions/autodoc>` provides this functionality. Reusing signatures and docstrings with autodoc ---------------------------------------------- To use autodoc, first add it to the list of enabled extensions: .. code-block:: python :caption: docs/source/conf.py :emphasize-lines: 4 extensions = [ 'sphinx.ext.duration', 'sphinx.ext.doctest', 'sphinx.ext.autodoc', ] Next, move the content of the ``.. py:function`` directive to the function docstring in the original Python file, as follows: .. code-block:: python :caption: lumache.py :emphasize-lines: 2-11 def get_random_ingredients(kind=None): """ Return a list of random ingredients as strings. :param kind: Optional "kind" of ingredients. :type kind: list[str] or None :raise lumache.InvalidKindError: If the kind is invalid. :return: The ingredients list. :rtype: list[str] """ return ["shells", "gorgonzola", "parsley"] Finally, replace the ``.. py:function`` directive from the Sphinx documentation with :rst:dir:`autofunction`: .. code-block:: rst :caption: docs/source/usage.rst :emphasize-lines: 3 you can use the ``lumache.get_random_ingredients()`` function: .. autofunction:: lumache.get_random_ingredients If you now build the HTML documentation, the output will be the same! With the advantage that it is generated from the code itself. Sphinx took the reStructuredText from the docstring and included it, also generating proper cross-references. You can also autogenerate documentation from other objects. For example, add the code for the ``InvalidKindError`` exception: .. code-block:: python :caption: lumache.py class InvalidKindError(Exception): """Raised if the kind is invalid.""" pass And replace the ``.. py:exception`` directive with :rst:dir:`autoexception` as follows: .. code-block:: rst :caption: docs/source/usage.rst :emphasize-lines: 4 or ``"veggies"``. Otherwise, :py:func:`lumache.get_random_ingredients` will raise an exception. .. autoexception:: lumache.InvalidKindError And again, after running ``make html``, the output will be the same as before. Generating comprehensive API references --------------------------------------- While using ``sphinx.ext.autodoc`` makes keeping the code and the documentation in sync much easier, it still requires you to write an ``auto*`` directive for every object you want to document. Sphinx provides yet another level of automation: the :doc:`autosummary </usage/extensions/autosummary>` extension. The :rst:dir:`autosummary` directive generates documents that contain all the necessary ``autodoc`` directives. To use it, first enable the autosummary extension: .. code-block:: python :caption: docs/source/conf.py :emphasize-lines: 5 extensions = [ 'sphinx.ext.duration', 'sphinx.ext.doctest', 'sphinx.ext.autodoc', 'sphinx.ext.autosummary', ] Next, create a new ``api.rst`` file with these contents: .. code-block:: rst :caption: docs/source/api.rst API === .. autosummary:: :toctree: generated lumache Remember to include the new document in the root toctree: .. code-block:: rst :caption: docs/source/index.rst :emphasize-lines: 7 Contents -------- .. toctree:: usage api Finally, after you build the HTML documentation running ``make html``, it will contain two new pages: - ``api.html``, corresponding to ``docs/source/api.rst`` and containing a table with the objects you included in the ``autosummary`` directive (in this case, only one). - ``generated/lumache.html``, corresponding to a newly created reST file ``generated/lumache.rst`` and containing a summary of members of the module, in this case one function and one exception. .. figure:: /_static/tutorial/lumache-autosummary.png :width: 80% :align: center :alt: Summary page created by autosummary Summary page created by autosummary Each of the links in the summary page will take you to the places where you originally used the corresponding ``autodoc`` directive, in this case in the ``usage.rst`` document. .. note:: The generated files are based on `Jinja2 templates <https://jinja2docs.readthedocs.io/>`_ that :ref:`can be customized <autosummary-customizing-templates>`, but that is out of scope for this tutorial. ���������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/tutorial/describing-code.rst�������������������������������������������������������0000644�0000766�0000024�00000017174�00000000000�020530� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Describing code in Sphinx ========================= In the :doc:`previous sections of the tutorial </tutorial/index>` you can read how to write narrative or prose documentation in Sphinx. In this section you will describe code objects instead. Sphinx supports documenting code objects in several languages, namely Python, C, C++, JavaScript, and reStructuredText. Each of them can be documented using a series of directives and roles grouped by :doc:`domain </usage/restructuredtext/domains>`. For the remainder of the tutorial you will use the Python domain, but all the concepts seen in this section apply for the other domains as well. .. _tutorial-describing-objects: Documenting Python objects -------------------------- Sphinx offers several roles and directives to document Python objects, all grouped together in :ref:`the Python domain <python-domain>`. For example, you can use the :rst:dir:`py:function` directive to document a Python function, as follows: .. code-block:: rst :caption: docs/source/usage.rst Creating recipes ---------------- To retrieve a list of random ingredients, you can use the ``lumache.get_random_ingredients()`` function: .. py:function:: lumache.get_random_ingredients(kind=None) Return a list of random ingredients as strings. :param kind: Optional "kind" of ingredients. :type kind: list[str] or None :return: The ingredients list. :rtype: list[str] Which will render like this: .. figure:: /_static/tutorial/lumache-py-function.png :width: 80% :align: center :alt: HTML result of documenting a Python function in Sphinx The rendered result of documenting a Python function in Sphinx Notice several things: - Sphinx parsed the argument of the ``.. py:function`` directive and highlighted the module, the function name, and the parameters appropriately. - The directive content includes a one-line description of the function, as well as a :ref:`info field list <info-field-lists>` containing the function parameter, its expected type, the return value, and the return type. .. note:: The ``py:`` prefix specifies the :term:`domain`. You may configure the default domain so you can omit the prefix, either globally using the :confval:`primary_domain` configuration, or use the :rst:dir:`default-domain` directive to change it from the point it is called until the end of the file. For example, if you set it to ``py`` (the default), you can write ``.. function::`` directly. Cross-referencing Python objects -------------------------------- By default, most of these directives generate entities that can be cross-referenced from any part of the documentation by using :ref:`a corresponding role <python-roles>`. For the case of functions, you can use :rst:role:`py:func` for that, as follows: .. code-block:: rst :caption: docs/source/usage.rst The ``kind`` parameter should be either ``"meat"``, ``"fish"``, or ``"veggies"``. Otherwise, :py:func:`lumache.get_random_ingredients` will raise an exception. When generating code documentation, Sphinx will generate a cross-reference automatically just by using the name of the object, without you having to explicitly use a role for that. For example, you can describe the custom exception raised by the function using the :rst:dir:`py:exception` directive: .. code-block:: rst :caption: docs/source/usage.rst .. py:exception:: lumache.InvalidKindError Raised if the kind is invalid. Then, add this exception to the original description of the function: .. code-block:: rst :caption: docs/source/usage.rst :emphasize-lines: 7 .. py:function:: lumache.get_random_ingredients(kind=None) Return a list of random ingredients as strings. :param kind: Optional "kind" of ingredients. :type kind: list[str] or None :raise lumache.InvalidKindError: If the kind is invalid. :return: The ingredients list. :rtype: list[str] And finally, this is how the result would look: .. figure:: /_static/tutorial/lumache-py-function-full.png :width: 80% :align: center :alt: HTML result of documenting a Python function in Sphinx with cross-references HTML result of documenting a Python function in Sphinx with cross-references Beautiful, isn't it? Including doctests in your documentation ---------------------------------------- Since you are now describing code from a Python library, it will become useful to keep both the documentation and the code as synchronized as possible. One of the ways to do that in Sphinx is to include code snippets in the documentation, called *doctests*, that are executed when the documentation is built. To demonstrate doctests and other Sphinx features covered in this tutorial, Sphinx will need to be able to import the code. To achieve that, write this at the beginning of ``conf.py``: .. code-block:: python :caption: docs/source/conf.py :emphasize-lines: 3-5 # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. import pathlib import sys sys.path.insert(0, pathlib.Path(__file__).parents[2].resolve().as_posix()) .. note:: An alternative to changing the :py:data:`sys.path` variable is to create a ``pyproject.toml`` file and make the code installable, so it behaves like any other Python library. However, the ``sys.path`` approach is simpler. Then, before adding doctests to your documentation, enable the :doc:`doctest </usage/extensions/doctest>` extension in ``conf.py``: .. code-block:: python :caption: docs/source/conf.py :emphasize-lines: 3 extensions = [ 'sphinx.ext.duration', 'sphinx.ext.doctest', ] Next, write a doctest block as follows: .. code-block:: rst :caption: docs/source/usage.rst >>> import lumache >>> lumache.get_random_ingredients() ['shells', 'gorgonzola', 'parsley'] Doctests include the Python instructions to be run preceded by ``>>>``, the standard Python interpreter prompt, as well as the expected output of each instruction. This way, Sphinx can check whether the actual output matches the expected one. To observe how a doctest failure looks like (rather than a code error as above), let's write the return value incorrectly first. Therefore, add a function ``get_random_ingredients`` like this: .. code-block:: python :caption: lumache.py def get_random_ingredients(kind=None): return ["eggs", "bacon", "spam"] You can now run ``make doctest`` to execute the doctests of your documentation. Initially this will display an error, since the actual code does not behave as specified: .. code-block:: console (.venv) $ make doctest Running Sphinx v4.2.0 loading pickled environment... done ... running tests... Document: usage --------------- ********************************************************************** File "usage.rst", line 44, in default Failed example: lumache.get_random_ingredients() Expected: ['shells', 'gorgonzola', 'parsley'] Got: ['eggs', 'bacon', 'spam'] ********************************************************************** ... make: *** [Makefile:20: doctest] Error 1 As you can see, doctest reports the expected and the actual results, for easy examination. It is now time to fix the function: .. code-block:: python :caption: lumache.py :emphasize-lines: 2 def get_random_ingredients(kind=None): return ["shells", "gorgonzola", "parsley"] And finally, ``make test`` reports success! For big projects though, this manual approach can become a bit tedious. In the next section, you will see :doc:`how to automate the process </tutorial/automatic-doc-generation>`. ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/tutorial/end.rst�������������������������������������������������������������������0000644�0000766�0000024�00000000353�00000000000�016244� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Where to go from here ===================== This tutorial covered the very first steps to create a documentation project with Sphinx. To continue learning more about Sphinx, check out the :ref:`rest of the documentation <contents>`. �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/tutorial/first-steps.rst�����������������������������������������������������������0000644�0000766�0000024�00000006572�00000000000�017772� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������First steps to document your project using Sphinx ================================================= Building your HTML documentation -------------------------------- The ``index.rst`` file that ``sphinx-quickstart`` created has some content already, and it gets rendered as the front page of your HTML documentation. It is written in reStructuredText, a powerful markup language. Modify the file as follows: .. code-block:: rst :caption: docs/source/index.rst Welcome to Lumache's documentation! =================================== **Lumache** (/lu'make/) is a Python library for cooks and food lovers that creates recipes mixing random ingredients. It pulls data from the `Open Food Facts database <https://world.openfoodfacts.org/>`_ and offers a *simple* and *intuitive* API. .. note:: This project is under active development. This showcases several features of the reStructuredText syntax, including: - a **section header** using ``===`` for the underline, - two examples of :ref:`rst-inline-markup`: ``**strong emphasis**`` (typically bold) and ``*emphasis*`` (typically italics), - an **inline external link**, - and a ``note`` **admonition** (one of the available :ref:`directives <rst-directives>`) Now to render it with the new content, you can use the ``sphinx-build`` command as before, or leverage the convenience script as follows: .. code-block:: console (.venv) $ cd docs (.venv) $ make html After running this command, you will see that ``index.html`` reflects the new changes! Building your documentation in other formats -------------------------------------------- Sphinx supports a variety of formats apart from HTML, including PDF, EPUB, :ref:`and more <builders>`. For example, to build your documentation in EPUB format, run this command from the ``docs`` directory: .. code-block:: console (.venv) $ make epub After that, you will see the files corresponding to the e-book under ``docs/build/epub/``. You can either open ``Lumache.epub`` with an EPUB-compatible e-book viewer, like `Calibre <https://calibre-ebook.com/>`_, or preview ``index.xhtml`` on a web browser. .. note:: To quickly display a complete list of possible output formats, plus some extra useful commands, you can run :code:`make help`. Each output format has some specific configuration options that you can tune, :ref:`including EPUB <epub-options>`. For instance, the default value of :confval:`epub_show_urls` is ``inline``, which means that, by default, URLs are shown right after the corresponding link, in parentheses. You can change that behavior by adding the following code at the end of your ``conf.py``: .. code-block:: python # EPUB options epub_show_urls = 'footnote' With this configuration value, and after running ``make epub`` again, you will notice that URLs appear now as footnotes, which avoids cluttering the text. Sweet! Read on to explore :doc:`other ways to customize Sphinx </tutorial/more-sphinx-customization>`. .. note:: Generating a PDF using Sphinx can be done running ``make latexpdf``, provided that the system has a working LaTeX installation, as explained in the documentation of :class:`sphinx.builders.latex.LaTeXBuilder`. Although this is perfectly feasible, such installations are often big, and in general LaTeX requires careful configuration in some cases, so PDF generation is out of scope for this tutorial. ��������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/tutorial/getting-started.rst�������������������������������������������������������0000644�0000766�0000024�00000007213�00000000000�020605� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Getting started =============== Setting up your project and development environment --------------------------------------------------- In a new directory, create a file called ``README.rst`` with the following content. .. code-block:: rst :caption: README.rst Lumache ======= **Lumache** (/lu'make/) is a Python library for cooks and food lovers that creates recipes mixing random ingredients. It is a good moment to create a Python virtual environment and install the required tools. For that, open a command line terminal, ``cd`` into the directory you just created, and run the following commands: .. code-block:: console $ python -m venv .venv $ source .venv/bin/activate (.venv) $ python -m pip install sphinx .. note:: The installation method used above is described in more detail in :ref:`install-pypi`. For the rest of this tutorial, the instructions will assume a Python virtual environment. If you executed these instructions correctly, you should have the Sphinx command line tools available. You can do a basic verification running this command: .. code-block:: console (.venv) $ sphinx-build --version sphinx-build 4.0.2 If you see a similar output, you are on the right path! Creating the documentation layout --------------------------------- Then from the command line, run the following command: .. code-block:: console (.venv) $ sphinx-quickstart docs This will present to you a series of questions required to create the basic directory and configuration layout for your project inside the ``docs`` folder. To proceed, answer each question as follows: - ``> Separate source and build directories (y/n) [n]``: Write "``y``" (without quotes) and press :kbd:`Enter`. - ``> Project name``: Write "``Lumache``" (without quotes) and press :kbd:`Enter`. - ``> Author name(s)``: Write "``Graziella``" (without quotes) and press :kbd:`Enter`. - ``> Project release []``: Write "``0.1``" (without quotes) and press :kbd:`Enter`. - ``> Project language [en]``: Leave it empty (the default, English) and press :kbd:`Enter`. After the last question, you will see the new ``docs`` directory with the following content. .. code-block:: text docs ├── build ├── make.bat ├── Makefile └── source ├── conf.py ├── index.rst ├── _static └── _templates The purpose of each of these files is: ``build/`` An empty directory (for now) that will hold the rendered documentation. ``make.bat`` and ``Makefile`` Convenience scripts to simplify some common Sphinx operations, such as rendering the content. ``source/conf.py`` A Python script holding the configuration of the Sphinx project. It contains the project name and release you specified to ``sphinx-quickstart``, as well as some extra configuration keys. ``source/index.rst`` The :term:`root document` of the project, which serves as welcome page and contains the root of the "table of contents tree" (or *toctree*). Thanks to this bootstrapping step, you already have everything needed to render the documentation as HTML for the first time. To do that, run this command: .. code-block:: console (.venv) $ sphinx-build -b html docs/source/ docs/build/html And finally, open ``docs/build/html/index.html`` in your browser. You should see something like this: .. figure:: /_static/tutorial/lumache-first-light.png :width: 80% :align: center :alt: Freshly created documentation of Lumache Freshly created documentation of Lumache There we go! You created your first HTML documentation using Sphinx. Now you can start :doc:`customizing it </tutorial/first-steps>`. �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/tutorial/index.rst�����������������������������������������������������������������0000644�0000766�0000024�00000002523�00000000000�016606� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. _tutorial: =============== Sphinx tutorial =============== In this tutorial you will build a simple documentation project using Sphinx, and view it in your browser as HTML. The project will include narrative, handwritten documentation, as well as autogenerated API documentation. The tutorial is aimed towards Sphinx newcomers willing to learn the fundamentals of how projects are created and structured. You will create a fictional software library to generate random food recipes that will serve as a guide throughout the process, with the objective of properly documenting it. To showcase Sphinx capabilities for code documentation you will use Python, which also supports *automatic* documentation generation. .. note:: Several other languages are natively supported in Sphinx for *manual* code documentation, however they require extensions for *automatic* code documentation, like `Breathe <https://breathe.readthedocs.io/>`_. To follow the instructions you will need access to a Linux-like command line and a basic understanding of how it works, as well as a working Python installation for development, since you will use *Python virtual environments* to create the project. .. toctree:: getting-started first-steps more-sphinx-customization narrative-documentation describing-code automatic-doc-generation end �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/tutorial/more-sphinx-customization.rst���������������������������������������������0000644�0000766�0000024�00000004740�00000000000�022661� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������More Sphinx customization ========================= There are two main ways to customize your documentation beyond what is possible with core Sphinx: extensions and themes. Enabling a built-in extension ----------------------------- In addition to these configuration values, you can customize Sphinx even more by using :doc:`extensions </usage/extensions/index>`. Sphinx ships several :ref:`builtin ones <builtin-extensions>`, and there are many more :ref:`maintained by the community <third-party-extensions>`. For example, to enable the :mod:`sphinx.ext.duration` extension, locate the ``extensions`` list in your ``conf.py`` and add one element as follows: .. code-block:: python :caption: docs/source/conf.py # Add any Sphinx extension module names here, as strings. They can be # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = [ 'sphinx.ext.duration', ] After that, every time you generate your documentation, you will see a short durations report at the end of the console output, like this one: .. code-block:: console (.venv) $ make html ... The HTML pages are in build/html. ====================== slowest reading durations ======================= 0.042 temp/source/index Using a third-party HTML theme ------------------------------ Themes, on the other hand, are a way to customize the appearance of your documentation. Sphinx has several :ref:`builtin themes <builtin-themes>`, and there are also `third-party ones <https://sphinx-themes.org/>`_. For example, to use the `Furo <https://pradyunsg.me/furo/>`_ third-party theme in your HTML documentation, first you will need to install it with ``pip`` in your Python virtual environment, like this: .. code-block:: console (.venv) $ pip install furo And then, locate the ``html_theme`` variable on your ``conf.py`` and replace its value as follows: .. code-block:: python :caption: docs/source/conf.py # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. # html_theme = 'furo' With this change, you will notice that your HTML documentation has now a new appearance: .. figure:: /_static/tutorial/lumache-furo.png :width: 80% :align: center :alt: HTML documentation of Lumache with the Furo theme HTML documentation of Lumache with the Furo theme It is now time to :doc:`expand the narrative documentation and split it into several documents </tutorial/narrative-documentation>`. ��������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/tutorial/narrative-documentation.rst�����������������������������������������������0000644�0000766�0000024�00000010221�00000000000�022333� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Narrative documentation in Sphinx ================================= Structuring your documentation across multiple pages ---------------------------------------------------- The file ``index.rst`` created by ``sphinx-quickstart`` is the :term:`root document`, whose main function is to serve as a welcome page and to contain the root of the "table of contents tree" (or *toctree*). Sphinx allows you to assemble a project from different files, which is helpful when the project grows. As an example, create a new file ``docs/source/usage.rst`` (next to ``index.rst``) with these contents: .. code-block:: rst :caption: docs/source/usage.rst Usage ===== Installation ------------ To use Lumache, first install it using pip: .. code-block:: console (.venv) $ pip install lumache This new file contains two :ref:`section <rst-sections>` headers, normal paragraph text, and a :rst:dir:`code-block` directive that renders a block of content as source code, with appropriate syntax highlighting (in this case, generic ``console`` text). The structure of the document is determined by the succession of heading styles, which means that, by using ``---`` for the "Installation" section after ``===`` for the "Usage" section, you have declared "Installation" to be a *subsection* of "Usage". To complete the process, add a ``toctree`` :ref:`directive <rst-directives>` at the end of ``index.rst`` including the document you just created, as follows: .. code-block:: rst :caption: docs/source/index.rst Contents -------- .. toctree:: usage This step inserts that document in the root of the *toctree*, so now it belongs to the structure of your project, which so far looks like this: .. code-block:: text index └── usage If you build the HTML documentation running ``make html``, you will see that the ``toctree`` gets rendered as a list of hyperlinks, and this allows you to navigate to the new page you just created. Neat! .. warning:: Documents outside a *toctree* will result in ``WARNING: document isn't included in any toctree`` messages during the build process, and will be unreachable for users. Adding cross-references ----------------------- One powerful feature of Sphinx is the ability to seamlessly add :ref:`cross-references <xref-syntax>` to specific parts of the documentation: a document, a section, a figure, a code object, etc. This tutorial is full of them! To add a cross-reference, write this sentence right after the introduction paragraph in ``index.rst``: .. code-block:: rst :caption: docs/source/index.rst Check out the :doc:`usage` section for further information. The :rst:role:`doc` :ref:`role <rst-roles-alt>` you used automatically references a specific document in the project, in this case the ``usage.rst`` you created earlier. Alternatively, you can also add a cross-reference to an arbitrary part of the project. For that, you need to use the :rst:role:`ref` role, and add an explicit *label* that acts as `a target`__. __ https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#hyperlink-targets For example, to reference the "Installation" subsection, add a label right before the heading, as follows: .. code-block:: rst :caption: docs/source/usage.rst :emphasize-lines: 4 Usage ===== .. _installation: Installation ------------ ... And make the sentence you added in ``index.rst`` look like this: .. code-block:: rst :caption: docs/source/index.rst Check out the :doc:`usage` section for further information, including how to :ref:`install <installation>` the project. Notice a trick here: the ``install`` part specifies how the link will look like (we want it to be a specific word, so the sentence makes sense), whereas the ``<installation>`` part refers to the actual label we want to add a cross-reference to. If you do not include an explicit title, hence using ``:ref:`installation```, the section title will be used (in this case, ``Installation``). Both the ``:doc:`` and the ``:ref:`` roles will be rendered as hyperlinks in the HTML documentation. What about :doc:`documenting code objects in Sphinx </tutorial/describing-code>`? Read on! �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4207425 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/�����������������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�014204� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.421683 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/advanced/��������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015751� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/advanced/intl.rst������������������������������������������������������������0000644�0000766�0000024�00000024154�00000000000�017457� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. _intl: Internationalization ==================== .. versionadded:: 1.1 Complementary to translations provided for Sphinx-generated messages such as navigation bars, Sphinx provides mechanisms facilitating the translation of *documents*. See the :ref:`intl-options` for details on configuration. .. figure:: /_static/translation.* :width: 100% Workflow visualization of translations in Sphinx. (The figure is created by `plantuml <https://plantuml.com>`_.) .. contents:: :local: Sphinx internationalization details ----------------------------------- **gettext** [1]_ is an established standard for internationalization and localization. It naively maps messages in a program to a translated string. Sphinx uses these facilities to translate whole documents. Initially project maintainers have to collect all translatable strings (also referred to as *messages*) to make them known to translators. Sphinx extracts these through invocation of ``sphinx-build -b gettext``. Every single element in the doctree will end up in a single message which results in lists being equally split into different chunks while large paragraphs will remain as coarsely-grained as they were in the original document. This grants seamless document updates while still providing a little bit of context for translators in free-text passages. It is the maintainer's task to split up paragraphs which are too large as there is no sane automated way to do that. After Sphinx successfully ran the :class:`~sphinx.builders.gettext.MessageCatalogBuilder` you will find a collection of ``.pot`` files in your output directory. These are **catalog templates** and contain messages in your original language *only*. They can be delivered to translators which will transform them to ``.po`` files --- so called **message catalogs** --- containing a mapping from the original messages to foreign-language strings. *gettext* compiles them into a binary format known as **binary catalogs** through :program:`msgfmt` for efficiency reasons. If you make these files discoverable with :confval:`locale_dirs` for your :confval:`language`, Sphinx will pick them up automatically. An example: you have a document ``usage.rst`` in your Sphinx project. The *gettext* builder will put its messages into ``usage.pot``. Imagine you have Spanish translations [2]_ stored in ``usage.po`` --- for your builds to be translated you need to follow these instructions: * Compile your message catalog to a locale directory, say ``locale``, so it ends up in ``./locale/es/LC_MESSAGES/usage.mo`` in your source directory (where ``es`` is the language code for Spanish.) :: msgfmt "usage.po" -o "locale/es/LC_MESSAGES/usage.mo" * Set :confval:`locale_dirs` to ``["locale/"]``. * Set :confval:`language` to ``es`` (also possible via :option:`-D <sphinx-build -D>`). * Run your desired build. Translating with sphinx-intl ---------------------------- Quick guide ~~~~~~~~~~~ `sphinx-intl`_ is a useful tool to work with Sphinx translation flow. This section describe an easy way to translate with *sphinx-intl*. #. Install `sphinx-intl`_. .. code-block:: console $ pip install sphinx-intl #. Add configurations to ``conf.py``. :: locale_dirs = ['locale/'] # path is example but recommended. gettext_compact = False # optional. This case-study assumes that BUILDDIR is set to ``_build``, :confval:`locale_dirs` is set to ``locale/`` and :confval:`gettext_compact` is set to ``False`` (the Sphinx document is already configured as such). #. Extract translatable messages into pot files. .. code-block:: console $ make gettext The generated pot files will be placed in the ``_build/gettext`` directory. #. Generate po files. We'll use the pot files generated in the above step. .. code-block:: console $ sphinx-intl update -p _build/gettext -l de -l ja Once completed, the generated po files will be placed in the below directories: * ``./locale/de/LC_MESSAGES/`` * ``./locale/ja/LC_MESSAGES/`` #. Translate po files. As noted above, these are located in the ``./locale/<lang>/LC_MESSAGES`` directory. An example of one such file, from Sphinx, ``builders.po``, is given below. .. code-block:: po # a5600c3d2e3d48fc8c261ea0284db79b #: ../../builders.rst:4 msgid "Available builders" msgstr "<FILL HERE BY TARGET LANGUAGE>" Another case, msgid is multi-line text and contains reStructuredText syntax: .. code-block:: po # 302558364e1d41c69b3277277e34b184 #: ../../builders.rst:9 msgid "" "These are the built-in Sphinx builders. More builders can be added by " ":ref:`extensions <extensions>`." msgstr "" "FILL HERE BY TARGET LANGUAGE FILL HERE BY TARGET LANGUAGE FILL HERE " "BY TARGET LANGUAGE :ref:`EXTENSIONS <extensions>` FILL HERE." Please be careful not to break reST notation. Most po-editors will help you with that. #. Build translated document. You need a :confval:`language` parameter in ``conf.py`` or you may also specify the parameter on the command line. For for BSD/GNU make, run: .. code-block:: console $ make -e SPHINXOPTS="-D language='de'" html For Windows :command:`cmd.exe`, run: .. code-block:: console > set SPHINXOPTS=-D language=de > .\make.bat html For PowerShell, run: .. code-block:: console > Set-Item env:SPHINXOPTS "-D language=de" > .\make.bat html Congratulations! You got the translated documentation in the ``_build/html`` directory. .. versionadded:: 1.3 :program:`sphinx-build` that is invoked by make command will build po files into mo files. If you are using 1.2.x or earlier, please invoke :command:`sphinx-intl build` command before :command:`make` command. Translating ~~~~~~~~~~~ Update your po files by new pot files ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If a document is updated, it is necessary to generate updated pot files and to apply differences to translated po files. In order to apply the updates from a pot file to the po file, use the :command:`sphinx-intl update` command. .. code-block:: console $ sphinx-intl update -p _build/gettext Using Transifex service for team translation -------------------------------------------- Transifex_ is one of several services that allow collaborative translation via a web interface. It has a nifty Python-based command line client that makes it easy to fetch and push translations. .. TODO: why use transifex? #. Install `transifex-client`_. You need :command:`tx` command to upload resources (pot files). .. code-block:: console $ pip install transifex-client .. seealso:: `Transifex Client documentation`_ #. Create your transifex_ account and create new project for your document. Currently, transifex does not allow for a translation project to have more than one version of the document, so you'd better include a version number in your project name. For example: :Project ID: ``sphinx-document-test_1_0`` :Project URL: ``https://www.transifex.com/projects/p/sphinx-document-test_1_0/`` #. Create config files for :command:`tx` command. This process will create ``.tx/config`` in the current directory, as well as a ``~/.transifexrc`` file that includes auth information. .. code-block:: console $ tx init Creating .tx folder... Transifex instance [https://www.transifex.com]: ... Please enter your transifex username: <transifex-username> Password: <transifex-password> ... Done. #. Upload pot files to transifex service. Register pot files to ``.tx/config`` file: .. code-block:: console $ cd /your/document/root $ sphinx-intl update-txconfig-resources --pot-dir _build/locale \ --transifex-project-name sphinx-document-test_1_0 and upload pot files: .. code-block:: console $ tx push -s Pushing translations for resource sphinx-document-test_1_0.builders: Pushing source file (locale/pot/builders.pot) Resource does not exist. Creating... ... Done. #. Forward the translation on transifex. .. TODO: write this section #. Pull translated po files and make translated HTML. Get translated catalogs and build mo files. For example, to build mo files for German (de): .. code-block:: console $ cd /your/document/root $ tx pull -l de Pulling translations for resource sphinx-document-test_1_0.builders (...) -> de: locale/de/LC_MESSAGES/builders.po ... Done. Invoke :command:`make html` (for BSD/GNU make): .. code-block:: console $ make -e SPHINXOPTS="-D language='de'" html That's all! .. tip:: Translating locally and on Transifex If you want to push all language's po files, you can be done by using :command:`tx push -t` command. Watch out! This operation overwrites translations in transifex. In other words, if you have updated each in the service and local po files, it would take much time and effort to integrate them. Contributing to Sphinx reference translation -------------------------------------------- The recommended way for new contributors to translate Sphinx reference is to join the translation team on Transifex. There is a `sphinx translation page`_ for Sphinx (master) documentation. 1. Login to transifex_ service. 2. Go to `sphinx translation page`_. 3. Click ``Request language`` and fill form. 4. Wait acceptance by transifex sphinx translation maintainers. 5. (After acceptance) Translate on transifex. Detail is here: https://docs.transifex.com/getting-started-1/translators .. rubric:: Footnotes .. [1] See the `GNU gettext utilities <https://www.gnu.org/software/gettext/manual/gettext.html#Introduction>`_ for details on that software suite. .. [2] Because nobody expects the Spanish Inquisition! .. _`transifex-client`: https://pypi.org/project/transifex-client/ .. _`sphinx-intl`: https://pypi.org/project/sphinx-intl/ .. _Transifex: https://www.transifex.com/ .. _`sphinx translation page`: https://www.transifex.com/sphinx-doc/sphinx-doc/ .. _`Transifex Client documentation`: https://docs.transifex.com/client/introduction/ ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/advanced/setuptools.rst������������������������������������������������������0000644�0000766�0000024�00000012023�00000000000�020722� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. _setuptools: Setuptools integration ====================== Sphinx supports integration with setuptools and distutils through a custom command - :class:`~sphinx.setup_command.BuildDoc`. Using setuptools integration ---------------------------- The Sphinx build can then be triggered from distutils, and some Sphinx options can be set in ``setup.py`` or ``setup.cfg`` instead of Sphinx's own configuration file. For instance, from ``setup.py``:: # this is only necessary when not using setuptools/distribute from sphinx.setup_command import BuildDoc cmdclass = {'build_sphinx': BuildDoc} name = 'My project' version = '1.2' release = '1.2.0' setup( name=name, author='Bernard Montgomery', version=release, cmdclass=cmdclass, # these are optional and override conf.py settings command_options={ 'build_sphinx': { 'project': ('setup.py', name), 'version': ('setup.py', version), 'release': ('setup.py', release), 'source_dir': ('setup.py', 'doc')}}, ) .. note:: If you set Sphinx options directly in the ``setup()`` command, replace hyphens in variable names with underscores. In the example above, ``source-dir`` becomes ``source_dir``. Or add this section in ``setup.cfg``:: [build_sphinx] project = 'My project' version = 1.2 release = 1.2.0 source-dir = 'doc' Once configured, call this by calling the relevant command on ``setup.py``:: $ python setup.py build_sphinx Options for setuptools integration ---------------------------------- .. setuptools-confval:: fresh-env A boolean that determines whether the saved environment should be discarded on build. Default is false. This can also be set by passing the `-E` flag to ``setup.py``: .. code-block:: bash $ python setup.py build_sphinx -E .. setuptools-confval:: all-files A boolean that determines whether all files should be built from scratch. Default is false. This can also be set by passing the `-a` flag to ``setup.py``: .. code-block:: bash $ python setup.py build_sphinx -a .. setuptools-confval:: source-dir The target source directory. This can be relative to the ``setup.py`` or ``setup.cfg`` file, or it can be absolute. It defaults to ``./doc`` or ``./docs`` if either contains a file named ``conf.py`` (checking ``./doc`` first); otherwise it defaults to the current directory. This can also be set by passing the `-s` flag to ``setup.py``: .. code-block:: bash $ python setup.py build_sphinx -s $SOURCE_DIR .. setuptools-confval:: build-dir The target build directory. This can be relative to the ``setup.py`` or ``setup.cfg`` file, or it can be absolute. Default is ``./build/sphinx``. .. setuptools-confval:: config-dir Location of the configuration directory. This can be relative to the ``setup.py`` or ``setup.cfg`` file, or it can be absolute. Default is to use `source-dir`. This can also be set by passing the `-c` flag to ``setup.py``: .. code-block:: bash $ python setup.py build_sphinx -c $CONFIG_DIR .. versionadded:: 1.0 .. setuptools-confval:: builder The builder or list of builders to use. Default is ``html``. This can also be set by passing the `-b` flag to ``setup.py``: .. code-block:: bash $ python setup.py build_sphinx -b $BUILDER .. versionchanged:: 1.6 This can now be a comma- or space-separated list of builders .. setuptools-confval:: warning-is-error A boolean that ensures Sphinx warnings will result in a failed build. Default is false. This can also be set by passing the `-W` flag to ``setup.py``: .. code-block:: bash $ python setup.py build_sphinx -W .. versionadded:: 1.5 .. setuptools-confval:: project The documented project's name. Default is ``''``. .. versionadded:: 1.0 .. setuptools-confval:: version The short X.Y version. Default is ``''``. .. versionadded:: 1.0 .. setuptools-confval:: release The full version, including alpha/beta/rc tags. Default is ``''``. .. versionadded:: 1.0 .. setuptools-confval:: today How to format the current date, used as the replacement for ``|today|``. Default is ``''``. .. versionadded:: 1.0 .. setuptools-confval:: link-index A boolean that ensures index.html will be linked to the root doc. Default is false. This can also be set by passing the `-i` flag to ``setup.py``: .. code-block:: bash $ python setup.py build_sphinx -i .. versionadded:: 1.0 .. setuptools-confval:: copyright The copyright string. Default is ``''``. .. versionadded:: 1.3 .. setuptools-confval:: nitpicky Run in nit-picky mode. Currently, this generates warnings for all missing references. See the config value :confval:`nitpick_ignore` for a way to exclude some references as "known missing". .. versionadded:: 1.8 .. setuptools-confval:: pdb A boolean to configure ``pdb`` on exception. Default is false. .. versionadded:: 1.5 �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4239955 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/advanced/websupport/���������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�020163� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163739.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/advanced/websupport/api.rst��������������������������������������������������0000644�0000766�0000024�00000005156�00000000000�021475� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. _websupportapi: .. currentmodule:: sphinxcontrib.websupport The WebSupport Class ==================== .. class:: WebSupport The main API class for the web support package. All interactions with the web support package should occur through this class. The class takes the following keyword arguments: srcdir The directory containing reStructuredText source files. builddir The directory that build data and static files should be placed in. This should be used when creating a :class:`WebSupport` object that will be used to build data. datadir The directory that the web support data is in. This should be used when creating a :class:`WebSupport` object that will be used to retrieve data. search This may contain either a string (e.g. 'xapian') referencing a built-in search adapter to use, or an instance of a subclass of :class:`~.search.BaseSearch`. storage This may contain either a string representing a database uri, or an instance of a subclass of :class:`~.storage.StorageBackend`. If this is not provided, a new sqlite database will be created. moderation_callback A callable to be called when a new comment is added that is not displayed. It must accept one argument: a dictionary representing the comment that was added. staticdir If the static files should be created in a different location **and not in** ``'/static'``, this should be a string with the name of that location (e.g. ``builddir + '/static_files'``). .. note:: If you specify ``staticdir``, you will typically want to adjust ``staticroot`` accordingly. staticroot If the static files are not served from ``'/static'``, this should be a string with the name of that location (e.g. ``'/static_files'``). docroot If the documentation is not served from the base path of a URL, this should be a string specifying that path (e.g. ``'docs'``). .. versionchanged:: 1.6 WebSupport class is moved to sphinxcontrib.websupport from sphinx.websupport. Please add ``sphinxcontrib-websupport`` package in your dependency and use moved class instead. Methods ------- .. automethod:: sphinxcontrib.websupport.WebSupport.build .. automethod:: sphinxcontrib.websupport.WebSupport.get_document .. automethod:: sphinxcontrib.websupport.WebSupport.get_data .. automethod:: sphinxcontrib.websupport.WebSupport.add_comment .. automethod:: sphinxcontrib.websupport.WebSupport.process_vote .. automethod:: sphinxcontrib.websupport.WebSupport.get_search_results ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163739.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/advanced/websupport/index.rst������������������������������������������������0000644�0000766�0000024�00000000456�00000000000�022031� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. _websupport: Sphinx Web Support ================== .. versionadded:: 1.1 Sphinx provides a Python API to easily integrate Sphinx documentation into your web application. To learn more read the :ref:`websupportquickstart`. .. toctree:: quickstart api searchadapters storagebackends ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/advanced/websupport/quickstart.rst�������������������������������������������0000644�0000766�0000024�00000022634�00000000000�023116� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. _websupportquickstart: Web Support Quick Start ======================= Building Documentation Data ---------------------------- To make use of the web support package in your application you'll need to build the data it uses. This data includes pickle files representing documents, search indices, and node data that is used to track where comments and other things are in a document. To do this you will need to create an instance of the :class:`~.WebSupport` class and call its :meth:`~.WebSupport.build` method:: from sphinxcontrib.websupport import WebSupport support = WebSupport(srcdir='/path/to/rst/sources/', builddir='/path/to/build/outdir', search='xapian') support.build() This will read reStructuredText sources from ``srcdir`` and place the necessary data in ``builddir``. The ``builddir`` will contain two sub-directories: one named "data" that contains all the data needed to display documents, search through documents, and add comments to documents. The other directory will be called "static" and contains static files that should be served from "/static". .. note:: If you wish to serve static files from a path other than "/static", you can do so by providing the *staticdir* keyword argument when creating the :class:`~.WebSupport` object. Integrating Sphinx Documents Into Your Webapp ---------------------------------------------- Now that the data is built, it's time to do something useful with it. Start off by creating a :class:`~.WebSupport` object for your application:: from sphinxcontrib.websupport import WebSupport support = WebSupport(datadir='/path/to/the/data', search='xapian') You'll only need one of these for each set of documentation you will be working with. You can then call its :meth:`~.WebSupport.get_document` method to access individual documents:: contents = support.get_document('contents') This will return a dictionary containing the following items: * **body**: The main body of the document as HTML * **sidebar**: The sidebar of the document as HTML * **relbar**: A div containing links to related documents * **title**: The title of the document * **css**: Links to CSS files used by Sphinx * **script**: JavaScript containing comment options This dict can then be used as context for templates. The goal is to be easy to integrate with your existing templating system. An example using `Jinja2 <https://jinja.palletsprojects.com/>`_ is: .. code-block:: html+jinja {%- extends "layout.html" %} {%- block title %} {{ document.title }} {%- endblock %} {% block css %} {{ super() }} {{ document.css|safe }} <link rel="stylesheet" href="/static/websupport-custom.css" type="text/css"> {% endblock %} {%- block script %} {{ super() }} {{ document.script|safe }} {%- endblock %} {%- block relbar %} {{ document.relbar|safe }} {%- endblock %} {%- block body %} {{ document.body|safe }} {%- endblock %} {%- block sidebar %} {{ document.sidebar|safe }} {%- endblock %} Authentication ~~~~~~~~~~~~~~ To use certain features such as voting, it must be possible to authenticate users. The details of the authentication are left to your application. Once a user has been authenticated you can pass the user's details to certain :class:`~.WebSupport` methods using the *username* and *moderator* keyword arguments. The web support package will store the username with comments and votes. The only caveat is that if you allow users to change their username you must update the websupport package's data:: support.update_username(old_username, new_username) *username* should be a unique string which identifies a user, and *moderator* should be a boolean representing whether the user has moderation privileges. The default value for *moderator* is ``False``. An example `Flask <https://flask.palletsprojects.com/>`_ function that checks whether a user is logged in and then retrieves a document is:: from sphinxcontrib.websupport.errors import * @app.route('/<path:docname>') def doc(docname): username = g.user.name if g.user else '' moderator = g.user.moderator if g.user else False try: document = support.get_document(docname, username, moderator) except DocumentNotFoundError: abort(404) return render_template('doc.html', document=document) The first thing to notice is that the *docname* is just the request path. This makes accessing the correct document easy from a single view. If the user is authenticated, then the username and moderation status are passed along with the docname to :meth:`~.WebSupport.get_document`. The web support package will then add this data to the ``COMMENT_OPTIONS`` that are used in the template. .. note:: This only works if your documentation is served from your document root. If it is served from another directory, you will need to prefix the url route with that directory, and give the `docroot` keyword argument when creating the web support object:: support = WebSupport(..., docroot='docs') @app.route('/docs/<path:docname>') Performing Searches ------------------- To use the search form built-in to the Sphinx sidebar, create a function to handle requests to the URL 'search' relative to the documentation root. The user's search query will be in the GET parameters, with the key `q`. Then use the :meth:`~sphinxcontrib.websupport.WebSupport.get_search_results` method to retrieve search results. In `Flask <https://flask.palletsprojects.com/>`_ that would be like this:: @app.route('/search') def search(): q = request.args.get('q') document = support.get_search_results(q) return render_template('doc.html', document=document) Note that we used the same template to render our search results as we did to render our documents. That's because :meth:`~.WebSupport.get_search_results` returns a context dict in the same format that :meth:`~.WebSupport.get_document` does. Comments & Proposals -------------------- Now that this is done it's time to define the functions that handle the AJAX calls from the script. You will need three functions. The first function is used to add a new comment, and will call the web support method :meth:`~.WebSupport.add_comment`:: @app.route('/docs/add_comment', methods=['POST']) def add_comment(): parent_id = request.form.get('parent', '') node_id = request.form.get('node', '') text = request.form.get('text', '') proposal = request.form.get('proposal', '') username = g.user.name if g.user is not None else 'Anonymous' comment = support.add_comment(text, node_id='node_id', parent_id='parent_id', username=username, proposal=proposal) return jsonify(comment=comment) You'll notice that both a ``parent_id`` and ``node_id`` are sent with the request. If the comment is being attached directly to a node, ``parent_id`` will be empty. If the comment is a child of another comment, then ``node_id`` will be empty. Then next function handles the retrieval of comments for a specific node, and is aptly named :meth:`~sphinxcontrib.websupport.WebSupport.get_data`:: @app.route('/docs/get_comments') def get_comments(): username = g.user.name if g.user else None moderator = g.user.moderator if g.user else False node_id = request.args.get('node', '') data = support.get_data(node_id, username, moderator) return jsonify(**data) The final function that is needed will call :meth:`~.WebSupport.process_vote`, and will handle user votes on comments:: @app.route('/docs/process_vote', methods=['POST']) def process_vote(): if g.user is None: abort(401) comment_id = request.form.get('comment_id') value = request.form.get('value') if value is None or comment_id is None: abort(400) support.process_vote(comment_id, g.user.id, value) return "success" Comment Moderation ------------------ By default, all comments added through :meth:`~.WebSupport.add_comment` are automatically displayed. If you wish to have some form of moderation, you can pass the ``displayed`` keyword argument:: comment = support.add_comment(text, node_id='node_id', parent_id='parent_id', username=username, proposal=proposal, displayed=False) You can then create a new view to handle the moderation of comments. It will be called when a moderator decides a comment should be accepted and displayed:: @app.route('/docs/accept_comment', methods=['POST']) def accept_comment(): moderator = g.user.moderator if g.user else False comment_id = request.form.get('id') support.accept_comment(comment_id, moderator=moderator) return 'OK' Rejecting comments happens via comment deletion. To perform a custom action (such as emailing a moderator) when a new comment is added but not displayed, you can pass callable to the :class:`~.WebSupport` class when instantiating your support object:: def moderation_callback(comment): """Do something...""" support = WebSupport(..., moderation_callback=moderation_callback) The moderation callback must take one argument, which will be the same comment dict that is returned by :meth:`add_comment`. ����������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163739.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/advanced/websupport/searchadapters.rst���������������������������������������0000644�0000766�0000024�00000002530�00000000000�023706� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. _searchadapters: .. currentmodule:: sphinxcontrib.websupport.search Search Adapters =============== To create a custom search adapter you will need to subclass the :class:`BaseSearch` class. Then create an instance of the new class and pass that as the `search` keyword argument when you create the :class:`~.WebSupport` object:: support = WebSupport(srcdir=srcdir, builddir=builddir, search=MySearch()) For more information about creating a custom search adapter, please see the documentation of the :class:`BaseSearch` class below. .. class:: BaseSearch Defines an interface for search adapters. .. versionchanged:: 1.6 BaseSearch class is moved to sphinxcontrib.websupport.search from sphinx.websupport.search. Methods ------- The following methods are defined in the BaseSearch class. Some methods do not need to be overridden, but some (:meth:`~BaseSearch.add_document` and :meth:`~BaseSearch.handle_query`) must be overridden in your subclass. For a working example, look at the built-in adapter for whoosh. .. automethod:: BaseSearch.init_indexing .. automethod:: BaseSearch.finish_indexing .. automethod:: BaseSearch.feed .. automethod:: BaseSearch.add_document .. automethod:: BaseSearch.query .. automethod:: BaseSearch.handle_query .. automethod:: BaseSearch.extract_context ������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163739.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/advanced/websupport/storagebackends.rst��������������������������������������0000644�0000766�0000024�00000002317�00000000000�024057� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. _storagebackends: .. currentmodule:: sphinxcontrib.websupport.storage Storage Backends ================ To create a custom storage backend you will need to subclass the :class:`StorageBackend` class. Then create an instance of the new class and pass that as the `storage` keyword argument when you create the :class:`~.WebSupport` object:: support = WebSupport(srcdir=srcdir, builddir=builddir, storage=MyStorage()) For more information about creating a custom storage backend, please see the documentation of the :class:`StorageBackend` class below. .. class:: StorageBackend Defines an interface for storage backends. .. versionchanged:: 1.6 StorageBackend class is moved to sphinxcontrib.websupport.storage from sphinx.websupport.storage. Methods ------- .. automethod:: StorageBackend.pre_build .. automethod:: StorageBackend.add_node .. automethod:: StorageBackend.post_build .. automethod:: StorageBackend.add_comment .. automethod:: StorageBackend.delete_comment .. automethod:: StorageBackend.get_data .. automethod:: StorageBackend.process_vote .. automethod:: StorageBackend.update_username .. automethod:: StorageBackend.accept_comment �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.424521 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/builders/��������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016015� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/builders/index.rst�����������������������������������������������������������0000644�0000766�0000024�00000043117�00000000000�017664� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. _builders: ======== Builders ======== .. module:: sphinx.builders :synopsis: Available built-in builder classes. These are the built-in Sphinx builders. More builders can be added by :doc:`extensions </usage/extensions/index>`. The builder's "name" must be given to the **-b** command-line option of :program:`sphinx-build` to select a builder. .. module:: sphinx.builders.html .. class:: StandaloneHTMLBuilder This is the standard HTML builder. Its output is a directory with HTML files, complete with style sheets and optionally the reST sources. There are quite a few configuration values that customize the output of this builder, see the chapter :ref:`html-options` for details. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. module:: sphinx.builders.dirhtml .. class:: DirectoryHTMLBuilder This is a subclass of the standard HTML builder. Its output is a directory with HTML files, where each file is called ``index.html`` and placed in a subdirectory named like its page name. For example, the document ``markup/rest.rst`` will not result in an output file ``markup/rest.html``, but ``markup/rest/index.html``. When generating links between pages, the ``index.html`` is omitted, so that the URL would look like ``markup/rest/``. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. versionadded:: 0.6 .. module:: sphinx.builders.singlehtml .. class:: SingleFileHTMLBuilder This is an HTML builder that combines the whole project in one output file. (Obviously this only works with smaller projects.) The file is named like the root document. No indices will be generated. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. versionadded:: 1.0 .. module:: sphinxcontrib.htmlhelp .. class:: HTMLHelpBuilder This builder produces the same output as the standalone HTML builder, but also generates HTML Help support files that allow the Microsoft HTML Help Workshop to compile them into a CHM file. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. module:: sphinxcontrib.qthelp .. class:: QtHelpBuilder This builder produces the same output as the standalone HTML builder, but also generates `Qt help`_ collection support files that allow the Qt collection generator to compile them. .. versionchanged:: 2.0 Moved to sphinxcontrib.qthelp from sphinx.builders package. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. _Qt help: https://doc.qt.io/qt-4.8/qthelp-framework.html .. module:: sphinxcontrib.applehelp .. class:: AppleHelpBuilder This builder produces an Apple Help Book based on the same output as the standalone HTML builder. If the source directory contains any ``.lproj`` folders, the one corresponding to the selected language will have its contents merged with the generated output. These folders will be ignored by all other documentation types. In order to generate a valid help book, this builder requires the command line tool :program:`hiutil`, which is only available on Mac OS X 10.6 and above. You can disable the indexing step by setting :confval:`applehelp_disable_external_tools` to ``True``, in which case the output will not be valid until :program:`hiutil` has been run on all of the ``.lproj`` folders within the bundle. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. versionadded:: 1.3 .. versionchanged:: 2.0 Moved to sphinxcontrib.applehelp from sphinx.builders package. .. module:: sphinxcontrib.devhelp .. class:: DevhelpBuilder This builder produces the same output as the standalone HTML builder, but also generates `GNOME Devhelp <https://wiki.gnome.org/Apps/Devhelp>`__ support file that allows the GNOME Devhelp reader to view them. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. versionchanged:: 2.0 Moved to sphinxcontrib.devhelp from sphinx.builders package. .. module:: sphinx.builders.epub3 .. class:: Epub3Builder This builder produces the same output as the standalone HTML builder, but also generates an *epub* file for ebook readers. See :ref:`epub-faq` for details about it. For definition of the epub format, have a look at `<http://idpf.org/epub>`_ or `<https://en.wikipedia.org/wiki/EPUB>`_. The builder creates *EPUB 3* files. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. versionadded:: 1.4 .. versionchanged:: 1.5 Since Sphinx-1.5, the epub3 builder is used for the default builder of epub. .. module:: sphinx.builders.latex .. class:: LaTeXBuilder This builder produces a bunch of LaTeX files in the output directory. You have to specify which documents are to be included in which LaTeX files via the :confval:`latex_documents` configuration value. There are a few configuration values that customize the output of this builder, see the chapter :ref:`latex-options` for details. The produced LaTeX file uses several LaTeX packages that may not be present in a "minimal" TeX distribution installation. On Ubuntu xenial, the following packages need to be installed for successful PDF builds: * ``texlive-latex-recommended`` * ``texlive-fonts-recommended`` * ``tex-gyre`` (if :confval:`latex_engine` is ``'pdflatex'``) * ``texlive-latex-extra`` * ``latexmk`` (this is a Sphinx requirement on GNU/Linux and MacOS X for functioning of ``make latexpdf``) Additional packages are needed in some circumstances (see the discussion of the ``'fontpkg'`` key of :confval:`latex_elements` for more information): * ``texlive-lang-cyrillic`` for Cyrillic (even individual letters), and, ``cm-super`` or ``cm-super-minimal`` (if default fonts), * ``texlive-lang-greek`` for Greek (even individual letters), and, ``cm-super`` or ``cm-super-minimal`` (if default fonts), * ``texlive-xetex`` if :confval:`latex_engine` is ``'xelatex'``, * ``texlive-luatex`` if :confval:`latex_engine` is ``'lualatex'``, * ``fonts-freefont-otf`` if :confval:`latex_engine` is ``'xelatex'`` or ``'lualatex'``. The testing of Sphinx LaTeX is done on Ubuntu xenial whose TeX distribution is based on a TeXLive 2015 snapshot dated March 2016. .. versionchanged:: 1.6 Formerly, testing had been done on Ubuntu precise (TeXLive 2009). .. versionchanged:: 2.0 Formerly, testing had been done on Ubuntu trusty (TeXLive 2013). .. versionchanged:: 4.0.0 TeX Gyre fonts dependency for the default LaTeX font configuration. .. note:: Since 1.6, ``make latexpdf`` uses ``latexmk`` (not on Windows). This makes sure the needed number of runs is automatically executed to get the cross-references, bookmarks, indices, and tables of contents right. One can pass to ``latexmk`` options via the ``LATEXMKOPTS`` Makefile variable. For example: .. code-block:: console make latexpdf LATEXMKOPTS="-silent" reduces console output to a minimum. Also, if ``latexmk`` is at version 4.52b or higher (January 2017) ``LATEXMKOPTS="-xelatex"`` speeds up PDF builds via XeLateX in case of numerous graphics inclusions. To pass options directly to the ``(pdf|xe|lua)latex`` binary, use variable ``LATEXOPTS``, for example: .. code-block:: console make latexpdf LATEXOPTS="--halt-on-error" .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types Note that a direct PDF builder is being provided by `rinohtype`_. The builder's name is ``rinoh``. Refer to the `rinohtype manual`_ for details. .. _rinohtype: https://github.com/brechtm/rinohtype .. _rinohtype manual: https://www.mos6581.org/rinohtype/quickstart.html#sphinx-builder .. module:: sphinx.builders.text .. class:: TextBuilder This builder produces a text file for each reST file -- this is almost the same as the reST source, but with much of the markup stripped for better readability. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. versionadded:: 0.4 .. module:: sphinx.builders.manpage .. class:: ManualPageBuilder This builder produces manual pages in the groff format. You have to specify which documents are to be included in which manual pages via the :confval:`man_pages` configuration value. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. versionadded:: 1.0 .. module:: sphinx.builders.texinfo .. class:: TexinfoBuilder This builder produces Texinfo files that can be processed into Info files by the :program:`makeinfo` program. You have to specify which documents are to be included in which Texinfo files via the :confval:`texinfo_documents` configuration value. The Info format is the basis of the on-line help system used by GNU Emacs and the terminal-based program :program:`info`. See :ref:`texinfo-faq` for more details. The Texinfo format is the official documentation system used by the GNU project. More information on Texinfo can be found at `<https://www.gnu.org/software/texinfo/>`_. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. versionadded:: 1.1 .. currentmodule:: sphinxcontrib.serializinghtml .. class:: SerializingHTMLBuilder This builder uses a module that implements the Python serialization API (`pickle`, `simplejson`, `phpserialize`, and others) to dump the generated HTML documentation. The pickle builder is a subclass of it. A concrete subclass of this builder serializing to the `PHP serialization`_ format could look like this:: import phpserialize class PHPSerializedBuilder(SerializingHTMLBuilder): name = 'phpserialized' implementation = phpserialize out_suffix = '.file.phpdump' globalcontext_filename = 'globalcontext.phpdump' searchindex_filename = 'searchindex.phpdump' .. _PHP serialization: https://pypi.org/project/phpserialize/ .. attribute:: implementation A module that implements `dump()`, `load()`, `dumps()` and `loads()` functions that conform to the functions with the same names from the pickle module. Known modules implementing this interface are `simplejson`, `phpserialize`, `plistlib`, and others. .. attribute:: out_suffix The suffix for all regular files. .. attribute:: globalcontext_filename The filename for the file that contains the "global context". This is a dict with some general configuration values such as the name of the project. .. attribute:: searchindex_filename The filename for the search index Sphinx generates. See :ref:`serialization-details` for details about the output format. .. versionadded:: 0.5 .. class:: PickleHTMLBuilder This builder produces a directory with pickle files containing mostly HTML fragments and TOC information, for use of a web application (or custom postprocessing tool) that doesn't use the standard HTML templates. See :ref:`serialization-details` for details about the output format. .. autoattribute:: name The old name ``web`` still works as well. .. autoattribute:: format .. autoattribute:: supported_image_types The file suffix is ``.fpickle``. The global context is called ``globalcontext.pickle``, the search index ``searchindex.pickle``. .. class:: JSONHTMLBuilder This builder produces a directory with JSON files containing mostly HTML fragments and TOC information, for use of a web application (or custom postprocessing tool) that doesn't use the standard HTML templates. See :ref:`serialization-details` for details about the output format. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types The file suffix is ``.fjson``. The global context is called ``globalcontext.json``, the search index ``searchindex.json``. .. versionadded:: 0.5 .. module:: sphinx.builders.gettext .. class:: MessageCatalogBuilder This builder produces gettext-style message catalogs. Each top-level file or subdirectory grows a single ``.pot`` catalog template. See the documentation on :ref:`intl` for further reference. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. versionadded:: 1.1 .. module:: sphinx.builders.changes .. class:: ChangesBuilder This builder produces an HTML overview of all :rst:dir:`versionadded`, :rst:dir:`versionchanged` and :rst:dir:`deprecated` directives for the current :confval:`version`. This is useful to generate a ChangeLog file, for example. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. module:: sphinx.builders.dummy .. class:: DummyBuilder This builder produces no output. The input is only parsed and checked for consistency. This is useful for linting purposes. .. autoattribute:: name .. autoattribute:: supported_image_types .. versionadded:: 1.4 .. module:: sphinx.builders.linkcheck .. class:: CheckExternalLinksBuilder This builder scans all documents for external links, tries to open them with ``requests``, and writes an overview which ones are broken and redirected to standard output and to :file:`output.txt` in the output directory. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. versionchanged:: 1.5 Since Sphinx-1.5, the linkcheck builder comes to use requests module. .. versionchanged:: 3.4 The linkcheck builder retries links when servers apply rate limits. .. module:: sphinx.builders.xml .. class:: XMLBuilder This builder produces Docutils-native XML files. The output can be transformed with standard XML tools such as XSLT processors into arbitrary final forms. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. versionadded:: 1.2 .. class:: PseudoXMLBuilder This builder is used for debugging the Sphinx/Docutils "Reader to Transform to Writer" pipeline. It produces compact pretty-printed "pseudo-XML", files where nesting is indicated by indentation (no end-tags). External attributes for all elements are output, and internal attributes for any leftover "pending" elements are also given. .. autoattribute:: name .. autoattribute:: format .. autoattribute:: supported_image_types .. versionadded:: 1.2 Built-in Sphinx extensions that offer more builders are: * :mod:`~sphinx.ext.doctest` * :mod:`~sphinx.ext.coverage` .. _serialization-details: Serialization builder details ----------------------------- All serialization builders outputs one file per source file and a few special files. They also copy the reST source files in the directory ``_sources`` under the output directory. The :class:`.PickleHTMLBuilder` is a builtin subclass that implements the pickle serialization interface. The files per source file have the extensions of :attr:`~.SerializingHTMLBuilder.out_suffix`, and are arranged in directories just as the source files are. They unserialize to a dictionary (or dictionary like structure) with these keys: ``body`` The HTML "body" (that is, the HTML rendering of the source file), as rendered by the HTML translator. ``title`` The title of the document, as HTML (may contain markup). ``toc`` The table of contents for the file, rendered as an HTML ``<ul>``. ``display_toc`` A boolean that is ``True`` if the ``toc`` contains more than one entry. ``current_page_name`` The document name of the current file. ``parents``, ``prev`` and ``next`` Information about related chapters in the TOC tree. Each relation is a dictionary with the keys ``link`` (HREF for the relation) and ``title`` (title of the related document, as HTML). ``parents`` is a list of relations, while ``prev`` and ``next`` are a single relation. ``sourcename`` The name of the source file under ``_sources``. The special files are located in the root output directory. They are: :attr:`.SerializingHTMLBuilder.globalcontext_filename` A pickled dict with these keys: ``project``, ``copyright``, ``release``, ``version`` The same values as given in the configuration file. ``style`` :confval:`html_style`. ``last_updated`` Date of last build. ``builder`` Name of the used builder, in the case of pickles this is always ``'pickle'``. ``titles`` A dictionary of all documents' titles, as HTML strings. :attr:`.SerializingHTMLBuilder.searchindex_filename` An index that can be used for searching the documentation. It is a pickled list with these entries: * A list of indexed docnames. * A list of document titles, as HTML strings, in the same order as the first list. * A dict mapping word roots (processed by an English-language stemmer) to a list of integers, which are indices into the first list. ``environment.pickle`` The build environment. This is always a pickle file, independent of the builder and a copy of the environment that was used when the builder was started. .. todo:: Document common members. Unlike the other pickle files this pickle file requires that the ``sphinx`` package is available on unpickling. �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/configuration.rst������������������������������������������������������������0000644�0000766�0000024�00000264716�00000000000�017625� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: python .. _build-config: ============= Configuration ============= .. module:: conf :synopsis: Build configuration file. The :term:`configuration directory` must contain a file named :file:`conf.py`. This file (containing Python code) is called the "build configuration file" and contains (almost) all configuration needed to customize Sphinx input and output behavior. An optional file `docutils.conf`_ can be added to the configuration directory to adjust `Docutils`_ configuration if not otherwise overridden or set by Sphinx. .. _`docutils`: https://docutils.sourceforge.io/ .. _`docutils.conf`: https://docutils.sourceforge.io/docs/user/config.html The configuration file is executed as Python code at build time (using :func:`importlib.import_module`, and with the current directory set to its containing directory), and therefore can execute arbitrarily complex code. Sphinx then reads simple names from the file's namespace as its configuration. Important points to note: * If not otherwise documented, values must be strings, and their default is the empty string. * The term "fully-qualified name" refers to a string that names an importable Python object inside a module; for example, the FQN ``"sphinx.builders.Builder"`` means the ``Builder`` class in the ``sphinx.builders`` module. * Remember that document names use ``/`` as the path separator and don't contain the file name extension. * Since :file:`conf.py` is read as a Python file, the usual rules apply for encodings and Unicode support. * The contents of the config namespace are pickled (so that Sphinx can find out when configuration changes), so it may not contain unpickleable values -- delete them from the namespace with ``del`` if appropriate. Modules are removed automatically, so you don't need to ``del`` your imports after use. .. _conf-tags: * There is a special object named ``tags`` available in the config file. It can be used to query and change the tags (see :ref:`tags`). Use ``tags.has('tag')`` to query, ``tags.add('tag')`` and ``tags.remove('tag')`` to change. Only tags set via the ``-t`` command-line option or via ``tags.add('tag')`` can be queried using ``tags.has('tag')``. Note that the current builder tag is not available in ``conf.py``, as it is created *after* the builder is initialized. Project information ------------------- .. confval:: project The documented project's name. .. confval:: author The author name(s) of the document. The default value is ``'unknown'``. .. confval:: copyright A copyright statement in the style ``'2008, Author Name'``. .. confval:: project_copyright An alias of :confval:`copyright`. .. versionadded:: 3.5 .. confval:: version The major project version, used as the replacement for ``|version|``. For example, for the Python documentation, this may be something like ``2.6``. .. confval:: release The full project version, used as the replacement for ``|release|`` and e.g. in the HTML templates. For example, for the Python documentation, this may be something like ``2.6.0rc1``. If you don't need the separation provided between :confval:`version` and :confval:`release`, just set them both to the same value. General configuration --------------------- .. confval:: extensions A list of strings that are module names of :doc:`extensions <extensions/index>`. These can be extensions coming with Sphinx (named ``sphinx.ext.*``) or custom ones. Note that you can extend :data:`sys.path` within the conf file if your extensions live in another directory -- but make sure you use absolute paths. If your extension path is relative to the :term:`configuration directory`, use :func:`os.path.abspath` like so:: import sys, os sys.path.append(os.path.abspath('sphinxext')) extensions = ['extname'] That way, you can load an extension called ``extname`` from the subdirectory ``sphinxext``. The configuration file itself can be an extension; for that, you only need to provide a :func:`setup` function in it. .. confval:: source_suffix The file extensions of source files. Sphinx considers the files with this suffix as sources. The value can be a dictionary mapping file extensions to file types. For example:: source_suffix = { '.rst': 'restructuredtext', '.txt': 'restructuredtext', '.md': 'markdown', } By default, Sphinx only supports ``'restructuredtext'`` file type. You can add a new file type using source parser extensions. Please read a document of the extension to know which file type the extension supports. The value may also be a list of file extensions: then Sphinx will consider that they all map to the ``'restructuredtext'`` file type. Default is ``{'.rst': 'restructuredtext'}``. .. note:: file extensions have to start with a dot (e.g. ``.rst``). .. versionchanged:: 1.3 Can now be a list of extensions. .. versionchanged:: 1.8 Support file type mapping .. confval:: source_encoding The encoding of all reST source files. The recommended encoding, and the default value, is ``'utf-8-sig'``. .. versionadded:: 0.5 Previously, Sphinx accepted only UTF-8 encoded sources. .. confval:: source_parsers If given, a dictionary of parser classes for different source suffices. The keys are the suffix, the values can be either a class or a string giving a fully-qualified name of a parser class. The parser class can be either ``docutils.parsers.Parser`` or :class:`sphinx.parsers.Parser`. Files with a suffix that is not in the dictionary will be parsed with the default reStructuredText parser. For example:: source_parsers = {'.md': 'recommonmark.parser.CommonMarkParser'} .. note:: Refer to :doc:`/usage/markdown` for more information on using Markdown with Sphinx. .. versionadded:: 1.3 .. deprecated:: 1.8 Now Sphinx provides an API :meth:`.Sphinx.add_source_parser` to register a source parser. Please use it instead. .. confval:: master_doc Same as :confval:`root_doc`. .. versionchanged:: 4.0 Renamed ``master_doc`` to ``root_doc``. .. confval:: root_doc The document name of the "root" document, that is, the document that contains the root :rst:dir:`toctree` directive. Default is ``'index'``. .. versionchanged:: 2.0 The default is changed to ``'index'`` from ``'contents'``. .. versionchanged:: 4.0 Renamed ``root_doc`` from ``master_doc``. .. confval:: exclude_patterns A list of glob-style patterns that should be excluded when looking for source files. [1]_ They are matched against the source file names relative to the source directory, using slashes as directory separators on all platforms. Example patterns: - ``'library/xml.rst'`` -- ignores the ``library/xml.rst`` file (replaces entry in :confval:`unused_docs`) - ``'library/xml'`` -- ignores the ``library/xml`` directory - ``'library/xml*'`` -- ignores all files and directories starting with ``library/xml`` - ``'**/.svn'`` -- ignores all ``.svn`` directories :confval:`exclude_patterns` is also consulted when looking for static files in :confval:`html_static_path` and :confval:`html_extra_path`. .. versionadded:: 1.0 .. confval:: templates_path A list of paths that contain extra templates (or templates that overwrite builtin/theme-specific templates). Relative paths are taken as relative to the configuration directory. .. versionchanged:: 1.3 As these files are not meant to be built, they are automatically added to :confval:`exclude_patterns`. .. confval:: template_bridge A string with the fully-qualified name of a callable (or simply a class) that returns an instance of :class:`~sphinx.application.TemplateBridge`. This instance is then used to render HTML documents, and possibly the output of other builders (currently the changes builder). (Note that the template bridge must be made theme-aware if HTML themes are to be used.) .. confval:: rst_epilog .. index:: pair: global; substitutions A string of reStructuredText that will be included at the end of every source file that is read. This is a possible place to add substitutions that should be available in every file (another being :confval:`rst_prolog`). An example:: rst_epilog = """ .. |psf| replace:: Python Software Foundation """ .. versionadded:: 0.6 .. confval:: rst_prolog .. index:: pair: global; substitutions A string of reStructuredText that will be included at the beginning of every source file that is read. This is a possible place to add substitutions that should be available in every file (another being :confval:`rst_epilog`). An example:: rst_prolog = """ .. |psf| replace:: Python Software Foundation """ .. versionadded:: 1.0 .. confval:: primary_domain .. index:: default; domain primary; domain The name of the default :doc:`domain </usage/restructuredtext/domains>`. Can also be ``None`` to disable a default domain. The default is ``'py'``. Those objects in other domains (whether the domain name is given explicitly, or selected by a :rst:dir:`default-domain` directive) will have the domain name explicitly prepended when named (e.g., when the default domain is C, Python functions will be named "Python function", not just "function"). .. versionadded:: 1.0 .. confval:: default_role .. index:: default; role The name of a reST role (builtin or Sphinx extension) to use as the default role, that is, for text marked up ```like this```. This can be set to ``'py:obj'`` to make ```filter``` a cross-reference to the Python function "filter". The default is ``None``, which doesn't reassign the default role. The default role can always be set within individual documents using the standard reST :rst:dir:`default-role` directive. .. versionadded:: 0.4 .. confval:: keep_warnings If true, keep warnings as "system message" paragraphs in the built documents. Regardless of this setting, warnings are always written to the standard error stream when ``sphinx-build`` is run. The default is ``False``, the pre-0.5 behavior was to always keep them. .. versionadded:: 0.5 .. confval:: suppress_warnings A list of warning types to suppress arbitrary warning messages. Sphinx supports following warning types: * ``app.add_node`` * ``app.add_directive`` * ``app.add_role`` * ``app.add_generic_role`` * ``app.add_source_parser`` * ``download.not_readable`` * ``image.not_readable`` * ``ref.term`` * ``ref.ref`` * ``ref.numref`` * ``ref.keyword`` * ``ref.option`` * ``ref.citation`` * ``ref.footnote`` * ``ref.doc`` * ``ref.python`` * ``misc.highlighting_failure`` * ``toc.circular`` * ``toc.excluded`` * ``toc.not_readable`` * ``toc.secnum`` * ``epub.unknown_project_files`` * ``epub.duplicated_toc_entry`` * ``autosectionlabel.*`` You can choose from these types. Now, this option should be considered *experimental*. .. versionadded:: 1.4 .. versionchanged:: 1.5 Added ``misc.highlighting_failure`` .. versionchanged:: 1.5.1 Added ``epub.unknown_project_files`` .. versionchanged:: 1.6 Added ``ref.footnote`` .. versionchanged:: 2.1 Added ``autosectionlabel.*`` .. versionchanged:: 3.3.0 Added ``epub.duplicated_toc_entry`` .. versionchanged:: 4.3 Added ``toc.excluded`` and ``toc.not_readable`` .. confval:: needs_sphinx If set to a ``major.minor`` version string like ``'1.1'``, Sphinx will compare it with its version and refuse to build if it is too old. Default is no requirement. .. versionadded:: 1.0 .. versionchanged:: 1.4 also accepts micro version string .. confval:: needs_extensions This value can be a dictionary specifying version requirements for extensions in :confval:`extensions`, e.g. ``needs_extensions = {'sphinxcontrib.something': '1.5'}``. The version strings should be in the form ``major.minor``. Requirements do not have to be specified for all extensions, only for those you want to check. This requires that the extension specifies its version to Sphinx (see :ref:`dev-extensions` for how to do that). .. versionadded:: 1.3 .. confval:: manpages_url A URL to cross-reference :rst:role:`manpage` directives. If this is defined to ``https://manpages.debian.org/{path}``, the :literal:`:manpage:`man(1)`` role will link to <https://manpages.debian.org/man(1)>. The patterns available are: * ``page`` - the manual page (``man``) * ``section`` - the manual section (``1``) * ``path`` - the original manual page and section specified (``man(1)``) This also supports manpages specified as ``man.1``. .. note:: This currently affects only HTML writers but could be expanded in the future. .. versionadded:: 1.7 .. confval:: nitpicky If true, Sphinx will warn about *all* references where the target cannot be found. Default is ``False``. You can activate this mode temporarily using the :option:`-n <sphinx-build -n>` command-line switch. .. versionadded:: 1.0 .. confval:: nitpick_ignore A list of ``(type, target)`` tuples (by default empty) that should be ignored when generating warnings in "nitpicky mode". Note that ``type`` should include the domain name if present. Example entries would be ``('py:func', 'int')`` or ``('envvar', 'LD_LIBRARY_PATH')``. .. versionadded:: 1.1 .. confval:: nitpick_ignore_regex An extended version of :confval:`nitpick_ignore`, which instead interprets the ``type`` and ``target`` strings as regular expressions. Note, that the regular expression must match the whole string (as if the ``^`` and ``$`` markers were inserted). For example, ``(r'py:.*', r'foo.*bar\.B.*')`` will ignore nitpicky warnings for all python entities that start with ``'foo'`` and have ``'bar.B'`` in them, such as ``('py:const', 'foo_package.bar.BAZ_VALUE')`` or ``('py:class', 'food.bar.Barman')``. .. versionadded:: 4.1 .. confval:: numfig If true, figures, tables and code-blocks are automatically numbered if they have a caption. The :rst:role:`numref` role is enabled. Obeyed so far only by HTML and LaTeX builders. Default is ``False``. .. note:: The LaTeX builder always assigns numbers whether this option is enabled or not. .. versionadded:: 1.3 .. confval:: numfig_format A dictionary mapping ``'figure'``, ``'table'``, ``'code-block'`` and ``'section'`` to strings that are used for format of figure numbers. As a special character, ``%s`` will be replaced to figure number. Default is to use ``'Fig. %s'`` for ``'figure'``, ``'Table %s'`` for ``'table'``, ``'Listing %s'`` for ``'code-block'`` and ``'Section %s'`` for ``'section'``. .. versionadded:: 1.3 .. confval:: numfig_secnum_depth - if set to ``0``, figures, tables and code-blocks are continuously numbered starting at ``1``. - if ``1`` (default) numbers will be ``x.1``, ``x.2``, ... with ``x`` the section number (top level sectioning; no ``x.`` if no section). This naturally applies only if section numbering has been activated via the ``:numbered:`` option of the :rst:dir:`toctree` directive. - ``2`` means that numbers will be ``x.y.1``, ``x.y.2``, ... if located in a sub-section (but still ``x.1``, ``x.2``, ... if located directly under a section and ``1``, ``2``, ... if not in any top level section.) - etc... .. versionadded:: 1.3 .. versionchanged:: 1.7 The LaTeX builder obeys this setting (if :confval:`numfig` is set to ``True``). .. confval:: smartquotes If true, the `Docutils Smart Quotes transform`__, originally based on `SmartyPants`__ (limited to English) and currently applying to many languages, will be used to convert quotes and dashes to typographically correct entities. Default: ``True``. __ https://docutils.sourceforge.io/docs/user/smartquotes.html __ https://daringfireball.net/projects/smartypants/ .. versionadded:: 1.6.6 It replaces deprecated :confval:`html_use_smartypants`. It applies by default to all builders except ``man`` and ``text`` (see :confval:`smartquotes_excludes`.) A `docutils.conf`__ file located in the configuration directory (or a global :file:`~/.docutils` file) is obeyed unconditionally if it *deactivates* smart quotes via the corresponding `Docutils option`__. But if it *activates* them, then :confval:`smartquotes` does prevail. __ https://docutils.sourceforge.io/docs/user/config.html __ https://docutils.sourceforge.io/docs/user/config.html#smart-quotes .. confval:: smartquotes_action This string customizes the Smart Quotes transform. See the file :file:`smartquotes.py` at the `Docutils repository`__ for details. The default ``'qDe'`` educates normal **q**\ uote characters ``"``, ``'``, em- and en-**D**\ ashes ``---``, ``--``, and **e**\ llipses ``...``. .. versionadded:: 1.6.6 __ https://sourceforge.net/p/docutils/code/HEAD/tree/trunk/docutils/ .. confval:: smartquotes_excludes This is a ``dict`` whose default is:: {'languages': ['ja'], 'builders': ['man', 'text']} Each entry gives a sufficient condition to ignore the :confval:`smartquotes` setting and deactivate the Smart Quotes transform. Accepted keys are as above ``'builders'`` or ``'languages'``. The values are lists. .. note:: Currently, in case of invocation of :program:`make` with multiple targets, the first target name is the only one which is tested against the ``'builders'`` entry and it decides for all. Also, a ``make text`` following ``make html`` needs to be issued in the form ``make text O="-E"`` to force re-parsing of source files, as the cached ones are already transformed. On the other hand the issue does not arise with direct usage of :program:`sphinx-build` as it caches (in its default usage) the parsed source files in per builder locations. .. hint:: An alternative way to effectively deactivate (or customize) the smart quotes for a given builder, for example ``latex``, is to use ``make`` this way: .. code-block:: console make latex O="-D smartquotes_action=" This can follow some ``make html`` with no problem, in contrast to the situation from the prior note. It requires Docutils 0.14 or later. .. versionadded:: 1.6.6 .. confval:: user_agent A User-Agent of Sphinx. It is used for a header on HTTP access (ex. linkcheck, intersphinx and so on). Default is ``"Sphinx/X.Y.Z requests/X.Y.Z python/X.Y.Z"``. .. versionadded:: 2.3 .. confval:: tls_verify If true, Sphinx verifies server certifications. Default is ``True``. .. versionadded:: 1.5 .. confval:: tls_cacerts A path to a certification file of CA or a path to directory which contains the certificates. This also allows a dictionary mapping hostname to the path to certificate file. The certificates are used to verify server certifications. .. versionadded:: 1.5 .. tip:: Sphinx uses requests_ as a HTTP library internally. Therefore, Sphinx refers a certification file on the directory pointed ``REQUESTS_CA_BUNDLE`` environment variable if ``tls_cacerts`` not set. .. _requests: https://requests.readthedocs.io/en/master/ .. confval:: today today_fmt These values determine how to format the current date, used as the replacement for ``|today|``. * If you set :confval:`today` to a non-empty value, it is used. * Otherwise, the current time is formatted using :func:`time.strftime` and the format given in :confval:`today_fmt`. The default is now :confval:`today` and a :confval:`today_fmt` of ``'%b %d, %Y'`` (or, if translation is enabled with :confval:`language`, an equivalent format for the selected locale). .. confval:: highlight_language The default language to highlight source code in. The default is ``'default'``. It is similar to ``'python3'``; it is mostly a superset of ``'python'`` but it fallbacks to ``'none'`` without warning if failed. ``'python3'`` and other languages will emit warning if failed. The value should be a valid Pygments lexer name, see :ref:`code-examples` for more details. .. versionadded:: 0.5 .. versionchanged:: 1.4 The default is now ``'default'``. If you prefer Python 2 only highlighting, you can set it back to ``'python'``. .. confval:: highlight_options A dictionary that maps language names to options for the lexer modules of Pygments. These are lexer-specific; for the options understood by each, see the `Pygments documentation <https://pygments.org/docs/lexers>`_. Example:: highlight_options = { 'default': {'stripall': True}, 'php': {'startinline': True}, } A single dictionary of options are also allowed. Then it is recognized as options to the lexer specified by :confval:`highlight_language`:: # configuration for the ``highlight_language`` highlight_options = {'stripall': True} .. versionadded:: 1.3 .. versionchanged:: 3.5 Allow to configure highlight options for multiple languages .. confval:: pygments_style The style name to use for Pygments highlighting of source code. If not set, either the theme's default style or ``'sphinx'`` is selected for HTML output. .. versionchanged:: 0.3 If the value is a fully-qualified name of a custom Pygments style class, this is then used as custom style. .. confval:: add_function_parentheses A boolean that decides whether parentheses are appended to function and method role text (e.g. the content of ``:func:`input```) to signify that the name is callable. Default is ``True``. .. confval:: add_module_names A boolean that decides whether module names are prepended to all :term:`object` names (for object types where a "module" of some kind is defined), e.g. for :rst:dir:`py:function` directives. Default is ``True``. .. confval:: show_authors A boolean that decides whether :rst:dir:`codeauthor` and :rst:dir:`sectionauthor` directives produce any output in the built files. .. confval:: modindex_common_prefix A list of prefixes that are ignored for sorting the Python module index (e.g., if this is set to ``['foo.']``, then ``foo.bar`` is shown under ``B``, not ``F``). This can be handy if you document a project that consists of a single package. Works only for the HTML builder currently. Default is ``[]``. .. versionadded:: 0.6 .. confval:: trim_footnote_reference_space Trim spaces before footnote references that are necessary for the reST parser to recognize the footnote, but do not look too nice in the output. .. versionadded:: 0.6 .. confval:: trim_doctest_flags If true, doctest flags (comments looking like ``# doctest: FLAG, ...``) at the ends of lines and ``<BLANKLINE>`` markers are removed for all code blocks showing interactive Python sessions (i.e. doctests). Default is ``True``. See the extension :mod:`~sphinx.ext.doctest` for more possibilities of including doctests. .. versionadded:: 1.0 .. versionchanged:: 1.1 Now also removes ``<BLANKLINE>``. .. confval:: strip_signature_backslash Default is ``False``. When backslash stripping is enabled then every occurrence of ``\\`` in a domain directive will be changed to ``\``, even within string literals. This was the behaviour before version 3.0, and setting this variable to ``True`` will reinstate that behaviour. .. versionadded:: 3.0 .. _intl-options: Options for internationalization -------------------------------- These options influence Sphinx's *Native Language Support*. See the documentation on :ref:`intl` for details. .. confval:: language The code for the language the docs are written in. Any text automatically generated by Sphinx will be in that language. Also, Sphinx will try to substitute individual paragraphs from your documents with the translation sets obtained from :confval:`locale_dirs`. Sphinx will search language-specific figures named by :confval:`figure_language_filename` (e.g. the German version of ``myfigure.png`` will be ``myfigure.de.png`` by default setting) and substitute them for original figures. In the LaTeX builder, a suitable language will be selected as an option for the *Babel* package. Default is ``None``, which means that no translation will be done. .. versionadded:: 0.5 .. versionchanged:: 1.4 Support figure substitution Currently supported languages by Sphinx are: * ``ar`` -- Arabic * ``bg`` -- Bulgarian * ``bn`` -- Bengali * ``ca`` -- Catalan * ``cak`` -- Kaqchikel * ``cs`` -- Czech * ``cy`` -- Welsh * ``da`` -- Danish * ``de`` -- German * ``el`` -- Greek * ``en`` -- English * ``eo`` -- Esperanto * ``es`` -- Spanish * ``et`` -- Estonian * ``eu`` -- Basque * ``fa`` -- Iranian * ``fi`` -- Finnish * ``fr`` -- French * ``he`` -- Hebrew * ``hi`` -- Hindi * ``hi_IN`` -- Hindi (India) * ``hr`` -- Croatian * ``hu`` -- Hungarian * ``id`` -- Indonesian * ``it`` -- Italian * ``ja`` -- Japanese * ``ko`` -- Korean * ``lt`` -- Lithuanian * ``lv`` -- Latvian * ``mk`` -- Macedonian * ``nb_NO`` -- Norwegian Bokmal * ``ne`` -- Nepali * ``nl`` -- Dutch * ``pl`` -- Polish * ``pt`` -- Portuguese * ``pt_BR`` -- Brazilian Portuguese * ``pt_PT`` -- European Portuguese * ``ro`` -- Romanian * ``ru`` -- Russian * ``si`` -- Sinhala * ``sk`` -- Slovak * ``sl`` -- Slovenian * ``sq`` -- Albanian * ``sr`` -- Serbian * ``sr@latin`` -- Serbian (Latin) * ``sr_RS`` -- Serbian (Cyrillic) * ``sv`` -- Swedish * ``ta`` -- Tamil * ``te`` -- Telugu * ``tr`` -- Turkish * ``uk_UA`` -- Ukrainian * ``ur`` -- Urdu * ``vi`` -- Vietnamese * ``zh_CN`` -- Simplified Chinese * ``zh_TW`` -- Traditional Chinese .. confval:: locale_dirs .. versionadded:: 0.5 Directories in which to search for additional message catalogs (see :confval:`language`), relative to the source directory. The directories on this path are searched by the standard :mod:`gettext` module. Internal messages are fetched from a text domain of ``sphinx``; so if you add the directory :file:`./locale` to this setting, the message catalogs (compiled from ``.po`` format using :program:`msgfmt`) must be in :file:`./locale/{language}/LC_MESSAGES/sphinx.mo`. The text domain of individual documents depends on :confval:`gettext_compact`. The default is ``['locales']``. .. note:: The :option:`-v option for sphinx-build command <sphinx-build -v>` is useful to check the locale_dirs config works as expected. It emits debug messages if message catalog directory not found. .. versionchanged:: 1.5 Use ``locales`` directory as a default value .. confval:: gettext_allow_fuzzy_translations If true, "fuzzy" messages in the message catalogs are used for translation. The default is ``False``. .. versionadded:: 4.3 .. confval:: gettext_compact .. versionadded:: 1.1 If true, a document's text domain is its docname if it is a top-level project file and its very base directory otherwise. If set to string, all document's text domain is this string, making all documents use single text domain. By default, the document ``markup/code.rst`` ends up in the ``markup`` text domain. With this option set to ``False``, it is ``markup/code``. .. versionchanged:: 3.3 The string value is now accepted. .. confval:: gettext_uuid If true, Sphinx generates uuid information for version tracking in message catalogs. It is used for: * Add uid line for each msgids in .pot files. * Calculate similarity between new msgids and previously saved old msgids. This calculation takes a long time. If you want to accelerate the calculation, you can use ``python-levenshtein`` 3rd-party package written in C by using :command:`pip install python-levenshtein`. The default is ``False``. .. versionadded:: 1.3 .. confval:: gettext_location If true, Sphinx generates location information for messages in message catalogs. The default is ``True``. .. versionadded:: 1.3 .. confval:: gettext_auto_build If true, Sphinx builds mo file for each translation catalog files. The default is ``True``. .. versionadded:: 1.3 .. confval:: gettext_additional_targets To specify names to enable gettext extracting and translation applying for i18n additionally. You can specify below names: :index: index terms :literal-block: literal blocks (``::`` annotation and ``code-block`` directive) :doctest-block: doctest block :raw: raw content :image: image/figure uri For example: ``gettext_additional_targets = ['literal-block', 'image']``. The default is ``[]``. .. versionadded:: 1.3 .. versionchanged:: 4.0 The alt text for image is translated by default. .. confval:: figure_language_filename The filename format for language-specific figures. The default value is ``{root}.{language}{ext}``. It will be expanded to ``dirname/filename.en.png`` from ``.. image:: dirname/filename.png``. The available format tokens are: * ``{root}`` - the filename, including any path component, without the file extension, e.g. ``dirname/filename`` * ``{path}`` - the directory path component of the filename, with a trailing slash if non-empty, e.g. ``dirname/`` * ``{docpath}`` - the directory path component for the current document, with a trailing slash if non-empty. * ``{basename}`` - the filename without the directory path or file extension components, e.g. ``filename`` * ``{ext}`` - the file extension, e.g. ``.png`` * ``{language}`` - the translation language, e.g. ``en`` For example, setting this to ``{path}{language}/{basename}{ext}`` will expand to ``dirname/en/filename.png`` instead. .. versionadded:: 1.4 .. versionchanged:: 1.5 Added ``{path}`` and ``{basename}`` tokens. .. versionchanged:: 3.2 Added ``{docpath}`` token. .. _math-options: Options for Math ---------------- These options influence Math notations. .. confval:: math_number_all Set this option to ``True`` if you want all displayed math to be numbered. The default is ``False``. .. confval:: math_eqref_format A string used for formatting the labels of references to equations. The ``{number}`` place-holder stands for the equation number. Example: ``'Eq.{number}'`` gets rendered as, for example, ``Eq.10``. .. confval:: math_numfig If ``True``, displayed math equations are numbered across pages when :confval:`numfig` is enabled. The :confval:`numfig_secnum_depth` setting is respected. The :rst:role:`eq`, not :rst:role:`numref`, role must be used to reference equation numbers. Default is ``True``. .. versionadded:: 1.7 .. _html-options: Options for HTML output ----------------------- These options influence HTML as well as HTML Help output, and other builders that use Sphinx's HTMLWriter class. .. confval:: html_theme The "theme" that the HTML output should use. See the :doc:`section about theming </usage/theming>`. The default is ``'alabaster'``. .. versionadded:: 0.6 .. confval:: html_theme_options A dictionary of options that influence the look and feel of the selected theme. These are theme-specific. For the options understood by the builtin themes, see :ref:`this section <builtin-themes>`. .. versionadded:: 0.6 .. confval:: html_theme_path A list of paths that contain custom themes, either as subdirectories or as zip files. Relative paths are taken as relative to the configuration directory. .. versionadded:: 0.6 .. confval:: html_style The style sheet to use for HTML pages. A file of that name must exist either in Sphinx's :file:`static/` path, or in one of the custom paths given in :confval:`html_static_path`. Default is the stylesheet given by the selected theme. If you only want to add or override a few things compared to the theme's stylesheet, use CSS ``@import`` to import the theme's stylesheet. .. confval:: html_title The "title" for HTML documentation generated with Sphinx's own templates. This is appended to the ``<title>`` tag of individual pages, and used in the navigation bar as the "topmost" element. It defaults to :samp:`'{<project>} v{<revision>} documentation'`. .. confval:: html_short_title A shorter "title" for the HTML docs. This is used for links in the header and in the HTML Help docs. If not given, it defaults to the value of :confval:`html_title`. .. versionadded:: 0.4 .. confval:: html_baseurl The base URL which points to the root of the HTML documentation. It is used to indicate the location of document using `The Canonical Link Relation`_. Default: ``''``. .. _The Canonical Link Relation: https://tools.ietf.org/html/rfc6596 .. versionadded:: 1.8 .. confval:: html_codeblock_linenos_style The style of line numbers for code-blocks. * ``'table'`` -- display line numbers using ``<table>`` tag * ``'inline'`` -- display line numbers using ``<span>`` tag (default) .. versionadded:: 3.2 .. versionchanged:: 4.0 It defaults to ``'inline'``. .. deprecated:: 4.0 .. confval:: html_context A dictionary of values to pass into the template engine's context for all pages. Single values can also be put in this dictionary using the :option:`-A <sphinx-build -A>` command-line option of ``sphinx-build``. .. versionadded:: 0.5 .. confval:: html_logo If given, this must be the name of an image file (path relative to the :term:`configuration directory`) that is the logo of the docs, or URL that points an image file for the logo. It is placed at the top of the sidebar; its width should therefore not exceed 200 pixels. Default: ``None``. .. versionadded:: 0.4.1 The image file will be copied to the ``_static`` directory of the output HTML, but only if the file does not already exist there. .. versionchanged:: 4.0 Also accepts the URL for the logo file. .. confval:: html_favicon If given, this must be the name of an image file (path relative to the :term:`configuration directory`) that is the favicon of the docs, or URL that points an image file for the favicon. Modern browsers use this as the icon for tabs, windows and bookmarks. It should be a Windows-style icon file (``.ico``), which is 16x16 or 32x32 pixels large. Default: ``None``. .. versionadded:: 0.4 The image file will be copied to the ``_static`` directory of the output HTML, but only if the file does not already exist there. .. versionchanged:: 4.0 Also accepts the URL for the favicon. .. confval:: html_css_files A list of CSS files. The entry must be a *filename* string or a tuple containing the *filename* string and the *attributes* dictionary. The *filename* must be relative to the :confval:`html_static_path`, or a full URI with scheme like ``https://example.org/style.css``. The *attributes* is used for attributes of ``<link>`` tag. It defaults to an empty list. Example:: html_css_files = ['custom.css', 'https://example.com/css/custom.css', ('print.css', {'media': 'print'})] As a special attribute, *priority* can be set as an integer to load the CSS file earlier or lazier step. For more information, refer :meth:`Sphinx.add_css_files()`. .. versionadded:: 1.8 .. versionchanged:: 3.5 Support priority attribute .. confval:: html_js_files A list of JavaScript *filename*. The entry must be a *filename* string or a tuple containing the *filename* string and the *attributes* dictionary. The *filename* must be relative to the :confval:`html_static_path`, or a full URI with scheme like ``https://example.org/script.js``. The *attributes* is used for attributes of ``<script>`` tag. It defaults to an empty list. Example:: html_js_files = ['script.js', 'https://example.com/scripts/custom.js', ('custom.js', {'async': 'async'})] As a special attribute, *priority* can be set as an integer to load the CSS file earlier or lazier step. For more information, refer :meth:`Sphinx.add_css_files()`. .. versionadded:: 1.8 .. versionchanged:: 3.5 Support priority attribute .. confval:: html_static_path A list of paths that contain custom static files (such as style sheets or script files). Relative paths are taken as relative to the configuration directory. They are copied to the output's :file:`_static` directory after the theme's static files, so a file named :file:`default.css` will overwrite the theme's :file:`default.css`. As these files are not meant to be built, they are automatically excluded from source files. .. note:: For security reasons, dotfiles under ``html_static_path`` will not be copied. If you would like to copy them intentionally, please add each filepath to this setting:: html_static_path = ['_static', '_static/.htaccess'] Another way to do that, you can also use :confval:`html_extra_path`. It allows to copy dotfiles under the directories. .. versionchanged:: 0.4 The paths in :confval:`html_static_path` can now contain subdirectories. .. versionchanged:: 1.0 The entries in :confval:`html_static_path` can now be single files. .. versionchanged:: 1.8 The files under :confval:`html_static_path` are excluded from source files. .. confval:: html_extra_path A list of paths that contain extra files not directly related to the documentation, such as :file:`robots.txt` or :file:`.htaccess`. Relative paths are taken as relative to the configuration directory. They are copied to the output directory. They will overwrite any existing file of the same name. As these files are not meant to be built, they are automatically excluded from source files. .. versionadded:: 1.2 .. versionchanged:: 1.4 The dotfiles in the extra directory will be copied to the output directory. And it refers :confval:`exclude_patterns` on copying extra files and directories, and ignores if path matches to patterns. .. confval:: html_last_updated_fmt If this is not None, a 'Last updated on:' timestamp is inserted at every page bottom, using the given :func:`strftime` format. The empty string is equivalent to ``'%b %d, %Y'`` (or a locale-dependent equivalent). .. confval:: html_use_smartypants If true, quotes and dashes are converted to typographically correct entities. Default: ``True``. .. deprecated:: 1.6 To disable smart quotes, use rather :confval:`smartquotes`. .. confval:: html_add_permalinks Sphinx will add "permalinks" for each heading and description environment as paragraph signs that become visible when the mouse hovers over them. This value determines the text for the permalink; it defaults to ``"¶"``. Set it to ``None`` or the empty string to disable permalinks. .. versionadded:: 0.6 Previously, this was always activated. .. versionchanged:: 1.1 This can now be a string to select the actual text of the link. Previously, only boolean values were accepted. .. deprecated:: 3.5 This has been replaced by :confval:`html_permalinks` .. confval:: html_permalinks If true, Sphinx will add "permalinks" for each heading and description environment. Default: ``True``. .. versionadded:: 3.5 .. confval:: html_permalinks_icon A text for permalinks for each heading and description environment. HTML tags are allowed. Default: a paragraph sign; ``¶`` .. versionadded:: 3.5 .. confval:: html_sidebars Custom sidebar templates, must be a dictionary that maps document names to template names. The keys can contain glob-style patterns [1]_, in which case all matching documents will get the specified sidebars. (A warning is emitted when a more than one glob-style pattern matches for any document.) The values can be either lists or single strings. * If a value is a list, it specifies the complete list of sidebar templates to include. If all or some of the default sidebars are to be included, they must be put into this list as well. The default sidebars (for documents that don't match any pattern) are defined by theme itself. Builtin themes are using these templates by default: ``['localtoc.html', 'relations.html', 'sourcelink.html', 'searchbox.html']``. * If a value is a single string, it specifies a custom sidebar to be added between the ``'sourcelink.html'`` and ``'searchbox.html'`` entries. This is for compatibility with Sphinx versions before 1.0. .. deprecated:: 1.7 a single string value for ``html_sidebars`` will be removed in 2.0 Builtin sidebar templates that can be rendered are: * **localtoc.html** -- a fine-grained table of contents of the current document * **globaltoc.html** -- a coarse-grained table of contents for the whole documentation set, collapsed * **relations.html** -- two links to the previous and next documents * **sourcelink.html** -- a link to the source of the current document, if enabled in :confval:`html_show_sourcelink` * **searchbox.html** -- the "quick search" box Example:: html_sidebars = { '**': ['globaltoc.html', 'sourcelink.html', 'searchbox.html'], 'using/windows': ['windowssidebar.html', 'searchbox.html'], } This will render the custom template ``windowssidebar.html`` and the quick search box within the sidebar of the given document, and render the default sidebars for all other pages (except that the local TOC is replaced by the global TOC). .. versionadded:: 1.0 The ability to use globbing keys and to specify multiple sidebars. Note that this value only has no effect if the chosen theme does not possess a sidebar, like the builtin **scrolls** and **haiku** themes. .. confval:: html_additional_pages Additional templates that should be rendered to HTML pages, must be a dictionary that maps document names to template names. Example:: html_additional_pages = { 'download': 'customdownload.html', } This will render the template ``customdownload.html`` as the page ``download.html``. .. confval:: html_domain_indices If true, generate domain-specific indices in addition to the general index. For e.g. the Python domain, this is the global module index. Default is ``True``. This value can be a bool or a list of index names that should be generated. To find out the index name for a specific index, look at the HTML file name. For example, the Python module index has the name ``'py-modindex'``. .. versionadded:: 1.0 .. confval:: html_use_index If true, add an index to the HTML documents. Default is ``True``. .. versionadded:: 0.4 .. confval:: html_split_index If true, the index is generated twice: once as a single page with all the entries, and once as one page per starting letter. Default is ``False``. .. versionadded:: 0.4 .. confval:: html_copy_source If true, the reST sources are included in the HTML build as :file:`_sources/{name}`. The default is ``True``. .. confval:: html_show_sourcelink If true (and :confval:`html_copy_source` is true as well), links to the reST sources will be added to the sidebar. The default is ``True``. .. versionadded:: 0.6 .. confval:: html_sourcelink_suffix Suffix to be appended to source links (see :confval:`html_show_sourcelink`), unless they have this suffix already. Default is ``'.txt'``. .. versionadded:: 1.5 .. confval:: html_use_opensearch If nonempty, an `OpenSearch <https://github.com/dewitt/opensearch>`_ description file will be output, and all pages will contain a ``<link>`` tag referring to it. Since OpenSearch doesn't support relative URLs for its search page location, the value of this option must be the base URL from which these documents are served (without trailing slash), e.g. ``"https://docs.python.org"``. The default is ``''``. .. confval:: html_file_suffix This is the file name suffix for generated HTML files. The default is ``".html"``. .. versionadded:: 0.4 .. confval:: html_link_suffix Suffix for generated links to HTML files. The default is whatever :confval:`html_file_suffix` is set to; it can be set differently (e.g. to support different web server setups). .. versionadded:: 0.6 .. confval:: html_show_copyright If true, "(C) Copyright ..." is shown in the HTML footer. Default is ``True``. .. versionadded:: 1.0 .. confval:: html_show_sphinx If true, "Created using Sphinx" is shown in the HTML footer. Default is ``True``. .. versionadded:: 0.4 .. confval:: html_output_encoding Encoding of HTML output files. Default is ``'utf-8'``. Note that this encoding name must both be a valid Python encoding name and a valid HTML ``charset`` value. .. versionadded:: 1.0 .. confval:: html_compact_lists If true, a list all whose items consist of a single paragraph and/or a sub-list all whose items etc... (recursive definition) will not use the ``<p>`` element for any of its items. This is standard docutils behavior. Default: ``True``. .. versionadded:: 1.0 .. confval:: html_secnumber_suffix Suffix for section numbers. Default: ``". "``. Set to ``" "`` to suppress the final dot on section numbers. .. versionadded:: 1.0 .. confval:: html_search_language Language to be used for generating the HTML full-text search index. This defaults to the global language selected with :confval:`language`. If there is no support for this language, ``"en"`` is used which selects the English language. Support is present for these languages: * ``da`` -- Danish * ``nl`` -- Dutch * ``en`` -- English * ``fi`` -- Finnish * ``fr`` -- French * ``de`` -- German * ``hu`` -- Hungarian * ``it`` -- Italian * ``ja`` -- Japanese * ``no`` -- Norwegian * ``pt`` -- Portuguese * ``ro`` -- Romanian * ``ru`` -- Russian * ``es`` -- Spanish * ``sv`` -- Swedish * ``tr`` -- Turkish * ``zh`` -- Chinese .. admonition:: Accelerating build speed Each language (except Japanese) provides its own stemming algorithm. Sphinx uses a Python implementation by default. You can use a C implementation to accelerate building the index file. * `PorterStemmer <https://pypi.org/project/PorterStemmer/>`_ (``en``) * `PyStemmer <https://pypi.org/project/PyStemmer/>`_ (all languages) .. versionadded:: 1.1 With support for ``en`` and ``ja``. .. versionchanged:: 1.3 Added additional languages. .. confval:: html_search_options A dictionary with options for the search language support, empty by default. The meaning of these options depends on the language selected. The English support has no options. The Japanese support has these options: :type: _`type` is dotted module path string to specify Splitter implementation which should be derived from :class:`sphinx.search.ja.BaseSplitter`. If not specified or None is specified, ``'sphinx.search.ja.DefaultSplitter'`` will be used. You can choose from these modules: :'sphinx.search.ja.DefaultSplitter': TinySegmenter algorithm. This is default splitter. :'sphinx.search.ja.MecabSplitter': MeCab binding. To use this splitter, 'mecab' python binding or dynamic link library ('libmecab.so' for linux, 'libmecab.dll' for windows) is required. :'sphinx.search.ja.JanomeSplitter': Janome binding. To use this splitter, `Janome <https://pypi.org/project/Janome/>`_ is required. .. deprecated:: 1.6 ``'mecab'``, ``'janome'`` and ``'default'`` is deprecated. To keep compatibility, ``'mecab'``, ``'janome'`` and ``'default'`` are also acceptable. Other option values depend on splitter value which you choose. Options for ``'mecab'``: :dic_enc: _`dic_enc option` is the encoding for the MeCab algorithm. :dict: _`dict option` is the dictionary to use for the MeCab algorithm. :lib: _`lib option` is the library name for finding the MeCab library via ctypes if the Python binding is not installed. For example:: html_search_options = { 'type': 'mecab', 'dic_enc': 'utf-8', 'dict': '/path/to/mecab.dic', 'lib': '/path/to/libmecab.so', } Options for ``'janome'``: :user_dic: _`user_dic option` is the user dictionary file path for Janome. :user_dic_enc: _`user_dic_enc option` is the encoding for the user dictionary file specified by ``user_dic`` option. Default is 'utf8'. .. versionadded:: 1.1 .. versionchanged:: 1.4 html_search_options for Japanese is re-organized and any custom splitter can be used by `type`_ settings. The Chinese support has these options: * ``dict`` -- the ``jieba`` dictionary path if want to use custom dictionary. .. confval:: html_search_scorer The name of a JavaScript file (relative to the configuration directory) that implements a search results scorer. If empty, the default will be used. .. XXX describe interface for scorer here .. versionadded:: 1.2 .. confval:: html_scaled_image_link If true, images itself links to the original image if it doesn't have 'target' option or scale related options: 'scale', 'width', 'height'. The default is ``True``. Document authors can this feature manually with giving ``no-scaled-link`` class to the image: .. code-block:: rst .. image:: sphinx.png :scale: 50% :class: no-scaled-link .. versionadded:: 1.3 .. versionchanged:: 3.0 It is disabled for images having ``no-scaled-link`` class .. confval:: html_math_renderer The name of math_renderer extension for HTML output. The default is ``'mathjax'``. .. versionadded:: 1.8 .. confval:: html_experimental_html5_writer Output is processed with HTML5 writer. Default is ``False``. .. versionadded:: 1.6 .. deprecated:: 2.0 .. confval:: html4_writer Output is processed with HTML4 writer. Default is ``False``. Options for Single HTML output ------------------------------- .. confval:: singlehtml_sidebars Custom sidebar templates, must be a dictionary that maps document names to template names. And it only allows a key named `'index'`. All other keys are ignored. For more information, refer to :confval:`html_sidebars`. By default, it is same as :confval:`html_sidebars`. .. _htmlhelp-options: Options for HTML help output ----------------------------- .. confval:: htmlhelp_basename Output file base name for HTML help builder. Default is ``'pydoc'``. .. confval:: htmlhelp_file_suffix This is the file name suffix for generated HTML help files. The default is ``".html"``. .. versionadded:: 2.0 .. confval:: htmlhelp_link_suffix Suffix for generated links to HTML files. The default is ``".html"``. .. versionadded:: 2.0 .. _applehelp-options: Options for Apple Help output ----------------------------- .. versionadded:: 1.3 These options influence the Apple Help output. This builder derives from the HTML builder, so the HTML options also apply where appropriate. .. note:: Apple Help output will only work on Mac OS X 10.6 and higher, as it requires the :program:`hiutil` and :program:`codesign` command line tools, neither of which are Open Source. You can disable the use of these tools using :confval:`applehelp_disable_external_tools`, but the result will not be a valid help book until the indexer is run over the ``.lproj`` folders within the bundle. .. confval:: applehelp_bundle_name The basename for the Apple Help Book. Defaults to the :confval:`project` name. .. confval:: applehelp_bundle_id The bundle ID for the help book bundle. .. warning:: You *must* set this value in order to generate Apple Help. .. confval:: applehelp_dev_region The development region. Defaults to ``'en-us'``, which is Apple’s recommended setting. .. confval:: applehelp_bundle_version The bundle version (as a string). Defaults to ``'1'``. .. confval:: applehelp_icon The help bundle icon file, or ``None`` for no icon. According to Apple's documentation, this should be a 16-by-16 pixel version of the application's icon with a transparent background, saved as a PNG file. .. confval:: applehelp_kb_product The product tag for use with :confval:`applehelp_kb_url`. Defaults to :samp:`'{<project>}-{<release>}'`. .. confval:: applehelp_kb_url The URL for your knowledgebase server, e.g. ``https://example.com/kbsearch.py?p='product'&q='query'&l='lang'``. Help Viewer will replace the values ``'product'``, ``'query'`` and ``'lang'`` at runtime with the contents of :confval:`applehelp_kb_product`, the text entered by the user in the search box and the user's system language respectively. Defaults to ``None`` for no remote search. .. confval:: applehelp_remote_url The URL for remote content. You can place a copy of your Help Book's ``Resources`` folder at this location and Help Viewer will attempt to use it to fetch updated content. e.g. if you set it to ``https://example.com/help/Foo/`` and Help Viewer wants a copy of ``index.html`` for an English speaking customer, it will look at ``https://example.com/help/Foo/en.lproj/index.html``. Defaults to ``None`` for no remote content. .. confval:: applehelp_index_anchors If ``True``, tell the help indexer to index anchors in the generated HTML. This can be useful for jumping to a particular topic using the ``AHLookupAnchor`` function or the ``openHelpAnchor:inBook:`` method in your code. It also allows you to use ``help:anchor`` URLs; see the Apple documentation for more information on this topic. .. confval:: applehelp_min_term_length Controls the minimum term length for the help indexer. Defaults to ``None``, which means the default will be used. .. confval:: applehelp_stopwords Either a language specification (to use the built-in stopwords), or the path to a stopwords plist, or ``None`` if you do not want to use stopwords. The default stopwords plist can be found at ``/usr/share/hiutil/Stopwords.plist`` and contains, at time of writing, stopwords for the following languages: ========= ==== Language Code ========= ==== English en German de Spanish es French fr Swedish sv Hungarian hu Italian it ========= ==== Defaults to :confval:`language`, or if that is not set, to :confval:`en`. .. confval:: applehelp_locale Specifies the locale to generate help for. This is used to determine the name of the ``.lproj`` folder inside the Help Book’s ``Resources``, and is passed to the help indexer. Defaults to :confval:`language`, or if that is not set, to :confval:`en`. .. confval:: applehelp_title Specifies the help book title. Defaults to :samp:`'{<project>} Help'`. .. confval:: applehelp_codesign_identity Specifies the identity to use for code signing, or ``None`` if code signing is not to be performed. Defaults to the value of the environment variable ``CODE_SIGN_IDENTITY``, which is set by Xcode for script build phases, or ``None`` if that variable is not set. .. confval:: applehelp_codesign_flags A *list* of additional arguments to pass to :program:`codesign` when signing the help book. Defaults to a list based on the value of the environment variable ``OTHER_CODE_SIGN_FLAGS``, which is set by Xcode for script build phases, or the empty list if that variable is not set. .. confval:: applehelp_indexer_path The path to the :program:`hiutil` program. Defaults to ``'/usr/bin/hiutil'``. .. confval:: applehelp_codesign_path The path to the :program:`codesign` program. Defaults to ``'/usr/bin/codesign'``. .. confval:: applehelp_disable_external_tools If ``True``, the builder will not run the indexer or the code signing tool, no matter what other settings are specified. This is mainly useful for testing, or where you want to run the Sphinx build on a non-Mac OS X platform and then complete the final steps on OS X for some reason. Defaults to ``False``. .. _epub-options: Options for epub output ----------------------- These options influence the epub output. As this builder derives from the HTML builder, the HTML options also apply where appropriate. The actual values for some of the options is not really important, they just have to be entered into the `Dublin Core metadata <https://dublincore.org/>`_. .. confval:: epub_basename The basename for the epub file. It defaults to the :confval:`project` name. .. confval:: epub_theme The HTML theme for the epub output. Since the default themes are not optimized for small screen space, using the same theme for HTML and epub output is usually not wise. This defaults to ``'epub'``, a theme designed to save visual space. .. confval:: epub_theme_options A dictionary of options that influence the look and feel of the selected theme. These are theme-specific. For the options understood by the builtin themes, see :ref:`this section <builtin-themes>`. .. versionadded:: 1.2 .. confval:: epub_title The title of the document. It defaults to the :confval:`html_title` option but can be set independently for epub creation. It defaults to the :confval:`project` option. .. versionchanged:: 2.0 It defaults to the ``project`` option. .. confval:: epub_description The description of the document. The default value is ``'unknown'``. .. versionadded:: 1.4 .. versionchanged:: 1.5 Renamed from ``epub3_description`` .. confval:: epub_author The author of the document. This is put in the Dublin Core metadata. It defaults to the :confval:`author` option. .. confval:: epub_contributor The name of a person, organization, etc. that played a secondary role in the creation of the content of an EPUB Publication. The default value is ``'unknown'``. .. versionadded:: 1.4 .. versionchanged:: 1.5 Renamed from ``epub3_contributor`` .. confval:: epub_language The language of the document. This is put in the Dublin Core metadata. The default is the :confval:`language` option or ``'en'`` if unset. .. confval:: epub_publisher The publisher of the document. This is put in the Dublin Core metadata. You may use any sensible string, e.g. the project homepage. The defaults to the :confval:`author` option. .. confval:: epub_copyright The copyright of the document. It defaults to the :confval:`copyright` option but can be set independently for epub creation. .. confval:: epub_identifier An identifier for the document. This is put in the Dublin Core metadata. For published documents this is the ISBN number, but you can also use an alternative scheme, e.g. the project homepage. The default value is ``'unknown'``. .. confval:: epub_scheme The publication scheme for the :confval:`epub_identifier`. This is put in the Dublin Core metadata. For published books the scheme is ``'ISBN'``. If you use the project homepage, ``'URL'`` seems reasonable. The default value is ``'unknown'``. .. confval:: epub_uid A unique identifier for the document. This is put in the Dublin Core metadata. You may use a `XML's Name format <https://www.w3.org/TR/REC-xml/#NT-NameStartChar>`_ string. You can't use hyphen, period, numbers as a first character. The default value is ``'unknown'``. .. confval:: epub_cover The cover page information. This is a tuple containing the filenames of the cover image and the html template. The rendered html cover page is inserted as the first item in the spine in :file:`content.opf`. If the template filename is empty, no html cover page is created. No cover at all is created if the tuple is empty. Examples:: epub_cover = ('_static/cover.png', 'epub-cover.html') epub_cover = ('_static/cover.png', '') epub_cover = () The default value is ``()``. .. versionadded:: 1.1 .. confval:: epub_css_files A list of CSS files. The entry must be a *filename* string or a tuple containing the *filename* string and the *attributes* dictionary. For more information, see :confval:`html_css_files`. .. versionadded:: 1.8 .. confval:: epub_guide Meta data for the guide element of :file:`content.opf`. This is a sequence of tuples containing the *type*, the *uri* and the *title* of the optional guide information. See the OPF documentation at `<http://idpf.org/epub>`_ for details. If possible, default entries for the *cover* and *toc* types are automatically inserted. However, the types can be explicitly overwritten if the default entries are not appropriate. Example:: epub_guide = (('cover', 'cover.html', u'Cover Page'),) The default value is ``()``. .. confval:: epub_pre_files Additional files that should be inserted before the text generated by Sphinx. It is a list of tuples containing the file name and the title. If the title is empty, no entry is added to :file:`toc.ncx`. Example:: epub_pre_files = [ ('index.html', 'Welcome'), ] The default value is ``[]``. .. confval:: epub_post_files Additional files that should be inserted after the text generated by Sphinx. It is a list of tuples containing the file name and the title. This option can be used to add an appendix. If the title is empty, no entry is added to :file:`toc.ncx`. The default value is ``[]``. .. confval:: epub_exclude_files A list of files that are generated/copied in the build directory but should not be included in the epub file. The default value is ``[]``. .. confval:: epub_tocdepth The depth of the table of contents in the file :file:`toc.ncx`. It should be an integer greater than zero. The default value is 3. Note: A deeply nested table of contents may be difficult to navigate. .. confval:: epub_tocdup This flag determines if a toc entry is inserted again at the beginning of its nested toc listing. This allows easier navigation to the top of a chapter, but can be confusing because it mixes entries of different depth in one list. The default value is ``True``. .. confval:: epub_tocscope This setting control the scope of the epub table of contents. The setting can have the following values: * ``'default'`` -- include all toc entries that are not hidden (default) * ``'includehidden'`` -- include all toc entries .. versionadded:: 1.2 .. confval:: epub_fix_images This flag determines if sphinx should try to fix image formats that are not supported by some epub readers. At the moment palette images with a small color table are upgraded. You need Pillow, the Python Image Library, installed to use this option. The default value is ``False`` because the automatic conversion may lose information. .. versionadded:: 1.2 .. confval:: epub_max_image_width This option specifies the maximum width of images. If it is set to a value greater than zero, images with a width larger than the given value are scaled accordingly. If it is zero, no scaling is performed. The default value is ``0``. You need the Python Image Library (Pillow) installed to use this option. .. versionadded:: 1.2 .. confval:: epub_show_urls Control whether to display URL addresses. This is very useful for readers that have no other means to display the linked URL. The settings can have the following values: * ``'inline'`` -- display URLs inline in parentheses (default) * ``'footnote'`` -- display URLs in footnotes * ``'no'`` -- do not display URLs The display of inline URLs can be customized by adding CSS rules for the class ``link-target``. .. versionadded:: 1.2 .. confval:: epub_use_index If true, add an index to the epub document. It defaults to the :confval:`html_use_index` option but can be set independently for epub creation. .. versionadded:: 1.2 .. confval:: epub_writing_mode It specifies writing direction. It can accept ``'horizontal'`` (default) and ``'vertical'`` .. list-table:: :header-rows: 1 :stub-columns: 1 - * ``epub_writing_mode`` * ``'horizontal'`` * ``'vertical'`` - * writing-mode [#]_ * ``horizontal-tb`` * ``vertical-rl`` - * page progression * left to right * right to left - * iBook's Scroll Theme support * scroll-axis is vertical. * scroll-axis is horizontal. .. [#] https://developer.mozilla.org/en-US/docs/Web/CSS/writing-mode .. _latex-options: Options for LaTeX output ------------------------ These options influence LaTeX output. .. confval:: latex_engine The LaTeX engine to build the docs. The setting can have the following values: * ``'pdflatex'`` -- PDFLaTeX (default) * ``'xelatex'`` -- XeLaTeX * ``'lualatex'`` -- LuaLaTeX * ``'platex'`` -- pLaTeX * ``'uplatex'`` -- upLaTeX (default if :confval:`language` is ``'ja'``) ``'pdflatex'``\ 's support for Unicode characters is limited. .. note:: 2.0 adds to ``'pdflatex'`` support in Latin language document of occasional Cyrillic or Greek letters or words. This is not automatic, see the discussion of the :confval:`latex_elements` ``'fontenc'`` key. If your project uses Unicode characters, setting the engine to ``'xelatex'`` or ``'lualatex'`` and making sure to use an OpenType font with wide-enough glyph coverage is often easier than trying to make ``'pdflatex'`` work with the extra Unicode characters. Since Sphinx 2.0 the default is the GNU FreeFont which covers well Latin, Cyrillic and Greek. .. versionchanged:: 2.1.0 Use ``xelatex`` (and LaTeX package ``xeCJK``) by default for Chinese documents. .. versionchanged:: 2.2.1 Use ``xelatex`` by default for Greek documents. .. versionchanged:: 2.3 Add ``uplatex`` support. .. versionchanged:: 4.0 ``uplatex`` becomes the default setting of Japanese documents. Contrarily to :ref:`MathJaX math rendering in HTML output <math-support>`, LaTeX requires some extra configuration to support Unicode literals in :rst:dir:`math`: the only comprehensive solution (as far as we know) is to use ``'xelatex'`` or ``'lualatex'`` *and* to add ``r'\usepackage{unicode-math}'`` (e.g. via the :confval:`latex_elements` ``'preamble'`` key). You may prefer ``r'\usepackage[math-style=literal]{unicode-math}'`` to keep a Unicode literal such as ``α`` (U+03B1) for example as is in output, rather than being rendered as :math:`\alpha`. .. confval:: latex_documents This value determines how to group the document tree into LaTeX source files. It must be a list of tuples ``(startdocname, targetname, title, author, theme, toctree_only)``, where the items are: *startdocname* String that specifies the :term:`document name` of the LaTeX file's master document. All documents referenced by the *startdoc* document in TOC trees will be included in the LaTeX file. (If you want to use the default root document for your LaTeX build, provide your :confval:`root_doc` here.) *targetname* File name of the LaTeX file in the output directory. *title* LaTeX document title. Can be empty to use the title of the *startdoc* document. This is inserted as LaTeX markup, so special characters like a backslash or ampersand must be represented by the proper LaTeX commands if they are to be inserted literally. *author* Author for the LaTeX document. The same LaTeX markup caveat as for *title* applies. Use ``\\and`` to separate multiple authors, as in: ``'John \\and Sarah'`` (backslashes must be Python-escaped to reach LaTeX). *theme* LaTeX theme. See :confval:`latex_theme`. *toctree_only* Must be ``True`` or ``False``. If true, the *startdoc* document itself is not included in the output, only the documents referenced by it via TOC trees. With this option, you can put extra stuff in the master document that shows up in the HTML, but not the LaTeX output. .. versionadded:: 1.2 In the past including your own document class required you to prepend the document class name with the string "sphinx". This is not necessary anymore. .. versionadded:: 0.3 The 6th item ``toctree_only``. Tuples with 5 items are still accepted. .. confval:: latex_logo If given, this must be the name of an image file (relative to the configuration directory) that is the logo of the docs. It is placed at the top of the title page. Default: ``None``. .. confval:: latex_toplevel_sectioning This value determines the topmost sectioning unit. It should be chosen from ``'part'``, ``'chapter'`` or ``'section'``. The default is ``None``; the topmost sectioning unit is switched by documentclass: ``section`` is used if documentclass will be ``howto``, otherwise ``chapter`` will be used. Note that if LaTeX uses ``\part`` command, then the numbering of sectioning units one level deep gets off-sync with HTML numbering, because LaTeX numbers continuously ``\chapter`` (or ``\section`` for ``howto``.) .. versionadded:: 1.4 .. confval:: latex_appendices A list of document names to append as an appendix to all manuals. .. confval:: latex_domain_indices If true, generate domain-specific indices in addition to the general index. For e.g. the Python domain, this is the global module index. Default is ``True``. This value can be a bool or a list of index names that should be generated, like for :confval:`html_domain_indices`. .. versionadded:: 1.0 .. confval:: latex_show_pagerefs If true, add page references after internal references. This is very useful for printed copies of the manual. Default is ``False``. .. versionadded:: 1.0 .. confval:: latex_show_urls Control whether to display URL addresses. This is very useful for printed copies of the manual. The setting can have the following values: * ``'no'`` -- do not display URLs (default) * ``'footnote'`` -- display URLs in footnotes * ``'inline'`` -- display URLs inline in parentheses .. versionadded:: 1.0 .. versionchanged:: 1.1 This value is now a string; previously it was a boolean value, and a true value selected the ``'inline'`` display. For backwards compatibility, ``True`` is still accepted. .. confval:: latex_use_latex_multicolumn The default is ``False``: it means that Sphinx's own macros are used for merged cells from grid tables. They allow general contents (literal blocks, lists, blockquotes, ...) but may have problems if the :rst:dir:`tabularcolumns` directive was used to inject LaTeX mark-up of the type ``>{..}``, ``<{..}``, ``@{..}`` as column specification. Setting to ``True`` means to use LaTeX's standard ``\multicolumn``; this is incompatible with literal blocks in the horizontally merged cell, and also with multiple paragraphs in such cell if the table is rendered using ``tabulary``. .. versionadded:: 1.6 .. confval:: latex_use_xindy If ``True``, the PDF build from the LaTeX files created by Sphinx will use :program:`xindy` (doc__) rather than :program:`makeindex` for preparing the index of general terms (from :rst:dir:`index` usage). This means that words with UTF-8 characters will get ordered correctly for the :confval:`language`. __ http://xindy.sourceforge.net/ - This option is ignored if :confval:`latex_engine` is ``'platex'`` (Japanese documents; :program:`mendex` replaces :program:`makeindex` then). - The default is ``True`` for ``'xelatex'`` or ``'lualatex'`` as :program:`makeindex`, if any indexed term starts with a non-ascii character, creates ``.ind`` files containing invalid bytes for UTF-8 encoding. With ``'lualatex'`` this then breaks the PDF build. - The default is ``False`` for ``'pdflatex'`` but ``True`` is recommended for non-English documents as soon as some indexed terms use non-ascii characters from the language script. Sphinx adds to :program:`xindy` base distribution some dedicated support for using ``'pdflatex'`` engine with Cyrillic scripts. And whether with ``'pdflatex'`` or Unicode engines, Cyrillic documents handle correctly the indexing of Latin names, even with diacritics. .. versionadded:: 1.8 .. confval:: latex_elements .. versionadded:: 0.5 Its :ref:`documentation <latex_elements_confval>` has moved to :doc:`/latex`. .. confval:: latex_docclass A dictionary mapping ``'howto'`` and ``'manual'`` to names of real document classes that will be used as the base for the two Sphinx classes. Default is to use ``'article'`` for ``'howto'`` and ``'report'`` for ``'manual'``. .. versionadded:: 1.0 .. versionchanged:: 1.5 In Japanese docs (:confval:`language` is ``'ja'``), by default ``'jreport'`` is used for ``'howto'`` and ``'jsbook'`` for ``'manual'``. .. confval:: latex_additional_files A list of file names, relative to the configuration directory, to copy to the build directory when building LaTeX output. This is useful to copy files that Sphinx doesn't copy automatically, e.g. if they are referenced in custom LaTeX added in ``latex_elements``. Image files that are referenced in source files (e.g. via ``.. image::``) are copied automatically. You have to make sure yourself that the filenames don't collide with those of any automatically copied files. .. versionadded:: 0.6 .. versionchanged:: 1.2 This overrides the files which is provided from Sphinx such as ``sphinx.sty``. .. confval:: latex_theme The "theme" that the LaTeX output should use. It is a collection of settings for LaTeX output (ex. document class, top level sectioning unit and so on). As a built-in LaTeX themes, ``manual`` and ``howto`` are bundled. ``manual`` A LaTeX theme for writing a manual. It imports the ``report`` document class (Japanese documents use ``jsbook``). ``howto`` A LaTeX theme for writing an article. It imports the ``article`` document class (Japanese documents use ``jreport`` rather). :confval:`latex_appendices` is available only for this theme. It defaults to ``'manual'``. .. versionadded:: 3.0 .. confval:: latex_theme_options A dictionary of options that influence the look and feel of the selected theme. .. versionadded:: 3.1 .. confval:: latex_theme_path A list of paths that contain custom LaTeX themes as subdirectories. Relative paths are taken as relative to the configuration directory. .. versionadded:: 3.0 .. _text-options: Options for text output ----------------------- These options influence text output. .. confval:: text_newlines Determines which end-of-line character(s) are used in text output. * ``'unix'``: use Unix-style line endings (``\n``) * ``'windows'``: use Windows-style line endings (``\r\n``) * ``'native'``: use the line ending style of the platform the documentation is built on Default: ``'unix'``. .. versionadded:: 1.1 .. confval:: text_sectionchars A string of 7 characters that should be used for underlining sections. The first character is used for first-level headings, the second for second-level headings and so on. The default is ``'*=-~"+`'``. .. versionadded:: 1.1 .. confval:: text_add_secnumbers A boolean that decides whether section numbers are included in text output. Default is ``True``. .. versionadded:: 1.7 .. confval:: text_secnumber_suffix Suffix for section numbers in text output. Default: ``". "``. Set to ``" "`` to suppress the final dot on section numbers. .. versionadded:: 1.7 .. _man-options: Options for manual page output ------------------------------ These options influence manual page output. .. confval:: man_pages This value determines how to group the document tree into manual pages. It must be a list of tuples ``(startdocname, name, description, authors, section)``, where the items are: *startdocname* String that specifies the :term:`document name` of the manual page's master document. All documents referenced by the *startdoc* document in TOC trees will be included in the manual file. (If you want to use the default root document for your manual pages build, use your :confval:`root_doc` here.) *name* Name of the manual page. This should be a short string without spaces or special characters. It is used to determine the file name as well as the name of the manual page (in the NAME section). *description* Description of the manual page. This is used in the NAME section. Can be an empty string if you do not want to automatically generate the NAME section. *authors* A list of strings with authors, or a single string. Can be an empty string or list if you do not want to automatically generate an AUTHORS section in the manual page. *section* The manual page section. Used for the output file name as well as in the manual page header. .. versionadded:: 1.0 .. confval:: man_show_urls If true, add URL addresses after links. Default is ``False``. .. versionadded:: 1.1 .. confval:: man_make_section_directory If true, make a section directory on build man page. Default is True. .. versionadded:: 3.3 .. versionchanged:: 4.0 The default is changed to ``False`` from ``True``. .. versionchanged:: 4.0.2 The default is changed to ``True`` from ``False`` again. .. _texinfo-options: Options for Texinfo output -------------------------- These options influence Texinfo output. .. confval:: texinfo_documents This value determines how to group the document tree into Texinfo source files. It must be a list of tuples ``(startdocname, targetname, title, author, dir_entry, description, category, toctree_only)``, where the items are: *startdocname* String that specifies the :term:`document name` of the the Texinfo file's master document. All documents referenced by the *startdoc* document in TOC trees will be included in the Texinfo file. (If you want to use the default master document for your Texinfo build, provide your :confval:`root_doc` here.) *targetname* File name (no extension) of the Texinfo file in the output directory. *title* Texinfo document title. Can be empty to use the title of the *startdoc* document. Inserted as Texinfo markup, so special characters like ``@`` and ``{}`` will need to be escaped to be inserted literally. *author* Author for the Texinfo document. Inserted as Texinfo markup. Use ``@*`` to separate multiple authors, as in: ``'John@*Sarah'``. *dir_entry* The name that will appear in the top-level ``DIR`` menu file. *description* Descriptive text to appear in the top-level ``DIR`` menu file. *category* Specifies the section which this entry will appear in the top-level ``DIR`` menu file. *toctree_only* Must be ``True`` or ``False``. If true, the *startdoc* document itself is not included in the output, only the documents referenced by it via TOC trees. With this option, you can put extra stuff in the master document that shows up in the HTML, but not the Texinfo output. .. versionadded:: 1.1 .. confval:: texinfo_appendices A list of document names to append as an appendix to all manuals. .. versionadded:: 1.1 .. confval:: texinfo_domain_indices If true, generate domain-specific indices in addition to the general index. For e.g. the Python domain, this is the global module index. Default is ``True``. This value can be a bool or a list of index names that should be generated, like for :confval:`html_domain_indices`. .. versionadded:: 1.1 .. confval:: texinfo_show_urls Control how to display URL addresses. * ``'footnote'`` -- display URLs in footnotes (default) * ``'no'`` -- do not display URLs * ``'inline'`` -- display URLs inline in parentheses .. versionadded:: 1.1 .. confval:: texinfo_no_detailmenu If true, do not generate a ``@detailmenu`` in the "Top" node's menu containing entries for each sub-node in the document. Default is ``False``. .. versionadded:: 1.2 .. confval:: texinfo_elements A dictionary that contains Texinfo snippets that override those Sphinx usually puts into the generated ``.texi`` files. * Keys that you may want to override include: ``'paragraphindent'`` Number of spaces to indent the first line of each paragraph, default ``2``. Specify ``0`` for no indentation. ``'exampleindent'`` Number of spaces to indent the lines for examples or literal blocks, default ``4``. Specify ``0`` for no indentation. ``'preamble'`` Texinfo markup inserted near the beginning of the file. ``'copying'`` Texinfo markup inserted within the ``@copying`` block and displayed after the title. The default value consists of a simple title page identifying the project. * Keys that are set by other options and therefore should not be overridden are: ``'author'`` ``'body'`` ``'date'`` ``'direntry'`` ``'filename'`` ``'project'`` ``'release'`` ``'title'`` .. versionadded:: 1.1 .. _qthelp-options: Options for QtHelp output -------------------------- These options influence qthelp output. As this builder derives from the HTML builder, the HTML options also apply where appropriate. .. confval:: qthelp_basename The basename for the qthelp file. It defaults to the :confval:`project` name. .. confval:: qthelp_namespace The namespace for the qthelp file. It defaults to ``org.sphinx.<project_name>.<project_version>``. .. confval:: qthelp_theme The HTML theme for the qthelp output. This defaults to ``'nonav'``. .. confval:: qthelp_theme_options A dictionary of options that influence the look and feel of the selected theme. These are theme-specific. For the options understood by the builtin themes, see :ref:`this section <builtin-themes>`. Options for the linkcheck builder --------------------------------- .. confval:: linkcheck_ignore A list of regular expressions that match URIs that should not be checked when doing a ``linkcheck`` build. Example:: linkcheck_ignore = [r'http://localhost:\d+/'] .. versionadded:: 1.1 .. confval:: linkcheck_allowed_redirects A dictionary that maps a pattern of the source URI to a pattern of the canonical URI. The linkcheck builder treats the redirected link as "working" when: - the link in the document matches the source URI pattern, and - the redirect location matches the canonical URI pattern. Example: .. code-block:: python linkcheck_allowed_redirects = { # All HTTP redirections from the source URI to the canonical URI will be treated as "working". r'https://sphinx-doc\.org/.*': r'https://sphinx-doc\.org/en/master/.*' } If set, linkcheck builder will emit a warning when disallowed redirection found. It's useful to detect unexpected redirects under :option:`the warn-is-error mode <sphinx-build -W>`. .. versionadded:: 4.1 .. confval:: linkcheck_request_headers A dictionary that maps baseurls to HTTP request headers. The key is a URL base string like ``"https://www.sphinx-doc.org/"``. To specify headers for other hosts, ``"*"`` can be used. It matches all hosts only when the URL does not match other settings. The value is a dictionary that maps header name to its value. Example: .. code-block:: python linkcheck_request_headers = { "https://www.sphinx-doc.org/": { "Accept": "text/html", "Accept-Encoding": "utf-8", }, "*": { "Accept": "text/html,application/xhtml+xml", } } .. versionadded:: 3.1 .. confval:: linkcheck_retries The number of times the linkcheck builder will attempt to check a URL before declaring it broken. Defaults to 1 attempt. .. versionadded:: 1.4 .. confval:: linkcheck_timeout A timeout value, in seconds, for the linkcheck builder. The default is to use Python's global socket timeout. .. versionadded:: 1.1 .. confval:: linkcheck_workers The number of worker threads to use when checking links. Default is 5 threads. .. versionadded:: 1.1 .. confval:: linkcheck_anchors If true, check the validity of ``#anchor``\ s in links. Since this requires downloading the whole document, it's considerably slower when enabled. Default is ``True``. .. versionadded:: 1.2 .. confval:: linkcheck_anchors_ignore A list of regular expressions that match anchors Sphinx should skip when checking the validity of anchors in links. This allows skipping anchors that a website's JavaScript adds to control dynamic pages or when triggering an internal REST request. Default is ``["^!"]``. .. note:: If you want to ignore anchors of a specific page or of pages that match a specific pattern (but still check occurrences of the same page(s) that don't have anchors), use :confval:`linkcheck_ignore` instead, for example as follows:: linkcheck_ignore = [ 'https://www.sphinx-doc.org/en/1.7/intro.html#' ] .. versionadded:: 1.5 .. confval:: linkcheck_auth Pass authentication information when doing a ``linkcheck`` build. A list of ``(regex_pattern, auth_info)`` tuples where the items are: *regex_pattern* A regular expression that matches a URI. *auth_info* Authentication information to use for that URI. The value can be anything that is understood by the ``requests`` library (see :ref:`requests Authentication <requests:authentication>` for details). The ``linkcheck`` builder will use the first matching ``auth_info`` value it can find in the :confval:`linkcheck_auth` list, so values earlier in the list have higher priority. Example:: linkcheck_auth = [ ('https://foo\.yourcompany\.com/.+', ('johndoe', 'secret')), ('https://.+\.yourcompany\.com/.+', HTTPDigestAuth(...)), ] .. versionadded:: 2.3 .. confval:: linkcheck_rate_limit_timeout The ``linkcheck`` builder may issue a large number of requests to the same site over a short period of time. This setting controls the builder behavior when servers indicate that requests are rate-limited. If a server indicates when to retry (using the `Retry-After`_ header), ``linkcheck`` always follows the server indication. Otherwise, ``linkcheck`` waits for a minute before to retry and keeps doubling the wait time between attempts until it succeeds or exceeds the ``linkcheck_rate_limit_timeout``. By default, the timeout is 5 minutes. .. _Retry-After: https://tools.ietf.org/html/rfc7231#section-7.1.3 .. versionadded:: 3.4 Options for the XML builder --------------------------- .. confval:: xml_pretty If true, pretty-print the XML. Default is ``True``. .. versionadded:: 1.2 .. rubric:: Footnotes .. [1] A note on available globbing syntax: you can use the standard shell constructs ``*``, ``?``, ``[...]`` and ``[!...]`` with the feature that these all don't match slashes. A double star ``**`` can be used to match any sequence of characters *including* slashes. .. _c-config: Options for the C domain ------------------------ .. confval:: c_id_attributes A list of strings that the parser additionally should accept as attributes. This can for example be used when attributes have been ``#define`` d for portability. .. versionadded:: 3.0 .. confval:: c_paren_attributes A list of strings that the parser additionally should accept as attributes with one argument. That is, if ``my_align_as`` is in the list, then ``my_align_as(X)`` is parsed as an attribute for all strings ``X`` that have balanced braces (``()``, ``[]``, and ``{}``). This can for example be used when attributes have been ``#define`` d for portability. .. versionadded:: 3.0 .. confval:: c_extra_keywords A list of identifiers to be recognized as keywords by the C parser. It defaults to ``['alignas', 'alignof', 'bool', 'complex', 'imaginary', 'noreturn', 'static_assert', 'thread_local']``. .. versionadded:: 4.0.3 .. confval:: c_allow_pre_v3 A boolean (default ``False``) controlling whether to parse and try to convert pre-v3 style type directives and type roles. .. versionadded:: 3.2 .. deprecated:: 3.2 Use the directives and roles added in v3. .. confval:: c_warn_on_allowed_pre_v3 A boolean (default ``True``) controlling whether to warn when a pre-v3 style type directive/role is parsed and converted. .. versionadded:: 3.2 .. deprecated:: 3.2 Use the directives and roles added in v3. .. _cpp-config: Options for the C++ domain -------------------------- .. confval:: cpp_index_common_prefix A list of prefixes that will be ignored when sorting C++ objects in the global index. For example ``['awesome_lib::']``. .. versionadded:: 1.5 .. confval:: cpp_id_attributes A list of strings that the parser additionally should accept as attributes. This can for example be used when attributes have been ``#define`` d for portability. .. versionadded:: 1.5 .. confval:: cpp_paren_attributes A list of strings that the parser additionally should accept as attributes with one argument. That is, if ``my_align_as`` is in the list, then ``my_align_as(X)`` is parsed as an attribute for all strings ``X`` that have balanced braces (``()``, ``[]``, and ``{}``). This can for example be used when attributes have been ``#define`` d for portability. .. versionadded:: 1.5 Options for the Python domain ----------------------------- .. confval:: python_use_unqualified_type_names If true, suppress the module name of the python reference if it can be resolved. The default is ``False``. .. versionadded:: 4.0 .. note:: This configuration is still in experimental Example of configuration file ============================= .. literalinclude:: /_static/conf.py.txt :language: python ��������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.433617 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016403� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/autodoc.rst�������������������������������������������������������0000644�0000766�0000024�00000070166�00000000000�020605� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: rest :mod:`sphinx.ext.autodoc` -- Include documentation from docstrings ================================================================== .. module:: sphinx.ext.autodoc :synopsis: Include documentation from docstrings. .. index:: pair: automatic; documentation single: docstring This extension can import the modules you are documenting, and pull in documentation from docstrings in a semi-automatic way. .. note:: For Sphinx (actually, the Python interpreter that executes Sphinx) to find your module, it must be importable. That means that the module or the package must be in one of the directories on :data:`sys.path` -- adapt your :data:`sys.path` in the configuration file accordingly. .. warning:: :mod:`~sphinx.ext.autodoc` **imports** the modules to be documented. If any modules have side effects on import, these will be executed by ``autodoc`` when ``sphinx-build`` is run. If you document scripts (as opposed to library modules), make sure their main routine is protected by a ``if __name__ == '__main__'`` condition. For this to work, the docstrings must of course be written in correct reStructuredText. You can then use all of the usual Sphinx markup in the docstrings, and it will end up correctly in the documentation. Together with hand-written documentation, this technique eases the pain of having to maintain two locations for documentation, while at the same time avoiding auto-generated-looking pure API documentation. If you prefer `NumPy`_ or `Google`_ style docstrings over reStructuredText, you can also enable the :mod:`napoleon <sphinx.ext.napoleon>` extension. :mod:`napoleon <sphinx.ext.napoleon>` is a preprocessor that converts your docstrings to correct reStructuredText before :mod:`autodoc` processes them. .. _Google: https://github.com/google/styleguide/blob/gh-pages/pyguide.md#38-comments-and-docstrings .. _NumPy: https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt Directives ---------- :mod:`autodoc` provides several directives that are versions of the usual :rst:dir:`py:module`, :rst:dir:`py:class` and so forth. On parsing time, they import the corresponding module and extract the docstring of the given objects, inserting them into the page source under a suitable :rst:dir:`py:module`, :rst:dir:`py:class` etc. directive. .. note:: Just as :rst:dir:`py:class` respects the current :rst:dir:`py:module`, :rst:dir:`autoclass` will also do so. Likewise, :rst:dir:`automethod` will respect the current :rst:dir:`py:class`. .. rst:directive:: automodule autoclass autoexception Document a module, class or exception. All three directives will by default only insert the docstring of the object itself:: .. autoclass:: Noodle will produce source like this:: .. class:: Noodle Noodle's docstring. The "auto" directives can also contain content of their own, it will be inserted into the resulting non-auto directive source after the docstring (but before any automatic member documentation). Therefore, you can also mix automatic and non-automatic member documentation, like so:: .. autoclass:: Noodle :members: eat, slurp .. method:: boil(time=10) Boil the noodle *time* minutes. .. rubric:: Options .. rst:directive:option:: members :type: no value or comma separated list If set, autodoc will generate document for the members of the target module, class or exception. For example:: .. automodule:: noodle :members: will document all module members (recursively), and :: .. autoclass:: Noodle :members: will document all class member methods and properties. By default, autodoc will not generate document for the members that are private, not having docstrings, inherited from super class, or special members. For modules, ``__all__`` will be respected when looking for members unless you give the ``ignore-module-all`` flag option. Without ``ignore-module-all``, the order of the members will also be the order in ``__all__``. You can also give an explicit list of members; only these will then be documented:: .. autoclass:: Noodle :members: eat, slurp .. rst:directive:option:: undoc-members :type: no value If set, autodoc will also generate document for the members not having docstrings:: .. automodule:: noodle :members: :undoc-members: .. rst:directive:option:: private-members :type: no value or comma separated list If set, autodoc will also generate document for the private members (that is, those named like ``_private`` or ``__private``):: .. automodule:: noodle :members: :private-members: It can also take an explicit list of member names to be documented as arguments:: .. automodule:: noodle :members: :private-members: _spicy, _garlickly .. versionadded:: 1.1 .. versionchanged:: 3.2 The option can now take arguments. .. rst:directive:option:: special-members :type: no value or comma separated list If set, autodoc will also generate document for the special members (that is, those named like ``__special__``):: .. autoclass:: my.Class :members: :special-members: It can also take an explicit list of member names to be documented as arguments:: .. autoclass:: my.Class :members: :special-members: __init__, __name__ .. versionadded:: 1.1 .. versionchanged:: 1.2 The option can now take arguments **Options and advanced usage** * If you want to make the ``members`` option (or other options described below) the default, see :confval:`autodoc_default_options`. .. tip:: You can use a negated form, :samp:`'no-{flag}'`, as an option of autodoc directive, to disable it temporarily. For example:: .. automodule:: foo :no-undoc-members: .. tip:: You can use autodoc directive options to temporarily override or extend default options which takes list as an input. For example:: .. autoclass:: Noodle :members: eat :private-members: +_spicy, _garlickly .. versionchanged:: 3.5 The default options can be overridden or extended temporarily. * autodoc considers a member private if its docstring contains ``:meta private:`` in its :ref:`info-field-lists`. For example: .. code-block:: python def my_function(my_arg, my_other_arg): """blah blah blah :meta private: """ .. versionadded:: 3.0 * autodoc considers a member public if its docstring contains ``:meta public:`` in its :ref:`info-field-lists`, even if it starts with an underscore. For example: .. code-block:: python def _my_function(my_arg, my_other_arg): """blah blah blah :meta public: """ .. versionadded:: 3.1 * autodoc considers a variable member does not have any default value if its docstring contains ``:meta hide-value:`` in its :ref:`info-field-lists`. Example: .. code-block:: python var1 = None #: :meta hide-value: .. versionadded:: 3.5 * For classes and exceptions, members inherited from base classes will be left out when documenting all members, unless you give the ``inherited-members`` option, in addition to ``members``:: .. autoclass:: Noodle :members: :inherited-members: This can be combined with ``undoc-members`` to document *all* available members of the class or module. It can take an ancestor class not to document inherited members from it. By default, members of ``object`` class are not documented. To show them all, give ``None`` to the option. For example; If your class ``Foo`` is derived from ``list`` class and you don't want to document ``list.__len__()``, you should specify a option ``:inherited-members: list`` to avoid special members of list class. Another example; If your class Foo has ``__str__`` special method and autodoc directive has both ``inherited-members`` and ``special-members``, ``__str__`` will be documented as in the past, but other special method that are not implemented in your class ``Foo``. Note: this will lead to markup errors if the inherited members come from a module whose docstrings are not reST formatted. .. versionadded:: 0.3 .. versionchanged:: 3.0 It takes an ancestor class name as an argument. * It's possible to override the signature for explicitly documented callable objects (functions, methods, classes) with the regular syntax that will override the signature gained from introspection:: .. autoclass:: Noodle(type) .. automethod:: eat(persona) This is useful if the signature from the method is hidden by a decorator. .. versionadded:: 0.4 * The :rst:dir:`automodule`, :rst:dir:`autoclass` and :rst:dir:`autoexception` directives also support a flag option called ``show-inheritance``. When given, a list of base classes will be inserted just below the class signature (when used with :rst:dir:`automodule`, this will be inserted for every class that is documented in the module). .. versionadded:: 0.4 * All autodoc directives support the ``noindex`` flag option that has the same effect as for standard :rst:dir:`py:function` etc. directives: no index entries are generated for the documented object (and all autodocumented members). .. versionadded:: 0.4 * :rst:dir:`automodule` also recognizes the ``synopsis``, ``platform`` and ``deprecated`` options that the standard :rst:dir:`py:module` directive supports. .. versionadded:: 0.5 * :rst:dir:`automodule` and :rst:dir:`autoclass` also has an ``member-order`` option that can be used to override the global value of :confval:`autodoc_member_order` for one directive. .. versionadded:: 0.6 * The directives supporting member documentation also have a ``exclude-members`` option that can be used to exclude single member names from documentation, if all members are to be documented. .. versionadded:: 0.6 * In an :rst:dir:`automodule` directive with the ``members`` option set, only module members whose ``__module__`` attribute is equal to the module name as given to ``automodule`` will be documented. This is to prevent documentation of imported classes or functions. Set the ``imported-members`` option if you want to prevent this behavior and document all available members. Note that attributes from imported modules will not be documented, because attribute documentation is discovered by parsing the source file of the current module. .. versionadded:: 1.2 * Add a list of modules in the :confval:`autodoc_mock_imports` to prevent import errors to halt the building process when some external dependencies are not importable at build time. .. versionadded:: 1.3 * As a hint to autodoc extension, you can put a ``::`` separator in between module name and object name to let autodoc know the correct module name if it is ambiguous. :: .. autoclass:: module.name::Noodle * :rst:dir:`autoclass` also recognizes the ``class-doc-from`` option that can be used to override the global value of :confval:`autoclass_content`. .. versionadded:: 4.1 .. rst:directive:: autofunction autodecorator autodata automethod autoattribute autoproperty These work exactly like :rst:dir:`autoclass` etc., but do not offer the options used for automatic member documentation. :rst:dir:`autodata` and :rst:dir:`autoattribute` support the ``annotation`` option. The option controls how the value of variable is shown. If specified without arguments, only the name of the variable will be printed, and its value is not shown:: .. autodata:: CD_DRIVE :annotation: If the option specified with arguments, it is printed after the name as a value of the variable:: .. autodata:: CD_DRIVE :annotation: = your CD device name By default, without ``annotation`` option, Sphinx tries to obtain the value of the variable and print it after the name. The ``no-value`` option can be used instead of a blank ``annotation`` to show the type hint but not the value:: .. autodata:: CD_DRIVE :no-value: If both the ``annotation`` and ``no-value`` options are used, ``no-value`` has no effect. For module data members and class attributes, documentation can either be put into a comment with special formatting (using a ``#:`` to start the comment instead of just ``#``), or in a docstring *after* the definition. Comments need to be either on a line of their own *before* the definition, or immediately after the assignment *on the same line*. The latter form is restricted to one line only. This means that in the following class definition, all attributes can be autodocumented:: class Foo: """Docstring for class Foo.""" #: Doc comment for class attribute Foo.bar. #: It can have multiple lines. bar = 1 flox = 1.5 #: Doc comment for Foo.flox. One line only. baz = 2 """Docstring for class attribute Foo.baz.""" def __init__(self): #: Doc comment for instance attribute qux. self.qux = 3 self.spam = 4 """Docstring for instance attribute spam.""" .. versionchanged:: 0.6 :rst:dir:`autodata` and :rst:dir:`autoattribute` can now extract docstrings. .. versionchanged:: 1.1 Comment docs are now allowed on the same line after an assignment. .. versionchanged:: 1.2 :rst:dir:`autodata` and :rst:dir:`autoattribute` have an ``annotation`` option. .. versionchanged:: 2.0 :rst:dir:`autodecorator` added. .. versionchanged:: 2.1 :rst:dir:`autoproperty` added. .. versionchanged:: 3.4 :rst:dir:`autodata` and :rst:dir:`autoattribute` now have a ``no-value`` option. .. note:: If you document decorated functions or methods, keep in mind that autodoc retrieves its docstrings by importing the module and inspecting the ``__doc__`` attribute of the given function or method. That means that if a decorator replaces the decorated function with another, it must copy the original ``__doc__`` to the new function. Configuration ------------- There are also config values that you can set: .. confval:: autoclass_content This value selects what content will be inserted into the main body of an :rst:dir:`autoclass` directive. The possible values are: ``"class"`` Only the class' docstring is inserted. This is the default. You can still document ``__init__`` as a separate method using :rst:dir:`automethod` or the ``members`` option to :rst:dir:`autoclass`. ``"both"`` Both the class' and the ``__init__`` method's docstring are concatenated and inserted. ``"init"`` Only the ``__init__`` method's docstring is inserted. .. versionadded:: 0.3 If the class has no ``__init__`` method or if the ``__init__`` method's docstring is empty, but the class has a ``__new__`` method's docstring, it is used instead. .. versionadded:: 1.4 .. confval:: autodoc_class_signature This value selects how the signautre will be displayed for the class defined by :rst:dir:`autoclass` directive. The possible values are: ``"mixed"`` Display the signature with the class name. ``"separated"`` Display the signature as a method. The default is ``"mixed"``. .. versionadded:: 4.1 .. confval:: autodoc_member_order This value selects if automatically documented members are sorted alphabetical (value ``'alphabetical'``), by member type (value ``'groupwise'``) or by source order (value ``'bysource'``). The default is alphabetical. Note that for source order, the module must be a Python module with the source code available. .. versionadded:: 0.6 .. versionchanged:: 1.0 Support for ``'bysource'``. .. confval:: autodoc_default_flags This value is a list of autodoc directive flags that should be automatically applied to all autodoc directives. The supported flags are ``'members'``, ``'undoc-members'``, ``'private-members'``, ``'special-members'``, ``'inherited-members'``, ``'show-inheritance'``, ``'ignore-module-all'`` and ``'exclude-members'``. .. versionadded:: 1.0 .. deprecated:: 1.8 Integrated into :confval:`autodoc_default_options`. .. confval:: autodoc_default_options The default options for autodoc directives. They are applied to all autodoc directives automatically. It must be a dictionary which maps option names to the values. For example:: autodoc_default_options = { 'members': 'var1, var2', 'member-order': 'bysource', 'special-members': '__init__', 'undoc-members': True, 'exclude-members': '__weakref__' } Setting ``None`` or ``True`` to the value is equivalent to giving only the option name to the directives. The supported options are ``'members'``, ``'member-order'``, ``'undoc-members'``, ``'private-members'``, ``'special-members'``, ``'inherited-members'``, ``'show-inheritance'``, ``'ignore-module-all'``, ``'imported-members'``, ``'exclude-members'`` and ``'class-doc-from'``. .. versionadded:: 1.8 .. versionchanged:: 2.0 Accepts ``True`` as a value. .. versionchanged:: 2.1 Added ``'imported-members'``. .. versionchanged:: 4.1 Added ``'class-doc-from'``. .. confval:: autodoc_docstring_signature Functions imported from C modules cannot be introspected, and therefore the signature for such functions cannot be automatically determined. However, it is an often-used convention to put the signature into the first line of the function's docstring. If this boolean value is set to ``True`` (which is the default), autodoc will look at the first line of the docstring for functions and methods, and if it looks like a signature, use the line as the signature and remove it from the docstring content. autodoc will continue to look for multiple signature lines, stopping at the first line that does not look like a signature. This is useful for declaring overloaded function signatures. .. versionadded:: 1.1 .. versionchanged:: 3.1 Support overloaded signatures .. versionchanged:: 4.0 Overloaded signatures do not need to be separated by a backslash .. confval:: autodoc_mock_imports This value contains a list of modules to be mocked up. This is useful when some external dependencies are not met at build time and break the building process. You may only specify the root package of the dependencies themselves and omit the sub-modules: .. code-block:: python autodoc_mock_imports = ["django"] Will mock all imports under the ``django`` package. .. versionadded:: 1.3 .. versionchanged:: 1.6 This config value only requires to declare the top-level modules that should be mocked. .. confval:: autodoc_typehints This value controls how to represent typehints. The setting takes the following values: * ``'signature'`` -- Show typehints in the signature (default) * ``'description'`` -- Show typehints as content of the function or method The typehints of overloaded functions or methods will still be represented in the signature. * ``'none'`` -- Do not show typehints * ``'both'`` -- Show typehints in the signature and as content of the function or method Overloaded functions or methods will not have typehints included in the description because it is impossible to accurately represent all possible overloads as a list of parameters. .. versionadded:: 2.1 .. versionadded:: 3.0 New option ``'description'`` is added. .. versionadded:: 4.1 New option ``'both'`` is added. .. confval:: autodoc_typehints_description_target This value controls whether the types of undocumented parameters and return values are documented when ``autodoc_typehints`` is set to ``description``. The default value is ``"all"``, meaning that types are documented for all parameters and return values, whether they are documented or not. When set to ``"documented"``, types will only be documented for a parameter or a return value that is already documented by the docstring. .. versionadded:: 4.0 .. confval:: autodoc_type_aliases A dictionary for users defined `type aliases`__ that maps a type name to the full-qualified object name. It is used to keep type aliases not evaluated in the document. Defaults to empty (``{}``). The type aliases are only available if your program enables `Postponed Evaluation of Annotations (PEP 563)`__ feature via ``from __future__ import annotations``. For example, there is code using a type alias:: from __future__ import annotations AliasType = Union[List[Dict[Tuple[int, str], Set[int]]], Tuple[str, List[str]]] def f() -> AliasType: ... If ``autodoc_type_aliases`` is not set, autodoc will generate internal mark-up from this code as following:: .. py:function:: f() -> Union[List[Dict[Tuple[int, str], Set[int]]], Tuple[str, List[str]]] ... If you set ``autodoc_type_aliases`` as ``{'AliasType': 'your.module.AliasType'}``, it generates the following document internally:: .. py:function:: f() -> your.module.AliasType: ... .. __: https://www.python.org/dev/peps/pep-0563/ .. __: https://mypy.readthedocs.io/en/latest/kinds_of_types.html#type-aliases .. versionadded:: 3.3 .. confval:: autodoc_preserve_defaults If True, the default argument values of functions will be not evaluated on generating document. It preserves them as is in the source code. .. versionadded:: 4.0 Added as an experimental feature. This will be integrated into autodoc core in the future. .. confval:: autodoc_warningiserror This value controls the behavior of :option:`sphinx-build -W` during importing modules. If ``False`` is given, autodoc forcedly suppresses the error if the imported module emits warnings. By default, ``True``. .. confval:: autodoc_inherit_docstrings This value controls the docstrings inheritance. If set to True the docstring for classes or methods, if not explicitly set, is inherited from parents. The default is ``True``. .. versionadded:: 1.7 .. confval:: suppress_warnings :noindex: :mod:`autodoc` supports to suppress warning messages via :confval:`suppress_warnings`. It allows following warnings types in addition: * autodoc * autodoc.import_object Docstring preprocessing ----------------------- autodoc provides the following additional events: .. event:: autodoc-process-docstring (app, what, name, obj, options, lines) .. versionadded:: 0.4 Emitted when autodoc has read and processed a docstring. *lines* is a list of strings -- the lines of the processed docstring -- that the event handler can modify **in place** to change what Sphinx puts into the output. :param app: the Sphinx application object :param what: the type of the object which the docstring belongs to (one of ``"module"``, ``"class"``, ``"exception"``, ``"function"``, ``"method"``, ``"attribute"``) :param name: the fully qualified name of the object :param obj: the object itself :param options: the options given to the directive: an object with attributes ``inherited_members``, ``undoc_members``, ``show_inheritance`` and ``noindex`` that are true if the flag option of same name was given to the auto directive :param lines: the lines of the docstring, see above .. event:: autodoc-before-process-signature (app, obj, bound_method) .. versionadded:: 2.4 Emitted before autodoc formats a signature for an object. The event handler can modify an object to change its signature. :param app: the Sphinx application object :param obj: the object itself :param bound_method: a boolean indicates an object is bound method or not .. event:: autodoc-process-signature (app, what, name, obj, options, signature, return_annotation) .. versionadded:: 0.5 Emitted when autodoc has formatted a signature for an object. The event handler can return a new tuple ``(signature, return_annotation)`` to change what Sphinx puts into the output. :param app: the Sphinx application object :param what: the type of the object which the docstring belongs to (one of ``"module"``, ``"class"``, ``"exception"``, ``"function"``, ``"method"``, ``"attribute"``) :param name: the fully qualified name of the object :param obj: the object itself :param options: the options given to the directive: an object with attributes ``inherited_members``, ``undoc_members``, ``show_inheritance`` and ``noindex`` that are true if the flag option of same name was given to the auto directive :param signature: function signature, as a string of the form ``"(parameter_1, parameter_2)"``, or ``None`` if introspection didn't succeed and signature wasn't specified in the directive. :param return_annotation: function return annotation as a string of the form ``" -> annotation"``, or ``None`` if there is no return annotation The :mod:`sphinx.ext.autodoc` module provides factory functions for commonly needed docstring processing in event :event:`autodoc-process-docstring`: .. autofunction:: cut_lines .. autofunction:: between .. event:: autodoc-process-bases (app, name, obj, options, bases) Emitted when autodoc has read and processed a class to determine the base-classes. *bases* is a list of classes that the event handler can modify **in place** to change what Sphinx puts into the output. It's emitted only if ``show-inheritance`` option given. :param app: the Sphinx application object :param name: the fully qualified name of the object :param obj: the object itself :param options: the options given to the class directive :param bases: the list of base classes signature. see above. .. versionadded:: 4.1 .. versionchanged:: 4.3 ``bases`` can contain a string as a base class name. It will be processed as reST mark-up'ed text. Skipping members ---------------- autodoc allows the user to define a custom method for determining whether a member should be included in the documentation by using the following event: .. event:: autodoc-skip-member (app, what, name, obj, skip, options) .. versionadded:: 0.5 Emitted when autodoc has to decide whether a member should be included in the documentation. The member is excluded if a handler returns ``True``. It is included if the handler returns ``False``. If more than one enabled extension handles the ``autodoc-skip-member`` event, autodoc will use the first non-``None`` value returned by a handler. Handlers should return ``None`` to fall back to the skipping behavior of autodoc and other enabled extensions. :param app: the Sphinx application object :param what: the type of the object which the docstring belongs to (one of ``"module"``, ``"class"``, ``"exception"``, ``"function"``, ``"method"``, ``"attribute"``) :param name: the fully qualified name of the object :param obj: the object itself :param skip: a boolean indicating if autodoc will skip this member if the user handler does not override the decision :param options: the options given to the directive: an object with attributes ``inherited_members``, ``undoc_members``, ``show_inheritance`` and ``noindex`` that are true if the flag option of same name was given to the auto directive ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163739.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/autosectionlabel.rst����������������������������������������������0000644�0000766�0000024�00000003052�00000000000�022472� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: rest :mod:`sphinx.ext.autosectionlabel` -- Allow reference sections using its title ============================================================================== .. module:: sphinx.ext.autosectionlabel :synopsis: Allow reference section its title. .. versionadded:: 1.4 This extension allows you to refer sections its title. This affects to the reference role (:rst:role:`ref`). For example:: A Plain Title ------------- This is the text of the section. It refers to the section title, see :ref:`A Plain Title`. Internally, this extension generates the labels for each section. If same section names are used in whole of document, any one is used for a target by default. The ``autosectionlabel_prefix_document`` configuration variable can be used to make headings which appear multiple times but in different documents unique. Configuration ------------- .. confval:: autosectionlabel_prefix_document True to prefix each section label with the name of the document it is in, followed by a colon. For example, ``index:Introduction`` for a section called ``Introduction`` that appears in document ``index.rst``. Useful for avoiding ambiguity when the same section heading appears in different documents. .. confval:: autosectionlabel_maxdepth If set, autosectionlabel chooses the sections for labeling by its depth. For example, when set 1 to ``autosectionlabel_maxdepth``, labels are generated only for top level sections, and deeper sections are not labeled. It defaults to ``None`` (disabled). ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/autosummary.rst���������������������������������������������������0000644�0000766�0000024�00000023705�00000000000�021532� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: rest :mod:`sphinx.ext.autosummary` -- Generate autodoc summaries =========================================================== .. module:: sphinx.ext.autosummary :synopsis: Generate autodoc summaries .. versionadded:: 0.6 This extension generates function/method/attribute summary lists, similar to those output e.g. by Epydoc and other API doc generation tools. This is especially useful when your docstrings are long and detailed, and putting each one of them on a separate page makes them easier to read. The :mod:`sphinx.ext.autosummary` extension does this in two parts: 1. There is an :rst:dir:`autosummary` directive for generating summary listings that contain links to the documented items, and short summary blurbs extracted from their docstrings. 2. A :rst:dir:`autosummary` directive also generates short "stub" files for the entries listed in its content. These files by default contain only the corresponding :mod:`sphinx.ext.autodoc` directive, but can be customized with templates. The :program:`sphinx-autogen` script is also able to generate "stub" files from command line. .. rst:directive:: autosummary Insert a table that contains links to documented items, and a short summary blurb (the first sentence of the docstring) for each of them. The :rst:dir:`autosummary` directive can also optionally serve as a :rst:dir:`toctree` entry for the included items. Optionally, stub ``.rst`` files for these items can also be automatically generated when :confval:`autosummary_generate` is `True`. For example, :: .. currentmodule:: sphinx .. autosummary:: environment.BuildEnvironment util.relative_uri produces a table like this: .. currentmodule:: sphinx .. autosummary:: environment.BuildEnvironment util.relative_uri .. currentmodule:: sphinx.ext.autosummary Autosummary preprocesses the docstrings and signatures with the same :event:`autodoc-process-docstring` and :event:`autodoc-process-signature` hooks as :mod:`~sphinx.ext.autodoc`. **Options** * If you want the :rst:dir:`autosummary` table to also serve as a :rst:dir:`toctree` entry, use the ``toctree`` option, for example:: .. autosummary:: :toctree: DIRNAME sphinx.environment.BuildEnvironment sphinx.util.relative_uri The ``toctree`` option also signals to the :program:`sphinx-autogen` script that stub pages should be generated for the entries listed in this directive. The option accepts a directory name as an argument; :program:`sphinx-autogen` will by default place its output in this directory. If no argument is given, output is placed in the same directory as the file that contains the directive. You can also use ``caption`` option to give a caption to the toctree. .. versionadded:: 3.1 caption option added. * If you don't want the :rst:dir:`autosummary` to show function signatures in the listing, include the ``nosignatures`` option:: .. autosummary:: :nosignatures: sphinx.environment.BuildEnvironment sphinx.util.relative_uri * You can specify a custom template with the ``template`` option. For example, :: .. autosummary:: :template: mytemplate.rst sphinx.environment.BuildEnvironment would use the template :file:`mytemplate.rst` in your :confval:`templates_path` to generate the pages for all entries listed. See `Customizing templates`_ below. .. versionadded:: 1.0 * You can specify the ``recursive`` option to generate documents for modules and sub-packages recursively. It defaults to disabled. For example, :: .. autosummary:: :recursive: sphinx.environment.BuildEnvironment .. versionadded:: 3.1 :program:`sphinx-autogen` -- generate autodoc stub pages -------------------------------------------------------- The :program:`sphinx-autogen` script can be used to conveniently generate stub documentation pages for items included in :rst:dir:`autosummary` listings. For example, the command :: $ sphinx-autogen -o generated *.rst will read all :rst:dir:`autosummary` tables in the :file:`*.rst` files that have the ``:toctree:`` option set, and output corresponding stub pages in directory ``generated`` for all documented items. The generated pages by default contain text of the form:: sphinx.util.relative_uri ======================== .. autofunction:: sphinx.util.relative_uri If the ``-o`` option is not given, the script will place the output files in the directories specified in the ``:toctree:`` options. For more information, refer to the :doc:`sphinx-autogen documentation </man/sphinx-autogen>` Generating stub pages automatically ----------------------------------- If you do not want to create stub pages with :program:`sphinx-autogen`, you can also use these config values: .. confval:: autosummary_context A dictionary of values to pass into the template engine's context for autosummary stubs files. .. versionadded:: 3.1 .. confval:: autosummary_generate Boolean indicating whether to scan all found documents for autosummary directives, and to generate stub pages for each. It is enabled by default. Can also be a list of documents for which stub pages should be generated. The new files will be placed in the directories specified in the ``:toctree:`` options of the directives. .. versionchanged:: 2.3 Emits :event:`autodoc-skip-member` event as :mod:`~sphinx.ext.autodoc` does. .. versionchanged:: 4.0 Enabled by default. .. confval:: autosummary_generate_overwrite If true, autosummary overwrites existing files by generated stub pages. Defaults to true (enabled). .. versionadded:: 3.0 .. confval:: autosummary_mock_imports This value contains a list of modules to be mocked up. See :confval:`autodoc_mock_imports` for more details. It defaults to :confval:`autodoc_mock_imports`. .. versionadded:: 2.0 .. confval:: autosummary_imported_members A boolean flag indicating whether to document classes and functions imported in modules. Default is ``False`` .. versionadded:: 2.1 .. confval:: autosummary_filename_map A dict mapping object names to filenames. This is necessary to avoid filename conflicts where multiple objects have names that are indistinguishable when case is ignored, on file systems where filenames are case-insensitive. .. versionadded:: 3.2 .. _autosummary-customizing-templates: Customizing templates --------------------- .. versionadded:: 1.0 You can customize the stub page templates, in a similar way as the HTML Jinja templates, see :ref:`templating`. (:class:`~sphinx.application.TemplateBridge` is not supported.) .. note:: If you find yourself spending much time tailoring the stub templates, this may indicate that it's a better idea to write custom narrative documentation instead. Autosummary uses the following Jinja template files: - :file:`autosummary/base.rst` -- fallback template - :file:`autosummary/module.rst` -- template for modules - :file:`autosummary/class.rst` -- template for classes - :file:`autosummary/function.rst` -- template for functions - :file:`autosummary/attribute.rst` -- template for class attributes - :file:`autosummary/method.rst` -- template for class methods The following variables available in the templates: .. currentmodule:: None .. data:: name Name of the documented object, excluding the module and class parts. .. data:: objname Name of the documented object, excluding the module parts. .. data:: fullname Full name of the documented object, including module and class parts. .. data:: module Name of the module the documented object belongs to. .. data:: class Name of the class the documented object belongs to. Only available for methods and attributes. .. data:: underline A string containing ``len(full_name) * '='``. Use the ``underline`` filter instead. .. data:: members List containing names of all members of the module or class. Only available for modules and classes. .. data:: inherited_members List containing names of all inherited members of class. Only available for classes. .. versionadded:: 1.8.0 .. data:: functions List containing names of "public" functions in the module. Here, "public" here means that the name does not start with an underscore. Only available for modules. .. data:: classes List containing names of "public" classes in the module. Only available for modules. .. data:: exceptions List containing names of "public" exceptions in the module. Only available for modules. .. data:: methods List containing names of "public" methods in the class. Only available for classes. .. data:: attributes List containing names of "public" attributes in the class/module. Only available for classes and modules. .. versionchanged:: 3.1 Attributes of modules are supported. .. data:: modules List containing names of "public" modules in the package. Only available for modules that are packages and the ``recursive`` option is on. .. versionadded:: 3.1 Additionally, the following filters are available .. function:: escape(s) Escape any special characters in the text to be used in formatting RST contexts. For instance, this prevents asterisks making things bold. This replaces the builtin Jinja `escape filter`_ that does html-escaping. .. function:: underline(s, line='=') :noindex: Add a title underline to a piece of text. For instance, ``{{ fullname | escape | underline }}`` should be used to produce the title of a page. .. note:: You can use the :rst:dir:`autosummary` directive in the stub pages. Stub pages are generated also based on these directives. .. _`escape filter`: https://jinja.palletsprojects.com/en/3.0.x/templates/#jinja-filters.escape �����������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/coverage.rst������������������������������������������������������0000644�0000766�0000024�00000003060�00000000000�020727� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������:mod:`sphinx.ext.coverage` -- Collect doc coverage stats ======================================================== .. module:: sphinx.ext.coverage :synopsis: Check Python modules and C API for coverage in the documentation. This extension features one additional builder, the :class:`CoverageBuilder`. .. class:: CoverageBuilder To use this builder, activate the coverage extension in your configuration file and give ``-b coverage`` on the command line. .. todo:: Write this section. Several configuration values can be used to specify what the builder should check: .. confval:: coverage_ignore_modules .. confval:: coverage_ignore_functions .. confval:: coverage_ignore_classes .. confval:: coverage_ignore_pyobjects List of `Python regular expressions`_. If any of these regular expressions matches any part of the full import path of a Python object, that Python object is excluded from the documentation coverage report. .. versionadded:: 2.1 .. confval:: coverage_c_path .. confval:: coverage_c_regexes .. confval:: coverage_ignore_c_items .. confval:: coverage_write_headline Set to ``False`` to not write headlines. .. versionadded:: 1.1 .. confval:: coverage_skip_undoc_in_source Skip objects that are not documented in the source with a docstring. ``False`` by default. .. versionadded:: 1.1 .. confval:: coverage_show_missing_items Print objects that are missing to standard output also. ``False`` by default. .. versionadded:: 3.1 .. _Python regular expressions: https://docs.python.org/library/re ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/doctest.rst�������������������������������������������������������0000644�0000766�0000024�00000027141�00000000000�020607� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: rest :mod:`sphinx.ext.doctest` -- Test snippets in the documentation =============================================================== .. module:: sphinx.ext.doctest :synopsis: Test snippets in the documentation. .. index:: pair: automatic; testing single: doctest pair: testing; snippets It is often helpful to include snippets of code in your documentation and demonstrate the results of executing them. But it is important to ensure that the documentation stays up-to-date with the code. This extension allows you to test such code snippets in the documentation in a natural way. If you mark the code blocks as shown here, the ``doctest`` builder will collect them and run them as doctest tests. Within each document, you can assign each snippet to a *group*. Each group consists of: * zero or more *setup code* blocks (e.g. importing the module to test) * one or more *test* blocks When building the docs with the ``doctest`` builder, groups are collected for each document and run one after the other, first executing setup code blocks, then the test blocks in the order they appear in the file. There are two kinds of test blocks: * *doctest-style* blocks mimic interactive sessions by interleaving Python code (including the interpreter prompt) and output. * *code-output-style* blocks consist of an ordinary piece of Python code, and optionally, a piece of output for that code. Directives ---------- The *group* argument below is interpreted as follows: if it is empty, the block is assigned to the group named ``default``. If it is ``*``, the block is assigned to all groups (including the ``default`` group). Otherwise, it must be a comma-separated list of group names. .. rst:directive:: .. testsetup:: [group] A setup code block. This code is not shown in the output for other builders, but executed before the doctests of the group(s) it belongs to. .. rst:directive:: .. testcleanup:: [group] A cleanup code block. This code is not shown in the output for other builders, but executed after the doctests of the group(s) it belongs to. .. versionadded:: 1.1 .. rst:directive:: .. doctest:: [group] A doctest-style code block. You can use standard :mod:`doctest` flags for controlling how actual output is compared with what you give as output. The default set of flags is specified by the :confval:`doctest_default_flags` configuration variable. This directive supports five options: * ``hide``, a flag option, hides the doctest block in other builders. By default it is shown as a highlighted doctest block. * ``options``, a string option, can be used to give a comma-separated list of doctest flags that apply to each example in the tests. (You still can give explicit flags per example, with doctest comments, but they will show up in other builders too.) * ``pyversion``, a string option, can be used to specify the required Python version for the example to be tested. For instance, in the following case the example will be tested only for Python versions greater than 3.3:: .. doctest:: :pyversion: > 3.3 The following operands are supported: * ``~=``: Compatible release clause * ``==``: Version matching clause * ``!=``: Version exclusion clause * ``<=``, ``>=``: Inclusive ordered comparison clause * ``<``, ``>``: Exclusive ordered comparison clause * ``===``: Arbitrary equality clause. ``pyversion`` option is followed `PEP-440: Version Specifiers <https://www.python.org/dev/peps/pep-0440/#version-specifiers>`__. .. versionadded:: 1.6 .. versionchanged:: 1.7 Supported PEP-440 operands and notations * ``trim-doctest-flags`` and ``no-trim-doctest-flags``, a flag option, doctest flags (comments looking like ``# doctest: FLAG, ...``) at the ends of lines and ``<BLANKLINE>`` markers are removed (or not removed) individually. Default is ``trim-doctest-flags``. Note that like with standard doctests, you have to use ``<BLANKLINE>`` to signal a blank line in the expected output. The ``<BLANKLINE>`` is removed when building presentation output (HTML, LaTeX etc.). Also, you can give inline doctest options, like in doctest:: >>> datetime.date.now() # doctest: +SKIP datetime.date(2008, 1, 1) They will be respected when the test is run, but stripped from presentation output. .. rst:directive:: .. testcode:: [group] A code block for a code-output-style test. This directive supports three options: * ``hide``, a flag option, hides the code block in other builders. By default it is shown as a highlighted code block. * ``trim-doctest-flags`` and ``no-trim-doctest-flags``, a flag option, doctest flags (comments looking like ``# doctest: FLAG, ...``) at the ends of lines and ``<BLANKLINE>`` markers are removed (or not removed) individually. Default is ``trim-doctest-flags``. .. note:: Code in a ``testcode`` block is always executed all at once, no matter how many statements it contains. Therefore, output will *not* be generated for bare expressions -- use ``print``. Example:: .. testcode:: 1+1 # this will give no output! print(2+2) # this will give output .. testoutput:: 4 Also, please be aware that since the doctest module does not support mixing regular output and an exception message in the same snippet, this applies to testcode/testoutput as well. .. rst:directive:: .. testoutput:: [group] The corresponding output, or the exception message, for the last :rst:dir:`testcode` block. This directive supports four options: * ``hide``, a flag option, hides the output block in other builders. By default it is shown as a literal block without highlighting. * ``options``, a string option, can be used to give doctest flags (comma-separated) just like in normal doctest blocks. * ``trim-doctest-flags`` and ``no-trim-doctest-flags``, a flag option, doctest flags (comments looking like ``# doctest: FLAG, ...``) at the ends of lines and ``<BLANKLINE>`` markers are removed (or not removed) individually. Default is ``trim-doctest-flags``. Example:: .. testcode:: print('Output text.') .. testoutput:: :hide: :options: -ELLIPSIS, +NORMALIZE_WHITESPACE Output text. The following is an example for the usage of the directives. The test via :rst:dir:`doctest` and the test via :rst:dir:`testcode` and :rst:dir:`testoutput` are equivalent. :: The parrot module ================= .. testsetup:: * import parrot The parrot module is a module about parrots. Doctest example: .. doctest:: >>> parrot.voom(3000) This parrot wouldn't voom if you put 3000 volts through it! Test-Output example: .. testcode:: parrot.voom(3000) This would output: .. testoutput:: This parrot wouldn't voom if you put 3000 volts through it! Skipping tests conditionally ---------------------------- ``skipif``, a string option, can be used to skip directives conditionally. This may be useful e.g. when a different set of tests should be run depending on the environment (hardware, network/VPN, optional dependencies or different versions of dependencies). The ``skipif`` option is supported by all of the doctest directives. Below are typical use cases for ``skipif`` when used for different directives: - :rst:dir:`testsetup` and :rst:dir:`testcleanup` - conditionally skip test setup and/or cleanup - customize setup/cleanup code per environment - :rst:dir:`doctest` - conditionally skip both a test and its output verification - :rst:dir:`testcode` - conditionally skip a test - customize test code per environment - :rst:dir:`testoutput` - conditionally skip output assertion for a skipped test - expect different output depending on the environment The value of the ``skipif`` option is evaluated as a Python expression. If the result is a true value, the directive is omitted from the test run just as if it wasn't present in the file at all. Instead of repeating an expression, the :confval:`doctest_global_setup` configuration option can be used to assign it to a variable which can then be used instead. Here's an example which skips some tests if Pandas is not installed: .. code-block:: py :caption: conf.py extensions = ['sphinx.ext.doctest'] doctest_global_setup = ''' try: import pandas as pd except ImportError: pd = None ''' .. code-block:: rst :caption: contents.rst .. testsetup:: :skipif: pd is None data = pd.Series([42]) .. doctest:: :skipif: pd is None >>> data.iloc[0] 42 .. testcode:: :skipif: pd is None print(data.iloc[-1]) .. testoutput:: :skipif: pd is None 42 Configuration ------------- The doctest extension uses the following configuration values: .. confval:: doctest_default_flags By default, these options are enabled: - ``ELLIPSIS``, allowing you to put ellipses in the expected output that match anything in the actual output; - ``IGNORE_EXCEPTION_DETAIL``, causing everything following the leftmost colon and any module information in the exception name to be ignored; - ``DONT_ACCEPT_TRUE_FOR_1``, rejecting "True" in the output where "1" is given -- the default behavior of accepting this substitution is a relic of pre-Python 2.2 times. .. versionadded:: 1.5 .. confval:: doctest_path A list of directories that will be added to :data:`sys.path` when the doctest builder is used. (Make sure it contains absolute paths.) .. confval:: doctest_global_setup Python code that is treated like it were put in a ``testsetup`` directive for *every* file that is tested, and for every group. You can use this to e.g. import modules you will always need in your doctests. .. versionadded:: 0.6 .. confval:: doctest_global_cleanup Python code that is treated like it were put in a ``testcleanup`` directive for *every* file that is tested, and for every group. You can use this to e.g. remove any temporary files that the tests leave behind. .. versionadded:: 1.1 .. confval:: doctest_test_doctest_blocks If this is a nonempty string (the default is ``'default'``), standard reST doctest blocks will be tested too. They will be assigned to the group name given. reST doctest blocks are simply doctests put into a paragraph of their own, like so:: Some documentation text. >>> print(1) 1 Some more documentation text. (Note that no special ``::`` is used to introduce a doctest block; docutils recognizes them from the leading ``>>>``. Also, no additional indentation is used, though it doesn't hurt.) If this value is left at its default value, the above snippet is interpreted by the doctest builder exactly like the following:: Some documentation text. .. doctest:: >>> print(1) 1 Some more documentation text. This feature makes it easy for you to test doctests in docstrings included with the :mod:`~sphinx.ext.autodoc` extension without marking them up with a special directive. Note though that you can't have blank lines in reST doctest blocks. They will be interpreted as one block ending and another one starting. Also, removal of ``<BLANKLINE>`` and ``# doctest:`` options only works in :rst:dir:`doctest` blocks, though you may set :confval:`trim_doctest_flags` to achieve that in all code blocks with Python console content. �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163739.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/duration.rst������������������������������������������������������0000644�0000766�0000024�00000000624�00000000000�020764� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������:mod:`sphinx.ext.duration` -- Measure durations of Sphinx processing ==================================================================== .. module:: sphinx.ext.duration :synopsis: Measure durations of Sphinx processing .. versionadded:: 2.4 This extension measures durations of Sphinx processing and show its result at end of the build. It is useful for inspecting what document is slowly built. ������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/example_google.py�������������������������������������������������0000644�0000766�0000024�00000023024�00000000000�021745� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������"""Example Google style docstrings. This module demonstrates documentation as specified by the `Google Python Style Guide`_. Docstrings may extend over multiple lines. Sections are created with a section header and a colon followed by a block of indented text. Example: Examples can be given using either the ``Example`` or ``Examples`` sections. Sections support any reStructuredText formatting, including literal blocks:: $ python example_google.py Section breaks are created by resuming unindented text. Section breaks are also implicitly created anytime a new section starts. Attributes: module_level_variable1 (int): Module level variables may be documented in either the ``Attributes`` section of the module docstring, or in an inline docstring immediately following the variable. Either form is acceptable, but the two should not be mixed. Choose one convention to document module level variables and be consistent with it. Todo: * For module TODOs * You have to also use ``sphinx.ext.todo`` extension .. _Google Python Style Guide: https://google.github.io/styleguide/pyguide.html """ module_level_variable1 = 12345 module_level_variable2 = 98765 """int: Module level variable documented inline. The docstring may span multiple lines. The type may optionally be specified on the first line, separated by a colon. """ def function_with_types_in_docstring(param1, param2): """Example function with types documented in the docstring. `PEP 484`_ type annotations are supported. If attribute, parameter, and return types are annotated according to `PEP 484`_, they do not need to be included in the docstring: Args: param1 (int): The first parameter. param2 (str): The second parameter. Returns: bool: The return value. True for success, False otherwise. .. _PEP 484: https://www.python.org/dev/peps/pep-0484/ """ def function_with_pep484_type_annotations(param1: int, param2: str) -> bool: """Example function with PEP 484 type annotations. Args: param1: The first parameter. param2: The second parameter. Returns: The return value. True for success, False otherwise. """ def module_level_function(param1, param2=None, *args, **kwargs): """This is an example of a module level function. Function parameters should be documented in the ``Args`` section. The name of each parameter is required. The type and description of each parameter is optional, but should be included if not obvious. If ``*args`` or ``**kwargs`` are accepted, they should be listed as ``*args`` and ``**kwargs``. The format for a parameter is:: name (type): description The description may span multiple lines. Following lines should be indented. The "(type)" is optional. Multiple paragraphs are supported in parameter descriptions. Args: param1 (int): The first parameter. param2 (:obj:`str`, optional): The second parameter. Defaults to None. Second line of description should be indented. *args: Variable length argument list. **kwargs: Arbitrary keyword arguments. Returns: bool: True if successful, False otherwise. The return type is optional and may be specified at the beginning of the ``Returns`` section followed by a colon. The ``Returns`` section may span multiple lines and paragraphs. Following lines should be indented to match the first line. The ``Returns`` section supports any reStructuredText formatting, including literal blocks:: { 'param1': param1, 'param2': param2 } Raises: AttributeError: The ``Raises`` section is a list of all exceptions that are relevant to the interface. ValueError: If `param2` is equal to `param1`. """ if param1 == param2: raise ValueError('param1 may not be equal to param2') return True def example_generator(n): """Generators have a ``Yields`` section instead of a ``Returns`` section. Args: n (int): The upper limit of the range to generate, from 0 to `n` - 1. Yields: int: The next number in the range of 0 to `n` - 1. Examples: Examples should be written in doctest format, and should illustrate how to use the function. >>> print([i for i in example_generator(4)]) [0, 1, 2, 3] """ for i in range(n): yield i class ExampleError(Exception): """Exceptions are documented in the same way as classes. The __init__ method may be documented in either the class level docstring, or as a docstring on the __init__ method itself. Either form is acceptable, but the two should not be mixed. Choose one convention to document the __init__ method and be consistent with it. Note: Do not include the `self` parameter in the ``Args`` section. Args: msg (str): Human readable string describing the exception. code (:obj:`int`, optional): Error code. Attributes: msg (str): Human readable string describing the exception. code (int): Exception error code. """ def __init__(self, msg, code): self.msg = msg self.code = code class ExampleClass: """The summary line for a class docstring should fit on one line. If the class has public attributes, they may be documented here in an ``Attributes`` section and follow the same formatting as a function's ``Args`` section. Alternatively, attributes may be documented inline with the attribute's declaration (see __init__ method below). Properties created with the ``@property`` decorator should be documented in the property's getter method. Attributes: attr1 (str): Description of `attr1`. attr2 (:obj:`int`, optional): Description of `attr2`. """ def __init__(self, param1, param2, param3): """Example of docstring on the __init__ method. The __init__ method may be documented in either the class level docstring, or as a docstring on the __init__ method itself. Either form is acceptable, but the two should not be mixed. Choose one convention to document the __init__ method and be consistent with it. Note: Do not include the `self` parameter in the ``Args`` section. Args: param1 (str): Description of `param1`. param2 (:obj:`int`, optional): Description of `param2`. Multiple lines are supported. param3 (list(str)): Description of `param3`. """ self.attr1 = param1 self.attr2 = param2 self.attr3 = param3 #: Doc comment *inline* with attribute #: list(str): Doc comment *before* attribute, with type specified self.attr4 = ['attr4'] self.attr5 = None """str: Docstring *after* attribute, with type specified.""" @property def readonly_property(self): """str: Properties should be documented in their getter method.""" return 'readonly_property' @property def readwrite_property(self): """list(str): Properties with both a getter and setter should only be documented in their getter method. If the setter method contains notable behavior, it should be mentioned here. """ return ['readwrite_property'] @readwrite_property.setter def readwrite_property(self, value): value def example_method(self, param1, param2): """Class methods are similar to regular functions. Note: Do not include the `self` parameter in the ``Args`` section. Args: param1: The first parameter. param2: The second parameter. Returns: True if successful, False otherwise. """ return True def __special__(self): """By default special members with docstrings are not included. Special members are any methods or attributes that start with and end with a double underscore. Any special member with a docstring will be included in the output, if ``napoleon_include_special_with_doc`` is set to True. This behavior can be enabled by changing the following setting in Sphinx's conf.py:: napoleon_include_special_with_doc = True """ pass def __special_without_docstring__(self): pass def _private(self): """By default private members are not included. Private members are any methods or attributes that start with an underscore and are *not* special. By default they are not included in the output. This behavior can be changed such that private members *are* included by changing the following setting in Sphinx's conf.py:: napoleon_include_private_with_doc = True """ pass def _private_without_docstring(self): pass class ExamplePEP526Class: """The summary line for a class docstring should fit on one line. If the class has public attributes, they may be documented here in an ``Attributes`` section and follow the same formatting as a function's ``Args`` section. If ``napoleon_attr_annotations`` is True, types can be specified in the class body using ``PEP 526`` annotations. Attributes: attr1: Description of `attr1`. attr2: Description of `attr2`. """ attr1: str attr2: int������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1609484009.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/example_google.rst������������������������������������������������0000644�0000766�0000024�00000000450�00000000000�022123� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������:orphan: .. _example_google: Example Google Style Python Docstrings ====================================== .. seealso:: :ref:`example_numpy` .. only:: builder_html Download: :download:`example_google.py <example_google.py>` .. literalinclude:: example_google.py :language: python ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163739.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/example_numpy.py��������������������������������������������������0000644�0000766�0000024�00000023104�00000000000�021640� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������"""Example NumPy style docstrings. This module demonstrates documentation as specified by the `NumPy Documentation HOWTO`_. Docstrings may extend over multiple lines. Sections are created with a section header followed by an underline of equal length. Example ------- Examples can be given using either the ``Example`` or ``Examples`` sections. Sections support any reStructuredText formatting, including literal blocks:: $ python example_numpy.py Section breaks are created with two blank lines. Section breaks are also implicitly created anytime a new section starts. Section bodies *may* be indented: Notes ----- This is an example of an indented section. It's like any other section, but the body is indented to help it stand out from surrounding text. If a section is indented, then a section break is created by resuming unindented text. Attributes ---------- module_level_variable1 : int Module level variables may be documented in either the ``Attributes`` section of the module docstring, or in an inline docstring immediately following the variable. Either form is acceptable, but the two should not be mixed. Choose one convention to document module level variables and be consistent with it. .. _NumPy Documentation HOWTO: https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt """ module_level_variable1 = 12345 module_level_variable2 = 98765 """int: Module level variable documented inline. The docstring may span multiple lines. The type may optionally be specified on the first line, separated by a colon. """ def function_with_types_in_docstring(param1, param2): """Example function with types documented in the docstring. `PEP 484`_ type annotations are supported. If attribute, parameter, and return types are annotated according to `PEP 484`_, they do not need to be included in the docstring: Parameters ---------- param1 : int The first parameter. param2 : str The second parameter. Returns ------- bool True if successful, False otherwise. .. _PEP 484: https://www.python.org/dev/peps/pep-0484/ """ def function_with_pep484_type_annotations(param1: int, param2: str) -> bool: """Example function with PEP 484 type annotations. The return type must be duplicated in the docstring to comply with the NumPy docstring style. Parameters ---------- param1 The first parameter. param2 The second parameter. Returns ------- bool True if successful, False otherwise. """ def module_level_function(param1, param2=None, *args, **kwargs): """This is an example of a module level function. Function parameters should be documented in the ``Parameters`` section. The name of each parameter is required. The type and description of each parameter is optional, but should be included if not obvious. If ``*args`` or ``**kwargs`` are accepted, they should be listed as ``*args`` and ``**kwargs``. The format for a parameter is:: name : type description The description may span multiple lines. Following lines should be indented to match the first line of the description. The ": type" is optional. Multiple paragraphs are supported in parameter descriptions. Parameters ---------- param1 : int The first parameter. param2 : :obj:`str`, optional The second parameter. *args Variable length argument list. **kwargs Arbitrary keyword arguments. Returns ------- bool True if successful, False otherwise. The return type is not optional. The ``Returns`` section may span multiple lines and paragraphs. Following lines should be indented to match the first line of the description. The ``Returns`` section supports any reStructuredText formatting, including literal blocks:: { 'param1': param1, 'param2': param2 } Raises ------ AttributeError The ``Raises`` section is a list of all exceptions that are relevant to the interface. ValueError If `param2` is equal to `param1`. """ if param1 == param2: raise ValueError('param1 may not be equal to param2') return True def example_generator(n): """Generators have a ``Yields`` section instead of a ``Returns`` section. Parameters ---------- n : int The upper limit of the range to generate, from 0 to `n` - 1. Yields ------ int The next number in the range of 0 to `n` - 1. Examples -------- Examples should be written in doctest format, and should illustrate how to use the function. >>> print([i for i in example_generator(4)]) [0, 1, 2, 3] """ for i in range(n): yield i class ExampleError(Exception): """Exceptions are documented in the same way as classes. The __init__ method may be documented in either the class level docstring, or as a docstring on the __init__ method itself. Either form is acceptable, but the two should not be mixed. Choose one convention to document the __init__ method and be consistent with it. Note ---- Do not include the `self` parameter in the ``Parameters`` section. Parameters ---------- msg : str Human readable string describing the exception. code : :obj:`int`, optional Numeric error code. Attributes ---------- msg : str Human readable string describing the exception. code : int Numeric error code. """ def __init__(self, msg, code): self.msg = msg self.code = code class ExampleClass: """The summary line for a class docstring should fit on one line. If the class has public attributes, they may be documented here in an ``Attributes`` section and follow the same formatting as a function's ``Args`` section. Alternatively, attributes may be documented inline with the attribute's declaration (see __init__ method below). Properties created with the ``@property`` decorator should be documented in the property's getter method. Attributes ---------- attr1 : str Description of `attr1`. attr2 : :obj:`int`, optional Description of `attr2`. """ def __init__(self, param1, param2, param3): """Example of docstring on the __init__ method. The __init__ method may be documented in either the class level docstring, or as a docstring on the __init__ method itself. Either form is acceptable, but the two should not be mixed. Choose one convention to document the __init__ method and be consistent with it. Note ---- Do not include the `self` parameter in the ``Parameters`` section. Parameters ---------- param1 : str Description of `param1`. param2 : list(str) Description of `param2`. Multiple lines are supported. param3 : :obj:`int`, optional Description of `param3`. """ self.attr1 = param1 self.attr2 = param2 self.attr3 = param3 #: Doc comment *inline* with attribute #: list(str): Doc comment *before* attribute, with type specified self.attr4 = ["attr4"] self.attr5 = None """str: Docstring *after* attribute, with type specified.""" @property def readonly_property(self): """str: Properties should be documented in their getter method.""" return "readonly_property" @property def readwrite_property(self): """list(str): Properties with both a getter and setter should only be documented in their getter method. If the setter method contains notable behavior, it should be mentioned here. """ return ["readwrite_property"] @readwrite_property.setter def readwrite_property(self, value): value def example_method(self, param1, param2): """Class methods are similar to regular functions. Note ---- Do not include the `self` parameter in the ``Parameters`` section. Parameters ---------- param1 The first parameter. param2 The second parameter. Returns ------- bool True if successful, False otherwise. """ return True def __special__(self): """By default special members with docstrings are not included. Special members are any methods or attributes that start with and end with a double underscore. Any special member with a docstring will be included in the output, if ``napoleon_include_special_with_doc`` is set to True. This behavior can be enabled by changing the following setting in Sphinx's conf.py:: napoleon_include_special_with_doc = True """ pass def __special_without_docstring__(self): pass def _private(self): """By default private members are not included. Private members are any methods or attributes that start with an underscore and are *not* special. By default they are not included in the output. This behavior can be changed such that private members *are* included by changing the following setting in Sphinx's conf.py:: napoleon_include_private_with_doc = True """ pass def _private_without_docstring(self): pass ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1609484009.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/example_numpy.rst�������������������������������������������������0000644�0000766�0000024�00000000444�00000000000�022022� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������:orphan: .. _example_numpy: Example NumPy Style Python Docstrings ====================================== .. seealso:: :ref:`example_google` .. only:: builder_html Download: :download:`example_numpy.py <example_numpy.py>` .. literalinclude:: example_numpy.py :language: python ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/extlinks.rst������������������������������������������������������0000644�0000766�0000024�00000004761�00000000000�021006� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������:mod:`sphinx.ext.extlinks` -- Markup to shorten external links ============================================================== .. module:: sphinx.ext.extlinks :synopsis: Allow inserting external links with common base URLs easily. .. moduleauthor:: Georg Brandl .. versionadded:: 1.0 This extension is meant to help with the common pattern of having many external links that point to URLs on one and the same site, e.g. links to bug trackers, version control web interfaces, or simply subpages in other websites. It does so by providing aliases to base URLs, so that you only need to give the subpage name when creating a link. Let's assume that you want to include many links to issues at the Sphinx tracker, at :samp:`https://github.com/sphinx-doc/sphinx/issues/{num}`. Typing this URL again and again is tedious, so you can use :mod:`~sphinx.ext.extlinks` to avoid repeating yourself. The extension adds a config value: .. confval:: extlinks This config value must be a dictionary of external sites, mapping unique short alias names to a *base URL* and a *caption*. For example, to create an alias for the above mentioned issues, you would add :: extlinks = {'issue': ('https://github.com/sphinx-doc/sphinx/issues/%s', 'issue %s')} Now, you can use the alias name as a new role, e.g. ``:issue:`123```. This then inserts a link to https://github.com/sphinx-doc/sphinx/issues/123. As you can see, the target given in the role is substituted in the *base URL* in the place of ``%s``. The link caption depends on the second item in the tuple, the *caption*: - If *caption* is ``None``, the link caption is the full URL. - If *caption* is a string, then it must contain ``%s`` exactly once. In this case the link caption is *caption* with the partial URL substituted for ``%s`` -- in the above example, the link caption would be ``issue 123``. To produce a literal ``%`` in either *base URL* or *caption*, use ``%%``:: extlinks = {'KnR': ('https://example.org/K%%26R/page/%s', '[K&R; page %s]')} You can also use the usual "explicit title" syntax supported by other roles that generate links, i.e. ``:issue:`this issue <123>```. In this case, the *caption* is not relevant. .. versionchanged:: 4.0 Support to substitute by '%s' in the caption. .. note:: Since links are generated from the role in the reading stage, they appear as ordinary links to e.g. the ``linkcheck`` builder. ���������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163739.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/githubpages.rst���������������������������������������������������0000644�0000766�0000024�00000000753�00000000000�021444� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������:mod:`sphinx.ext.githubpages` -- Publish HTML docs in GitHub Pages ================================================================== .. module:: sphinx.ext.githubpages :synopsis: Publish HTML docs in GitHub Pages .. versionadded:: 1.4 .. versionchanged:: 2.0 Support ``CNAME`` file This extension creates ``.nojekyll`` file on generated HTML directory to publish the document on GitHub Pages. It also creates a ``CNAME`` file for custom domains when :confval:`html_baseurl` set. ���������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/graphviz.rst������������������������������������������������������0000644�0000766�0000024�00000014224�00000000000�020772� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: rest :mod:`sphinx.ext.graphviz` -- Add Graphviz graphs ================================================= .. module:: sphinx.ext.graphviz :synopsis: Support for Graphviz graphs. .. versionadded:: 0.6 This extension allows you to embed `Graphviz <https://graphviz.org/>`_ graphs in your documents. It adds these directives: .. rst:directive:: graphviz Directive to embed graphviz code. The input code for ``dot`` is given as the content. For example:: .. graphviz:: digraph foo { "bar" -> "baz"; } In HTML output, the code will be rendered to a PNG or SVG image (see :confval:`graphviz_output_format`). In LaTeX output, the code will be rendered to an embeddable PDF file. You can also embed external dot files, by giving the file name as an argument to :rst:dir:`graphviz` and no additional content:: .. graphviz:: external.dot As for all file references in Sphinx, if the filename is absolute, it is taken as relative to the source directory. .. versionchanged:: 1.1 Added support for external files. .. rubric:: options .. rst:directive:option:: alt: alternate text :type: text The alternate text of the graph. By default, the graph code is used to the alternate text. .. versionadded:: 1.0 .. rst:directive:option:: align: alignment of the graph :type: left, center or right The horizontal alignment of the graph. .. versionadded:: 1.5 .. rst:directive:option:: caption: caption of the graph :type: text The caption of the graph. .. versionadded:: 1.1 .. rst:directive:option:: layout: layout type of the graph :type: text The layout of the graph (ex. ``dot``, ``neato`` and so on). A path to the graphviz commands are also allowed. By default, :confval:`graphviz_dot` is used. .. versionadded:: 1.4 .. versionchanged:: 2.2 Renamed from ``graphviz_dot`` .. rst:directive:option:: name: label :type: text The label of the graph. .. versionadded:: 1.6 .. rst:directive:option:: class: class names :type: a list of class names separated by spaces The class name of the graph. .. versionadded:: 2.4 .. rst:directive:: graph Directive for embedding a single undirected graph. The name is given as a directive argument, the contents of the graph are the directive content. This is a convenience directive to generate ``graph <name> { <content> }``. For example:: .. graph:: foo "bar" -- "baz"; .. note:: The graph name is passed unchanged to Graphviz. If it contains non-alphanumeric characters (e.g. a dash), you will have to double-quote it. .. rubric:: options Same as :rst:dir:`graphviz`. .. rst:directive:option:: alt: alternate text :type: text .. versionadded:: 1.0 .. rst:directive:option:: align: alignment of the graph :type: left, center or right .. versionadded:: 1.5 .. rst:directive:option:: caption: caption of the graph :type: text .. versionadded:: 1.1 .. rst:directive:option:: layout: layout type of the graph :type: text .. versionadded:: 1.4 .. versionchanged:: 2.2 Renamed from ``graphviz_dot`` .. rst:directive:option:: name: label :type: text .. versionadded:: 1.6 .. rst:directive:option:: class: class names :type: a list of class names separated by spaces The class name of the graph. .. versionadded:: 2.4 .. rst:directive:: digraph Directive for embedding a single directed graph. The name is given as a directive argument, the contents of the graph are the directive content. This is a convenience directive to generate ``digraph <name> { <content> }``. For example:: .. digraph:: foo "bar" -> "baz" -> "quux"; .. rubric:: options Same as :rst:dir:`graphviz`. .. rst:directive:option:: alt: alternate text :type: text .. versionadded:: 1.0 .. rst:directive:option:: align: alignment of the graph :type: left, center or right .. versionadded:: 1.5 .. rst:directive:option:: caption: caption of the graph :type: text .. versionadded:: 1.1 .. rst:directive:option:: layout: layout type of the graph :type: text .. versionadded:: 1.4 .. versionchanged:: 2.2 Renamed from ``graphviz_dot`` .. rst:directive:option:: name: label :type: text .. versionadded:: 1.6 .. rst:directive:option:: class: class names :type: a list of class names separated by spaces The class name of the graph. .. versionadded:: 2.4 There are also these config values: .. confval:: graphviz_dot The command name with which to invoke ``dot``. The default is ``'dot'``; you may need to set this to a full path if ``dot`` is not in the executable search path. Since this setting is not portable from system to system, it is normally not useful to set it in ``conf.py``; rather, giving it on the :program:`sphinx-build` command line via the :option:`-D <sphinx-build -D>` option should be preferable, like this:: sphinx-build -b html -D graphviz_dot=C:\graphviz\bin\dot.exe . _build/html .. confval:: graphviz_dot_args Additional command-line arguments to give to dot, as a list. The default is an empty list. This is the right place to set global graph, node or edge attributes via dot's ``-G``, ``-N`` and ``-E`` options. .. confval:: graphviz_output_format The output format for Graphviz when building HTML files. This must be either ``'png'`` or ``'svg'``; the default is ``'png'``. If ``'svg'`` is used, in order to make the URL links work properly, an appropriate ``target`` attribute must be set, such as ``"_top"`` and ``"_blank"``. For example, the link in the following graph should work in the svg output: :: .. graphviz:: digraph example { a [label="sphinx", href="https://www.sphinx-doc.org/", target="_top"]; b [label="other"]; a -> b; } .. versionadded:: 1.0 Previously, output always was PNG. ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163739.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/ifconfig.rst������������������������������������������������������0000644�0000766�0000024�00000002461�00000000000�020724� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: rest :mod:`sphinx.ext.ifconfig` -- Include content based on configuration ==================================================================== .. module:: sphinx.ext.ifconfig :synopsis: Include documentation content based on configuration values. This extension is quite simple, and features only one directive: .. warning:: This directive is designed to control only content of document. It could not control sections, labels and so on. .. rst:directive:: ifconfig Include content of the directive only if the Python expression given as an argument is ``True``, evaluated in the namespace of the project's configuration (that is, all registered variables from :file:`conf.py` are available). For example, one could write :: .. ifconfig:: releaselevel in ('alpha', 'beta', 'rc') This stuff is only included in the built docs for unstable versions. To make a custom config value known to Sphinx, use :func:`~sphinx.application.Sphinx.add_config_value` in the setup function in :file:`conf.py`, e.g.:: def setup(app): app.add_config_value('releaselevel', '', 'env') The second argument is the default value, the third should always be ``'env'`` for such values (it selects if Sphinx re-reads the documents if the value changes). ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/imgconverter.rst��������������������������������������������������0000644�0000766�0000024�00000003115�00000000000�021641� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. _sphinx.ext.imgconverter: :mod:`sphinx.ext.imgconverter` -- A reference image converter using Imagemagick =============================================================================== .. module:: sphinx.ext.imgconverter :synopsis: Convert images to appropriate format for builders .. versionadded:: 1.6 This extension converts images in your document to appropriate format for builders. For example, it allows you to use SVG images with LaTeX builder. As a result, you don't mind what image format the builder supports. Internally, this extension uses Imagemagick_ to convert images. .. _Imagemagick: https://www.imagemagick.org/script/index.php .. note:: Imagemagick rasterizes a SVG image on conversion. As a result, the image becomes not scalable. To avoid that, please use other image converters like `sphinxcontrib-svg2pdfconverter`__ (which uses Inkscape or ``rsvg-convert``). .. __: https://github.com/missinglinkelectronics/sphinxcontrib-svg2pdfconverter Configuration ------------- .. confval:: image_converter A path to :command:`convert` command. By default, the imgconverter uses the command from search paths. On windows platform, :command:`magick` command is used by default. .. versionchanged:: 3.1 Use :command:`magick` command by default on windows .. confval:: image_converter_args Additional command-line arguments to give to :command:`convert`, as a list. The default is an empty list ``[]``. On windows platform, it defaults to ``["convert"]``. .. versionchanged:: 3.1 Use ``["convert"]`` by default on windows ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/index.rst���������������������������������������������������������0000644�0000766�0000024�00000004405�00000000000�020247� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������========== Extensions ========== Since many projects will need special features in their documentation, Sphinx allows adding "extensions" to the build process, each of which can modify almost any aspect of document processing. This chapter describes the extensions bundled with Sphinx. For the API documentation on writing your own extension, refer to :ref:`dev-extensions`. .. _builtin-extensions: Built-in extensions ------------------- These extensions are built in and can be activated by respective entries in the :confval:`extensions` configuration value: .. toctree:: autodoc autosectionlabel autosummary coverage doctest duration extlinks githubpages graphviz ifconfig imgconverter inheritance intersphinx linkcode math napoleon todo viewcode .. _third-party-extensions: Third-party extensions ---------------------- You can find several extensions contributed by users in the `sphinx-contrib`__ organization. If you wish to include your extension in this organization, simply follow the instructions provided in the `github-administration`__ project. This is optional and there are several extensions hosted elsewhere. The `awesome-sphinxdoc`__ project contains a curated list of Sphinx packages, and many packages use the `Framework :: Sphinx :: Extension`__ and `Framework :: Sphinx :: Theme`__ trove classifiers for Sphinx extensions and themes, respectively. .. __: https://github.com/sphinx-contrib/ .. __: https://github.com/sphinx-contrib/github-administration .. __: https://github.com/yoloseem/awesome-sphinxdoc .. __: https://pypi.org/search/?c=Framework+%3A%3A+Sphinx+%3A%3A+Extension .. __: https://pypi.org/search/?c=Framework+%3A%3A+Sphinx+%3A%3A+Theme Where to put your own extensions? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Extensions local to a project should be put within the project's directory structure. Set Python's module search path, ``sys.path``, accordingly so that Sphinx can find them. For example, if your extension ``foo.py`` lies in the ``exts`` subdirectory of the project root, put into :file:`conf.py`:: import sys, os sys.path.append(os.path.abspath('exts')) extensions = ['foo'] You can also install extensions anywhere else on ``sys.path``, e.g. in the ``site-packages`` directory. �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163739.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/inheritance.rst���������������������������������������������������0000644�0000766�0000024�00000012445�00000000000�021434� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: rest :mod:`sphinx.ext.inheritance_diagram` -- Include inheritance diagrams ===================================================================== .. module:: sphinx.ext.inheritance_diagram :synopsis: Support for displaying inheritance diagrams via graphviz. .. versionadded:: 0.6 This extension allows you to include inheritance diagrams, rendered via the :mod:`Graphviz extension <sphinx.ext.graphviz>`. It adds this directive: .. rst:directive:: inheritance-diagram This directive has one or more arguments, each giving a module or class name. Class names can be unqualified; in that case they are taken to exist in the currently described module (see :rst:dir:`py:module`). For each given class, and each class in each given module, the base classes are determined. Then, from all classes and their base classes, a graph is generated which is then rendered via the graphviz extension to a directed graph. This directive supports an option called ``parts`` that, if given, must be an integer, advising the directive to keep that many dot-separated parts in the displayed names (from right to left). For example, ``parts=1`` will only display class names, without the names of the modules that contain them. .. versionchanged:: 2.0 The value of for ``parts`` can also be negative, indicating how many parts to drop from the left. For example, if all your class names start with ``lib.``, you can give ``:parts: -1`` to remove that prefix from the displayed node names. The directive also supports a ``private-bases`` flag option; if given, private base classes (those whose name starts with ``_``) will be included. You can use ``caption`` option to give a caption to the diagram. .. versionchanged:: 1.1 Added ``private-bases`` option; previously, all bases were always included. .. versionchanged:: 1.5 Added ``caption`` option It also supports a ``top-classes`` option which requires one or more class names separated by comma. If specified inheritance traversal will stop at the specified class names. Given the following Python module:: """ A / \ B C / \ / \ E D F """ class A: pass class B(A): pass class C(A): pass class D(B, C): pass class E(B): pass class F(C): pass If you have specified a module in the inheritance diagram like this:: .. inheritance-diagram:: dummy.test :top-classes: dummy.test.B, dummy.test.C any base classes which are ancestors to ``top-classes`` and are also defined in the same module will be rendered as stand alone nodes. In this example class A will be rendered as stand alone node in the graph. This is a known issue due to how this extension works internally. If you don't want class A (or any other ancestors) to be visible then specify only the classes you would like to generate the diagram for like this:: .. inheritance-diagram:: dummy.test.D dummy.test.E dummy.test.F :top-classes: dummy.test.B, dummy.test.C .. versionchanged:: 1.7 Added ``top-classes`` option to limit the scope of inheritance graphs. Examples -------- The following are different inheritance diagrams for the internal ``InheritanceDiagram`` class that implements the directive. With full names:: .. inheritance-diagram:: sphinx.ext.inheritance_diagram.InheritanceDiagram .. inheritance-diagram:: sphinx.ext.inheritance_diagram.InheritanceDiagram Showing class names only:: .. inheritance-diagram:: sphinx.ext.inheritance_diagram.InheritanceDiagram :parts: 1 .. inheritance-diagram:: sphinx.ext.inheritance_diagram.InheritanceDiagram :parts: 1 Stopping the diagram at :class:`sphinx.util.docutils.SphinxDirective` (the highest superclass still part of Sphinx), and dropping the common left-most part (``sphinx``) from all names:: .. inheritance-diagram:: sphinx.ext.inheritance_diagram.InheritanceDiagram :top-classes: sphinx.util.docutils.SphinxDirective :parts: -1 .. inheritance-diagram:: sphinx.ext.inheritance_diagram.InheritanceDiagram :top-classes: sphinx.util.docutils.SphinxDirective :parts: -1 Configuration ------------- .. confval:: inheritance_graph_attrs A dictionary of graphviz graph attributes for inheritance diagrams. For example:: inheritance_graph_attrs = dict(rankdir="LR", size='"6.0, 8.0"', fontsize=14, ratio='compress') .. confval:: inheritance_node_attrs A dictionary of graphviz node attributes for inheritance diagrams. For example:: inheritance_node_attrs = dict(shape='ellipse', fontsize=14, height=0.75, color='dodgerblue1', style='filled') .. confval:: inheritance_edge_attrs A dictionary of graphviz edge attributes for inheritance diagrams. .. confval:: inheritance_alias Allows mapping the full qualified name of the class to custom values (useful when exposing the underlying path of a class is not desirable, e.g. it's a private class and should not be instantiated by the user). For example:: inheritance_alias = {'_pytest.Magic': 'pytest.Magic'} ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/intersphinx.rst���������������������������������������������������0000644�0000766�0000024�00000017732�00000000000�021522� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������:mod:`sphinx.ext.intersphinx` -- Link to other projects' documentation ====================================================================== .. module:: sphinx.ext.intersphinx :synopsis: Link to other Sphinx documentation. .. index:: pair: automatic; linking .. versionadded:: 0.5 This extension can generate automatic links to the documentation of objects in other projects. Usage is simple: whenever Sphinx encounters a cross-reference that has no matching target in the current documentation set, it looks for targets in the documentation sets configured in :confval:`intersphinx_mapping`. A reference like ``:py:class:`zipfile.ZipFile``` can then link to the Python documentation for the ZipFile class, without you having to specify where it is located exactly. When using the "new" format (see below), you can even force lookup in a foreign set by prefixing the link target appropriately. A link like ``:ref:`comparison manual <python:comparisons>``` will then link to the label "comparisons" in the doc set "python", if it exists. Behind the scenes, this works as follows: * Each Sphinx HTML build creates a file named :file:`objects.inv` that contains a mapping from object names to URIs relative to the HTML set's root. * Projects using the Intersphinx extension can specify the location of such mapping files in the :confval:`intersphinx_mapping` config value. The mapping will then be used to resolve otherwise missing references to objects into links to the other documentation. * By default, the mapping file is assumed to be at the same location as the rest of the documentation; however, the location of the mapping file can also be specified individually, e.g. if the docs should be buildable without Internet access. Configuration ------------- To use Intersphinx linking, add ``'sphinx.ext.intersphinx'`` to your :confval:`extensions` config value, and use these config values to activate linking: .. confval:: intersphinx_mapping This config value contains the locations and names of other projects that should be linked to in this documentation. Relative local paths for target locations are taken as relative to the base of the built documentation, while relative local paths for inventory locations are taken as relative to the source directory. When fetching remote inventory files, proxy settings will be read from the ``$HTTP_PROXY`` environment variable. **Old format for this config value** This is the format used before Sphinx 1.0. It is still recognized. A dictionary mapping URIs to either ``None`` or an URI. The keys are the base URI of the foreign Sphinx documentation sets and can be local paths or HTTP URIs. The values indicate where the inventory file can be found: they can be ``None`` (at the same location as the base URI) or another local or HTTP URI. **New format for this config value** .. versionadded:: 1.0 A dictionary mapping unique identifiers to a tuple ``(target, inventory)``. Each ``target`` is the base URI of a foreign Sphinx documentation set and can be a local path or an HTTP URI. The ``inventory`` indicates where the inventory file can be found: it can be ``None`` (an :file:`objects.inv` file at the same location as the base URI) or another local file path or a full HTTP URI to an inventory file. The unique identifier can be used to prefix cross-reference targets, so that it is clear which intersphinx set the target belongs to. A link like ``:ref:`comparison manual <python:comparisons>``` will link to the label "comparisons" in the doc set "python", if it exists. **Example** To add links to modules and objects in the Python standard library documentation, use:: intersphinx_mapping = {'python': ('https://docs.python.org/3', None)} This will download the corresponding :file:`objects.inv` file from the Internet and generate links to the pages under the given URI. The downloaded inventory is cached in the Sphinx environment, so it must be re-downloaded whenever you do a full rebuild. A second example, showing the meaning of a non-``None`` value of the second tuple item:: intersphinx_mapping = {'python': ('https://docs.python.org/3', 'python-inv.txt')} This will read the inventory from :file:`python-inv.txt` in the source directory, but still generate links to the pages under ``https://docs.python.org/3``. It is up to you to update the inventory file as new objects are added to the Python documentation. **Multiple targets for the inventory** .. versionadded:: 1.3 Alternative files can be specified for each inventory. One can give a tuple for the second inventory tuple item as shown in the following example. This will read the inventory iterating through the (second) tuple items until the first successful fetch. The primary use case for this to specify mirror sites for server downtime of the primary inventory:: intersphinx_mapping = {'python': ('https://docs.python.org/3', (None, 'python-inv.txt'))} For a set of books edited and tested locally and then published together, it could be helpful to try a local inventory file first, to check references before publication:: intersphinx_mapping = { 'otherbook': ('https://myproj.readthedocs.io/projects/otherbook/en/latest', ('../../otherbook/build/html/objects.inv', None)), } .. confval:: intersphinx_cache_limit The maximum number of days to cache remote inventories. The default is ``5``, meaning five days. Set this to a negative value to cache inventories for unlimited time. .. confval:: intersphinx_timeout The number of seconds for timeout. The default is ``None``, meaning do not timeout. .. note:: 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. .. confval:: intersphinx_disabled_reftypes .. versionadded:: 4.3 A list of strings being either: - the name of a specific reference type in a domain, e.g., ``std:doc``, ``py:func``, or ``cpp:class``, - the name of a domain, and a wildcard, e.g., ``std:*``, ``py:*``, or ``cpp:*``, or - simply a wildcard ``*``. The default value is an empty list. When a cross-reference without an explicit inventory specification is being resolved by intersphinx, skip resolution if it matches one of the specifications in this list. For example, with ``intersphinx_disabled_reftypes = ['std:doc']`` a cross-reference ``:doc:`installation``` will not be attempted to be resolved by intersphinx, but ``:doc:`otherbook: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. If ``*`` is in the list of domains, then no references without an explicit inventory will be resolved by intersphinx. Showing all links of an Intersphinx mapping file ------------------------------------------------ To show all Intersphinx links and their targets of an Intersphinx mapping file, run ``python -msphinx.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 3 documentation:: $ python -m sphinx.ext.intersphinx https://docs.python.org/3/objects.inv Using Intersphinx with inventory file under Basic Authorization --------------------------------------------------------------- Intersphinx supports Basic Authorization like this:: intersphinx_mapping = {'python': ('https://user:password@docs.python.org/3', None)} The user and password will be stripped from the URL when generating the links. ��������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1609484009.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/linkcode.rst������������������������������������������������������0000644�0000766�0000024�00000003334�00000000000�020730� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������:mod:`sphinx.ext.linkcode` -- Add external links to source code =============================================================== .. module:: sphinx.ext.linkcode :synopsis: Add external links to source code. .. moduleauthor:: Pauli Virtanen .. versionadded:: 1.2 This extension looks at your object descriptions (``.. class::``, ``.. function::`` etc.) and adds external links to code hosted somewhere on the web. The intent is similar to the ``sphinx.ext.viewcode`` extension, but assumes the source code can be found somewhere on the Internet. In your configuration, you need to specify a :confval:`linkcode_resolve` function that returns an URL based on the object. Configuration ------------- .. confval:: linkcode_resolve This is a function ``linkcode_resolve(domain, info)``, which should return the URL to source code corresponding to the object in given domain with given information. The function should return ``None`` if no link is to be added. The argument ``domain`` specifies the language domain the object is in. ``info`` is a dictionary with the following keys guaranteed to be present (dependent on the domain): - ``py``: ``module`` (name of the module), ``fullname`` (name of the object) - ``c``: ``names`` (list of names for the object) - ``cpp``: ``names`` (list of names for the object) - ``javascript``: ``object`` (name of the object), ``fullname`` (name of the item) Example: .. code-block:: python def linkcode_resolve(domain, info): if domain != 'py': return None if not info['module']: return None filename = info['module'].replace('.', '/') return "https://somesite/sourcerepo/%s.py" % filename ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1638029276.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/math.rst����������������������������������������������������������0000644�0000766�0000024�00000024330�00000000000�020070� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: rest .. _math-support: Math support for HTML outputs in Sphinx ======================================= .. module:: sphinx.ext.mathbase :synopsis: Common math support for imgmath and mathjax / jsmath. .. versionadded:: 0.5 .. versionchanged:: 1.8 Math support for non-HTML builders is integrated to sphinx-core. So mathbase extension is no longer needed. Since mathematical notation isn't natively supported by HTML in any way, Sphinx gives a math support to HTML document with several extensions. These use the reStructuredText math :rst:dir:`directive <math>` and :rst:role:`role <math>`. :mod:`sphinx.ext.imgmath` -- Render math as images -------------------------------------------------- .. module:: sphinx.ext.imgmath :synopsis: Render math as PNG or SVG images. .. versionadded:: 1.4 This extension renders math via LaTeX and dvipng_ or dvisvgm_ into PNG or SVG images. This of course means that the computer where the docs are built must have both programs available. There are various configuration values you can set to influence how the images are built: .. confval:: imgmath_image_format The output image format. The default is ``'png'``. It should be either ``'png'`` or ``'svg'``. The image is produced by first executing ``latex`` on the TeX mathematical mark-up then (depending on the requested format) either `dvipng`_ or `dvisvgm`_. .. confval:: imgmath_use_preview ``dvipng`` and ``dvisvgm`` both have the ability to collect from LaTeX the "depth" of the rendered math: an inline image should use this "depth" in a ``vertical-align`` style to get correctly aligned with surrounding text. This mechanism requires the `LaTeX preview package`_ (available as ``preview-latex-style`` on Ubuntu xenial). Therefore, the default for this option is ``False`` but it is strongly recommended to set it to ``True``. .. versionchanged:: 2.2 This option can be used with the ``'svg'`` :confval:`imgmath_image_format`. .. confval:: imgmath_add_tooltips Default: ``True``. If false, do not add the LaTeX code as an "alt" attribute for math images. .. confval:: imgmath_font_size The font size (in ``pt``) of the displayed math. The default value is ``12``. It must be a positive integer. .. confval:: imgmath_latex The command name with which to invoke LaTeX. The default is ``'latex'``; you may need to set this to a full path if ``latex`` is not in the executable search path. Since this setting is not portable from system to system, it is normally not useful to set it in ``conf.py``; rather, giving it on the :program:`sphinx-build` command line via the :option:`-D <sphinx-build -D>` option should be preferable, like this:: sphinx-build -b html -D imgmath_latex=C:\tex\latex.exe . _build/html This value should only contain the path to the latex executable, not further arguments; use :confval:`imgmath_latex_args` for that purpose. .. hint:: Some fancy LaTeX mark-up (an example was reported which used TikZ to add various decorations to the equation) require multiple runs of the LaTeX executable. To handle this, set this configuration setting to ``'latexmk'`` (or a full path to it) as this Perl script reliably chooses dynamically how many latex runs are needed. .. confval:: imgmath_latex_args Additional arguments to give to latex, as a list. The default is an empty list. .. confval:: imgmath_latex_preamble Additional LaTeX code to put into the preamble of the LaTeX files used to translate the math snippets. This is left empty by default. Use it e.g. to add packages which modify the fonts used for math, such as ``'\\usepackage{newtxsf}'`` for sans-serif fonts, or ``'\\usepackage{fouriernc}'`` for serif fonts. Indeed, the default LaTeX math fonts have rather thin glyphs which (in HTML output) often do not match well with the font for text. .. confval:: imgmath_dvipng The command name to invoke ``dvipng``. The default is ``'dvipng'``; you may need to set this to a full path if ``dvipng`` is not in the executable search path. This option is only used when ``imgmath_image_format`` is set to ``'png'``. .. confval:: imgmath_dvipng_args Additional arguments to give to dvipng, as a list. The default value is ``['-gamma', '1.5', '-D', '110', '-bg', 'Transparent']`` which makes the image a bit darker and larger then it is by default (this compensates somewhat for the thinness of default LaTeX math fonts), and produces PNGs with a transparent background. This option is used only when ``imgmath_image_format`` is ``'png'``. .. confval:: imgmath_dvisvgm The command name to invoke ``dvisvgm``. The default is ``'dvisvgm'``; you may need to set this to a full path if ``dvisvgm`` is not in the executable search path. This option is only used when ``imgmath_image_format`` is ``'svg'``. .. confval:: imgmath_dvisvgm_args Additional arguments to give to dvisvgm, as a list. The default value is ``['--no-fonts']``, which means that ``dvisvgm`` will render glyphs as path elements (cf the `dvisvgm FAQ`_). This option is used only when ``imgmath_image_format`` is ``'svg'``. :mod:`sphinx.ext.mathjax` -- Render math via JavaScript ------------------------------------------------------- .. module:: sphinx.ext.mathjax :synopsis: Render math using JavaScript via MathJax. .. warning:: Version 4.0 changes the version of MathJax used to version 3. You may need to override ``mathjax_path`` to ``https://cdn.jsdelivr.net/npm/mathjax@2/MathJax.js?config=TeX-AMS-MML_HTMLorMML`` or update your configuration options for version 3 (see :confval:`mathjax3_config`). .. versionadded:: 1.1 This extension puts math as-is into the HTML files. The JavaScript package MathJax_ is then loaded and transforms the LaTeX markup to readable math live in the browser. Because MathJax (and the necessary fonts) is very large, it is not included in Sphinx but is set to automatically include it from a third-party site. .. attention:: You should use the math :rst:dir:`directive <math>` and :rst:role:`role <math>`, not the native MathJax ``$$``, ``\(``, etc. .. confval:: mathjax_path The path to the JavaScript file to include in the HTML files in order to load MathJax. The default is the ``https://`` URL that loads the JS files from the `jsdelivr`__ Content Delivery Network. See the `MathJax Getting Started page`__ for details. If you want MathJax to be available offline or without including resources from a third-party site, you have to download it and set this value to a different path. __ https://www.jsdelivr.com/ __ https://www.mathjax.org/#gettingstarted The path can be absolute or relative; if it is relative, it is relative to the ``_static`` directory of the built docs. For example, if you put MathJax into the static path of the Sphinx docs, this value would be ``MathJax/MathJax.js``. If you host more than one Sphinx documentation set on one server, it is advisable to install MathJax in a shared location. You can also give a full ``https://`` URL different from the CDN URL. .. confval:: mathjax_options The options to script tag for mathjax. For example, you can set integrity option with following setting:: mathjax_options = { 'integrity': 'sha384-......', } The default is empty (``{}``). .. versionadded:: 1.8 .. versionchanged:: 4.4.1 Allow to change the loading method (async or defer) of MathJax if "async" or "defer" key is set. .. confval:: mathjax3_config The configuration options for MathJax v3 (which is used by default). The given dictionary is assigned to the JavaScript variable ``window.MathJax``. For more information, please read `Configuring MathJax`__. __ https://docs.mathjax.org/en/latest/web/configuration.html#configuration The default is empty (not configured). .. versionadded:: 4.0 .. confval:: mathjax2_config The configuration options for MathJax v2 (which can be loaded via :confval:`mathjax_path`). The value is used as a parameter of ``MathJax.Hub.Config()``. For more information, please read `Using in-line configuration options`__. __ https://docs.mathjax.org/en/v2.7-latest/ configuration.html#using-in-line-configuration-options For example:: mathjax2_config = { 'extensions': ['tex2jax.js'], 'jax': ['input/TeX', 'output/HTML-CSS'], } The default is empty (not configured). .. versionadded:: 4.0 :confval:`mathjax_config` has been renamed to :confval:`mathjax2_config`. .. confval:: mathjax_config Former name of :confval:`mathjax2_config`. For help converting your old MathJax configuration to to the new :confval:`mathjax3_config`, see `Converting Your v2 Configuration to v3`__. __ https://docs.mathjax.org/en/latest/web/ configuration.html#converting-your-v2-configuration-to-v3 .. versionadded:: 1.8 .. versionchanged:: 4.0 This has been renamed to :confval:`mathjax2_config`. :confval:`mathjax_config` is still supported for backwards compatibility. :mod:`sphinx.ext.jsmath` -- Render math via JavaScript ------------------------------------------------------ .. module:: sphinx.ext.jsmath :synopsis: Render math using JavaScript via JSMath. This extension works just as the MathJax extension does, but uses the older package jsMath_. It provides this config value: .. confval:: jsmath_path The path to the JavaScript file to include in the HTML files in order to load JSMath. There is no default. The path can be absolute or relative; if it is relative, it is relative to the ``_static`` directory of the built docs. For example, if you put JSMath into the static path of the Sphinx docs, this value would be ``jsMath/easy/load.js``. If you host more than one Sphinx documentation set on one server, it is advisable to install jsMath in a shared location. .. _dvipng: https://savannah.nongnu.org/projects/dvipng/ .. _dvisvgm: https://dvisvgm.de/ .. _dvisvgm FAQ: https://dvisvgm.de/FAQ .. _MathJax: https://www.mathjax.org/ .. _jsMath: http://www.math.union.edu/~dpvc/jsmath/ .. _LaTeX preview package: https://www.gnu.org/software/auctex/preview-latex.html ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/napoleon.rst������������������������������������������������������0000644�0000766�0000024�00000037630�00000000000�020761� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������:mod:`sphinx.ext.napoleon` -- Support for NumPy and Google style docstrings =========================================================================== .. module:: sphinx.ext.napoleon :synopsis: Support for NumPy and Google style docstrings .. moduleauthor:: Rob Ruana .. versionadded:: 1.3 Overview -------- .. highlight:: text Are you tired of writing docstrings that look like this:: :param path: The path of the file to wrap :type path: str :param field_storage: The :class:`FileStorage` instance to wrap :type field_storage: FileStorage :param temporary: Whether or not to delete the file when the File instance is destructed :type temporary: bool :returns: A buffered writable file descriptor :rtype: BufferedFileStorage `reStructuredText`_ is great, but it creates visually dense, hard to read `docstrings`_. Compare the jumble above to the same thing rewritten according to the `Google Python Style Guide`_:: Args: path (str): The path of the file to wrap field_storage (FileStorage): The :class:`FileStorage` instance to wrap temporary (bool): Whether or not to delete the file when the File instance is destructed Returns: BufferedFileStorage: A buffered writable file descriptor Much more legible, no? Napoleon is a :term:`extension` that enables Sphinx to parse both `NumPy`_ and `Google`_ style docstrings - the style recommended by `Khan Academy`_. Napoleon is a pre-processor that parses `NumPy`_ and `Google`_ style docstrings and converts them to reStructuredText before Sphinx attempts to parse them. This happens in an intermediate step while Sphinx is processing the documentation, so it doesn't modify any of the docstrings in your actual source code files. .. _ReStructuredText: https://docutils.sourceforge.io/rst.html .. _docstrings: https://www.python.org/dev/peps/pep-0287/ .. _Google Python Style Guide: https://google.github.io/styleguide/pyguide.html .. _Google: https://google.github.io/styleguide/pyguide.html#Comments .. _NumPy: https://numpydoc.readthedocs.io/en/latest/format.html#docstring-standard .. _Khan Academy: https://github.com/Khan/style-guides/blob/master/style/python.md#docstrings Getting Started ~~~~~~~~~~~~~~~ 1. After :doc:`setting up Sphinx </usage/quickstart>` to build your docs, enable napoleon in the Sphinx `conf.py` file:: # conf.py # Add napoleon to the extensions list extensions = ['sphinx.ext.napoleon'] 2. Use `sphinx-apidoc` to build your API documentation:: $ sphinx-apidoc -f -o docs/source projectdir Docstrings ~~~~~~~~~~ Napoleon interprets every docstring that :mod:`autodoc <sphinx.ext.autodoc>` can find, including docstrings on: ``modules``, ``classes``, ``attributes``, ``methods``, ``functions``, and ``variables``. Inside each docstring, specially formatted `Sections`_ are parsed and converted to reStructuredText. All standard reStructuredText formatting still works as expected. .. _Sections: Docstring Sections ~~~~~~~~~~~~~~~~~~ All of the following section headers are supported: * ``Args`` *(alias of Parameters)* * ``Arguments`` *(alias of Parameters)* * ``Attention`` * ``Attributes`` * ``Caution`` * ``Danger`` * ``Error`` * ``Example`` * ``Examples`` * ``Hint`` * ``Important`` * ``Keyword Args`` *(alias of Keyword Arguments)* * ``Keyword Arguments`` * ``Methods`` * ``Note`` * ``Notes`` * ``Other Parameters`` * ``Parameters`` * ``Return`` *(alias of Returns)* * ``Returns`` * ``Raise`` *(alias of Raises)* * ``Raises`` * ``References`` * ``See Also`` * ``Tip`` * ``Todo`` * ``Warning`` * ``Warnings`` *(alias of Warning)* * ``Warn`` *(alias of Warns)* * ``Warns`` * ``Yield`` *(alias of Yields)* * ``Yields`` Google vs NumPy ~~~~~~~~~~~~~~~ Napoleon supports two styles of docstrings: `Google`_ and `NumPy`_. The main difference between the two styles is that Google uses indentation to separate sections, whereas NumPy uses underlines. Google style: .. code-block:: python3 def func(arg1, arg2): """Summary line. Extended description of function. Args: arg1 (int): Description of arg1 arg2 (str): Description of arg2 Returns: bool: Description of return value """ return True NumPy style: .. code-block:: python3 def func(arg1, arg2): """Summary line. Extended description of function. Parameters ---------- arg1 : int Description of arg1 arg2 : str Description of arg2 Returns ------- bool Description of return value """ return True NumPy style tends to require more vertical space, whereas Google style tends to use more horizontal space. Google style tends to be easier to read for short and simple docstrings, whereas NumPy style tends be easier to read for long and in-depth docstrings. The `Khan Academy`_ recommends using Google style. The choice between styles is largely aesthetic, but the two styles should not be mixed. Choose one style for your project and be consistent with it. .. seealso:: For complete examples: * :ref:`example_google` * :ref:`example_numpy` Type Annotations ~~~~~~~~~~~~~~~~ `PEP 484`_ introduced a standard way to express types in Python code. This is an alternative to expressing types directly in docstrings. One benefit of expressing types according to `PEP 484`_ is that type checkers and IDEs can take advantage of them for static code analysis. `PEP 484`_ was then extended by `PEP 526`_ which introduced a similar way to annotate variables (and attributes). Google style with Python 3 type annotations:: def func(arg1: int, arg2: str) -> bool: """Summary line. Extended description of function. Args: arg1: Description of arg1 arg2: Description of arg2 Returns: Description of return value """ return True class Class: """Summary line. Extended description of class Attributes: attr1: Description of attr1 attr2: Description of attr2 """ attr1: int attr2: str Google style with types in docstrings:: def func(arg1, arg2): """Summary line. Extended description of function. Args: arg1 (int): Description of arg1 arg2 (str): Description of arg2 Returns: bool: Description of return value """ return True class Class: """Summary line. Extended description of class Attributes: attr1 (int): Description of attr1 attr2 (str): Description of attr2 """ .. Note:: `Python 2/3 compatible annotations`_ aren't currently supported by Sphinx and won't show up in the docs. .. _PEP 484: https://www.python.org/dev/peps/pep-0484/ .. _PEP 526: https://www.python.org/dev/peps/pep-0526/ .. _Python 2/3 compatible annotations: https://www.python.org/dev/peps/pep-0484/#suggested-syntax-for-python-2-7-and-straddling-code Configuration ------------- Listed below are all the settings used by napoleon and their default values. These settings can be changed in the Sphinx `conf.py` file. Make sure that "sphinx.ext.napoleon" is enabled in `conf.py`:: # conf.py # Add any Sphinx extension module names here, as strings extensions = ['sphinx.ext.napoleon'] # Napoleon settings napoleon_google_docstring = True napoleon_numpy_docstring = True napoleon_include_init_with_doc = False napoleon_include_private_with_doc = False napoleon_include_special_with_doc = True napoleon_use_admonition_for_examples = False napoleon_use_admonition_for_notes = False napoleon_use_admonition_for_references = False napoleon_use_ivar = False napoleon_use_param = True napoleon_use_rtype = True napoleon_preprocess_types = False napoleon_type_aliases = None napoleon_attr_annotations = True .. _Google style: https://google.github.io/styleguide/pyguide.html .. _NumPy style: https://numpydoc.readthedocs.io/en/latest/format.html#docstring-standard .. confval:: napoleon_google_docstring True to parse `Google style`_ docstrings. False to disable support for Google style docstrings. *Defaults to True.* .. confval:: napoleon_numpy_docstring True to parse `NumPy style`_ docstrings. False to disable support for NumPy style docstrings. *Defaults to True.* .. confval:: napoleon_include_init_with_doc True to list ``__init___`` docstrings separately from the class docstring. False to fall back to Sphinx's default behavior, which considers the ``__init___`` docstring as part of the class documentation. *Defaults to False.* **If True**:: def __init__(self): """ This will be included in the docs because it has a docstring """ def __init__(self): # This will NOT be included in the docs .. confval:: napoleon_include_private_with_doc True to include private members (like ``_membername``) with docstrings in the documentation. False to fall back to Sphinx's default behavior. *Defaults to False.* **If True**:: def _included(self): """ This will be included in the docs because it has a docstring """ pass def _skipped(self): # This will NOT be included in the docs pass .. confval:: napoleon_include_special_with_doc True to include special members (like ``__membername__``) with docstrings in the documentation. False to fall back to Sphinx's default behavior. *Defaults to True.* **If True**:: def __str__(self): """ This will be included in the docs because it has a docstring """ return unicode(self).encode('utf-8') def __unicode__(self): # This will NOT be included in the docs return unicode(self.__class__.__name__) .. confval:: napoleon_use_admonition_for_examples True to use the ``.. admonition::`` directive for the **Example** and **Examples** sections. False to use the ``.. rubric::`` directive instead. One may look better than the other depending on what HTML theme is used. *Defaults to False.* This `NumPy style`_ snippet will be converted as follows:: Example ------- This is just a quick example **If True**:: .. admonition:: Example This is just a quick example **If False**:: .. rubric:: Example This is just a quick example .. confval:: napoleon_use_admonition_for_notes True to use the ``.. admonition::`` directive for **Notes** sections. False to use the ``.. rubric::`` directive instead. *Defaults to False.* .. note:: The singular **Note** section will always be converted to a ``.. note::`` directive. .. seealso:: :attr:`napoleon_use_admonition_for_examples` .. confval:: napoleon_use_admonition_for_references True to use the ``.. admonition::`` directive for **References** sections. False to use the ``.. rubric::`` directive instead. *Defaults to False.* .. seealso:: :attr:`napoleon_use_admonition_for_examples` .. confval:: napoleon_use_ivar True to use the ``:ivar:`` role for instance variables. False to use the ``.. attribute::`` directive instead. *Defaults to False.* This `NumPy style`_ snippet will be converted as follows:: Attributes ---------- attr1 : int Description of `attr1` **If True**:: :ivar attr1: Description of `attr1` :vartype attr1: int **If False**:: .. attribute:: attr1 Description of `attr1` :type: int .. confval:: napoleon_use_param True to use a ``:param:`` role for each function parameter. False to use a single ``:parameters:`` role for all the parameters. *Defaults to True.* This `NumPy style`_ snippet will be converted as follows:: Parameters ---------- arg1 : str Description of `arg1` arg2 : int, optional Description of `arg2`, defaults to 0 **If True**:: :param arg1: Description of `arg1` :type arg1: str :param arg2: Description of `arg2`, defaults to 0 :type arg2: :class:`int`, *optional* **If False**:: :parameters: * **arg1** (*str*) -- Description of `arg1` * **arg2** (*int, optional*) -- Description of `arg2`, defaults to 0 .. confval:: napoleon_use_keyword True to use a ``:keyword:`` role for each function keyword argument. False to use a single ``:keyword arguments:`` role for all the keywords. *Defaults to True.* This behaves similarly to :attr:`napoleon_use_param`. Note unlike docutils, ``:keyword:`` and ``:param:`` will not be treated the same way - there will be a separate "Keyword Arguments" section, rendered in the same fashion as "Parameters" section (type links created if possible) .. seealso:: :attr:`napoleon_use_param` .. confval:: napoleon_use_rtype True to use the ``:rtype:`` role for the return type. False to output the return type inline with the description. *Defaults to True.* This `NumPy style`_ snippet will be converted as follows:: Returns ------- bool True if successful, False otherwise **If True**:: :returns: True if successful, False otherwise :rtype: bool **If False**:: :returns: *bool* -- True if successful, False otherwise .. confval:: napoleon_preprocess_types True to convert the type definitions in the docstrings as references. Defaults to *False*. .. versionadded:: 3.2.1 .. versionchanged:: 3.5 Do preprocess the Google style docstrings also. .. confval:: napoleon_type_aliases A mapping to translate type names to other names or references. Works only when ``napoleon_use_param = True``. *Defaults to None.* With:: napoleon_type_aliases = { "CustomType": "mypackage.CustomType", "dict-like": ":term:`dict-like <mapping>`", } This `NumPy style`_ snippet:: Parameters ---------- arg1 : CustomType Description of `arg1` arg2 : dict-like Description of `arg2` becomes:: :param arg1: Description of `arg1` :type arg1: mypackage.CustomType :param arg2: Description of `arg2` :type arg2: :term:`dict-like <mapping>` .. versionadded:: 3.2 .. confval:: napoleon_attr_annotations True to allow using `PEP 526`_ attributes annotations in classes. If an attribute is documented in the docstring without a type and has an annotation in the class body, that type is used. .. versionadded:: 3.4 .. confval:: napoleon_custom_sections Add a list of custom sections to include, expanding the list of parsed sections. *Defaults to None.* The entries can either be strings or tuples, depending on the intention: * To create a custom "generic" section, just pass a string. * To create an alias for an existing section, pass a tuple containing the alias name and the original, in that order. * To create a custom section that displays like the parameters or returns section, pass a tuple containing the custom section name and a string value, "params_style" or "returns_style". If an entry is just a string, it is interpreted as a header for a generic section. If the entry is a tuple/list/indexed container, the first entry is the name of the section, the second is the section key to emulate. If the second entry value is "params_style" or "returns_style", the custom section will be displayed like the parameters section or returns section. .. versionadded:: 1.8 .. versionchanged:: 3.5 Support ``params_style`` and ``returns_style`` ��������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163739.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/todo.rst����������������������������������������������������������0000644�0000766�0000024�00000003154�00000000000�020105� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������:mod:`sphinx.ext.todo` -- Support for todo items ================================================ .. module:: sphinx.ext.todo :synopsis: Allow inserting todo items into documents. .. moduleauthor:: Daniel Bültmann .. versionadded:: 0.5 There are two additional directives when using this extension: .. rst:directive:: todo Use this directive like, for example, :rst:dir:`note`. It will only show up in the output if :confval:`todo_include_todos` is ``True``. .. versionadded:: 1.3.2 This directive supports an ``class`` option that determines the class attribute for HTML output. If not given, the class defaults to ``admonition-todo``. .. rst:directive:: todolist This directive is replaced by a list of all todo directives in the whole documentation, if :confval:`todo_include_todos` is ``True``. These can be configured as seen below. Configuration ------------- .. confval:: todo_include_todos If this is ``True``, :rst:dir:`todo` and :rst:dir:`todolist` produce output, else they produce nothing. The default is ``False``. .. confval:: todo_emit_warnings If this is ``True``, :rst:dir:`todo` emits a warning for each TODO entries. The default is ``False``. .. versionadded:: 1.5 .. confval:: todo_link_only If this is ``True``, :rst:dir:`todolist` produce output without file path and line, The default is ``False``. .. versionadded:: 1.4 autodoc provides the following an additional event: .. event:: todo-defined (app, node) .. versionadded:: 1.5 Emitted when a todo is defined. *node* is the defined ``sphinx.ext.todo.todo_node`` node. ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163739.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/extensions/viewcode.rst������������������������������������������������������0000644�0000766�0000024�00000007244�00000000000�020751� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������:mod:`sphinx.ext.viewcode` -- Add links to highlighted source code ================================================================== .. module:: sphinx.ext.viewcode :synopsis: Add links to a highlighted version of the source code. .. moduleauthor:: Georg Brandl .. versionadded:: 1.0 This extension looks at your Python object descriptions (``.. class::``, ``.. function::`` etc.) and tries to find the source files where the objects are contained. When found, a separate HTML page will be output for each module with a highlighted version of the source code, and a link will be added to all object descriptions that leads to the source code of the described object. A link back from the source to the description will also be inserted. .. warning:: Basically, ``viewcode`` extension will import the modules being linked to. If any modules have side effects on import, these will be executed when ``sphinx-build`` is run. If you document scripts (as opposed to library modules), make sure their main routine is protected by a ``if __name__ == '__main__'`` condition. In addition, if you don't want to import the modules by ``viewcode``, you can tell the location of the location of source code to ``viewcode`` using the :event:`viewcode-find-source` event. If :confval:`viewcode_follow_imported_members` is enabled, you will also need to resolve imported attributes using the :event:`viewcode-follow-imported` event. This extension works only on HTML related builders like ``html``, ``applehelp``, ``devhelp``, ``htmlhelp``, ``qthelp`` and so on except ``singlehtml``. By default ``epub`` builder doesn't support this extension (see :confval:`viewcode_enable_epub`). Configuration ------------- .. confval:: viewcode_follow_imported_members If this is ``True``, viewcode extension will emit :event:`viewcode-follow-imported` event to resolve the name of the module by other extensions. The default is ``True``. .. versionadded:: 1.3 .. versionchanged:: 1.8 Renamed from ``viewcode_import`` to ``viewcode_follow_imported_members``. .. confval:: viewcode_enable_epub If this is ``True``, viewcode extension is also enabled even if you use epub builders. This extension generates pages outside toctree, but this is not preferred as epub format. Until 1.4.x, this extension is always enabled. If you want to generate epub as same as 1.4.x, you should set ``True``, but epub format checker's score becomes worse. The default is ``False``. .. versionadded:: 1.5 .. warning:: Not all epub readers support pages generated by viewcode extension. These readers ignore links to pages are not under toctree. Some reader's rendering result are corrupted and `epubcheck <https://github.com/IDPF/epubcheck>`_'s score becomes worse even if the reader supports. .. event:: viewcode-find-source (app, modname) .. versionadded:: 1.8 Find the source code for a module. An event handler for this event should return a tuple of the source code itself and a dictionary of tags. The dictionary maps the name of a class, function, attribute, etc to a tuple of its type, the start line number, and the end line number. The type should be one of "class", "def", or "other". :param app: The Sphinx application object. :param modname: The name of the module to find source code for. .. event:: viewcode-follow-imported (app, modname, attribute) .. versionadded:: 1.8 Find the name of the original module for an attribute. :param app: The Sphinx application object. :param modname: The name of the module that the attribute belongs to. :param attribute: The name of the member to follow. ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/index.rst��������������������������������������������������������������������0000644�0000766�0000024�00000001116�00000000000�016044� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������============ Using Sphinx ============ This guide serves to demonstrate how one can get started with Sphinx and covers everything from installing Sphinx and configuring your first Sphinx project to using some of the advanced features Sphinx provides out-of-the-box. If you are looking for guidance on extending Sphinx, refer to :doc:`/development/index`. .. toctree:: :maxdepth: 2 quickstart installation restructuredtext/index markdown configuration builders/index extensions/index theming advanced/intl advanced/setuptools advanced/websupport/index ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/installation.rst�������������������������������������������������������������0000644�0000766�0000024�00000016026�00000000000�017444� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������================= Installing Sphinx ================= .. contents:: :depth: 1 :local: :backlinks: none .. highlight:: console Overview -------- Sphinx is written in `Python`__ and supports Python 3.6+. It builds upon the shoulders of many third-party libraries such as `Docutils`__ and `Jinja`__, which are installed when Sphinx is installed. __ https://docs.python-guide.org/ __ https://docutils.sourceforge.io/ __ https://jinja.palletsprojects.com/ Linux ----- Debian/Ubuntu ~~~~~~~~~~~~~ Install either ``python3-sphinx`` using :command:`apt-get`: :: $ apt-get install python3-sphinx If it not already present, this will install Python for you. RHEL, CentOS ~~~~~~~~~~~~ Install ``python-sphinx`` using :command:`yum`: :: $ yum install python-sphinx If it not already present, this will install Python for you. Other distributions ~~~~~~~~~~~~~~~~~~~ Most Linux distributions have Sphinx in their package repositories. Usually the package is called ``python3-sphinx``, ``python-sphinx`` or ``sphinx``. Be aware that there are at least two other packages with ``sphinx`` in their name: a speech recognition toolkit (*CMU Sphinx*) and a full-text search database (*Sphinx search*). macOS ----- Sphinx can be installed using `Homebrew`__, `MacPorts`__, or as part of a Python distribution such as `Anaconda`__. __ https://brew.sh/ __ https://www.macports.org/ __ https://www.anaconda.com/download/#macos Homebrew ~~~~~~~~ :: $ brew install sphinx-doc For more information, refer to the `package overview`__. __ https://formulae.brew.sh/formula/sphinx-doc MacPorts ~~~~~~~~ Install either ``python3x-sphinx`` using :command:`port`: :: $ sudo port install py38-sphinx To set up the executable paths, use the ``port select`` command: :: $ sudo port select --set python python38 $ sudo port select --set sphinx py38-sphinx For more information, refer to the `package overview`__. __ https://www.macports.org/ports.php?by=library&substr=py38-sphinx Anaconda ~~~~~~~~ :: $ conda install sphinx Windows ------- Sphinx can be install using `Chocolatey`__ or :ref:`installed manually <windows-other-method>`. __ https://chocolatey.org/ Chocolatey ~~~~~~~~~~ :: $ choco install sphinx You would need to `install Chocolatey <https://chocolatey.org/install>`_ before running this. For more information, refer to the `chocolatey page`__. __ https://chocolatey.org/packages/sphinx/ .. _windows-other-method: Other Methods ~~~~~~~~~~~~~ Most Windows users do not have Python installed by default, so we begin with the installation of Python itself. To check if you already have Python installed, open the *Command Prompt* (:kbd:`⊞Win-r` and type :command:`cmd`). Once the command prompt is open, type :command:`python --version` and press Enter. If Python is installed, you will see the version of Python printed to the screen. If you do not have Python installed, refer to the `Hitchhikers Guide to Python's`__ Python on Windows installation guides. You must install `Python 3`__. Once Python is installed, you can install Sphinx using :command:`pip`. Refer to the :ref:`pip installation instructions <install-pypi>` below for more information. __ https://docs.python-guide.org/ __ https://docs.python-guide.org/starting/install3/win/ .. _install-pypi: Installation from PyPI ---------------------- Sphinx packages are published on the `Python Package Index <https://pypi.org/project/Sphinx/>`_. The preferred tool for installing packages from *PyPI* is :command:`pip`. This tool is provided with all modern versions of Python. On Linux or MacOS, you should open your terminal and run the following command. :: $ pip install -U sphinx On Windows, you should open *Command Prompt* (:kbd:`⊞Win-r` and type :command:`cmd`) and run the same command. .. code-block:: doscon C:\> pip install -U sphinx After installation, type :command:`sphinx-build --version` on the command prompt. If everything worked fine, you will see the version number for the Sphinx package you just installed. Installation from *PyPI* also allows you to install the latest development release. You will not generally need (or want) to do this, but it can be useful if you see a possible bug in the latest stable release. To do this, use the ``--pre`` flag. :: $ pip install -U --pre sphinx Using virtual environments ~~~~~~~~~~~~~~~~~~~~~~~~~~ When installing Sphinx using pip, it is highly recommended to use *virtual environments*, which isolate the installed packages from the system packages, thus removing the need to use administrator privileges. To create a virtual environment in the ``.venv`` directory, use the following command. :: $ python -m venv .venv You can read more about them in the `Python Packaging User Guide`_. .. _Python Packaging User Guide: https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/#creating-a-virtual-environment .. warning:: Note that in some Linux distributions, such as Debian and Ubuntu, this might require an extra installation step as follows. .. code-block:: console $ apt-get install python3-venv Docker ------ Docker images for Sphinx are published on the `Docker Hub`_. There are two kind of images: - `sphinxdoc/sphinx`_ - `sphinxdoc/sphinx-latexpdf`_ .. _Docker Hub: https://hub.docker.com/ .. _sphinxdoc/sphinx: https://hub.docker.com/repository/docker/sphinxdoc/sphinx .. _sphinxdoc/sphinx-latexpdf: https://hub.docker.com/repository/docker/sphinxdoc/sphinx-latexpdf Former one is used for standard usage of Sphinx, and latter one is mainly used for PDF builds using LaTeX. Please choose one for your purpose. .. note:: sphinxdoc/sphinx-latexpdf contains TeXLive packages. So the image is very large (over 2GB!). .. hint:: When using docker images, please use ``docker run`` command to invoke sphinx commands. For example, you can use following command to create a Sphinx project: .. code-block:: bash $ docker run -it --rm -v /path/to/document:/docs sphinxdoc/sphinx sphinx-quickstart And you can following command this to build HTML document: .. code-block:: bash $ docker run --rm -v /path/to/document:/docs sphinxdoc/sphinx make html For more details, please read `README file`__ of docker images. .. __: https://hub.docker.com/repository/docker/sphinxdoc/sphinx Installation from source ------------------------ You can install Sphinx directly from a clone of the `Git repository`__. This can be done either by cloning the repo and installing from the local clone, on simply installing directly via :command:`git`. :: $ git clone https://github.com/sphinx-doc/sphinx $ cd sphinx $ pip install . :: $ pip install git+https://github.com/sphinx-doc/sphinx You can also download a snapshot of the Git repo in either `tar.gz`__ or `zip`__ format. Once downloaded and extracted, these can be installed with :command:`pip` as above. .. highlight:: default __ https://github.com/sphinx-doc/sphinx __ https://github.com/sphinx-doc/sphinx/archive/master.tar.gz __ https://github.com/sphinx-doc/sphinx/archive/master.zip ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/markdown.rst�����������������������������������������������������������������0000644�0000766�0000024�00000003060�00000000000�016557� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: python .. _markdown: ======== Markdown ======== `Markdown`__ is a lightweight markup language with a simplistic plain text formatting syntax. It exists in many syntactically different *flavors*. To support Markdown-based documentation, Sphinx can use `MyST-Parser`__. MyST-Parser is a Docutils bridge to `markdown-it-py`__, a Python package for parsing the `CommonMark`__ Markdown flavor. __ https://daringfireball.net/projects/markdown/ __ https://myst-parser.readthedocs.io/en/latest/ __ https://github.com/executablebooks/markdown-it-py __ https://commonmark.org/ Configuration ------------- To configure your Sphinx project for Markdown support, proceed as follows: #. Install the Markdown parser *MyST-Parser*:: pip install --upgrade myst-parser #. Add *myst_parser* to the :confval:`list of configured extensions <extensions>`:: extensions = ['myst_parser'] .. note:: MyST-Parser requires Sphinx 2.1 or newer. #. If you want to use Markdown files with extensions other than ``.md``, adjust the :confval:`source_suffix` variable. The following example configures Sphinx to parse all files with the extensions ``.md`` and ``.txt`` as Markdown:: source_suffix = { '.rst': 'restructuredtext', '.txt': 'markdown', '.md': 'markdown', } #. You can further configure *MyST-Parser* to allow custom syntax that standard *CommonMark* doesn't support. Read more in the `MyST-Parser documentation`__. __ https://myst-parser.readthedocs.io/en/latest/using/syntax-optional.html ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/quickstart.rst���������������������������������������������������������������0000644�0000766�0000024�00000031574�00000000000�017142� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������=============== Getting Started =============== Sphinx is a *documentation generator* or a tool that translates a set of plain text source files into various output formats, automatically producing cross-references, indices, etc. That is, if you have a directory containing a bunch of :doc:`/usage/restructuredtext/index` or :doc:`/usage/markdown` documents, Sphinx can generate a series of HTML files, a PDF file (via LaTeX), man pages and much more. Sphinx focuses on documentation, in particular handwritten documentation, however, Sphinx can also be used to generate blogs, homepages and even books. Much of Sphinx's power comes from the richness of its default plain-text markup format, :doc:`reStructuredText </usage/restructuredtext/index>`, along with its :doc:`significant extensibility capabilities </development/index>`. The goal of this document is to give you a quick taste of what Sphinx is and how you might use it. When you're done here, you can check out the :doc:`installation guide </usage/installation>` followed by the intro to the default markup format used by Sphinx, :doc:`reStucturedText </usage/restructuredtext/index>`. For a great "introduction" to writing docs in general -- the whys and hows, see also `Write the docs`__, written by Eric Holscher. .. __: https://www.writethedocs.org/guide/writing/beginners-guide-to-docs/ Setting up the documentation sources ------------------------------------ The root directory of a Sphinx collection of plain-text document sources is called the :term:`source directory`. This directory also contains the Sphinx configuration file :file:`conf.py`, where you can configure all aspects of how Sphinx reads your sources and builds your documentation. [#]_ Sphinx comes with a script called :program:`sphinx-quickstart` that sets up a source directory and creates a default :file:`conf.py` with the most useful configuration values from a few questions it asks you. To use this, run: .. code-block:: shell $ sphinx-quickstart Defining document structure --------------------------- Let's assume you've run :program:`sphinx-quickstart`. It created a source directory with :file:`conf.py` and a root document, :file:`index.rst`. The main function of the :term:`root document` is to serve as a welcome page, and to contain the root of the "table of contents tree" (or *toctree*). This is one of the main things that Sphinx adds to reStructuredText, a way to connect multiple files to a single hierarchy of documents. .. sidebar:: reStructuredText directives ``toctree`` is a reStructuredText :dfn:`directive`, a very versatile piece of markup. Directives can have arguments, options and content. *Arguments* are given directly after the double colon following the directive's name. Each directive decides whether it can have arguments, and how many. *Options* are given after the arguments, in form of a "field list". The ``maxdepth`` is such an option for the ``toctree`` directive. *Content* follows the options or arguments after a blank line. Each directive decides whether to allow content, and what to do with it. A common gotcha with directives is that **the first line of the content must be indented to the same level as the options are**. The ``toctree`` directive initially is empty, and looks like so: .. code-block:: rst .. toctree:: :maxdepth: 2 You add documents listing them in the *content* of the directive: .. code-block:: rst .. toctree:: :maxdepth: 2 usage/installation usage/quickstart ... This is exactly how the ``toctree`` for this documentation looks. The documents to include are given as :term:`document name`\ s, which in short means that you leave off the file name extension and use forward slashes (``/``) as directory separators. |more| Read more about :ref:`the toctree directive <toctree-directive>`. You can now create the files you listed in the ``toctree`` and add content, and their section titles will be inserted (up to the ``maxdepth`` level) at the place where the ``toctree`` directive is placed. Also, Sphinx now knows about the order and hierarchy of your documents. (They may contain ``toctree`` directives themselves, which means you can create deeply nested hierarchies if necessary.) Adding content -------------- In Sphinx source files, you can use most features of standard :term:`reStructuredText`. There are also several features added by Sphinx. For example, you can add cross-file references in a portable way (which works for all output types) using the :rst:role:`ref` role. For an example, if you are viewing the HTML version, you can look at the source for this document -- use the "Show Source" link in the sidebar. .. todo:: Update the below link when we add new guides on these. |more| See :doc:`/usage/restructuredtext/index` for a more in-depth introduction to reStructuredText, including markup added by Sphinx. Running the build ----------------- Now that you have added some files and content, let's make a first build of the docs. A build is started with the :program:`sphinx-build` program: .. code-block:: shell $ sphinx-build -b html sourcedir builddir where *sourcedir* is the :term:`source directory`, and *builddir* is the directory in which you want to place the built documentation. The :option:`-b <sphinx-build -b>` option selects a builder; in this example Sphinx will build HTML files. |more| Refer to the :doc:`sphinx-build man page </man/sphinx-build>` for all options that :program:`sphinx-build` supports. However, :program:`sphinx-quickstart` script creates a :file:`Makefile` and a :file:`make.bat` which make life even easier for you. These can be executed by running :command:`make` with the name of the builder. For example. .. code-block:: shell $ make html This will build HTML docs in the build directory you chose. Execute :command:`make` without an argument to see which targets are available. .. admonition:: How do I generate PDF documents? ``make latexpdf`` runs the :mod:`LaTeX builder <sphinx.builders.latex.LaTeXBuilder>` and readily invokes the pdfTeX toolchain for you. .. todo:: Move this whole section into a guide on rST or directives Documenting objects ------------------- One of Sphinx's main objectives is easy documentation of :dfn:`objects` (in a very general sense) in any :dfn:`domain`. A domain is a collection of object types that belong together, complete with markup to create and reference descriptions of these objects. The most prominent domain is the Python domain. For example, to document Python's built-in function ``enumerate()``, you would add this to one of your source files. .. code-block:: rst .. py:function:: enumerate(sequence[, start=0]) Return an iterator that yields tuples of an index and an item of the *sequence*. (And so on.) This is rendered like this: .. py:function:: enumerate(sequence[, start=0]) Return an iterator that yields tuples of an index and an item of the *sequence*. (And so on.) The argument of the directive is the :dfn:`signature` of the object you describe, the content is the documentation for it. Multiple signatures can be given, each in its own line. The Python domain also happens to be the default domain, so you don't need to prefix the markup with the domain name. .. code-block:: rst .. function:: enumerate(sequence[, start=0]) ... does the same job if you keep the default setting for the default domain. There are several more directives for documenting other types of Python objects, for example :rst:dir:`py:class` or :rst:dir:`py:method`. There is also a cross-referencing :dfn:`role` for each of these object types. This markup will create a link to the documentation of ``enumerate()``. :: The :py:func:`enumerate` function can be used for ... And here is the proof: A link to :func:`enumerate`. Again, the ``py:`` can be left out if the Python domain is the default one. It doesn't matter which file contains the actual documentation for ``enumerate()``; Sphinx will find it and create a link to it. Each domain will have special rules for how the signatures can look like, and make the formatted output look pretty, or add specific features like links to parameter types, e.g. in the C/C++ domains. |more| See :doc:`/usage/restructuredtext/domains` for all the available domains and their directives/roles. Basic configuration ------------------- Earlier we mentioned that the :file:`conf.py` file controls how Sphinx processes your documents. In that file, which is executed as a Python source file, you assign configuration values. For advanced users: since it is executed by Sphinx, you can do non-trivial tasks in it, like extending :data:`sys.path` or importing a module to find out the version you are documenting. The config values that you probably want to change are already put into the :file:`conf.py` by :program:`sphinx-quickstart` and initially commented out (with standard Python syntax: a ``#`` comments the rest of the line). To change the default value, remove the hash sign and modify the value. To customize a config value that is not automatically added by :program:`sphinx-quickstart`, just add an additional assignment. Keep in mind that the file uses Python syntax for strings, numbers, lists and so on. The file is saved in UTF-8 by default, as indicated by the encoding declaration in the first line. |more| See :doc:`/usage/configuration` for documentation of all available config values. .. todo:: Move this entire doc to a different section Autodoc ------- When documenting Python code, it is common to put a lot of documentation in the source files, in documentation strings. Sphinx supports the inclusion of docstrings from your modules with an :dfn:`extension` (an extension is a Python module that provides additional features for Sphinx projects) called *autodoc*. In order to use *autodoc*, you need to activate it in :file:`conf.py` by putting the string ``'sphinx.ext.autodoc'`` into the list assigned to the :confval:`extensions` config value:: extensions = ['sphinx.ext.autodoc'] Then, you have a few additional directives at your disposal. For example, to document the function ``io.open()``, reading its signature and docstring from the source file, you'd write this:: .. autofunction:: io.open You can also document whole classes or even modules automatically, using member options for the auto directives, like :: .. automodule:: io :members: *autodoc* needs to import your modules in order to extract the docstrings. Therefore, you must add the appropriate path to :py:data:`sys.path` in your :file:`conf.py`. .. warning:: :mod:`~sphinx.ext.autodoc` **imports** the modules to be documented. If any modules have side effects on import, these will be executed by ``autodoc`` when ``sphinx-build`` is run. If you document scripts (as opposed to library modules), make sure their main routine is protected by a ``if __name__ == '__main__'`` condition. |more| See :mod:`sphinx.ext.autodoc` for the complete description of the features of autodoc. .. todo:: Move this doc to another section Intersphinx ----------- Many Sphinx documents including the `Python documentation`_ are published on the Internet. When you want to make links to such documents from your documentation, you can do it with :mod:`sphinx.ext.intersphinx`. .. _Python documentation: https://docs.python.org/3 In order to use intersphinx, you need to activate it in :file:`conf.py` by putting the string ``'sphinx.ext.intersphinx'`` into the :confval:`extensions` list and set up the :confval:`intersphinx_mapping` config value. For example, to link to ``io.open()`` in the Python library manual, you need to setup your :confval:`intersphinx_mapping` like:: intersphinx_mapping = {'python': ('https://docs.python.org/3', None)} And now, you can write a cross-reference like ``:py:func:`io.open```. Any cross-reference that has no matching target in the current documentation set, will be looked up in the documentation sets configured in :confval:`intersphinx_mapping` (this needs access to the URL in order to download the list of valid targets). Intersphinx also works for some other :term:`domain`\'s roles including ``:ref:``, however it doesn't work for ``:doc:`` as that is non-domain role. |more| See :mod:`sphinx.ext.intersphinx` for the complete description of the features of intersphinx. More topics to be covered ------------------------- - :doc:`Other extensions </usage/extensions/index>`: - Static files - :doc:`Selecting a theme </usage/theming>` - :doc:`/usage/advanced/setuptools` - :ref:`Templating <templating>` - Using extensions - :ref:`Writing extensions <dev-extensions>` .. rubric:: Footnotes .. [#] This is the usual layout. However, :file:`conf.py` can also live in another directory, the :term:`configuration directory`. Refer to the :doc:`sphinx-build man page </man/sphinx-build>` for more information. .. |more| image:: /_static/more.png :align: middle :alt: more info ������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4390152 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/restructuredtext/������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017644� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/restructuredtext/basics.rst��������������������������������������������������0000644�0000766�0000024�00000050110�00000000000�021637� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: rst .. _rst-primer: ======================= reStructuredText Primer ======================= reStructuredText is the default plaintext markup language used by Sphinx. This section is a brief introduction to reStructuredText (reST) concepts and syntax, intended to provide authors with enough information to author documents productively. Since reST was designed to be a simple, unobtrusive markup language, this will not take too long. .. seealso:: The authoritative `reStructuredText User Documentation <https://docutils.sourceforge.io/rst.html>`_. The "ref" links in this document link to the description of the individual constructs in the reST reference. Paragraphs ---------- The paragraph (:duref:`ref <paragraphs>`) is the most basic block in a reST document. Paragraphs are simply chunks of text separated by one or more blank lines. As in Python, indentation is significant in reST, so all lines of the same paragraph must be left-aligned to the same level of indentation. .. _rst-inline-markup: Inline markup ------------- The standard reST inline markup is quite simple: use * one asterisk: ``*text*`` for emphasis (italics), * two asterisks: ``**text**`` for strong emphasis (boldface), and * backquotes: ````text```` for code samples. If asterisks or backquotes appear in running text and could be confused with inline markup delimiters, they have to be escaped with a backslash. Be aware of some restrictions of this markup: * it may not be nested, * content may not start or end with whitespace: ``* text*`` is wrong, * it must be separated from surrounding text by non-word characters. Use a backslash escaped space to work around that: ``thisis\ *one*\ word``. These restrictions may be lifted in future versions of the docutils. It is also possible to replace or expand upon some of this inline markup with roles. Refer to :ref:`rst-roles-alt` for more information. Lists and Quote-like blocks --------------------------- List markup (:duref:`ref <bullet-lists>`) is natural: just place an asterisk at the start of a paragraph and indent properly. The same goes for numbered lists; they can also be autonumbered using a ``#`` sign:: * This is a bulleted list. * It has two items, the second item uses two lines. 1. This is a numbered list. 2. It has two items too. #. This is a numbered list. #. It has two items too. Nested lists are possible, but be aware that they must be separated from the parent list items by blank lines:: * this is * a list * with a nested list * and some subitems * and here the parent list continues Definition lists (:duref:`ref <definition-lists>`) are created as follows:: term (up to a line of text) Definition of the term, which must be indented and can even consist of multiple paragraphs next term Description. Note that the term cannot have more than one line of text. Quoted paragraphs (:duref:`ref <block-quotes>`) are created by just indenting them more than the surrounding paragraphs. Line blocks (:duref:`ref <line-blocks>`) are a way of preserving line breaks:: | These lines are | broken exactly like in | the source file. There are also several more special blocks available: * field lists (:duref:`ref <field-lists>`, with caveats noted in :ref:`rst-field-lists`) * option lists (:duref:`ref <option-lists>`) * quoted literal blocks (:duref:`ref <quoted-literal-blocks>`) * doctest blocks (:duref:`ref <doctest-blocks>`) .. _rst-literal-blocks: Literal blocks -------------- Literal code blocks (:duref:`ref <literal-blocks>`) are introduced by ending a paragraph with the special marker ``::``. The literal block must be indented (and, like all paragraphs, separated from the surrounding ones by blank lines):: This is a normal text paragraph. The next paragraph is a code sample:: It is not processed in any way, except that the indentation is removed. It can span multiple lines. This is a normal text paragraph again. The handling of the ``::`` marker is smart: * If it occurs as a paragraph of its own, that paragraph is completely left out of the document. * If it is preceded by whitespace, the marker is removed. * If it is preceded by non-whitespace, the marker is replaced by a single colon. That way, the second sentence in the above example's first paragraph would be rendered as "The next paragraph is a code sample:". Code highlighting can be enabled for these literal blocks on a document-wide basis using the :rst:dir:`highlight` directive and on a project-wide basis using the :confval:`highlight_language` configuration option. The :rst:dir:`code-block` directive can be used to set highlighting on a block-by-block basis. These directives are discussed later. .. _rst-doctest-blocks: Doctest blocks -------------- Doctest blocks (:duref:`ref <doctest-blocks>`) are interactive Python sessions cut-and-pasted into docstrings. They do not require the :ref:`literal blocks <rst-literal-blocks>` syntax. The doctest block must end with a blank line and should *not* end with an unused prompt:: >>> 1 + 1 2 .. _rst-tables: Tables ------ For *grid tables* (:duref:`ref <grid-tables>`), you have to "paint" the cell grid yourself. They look like this:: +------------------------+------------+----------+----------+ | Header row, column 1 | Header 2 | Header 3 | Header 4 | | (header rows optional) | | | | +========================+============+==========+==========+ | body row 1, column 1 | column 2 | column 3 | column 4 | +------------------------+------------+----------+----------+ | body row 2 | ... | ... | | +------------------------+------------+----------+----------+ *Simple tables* (:duref:`ref <simple-tables>`) are easier to write, but limited: they must contain more than one row, and the first column cells cannot contain multiple lines. They look like this:: ===== ===== ======= A B A and B ===== ===== ======= False False False True False False False True False True True True ===== ===== ======= Two more syntaxes are supported: *CSV tables* and *List tables*. They use an *explicit markup block*. Refer to :ref:`table-directives` for more information. Hyperlinks ---------- External links ~~~~~~~~~~~~~~ Use ```Link text <https://domain.invalid/>`_`` for inline web links. If the link text should be the web address, you don't need special markup at all, the parser finds links and mail addresses in ordinary text. .. important:: There must be a space between the link text and the opening \< for the URL. You can also separate the link and the target definition (:duref:`ref <hyperlink-targets>`), like this:: This is a paragraph that contains `a link`_. .. _a link: https://domain.invalid/ Internal links ~~~~~~~~~~~~~~ Internal linking is done via a special reST role provided by Sphinx, see the section on specific markup, :ref:`ref-role`. .. _rst-sections: Sections -------- Section headers (:duref:`ref <sections>`) are created by underlining (and optionally overlining) the section title with a punctuation character, at least as long as the text:: ================= This is a heading ================= Normally, there are no heading levels assigned to certain characters as the structure is determined from the succession of headings. However, this convention is used in `Python's Style Guide for documenting <https://docs.python.org/devguide/documenting.html#style-guide>`_ which you may follow: * ``#`` with overline, for parts * ``*`` with overline, for chapters * ``=``, for sections * ``-``, for subsections * ``^``, for subsubsections * ``"``, for paragraphs Of course, you are free to use your own marker characters (see the reST documentation), and use a deeper nesting level, but keep in mind that most target formats (HTML, LaTeX) have a limited supported nesting depth. .. _rst-field-lists: Field Lists ----------- Field lists (:duref:`ref <field-lists>`) are sequences of fields marked up like this:: :fieldname: Field content They are commonly used in Python documentation:: def my_function(my_arg, my_other_arg): """A function just for me. :param my_arg: The first of my arguments. :param my_other_arg: The second of my arguments. :returns: A message (just for me, of course). """ Sphinx extends standard docutils behavior and intercepts field lists specified at the beginning of documents. Refer to :doc:`field-lists` for more information. .. TODO This ref should be 'rst-roles', but that already exists. Rename the .. other ones .. _rst-roles-alt: Roles ----- A role or "custom interpreted text role" (:duref:`ref <roles>`) is an inline piece of explicit markup. It signifies that the enclosed text should be interpreted in a specific way. Sphinx uses this to provide semantic markup and cross-referencing of identifiers, as described in the appropriate section. The general syntax is ``:rolename:`content```. Docutils supports the following roles: * :durole:`emphasis` -- equivalent of ``*emphasis*`` * :durole:`strong` -- equivalent of ``**strong**`` * :durole:`literal` -- equivalent of ````literal```` * :durole:`subscript` -- subscript text * :durole:`superscript` -- superscript text * :durole:`title-reference` -- for titles of books, periodicals, and other materials Refer to :doc:`roles` for roles added by Sphinx. Explicit Markup --------------- "Explicit markup" (:duref:`ref <explicit-markup-blocks>`) is used in reST for most constructs that need special handling, such as footnotes, specially-highlighted paragraphs, comments, and generic directives. An explicit markup block begins with a line starting with ``..`` followed by whitespace and is terminated by the next paragraph at the same level of indentation. (There needs to be a blank line between explicit markup and normal paragraphs. This may all sound a bit complicated, but it is intuitive enough when you write it.) .. _rst-directives: Directives ---------- A directive (:duref:`ref <directives>`) is a generic block of explicit markup. Along with roles, it is one of the extension mechanisms of reST, and Sphinx makes heavy use of it. Docutils supports the following directives: * Admonitions: :dudir:`attention`, :dudir:`caution`, :dudir:`danger`, :dudir:`error`, :dudir:`hint`, :dudir:`important`, :dudir:`note`, :dudir:`tip`, :dudir:`warning` and the generic :dudir:`admonition <admonitions>`. (Most themes style only "note" and "warning" specially.) * Images: - :dudir:`image` (see also Images_ below) - :dudir:`figure` (an image with caption and optional legend) * Additional body elements: - :dudir:`contents <table-of-contents>` (a local, i.e. for the current file only, table of contents) - :dudir:`container` (a container with a custom class, useful to generate an outer ``<div>`` in HTML) - :dudir:`rubric` (a heading without relation to the document sectioning) - :dudir:`topic`, :dudir:`sidebar` (special highlighted body elements) - :dudir:`parsed-literal` (literal block that supports inline markup) - :dudir:`epigraph` (a block quote with optional attribution line) - :dudir:`highlights`, :dudir:`pull-quote` (block quotes with their own class attribute) - :dudir:`compound <compound-paragraph>` (a compound paragraph) * Special tables: - :dudir:`table` (a table with title) - :dudir:`csv-table` (a table generated from comma-separated values) - :dudir:`list-table` (a table generated from a list of lists) * Special directives: - :dudir:`raw <raw-data-pass-through>` (include raw target-format markup) - :dudir:`include` (include reStructuredText from another file) -- in Sphinx, when given an absolute include file path, this directive takes it as relative to the source directory - :dudir:`class` (assign a class attribute to the next element) [1]_ * HTML specifics: - :dudir:`meta` (generation of HTML ``<meta>`` tags, see also :ref:`html-meta` below) - :dudir:`title <metadata-document-title>` (override document title) * Influencing markup: - :dudir:`default-role` (set a new default role) - :dudir:`role` (create a new role) Since these are only per-file, better use Sphinx's facilities for setting the :confval:`default_role`. .. warning:: Do *not* use the directives :dudir:`sectnum`, :dudir:`header` and :dudir:`footer`. Directives added by Sphinx are described in :doc:`directives`. Basically, a directive consists of a name, arguments, options and content. (Keep this terminology in mind, it is used in the next chapter describing custom directives.) Looking at this example, :: .. function:: foo(x) foo(y, z) :module: some.module.name Return a line of text input from the user. ``function`` is the directive name. It is given two arguments here, the remainder of the first line and the second line, as well as one option ``module`` (as you can see, options are given in the lines immediately following the arguments and indicated by the colons). Options must be indented to the same level as the directive content. The directive content follows after a blank line and is indented relative to the directive start or if options are present, by the same amount as the options. Be careful as the indent is not a fixed number of whitespace, e.g. three, but any number whitespace. This can be surprising when a fixed indent is used throughout the document and can make a difference for directives which are sensitive to whitespace. Compare:: .. code-block:: :caption: A cool example The output of this line starts with four spaces. .. code-block:: The output of this line has no spaces at the beginning. In the first code block, the indent for the content was fixated by the option line to three spaces, consequently the content starts with four spaces. In the latter the indent was fixed by the content itself to seven spaces, thus it does not start with a space. Images ------ reST supports an image directive (:dudir:`ref <image>`), used like so:: .. image:: gnu.png (options) When used within Sphinx, the file name given (here ``gnu.png``) must either be relative to the source file, or absolute which means that they are relative to the top source directory. For example, the file ``sketch/spam.rst`` could refer to the image ``images/spam.png`` as ``../images/spam.png`` or ``/images/spam.png``. Sphinx will automatically copy image files over to a subdirectory of the output directory on building (e.g. the ``_static`` directory for HTML output.) Interpretation of image size options (``width`` and ``height``) is as follows: if the size has no unit or the unit is pixels, the given size will only be respected for output channels that support pixels. Other units (like ``pt`` for points) will be used for HTML and LaTeX output (the latter replaces ``pt`` by ``bp`` as this is the TeX unit such that ``72bp=1in``). Sphinx extends the standard docutils behavior by allowing an asterisk for the extension:: .. image:: gnu.* Sphinx then searches for all images matching the provided pattern and determines their type. Each builder then chooses the best image out of these candidates. For instance, if the file name ``gnu.*`` was given and two files :file:`gnu.pdf` and :file:`gnu.png` existed in the source tree, the LaTeX builder would choose the former, while the HTML builder would prefer the latter. Supported image types and choosing priority are defined at :doc:`/usage/builders/index`. Note that image file names should not contain spaces. .. versionchanged:: 0.4 Added the support for file names ending in an asterisk. .. versionchanged:: 0.6 Image paths can now be absolute. .. versionchanged:: 1.5 latex target supports pixels (default is ``96px=1in``). Footnotes --------- For footnotes (:duref:`ref <footnotes>`), use ``[#name]_`` to mark the footnote location, and add the footnote body at the bottom of the document after a "Footnotes" rubric heading, like so:: Lorem ipsum [#f1]_ dolor sit amet ... [#f2]_ .. rubric:: Footnotes .. [#f1] Text of the first footnote. .. [#f2] Text of the second footnote. You can also explicitly number the footnotes (``[1]_``) or use auto-numbered footnotes without names (``[#]_``). Citations --------- Standard reST citations (:duref:`ref <citations>`) are supported, with the additional feature that they are "global", i.e. all citations can be referenced from all files. Use them like so:: Lorem ipsum [Ref]_ dolor sit amet. .. [Ref] Book or article reference, URL or whatever. Citation usage is similar to footnote usage, but with a label that is not numeric or begins with ``#``. Substitutions ------------- reST supports "substitutions" (:duref:`ref <substitution-definitions>`), which are pieces of text and/or markup referred to in the text by ``|name|``. They are defined like footnotes with explicit markup blocks, like this:: .. |name| replace:: replacement *text* or this:: .. |caution| image:: warning.png :alt: Warning! See the :duref:`reST reference for substitutions <substitution-definitions>` for details. .. index:: ! pair: global; substitutions If you want to use some substitutions for all documents, put them into :confval:`rst_prolog` or :confval:`rst_epilog` or put them into a separate file and include it into all documents you want to use them in, using the :rst:dir:`include` directive. (Be sure to give the include file a file name extension differing from that of other source files, to avoid Sphinx finding it as a standalone document.) Sphinx defines some default substitutions, see :ref:`default-substitutions`. Comments -------- Every explicit markup block which isn't a valid markup construct (like the footnotes above) is regarded as a comment (:duref:`ref <comments>`). For example:: .. This is a comment. You can indent text after a comment start to form multiline comments:: .. This whole indented block is a comment. Still in the comment. .. _html-meta: HTML Metadata ------------- The :rst:dir:`meta` directive (:dudir:`ref <meta>`) allows specifying the HTML `metadata element`_ of a Sphinx documentation page. For example, the directive:: .. meta:: :description: The Sphinx documentation builder :keywords: Sphinx, documentation, builder will generate the following HTML output: .. code:: html <meta name="description" content="The Sphinx documentation builder"> <meta name="keywords" content="Sphinx, documentation, builder"> Also, Sphinx will add the keywords as specified in the meta directive to the search index. Thereby, the ``lang`` attribute of the meta element is considered. For example, the directive:: .. meta:: :keywords: backup :keywords lang=en: pleasefindthiskey pleasefindthiskeytoo :keywords lang=de: bittediesenkeyfinden adds the following words to the search indices of builds with different language configurations: * ``pleasefindthiskey``, ``pleasefindthiskeytoo`` to *English* builds; * ``bittediesenkeyfinden`` to *German* builds; * ``backup`` to builds in all languages. .. _metadata element: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta Source encoding --------------- Since the easiest way to include special characters like em dashes or copyright signs in reST is to directly write them as Unicode characters, one has to specify an encoding. Sphinx assumes source files to be encoded in UTF-8 by default; you can change this with the :confval:`source_encoding` config value. Gotchas ------- There are some problems one commonly runs into while authoring reST documents: * **Separation of inline markup:** As said above, inline markup spans must be separated from the surrounding text by non-word characters, you have to use a backslash-escaped space to get around that. See :duref:`the reference <substitution-definitions>` for the details. * **No nested inline markup:** Something like ``*see :func:`foo`*`` is not possible. .. rubric:: Footnotes .. [1] When the default domain contains a :rst:dir:`class` directive, this directive will be shadowed. Therefore, Sphinx re-exports it as :rst:dir:`rst-class`. ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/restructuredtext/directives.rst����������������������������������������������0000644�0000766�0000024�00000132122�00000000000�022540� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: rst ========== Directives ========== :ref:`As previously discussed <rst-directives>`, a directive is a generic block of explicit markup. While Docutils provides a number of directives, Sphinx provides many more and uses directives as one of the primary extension mechanisms. See :doc:`/usage/restructuredtext/domains` for roles added by domains. .. seealso:: Refer to the :ref:`reStructuredText Primer <rst-directives>` for an overview of the directives provided by Docutils. .. _toctree-directive: Table of contents ----------------- .. index:: pair: table of; contents Since reST does not have facilities to interconnect several documents, or split documents into multiple output files, Sphinx uses a custom directive to add relations between the single files the documentation is made of, as well as tables of contents. The ``toctree`` directive is the central element. .. note:: Simple "inclusion" of one file in another can be done with the :dudir:`include` directive. .. note:: To create table of contents for current document (.rst file), use the standard reST :dudir:`contents directive <table-of-contents>`. .. rst:directive:: toctree This directive inserts a "TOC tree" at the current location, using the individual TOCs (including "sub-TOC trees") of the documents given in the directive body. Relative document names (not beginning with a slash) are relative to the document the directive occurs in, absolute names are relative to the source directory. A numeric ``maxdepth`` option may be given to indicate the depth of the tree; by default, all levels are included. [#]_ The representation of "TOC tree" is changed in each output format. The builders that output multiple files (ex. HTML) treat it as a collection of hyperlinks. On the other hand, the builders that output a single file (ex. LaTeX, man page, etc.) replace it with the content of the documents on the TOC tree. Consider this example (taken from the Python docs' library reference index):: .. toctree:: :maxdepth: 2 intro strings datatypes numeric (many more documents listed here) This accomplishes two things: * Tables of contents from all those documents are inserted, with a maximum depth of two, that means one nested heading. ``toctree`` directives in those documents are also taken into account. * Sphinx knows the relative order of the documents ``intro``, ``strings`` and so forth, and it knows that they are children of the shown document, the library index. From this information it generates "next chapter", "previous chapter" and "parent chapter" links. **Entries** Document titles in the :rst:dir:`toctree` will be automatically read from the title of the referenced document. If that isn't what you want, you can specify an explicit title and target using a similar syntax to reST hyperlinks (and Sphinx's :ref:`cross-referencing syntax <xref-syntax>`). This looks like:: .. toctree:: intro All about strings <strings> datatypes The second line above will link to the ``strings`` document, but will use the title "All about strings" instead of the title of the ``strings`` document. You can also add external links, by giving an HTTP URL instead of a document name. **Section numbering** If you want to have section numbers even in HTML output, give the **toplevel** toctree a ``numbered`` option. For example:: .. toctree:: :numbered: foo bar Numbering then starts at the heading of ``foo``. Sub-toctrees are automatically numbered (don't give the ``numbered`` flag to those). Numbering up to a specific depth is also possible, by giving the depth as a numeric argument to ``numbered``. **Additional options** You can use the ``caption`` option to provide a toctree caption and you can use the ``name`` option to provide an implicit target name that can be referenced by using :rst:role:`ref`:: .. toctree:: :caption: Table of Contents :name: mastertoc foo If you want only the titles of documents in the tree to show up, not other headings of the same level, you can use the ``titlesonly`` option:: .. toctree:: :titlesonly: foo bar You can use "globbing" in toctree directives, by giving the ``glob`` flag option. All entries are then matched against the list of available documents, and matches are inserted into the list alphabetically. Example:: .. toctree:: :glob: intro* recipe/* * This includes first all documents whose names start with ``intro``, then all documents in the ``recipe`` folder, then all remaining documents (except the one containing the directive, of course.) [#]_ The special entry name ``self`` stands for the document containing the toctree directive. This is useful if you want to generate a "sitemap" from the toctree. You can use the ``reversed`` flag option to reverse the order of the entries in the list. This can be useful when using the ``glob`` flag option to reverse the ordering of the files. Example:: .. toctree:: :glob: :reversed: recipe/* You can also give a "hidden" option to the directive, like this:: .. toctree:: :hidden: doc_1 doc_2 This will still notify Sphinx of the document hierarchy, but not insert links into the document at the location of the directive -- this makes sense if you intend to insert these links yourself, in a different style, or in the HTML sidebar. In cases where you want to have only one top-level toctree and hide all other lower level toctrees you can add the "includehidden" option to the top-level toctree entry:: .. toctree:: :includehidden: doc_1 doc_2 All other toctree entries can then be eliminated by the "hidden" option. In the end, all documents in the :term:`source directory` (or subdirectories) must occur in some ``toctree`` directive; Sphinx will emit a warning if it finds a file that is not included, because that means that this file will not be reachable through standard navigation. Use :confval:`exclude_patterns` to explicitly exclude documents or directories from building completely. Use :ref:`the "orphan" metadata <metadata>` to let a document be built, but notify Sphinx that it is not reachable via a toctree. The "root document" (selected by :confval:`root_doc`) is the "root" of the TOC tree hierarchy. It can be used as the documentation's main page, or as a "full table of contents" if you don't give a ``maxdepth`` option. .. versionchanged:: 0.3 Added "globbing" option. .. versionchanged:: 0.6 Added "numbered" and "hidden" options as well as external links and support for "self" references. .. versionchanged:: 1.0 Added "titlesonly" option. .. versionchanged:: 1.1 Added numeric argument to "numbered". .. versionchanged:: 1.2 Added "includehidden" option. .. versionchanged:: 1.3 Added "caption" and "name" option. Special names ^^^^^^^^^^^^^ Sphinx reserves some document names for its own use; you should not try to create documents with these names -- it will cause problems. The special document names (and pages generated for them) are: * ``genindex``, ``modindex``, ``search`` These are used for the general index, the Python module index, and the search page, respectively. The general index is populated with entries from modules, all index-generating :ref:`object descriptions <basic-domain-markup>`, and from :rst:dir:`index` directives. The Python module index contains one entry per :rst:dir:`py:module` directive. The search page contains a form that uses the generated JSON search index and JavaScript to full-text search the generated documents for search words; it should work on every major browser that supports modern JavaScript. * every name beginning with ``_`` Though few such names are currently used by Sphinx, you should not create documents or document-containing directories with such names. (Using ``_`` as a prefix for a custom template directory is fine.) .. warning:: Be careful with unusual characters in filenames. Some formats may interpret these characters in unexpected ways: * Do not use the colon ``:`` for HTML based formats. Links to other parts may not work. * Do not use the plus ``+`` for the ePub format. Some resources may not be found. Paragraph-level markup ---------------------- .. index:: note, warning pair: changes; in version These directives create short paragraphs and can be used inside information units as well as normal text. .. rst:directive:: .. note:: An especially important bit of information about an API that a user should be aware of when using whatever bit of API the note pertains to. The content of the directive should be written in complete sentences and include all appropriate punctuation. Example:: .. note:: This function is not suitable for sending spam e-mails. .. rst:directive:: .. warning:: An important bit of information about an API that a user should be very aware of when using whatever bit of API the warning pertains to. The content of the directive should be written in complete sentences and include all appropriate punctuation. This differs from :rst:dir:`note` in that it is recommended over :rst:dir:`note` for information regarding security. .. rst:directive:: .. versionadded:: version This directive documents the version of the project which added the described feature to the library or C API. When this applies to an entire module, it should be placed at the top of the module section before any prose. The first argument must be given and is the version in question; you can add a second argument consisting of a *brief* explanation of the change. Example:: .. versionadded:: 2.5 The *spam* parameter. Note that there must be no blank line between the directive head and the explanation; this is to make these blocks visually continuous in the markup. .. rst:directive:: .. versionchanged:: version Similar to :rst:dir:`versionadded`, but describes when and what changed in the named feature in some way (new parameters, changed side effects, etc.). .. rst:directive:: .. deprecated:: version Similar to :rst:dir:`versionchanged`, but describes when the feature was deprecated. An explanation can also be given, for example to inform the reader what should be used instead. Example:: .. deprecated:: 3.1 Use :func:`spam` instead. .. rst:directive:: seealso Many sections include a list of references to module documentation or external documents. These lists are created using the :rst:dir:`seealso` directive. The :rst:dir:`seealso` directive is typically placed in a section just before any subsections. For the HTML output, it is shown boxed off from the main flow of the text. The content of the :rst:dir:`seealso` directive should be a reST definition list. Example:: .. seealso:: Module :py:mod:`zipfile` Documentation of the :py:mod:`zipfile` standard module. `GNU tar manual, Basic Tar Format <http://link>`_ Documentation for tar archive files, including GNU tar extensions. There's also a "short form" allowed that looks like this:: .. seealso:: modules :py:mod:`zipfile`, :py:mod:`tarfile` .. versionadded:: 0.5 The short form. .. rst:directive:: .. rubric:: title This directive creates a paragraph heading that is not used to create a table of contents node. .. note:: If the *title* of the rubric is "Footnotes" (or the selected language's equivalent), this rubric is ignored by the LaTeX writer, since it is assumed to only contain footnote definitions and therefore would create an empty heading. .. rst:directive:: centered This directive creates a centered boldfaced line of text. Use it as follows:: .. centered:: LICENSE AGREEMENT .. deprecated:: 1.1 This presentation-only directive is a legacy from older versions. Use a :rst:dir:`rst-class` directive instead and add an appropriate style. .. rst:directive:: hlist This directive must contain a bullet list. It will transform it into a more compact list by either distributing more than one item horizontally, or reducing spacing between items, depending on the builder. For builders that support the horizontal distribution, there is a ``columns`` option that specifies the number of columns; it defaults to 2. Example:: .. hlist:: :columns: 3 * A list of * short items * that should be * displayed * horizontally .. versionadded:: 0.6 .. _code-examples: Showing code examples --------------------- .. index:: pair: code; examples single: sourcecode There are multiple ways to show syntax-highlighted literal code blocks in Sphinx: * using :ref:`reST doctest blocks <rst-doctest-blocks>`; * using :ref:`reST literal blocks <rst-literal-blocks>`, optionally in combination with the :rst:dir:`highlight` directive; * using the :rst:dir:`code-block` directive; * and using the :rst:dir:`literalinclude` directive. Doctest blocks can only be used to show interactive Python sessions, while the remaining three can be used for other languages. Of these three, literal blocks are useful when an entire document, or at least large sections of it, use code blocks with the same syntax and which should be styled in the same manner. On the other hand, the :rst:dir:`code-block` directive makes more sense when you want more fine-tuned control over the styling of each block or when you have a document containing code blocks using multiple varied syntaxes. Finally, the :rst:dir:`literalinclude` directive is useful for including entire code files in your documentation. In all cases, Syntax highlighting is provided by `Pygments <https://pygments.org>`_. When using literal blocks, this is configured using any :rst:dir:`highlight` directives in the source file. When a ``highlight`` directive is encountered, it is used until the next ``highlight`` directive is encountered. If there is no ``highlight`` directive in the file, the global highlighting language is used. This defaults to ``python`` but can be configured using the :confval:`highlight_language` config value. The following values are supported: * ``none`` (no highlighting) * ``default`` (similar to ``python3`` but with a fallback to ``none`` without warning highlighting fails; the default when :confval:`highlight_language` isn't set) * ``guess`` (let Pygments guess the lexer based on contents, only works with certain well-recognizable languages) * ``python`` * ``rest`` * ``c`` * ... and any other `lexer alias that Pygments supports`__ If highlighting with the selected language fails (i.e. Pygments emits an "Error" token), the block is not highlighted in any way. .. important:: The list of lexer aliases supported is tied to the Pygment version. If you want to ensure consistent highlighting, you should fix your version of Pygments. __ https://pygments.org/docs/lexers .. rst:directive:: .. highlight:: language Example:: .. highlight:: c This language is used until the next ``highlight`` directive is encountered. As discussed previously, *language* can be any lexer alias supported by Pygments. .. rubric:: options .. rst:directive:option:: linenothreshold: threshold :type: number (optional) Enable to generate line numbers for code blocks. This option takes an optional number as threshold parameter. If any threshold given, the directive will produce line numbers only for the code blocks longer than N lines. If not given, line numbers will be produced for all of code blocks. Example:: .. highlight:: python :linenothreshold: 5 .. rst:directive:option:: force :type: no value If given, minor errors on highlighting are ignored. .. versionadded:: 2.1 .. rst:directive:: .. code-block:: [language] Example:: .. code-block:: ruby Some Ruby code. The directive's alias name :rst:dir:`sourcecode` works as well. This directive takes a language name as an argument. It can be `any lexer alias supported by Pygments <https://pygments.org/docs/lexers/>`_. If it is not given, the setting of :rst:dir:`highlight` directive will be used. If not set, :confval:`highlight_language` will be used. .. versionchanged:: 2.0 The ``language`` argument becomes optional. .. rubric:: options .. rst:directive:option:: linenos :type: no value Enable to generate line numbers for the code block:: .. code-block:: ruby :linenos: Some more Ruby code. .. rst:directive:option:: lineno-start: number :type: number Set the first line number of the code block. If present, ``linenos`` option is also automatically activated:: .. code-block:: ruby :lineno-start: 10 Some more Ruby code, with line numbering starting at 10. .. versionadded:: 1.3 .. rst:directive:option:: emphasize-lines: line numbers :type: comma separated numbers Emphasize particular lines of the code block:: .. code-block:: python :emphasize-lines: 3,5 def some_function(): interesting = False print 'This line is highlighted.' print 'This one is not...' print '...but this one is.' .. versionadded:: 1.1 .. versionchanged:: 1.6.6 LaTeX supports the ``emphasize-lines`` option. .. rst:directive:option: force :type: no value Ignore minor errors on highlighting .. versionchanged:: 2.1 .. rst:directive:option:: caption: caption of code block :type: text Set a caption to the code block. .. versionadded:: 1.3 .. rst:directive:option:: name: a label for hyperlink :type: text Define implicit target name that can be referenced by using :rst:role:`ref`. For example:: .. code-block:: python :caption: this.py :name: this-py print 'Explicit is better than implicit.' In order to cross-reference a code-block using either the :rst:role:`ref` or the :rst:role:`numref` role, it is necessary that both :strong:`name` and :strong:`caption` be defined. The argument of :strong:`name` can then be given to :rst:role:`numref` to generate the cross-reference. Example:: See :numref:`this-py` for an example. When using :rst:role:`ref`, it is possible to generate a cross-reference with only :strong:`name` defined, provided an explicit title is given. Example:: See :ref:`this code snippet <this-py>` for an example. .. versionadded:: 1.3 .. rst:directive:option:: dedent: number :type: number or no value Strip indentation characters from the code block. When number given, leading N characters are removed. When no argument given, leading spaces are removed via :func:`textwrap.dedent()`. For example:: .. code-block:: ruby :dedent: 4 some ruby code .. versionadded:: 1.3 .. versionchanged:: 3.5 Support automatic dedent. .. rst:directive:option:: force :type: no value If given, minor errors on highlighting are ignored. .. versionadded:: 2.1 .. rst:directive:: .. literalinclude:: filename Longer displays of verbatim text may be included by storing the example text in an external file containing only plain text. The file may be included using the ``literalinclude`` directive. [#]_ For example, to include the Python source file :file:`example.py`, use:: .. literalinclude:: example.py The file name is usually relative to the current file's path. However, if it is absolute (starting with ``/``), it is relative to the top source directory. **Additional options** Like :rst:dir:`code-block`, the directive supports the ``linenos`` flag option to switch on line numbers, the ``lineno-start`` option to select the first line number, the ``emphasize-lines`` option to emphasize particular lines, the ``name`` option to provide an implicit target name, the ``dedent`` option to strip indentation characters for the code block, and a ``language`` option to select a language different from the current file's standard language. In addition, it supports the ``caption`` option; however, this can be provided with no argument to use the filename as the caption. Example with options:: .. literalinclude:: example.rb :language: ruby :emphasize-lines: 12,15-18 :linenos: Tabs in the input are expanded if you give a ``tab-width`` option with the desired tab width. Include files are assumed to be encoded in the :confval:`source_encoding`. If the file has a different encoding, you can specify it with the ``encoding`` option:: .. literalinclude:: example.py :encoding: latin-1 The directive also supports including only parts of the file. If it is a Python module, you can select a class, function or method to include using the ``pyobject`` option:: .. literalinclude:: example.py :pyobject: Timer.start This would only include the code lines belonging to the ``start()`` method in the ``Timer`` class within the file. Alternately, you can specify exactly which lines to include by giving a ``lines`` option:: .. literalinclude:: example.py :lines: 1,3,5-10,20- This includes the lines 1, 3, 5 to 10 and lines 20 to the last line. Another way to control which part of the file is included is to use the ``start-after`` and ``end-before`` options (or only one of them). If ``start-after`` is given as a string option, only lines that follow the first line containing that string are included. If ``end-before`` is given as a string option, only lines that precede the first lines containing that string are included. The ``start-at`` and ``end-at`` options behave in a similar way, but the lines containing the matched string are included. ``start-after``/``start-at`` and ``end-before``/``end-at`` can have same string. ``start-after``/``start-at`` filter lines before the line that contains option string (``start-at`` will keep the line). Then ``end-before``/``end-at`` filter lines after the line that contains option string (``end-at`` will keep the line and ``end-before`` skip the first line). .. note:: If you want to select only ``[second-section]`` of ini file like the following, you can use ``:start-at: [second-section]`` and ``:end-before: [third-section]``: .. code-block:: ini [first-section] var_in_first=true [second-section] var_in_second=true [third-section] var_in_third=true Useful cases of these option is working with tag comments. ``:start-after: [initialized]`` and ``:end-before: [initialized]`` options keep lines between comments: .. code-block:: py if __name__ == "__main__": # [initialize] app.start(":8000") # [initialize] When lines have been selected in any of the ways described above, the line numbers in ``emphasize-lines`` refer to those selected lines, counted consecutively starting at ``1``. When specifying particular parts of a file to display, it can be useful to display the original line numbers. This can be done using the ``lineno-match`` option, which is however allowed only when the selection consists of contiguous lines. You can prepend and/or append a line to the included code, using the ``prepend`` and ``append`` option, respectively. This is useful e.g. for highlighting PHP code that doesn't include the ``<?php``/``?>`` markers. If you want to show the diff of the code, you can specify the old file by giving a ``diff`` option:: .. literalinclude:: example.py :diff: example.py.orig This shows the diff between ``example.py`` and ``example.py.orig`` with unified diff format. A ``force`` option can ignore minor errors on highlighting. .. versionchanged:: 0.4.3 Added the ``encoding`` option. .. versionchanged:: 0.6 Added the ``pyobject``, ``lines``, ``start-after`` and ``end-before`` options, as well as support for absolute filenames. .. versionchanged:: 1.0 Added the ``prepend``, ``append``, and ``tab-width`` options. .. versionchanged:: 1.3 Added the ``diff``, ``lineno-match``, ``caption``, ``name``, and ``dedent`` options. .. versionchanged:: 1.5 Added the ``start-at``, and ``end-at`` options. .. versionchanged:: 1.6 With both ``start-after`` and ``lines`` in use, the first line as per ``start-after`` is considered to be with line number ``1`` for ``lines``. .. versionchanged:: 2.1 Added the ``force`` option. .. versionchanged:: 3.5 Support automatic dedent. .. _glossary-directive: Glossary -------- .. rst:directive:: .. glossary:: This directive must contain a reST definition-list-like markup with terms and definitions. The definitions will then be referenceable with the :rst:role:`term` role. Example:: .. glossary:: environment A structure where information about all documents under the root is saved, and used for cross-referencing. The environment is pickled after the parsing stage, so that successive runs only need to read and parse new and changed documents. source directory The directory which, including its subdirectories, contains all source files for one Sphinx project. In contrast to regular definition lists, *multiple* terms per entry are allowed, and inline markup is allowed in terms. You can link to all of the terms. For example:: .. glossary:: term 1 term 2 Definition of both terms. (When the glossary is sorted, the first term determines the sort order.) If you want to specify "grouping key" for general index entries, you can put a "key" as "term : key". For example:: .. glossary:: term 1 : A term 2 : B Definition of both terms. Note that "key" is used for grouping key as is. The "key" isn't normalized; key "A" and "a" become different groups. The whole characters in "key" is used instead of a first character; it is used for "Combining Character Sequence" and "Surrogate Pairs" grouping key. In i18n situation, you can specify "localized term : key" even if original text only have "term" part. In this case, translated "localized term" will be categorized in "key" group. .. versionadded:: 0.6 You can now give the glossary directive a ``:sorted:`` flag that will automatically sort the entries alphabetically. .. versionchanged:: 1.1 Now supports multiple terms and inline markup in terms. .. versionchanged:: 1.4 Index key for glossary term should be considered *experimental*. Meta-information markup ----------------------- .. rst:directive:: .. sectionauthor:: name <email> Identifies the author of the current section. The argument should include the author's name such that it can be used for presentation and email address. The domain name portion of the address should be lower case. Example:: .. sectionauthor:: Guido van Rossum <guido@python.org> By default, this markup isn't reflected in the output in any way (it helps keep track of contributions), but you can set the configuration value :confval:`show_authors` to ``True`` to make them produce a paragraph in the output. .. rst:directive:: .. codeauthor:: name <email> The :rst:dir:`codeauthor` directive, which can appear multiple times, names the authors of the described code, just like :rst:dir:`sectionauthor` names the author(s) of a piece of documentation. It too only produces output if the :confval:`show_authors` configuration value is ``True``. Index-generating markup ----------------------- Sphinx automatically creates index entries from all object descriptions (like functions, classes or attributes) like discussed in :doc:`/usage/restructuredtext/domains`. However, there is also explicit markup available, to make the index more comprehensive and enable index entries in documents where information is not mainly contained in information units, such as the language reference. .. rst:directive:: .. index:: <entries> This directive contains one or more index entries. Each entry consists of a type and a value, separated by a colon. For example:: .. index:: single: execution; context module: __main__ module: sys triple: module; search; path The execution context --------------------- ... This directive contains five entries, which will be converted to entries in the generated index which link to the exact location of the index statement (or, in case of offline media, the corresponding page number). Since index directives generate cross-reference targets at their location in the source, it makes sense to put them *before* the thing they refer to -- e.g. a heading, as in the example above. The possible entry types are: single Creates a single index entry. Can be made a subentry by separating the subentry text with a semicolon (this notation is also used below to describe what entries are created). pair ``pair: loop; statement`` is a shortcut that creates two index entries, namely ``loop; statement`` and ``statement; loop``. triple Likewise, ``triple: module; search; path`` is a shortcut that creates three index entries, which are ``module; search path``, ``search; path, module`` and ``path; module search``. see ``see: entry; other`` creates an index entry that refers from ``entry`` to ``other``. seealso Like ``see``, but inserts "see also" instead of "see". module, keyword, operator, object, exception, statement, builtin These all create two index entries. For example, ``module: hashlib`` creates the entries ``module; hashlib`` and ``hashlib; module``. (These are Python-specific and therefore deprecated.) You can mark up "main" index entries by prefixing them with an exclamation mark. The references to "main" entries are emphasized in the generated index. For example, if two pages contain :: .. index:: Python and one page contains :: .. index:: ! Python then the backlink to the latter page is emphasized among the three backlinks. For index directives containing only "single" entries, there is a shorthand notation:: .. index:: BNF, grammar, syntax, notation This creates four index entries. .. versionchanged:: 1.1 Added ``see`` and ``seealso`` types, as well as marking main entries. .. rubric:: options .. rst:directive:option:: name: a label for hyperlink :type: text Define implicit target name that can be referenced by using :rst:role:`ref`. For example:: .. index:: Python :name: py-index .. versionadded:: 3.0 .. rst:role:: index While the :rst:dir:`index` directive is a block-level markup and links to the beginning of the next paragraph, there is also a corresponding role that sets the link target directly where it is used. The content of the role can be a simple phrase, which is then kept in the text and used as an index entry. It can also be a combination of text and index entry, styled like with explicit targets of cross-references. In that case, the "target" part can be a full entry as described for the directive above. For example:: This is a normal reST :index:`paragraph` that contains several :index:`index entries <pair: index; entry>`. .. versionadded:: 1.1 .. _tags: Including content based on tags ------------------------------- .. rst:directive:: .. only:: <expression> Include the content of the directive only if the *expression* is true. The expression should consist of tags, like this:: .. only:: html and draft Undefined tags are false, defined tags (via the ``-t`` command-line option or within :file:`conf.py`, see :ref:`here <conf-tags>`) are true. Boolean expressions, also using parentheses (like ``html and (latex or draft)``) are supported. The *format* and the *name* of the current builder (``html``, ``latex`` or ``text``) are always set as a tag [#]_. To make the distinction between format and name explicit, they are also added with the prefix ``format_`` and ``builder_``, e.g. the epub builder defines the tags ``html``, ``epub``, ``format_html`` and ``builder_epub``. These standard tags are set *after* the configuration file is read, so they are not available there. All tags must follow the standard Python identifier syntax as set out in the `Identifiers and keywords <https://docs.python.org/3/reference/lexical_analysis.html#identifiers>`_ documentation. That is, a tag expression may only consist of tags that conform to the syntax of Python variables. In ASCII, this consists of the uppercase and lowercase letters ``A`` through ``Z``, the underscore ``_`` and, except for the first character, the digits ``0`` through ``9``. .. versionadded:: 0.6 .. versionchanged:: 1.2 Added the name of the builder and the prefixes. .. warning:: This directive is designed to control only content of document. It could not control sections, labels and so on. .. _table-directives: Tables ------ Use :ref:`reStructuredText tables <rst-tables>`, i.e. either - grid table syntax (:duref:`ref <grid-tables>`), - simple table syntax (:duref:`ref <simple-tables>`), - :dudir:`csv-table` syntax, - or :dudir:`list-table` syntax. The :dudir:`table` directive serves as optional wrapper of the *grid* and *simple* syntaxes. They work fine in HTML output, however there are some gotchas when using tables in LaTeX: the column width is hard to determine correctly automatically. For this reason, the following directive exists: .. rst:directive:: .. tabularcolumns:: column spec This directive gives a "column spec" for the next table occurring in the source file. The spec is the second argument to the LaTeX ``tabulary`` package's environment (which Sphinx uses to translate tables). It can have values like :: |l|l|l| which means three left-adjusted, nonbreaking columns. For columns with longer text that should automatically be broken, use either the standard ``p{width}`` construct, or tabulary's automatic specifiers: +-----+------------------------------------------+ |``L``| flush left column with automatic width | +-----+------------------------------------------+ |``R``| flush right column with automatic width | +-----+------------------------------------------+ |``C``| centered column with automatic width | +-----+------------------------------------------+ |``J``| justified column with automatic width | +-----+------------------------------------------+ The automatic widths of the ``LRCJ`` columns are attributed by ``tabulary`` in proportion to the observed shares in a first pass where the table cells are rendered at their natural "horizontal" widths. By default, Sphinx uses a table layout with ``J`` for every column. .. versionadded:: 0.3 .. versionchanged:: 1.6 Merged cells may now contain multiple paragraphs and are much better handled, thanks to custom Sphinx LaTeX macros. This novel situation motivated the switch to ``J`` specifier and not ``L`` by default. .. hint:: Sphinx actually uses ``T`` specifier having done ``\newcolumntype{T}{J}``. To revert to previous default, insert ``\newcolumntype{T}{L}`` in the LaTeX preamble (see :confval:`latex_elements`). A frequent issue with tabulary is that columns with little contents are "squeezed". The minimal column width is a tabulary parameter called ``\tymin``. You may set it globally in the LaTeX preamble via ``\setlength{\tymin}{40pt}`` for example. Else, use the :rst:dir:`tabularcolumns` directive with an explicit ``p{40pt}`` (for example) for that column. You may use also ``l`` specifier but this makes the task of setting column widths more difficult if some merged cell intersects that column. .. warning:: Tables with more than 30 rows are rendered using ``longtable``, not ``tabulary``, in order to allow pagebreaks. The ``L``, ``R``, ... specifiers do not work for these tables. Tables that contain list-like elements such as object descriptions, blockquotes or any kind of lists cannot be set out of the box with ``tabulary``. They are therefore set with the standard LaTeX ``tabular`` (or ``longtable``) environment if you don't give a ``tabularcolumns`` directive. If you do, the table will be set with ``tabulary`` but you must use the ``p{width}`` construct (or Sphinx's ``\X`` and ``\Y`` specifiers described below) for the columns containing these elements. Literal blocks do not work with ``tabulary`` at all, so tables containing a literal block are always set with ``tabular``. The verbatim environment used for literal blocks only works in ``p{width}`` (and ``\X`` or ``\Y``) columns, hence Sphinx generates such column specs for tables containing literal blocks. Since Sphinx 1.5, the ``\X{a}{b}`` specifier is used (there *is* a backslash in the specifier letter). It is like ``p{width}`` with the width set to a fraction ``a/b`` of the current line width. You can use it in the :rst:dir:`tabularcolumns` (it is not a problem if some LaTeX macro is also called ``\X``.) It is *not* needed for ``b`` to be the total number of columns, nor for the sum of the fractions of the ``\X`` specifiers to add up to one. For example ``|\X{2}{5}|\X{1}{5}|\X{1}{5}|`` is legitimate and the table will occupy 80% of the line width, the first of its three columns having the same width as the sum of the next two. This is used by the ``:widths:`` option of the :dudir:`table` directive. Since Sphinx 1.6, there is also the ``\Y{f}`` specifier which admits a decimal argument, such has ``\Y{0.15}``: this would have the same effect as ``\X{3}{20}``. .. versionchanged:: 1.6 Merged cells from complex grid tables (either multi-row, multi-column, or both) now allow blockquotes, lists, literal blocks, ... as do regular cells. Sphinx's merged cells interact well with ``p{width}``, ``\X{a}{b}``, ``\Y{f}`` and tabulary's columns. .. note:: :rst:dir:`tabularcolumns` conflicts with ``:widths:`` option of table directives. If both are specified, ``:widths:`` option will be ignored. Math ---- The input language for mathematics is LaTeX markup. This is the de-facto standard for plain-text math notation and has the added advantage that no further translation is necessary when building LaTeX output. Keep in mind that when you put math markup in **Python docstrings** read by :mod:`autodoc <sphinx.ext.autodoc>`, you either have to double all backslashes, or use Python raw strings (``r"raw"``). .. rst:directive:: math Directive for displayed math (math that takes the whole line for itself). The directive supports multiple equations, which should be separated by a blank line:: .. math:: (a + b)^2 = a^2 + 2ab + b^2 (a - b)^2 = a^2 - 2ab + b^2 In addition, each single equation is set within a ``split`` environment, which means that you can have multiple aligned lines in an equation, aligned at ``&`` and separated by ``\\``:: .. math:: (a + b)^2 &= (a + b)(a + b) \\ &= a^2 + 2ab + b^2 For more details, look into the documentation of the `AmSMath LaTeX package`_. When the math is only one line of text, it can also be given as a directive argument:: .. math:: (a + b)^2 = a^2 + 2ab + b^2 Normally, equations are not numbered. If you want your equation to get a number, use the ``label`` option. When given, it selects an internal label for the equation, by which it can be cross-referenced, and causes an equation number to be issued. See :rst:role:`eq` for an example. The numbering style depends on the output format. There is also an option ``nowrap`` that prevents any wrapping of the given math in a math environment. When you give this option, you must make sure yourself that the math is properly set up. For example:: .. math:: :nowrap: \begin{eqnarray} y & = & ax^2 + bx + c \\ f(x) & = & x^2 + 2xy + y^2 \end{eqnarray} .. _AmSMath LaTeX package: https://www.ams.org/publications/authors/tex/amslatex .. seealso:: :ref:`math-support` Rendering options for math with HTML builders. :confval:`latex_engine` Explains how to configure LaTeX builder to support Unicode literals in math mark-up. Grammar production displays --------------------------- Special markup is available for displaying the productions of a formal grammar. The markup is simple and does not attempt to model all aspects of BNF (or any derived forms), but provides enough to allow context-free grammars to be displayed in a way that causes uses of a symbol to be rendered as hyperlinks to the definition of the symbol. There is this directive: .. rst:directive:: .. productionlist:: [productionGroup] This directive is used to enclose a group of productions. Each production is given on a single line and consists of a name, separated by a colon from the following definition. If the definition spans multiple lines, each continuation line must begin with a colon placed at the same column as in the first line. Blank lines are not allowed within ``productionlist`` directive arguments. The definition can contain token names which are marked as interpreted text (e.g., "``sum ::= `integer` "+" `integer```") -- this generates cross-references to the productions of these tokens. Outside of the production list, you can reference to token productions using :rst:role:`token`. The *productionGroup* argument to :rst:dir:`productionlist` serves to distinguish different sets of production lists that belong to different grammars. Multiple production lists with the same *productionGroup* thus define rules in the same scope. Inside of the production list, tokens implicitly refer to productions from the current group. You can refer to the production of another grammar by prefixing the token with its group name and a colon, e.g, "``otherGroup:sum``". If the group of the token should not be shown in the production, it can be prefixed by a tilde, e.g., "``~otherGroup:sum``". To refer to a production from an unnamed grammar, the token should be prefixed by a colon, e.g., "``:sum``". Outside of the production list, if you have given a *productionGroup* argument you must prefix the token name in the cross-reference with the group name and a colon, e.g., "``myGroup:sum``" instead of just "``sum``". If the group should not be shown in the title of the link either an explicit title can be given (e.g., "``myTitle <myGroup:sum>``"), or the target can be prefixed with a tilde (e.g., "``~myGroup:sum``"). Note that no further reST parsing is done in the production, so that you don't have to escape ``*`` or ``|`` characters. The following is an example taken from the Python Reference Manual:: .. productionlist:: try_stmt: try1_stmt | try2_stmt try1_stmt: "try" ":" `suite` : ("except" [`expression` ["," `target`]] ":" `suite`)+ : ["else" ":" `suite`] : ["finally" ":" `suite`] try2_stmt: "try" ":" `suite` : "finally" ":" `suite` .. rubric:: Footnotes .. [#] The LaTeX writer only refers the ``maxdepth`` option of first toctree directive in the document. .. [#] A note on available globbing syntax: you can use the standard shell constructs ``*``, ``?``, ``[...]`` and ``[!...]`` with the feature that these all don't match slashes. A double star ``**`` can be used to match any sequence of characters *including* slashes. .. [#] There is a standard ``.. include`` directive, but it raises errors if the file is not found. This one only emits a warning. .. [#] For most builders name and format are the same. At the moment only builders derived from the html builder distinguish between the builder format and the builder name. Note that the current builder tag is not available in ``conf.py``, it is only available after the builder is initialized. ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/restructuredtext/domains.rst�������������������������������������������������0000644�0000766�0000024�00000164240�00000000000�022037� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: rst ======= Domains ======= .. versionadded:: 1.0 Originally, Sphinx was conceived for a single project, the documentation of the Python language. Shortly afterwards, it was made available for everyone as a documentation tool, but the documentation of Python modules remained deeply built in -- the most fundamental directives, like ``function``, were designed for Python objects. Since Sphinx has become somewhat popular, interest developed in using it for many different purposes: C/C++ projects, JavaScript, or even reStructuredText markup (like in this documentation). While this was always possible, it is now much easier to easily support documentation of projects using different programming languages or even ones not supported by the main Sphinx distribution, by providing a **domain** for every such purpose. A domain is a collection of markup (reStructuredText :term:`directive`\ s and :term:`role`\ s) to describe and link to :term:`object`\ s belonging together, e.g. elements of a programming language. Directive and role names in a domain have names like ``domain:name``, e.g. ``py:function``. Domains can also provide custom indices (like the Python Module Index). Having domains means that there are no naming problems when one set of documentation wants to refer to e.g. C++ and Python classes. It also means that extensions that support the documentation of whole new languages are much easier to write. This section describes what the domains that are included with Sphinx provide. The domain API is documented as well, in the section :ref:`domain-api`. .. _basic-domain-markup: Basic Markup ------------ Most domains provide a number of :dfn:`object description directives`, used to describe specific objects provided by modules. Each directive requires one or more signatures to provide basic information about what is being described, and the content should be the description. A domain will typically keep an internal index of all entities to aid cross-referencing. Typically it will also add entries in the shown general index. If you want to suppress the addition of an entry in the shown index, you can give the directive option flag ``:noindexentry:``. If you want to typeset an object description, without even making it available for cross-referencing, you can give the directive option flag ``:noindex:`` (which implies ``:noindexentry:``). Though, note that not every directive in every domain may support these options. .. versionadded:: 3.2 The directive option ``noindexentry`` in the Python, C, C++, and Javascript domains. An example using a Python domain directive:: .. py:function:: spam(eggs) ham(eggs) Spam or ham the foo. This describes the two Python functions ``spam`` and ``ham``. (Note that when signatures become too long, you can break them if you add a backslash to lines that are continued in the next line. Example:: .. py:function:: filterwarnings(action, message='', category=Warning, \ module='', lineno=0, append=False) :noindex: (This example also shows how to use the ``:noindex:`` flag.) The domains also provide roles that link back to these object descriptions. For example, to link to one of the functions described in the example above, you could say :: The function :py:func:`spam` does a similar thing. As you can see, both directive and role names contain the domain name and the directive name. .. rubric:: Default Domain For documentation describing objects from solely one domain, authors will not have to state again its name at each directive, role, etc... after having specified a default. This can be done either via the config value :confval:`primary_domain` or via this directive: .. rst:directive:: .. default-domain:: name Select a new default domain. While the :confval:`primary_domain` selects a global default, this only has an effect within the same file. If no other default is selected, the Python domain (named ``py``) is the default one, mostly for compatibility with documentation written for older versions of Sphinx. Directives and roles that belong to the default domain can be mentioned without giving the domain name, i.e. :: .. function:: pyfunc() Describes a Python function. Reference to :func:`pyfunc`. Cross-referencing syntax ~~~~~~~~~~~~~~~~~~~~~~~~ For cross-reference roles provided by domains, the same facilities exist as for general cross-references. See :ref:`xref-syntax`. In short: * You may supply an explicit title and reference target: ``:role:`title <target>``` will refer to *target*, but the link text will be *title*. * If you prefix the content with ``!``, no reference/hyperlink will be created. * 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. .. _python-domain: The Python Domain ----------------- The Python domain (name **py**) provides the following directives for module declarations: .. rst:directive:: .. py:module:: name This directive marks the beginning of the description of a module (or package submodule, in which case the name should be fully qualified, including the package name). It does not create content (like e.g. :rst:dir:`py:class` does). This directive will also cause an entry in the global module index. .. rubric:: options .. rst:directive:option:: platform: platforms :type: comma separated list Indicate platforms which the module is available (if it is available on all platforms, the option should be omitted). The keys are short identifiers; examples that are in use include "IRIX", "Mac", "Windows" and "Unix". It is important to use a key which has already been used when applicable. .. rst:directive:option:: synopsis: purpose :type: text Consist of one sentence describing the module's purpose -- it is currently only used in the Global Module Index. .. rst:directive:option:: deprecated :type: no argument Mark a module as deprecated; it will be designated as such in various locations then. .. rst:directive:: .. py:currentmodule:: name This directive tells Sphinx that the classes, functions etc. documented from here are in the given module (like :rst:dir:`py:module`), but it will not create index entries, an entry in the Global Module Index, or a link target for :rst:role:`py:mod`. This is helpful in situations where documentation for things in a module is spread over multiple files or sections -- one location has the :rst:dir:`py:module` directive, the others only :rst:dir:`py:currentmodule`. The following directives are provided for module and class contents: .. rst:directive:: .. py:function:: name(parameters) Describes a module-level function. The signature should include the parameters as given in the Python function definition, see :ref:`signatures`. For example:: .. py:function:: Timer.repeat(repeat=3, number=1000000) For methods you should use :rst:dir:`py:method`. The description normally includes information about the parameters required and how they are used (especially whether mutable objects passed as parameters are modified), side effects, and possible exceptions. This information can (in any ``py`` directive) optionally be given in a structured form, see :ref:`info-field-lists`. .. rubric:: options .. rst:directive:option:: async :type: no value Indicate the function is an async function. .. versionadded:: 2.1 .. rst:directive:option:: canonical :type: full qualified name including module name Describe the location where the object is defined if the object is imported from other modules .. versionadded:: 4.0 .. rst:directive:: .. py:data:: name Describes global data in a module, including both variables and values used as "defined constants." Class and object attributes are not documented using this environment. .. rubric:: options .. rst:directive:option:: type: type of the variable :type: text .. versionadded:: 2.4 .. rst:directive:option:: value: initial value of the variable :type: text .. versionadded:: 2.4 .. rst:directive:option:: canonical :type: full qualified name including module name Describe the location where the object is defined if the object is imported from other modules .. versionadded:: 4.0 .. rst:directive:: .. py:exception:: name Describes an exception class. The signature can, but need not include parentheses with constructor arguments. .. rubric:: options .. rst:directive:option:: final :type: no value Indicate the class is a final class. .. versionadded:: 3.1 .. rst:directive:: .. py:class:: name .. py:class:: name(parameters) Describes a class. The signature can optionally include parentheses with parameters which will be shown as the constructor arguments. See also :ref:`signatures`. Methods and attributes belonging to the class should be placed in this directive's body. If they are placed outside, the supplied name should contain the class name so that cross-references still work. Example:: .. py:class:: Foo .. py:method:: quux() -- or -- .. py:class:: Bar .. py:method:: Bar.quux() The first way is the preferred one. .. rubric:: options .. rst:directive:option:: canonical :type: full qualified name including module name Describe the location where the object is defined if the object is imported from other modules .. versionadded:: 4.0 .. rst:directive:option:: final :type: no value Indicate the class is a final class. .. versionadded:: 3.1 .. rst:directive:: .. py:attribute:: name Describes an object data attribute. The description should include information about the type of the data to be expected and whether it may be changed directly. .. rubric:: options .. rst:directive:option:: type: type of the attribute :type: text .. versionadded:: 2.4 .. rst:directive:option:: value: initial value of the attribute :type: text .. versionadded:: 2.4 .. rst:directive:option:: canonical :type: full qualified name including module name Describe the location where the object is defined if the object is imported from other modules .. versionadded:: 4.0 .. rst:directive:: .. py:property:: name Describes an object property. .. versionadded:: 4.0 .. rubric:: options .. rst:directive:option:: abstractmethod :type: no value Indicate the property is abstract. .. rst:directive:option:: classmethod :type: no value Indicate the property is a classmethod. .. versionaddedd: 4.2 .. rst:directive:option:: type: type of the property :type: text .. rst:directive:: .. py:method:: name(parameters) Describes an object method. The parameters should not include the ``self`` parameter. The description should include similar information to that described for ``function``. See also :ref:`signatures` and :ref:`info-field-lists`. .. rubric:: options .. rst:directive:option:: abstractmethod :type: no value Indicate the method is an abstract method. .. versionadded:: 2.1 .. rst:directive:option:: async :type: no value Indicate the method is an async method. .. versionadded:: 2.1 .. rst:directive:option:: canonical :type: full qualified name including module name Describe the location where the object is defined if the object is imported from other modules .. versionadded:: 4.0 .. rst:directive:option:: classmethod :type: no value Indicate the method is a class method. .. versionadded:: 2.1 .. rst:directive:option:: final :type: no value Indicate the class is a final method. .. versionadded:: 3.1 .. rst:directive:option:: property :type: no value Indicate the method is a property. .. versionadded:: 2.1 .. deprecated:: 4.0 Use :rst:dir:`py:property` instead. .. rst:directive:option:: staticmethod :type: no value Indicate the method is a static method. .. versionadded:: 2.1 .. rst:directive:: .. py:staticmethod:: name(parameters) Like :rst:dir:`py:method`, but indicates that the method is a static method. .. versionadded:: 0.4 .. rst:directive:: .. py:classmethod:: name(parameters) Like :rst:dir:`py:method`, but indicates that the method is a class method. .. versionadded:: 0.6 .. rst:directive:: .. py:decorator:: name .. py:decorator:: name(parameters) Describes a decorator function. The signature should represent the usage as a decorator. For example, given the functions .. code-block:: python def removename(func): func.__name__ = '' return func def setnewname(name): def decorator(func): func.__name__ = name return func return decorator the descriptions should look like this:: .. py:decorator:: removename Remove name of the decorated function. .. py:decorator:: setnewname(name) Set name of the decorated function to *name*. (as opposed to ``.. py:decorator:: removename(func)``.) 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. .. rst:directive:: .. py:decoratormethod:: name .. py:decoratormethod:: name(signature) Same as :rst:dir:`py:decorator`, but for decorators that are methods. Refer to a decorator method using the :rst:role:`py:meth` role. .. _signatures: Python Signatures ~~~~~~~~~~~~~~~~~ Signatures of functions, methods and class constructors can be given like they would be written in Python. Default values for optional arguments can be given (but if they contain commas, they will confuse the signature parser). Python 3-style argument annotations can also be given as well as return type annotations:: .. py:function:: compile(source : string, filename, symbol='file') -> ast object For functions with optional parameters that don't have default values (typically functions implemented in C extension modules without keyword argument support), you can use brackets to specify the optional parts: .. py:function:: compile(source[, filename[, symbol]]) It is customary to put the opening bracket before the comma. .. _info-field-lists: Info field lists ~~~~~~~~~~~~~~~~ .. versionadded:: 0.4 .. versionchanged:: 3.0 meta fields are added. Inside Python object description directives, reST field lists with these fields are recognized and formatted nicely: * ``param``, ``parameter``, ``arg``, ``argument``, ``key``, ``keyword``: Description of a parameter. * ``type``: Type of a parameter. Creates a link if possible. * ``raises``, ``raise``, ``except``, ``exception``: That (and when) a specific exception is raised. * ``var``, ``ivar``, ``cvar``: Description of a variable. * ``vartype``: Type of a variable. Creates a link if possible. * ``returns``, ``return``: Description of the return value. * ``rtype``: Return type. Creates a link if possible. * ``meta``: Add metadata to description of the python object. The metadata will not be shown on output document. For example, ``:meta private:`` indicates the python object is private member. It is used in :py:mod:`sphinx.ext.autodoc` for filtering members. .. note:: In current release, all ``var``, ``ivar`` and ``cvar`` are represented as "Variable". There is no difference at all. 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:: .. py:function:: send_message(sender, recipient, message_body, [priority=1]) Send a message to a recipient :param str sender: The person sending the message :param str recipient: The recipient of the message :param str message_body: The body of the message :param priority: The priority of the message, can be a number 1-5 :type priority: integer or None :return: the message id :rtype: int :raises ValueError: if the message_body exceeds 160 characters :raises TypeError: if the message_body is not a basestring This will render like this: .. py:function:: send_message(sender, recipient, message_body, [priority=1]) :noindex: Send a message to a recipient :param str sender: The person sending the message :param str recipient: The recipient of the message :param str message_body: The body of the message :param priority: The priority of the message, can be a number 1-5 :type priority: integer or None :return: the message id :rtype: int :raises ValueError: if the message_body exceeds 160 characters :raises TypeError: if the message_body is not a basestring It is also possible to combine parameter type and description, if the type is a single word, like this:: :param int priority: The priority of the message, can be a number 1-5 .. versionadded:: 1.5 Container types such as lists and dictionaries can be linked automatically using the following syntax:: :type priorities: list(int) :type priorities: list[int] :type mapping: dict(str, int) :type mapping: dict[str, int] :type point: tuple(float, float) :type point: tuple[float, float] Multiple types in a type field will be linked automatically if separated by the word "or":: :type an_arg: int or None :vartype a_var: str or int :rtype: float or str .. _python-roles: Cross-referencing Python objects ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following roles refer to objects in modules and are possibly hyperlinked if a matching identifier is found: .. rst:role:: py:mod Reference a module; a dotted name may be used. This should also be used for package names. .. rst:role:: py:func Reference a Python function; dotted names may be used. The role text needs not include trailing parentheses to enhance readability; they will be added automatically by Sphinx if the :confval:`add_function_parentheses` config value is ``True`` (the default). .. rst:role:: py:data Reference a module-level variable. .. rst:role:: py:const Reference a "defined" constant. This may be a Python variable that is not intended to be changed. .. rst:role:: py:class Reference a class; a dotted name may be used. .. rst:role:: py:meth 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. .. rst:role:: py:attr Reference a data attribute of an object. .. note:: The role is also able to refer to property. .. rst:role:: py:exc Reference an exception. A dotted name may be used. .. rst:role:: py:obj Reference an object of unspecified type. Useful e.g. as the :confval:`default_role`. .. versionadded:: 0.4 The name enclosed in this markup can include a module name and/or a class name. For example, ``:py:func:`filter``` could refer to a function named ``filter`` in the current module, or the built-in function of that name. In contrast, ``:py:func:`foo.filter``` clearly refers to the ``filter`` function in the ``foo`` module. Normally, 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. If you prefix the name with a dot, this order is reversed. For example, in the documentation of Python's :mod:`codecs` module, ``:py:func:`open``` always refers to the built-in function, while ``:py:func:`.open``` refers to :func:`codecs.open`. A similar heuristic is used to determine whether the name is an attribute of the currently documented class. 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 searched. For example, ``:py:meth:`.TarFile.close``` references the ``tarfile.TarFile.close()`` function, even if the current module is not ``tarfile``. Since this can get ambiguous, if there is more than one possible match, you will get a warning from Sphinx. Note that you can combine the ``~`` and ``.`` prefixes: ``:py:meth:`~.TarFile.close``` will reference the ``tarfile.TarFile.close()`` method, but the visible link caption will only be ``close()``. .. _c-domain: The C Domain ------------ The C domain (name **c**) is suited for documentation of C API. .. rst:directive:: .. c:member:: declaration .. c:var:: declaration Describes a C struct member or variable. Example signature:: .. c:member:: PyObject *PyTypeObject.tp_bases The difference between the two directives is only cosmetic. .. rst:directive:: .. c:function:: function prototype Describes a C function. The signature should be given as in C, e.g.:: .. c:function:: PyObject *PyType_GenericAlloc(PyTypeObject *type, Py_ssize_t nitems) Note that you don't have to backslash-escape asterisks in the signature, as it is not parsed by the reST inliner. In the description of a function you can use the following info fields (see also :ref:`info-field-lists`). * ``param``, ``parameter``, ``arg``, ``argument``, Description of a parameter. * ``type``: Type of a parameter, written as if passed to the :rst:role:`c:expr` role. * ``returns``, ``return``: Description of the return value. * ``rtype``: Return type, written as if passed to the :rst:role:`c:expr` role. * ``retval``, ``retvals``: An alternative to ``returns`` for describing the result of the function. .. versionadded:: 4.3 The ``retval`` field type. For example:: .. c:function:: PyObject *PyType_GenericAlloc(PyTypeObject *type, Py_ssize_t nitems) :param type: description of the first parameter. :param nitems: description of the second parameter. :returns: a result. :retval NULL: under some conditions. :retval NULL: under some other conditions as well. which renders as .. c:function:: PyObject *PyType_GenericAlloc(PyTypeObject *type, Py_ssize_t nitems) .. ** for some editors (e.g., vim) to stop bold-highlighting the source :param type: description of the first parameter. :param nitems: description of the second parameter. :returns: a result. :retval NULL: under some conditions. :retval NULL: under some other conditions as well. .. rst:directive:: .. c:macro:: name .. c:macro:: name(arg list) Describes a C macro, i.e., a C-language ``#define``, without the replacement text. In the description of a macro you can use the same info fields as for the :rst:dir:`c:function` directive. .. versionadded:: 3.0 The function style variant. .. rst:directive:: .. c:struct:: name Describes a C struct. .. versionadded:: 3.0 .. rst:directive:: .. c:union:: name Describes a C union. .. versionadded:: 3.0 .. rst:directive:: .. c:enum:: name Describes a C enum. .. versionadded:: 3.0 .. rst:directive:: .. c:enumerator:: name Describes a C enumerator. .. versionadded:: 3.0 .. rst:directive:: .. c:type:: typedef-like declaration .. c:type:: name Describes a C type, either as a typedef, or the alias for an unspecified type. .. _c-roles: Cross-referencing C constructs ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following roles create cross-references to C-language constructs if they are defined in the documentation: .. rst:role:: c:member c:data c:var c:func c:macro c:struct c:union c:enum c:enumerator c:type Reference a C declaration, as defined above. Note that :rst:role:`c:member`, :rst:role:`c:data`, and :rst:role:`c:var` are equivalent. .. versionadded:: 3.0 The var, struct, union, enum, and enumerator roles. Anonymous Entities ~~~~~~~~~~~~~~~~~~ C supports anonymous structs, enums, and unions. For the sake of documentation they must be given some name that starts with ``@``, e.g., ``@42`` or ``@data``. These names can also be used in cross-references, though nested symbols will be found even when omitted. The ``@...`` name will always be rendered as **[anonymous]** (possibly as a link). Example:: .. c:struct:: Data .. c:union:: @data .. c:var:: int a .. c:var:: double b Explicit ref: :c:var:`Data.@data.a`. Short-hand ref: :c:var:`Data.a`. This will be rendered as: .. c:struct:: Data .. c:union:: @data .. c:var:: int a .. c:var:: double b Explicit ref: :c:var:`Data.@data.a`. Short-hand ref: :c:var:`Data.a`. .. versionadded:: 3.0 Aliasing Declarations ~~~~~~~~~~~~~~~~~~~~~ .. c:namespace-push:: @alias Sometimes it may be helpful list declarations elsewhere than their main documentation, e.g., when creating a synopsis of an interface. The following directive can be used for this purpose. .. rst:directive:: .. c:alias:: name Insert one or more alias declarations. Each entity can be specified as they can in the :rst:role:`c:any` role. For example:: .. c:var:: int data .. c:function:: int f(double k) .. c:alias:: data f becomes .. c:var:: int data .. c:function:: int f(double k) .. c:alias:: data f .. versionadded:: 3.2 .. rubric:: Options .. rst:directive:option:: maxdepth: int Insert nested declarations as well, up to the total depth given. Use 0 for infinite depth and 1 for just the mentioned declaration. Defaults to 1. .. versionadded:: 3.3 .. rst:directive:option:: noroot Skip the mentioned declarations and only render nested declarations. Requires ``maxdepth`` either 0 or at least 2. .. versionadded:: 3.5 .. c:namespace-pop:: Inline Expressions and Types ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. rst:role:: c:expr c:texpr Insert a C expression or type either as inline code (``cpp:expr``) or inline text (``cpp:texpr``). For example:: .. c:var:: int a = 42 .. c:function:: int f(int i) An expression: :c:expr:`a * f(a)` (or as text: :c:texpr:`a * f(a)`). A type: :c:expr:`const Data*` (or as text :c:texpr:`const Data*`). will be rendered as follows: .. c:var:: int a = 42 .. c:function:: int f(int i) An expression: :c:expr:`a * f(a)` (or as text: :c:texpr:`a * f(a)`). A type: :c:expr:`const Data*` (or as text :c:texpr:`const Data*`). .. versionadded:: 3.0 Namespacing ~~~~~~~~~~~ .. versionadded:: 3.1 The C language it self does not support namespacing, but it can sometimes be useful to emulate it in documentation, e.g., to show alternate declarations. The feature may also be used to document members of structs/unions/enums separate from their parent declaration. The current scope can be changed using three namespace directives. They manage a stack declarations where ``c:namespace`` resets the stack and changes a given scope. The ``c:namespace-push`` directive changes the scope to a given inner scope of the current one. The ``c:namespace-pop`` directive undoes the most recent ``c:namespace-push`` directive. .. rst:directive:: .. c:namespace:: scope specification Changes the current scope for the subsequent objects to the given scope, and resets the namespace directive stack. Note that nested scopes can be specified by separating with a dot, e.g.:: .. c:namespace:: Namespace1.Namespace2.SomeStruct.AnInnerStruct All subsequent objects will be defined as if their name were declared with the scope prepended. The subsequent cross-references will be searched for starting in the current scope. Using ``NULL`` or ``0`` as the scope will change to global scope. .. rst:directive:: .. c:namespace-push:: scope specification Change the scope relatively to the current scope. For example, after:: .. c:namespace:: A.B .. c:namespace-push:: C.D the current scope will be ``A.B.C.D``. .. rst:directive:: .. c:namespace-pop:: Undo the previous ``c:namespace-push`` directive (*not* just pop a scope). For example, after:: .. c:namespace:: A.B .. c:namespace-push:: C.D .. c:namespace-pop:: the current scope will be ``A.B`` (*not* ``A.B.C``). If no previous ``c:namespace-push`` directive has been used, but only a ``c:namespace`` directive, then the current scope will be reset to global scope. That is, ``.. c:namespace:: A.B`` is equivalent to:: .. c:namespace:: NULL .. c:namespace-push:: A.B Configuration Variables ~~~~~~~~~~~~~~~~~~~~~~~ See :ref:`c-config`. .. _cpp-domain: The C++ Domain -------------- The C++ domain (name **cpp**) supports documenting C++ projects. Directives for Declaring Entities ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The following directives are available. All declarations can start with a visibility statement (``public``, ``private`` or ``protected``). .. rst:directive:: .. cpp:class:: class specifier .. cpp:struct:: class specifier Describe a class/struct, possibly with specification of inheritance, e.g.,:: .. cpp:class:: MyClass : public MyBase, MyOtherBase The difference between :rst:dir:`cpp:class` and :rst:dir:`cpp:struct` is only cosmetic: the prefix rendered in the output, and the specifier shown in the index. The class can be directly declared inside a nested scope, e.g.,:: .. cpp:class:: OuterScope::MyClass : public MyBase, MyOtherBase A class template can be declared:: .. cpp:class:: template<typename T, std::size_t N> std::array or with a line break:: .. cpp:class:: template<typename T, std::size_t N> \ std::array Full and partial template specialisations can be declared:: .. cpp:class:: template<> \ std::array<bool, 256> .. cpp:class:: template<typename T> \ std::array<T, 42> .. versionadded:: 2.0 The :rst:dir:`cpp:struct` directive. .. rst:directive:: .. cpp:function:: (member) function prototype Describe a function or member function, e.g.,:: .. cpp:function:: bool myMethod(int arg1, std::string arg2) A function with parameters and types. .. cpp:function:: bool myMethod(int, double) A function with unnamed parameters. .. cpp:function:: const T &MyClass::operator[](std::size_t i) const An overload for the indexing operator. .. cpp:function:: operator bool() const A casting operator. .. cpp:function:: constexpr void foo(std::string &bar[2]) noexcept A constexpr function. .. cpp:function:: MyClass::MyClass(const MyClass&) = default A copy constructor with default implementation. Function templates can also be described:: .. cpp:function:: template<typename U> \ void print(U &&u) and function template specialisations:: .. cpp:function:: template<> \ void print(int i) .. rst:directive:: .. cpp:member:: (member) variable declaration .. cpp:var:: (member) variable declaration Describe a variable or member variable, e.g.,:: .. cpp:member:: std::string MyClass::myMember .. cpp:var:: std::string MyClass::myOtherMember[N][M] .. cpp:member:: int a = 42 Variable templates can also be described:: .. cpp:member:: template<class T> \ constexpr T pi = T(3.1415926535897932385) .. rst:directive:: .. cpp:type:: typedef declaration .. cpp:type:: name .. cpp:type:: type alias declaration Describe a type as in a typedef declaration, a type alias declaration, or simply the name of a type with unspecified type, e.g.,:: .. cpp:type:: std::vector<int> MyList A typedef-like declaration of a type. .. cpp:type:: MyContainer::const_iterator Declaration of a type alias with unspecified type. .. cpp:type:: MyType = std::unordered_map<int, std::string> Declaration of a type alias. A type alias can also be templated:: .. cpp:type:: template<typename T> \ MyContainer = std::vector<T> The example are rendered as follows. .. cpp:type:: std::vector<int> MyList A typedef-like declaration of a type. .. cpp:type:: MyContainer::const_iterator Declaration of a type alias with unspecified type. .. cpp:type:: MyType = std::unordered_map<int, std::string> Declaration of a type alias. .. cpp:type:: template<typename T> \ MyContainer = std::vector<T> .. rst:directive:: .. cpp:enum:: unscoped enum declaration .. cpp:enum-struct:: scoped enum declaration .. cpp:enum-class:: scoped enum declaration Describe a (scoped) enum, possibly with the underlying type specified. Any enumerators declared inside an unscoped enum will be declared both in the enum scope and in the parent scope. Examples:: .. cpp:enum:: MyEnum An unscoped enum. .. cpp:enum:: MySpecificEnum : long An unscoped enum with specified underlying type. .. cpp:enum-class:: MyScopedEnum A scoped enum. .. cpp:enum-struct:: protected MyScopedVisibilityEnum : std::underlying_type<MySpecificEnum>::type A scoped enum with non-default visibility, and with a specified underlying type. .. rst:directive:: .. cpp:enumerator:: name .. cpp:enumerator:: name = constant Describe an enumerator, optionally with its value defined, e.g.,:: .. cpp:enumerator:: MyEnum::myEnumerator .. cpp:enumerator:: MyEnum::myOtherEnumerator = 42 .. rst:directive:: .. cpp:union:: name Describe a union. .. versionadded:: 1.8 .. rst:directive:: .. cpp:concept:: template-parameter-list name .. warning:: The support for concepts is experimental. It is based on the current draft standard and the Concepts Technical Specification. The features may change as they evolve. Describe a concept. It must have exactly 1 template parameter list. The name may be a nested name. Example:: .. cpp:concept:: template<typename It> std::Iterator Proxy to an element of a notional sequence that can be compared, indirected, or incremented. **Notation** .. cpp:var:: It r An lvalue. **Valid Expressions** - :cpp:expr:`*r`, when :cpp:expr:`r` is dereferenceable. - :cpp:expr:`++r`, with return type :cpp:expr:`It&`, when :cpp:expr:`r` is incrementable. This will render as follows: .. cpp:concept:: template<typename It> std::Iterator Proxy to an element of a notional sequence that can be compared, indirected, or incremented. **Notation** .. cpp:var:: It r An lvalue. **Valid Expressions** - :cpp:expr:`*r`, when :cpp:expr:`r` is dereferenceable. - :cpp:expr:`++r`, with return type :cpp:expr:`It&`, when :cpp:expr:`r` is incrementable. .. versionadded:: 1.5 Options ^^^^^^^ Some directives support options: - ``:noindexentry:``, see :ref:`basic-domain-markup`. - ``:tparam-line-spec:``, for templated declarations. If specified, each template parameter will be rendered on a separate line. .. versionadded:: 1.6 Anonymous Entities ~~~~~~~~~~~~~~~~~~ C++ supports anonymous namespaces, classes, enums, and unions. For the sake of documentation they must be given some name that starts with ``@``, e.g., ``@42`` or ``@data``. These names can also be used in cross-references and (type) expressions, though nested symbols will be found even when omitted. The ``@...`` name will always be rendered as **[anonymous]** (possibly as a link). Example:: .. cpp:class:: Data .. cpp:union:: @data .. cpp:var:: int a .. cpp:var:: double b Explicit ref: :cpp:var:`Data::@data::a`. Short-hand ref: :cpp:var:`Data::a`. This will be rendered as: .. cpp:class:: Data .. cpp:union:: @data .. cpp:var:: int a .. cpp:var:: double b Explicit ref: :cpp:var:`Data::@data::a`. Short-hand ref: :cpp:var:`Data::a`. .. versionadded:: 1.8 Aliasing Declarations ~~~~~~~~~~~~~~~~~~~~~ Sometimes it may be helpful list declarations elsewhere than their main documentation, e.g., when creating a synopsis of a class interface. The following directive can be used for this purpose. .. rst:directive:: .. cpp:alias:: name or function signature Insert one or more alias declarations. Each entity can be specified as they can in the :rst:role:`cpp:any` role. If the name of a function is given (as opposed to the complete signature), then all overloads of the function will be listed. For example:: .. cpp:alias:: Data::a overload_example::C::f becomes .. cpp:alias:: Data::a overload_example::C::f whereas:: .. cpp:alias:: void overload_example::C::f(double d) const void overload_example::C::f(double d) becomes .. cpp:alias:: void overload_example::C::f(double d) const void overload_example::C::f(double d) .. versionadded:: 2.0 .. rubric:: Options .. rst:directive:option:: maxdepth: int Insert nested declarations as well, up to the total depth given. Use 0 for infinite depth and 1 for just the mentioned declaration. Defaults to 1. .. versionadded:: 3.5 .. rst:directive:option:: noroot Skip the mentioned declarations and only render nested declarations. Requires ``maxdepth`` either 0 or at least 2. .. versionadded:: 3.5 Constrained Templates ~~~~~~~~~~~~~~~~~~~~~ .. warning:: The support for concepts is experimental. It is based on the current draft standard and the Concepts Technical Specification. The features may change as they evolve. .. note:: Sphinx does not currently support ``requires`` clauses. Placeholders ^^^^^^^^^^^^ Declarations may use the name of a concept to introduce constrained template parameters, or the keyword ``auto`` to introduce unconstrained template parameters:: .. cpp:function:: void f(auto &&arg) A function template with a single unconstrained template parameter. .. cpp:function:: void f(std::Iterator it) A function template with a single template parameter, constrained by the Iterator concept. Template Introductions ^^^^^^^^^^^^^^^^^^^^^^ Simple constrained function or class templates can be declared with a `template introduction` instead of a template parameter list:: .. cpp:function:: std::Iterator{It} void advance(It &it) A function template with a template parameter constrained to be an Iterator. .. cpp:class:: std::LessThanComparable{T} MySortedContainer A class template with a template parameter constrained to be LessThanComparable. They are rendered as follows. .. cpp:function:: std::Iterator{It} void advance(It &it) A function template with a template parameter constrained to be an Iterator. .. cpp:class:: std::LessThanComparable{T} MySortedContainer A class template with a template parameter constrained to be LessThanComparable. Note however that no checking is performed with respect to parameter compatibility. E.g., ``Iterator{A, B, C}`` will be accepted as an introduction even though it would not be valid C++. Inline Expressions and Types ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. rst:role:: cpp:expr cpp:texpr Insert a C++ expression or type either as inline code (``cpp:expr``) or inline text (``cpp:texpr``). For example:: .. cpp:var:: int a = 42 .. cpp:function:: int f(int i) An expression: :cpp:expr:`a * f(a)` (or as text: :cpp:texpr:`a * f(a)`). A type: :cpp:expr:`const MySortedContainer<int>&` (or as text :cpp:texpr:`const MySortedContainer<int>&`). will be rendered as follows: .. cpp:var:: int a = 42 .. cpp:function:: int f(int i) An expression: :cpp:expr:`a * f(a)` (or as text: :cpp:texpr:`a * f(a)`). A type: :cpp:expr:`const MySortedContainer<int>&` (or as text :cpp:texpr:`const MySortedContainer<int>&`). .. versionadded:: 1.7 The :rst:role:`cpp:expr` role. .. versionadded:: 1.8 The :rst:role:`cpp:texpr` role. Namespacing ~~~~~~~~~~~ Declarations in the C++ domain are as default placed in global scope. The current scope can be changed using three namespace directives. They manage a stack declarations where ``cpp:namespace`` resets the stack and changes a given scope. The ``cpp:namespace-push`` directive changes the scope to a given inner scope of the current one. The ``cpp:namespace-pop`` directive undoes the most recent ``cpp:namespace-push`` directive. .. rst:directive:: .. cpp:namespace:: scope specification Changes the current scope for the subsequent objects to the given scope, and resets the namespace directive stack. Note that the namespace does not need to correspond to C++ namespaces, but can end in names of classes, e.g.,:: .. cpp:namespace:: Namespace1::Namespace2::SomeClass::AnInnerClass All subsequent objects will be defined as if their name were declared with the scope prepended. The subsequent cross-references will be searched for starting in the current scope. Using ``NULL``, ``0``, or ``nullptr`` as the scope will change to global scope. A namespace declaration can also be templated, e.g.,:: .. cpp:class:: template<typename T> \ std::vector .. cpp:namespace:: template<typename T> std::vector .. cpp:function:: std::size_t size() const declares ``size`` as a member function of the class template ``std::vector``. Equivalently this could have been declared using:: .. cpp:class:: template<typename T> \ std::vector .. cpp:function:: std::size_t size() const or:: .. cpp:class:: template<typename T> \ std::vector .. rst:directive:: .. cpp:namespace-push:: scope specification Change the scope relatively to the current scope. For example, after:: .. cpp:namespace:: A::B .. cpp:namespace-push:: C::D the current scope will be ``A::B::C::D``. .. versionadded:: 1.4 .. rst:directive:: .. cpp:namespace-pop:: Undo the previous ``cpp:namespace-push`` directive (*not* just pop a scope). For example, after:: .. cpp:namespace:: A::B .. cpp:namespace-push:: C::D .. cpp:namespace-pop:: the current scope will be ``A::B`` (*not* ``A::B::C``). If no previous ``cpp:namespace-push`` directive has been used, but only a ``cpp:namespace`` directive, then the current scope will be reset to global scope. That is, ``.. cpp:namespace:: A::B`` is equivalent to:: .. cpp:namespace:: nullptr .. cpp:namespace-push:: A::B .. versionadded:: 1.4 Info field lists ~~~~~~~~~~~~~~~~~ All the C++ directives for declaring entities support the following info fields (see also :ref:`info-field-lists`): * ``tparam``: Description of a template parameter. The :rst:dir:`cpp:function` directive additionally supports the following fields: * ``param``, ``parameter``, ``arg``, ``argument``: Description of a parameter. * ``returns``, ``return``: Description of a return value. * ``retval``, ``retvals``: An alternative to ``returns`` for describing the result of the function. * `throws`, `throw`, `exception`: Description of a possibly thrown exception. .. versionadded:: 4.3 The ``retval`` field type. .. _cpp-roles: Cross-referencing ~~~~~~~~~~~~~~~~~ These roles link to the given declaration types: .. rst:role:: cpp:any cpp:class cpp:struct cpp:func cpp:member cpp:var cpp:type cpp:concept cpp:enum cpp:enumerator Reference a C++ declaration by name (see below for details). The name must be properly qualified relative to the position of the link. .. versionadded:: 2.0 The :rst:role:`cpp:struct` role as alias for the :rst:role:`cpp:class` role. .. admonition:: Note on References with Templates Parameters/Arguments These roles follow the Sphinx :ref:`xref-syntax` rules. This means care must be taken when referencing a (partial) template specialization, e.g. if the link looks like this: ``:cpp:class:`MyClass<int>```. This is interpreted as a link to ``int`` with a title of ``MyClass``. In this case, escape the opening angle bracket with a backslash, like this: ``:cpp:class:`MyClass\<int>```. When a custom title is not needed it may be useful to use the roles for inline expressions, :rst:role:`cpp:expr` and :rst:role:`cpp:texpr`, where angle brackets do not need escaping. Declarations without template parameters and template arguments ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ For linking to non-templated declarations the name must be a nested name, e.g., ``f`` or ``MyClass::f``. Overloaded (member) functions ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ When a (member) function is referenced using just its name, the reference will point to an arbitrary matching overload. The :rst:role:`cpp:any` and :rst:role:`cpp:func` roles use an alternative format, which simply is a complete function declaration. This will resolve to the exact matching overload. As example, consider the following class declaration: .. cpp:namespace-push:: overload_example .. cpp:class:: C .. cpp:function:: void f(double d) const .. cpp:function:: void f(double d) .. cpp:function:: void f(int i) .. cpp:function:: void f() References using the :rst:role:`cpp:func` role: - Arbitrary overload: ``C::f``, :cpp:func:`C::f` - Also arbitrary overload: ``C::f()``, :cpp:func:`C::f()` - Specific overload: ``void C::f()``, :cpp:func:`void C::f()` - Specific overload: ``void C::f(int)``, :cpp:func:`void C::f(int)` - Specific overload: ``void C::f(double)``, :cpp:func:`void C::f(double)` - Specific overload: ``void C::f(double) const``, :cpp:func:`void C::f(double) const` Note that the :confval:`add_function_parentheses` configuration variable does not influence specific overload references. .. cpp:namespace-pop:: Templated declarations ^^^^^^^^^^^^^^^^^^^^^^ Assume the following declarations. .. cpp:class:: Wrapper .. cpp:class:: template<typename TOuter> \ Outer .. cpp:class:: template<typename TInner> \ Inner In general the reference must include the template parameter declarations, and template arguments for the prefix of qualified names. For example: - ``template\<typename TOuter> Wrapper::Outer`` (:cpp:class:`template\<typename TOuter> Wrapper::Outer`) - ``template\<typename TOuter> template\<typename TInner> Wrapper::Outer<TOuter>::Inner`` (:cpp:class:`template\<typename TOuter> template\<typename TInner> Wrapper::Outer<TOuter>::Inner`) Currently the lookup only succeed if the template parameter identifiers are equal strings. That is, ``template\<typename UOuter> Wrapper::Outer`` will not work. As a shorthand notation, if a template parameter list is omitted, then the lookup will assume either a primary template or a non-template, but not a partial template specialisation. This means the following references work as well: - ``Wrapper::Outer`` (:cpp:class:`Wrapper::Outer`) - ``Wrapper::Outer::Inner`` (:cpp:class:`Wrapper::Outer::Inner`) - ``template\<typename TInner> Wrapper::Outer::Inner`` (:cpp:class:`template\<typename TInner> Wrapper::Outer::Inner`) (Full) Template Specialisations ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Assume the following declarations. .. cpp:class:: template<typename TOuter> \ Outer .. cpp:class:: template<typename TInner> \ Inner .. cpp:class:: template<> \ Outer<int> .. cpp:class:: template<typename TInner> \ Inner .. cpp:class:: template<> \ Inner<bool> In general the reference must include a template parameter list for each template argument list. The full specialisation above can therefore be referenced with ``template\<> Outer\<int>`` (:cpp:class:`template\<> Outer\<int>`) and ``template\<> template\<> Outer\<int>::Inner\<bool>`` (:cpp:class:`template\<> template\<> Outer\<int>::Inner\<bool>`). As a shorthand the empty template parameter list can be omitted, e.g., ``Outer\<int>`` (:cpp:class:`Outer\<int>`) and ``Outer\<int>::Inner\<bool>`` (:cpp:class:`Outer\<int>::Inner\<bool>`). Partial Template Specialisations ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Assume the following declaration. .. cpp:class:: template<typename T> \ Outer<T*> References to partial specialisations must always include the template parameter lists, e.g., ``template\<typename T> Outer\<T*>`` (:cpp:class:`template\<typename T> Outer\<T*>`). Currently the lookup only succeed if the template parameter identifiers are equal strings. Configuration Variables ~~~~~~~~~~~~~~~~~~~~~~~ See :ref:`cpp-config`. .. _domains-std: The Standard Domain ------------------- The so-called "standard" domain collects all markup that doesn't warrant a domain of its own. Its directives and roles are not prefixed with a domain name. The standard domain is also where custom object descriptions, added using the :func:`~sphinx.application.Sphinx.add_object_type` API, are placed. There is a set of directives allowing documenting command-line programs: .. rst:directive:: .. option:: name args, name args, ... Describes a command line argument or switch. Option argument names should be enclosed in angle brackets. Examples:: .. option:: dest_dir Destination directory. .. option:: -m <module>, --module <module> Run a module as a script. The directive will create cross-reference targets for the given options, referenceable by :rst:role:`option` (in the example case, you'd use something like ``:option:`dest_dir```, ``:option:`-m```, or ``:option:`--module```). ``cmdoption`` directive is a deprecated alias for the ``option`` directive. .. rst:directive:: .. envvar:: name Describes an environment variable that the documented code or program uses or defines. Referenceable by :rst:role:`envvar`. .. rst:directive:: .. program:: name Like :rst:dir:`py:currentmodule`, this directive produces no output. Instead, it serves to notify Sphinx that all following :rst:dir:`option` directives document options for the program called *name*. If you use :rst:dir:`program`, you have to qualify the references in your :rst:role:`option` roles by the program name, so if you have the following situation :: .. program:: rm .. option:: -r Work recursively. .. program:: svn .. option:: -r <revision> Specify the revision to work upon. then ``:option:`rm -r``` would refer to the first option, while ``:option:`svn -r``` would refer to the second one. If ``None`` is passed to the argument, the directive will reset the current program name. The program name may contain spaces (in case you want to document subcommands like ``svn add`` and ``svn commit`` separately). .. versionadded:: 0.5 There is also a very generic object description directive, which is not tied to any domain: .. rst:directive:: .. describe:: text .. object:: text This directive produces the same formatting as the specific ones provided by domains, but does not create index entries or cross-referencing targets. Example:: .. describe:: PAPER You can set this variable to select a paper size. The JavaScript Domain --------------------- The JavaScript domain (name **js**) provides the following directives: .. rst:directive:: .. js:module:: name This directive sets the module name for object declarations that follow after. The module name is used in the global module index and in cross references. This directive does not create an object heading like :rst:dir:`py:class` would, for example. By default, this directive will create a linkable entity and will cause an entry in the global module index, unless the ``noindex`` option is specified. If this option is specified, the directive will only update the current module name. .. versionadded:: 1.6 .. rst:directive:: .. js:function:: name(signature) Describes a JavaScript function or method. If you want to describe arguments as optional use square brackets as :ref:`documented <signatures>` for Python signatures. You can use fields to give more details about arguments and their expected types, errors which may be thrown by the function, and the value being returned:: .. js:function:: $.getJSON(href, callback[, errback]) :param string href: An URI to the location of the resource. :param callback: Gets called with the object. :param errback: Gets called in case the request fails. And a lot of other text so we need multiple lines. :throws SomeError: For whatever reason in that case. :returns: Something. This is rendered as: .. js:function:: $.getJSON(href, callback[, errback]) :param string href: An URI to the location of the resource. :param callback: Gets called with the object. :param errback: Gets called in case the request fails. And a lot of other text so we need multiple lines. :throws SomeError: For whatever reason in that case. :returns: Something. .. rst:directive:: .. js:method:: name(signature) This directive is an alias for :rst:dir:`js:function`, however it describes a function that is implemented as a method on a class object. .. versionadded:: 1.6 .. rst:directive:: .. js:class:: name Describes a constructor that creates an object. This is basically like a function but will show up with a `class` prefix:: .. js:class:: MyAnimal(name[, age]) :param string name: The name of the animal :param number age: an optional age for the animal This is rendered as: .. js:class:: MyAnimal(name[, age]) :param string name: The name of the animal :param number age: an optional age for the animal .. rst:directive:: .. js:data:: name Describes a global variable or constant. .. rst:directive:: .. js:attribute:: object.name Describes the attribute *name* of *object*. .. _js-roles: These roles are provided to refer to the described objects: .. rst:role:: js:mod js:func js:meth js:class js:data js:attr The reStructuredText domain --------------------------- The reStructuredText domain (name **rst**) provides the following directives: .. rst:directive:: .. rst:directive:: name Describes a reST directive. The *name* can be a single directive name or actual directive syntax (`..` prefix and `::` suffix) with arguments that will be rendered differently. For example:: .. rst:directive:: foo Foo description. .. rst:directive:: .. bar:: baz Bar description. will be rendered as: .. rst:directive:: foo Foo description. .. rst:directive:: .. bar:: baz Bar description. .. rst:directive:: .. rst:directive:option:: name Describes an option for reST directive. The *name* can be a single option name or option name with arguments which separated with colon (``:``). For example:: .. rst:directive:: toctree .. rst:directive:option:: caption: caption of ToC .. rst:directive:option:: glob will be rendered as: .. rst:directive:: toctree :noindex: .. rst:directive:option:: caption: caption of ToC .. rst:directive:option:: glob .. rubric:: options .. rst:directive:option:: type: description of argument :type: text Describe the type of option value. For example:: .. rst:directive:: toctree .. rst:directive:option:: maxdepth :type: integer or no value .. versionadded:: 2.1 .. rst:directive:: .. rst:role:: name Describes a reST role. For example:: .. rst:role:: foo Foo description. will be rendered as: .. rst:role:: foo Foo description. .. _rst-roles: These roles are provided to refer to the described objects: .. rst:role:: rst:dir rst:role .. _math-domain: The Math Domain --------------- The math domain (name **math**) provides the following roles: .. rst:role:: math:numref Role for cross-referencing equations defined by :rst:dir:`math` directive via their label. Example:: .. math:: e^{i\pi} + 1 = 0 :label: euler Euler's identity, equation :math:numref:`euler`, was elected one of the most beautiful mathematical formulas. .. versionadded:: 1.8 More domains ------------ The sphinx-contrib_ repository contains more domains available as extensions; currently Ada_, CoffeeScript_, Erlang_, HTTP_, Lasso_, MATLAB_, PHP_, and Ruby_ domains. Also available are domains for `Chapel`_, `Common Lisp`_, dqn_, Go_, Jinja_, Operation_, and Scala_. .. _sphinx-contrib: https://github.com/sphinx-contrib .. _Ada: https://pypi.org/project/sphinxcontrib-adadomain/ .. _Chapel: https://pypi.org/project/sphinxcontrib-chapeldomain/ .. _CoffeeScript: https://pypi.org/project/sphinxcontrib-coffee/ .. _Common Lisp: https://pypi.org/project/sphinxcontrib-cldomain/ .. _dqn: https://pypi.org/project/sphinxcontrib-dqndomain/ .. _Erlang: https://pypi.org/project/sphinxcontrib-erlangdomain/ .. _Go: https://pypi.org/project/sphinxcontrib-golangdomain/ .. _HTTP: https://pypi.org/project/sphinxcontrib-httpdomain/ .. _Jinja: https://pypi.org/project/sphinxcontrib-jinjadomain/ .. _Lasso: https://pypi.org/project/sphinxcontrib-lassodomain/ .. _MATLAB: https://pypi.org/project/sphinxcontrib-matlabdomain/ .. _Operation: https://pypi.org/project/sphinxcontrib-operationdomain/ .. _PHP: https://pypi.org/project/sphinxcontrib-phpdomain/ .. _Ruby: https://bitbucket.org/birkenfeld/sphinx-contrib/src/default/rubydomain .. _Scala: https://pypi.org/project/sphinxcontrib-scaladomain/ ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/restructuredtext/field-lists.rst���������������������������������������������0000644�0000766�0000024�00000003657�00000000000�022630� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: rst =========== Field Lists =========== :ref:`As previously discussed <rst-field-lists>`, field lists are sequences of fields marked up like this:: :fieldname: Field content Sphinx extends standard docutils behavior for field lists and adds some extra functionality that is covered in this section. .. note:: The values of field lists will be parsed as strings. You cannot use Python collections such as lists or dictionaries. .. _metadata: File-wide metadata ------------------ A field list near the top of a file is normally parsed by docutils as the *docinfo* and shown on the page. However, in Sphinx, a field list preceding any other markup is moved from the *docinfo* to the Sphinx environment as document metadata, and is not displayed in the output. .. note:: A field list appearing after the document title *will* be part of the *docinfo* as normal and will be displayed in the output. Special metadata fields ----------------------- Sphinx provides custom behavior for bibliographic fields compared to docutils. At the moment, these metadata fields are recognized: ``tocdepth`` The maximum depth for a table of contents of this file. :: :tocdepth: 2 .. note:: This metadata effects to the depth of local toctree. But it does not effect to the depth of *global* toctree. So this would not be change the sidebar of some themes which uses global one. .. versionadded:: 0.4 ``nocomments`` If set, the web application won't display a comment form for a page generated from this source file. :: :nocomments: ``orphan`` If set, warnings about this file not being included in any toctree will be suppressed. :: :orphan: .. versionadded:: 1.0 ``nosearch`` If set, full text search for this file is disabled. :: :nosearch: .. note:: object search is still available even if `nosearch` option is set. .. versionadded:: 3.0 ���������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/restructuredtext/index.rst���������������������������������������������������0000644�0000766�0000024�00000001076�00000000000�021511� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. _rst-index: ================ reStructuredText ================ reStructuredText (reST) is the default plaintext markup language used by both Docutils and Sphinx. Docutils provides the basic reStructuredText syntax, while Sphinx extends this to support additional functionality. The below guides go through the most important aspects of reST. For the authoritative reStructuredText reference, refer to the `docutils documentation`__. __ https://docutils.sourceforge.io/rst.html .. toctree:: :maxdepth: 2 basics roles directives field-lists domains ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163739.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/restructuredtext/roles.rst���������������������������������������������������0000644�0000766�0000024�00000040121�00000000000�021520� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: rst ===== Roles ===== Sphinx uses interpreted text roles to insert semantic markup into documents. They are written as ``:rolename:`content```. .. note:: The default role (```content```) has no special meaning by default. You are free to use it for anything you like, e.g. variable names; use the :confval:`default_role` config value to set it to a known role -- the :rst:role:`any` role to find anything or the :rst:role:`py:obj` role to find Python objects are very useful for this. See :doc:`/usage/restructuredtext/domains` for roles added by domains. .. _xref-syntax: Cross-referencing syntax ------------------------ Cross-references are generated by many semantic interpreted text roles. Basically, you only need to write ``:role:`target```, and a link will be created to the item named *target* of the type indicated by *role*. The link's text will be the same as *target*. There are some additional facilities, however, that make cross-referencing roles more versatile: * You may supply an explicit title and reference target, like in reST direct hyperlinks: ``:role:`title <target>``` will refer to *target*, but the link text will be *title*. * If you prefix the content with ``!``, no reference/hyperlink will be created. * 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. This does not work with all cross-reference roles, but is domain specific. In HTML output, the link's ``title`` attribute (that is e.g. shown as a tool-tip on mouse-hover) will always be the full target name. .. _any-role: Cross-referencing anything ^^^^^^^^^^^^^^^^^^^^^^^^^^ .. rst:role:: any .. versionadded:: 1.3 This convenience role tries to do its best to find a valid target for its reference text. * First, it tries standard cross-reference targets that would be referenced by :rst:role:`doc`, :rst:role:`ref` or :rst:role:`option`. Custom objects added to the standard domain by extensions (see :meth:`.Sphinx.add_object_type`) are also searched. * Then, it looks for objects (targets) in all loaded domains. It is up to the domains how specific a match must be. For example, in the Python domain a reference of ``:any:`Builder``` would match the ``sphinx.builders.Builder`` class. If none or multiple targets are found, a warning will be emitted. In the case of multiple targets, you can change "any" to a specific role. This role is a good candidate for setting :confval:`default_role`. If you do, you can write cross-references without a lot of markup overhead. For example, in this Python function documentation :: .. function:: install() This function installs a `handler` for every signal known by the `signal` module. See the section `about-signals` for more information. there could be references to a glossary term (usually ``:term:`handler```), a Python module (usually ``:py:mod:`signal``` or ``:mod:`signal```) and a section (usually ``:ref:`about-signals```). The :rst:role:`any` role also works together with the :mod:`~sphinx.ext.intersphinx` extension: when no local cross-reference is found, all object types of intersphinx inventories are also searched. Cross-referencing objects ^^^^^^^^^^^^^^^^^^^^^^^^^ These roles are described with their respective domains: * :ref:`Python <python-roles>` * :ref:`C <c-roles>` * :ref:`C++ <cpp-roles>` * :ref:`JavaScript <js-roles>` * :ref:`ReST <rst-roles>` .. _ref-role: Cross-referencing arbitrary locations ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. rst:role:: ref To support cross-referencing to arbitrary locations in any document, the standard reST labels are used. For this to work label names must be unique throughout the entire documentation. There are two ways in which you can refer to labels: * If you place a label directly before a section title, you can reference to it with ``:ref:`label-name```. For example:: .. _my-reference-label: Section to cross-reference -------------------------- This is the text of the section. It refers to the section itself, see :ref:`my-reference-label`. The ``:ref:`` role would then generate a link to the section, with the link title being "Section to cross-reference". This works just as well when section and reference are in different source files. Automatic labels also work with figures. For example:: .. _my-figure: .. figure:: whatever Figure caption In this case, a reference ``:ref:`my-figure``` would insert a reference to the figure with link text "Figure caption". The same works for tables that are given an explicit caption using the :dudir:`table` directive. * Labels that aren't placed before a section title can still be referenced, but you must give the link an explicit title, using this syntax: ``:ref:`Link title <label-name>```. .. note:: Reference labels must start with an underscore. When referencing a label, the underscore must be omitted (see examples above). Using :rst:role:`ref` is advised over standard reStructuredText links to sections (like ```Section title`_``) because it works across files, when section headings are changed, will raise warnings if incorrect, and works for all builders that support cross-references. Cross-referencing documents ^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. versionadded:: 0.6 There is also a way to directly link to documents: .. rst:role:: doc Link to the specified document; the document name can be specified in absolute or relative fashion. For example, if the reference ``:doc:`parrot``` occurs in the document ``sketches/index``, then the link refers to ``sketches/parrot``. If the reference is ``:doc:`/people``` or ``:doc:`../people```, the link refers to ``people``. If no explicit link text is given (like usual: ``:doc:`Monty Python members </people>```), the link caption will be the title of the given document. Referencing downloadable files ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. versionadded:: 0.6 .. rst:role:: download This role lets you link to files within your source tree that are not reST documents that can be viewed, but files that can be downloaded. When you use this role, the referenced file is automatically marked for inclusion in the output when building (obviously, for HTML output only). All downloadable files are put into a ``_downloads/<unique hash>/`` subdirectory of the output directory; duplicate filenames are handled. An example:: See :download:`this example script <../example.py>`. The given filename is usually relative to the directory the current source file is contained in, but if it absolute (starting with ``/``), it is taken as relative to the top source directory. The ``example.py`` file will be copied to the output directory, and a suitable link generated to it. Not to show unavailable download links, you should wrap whole paragraphs that have this role:: .. only:: builder_html See :download:`this example script <../example.py>`. Cross-referencing figures by figure number ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. versionadded:: 1.3 .. versionchanged:: 1.5 `numref` role can also refer sections. And `numref` allows `{name}` for the link text. .. rst:role:: numref Link to the specified figures, tables, code-blocks and sections; the standard reST labels are used. When you use this role, it will insert a reference to the figure with link text by its figure number like "Fig. 1.1". If an explicit link text is given (as usual: ``:numref:`Image of Sphinx (Fig. %s) <my-figure>```), the link caption will serve as title of the reference. As placeholders, `%s` and `{number}` get replaced by the figure number and `{name}` by the figure caption. If no explicit link text is given, the :confval:`numfig_format` setting is used as fall-back default. If :confval:`numfig` is ``False``, figures are not numbered, so this role inserts not a reference but the label or the link text. Cross-referencing other items of interest ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The following roles do possibly create a cross-reference, but do not refer to objects: .. rst:role:: envvar An environment variable. Index entries are generated. Also generates a link to the matching :rst:dir:`envvar` directive, if it exists. .. rst:role:: token The name of a grammar token (used to create links between :rst:dir:`productionlist` directives). .. rst:role:: keyword The name of a keyword in Python. This creates a link to a reference label with that name, if it exists. .. rst:role:: option A command-line option to an executable program. This generates a link to a :rst:dir:`option` directive, if it exists. The following role creates a cross-reference to a term in a :ref:`glossary <glossary-directive>`: .. rst:role:: term Reference to a term in a glossary. A glossary is created using the ``glossary`` directive containing a definition list with terms and definitions. It does not have to be in the same file as the ``term`` markup, for example the Python docs have one global glossary in the ``glossary.rst`` file. If you use a term that's not explained in a glossary, you'll get a warning during build. Math ---- .. rst:role:: math Role for inline math. Use like this:: Since Pythagoras, we know that :math:`a^2 + b^2 = c^2`. .. rst:role:: eq Same as :rst:role:`math:numref`. Other semantic markup --------------------- The following roles don't do anything special except formatting the text in a different style: .. rst:role:: abbr An abbreviation. If the role content contains a parenthesized explanation, it will be treated specially: it will be shown in a tool-tip in HTML, and output only once in LaTeX. Example: ``:abbr:`LIFO (last-in, first-out)```. .. versionadded:: 0.6 .. rst:role:: command The name of an OS-level command, such as ``rm``. .. rst:role:: dfn Mark the defining instance of a term in the text. (No index entries are generated.) .. rst:role:: file The name of a file or directory. Within the contents, you can use curly braces to indicate a "variable" part, for example:: ... is installed in :file:`/usr/lib/python2.{x}/site-packages` ... In the built documentation, the ``x`` will be displayed differently to indicate that it is to be replaced by the Python minor version. .. rst:role:: guilabel Labels presented as part of an interactive user interface should be marked using ``guilabel``. This includes labels from text-based interfaces such as those created using :mod:`curses` or other text-based libraries. Any label used in the interface should be marked with this role, including button labels, window titles, field names, menu and menu selection names, and even values in selection lists. .. versionchanged:: 1.0 An accelerator key for the GUI label can be included using an ampersand; this will be stripped and displayed underlined in the output (example: ``:guilabel:`&Cancel```). To include a literal ampersand, double it. .. rst:role:: kbd Mark a sequence of keystrokes. What form the key sequence takes may depend on platform- or application-specific conventions. When there are no relevant conventions, the names of modifier keys should be spelled out, to improve accessibility for new users and non-native speakers. For example, an *xemacs* key sequence may be marked like ``:kbd:`C-x C-f```, but without reference to a specific application or platform, the same sequence should be marked as ``:kbd:`Control-x Control-f```. .. rst:role:: mailheader The name of an RFC 822-style mail header. This markup does not imply that the header is being used in an email message, but can be used to refer to any header of the same "style." This is also used for headers defined by the various MIME specifications. The header name should be entered in the same way it would normally be found in practice, with the camel-casing conventions being preferred where there is more than one common usage. For example: ``:mailheader:`Content-Type```. .. rst:role:: makevar The name of a :command:`make` variable. .. rst:role:: manpage A reference to a Unix manual page including the section, e.g. ``:manpage:`ls(1)```. Creates a hyperlink to an external site rendering the manpage if :confval:`manpages_url` is defined. .. rst:role:: menuselection Menu selections should be marked using the ``menuselection`` role. This is used to mark a complete sequence of menu selections, including selecting submenus and choosing a specific operation, or any subsequence of such a sequence. The names of individual selections should be separated by ``-->``. For example, to mark the selection "Start > Programs", use this markup:: :menuselection:`Start --> Programs` When including a selection that includes some trailing indicator, such as the ellipsis some operating systems use to indicate that the command opens a dialog, the indicator should be omitted from the selection name. ``menuselection`` also supports ampersand accelerators just like :rst:role:`guilabel`. .. rst:role:: mimetype The name of a MIME type, or a component of a MIME type (the major or minor portion, taken alone). .. rst:role:: newsgroup The name of a Usenet newsgroup. .. todo:: Is this not part of the standard domain? .. rst:role:: program The name of an executable program. This may differ from the file name for the executable for some platforms. In particular, the ``.exe`` (or other) extension should be omitted for Windows programs. .. rst:role:: regexp A regular expression. Quotes should not be included. .. rst:role:: samp A piece of literal text, such as code. Within the contents, you can use curly braces to indicate a "variable" part, as in :rst:role:`file`. For example, in ``:samp:`print 1+{variable}```, the part ``variable`` would be emphasized. If you don't need the "variable part" indication, use the standard ````code```` instead. .. versionchanged:: 1.8 Allowed to escape curly braces with backslash There is also an :rst:role:`index` role to generate index entries. The following roles generate external links: .. rst:role:: pep A reference to a Python Enhancement Proposal. This generates appropriate index entries. The text "PEP *number*\ " is generated; in the HTML output, this text is a hyperlink to an online copy of the specified PEP. You can link to a specific section by saying ``:pep:`number#anchor```. .. rst:role:: rfc A reference to an Internet Request for Comments. This generates appropriate index entries. The text "RFC *number*\ " is generated; in the HTML output, this text is a hyperlink to an online copy of the specified RFC. You can link to a specific section by saying ``:rfc:`number#anchor```. Note that there are no special roles for including hyperlinks as you can use the standard reST markup for that purpose. .. _default-substitutions: Substitutions ------------- The documentation system provides three substitutions that are defined by default. They are set in the build configuration file. .. describe:: |release| Replaced by the project release the documentation refers to. This is meant to be the full version string including alpha/beta/release candidate tags, e.g. ``2.5.2b3``. Set by :confval:`release`. .. describe:: |version| Replaced by the project version the documentation refers to. This is meant to consist only of the major and minor version parts, e.g. ``2.5``, even for version 2.5.1. Set by :confval:`version`. .. describe:: |today| Replaced by either today's date (the date on which the document is read), or the date set in the build configuration file. Normally has the format ``April 14, 2007``. Set by :confval:`today_fmt` and :confval:`today`. �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/doc/usage/theming.rst������������������������������������������������������������������0000644�0000766�0000024�00000033354�00000000000�016401� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������.. highlight:: python .. _html-themes: HTML Theming ============ Sphinx provides a number of builders for HTML and HTML-based formats. Builders -------- .. todo:: Populate when the 'builders' document is split up. Themes ------ .. versionadded:: 0.6 .. note:: This section provides information about using pre-existing HTML themes. If you wish to create your own theme, refer to :doc:`/development/theming`. Sphinx supports changing the appearance of its HTML output via *themes*. A theme is a collection of HTML templates, stylesheet(s) and other static files. Additionally, it has a configuration file which specifies from which theme to inherit, which highlighting style to use, and what options exist for customizing the theme's look and feel. Themes are meant to be project-unaware, so they can be used for different projects without change. Using a theme ~~~~~~~~~~~~~ Using a :ref:`theme provided with Sphinx <builtin-themes>` is easy. Since these do not need to be installed, you only need to set the :confval:`html_theme` config value. For example, to enable the ``classic`` theme, add the following to :file:`conf.py`:: html_theme = "classic" You can also set theme-specific options using the :confval:`html_theme_options` config value. These options are generally used to change the look and feel of the theme. For example, to place the sidebar on the right side and a black background for the relation bar (the bar with the navigation links at the page's top and bottom), add the following :file:`conf.py`:: html_theme_options = { "rightsidebar": "true", "relbarbgcolor": "black" } If the theme does not come with Sphinx, it can be in two static forms or as a Python package. For the static forms, either a directory (containing :file:`theme.conf` and other needed files), or a zip file with the same contents is supported. The directory or zipfile must be put where Sphinx can find it; for this there is the config value :confval:`html_theme_path`. This can be a list of directories, relative to the directory containing :file:`conf.py`, that can contain theme directories or zip files. For example, if you have a theme in the file :file:`blue.zip`, you can put it right in the directory containing :file:`conf.py` and use this configuration:: html_theme = "blue" html_theme_path = ["."] The third form is a Python package. If a theme you want to use is distributed as a Python package, you can use it after installing .. code-block:: bash # installing theme package $ pip install sphinxjp.themes.dotted Once installed, this can be used in the same manner as a directory or zipfile-based theme:: html_theme = "dotted" For more information on the design of themes, including information about writing your own themes, refer to :doc:`/development/theming`. .. _builtin-themes: Builtin themes ~~~~~~~~~~~~~~ .. cssclass:: longtable +--------------------+--------------------+ | **Theme overview** | | +--------------------+--------------------+ | |alabaster| | |classic| | | | | | *alabaster* | *classic* | +--------------------+--------------------+ | |sphinxdoc| | |scrolls| | | | | | *sphinxdoc* | *scrolls* | +--------------------+--------------------+ | |agogo| | |traditional| | | | | | *agogo* | *traditional* | +--------------------+--------------------+ | |nature| | |haiku| | | | | | *nature* | *haiku* | +--------------------+--------------------+ | |pyramid| | |bizstyle| | | | | | *pyramid* | *bizstyle* | +--------------------+--------------------+ .. |alabaster| image:: /_static/themes/alabaster.png .. |classic| image:: /_static/themes/classic.png .. |sphinxdoc| image:: /_static/themes/sphinxdoc.png .. |scrolls| image:: /_static/themes/scrolls.png .. |agogo| image:: /_static/themes/agogo.png .. |traditional| image:: /_static/themes/traditional.png .. |nature| image:: /_static/themes/nature.png .. |haiku| image:: /_static/themes/haiku.png .. |pyramid| image:: /_static/themes/pyramid.png .. |bizstyle| image:: /_static/themes/bizstyle.png Sphinx comes with a selection of themes to choose from. Note that from these themes only the Alabaster and Scrolls themes are mobile-optimated, the other themes resort to horizontal scrolling if the screen is too narrow. .. cssclass:: clear These themes are: **basic** This is a basically unstyled layout used as the base for the other themes, and usable as the base for custom themes as well. The HTML contains all important elements like sidebar and relation bar. There are these options (which are inherited by the other themes): - **nosidebar** (true or false): Don't include the sidebar. Defaults to ``False``. - **sidebarwidth** (int or str): Width of the sidebar in pixels. This can be an int, which is interpreted as pixels or a valid CSS dimension string such as '70em' or '50%'. Defaults to 230 pixels. - **body_min_width** (int or str): Minimal width of the document body. This can be an int, which is interpreted as pixels or a valid CSS dimension string such as '70em' or '50%'. Use 0 if you don't want a width limit. Defaults may depend on the theme (often 450px). - **body_max_width** (int or str): Maximal width of the document body. This can be an int, which is interpreted as pixels or a valid CSS dimension string such as '70em' or '50%'. Use 'none' if you don't want a width limit. Defaults may depend on the theme (often 800px). - **navigation_with_keys** (true or false): Allow navigating to the previous/next page using the keyboard's left and right arrows. Defaults to ``False``. - **globaltoc_collapse** (true or false): Only expand subsections of the current document in ``globaltoc.html`` (see :confval:`html_sidebars`). Defaults to ``True``. .. versionadded:: 3.1 - **globaltoc_includehidden** (true or false): Show even those subsections in ``globaltoc.html`` (see :confval:`html_sidebars`) which have been included with the ``:hidden:`` flag of the :rst:dir:`toctree` directive. Defaults to ``False``. .. versionadded:: 3.1 - **globaltoc_maxdepth** (int): The maximum depth of the toctree in ``globaltoc.html`` (see :confval:`html_sidebars`). Set it to -1 to allow unlimited depth. Defaults to the max depth selected in the toctree directive. .. versionadded:: 3.2 **alabaster** `Alabaster theme`_ is a modified "Kr" Sphinx theme from @kennethreitz (especially as used in his Requests project), which was itself originally based on @mitsuhiko's theme used for Flask & related projects. Refer to its `installation page`_ for information on how to configure :confval:`html_sidebars` for its use. .. _Alabaster theme: https://pypi.org/project/alabaster/ .. _installation page: https://alabaster.readthedocs.io/en/latest/installation.html **classic** This is the classic theme, which looks like `the Python 2 documentation <https://docs.python.org/2/>`_. It can be customized via these options: - **rightsidebar** (true or false): Put the sidebar on the right side. Defaults to ``False``. - **stickysidebar** (true or false): Make the sidebar "fixed" so that it doesn't scroll out of view for long body content. This may not work well with all browsers. Defaults to ``False``. - **collapsiblesidebar** (true or false): Add an *experimental* JavaScript snippet that makes the sidebar collapsible via a button on its side. Defaults to ``False``. - **externalrefs** (true or false): Display external links differently from internal links. Defaults to ``False``. There are also various color and font options that can change the color scheme without having to write a custom stylesheet: - **footerbgcolor** (CSS color): Background color for the footer line. - **footertextcolor** (CSS color): Text color for the footer line. - **sidebarbgcolor** (CSS color): Background color for the sidebar. - **sidebarbtncolor** (CSS color): Background color for the sidebar collapse button (used when *collapsiblesidebar* is ``True``). - **sidebartextcolor** (CSS color): Text color for the sidebar. - **sidebarlinkcolor** (CSS color): Link color for the sidebar. - **relbarbgcolor** (CSS color): Background color for the relation bar. - **relbartextcolor** (CSS color): Text color for the relation bar. - **relbarlinkcolor** (CSS color): Link color for the relation bar. - **bgcolor** (CSS color): Body background color. - **textcolor** (CSS color): Body text color. - **linkcolor** (CSS color): Body link color. - **visitedlinkcolor** (CSS color): Body color for visited links. - **headbgcolor** (CSS color): Background color for headings. - **headtextcolor** (CSS color): Text color for headings. - **headlinkcolor** (CSS color): Link color for headings. - **codebgcolor** (CSS color): Background color for code blocks. - **codetextcolor** (CSS color): Default text color for code blocks, if not set differently by the highlighting style. - **bodyfont** (CSS font-family): Font for normal text. - **headfont** (CSS font-family): Font for headings. **sphinxdoc** The theme originally used by this documentation. It features a sidebar on the right side. There are currently no options beyond *nosidebar* and *sidebarwidth*. .. note:: The Sphinx documentation now uses `an adjusted version of the sphinxdoc theme <https://github.com/sphinx-doc/sphinx/tree/master/doc/_themes/sphinx13>`_. **scrolls** A more lightweight theme, based on `the Jinja documentation <https://jinja.palletsprojects.com/>`_. The following color options are available: - **headerbordercolor** - **subheadlinecolor** - **linkcolor** - **visitedlinkcolor** - **admonitioncolor** **agogo** A theme created by Andi Albrecht. The following options are supported: - **bodyfont** (CSS font family): Font for normal text. - **headerfont** (CSS font family): Font for headings. - **pagewidth** (CSS length): Width of the page content, default 70em. - **documentwidth** (CSS length): Width of the document (without sidebar), default 50em. - **sidebarwidth** (CSS length): Width of the sidebar, default 20em. - **rightsidebar** (true or false): Put the sidebar on the right side. Defaults to ``True``. - **bgcolor** (CSS color): Background color. - **headerbg** (CSS value for "background"): background for the header area, default a grayish gradient. - **footerbg** (CSS value for "background"): background for the footer area, default a light gray gradient. - **linkcolor** (CSS color): Body link color. - **headercolor1**, **headercolor2** (CSS color): colors for <h1> and <h2> headings. - **headerlinkcolor** (CSS color): Color for the backreference link in headings. - **textalign** (CSS *text-align* value): Text alignment for the body, default is ``justify``. **nature** A greenish theme. There are currently no options beyond *nosidebar* and *sidebarwidth*. **pyramid** A theme from the Pyramid web framework project, designed by Blaise Laflamme. There are currently no options beyond *nosidebar* and *sidebarwidth*. **haiku** A theme without sidebar inspired by the `Haiku OS user guide <https://www.haiku-os.org/docs/userguide/en/contents.html>`_. The following options are supported: - **full_logo** (true or false, default ``False``): If this is true, the header will only show the :confval:`html_logo`. Use this for large logos. If this is false, the logo (if present) will be shown floating right, and the documentation title will be put in the header. - **textcolor**, **headingcolor**, **linkcolor**, **visitedlinkcolor**, **hoverlinkcolor** (CSS colors): Colors for various body elements. **traditional** A theme resembling the old Python documentation. There are currently no options beyond *nosidebar* and *sidebarwidth*. **epub** A theme for the epub builder. This theme tries to save visual space which is a sparse resource on ebook readers. The following options are supported: - **relbar1** (true or false, default ``True``): If this is true, the `relbar1` block is inserted in the epub output, otherwise it is omitted. - **footer** (true or false, default ``True``): If this is true, the `footer` block is inserted in the epub output, otherwise it is omitted. **bizstyle** A simple bluish theme. The following options are supported beyond *nosidebar* and *sidebarwidth*: - **rightsidebar** (true or false): Put the sidebar on the right side. Defaults to ``False``. .. versionadded:: 1.3 'alabaster', 'sphinx_rtd_theme' and 'bizstyle' theme. .. versionchanged:: 1.3 The 'default' theme has been renamed to 'classic'. 'default' is still available, however it will emit a notice that it is an alias for the new 'alabaster' theme. Third Party Themes ~~~~~~~~~~~~~~~~~~ There are many third-party themes available for Sphinx. Some of these are for general use, while others are specific to an individual project. sphinx-themes.org__ is a gallery that showcases various themes for Sphinx, with demo documentation rendered under each theme. Themes can also be found on PyPI__ (using the classifier ``Framework :: Sphinx :: Theme``), GitHub__ and GitLab__. .. __: https://sphinx-themes.org/ .. __: https://pypi.org/search/?q=&o=&c=Framework+%3A%3A+Sphinx+%3A%3A+Theme .. __: https://github.com/search?utf8=%E2%9C%93&q=sphinx+theme .. __: https://gitlab.com/explore?name=sphinx+theme ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.9690616 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/setup.cfg������������������������������������������������������������������������������0000644�0000766�0000024�00000002756�00000000000�014166� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������[metadata] license_file = LICENSE [egg_info] tag_build = tag_date = 0 [aliases] release = egg_info -Db '' upload = upload --sign --identity=36580288 [build_sphinx] warning-is-error = 1 [extract_messages] mapping_file = babel.cfg output_file = sphinx/locale/sphinx.pot keywords = _ __ l_ lazy_gettext [update_catalog] input_file = sphinx/locale/sphinx.pot domain = sphinx output_dir = sphinx/locale/ [compile_catalog] domain = sphinx directory = sphinx/locale/ [flake8] max-line-length = 95 ignore = E116,E241,E251,E741,W504,I101 exclude = .git,.tox,.venv,tests/roots/*,build/*,doc/_build/*,sphinx/search/*,doc/usage/extensions/example*.py application-import-names = sphinx import-order-style = smarkets per-file-ignores = tests/*: E501 [flake8:local-plugins] extension = X101 = utils.checks:sphinx_has_header paths = . [isort] line_length = 95 [mypy] python_version = 3.6 disallow_incomplete_defs = True show_column_numbers = True show_error_context = True ignore_missing_imports = True follow_imports = skip check_untyped_defs = True warn_unused_ignores = True strict_optional = False [tool:pytest] filterwarnings = all ignore::DeprecationWarning:docutils.io ignore::DeprecationWarning:pyximport.pyximport ignore::ImportWarning:importlib._bootstrap markers = apidoc setup_command testpaths = tests [coverage:run] branch = True parallel = True source = sphinx [coverage:report] exclude_lines = pragma: no cover raise NotImplementedError if __name__ == .__main__.: ignore_errors = True ������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902837.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/setup.py�������������������������������������������������������������������������������0000644�0000766�0000024�00000020611�00000000000�014045� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������import os import sys from distutils import log from io import StringIO from setuptools import find_packages, setup import sphinx with open('README.rst') as f: long_desc = f.read() if sys.version_info < (3, 6): print('ERROR: Sphinx requires at least Python 3.6 to run.') sys.exit(1) install_requires = [ 'sphinxcontrib-applehelp', 'sphinxcontrib-devhelp', 'sphinxcontrib-jsmath', 'sphinxcontrib-htmlhelp>=2.0.0', 'sphinxcontrib-serializinghtml>=1.1.5', 'sphinxcontrib-qthelp', 'Jinja2>=2.3', 'Pygments>=2.0', 'docutils>=0.14,<0.18', 'snowballstemmer>=1.1', 'babel>=1.3', 'alabaster>=0.7,<0.8', 'imagesize', 'requests>=2.5.0', 'setuptools', 'packaging', ] extras_require = { # Environment Marker works for wheel 0.24 or later ':sys_platform=="win32"': [ 'colorama>=0.3.5', ], 'docs': [ 'sphinxcontrib-websupport', ], 'lint': [ 'flake8>=3.5.0', 'isort', 'mypy>=0.920', 'docutils-stubs', "types-typed-ast", "types-pkg_resources", "types-requests", ], 'test': [ 'pytest', 'pytest-cov', 'html5lib', "typed_ast; python_version < '3.8'", 'cython', ], } # Provide a "compile_catalog" command that also creates the translated # JavaScript files if Babel is available. cmdclass = {} class Tee: def __init__(self, stream): self.stream = stream self.buffer = StringIO() def write(self, s): self.stream.write(s) self.buffer.write(s) def flush(self): self.stream.flush() try: from json import dump from babel.messages.frontend import compile_catalog from babel.messages.pofile import read_po except ImportError: pass else: class compile_catalog_plusjs(compile_catalog): """ An extended command that writes all message strings that occur in JavaScript files to a JavaScript file along with the .mo file. Unfortunately, babel's setup command isn't built very extensible, so most of the run() code is duplicated here. """ def run(self): try: sys.stderr = Tee(sys.stderr) compile_catalog.run(self) finally: if sys.stderr.buffer.getvalue(): print("Compiling failed.") sys.exit(1) if isinstance(self.domain, list): for domain in self.domain: self._run_domain_js(domain) else: self._run_domain_js(self.domain) def _run_domain_js(self, domain): po_files = [] js_files = [] if not self.input_file: if self.locale: po_files.append((self.locale, os.path.join(self.directory, self.locale, 'LC_MESSAGES', domain + '.po'))) js_files.append(os.path.join(self.directory, self.locale, 'LC_MESSAGES', domain + '.js')) else: for locale in os.listdir(self.directory): po_file = os.path.join(self.directory, locale, 'LC_MESSAGES', domain + '.po') if os.path.exists(po_file): po_files.append((locale, po_file)) js_files.append(os.path.join(self.directory, locale, 'LC_MESSAGES', domain + '.js')) else: po_files.append((self.locale, self.input_file)) if self.output_file: js_files.append(self.output_file) else: js_files.append(os.path.join(self.directory, self.locale, 'LC_MESSAGES', domain + '.js')) for js_file, (locale, po_file) in zip(js_files, po_files): with open(po_file, encoding='utf8') as infile: catalog = read_po(infile, locale) if catalog.fuzzy and not self.use_fuzzy: continue log.info('writing JavaScript strings in catalog %r to %r', po_file, js_file) jscatalog = {} for message in catalog: if any(x[0].endswith(('.js', '.js_t', '.html')) for x in message.locations): msgid = message.id if isinstance(msgid, (list, tuple)): msgid = msgid[0] jscatalog[msgid] = message.string with open(js_file, 'wt', encoding='utf8') as outfile: outfile.write('Documentation.addTranslations(') dump({ 'messages': jscatalog, 'plural_expr': catalog.plural_expr, 'locale': str(catalog.locale) }, outfile, sort_keys=True, indent=4) outfile.write(');') cmdclass['compile_catalog'] = compile_catalog_plusjs setup( name='Sphinx', version=sphinx.__version__, url='https://www.sphinx-doc.org/', download_url='https://pypi.org/project/Sphinx/', license='BSD', author='Georg Brandl', author_email='georg@python.org', description='Python documentation generator', long_description=long_desc, long_description_content_type='text/x-rst', project_urls={ "Code": "https://github.com/sphinx-doc/sphinx", "Issue tracker": "https://github.com/sphinx-doc/sphinx/issues", }, zip_safe=False, classifiers=[ 'Development Status :: 5 - Production/Stable', 'Environment :: Console', 'Environment :: Web Environment', 'Intended Audience :: Developers', 'Intended Audience :: Education', 'Intended Audience :: End Users/Desktop', 'Intended Audience :: Science/Research', 'Intended Audience :: System Administrators', 'License :: OSI Approved :: BSD License', 'Operating System :: OS Independent', 'Programming Language :: Python', 'Programming Language :: Python :: 3', 'Programming Language :: Python :: 3 :: Only', 'Programming Language :: Python :: 3.6', 'Programming Language :: Python :: 3.7', 'Programming Language :: Python :: 3.8', 'Programming Language :: Python :: 3.9', 'Programming Language :: Python :: 3.10', 'Programming Language :: Python :: Implementation :: CPython', 'Programming Language :: Python :: Implementation :: PyPy', 'Framework :: Setuptools Plugin', 'Framework :: Sphinx', 'Framework :: Sphinx :: Extension', 'Framework :: Sphinx :: Theme', 'Topic :: Documentation', 'Topic :: Documentation :: Sphinx', 'Topic :: Internet :: WWW/HTTP :: Site Management', 'Topic :: Printing', 'Topic :: Software Development', 'Topic :: Software Development :: Documentation', 'Topic :: Text Processing', 'Topic :: Text Processing :: General', 'Topic :: Text Processing :: Indexing', 'Topic :: Text Processing :: Markup', 'Topic :: Text Processing :: Markup :: HTML', 'Topic :: Text Processing :: Markup :: LaTeX', 'Topic :: Utilities', ], platforms='any', packages=find_packages(exclude=['tests', 'utils']), package_data = { 'sphinx': ['py.typed'], }, include_package_data=True, entry_points={ 'console_scripts': [ 'sphinx-build = sphinx.cmd.build:main', 'sphinx-quickstart = sphinx.cmd.quickstart:main', 'sphinx-apidoc = sphinx.ext.apidoc:main', 'sphinx-autogen = sphinx.ext.autosummary.generate:main', ], 'distutils.commands': [ 'build_sphinx = sphinx.setup_command:BuildDoc', ], }, python_requires=">=3.6", install_requires=install_requires, extras_require=extras_require, cmdclass=cmdclass, ) �����������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000032�00000000000�010210� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������26 mtime=1639903107.44459 ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/��������������������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�013644� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639903081.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/__init__.py���������������������������������������������������������������������0000644�0000766�0000024�00000004157�00000000000�015764� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" Sphinx ~~~~~~ The Sphinx documentation toolchain. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ # Keep this file executable as-is in Python 3! # (Otherwise getting the version out of it from setup.py is impossible.) import os import subprocess import warnings from os import path from subprocess import PIPE from .deprecation import RemovedInNextVersionWarning # by default, all DeprecationWarning under sphinx package will be emit. # Users can avoid this by using environment variable: PYTHONWARNINGS= if 'PYTHONWARNINGS' not in os.environ: warnings.filterwarnings('default', category=RemovedInNextVersionWarning) # docutils.io using mode='rU' for open warnings.filterwarnings('ignore', "'U' mode is deprecated", DeprecationWarning, module='docutils.io') __version__ = '4.3.2' __released__ = '4.3.2' # used when Sphinx builds its own docs #: Version info for better programmatic use. #: #: A tuple of five elements; for Sphinx version 1.2.1 beta 3 this would be #: ``(1, 2, 1, 'beta', 3)``. The fourth element can be one of: ``alpha``, #: ``beta``, ``rc``, ``final``. ``final`` always has 0 as the last element. #: #: .. versionadded:: 1.2 #: Before version 1.2, check the string ``sphinx.__version__``. version_info = (4, 3, 2, 'final', 0) package_dir = path.abspath(path.dirname(__file__)) __display_version__ = __version__ # used for command line version if __version__.endswith('+'): # try to find out the commit hash if checked out from git, and append # it to __version__ (since we use this value from setup.py, it gets # automatically propagated to an installed copy as well) __display_version__ = __version__ __version__ = __version__[:-1] # remove '+' for PEP-440 version spec. try: ret = subprocess.run(['git', 'show', '-s', '--pretty=format:%h'], cwd=package_dir, stdout=PIPE, stderr=PIPE, encoding='ascii') if ret.stdout: __display_version__ += '/' + ret.stdout.strip() except Exception: pass �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/__main__.py���������������������������������������������������������������������0000644�0000766�0000024�00000000430�00000000000�015733� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.__main__ ~~~~~~~~~~~~~~~ The Sphinx documentation toolchain. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import sys from sphinx.cmd.build import main sys.exit(main(sys.argv[1:])) ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/addnodes.py���������������������������������������������������������������������0000644�0000766�0000024�00000042570�00000000000�016007� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.addnodes ~~~~~~~~~~~~~~~ Additional docutils nodes. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import TYPE_CHECKING, Any, Dict, List, Sequence from docutils import nodes from docutils.nodes import Element if TYPE_CHECKING: from sphinx.application import Sphinx class document(nodes.document): """The document root element patched by Sphinx. This fixes that document.set_id() does not support a node having multiple node Ids. see https://sourceforge.net/p/docutils/patches/167/ .. important:: This is only for Sphinx internal use. Please don't use this in your extensions. It will be removed without deprecation period. """ def set_id(self, node: Element, msgnode: Element = None, suggested_prefix: str = '') -> str: from sphinx.util import docutils if docutils.__version_info__ >= (0, 16): ret = super().set_id(node, msgnode, suggested_prefix) # type: ignore else: ret = super().set_id(node, msgnode) if docutils.__version_info__ < (0, 17): # register other node IDs forcedly for node_id in node['ids']: if node_id not in self.ids: self.ids[node_id] = node return ret class translatable(nodes.Node): """Node which supports translation. The translation goes forward with following steps: 1. Preserve original translatable messages 2. Apply translated messages from message catalog 3. Extract preserved messages (for gettext builder) The translatable nodes MUST preserve original messages. And these messages should not be overridden at applying step. Because they are used at final step; extraction. """ def preserve_original_messages(self) -> None: """Preserve original translatable messages.""" raise NotImplementedError def apply_translated_message(self, original_message: str, translated_message: str) -> None: """Apply translated message.""" raise NotImplementedError def extract_original_messages(self) -> Sequence[str]: """Extract translation messages. :returns: list of extracted messages or messages generator """ raise NotImplementedError class not_smartquotable: """A node which does not support smart-quotes.""" support_smartquotes = False class toctree(nodes.General, nodes.Element, translatable): """Node for inserting a "TOC tree".""" def preserve_original_messages(self) -> None: # toctree entries rawentries = self.setdefault('rawentries', []) for title, docname in self['entries']: if title: rawentries.append(title) # :caption: option if self.get('caption'): self['rawcaption'] = self['caption'] def apply_translated_message(self, original_message: str, translated_message: str) -> None: # toctree entries for i, (title, docname) in enumerate(self['entries']): if title == original_message: self['entries'][i] = (translated_message, docname) # :caption: option if self.get('rawcaption') == original_message: self['caption'] = translated_message def extract_original_messages(self) -> List[str]: messages: List[str] = [] # toctree entries messages.extend(self.get('rawentries', [])) # :caption: option if 'rawcaption' in self: messages.append(self['rawcaption']) return messages ############################################################# # Domain-specific object descriptions (class, function etc.) ############################################################# class _desc_classes_injector(nodes.Element, not_smartquotable): """Helper base class for injecting a fixes list of classes. Use as the first base class. """ classes: List[str] = [] def __init__(self, *args: Any, **kwargs: Any) -> None: super().__init__(*args, **kwargs) self['classes'].extend(self.classes) # Top-level nodes ################# class desc(nodes.Admonition, nodes.Element): """Node for a list of object signatures and a common description of them. Contains one or more :py:class:`desc_signature` nodes and then a single :py:class:`desc_content` node. This node always has two classes: - The name of the domain it belongs to, e.g., ``py`` or ``cpp``. - The name of the object type in the domain, e.g., ``function``. """ # TODO: can we introduce a constructor # that forces the specification of the domain and objtyp? class desc_signature(_desc_classes_injector, nodes.Part, nodes.Inline, nodes.TextElement): """Node for a single object signature. As default the signature is a single-line signature. Set ``is_multiline = True`` to describe a multi-line signature. In that case all child nodes must be :py:class:`desc_signature_line` nodes. This node always has the classes ``sig``, ``sig-object``, and the domain it belongs to. """ # Note: the domain name is being added through a post-transform DescSigAddDomainAsClass classes = ['sig', 'sig-object'] @property def child_text_separator(self): if self.get('is_multiline'): return ' ' else: return super().child_text_separator class desc_signature_line(nodes.Part, nodes.Inline, nodes.FixedTextElement): """Node for a line in a multi-line object signature. It should only be used as a child of a :py:class:`desc_signature` with ``is_multiline`` set to ``True``. Set ``add_permalink = True`` for the line that should get the permalink. """ sphinx_line_type = '' class desc_content(nodes.General, nodes.Element): """Node for object description content. Must be the last child node in a :py:class:`desc` node. """ class desc_inline(_desc_classes_injector, nodes.Inline, nodes.TextElement): """Node for a signature fragment in inline text. This is for example used for roles like :rst:role:`cpp:expr`. This node always has the classes ``sig``, ``sig-inline``, and the name of the domain it belongs to. """ classes = ['sig', 'sig-inline'] def __init__(self, domain: str, *args: Any, **kwargs: Any) -> None: super().__init__(*args, **kwargs) self['classes'].append(domain) # Nodes for high-level structure in signatures ############################################## # nodes to use within a desc_signature or desc_signature_line class desc_name(_desc_classes_injector, nodes.Part, nodes.Inline, nodes.FixedTextElement): """Node for the main object name. For example, in the declaration of a Python class ``MyModule.MyClass``, the main name is ``MyClass``. This node always has the class ``sig-name``. """ classes = ['sig-name', 'descname'] # 'descname' is for backwards compatibility class desc_addname(_desc_classes_injector, nodes.Part, nodes.Inline, nodes.FixedTextElement): """Node for additional name parts for an object. For example, in the declaration of a Python class ``MyModule.MyClass``, the additional name part is ``MyModule.``. This node always has the class ``sig-prename``. """ # 'descclassname' is for backwards compatibility classes = ['sig-prename', 'descclassname'] # compatibility alias desc_classname = desc_addname class desc_type(nodes.Part, nodes.Inline, nodes.FixedTextElement): """Node for return types or object type names.""" class desc_returns(desc_type): """Node for a "returns" annotation (a la -> in Python).""" def astext(self) -> str: return ' -> ' + super().astext() class desc_parameterlist(nodes.Part, nodes.Inline, nodes.FixedTextElement): """Node for a general parameter list.""" child_text_separator = ', ' def astext(self): return '({})'.format(super().astext()) class desc_parameter(nodes.Part, nodes.Inline, nodes.FixedTextElement): """Node for a single parameter.""" class desc_optional(nodes.Part, nodes.Inline, nodes.FixedTextElement): """Node for marking optional parts of the parameter list.""" child_text_separator = ', ' def astext(self) -> str: return '[' + super().astext() + ']' class desc_annotation(nodes.Part, nodes.Inline, nodes.FixedTextElement): """Node for signature annotations (not Python 3-style annotations).""" # Leaf nodes for markup of text fragments ######################################### # Signature text elements, generally translated to node.inline # in SigElementFallbackTransform. # When adding a new one, add it to SIG_ELEMENTS. class desc_sig_element(nodes.inline, _desc_classes_injector): """Common parent class of nodes for inline text of a signature.""" classes: List[str] = [] def __init__(self, rawsource: str = '', text: str = '', *children: Element, **attributes: Any) -> None: super().__init__(rawsource, text, *children, **attributes) self['classes'].extend(self.classes) # to not reinvent the wheel, the classes in the following desc_sig classes # are based on those used in Pygments class desc_sig_space(desc_sig_element): """Node for a space in a signature.""" classes = ["w"] def __init__(self, rawsource: str = '', text: str = ' ', *children: Element, **attributes: Any) -> None: super().__init__(rawsource, text, *children, **attributes) class desc_sig_name(desc_sig_element): """Node for an identifier in a signature.""" classes = ["n"] class desc_sig_operator(desc_sig_element): """Node for an operator in a signature.""" classes = ["o"] class desc_sig_punctuation(desc_sig_element): """Node for punctuation in a signature.""" classes = ["p"] class desc_sig_keyword(desc_sig_element): """Node for a general keyword in a signature.""" classes = ["k"] class desc_sig_keyword_type(desc_sig_element): """Node for a keyword which is a built-in type in a signature.""" classes = ["kt"] class desc_sig_literal_number(desc_sig_element): """Node for a numeric literal in a signature.""" classes = ["m"] class desc_sig_literal_string(desc_sig_element): """Node for a string literal in a signature.""" classes = ["s"] class desc_sig_literal_char(desc_sig_element): """Node for a character literal in a signature.""" classes = ["sc"] SIG_ELEMENTS = [desc_sig_space, desc_sig_name, desc_sig_operator, desc_sig_punctuation, desc_sig_keyword, desc_sig_keyword_type, desc_sig_literal_number, desc_sig_literal_string, desc_sig_literal_char] ############################################################### # new admonition-like constructs class versionmodified(nodes.Admonition, nodes.TextElement): """Node for version change entries. Currently used for "versionadded", "versionchanged" and "deprecated" directives. """ class seealso(nodes.Admonition, nodes.Element): """Custom "see also" admonition.""" class productionlist(nodes.Admonition, nodes.Element): """Node for grammar production lists. Contains ``production`` nodes. """ class production(nodes.Part, nodes.Inline, nodes.FixedTextElement): """Node for a single grammar production rule.""" # other directive-level nodes class index(nodes.Invisible, nodes.Inline, nodes.TextElement): """Node for index entries. This node is created by the ``index`` directive and has one attribute, ``entries``. Its value is a list of 5-tuples of ``(entrytype, entryname, target, ignored, key)``. *entrytype* is one of "single", "pair", "double", "triple". *key* is categorization characters (usually a single character) for general index page. For the details of this, please see also: :rst:dir:`glossary` and issue #2320. """ class centered(nodes.Part, nodes.TextElement): """Deprecated.""" class acks(nodes.Element): """Special node for "acks" lists.""" class hlist(nodes.Element): """Node for "horizontal lists", i.e. lists that should be compressed to take up less vertical space. """ class hlistcol(nodes.Element): """Node for one column in a horizontal list.""" class compact_paragraph(nodes.paragraph): """Node for a compact paragraph (which never makes a <p> node).""" class glossary(nodes.Element): """Node to insert a glossary.""" class only(nodes.Element): """Node for "only" directives (conditional inclusion based on tags).""" # meta-information nodes class start_of_file(nodes.Element): """Node to mark start of a new file, used in the LaTeX builder only.""" class highlightlang(nodes.Element): """Inserted to set the highlight language and line number options for subsequent code blocks. """ class tabular_col_spec(nodes.Element): """Node for specifying tabular columns, used for LaTeX output.""" class meta(nodes.Special, nodes.PreBibliographic, nodes.Element): """Node for meta directive -- same as docutils' standard meta node, but pickleable. """ rawcontent = None # inline nodes class pending_xref(nodes.Inline, nodes.Element): """Node for cross-references that cannot be resolved without complete information about all documents. These nodes are resolved before writing output, in BuildEnvironment.resolve_references. """ child_text_separator = '' class pending_xref_condition(nodes.Inline, nodes.TextElement): """Node for cross-references that are used to choose appropriate content of the reference by conditions on the resolving phase. When the :py:class:`pending_xref` node contains one or more **pending_xref_condition** nodes, the cross-reference resolver should choose the content of the reference using defined conditions in ``condition`` attribute of each pending_xref_condition nodes:: <pending_xref refdomain="py" reftarget="io.StringIO ...> <pending_xref_condition condition="resolved"> <literal> StringIO <pending_xref_condition condition="*"> <literal> io.StringIO After the processing of cross-reference resolver, one of the content node under pending_xref_condition node is chosen by its condition and to be removed all of pending_xref_condition nodes:: # When resolved the cross-reference successfully <reference> <literal> StringIO # When resolution is failed <reference> <literal> io.StringIO .. note:: This node is only allowed to be placed under pending_xref node. It is not allows to place it under other nodes. In addition, pending_xref node must contain only pending_xref_condition nodes if it contains one or more pending_xref_condition nodes. The pending_xref_condition node should have **condition** attribute. Domains can be store their individual conditions into the attribute to filter contents on resolving phase. As a reserved condition name, ``condition="*"`` is used for the fallback of resolution failure. Additionally, as a recommended condition name, ``condition="resolved"`` is used for the representation of resolstion success in the intersphinx module. .. versionadded:: 4.0 """ class number_reference(nodes.reference): """Node for number references, similar to pending_xref.""" class download_reference(nodes.reference): """Node for download references, similar to pending_xref.""" class literal_emphasis(nodes.emphasis, not_smartquotable): """Node that behaves like `emphasis`, but further text processors are not applied (e.g. smartypants for HTML output). """ class literal_strong(nodes.strong, not_smartquotable): """Node that behaves like `strong`, but further text processors are not applied (e.g. smartypants for HTML output). """ class manpage(nodes.Inline, nodes.FixedTextElement): """Node for references to manpages.""" def setup(app: "Sphinx") -> Dict[str, Any]: from sphinx.util import docutils # lazy import app.add_node(toctree) app.add_node(desc) app.add_node(desc_signature) app.add_node(desc_signature_line) app.add_node(desc_content) app.add_node(desc_inline) app.add_node(desc_name) app.add_node(desc_addname) app.add_node(desc_type) app.add_node(desc_returns) app.add_node(desc_parameterlist) app.add_node(desc_parameter) app.add_node(desc_optional) app.add_node(desc_annotation) for n in SIG_ELEMENTS: app.add_node(n) app.add_node(versionmodified) app.add_node(seealso) app.add_node(productionlist) app.add_node(production) app.add_node(index) app.add_node(centered) app.add_node(acks) app.add_node(hlist) app.add_node(hlistcol) app.add_node(compact_paragraph) app.add_node(glossary) app.add_node(only) app.add_node(start_of_file) app.add_node(highlightlang) app.add_node(tabular_col_spec) app.add_node(pending_xref) app.add_node(number_reference) app.add_node(download_reference) app.add_node(literal_emphasis) app.add_node(literal_strong) app.add_node(manpage) if docutils.__version_info__ < (0, 18): app.add_node(meta) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ����������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/application.py������������������������������������������������������������������0000644�0000766�0000024�00000153022�00000000000�016524� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.application ~~~~~~~~~~~~~~~~~~ Sphinx application class and extensibility interface. Gracefully adapted from the TextPress system by Armin. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import os import pickle import platform import sys import warnings from collections import deque from io import StringIO from os import path from typing import IO, TYPE_CHECKING, Any, Callable, Dict, List, Optional, Tuple, Type, Union from docutils import nodes from docutils.nodes import Element, TextElement from docutils.parsers import Parser from docutils.parsers.rst import Directive, roles from docutils.transforms import Transform from pygments.lexer import Lexer import sphinx from sphinx import locale, package_dir from sphinx.config import Config from sphinx.deprecation import RemovedInSphinx60Warning from sphinx.domains import Domain, Index from sphinx.environment import BuildEnvironment from sphinx.environment.collectors import EnvironmentCollector from sphinx.errors import ApplicationError, ConfigError, VersionRequirementError from sphinx.events import EventManager from sphinx.extension import Extension from sphinx.highlighting import lexer_classes from sphinx.locale import __ from sphinx.project import Project from sphinx.registry import SphinxComponentRegistry from sphinx.roles import XRefRole from sphinx.theming import Theme from sphinx.util import docutils, logging, progress_message from sphinx.util.build_phase import BuildPhase from sphinx.util.console import bold # type: ignore from sphinx.util.i18n import CatalogRepository from sphinx.util.logging import prefixed_warnings from sphinx.util.osutil import abspath, ensuredir, relpath from sphinx.util.tags import Tags from sphinx.util.typing import RoleFunction, TitleGetter if TYPE_CHECKING: from docutils.nodes import Node # NOQA from sphinx.builders import Builder builtin_extensions = ( 'sphinx.addnodes', 'sphinx.builders.changes', 'sphinx.builders.epub3', 'sphinx.builders.dirhtml', 'sphinx.builders.dummy', 'sphinx.builders.gettext', 'sphinx.builders.html', 'sphinx.builders.latex', 'sphinx.builders.linkcheck', 'sphinx.builders.manpage', 'sphinx.builders.singlehtml', 'sphinx.builders.texinfo', 'sphinx.builders.text', 'sphinx.builders.xml', 'sphinx.config', 'sphinx.domains.c', 'sphinx.domains.changeset', 'sphinx.domains.citation', 'sphinx.domains.cpp', 'sphinx.domains.index', 'sphinx.domains.javascript', 'sphinx.domains.math', 'sphinx.domains.python', 'sphinx.domains.rst', 'sphinx.domains.std', 'sphinx.directives', 'sphinx.directives.code', 'sphinx.directives.other', 'sphinx.directives.patches', 'sphinx.extension', 'sphinx.parsers', 'sphinx.registry', 'sphinx.roles', 'sphinx.transforms', 'sphinx.transforms.compact_bullet_list', 'sphinx.transforms.i18n', 'sphinx.transforms.references', 'sphinx.transforms.post_transforms', 'sphinx.transforms.post_transforms.code', 'sphinx.transforms.post_transforms.images', 'sphinx.util.compat', 'sphinx.versioning', # collectors should be loaded by specific order 'sphinx.environment.collectors.dependencies', 'sphinx.environment.collectors.asset', 'sphinx.environment.collectors.metadata', 'sphinx.environment.collectors.title', 'sphinx.environment.collectors.toctree', # 1st party extensions 'sphinxcontrib.applehelp', 'sphinxcontrib.devhelp', 'sphinxcontrib.htmlhelp', 'sphinxcontrib.serializinghtml', 'sphinxcontrib.qthelp', # Strictly, alabaster theme is not a builtin extension, # but it is loaded automatically to use it as default theme. 'alabaster', ) ENV_PICKLE_FILENAME = 'environment.pickle' logger = logging.getLogger(__name__) class Sphinx: """The main application class and extensibility interface. :ivar srcdir: Directory containing source. :ivar confdir: Directory containing ``conf.py``. :ivar doctreedir: Directory for storing pickled doctrees. :ivar outdir: Directory for storing build documents. """ warningiserror: bool _warncount: int def __init__(self, srcdir: str, confdir: Optional[str], outdir: str, doctreedir: str, buildername: str, confoverrides: Dict = None, status: IO = sys.stdout, warning: IO = sys.stderr, freshenv: bool = False, warningiserror: bool = False, tags: List[str] = None, verbosity: int = 0, parallel: int = 0, keep_going: bool = False) -> None: self.phase = BuildPhase.INITIALIZATION self.verbosity = verbosity self.extensions: Dict[str, Extension] = {} self.builder: Optional[Builder] = None self.env: Optional[BuildEnvironment] = None self.project: Optional[Project] = None self.registry = SphinxComponentRegistry() # validate provided directories self.srcdir = abspath(srcdir) self.outdir = abspath(outdir) self.doctreedir = abspath(doctreedir) if not path.isdir(self.srcdir): raise ApplicationError(__('Cannot find source directory (%s)') % self.srcdir) if path.exists(self.outdir) and not path.isdir(self.outdir): raise ApplicationError(__('Output directory (%s) is not a directory') % self.outdir) if self.srcdir == self.outdir: raise ApplicationError(__('Source directory and destination ' 'directory cannot be identical')) self.parallel = parallel if status is None: self._status: IO = StringIO() self.quiet: bool = True else: self._status = status self.quiet = False if warning is None: self._warning: IO = StringIO() else: self._warning = warning self._warncount = 0 self.keep_going = warningiserror and keep_going if self.keep_going: self.warningiserror = False else: self.warningiserror = warningiserror logging.setup(self, self._status, self._warning) self.events = EventManager(self) # keep last few messages for traceback # This will be filled by sphinx.util.logging.LastMessagesWriter self.messagelog: deque = deque(maxlen=10) # say hello to the world logger.info(bold(__('Running Sphinx v%s') % sphinx.__display_version__)) # notice for parallel build on macOS and py38+ if sys.version_info > (3, 8) and platform.system() == 'Darwin' and parallel > 1: logger.info(bold(__("For security reasons, parallel mode is disabled on macOS and " "python3.8 and above. For more details, please read " "https://github.com/sphinx-doc/sphinx/issues/6803"))) # status code for command-line application self.statuscode = 0 # read config self.tags = Tags(tags) if confdir is None: # set confdir to srcdir if -C given (!= no confdir); a few pieces # of code expect a confdir to be set self.confdir = self.srcdir self.config = Config({}, confoverrides or {}) else: self.confdir = abspath(confdir) self.config = Config.read(self.confdir, confoverrides or {}, self.tags) # initialize some limited config variables before initialize i18n and loading # extensions self.config.pre_init_values() # set up translation infrastructure self._init_i18n() # check the Sphinx version if requested if self.config.needs_sphinx and self.config.needs_sphinx > sphinx.__display_version__: raise VersionRequirementError( __('This project needs at least Sphinx v%s and therefore cannot ' 'be built with this version.') % self.config.needs_sphinx) # load all built-in extension modules for extension in builtin_extensions: self.setup_extension(extension) # load all user-given extension modules for extension in self.config.extensions: self.setup_extension(extension) # preload builder module (before init config values) self.preload_builder(buildername) if not path.isdir(outdir): with progress_message(__('making output directory')): ensuredir(outdir) # the config file itself can be an extension if self.config.setup: prefix = __('while setting up extension %s:') % "conf.py" with prefixed_warnings(prefix): if callable(self.config.setup): self.config.setup(self) else: raise ConfigError( __("'setup' as currently defined in conf.py isn't a Python callable. " "Please modify its definition to make it a callable function. " "This is needed for conf.py to behave as a Sphinx extension.") ) # now that we know all config values, collect them from conf.py self.config.init_values() self.events.emit('config-inited', self.config) # create the project self.project = Project(self.srcdir, self.config.source_suffix) # create the builder self.builder = self.create_builder(buildername) # set up the build environment self._init_env(freshenv) # set up the builder self._init_builder() def _init_i18n(self) -> None: """Load translated strings from the configured localedirs if enabled in the configuration. """ if self.config.language is None: self.translator, has_translation = locale.init([], None) else: logger.info(bold(__('loading translations [%s]... ') % self.config.language), nonl=True) # compile mo files if sphinx.po file in user locale directories are updated repo = CatalogRepository(self.srcdir, self.config.locale_dirs, self.config.language, self.config.source_encoding) for catalog in repo.catalogs: if catalog.domain == 'sphinx' and catalog.is_outdated(): catalog.write_mo(self.config.language, self.config.gettext_allow_fuzzy_translations) locale_dirs: List[Optional[str]] = list(repo.locale_dirs) locale_dirs += [None] locale_dirs += [path.join(package_dir, 'locale')] self.translator, has_translation = locale.init(locale_dirs, self.config.language) if has_translation or self.config.language == 'en': # "en" never needs to be translated logger.info(__('done')) else: logger.info(__('not available for built-in messages')) def _init_env(self, freshenv: bool) -> None: filename = path.join(self.doctreedir, ENV_PICKLE_FILENAME) if freshenv or not os.path.exists(filename): self.env = BuildEnvironment(self) self.env.find_files(self.config, self.builder) else: try: with progress_message(__('loading pickled environment')): with open(filename, 'rb') as f: self.env = pickle.load(f) self.env.setup(self) except Exception as err: logger.info(__('failed: %s'), err) self._init_env(freshenv=True) def preload_builder(self, name: str) -> None: self.registry.preload_builder(self, name) def create_builder(self, name: str) -> "Builder": if name is None: logger.info(__('No builder selected, using default: html')) name = 'html' return self.registry.create_builder(self, name) def _init_builder(self) -> None: self.builder.set_environment(self.env) self.builder.init() self.events.emit('builder-inited') # ---- main "build" method ------------------------------------------------- def build(self, force_all: bool = False, filenames: List[str] = None) -> None: self.phase = BuildPhase.READING try: if force_all: self.builder.compile_all_catalogs() self.builder.build_all() elif filenames: self.builder.compile_specific_catalogs(filenames) self.builder.build_specific(filenames) else: self.builder.compile_update_catalogs() self.builder.build_update() if self._warncount and self.keep_going: self.statuscode = 1 status = (__('succeeded') if self.statuscode == 0 else __('finished with problems')) if self._warncount: if self.warningiserror: if self._warncount == 1: msg = __('build %s, %s warning (with warnings treated as errors).') else: msg = __('build %s, %s warnings (with warnings treated as errors).') else: if self._warncount == 1: msg = __('build %s, %s warning.') else: msg = __('build %s, %s warnings.') logger.info(bold(msg % (status, self._warncount))) else: logger.info(bold(__('build %s.') % status)) if self.statuscode == 0 and self.builder.epilog: logger.info('') logger.info(self.builder.epilog % { 'outdir': relpath(self.outdir), 'project': self.config.project }) except Exception as err: # delete the saved env to force a fresh build next time envfile = path.join(self.doctreedir, ENV_PICKLE_FILENAME) if path.isfile(envfile): os.unlink(envfile) self.events.emit('build-finished', err) raise else: self.events.emit('build-finished', None) self.builder.cleanup() # ---- general extensibility interface ------------------------------------- def setup_extension(self, extname: str) -> None: """Import and setup a Sphinx extension module. Load the extension given by the module *name*. Use this if your extension needs the features provided by another extension. No-op if called twice. """ logger.debug('[app] setting up extension: %r', extname) self.registry.load_extension(self, extname) def require_sphinx(self, version: str) -> None: """Check the Sphinx version if requested. Compare *version* with the version of the running Sphinx, and abort the build when it is too old. :param version: The required version in the form of ``major.minor``. .. versionadded:: 1.0 """ if version > sphinx.__display_version__[:3]: raise VersionRequirementError(version) # event interface def connect(self, event: str, callback: Callable, priority: int = 500) -> int: """Register *callback* to be called when *event* is emitted. For details on available core events and the arguments of callback functions, please see :ref:`events`. :param event: The name of target event :param callback: Callback function for the event :param priority: The priority of the callback. The callbacks will be invoked in order of *priority* (ascending). :return: A listener ID. It can be used for :meth:`disconnect`. .. versionchanged:: 3.0 Support *priority* """ listener_id = self.events.connect(event, callback, priority) logger.debug('[app] connecting event %r (%d): %r [id=%s]', event, priority, callback, listener_id) return listener_id def disconnect(self, listener_id: int) -> None: """Unregister callback by *listener_id*. :param listener_id: A listener_id that :meth:`connect` returns """ logger.debug('[app] disconnecting event: [id=%s]', listener_id) self.events.disconnect(listener_id) def emit(self, event: str, *args: Any, allowed_exceptions: Tuple[Type[Exception], ...] = ()) -> List: """Emit *event* and pass *arguments* to the callback functions. Return the return values of all callbacks as a list. Do not emit core Sphinx events in extensions! :param event: The name of event that will be emitted :param args: The arguments for the event :param allowed_exceptions: The list of exceptions that are allowed in the callbacks .. versionchanged:: 3.1 Added *allowed_exceptions* to specify path-through exceptions """ return self.events.emit(event, *args, allowed_exceptions=allowed_exceptions) def emit_firstresult(self, event: str, *args: Any, allowed_exceptions: Tuple[Type[Exception], ...] = ()) -> Any: """Emit *event* and pass *arguments* to the callback functions. Return the result of the first callback that doesn't return ``None``. :param event: The name of event that will be emitted :param args: The arguments for the event :param allowed_exceptions: The list of exceptions that are allowed in the callbacks .. versionadded:: 0.5 .. versionchanged:: 3.1 Added *allowed_exceptions* to specify path-through exceptions """ return self.events.emit_firstresult(event, *args, allowed_exceptions=allowed_exceptions) # registering addon parts def add_builder(self, builder: Type["Builder"], override: bool = False) -> None: """Register a new builder. :param builder: A builder class :param override: If true, install the builder forcedly even if another builder is already installed as the same name .. versionchanged:: 1.8 Add *override* keyword. """ self.registry.add_builder(builder, override=override) # TODO(stephenfin): Describe 'types' parameter def add_config_value(self, name: str, default: Any, rebuild: Union[bool, str], types: Any = ()) -> None: """Register a configuration value. This is necessary for Sphinx to recognize new values and set default values accordingly. :param name: The name of the configuration value. It is recommended to be prefixed with the extension name (ex. ``html_logo``, ``epub_title``) :param default: The default value of the configuration. :param rebuild: The condition of rebuild. It must be one of those values: * ``'env'`` if a change in the setting only takes effect when a document is parsed -- this means that the whole environment must be rebuilt. * ``'html'`` if a change in the setting needs a full rebuild of HTML documents. * ``''`` if a change in the setting will not need any special rebuild. :param types: The type of configuration value. A list of types can be specified. For example, ``[str]`` is used to describe a configuration that takes string value. .. versionchanged:: 0.4 If the *default* value is a callable, it will be called with the config object as its argument in order to get the default value. This can be used to implement config values whose default depends on other values. .. versionchanged:: 0.6 Changed *rebuild* from a simple boolean (equivalent to ``''`` or ``'env'``) to a string. However, booleans are still accepted and converted internally. """ logger.debug('[app] adding config value: %r', (name, default, rebuild, types)) if rebuild in (False, True): rebuild = 'env' if rebuild else '' self.config.add(name, default, rebuild, types) def add_event(self, name: str) -> None: """Register an event called *name*. This is needed to be able to emit it. :param name: The name of the event """ logger.debug('[app] adding event: %r', name) self.events.add(name) def set_translator(self, name: str, translator_class: Type[nodes.NodeVisitor], override: bool = False) -> None: """Register or override a Docutils translator class. This is used to register a custom output translator or to replace a builtin translator. This allows extensions to use a custom translator and define custom nodes for the translator (see :meth:`add_node`). :param name: The name of the builder for the translator :param translator_class: A translator class :param override: If true, install the translator forcedly even if another translator is already installed as the same name .. versionadded:: 1.3 .. versionchanged:: 1.8 Add *override* keyword. """ self.registry.add_translator(name, translator_class, override=override) def add_node(self, node: Type[Element], override: bool = False, **kwargs: Tuple[Callable, Optional[Callable]]) -> None: """Register a Docutils node class. This is necessary for Docutils internals. It may also be used in the future to validate nodes in the parsed documents. :param node: A node class :param kwargs: Visitor functions for each builder (see below) :param override: If true, install the node forcedly even if another node is already installed as the same name Node visitor functions for the Sphinx HTML, LaTeX, text and manpage writers can be given as keyword arguments: the keyword should be one or more of ``'html'``, ``'latex'``, ``'text'``, ``'man'``, ``'texinfo'`` or any other supported translators, the value a 2-tuple of ``(visit, depart)`` methods. ``depart`` can be ``None`` if the ``visit`` function raises :exc:`docutils.nodes.SkipNode`. Example: .. code-block:: python class math(docutils.nodes.Element): pass def visit_math_html(self, node): self.body.append(self.starttag(node, 'math')) def depart_math_html(self, node): self.body.append('</math>') app.add_node(math, html=(visit_math_html, depart_math_html)) Obviously, translators for which you don't specify visitor methods will choke on the node when encountered in a document to translate. .. versionchanged:: 0.5 Added the support for keyword arguments giving visit functions. """ logger.debug('[app] adding node: %r', (node, kwargs)) if not override and docutils.is_node_registered(node): logger.warning(__('node class %r is already registered, ' 'its visitors will be overridden'), node.__name__, type='app', subtype='add_node') docutils.register_node(node) self.registry.add_translation_handlers(node, **kwargs) def add_enumerable_node(self, node: Type[Element], figtype: str, title_getter: TitleGetter = None, override: bool = False, **kwargs: Tuple[Callable, Callable]) -> None: """Register a Docutils node class as a numfig target. Sphinx numbers the node automatically. And then the users can refer it using :rst:role:`numref`. :param node: A node class :param figtype: The type of enumerable nodes. Each figtype has individual numbering sequences. As system figtypes, ``figure``, ``table`` and ``code-block`` are defined. It is possible to add custom nodes to these default figtypes. It is also possible to define new custom figtype if a new figtype is given. :param title_getter: A getter function to obtain the title of node. It takes an instance of the enumerable node, and it must return its title as string. The title is used to the default title of references for :rst:role:`ref`. By default, Sphinx searches ``docutils.nodes.caption`` or ``docutils.nodes.title`` from the node as a title. :param kwargs: Visitor functions for each builder (same as :meth:`add_node`) :param override: If true, install the node forcedly even if another node is already installed as the same name .. versionadded:: 1.4 """ self.registry.add_enumerable_node(node, figtype, title_getter, override=override) self.add_node(node, override=override, **kwargs) def add_directive(self, name: str, cls: Type[Directive], override: bool = False) -> None: """Register a Docutils directive. :param name: The name of the directive :param cls: A directive class :param override: If true, install the directive forcedly even if another directive is already installed as the same name For example, a custom directive named ``my-directive`` would be added like this: .. code-block:: python from docutils.parsers.rst import Directive, directives class MyDirective(Directive): has_content = True required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec = { 'class': directives.class_option, 'name': directives.unchanged, } def run(self): ... def setup(app): app.add_directive('my-directive', MyDirective) For more details, see `the Docutils docs <https://docutils.sourceforge.io/docs/howto/rst-directives.html>`__ . .. versionchanged:: 0.6 Docutils 0.5-style directive classes are now supported. .. deprecated:: 1.8 Docutils 0.4-style (function based) directives support is deprecated. .. versionchanged:: 1.8 Add *override* keyword. """ logger.debug('[app] adding directive: %r', (name, cls)) if not override and docutils.is_directive_registered(name): logger.warning(__('directive %r is already registered, it will be overridden'), name, type='app', subtype='add_directive') docutils.register_directive(name, cls) def add_role(self, name: str, role: Any, override: bool = False) -> None: """Register a Docutils role. :param name: The name of role :param role: A role function :param override: If true, install the role forcedly even if another role is already installed as the same name For more details about role functions, see `the Docutils docs <https://docutils.sourceforge.io/docs/howto/rst-roles.html>`__ . .. versionchanged:: 1.8 Add *override* keyword. """ logger.debug('[app] adding role: %r', (name, role)) if not override and docutils.is_role_registered(name): logger.warning(__('role %r is already registered, it will be overridden'), name, type='app', subtype='add_role') docutils.register_role(name, role) def add_generic_role(self, name: str, nodeclass: Any, override: bool = False) -> None: """Register a generic Docutils role. Register a Docutils role that does nothing but wrap its contents in the node given by *nodeclass*. If *override* is True, the given *nodeclass* is forcedly installed even if a role named as *name* is already installed. .. versionadded:: 0.6 .. versionchanged:: 1.8 Add *override* keyword. """ # Don't use ``roles.register_generic_role`` because it uses # ``register_canonical_role``. logger.debug('[app] adding generic role: %r', (name, nodeclass)) if not override and docutils.is_role_registered(name): logger.warning(__('role %r is already registered, it will be overridden'), name, type='app', subtype='add_generic_role') role = roles.GenericRole(name, nodeclass) docutils.register_role(name, role) def add_domain(self, domain: Type[Domain], override: bool = False) -> None: """Register a domain. :param domain: A domain class :param override: If true, install the domain forcedly even if another domain is already installed as the same name .. versionadded:: 1.0 .. versionchanged:: 1.8 Add *override* keyword. """ self.registry.add_domain(domain, override=override) def add_directive_to_domain(self, domain: str, name: str, cls: Type[Directive], override: bool = False) -> None: """Register a Docutils directive in a domain. Like :meth:`add_directive`, but the directive is added to the domain named *domain*. :param domain: The name of target domain :param name: A name of directive :param cls: A directive class :param override: If true, install the directive forcedly even if another directive is already installed as the same name .. versionadded:: 1.0 .. versionchanged:: 1.8 Add *override* keyword. """ self.registry.add_directive_to_domain(domain, name, cls, override=override) def add_role_to_domain(self, domain: str, name: str, role: Union[RoleFunction, XRefRole], override: bool = False) -> None: """Register a Docutils role in a domain. Like :meth:`add_role`, but the role is added to the domain named *domain*. :param domain: The name of the target domain :param name: The name of the role :param role: The role function :param override: If true, install the role forcedly even if another role is already installed as the same name .. versionadded:: 1.0 .. versionchanged:: 1.8 Add *override* keyword. """ self.registry.add_role_to_domain(domain, name, role, override=override) def add_index_to_domain(self, domain: str, index: Type[Index], override: bool = False ) -> None: """Register a custom index for a domain. Add a custom *index* class to the domain named *domain*. :param domain: The name of the target domain :param index: The index class :param override: If true, install the index forcedly even if another index is already installed as the same name .. versionadded:: 1.0 .. versionchanged:: 1.8 Add *override* keyword. """ self.registry.add_index_to_domain(domain, index) def add_object_type(self, directivename: str, rolename: str, indextemplate: str = '', parse_node: Callable = None, ref_nodeclass: Type[TextElement] = None, objname: str = '', doc_field_types: List = [], override: bool = False ) -> None: """Register a new object type. This method is a very convenient way to add a new :term:`object` type that can be cross-referenced. It will do this: - Create a new directive (called *directivename*) for documenting an object. It will automatically add index entries if *indextemplate* is nonempty; if given, it must contain exactly one instance of ``%s``. See the example below for how the template will be interpreted. - Create a new role (called *rolename*) to cross-reference to these object descriptions. - If you provide *parse_node*, it must be a function that takes a string and a docutils node, and it must populate the node with children parsed from the string. It must then return the name of the item to be used in cross-referencing and index entries. See the :file:`conf.py` file in the source for this documentation for an example. - The *objname* (if not given, will default to *directivename*) names the type of object. It is used when listing objects, e.g. in search results. For example, if you have this call in a custom Sphinx extension:: app.add_object_type('directive', 'dir', 'pair: %s; directive') you can use this markup in your documents:: .. rst:directive:: function Document a function. <...> See also the :rst:dir:`function` directive. For the directive, an index entry will be generated as if you had prepended :: .. index:: pair: function; directive The reference node will be of class ``literal`` (so it will be rendered in a proportional font, as appropriate for code) unless you give the *ref_nodeclass* argument, which must be a docutils node class. Most useful are ``docutils.nodes.emphasis`` or ``docutils.nodes.strong`` -- you can also use ``docutils.nodes.generated`` if you want no further text decoration. If the text should be treated as literal (e.g. no smart quote replacement), but not have typewriter styling, use ``sphinx.addnodes.literal_emphasis`` or ``sphinx.addnodes.literal_strong``. For the role content, you have the same syntactical possibilities as for standard Sphinx roles (see :ref:`xref-syntax`). If *override* is True, the given object_type is forcedly installed even if an object_type having the same name is already installed. .. versionchanged:: 1.8 Add *override* keyword. """ self.registry.add_object_type(directivename, rolename, indextemplate, parse_node, ref_nodeclass, objname, doc_field_types, override=override) def add_crossref_type(self, directivename: str, rolename: str, indextemplate: str = '', ref_nodeclass: Type[TextElement] = None, objname: str = '', override: bool = False) -> None: """Register a new crossref object type. This method is very similar to :meth:`add_object_type` except that the directive it generates must be empty, and will produce no output. That means that you can add semantic targets to your sources, and refer to them using custom roles instead of generic ones (like :rst:role:`ref`). Example call:: app.add_crossref_type('topic', 'topic', 'single: %s', docutils.nodes.emphasis) Example usage:: .. topic:: application API The application API ------------------- Some random text here. See also :topic:`this section <application API>`. (Of course, the element following the ``topic`` directive needn't be a section.) If *override* is True, the given crossref_type is forcedly installed even if a crossref_type having the same name is already installed. .. versionchanged:: 1.8 Add *override* keyword. """ self.registry.add_crossref_type(directivename, rolename, indextemplate, ref_nodeclass, objname, override=override) def add_transform(self, transform: Type[Transform]) -> None: """Register a Docutils transform to be applied after parsing. Add the standard docutils :class:`Transform` subclass *transform* to the list of transforms that are applied after Sphinx parses a reST document. :param transform: A transform class .. list-table:: priority range categories for Sphinx transforms :widths: 20,80 * - Priority - Main purpose in Sphinx * - 0-99 - Fix invalid nodes by docutils. Translate a doctree. * - 100-299 - Preparation * - 300-399 - early * - 400-699 - main * - 700-799 - Post processing. Deadline to modify text and referencing. * - 800-899 - Collect referencing and referenced nodes. Domain processing. * - 900-999 - Finalize and clean up. refs: `Transform Priority Range Categories`__ __ https://docutils.sourceforge.io/docs/ref/transforms.html#transform-priority-range-categories """ # NOQA self.registry.add_transform(transform) def add_post_transform(self, transform: Type[Transform]) -> None: """Register a Docutils transform to be applied before writing. Add the standard docutils :class:`Transform` subclass *transform* to the list of transforms that are applied before Sphinx writes a document. :param transform: A transform class """ self.registry.add_post_transform(transform) def add_js_file(self, filename: str, priority: int = 500, **kwargs: Any) -> None: """Register a JavaScript file to include in the HTML output. Add *filename* to the list of JavaScript files that the default HTML template will include in order of *priority* (ascending). The filename must be relative to the HTML static path , or a full URI with scheme. If the priority of the JavaScript file is the same as others, the JavaScript files will be included in order of registration. If the keyword argument ``body`` is given, its value will be added between the ``<script>`` tags. Extra keyword arguments are included as attributes of the ``<script>`` tag. Example:: app.add_js_file('example.js') # => <script src="_static/example.js"></script> app.add_js_file('example.js', async="async") # => <script src="_static/example.js" async="async"></script> app.add_js_file(None, body="var myVariable = 'foo';") # => <script>var myVariable = 'foo';</script> .. list-table:: priority range for JavaScript files :widths: 20,80 * - Priority - Main purpose in Sphinx * - 200 - default priority for built-in JavaScript files * - 500 - default priority for extensions * - 800 - default priority for :confval:`html_js_files` A JavaScript file can be added to the specific HTML page when an extension calls this method on :event:`html-page-context` event. .. versionadded:: 0.5 .. versionchanged:: 1.8 Renamed from ``app.add_javascript()``. And it allows keyword arguments as attributes of script tag. .. versionchanged:: 3.5 Take priority argument. Allow to add a JavaScript file to the specific page. """ self.registry.add_js_file(filename, priority=priority, **kwargs) if hasattr(self.builder, 'add_js_file'): self.builder.add_js_file(filename, priority=priority, **kwargs) # type: ignore def add_css_file(self, filename: str, priority: int = 500, **kwargs: Any) -> None: """Register a stylesheet to include in the HTML output. Add *filename* to the list of CSS files that the default HTML template will include in order of *priority* (ascending). The filename must be relative to the HTML static path, or a full URI with scheme. If the priority of the CSS file is the same as others, the CSS files will be included in order of registration. The keyword arguments are also accepted for attributes of ``<link>`` tag. Example:: app.add_css_file('custom.css') # => <link rel="stylesheet" href="_static/custom.css" type="text/css" /> app.add_css_file('print.css', media='print') # => <link rel="stylesheet" href="_static/print.css" # type="text/css" media="print" /> app.add_css_file('fancy.css', rel='alternate stylesheet', title='fancy') # => <link rel="alternate stylesheet" href="_static/fancy.css" # type="text/css" title="fancy" /> .. list-table:: priority range for CSS files :widths: 20,80 * - Priority - Main purpose in Sphinx * - 200 - default priority for built-in CSS files * - 500 - default priority for extensions * - 800 - default priority for :confval:`html_css_files` A CSS file can be added to the specific HTML page when an extension calls this method on :event:`html-page-context` event. .. versionadded:: 1.0 .. versionchanged:: 1.6 Optional ``alternate`` and/or ``title`` attributes can be supplied with the arguments *alternate* (a Boolean) and *title* (a string). The default is no title and *alternate* = ``False``. For more information, refer to the `documentation <https://mdn.io/Web/CSS/Alternative_style_sheets>`__. .. versionchanged:: 1.8 Renamed from ``app.add_stylesheet()``. And it allows keyword arguments as attributes of link tag. .. versionchanged:: 3.5 Take priority argument. Allow to add a CSS file to the specific page. """ logger.debug('[app] adding stylesheet: %r', filename) self.registry.add_css_files(filename, priority=priority, **kwargs) if hasattr(self.builder, 'add_css_file'): self.builder.add_css_file(filename, priority=priority, **kwargs) # type: ignore def add_stylesheet(self, filename: str, alternate: bool = False, title: str = None ) -> None: """An alias of :meth:`add_css_file`. .. deprecated:: 1.8 """ logger.warning('The app.add_stylesheet() is deprecated. ' 'Please use app.add_css_file() instead.') attributes = {} # type: Dict[str, Any] if alternate: attributes['rel'] = 'alternate stylesheet' else: attributes['rel'] = 'stylesheet' if title: attributes['title'] = title self.add_css_file(filename, **attributes) def add_latex_package(self, packagename: str, options: str = None, after_hyperref: bool = False) -> None: r"""Register a package to include in the LaTeX source code. Add *packagename* to the list of packages that LaTeX source code will include. If you provide *options*, it will be taken to the `\usepackage` declaration. If you set *after_hyperref* truthy, the package will be loaded after ``hyperref`` package. .. code-block:: python app.add_latex_package('mypackage') # => \usepackage{mypackage} app.add_latex_package('mypackage', 'foo,bar') # => \usepackage[foo,bar]{mypackage} .. versionadded:: 1.3 .. versionadded:: 3.1 *after_hyperref* option. """ self.registry.add_latex_package(packagename, options, after_hyperref) def add_lexer(self, alias: str, lexer: Type[Lexer]) -> None: """Register a new lexer for source code. Use *lexer* to highlight code blocks with the given language *alias*. .. versionadded:: 0.6 .. versionchanged:: 2.1 Take a lexer class as an argument. An instance of lexers are still supported until Sphinx-3.x. """ logger.debug('[app] adding lexer: %r', (alias, lexer)) lexer_classes[alias] = lexer def add_autodocumenter(self, cls: Any, override: bool = False) -> None: """Register a new documenter class for the autodoc extension. Add *cls* as a new documenter class for the :mod:`sphinx.ext.autodoc` extension. It must be a subclass of :class:`sphinx.ext.autodoc.Documenter`. This allows auto-documenting new types of objects. See the source of the autodoc module for examples on how to subclass :class:`Documenter`. If *override* is True, the given *cls* is forcedly installed even if a documenter having the same name is already installed. See :ref:`autodoc_ext_tutorial`. .. versionadded:: 0.6 .. versionchanged:: 2.2 Add *override* keyword. """ logger.debug('[app] adding autodocumenter: %r', cls) from sphinx.ext.autodoc.directive import AutodocDirective self.registry.add_documenter(cls.objtype, cls) self.add_directive('auto' + cls.objtype, AutodocDirective, override=override) def add_autodoc_attrgetter(self, typ: Type, getter: Callable[[Any, str, Any], Any] ) -> None: """Register a new ``getattr``-like function for the autodoc extension. Add *getter*, which must be a function with an interface compatible to the :func:`getattr` builtin, as the autodoc attribute getter for objects that are instances of *typ*. All cases where autodoc needs to get an attribute of a type are then handled by this function instead of :func:`getattr`. .. versionadded:: 0.6 """ logger.debug('[app] adding autodoc attrgetter: %r', (typ, getter)) self.registry.add_autodoc_attrgetter(typ, getter) def add_search_language(self, cls: Any) -> None: """Register a new language for the HTML search index. Add *cls*, which must be a subclass of :class:`sphinx.search.SearchLanguage`, as a support language for building the HTML full-text search index. The class must have a *lang* attribute that indicates the language it should be used for. See :confval:`html_search_language`. .. versionadded:: 1.1 """ logger.debug('[app] adding search language: %r', cls) from sphinx.search import SearchLanguage, languages assert issubclass(cls, SearchLanguage) languages[cls.lang] = cls def add_source_suffix(self, suffix: str, filetype: str, override: bool = False) -> None: """Register a suffix of source files. Same as :confval:`source_suffix`. The users can override this using the config setting. If *override* is True, the given *suffix* is forcedly installed even if the same suffix is already installed. .. versionadded:: 1.8 """ self.registry.add_source_suffix(suffix, filetype, override=override) def add_source_parser(self, parser: Type[Parser], override: bool = False) -> None: """Register a parser class. If *override* is True, the given *parser* is forcedly installed even if a parser for the same suffix is already installed. .. versionadded:: 1.4 .. versionchanged:: 1.8 *suffix* argument is deprecated. It only accepts *parser* argument. Use :meth:`add_source_suffix` API to register suffix instead. .. versionchanged:: 1.8 Add *override* keyword. """ self.registry.add_source_parser(parser, override=override) def add_env_collector(self, collector: Type[EnvironmentCollector]) -> None: """Register an environment collector class. Refer to :ref:`collector-api`. .. versionadded:: 1.6 """ logger.debug('[app] adding environment collector: %r', collector) collector().enable(self) def add_html_theme(self, name: str, theme_path: str) -> None: """Register a HTML Theme. The *name* is a name of theme, and *theme_path* is a full path to the theme (refs: :ref:`distribute-your-theme`). .. versionadded:: 1.6 """ logger.debug('[app] adding HTML theme: %r, %r', name, theme_path) self.registry.add_html_theme(name, theme_path) def add_html_math_renderer(self, name: str, inline_renderers: Tuple[Callable, Callable] = None, block_renderers: Tuple[Callable, Callable] = None) -> None: """Register a math renderer for HTML. The *name* is a name of math renderer. Both *inline_renderers* and *block_renderers* are used as visitor functions for the HTML writer: the former for inline math node (``nodes.math``), the latter for block math node (``nodes.math_block``). Regarding visitor functions, see :meth:`add_node` for details. .. versionadded:: 1.8 """ self.registry.add_html_math_renderer(name, inline_renderers, block_renderers) def add_message_catalog(self, catalog: str, locale_dir: str) -> None: """Register a message catalog. :param catalog: The name of the catalog :param locale_dir: The base path of the message catalog For more details, see :func:`sphinx.locale.get_translation()`. .. versionadded:: 1.8 """ locale.init([locale_dir], self.config.language, catalog) locale.init_console(locale_dir, catalog) # ---- other methods ------------------------------------------------- def is_parallel_allowed(self, typ: str) -> bool: """Check whether parallel processing is allowed or not. :param typ: A type of processing; ``'read'`` or ``'write'``. """ if typ == 'read': attrname = 'parallel_read_safe' message_not_declared = __("the %s extension does not declare if it " "is safe for parallel reading, assuming " "it isn't - please ask the extension author " "to check and make it explicit") message_not_safe = __("the %s extension is not safe for parallel reading") elif typ == 'write': attrname = 'parallel_write_safe' message_not_declared = __("the %s extension does not declare if it " "is safe for parallel writing, assuming " "it isn't - please ask the extension author " "to check and make it explicit") message_not_safe = __("the %s extension is not safe for parallel writing") else: raise ValueError('parallel type %s is not supported' % typ) for ext in self.extensions.values(): allowed = getattr(ext, attrname, None) if allowed is None: logger.warning(message_not_declared, ext.name) logger.warning(__('doing serial %s'), typ) return False elif not allowed: logger.warning(message_not_safe, ext.name) logger.warning(__('doing serial %s'), typ) return False return True def set_html_assets_policy(self, policy): """Set the policy to include assets in HTML pages. - always: include the assets in all the pages - per_page: include the assets only in pages where they are used .. versionadded: 4.1 """ if policy not in ('always', 'per_page'): raise ValueError('policy %s is not supported' % policy) self.registry.html_assets_policy = policy @property def html_themes(self) -> Dict[str, str]: warnings.warn('app.html_themes is deprecated.', RemovedInSphinx60Warning) return self.registry.html_themes class TemplateBridge: """ This class defines the interface for a "template bridge", that is, a class that renders templates given a template name and a context. """ def init(self, builder: "Builder", theme: Theme = None, dirs: List[str] = None) -> None: """Called by the builder to initialize the template system. *builder* is the builder object; you'll probably want to look at the value of ``builder.config.templates_path``. *theme* is a :class:`sphinx.theming.Theme` object or None; in the latter case, *dirs* can be list of fixed directories to look for templates. """ raise NotImplementedError('must be implemented in subclasses') def newest_template_mtime(self) -> float: """Called by the builder to determine if output files are outdated because of template changes. Return the mtime of the newest template file that was changed. The default implementation returns ``0``. """ return 0 def render(self, template: str, context: Dict) -> None: """Called by the builder to render a template given as a filename with a specified context (a Python dictionary). """ raise NotImplementedError('must be implemented in subclasses') def render_string(self, template: str, context: Dict) -> str: """Called by the builder to render a template given as a string with a specified context (a Python dictionary). """ raise NotImplementedError('must be implemented in subclasses') ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4476907 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/�����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015455� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/__init__.py������������������������������������������������������������0000644�0000766�0000024�00000061572�00000000000�017601� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders ~~~~~~~~~~~~~~~ Builder superclass for all builders. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import pickle import time from os import path from typing import (TYPE_CHECKING, Any, Dict, Iterable, List, Optional, Sequence, Set, Tuple, Type, Union) from docutils import nodes from docutils.nodes import Node from sphinx.config import Config from sphinx.environment import CONFIG_CHANGED_REASON, CONFIG_OK, BuildEnvironment from sphinx.environment.adapters.asset import ImageAdapter from sphinx.errors import SphinxError from sphinx.events import EventManager from sphinx.io import read_doc from sphinx.locale import __ from sphinx.util import import_object, logging, progress_message, rst, status_iterator from sphinx.util.build_phase import BuildPhase from sphinx.util.console import bold # type: ignore from sphinx.util.docutils import sphinx_domains from sphinx.util.i18n import CatalogInfo, CatalogRepository, docname_to_domain from sphinx.util.osutil import SEP, ensuredir, relative_uri, relpath from sphinx.util.parallel import ParallelTasks, SerialTasks, make_chunks, parallel_available from sphinx.util.tags import Tags # side effect: registers roles and directives from sphinx import directives # NOQA isort:skip from sphinx import roles # NOQA isort:skip try: import multiprocessing except ImportError: multiprocessing = None if TYPE_CHECKING: from sphinx.application import Sphinx logger = logging.getLogger(__name__) class Builder: """ Builds target formats from the reST sources. """ #: The builder's name, for the -b command line option. name = '' #: The builder's output format, or '' if no document output is produced. format = '' #: The message emitted upon successful build completion. This can be a #: printf-style template string with the following keys: ``outdir``, #: ``project`` epilog = '' #: default translator class for the builder. This can be overridden by #: :py:meth:`app.set_translator()`. default_translator_class: Type[nodes.NodeVisitor] = None # doctree versioning method versioning_method = 'none' versioning_compare = False #: allow parallel write_doc() calls allow_parallel = False # support translation use_message_catalog = True #: The list of MIME types of image formats supported by the builder. #: Image files are searched in the order in which they appear here. supported_image_types: List[str] = [] #: The builder supports remote images or not. supported_remote_images = False #: The builder supports data URIs or not. supported_data_uri_images = False def __init__(self, app: "Sphinx") -> None: self.srcdir = app.srcdir self.confdir = app.confdir self.outdir = app.outdir self.doctreedir = app.doctreedir ensuredir(self.doctreedir) self.app: Sphinx = app self.env: Optional[BuildEnvironment] = None self.events: EventManager = app.events self.config: Config = app.config self.tags: Tags = app.tags self.tags.add(self.format) self.tags.add(self.name) self.tags.add("format_%s" % self.format) self.tags.add("builder_%s" % self.name) # images that need to be copied over (source -> dest) self.images: Dict[str, str] = {} # basename of images directory self.imagedir = "" # relative path to image directory from current docname (used at writing docs) self.imgpath = "" # these get set later self.parallel_ok = False self.finish_tasks: Any = None def set_environment(self, env: BuildEnvironment) -> None: """Store BuildEnvironment object.""" self.env = env self.env.set_versioning_method(self.versioning_method, self.versioning_compare) def get_translator_class(self, *args: Any) -> Type[nodes.NodeVisitor]: """Return a class of translator.""" return self.app.registry.get_translator_class(self) def create_translator(self, *args: Any) -> nodes.NodeVisitor: """Return an instance of translator. This method returns an instance of ``default_translator_class`` by default. Users can replace the translator class with ``app.set_translator()`` API. """ return self.app.registry.create_translator(self, *args) # helper methods def init(self) -> None: """Load necessary templates and perform initialization. The default implementation does nothing. """ pass def create_template_bridge(self) -> None: """Return the template bridge configured.""" if self.config.template_bridge: self.templates = import_object(self.config.template_bridge, 'template_bridge setting')() else: from sphinx.jinja2glue import BuiltinTemplateLoader self.templates = BuiltinTemplateLoader() def get_target_uri(self, docname: str, typ: str = None) -> str: """Return the target URI for a document name. *typ* can be used to qualify the link characteristic for individual builders. """ raise NotImplementedError def get_relative_uri(self, from_: str, to: str, typ: str = None) -> str: """Return a relative URI between two source filenames. May raise environment.NoUri if there's no way to return a sensible URI. """ return relative_uri(self.get_target_uri(from_), self.get_target_uri(to, typ)) def get_outdated_docs(self) -> Union[str, Iterable[str]]: """Return an iterable of output files that are outdated, or a string describing what an update build will build. If the builder does not output individual files corresponding to source files, return a string here. If it does, return an iterable of those files that need to be written. """ raise NotImplementedError def get_asset_paths(self) -> List[str]: """Return list of paths for assets (ex. templates, CSS, etc.).""" return [] def post_process_images(self, doctree: Node) -> None: """Pick the best candidate for all image URIs.""" images = ImageAdapter(self.env) for node in doctree.traverse(nodes.image): if '?' in node['candidates']: # don't rewrite nonlocal image URIs continue if '*' not in node['candidates']: for imgtype in self.supported_image_types: candidate = node['candidates'].get(imgtype, None) if candidate: break else: mimetypes = sorted(node['candidates']) image_uri = images.get_original_image_uri(node['uri']) if mimetypes: logger.warning(__('a suitable image for %s builder not found: ' '%s (%s)'), self.name, mimetypes, image_uri, location=node) else: logger.warning(__('a suitable image for %s builder not found: %s'), self.name, image_uri, location=node) continue node['uri'] = candidate else: candidate = node['uri'] if candidate not in self.env.images: # non-existing URI; let it alone continue self.images[candidate] = self.env.images[candidate][1] # compile po methods def compile_catalogs(self, catalogs: Set[CatalogInfo], message: str) -> None: if not self.config.gettext_auto_build: return def cat2relpath(cat: CatalogInfo) -> str: return relpath(cat.mo_path, self.env.srcdir).replace(path.sep, SEP) logger.info(bold(__('building [mo]: ')) + message) for catalog in status_iterator(catalogs, __('writing output... '), "darkgreen", len(catalogs), self.app.verbosity, stringify_func=cat2relpath): catalog.write_mo(self.config.language, self.config.gettext_allow_fuzzy_translations) def compile_all_catalogs(self) -> None: repo = CatalogRepository(self.srcdir, self.config.locale_dirs, self.config.language, self.config.source_encoding) message = __('all of %d po files') % len(list(repo.catalogs)) self.compile_catalogs(set(repo.catalogs), message) def compile_specific_catalogs(self, specified_files: List[str]) -> None: def to_domain(fpath: str) -> Optional[str]: docname = self.env.path2doc(path.abspath(fpath)) if docname: return docname_to_domain(docname, self.config.gettext_compact) else: return None catalogs = set() domains = set(map(to_domain, specified_files)) repo = CatalogRepository(self.srcdir, self.config.locale_dirs, self.config.language, self.config.source_encoding) for catalog in repo.catalogs: if catalog.domain in domains and catalog.is_outdated(): catalogs.add(catalog) message = __('targets for %d po files that are specified') % len(catalogs) self.compile_catalogs(catalogs, message) def compile_update_catalogs(self) -> None: repo = CatalogRepository(self.srcdir, self.config.locale_dirs, self.config.language, self.config.source_encoding) catalogs = {c for c in repo.catalogs if c.is_outdated()} message = __('targets for %d po files that are out of date') % len(catalogs) self.compile_catalogs(catalogs, message) # build methods def build_all(self) -> None: """Build all source files.""" self.build(None, summary=__('all source files'), method='all') def build_specific(self, filenames: List[str]) -> None: """Only rebuild as much as needed for changes in the *filenames*.""" # bring the filenames to the canonical format, that is, # relative to the source directory and without source_suffix. dirlen = len(self.srcdir) + 1 to_write = [] suffixes: Tuple[str] = tuple(self.config.source_suffix) # type: ignore for filename in filenames: filename = path.normpath(path.abspath(filename)) if not filename.startswith(self.srcdir): logger.warning(__('file %r given on command line is not under the ' 'source directory, ignoring'), filename) continue if not path.isfile(filename): logger.warning(__('file %r given on command line does not exist, ' 'ignoring'), filename) continue filename = filename[dirlen:] for suffix in suffixes: if filename.endswith(suffix): filename = filename[:-len(suffix)] break filename = filename.replace(path.sep, SEP) to_write.append(filename) self.build(to_write, method='specific', summary=__('%d source files given on command line') % len(to_write)) def build_update(self) -> None: """Only rebuild what was changed or added since last build.""" to_build = self.get_outdated_docs() if isinstance(to_build, str): self.build(['__all__'], to_build) else: to_build = list(to_build) self.build(to_build, summary=__('targets for %d source files that are out of date') % len(to_build)) def build(self, docnames: Iterable[str], summary: str = None, method: str = 'update') -> None: # NOQA """Main build method. First updates the environment, and then calls :meth:`write`. """ if summary: logger.info(bold(__('building [%s]: ') % self.name) + summary) # while reading, collect all warnings from docutils with logging.pending_warnings(): updated_docnames = set(self.read()) doccount = len(updated_docnames) logger.info(bold(__('looking for now-outdated files... ')), nonl=True) for docname in self.env.check_dependents(self.app, updated_docnames): updated_docnames.add(docname) outdated = len(updated_docnames) - doccount if outdated: logger.info(__('%d found'), outdated) else: logger.info(__('none found')) if updated_docnames: # save the environment from sphinx.application import ENV_PICKLE_FILENAME with progress_message(__('pickling environment')): with open(path.join(self.doctreedir, ENV_PICKLE_FILENAME), 'wb') as f: pickle.dump(self.env, f, pickle.HIGHEST_PROTOCOL) # global actions self.app.phase = BuildPhase.CONSISTENCY_CHECK with progress_message(__('checking consistency')): self.env.check_consistency() else: if method == 'update' and not docnames: logger.info(bold(__('no targets are out of date.'))) return self.app.phase = BuildPhase.RESOLVING # filter "docnames" (list of outdated files) by the updated # found_docs of the environment; this will remove docs that # have since been removed if docnames and docnames != ['__all__']: docnames = set(docnames) & self.env.found_docs # determine if we can write in parallel if parallel_available and self.app.parallel > 1 and self.allow_parallel: self.parallel_ok = self.app.is_parallel_allowed('write') else: self.parallel_ok = False # create a task executor to use for misc. "finish-up" tasks # if self.parallel_ok: # self.finish_tasks = ParallelTasks(self.app.parallel) # else: # for now, just execute them serially self.finish_tasks = SerialTasks() # write all "normal" documents (or everything for some builders) self.write(docnames, list(updated_docnames), method) # finish (write static files etc.) self.finish() # wait for all tasks self.finish_tasks.join() def read(self) -> List[str]: """(Re-)read all files new or changed since last update. Store all environment docnames in the canonical format (ie using SEP as a separator in place of os.path.sep). """ logger.info(bold(__('updating environment: ')), nonl=True) self.env.find_files(self.config, self) updated = (self.env.config_status != CONFIG_OK) added, changed, removed = self.env.get_outdated_files(updated) # allow user intervention as well for docs in self.events.emit('env-get-outdated', self.env, added, changed, removed): changed.update(set(docs) & self.env.found_docs) # if files were added or removed, all documents with globbed toctrees # must be reread if added or removed: # ... but not those that already were removed changed.update(self.env.glob_toctrees & self.env.found_docs) if updated: # explain the change iff build config status was not ok reason = (CONFIG_CHANGED_REASON.get(self.env.config_status, '') + (self.env.config_status_extra or '')) logger.info('[%s] ', reason, nonl=True) logger.info(__('%s added, %s changed, %s removed'), len(added), len(changed), len(removed)) # clear all files no longer present for docname in removed: self.events.emit('env-purge-doc', self.env, docname) self.env.clear_doc(docname) # read all new and changed files docnames = sorted(added | changed) # allow changing and reordering the list of docs to read self.events.emit('env-before-read-docs', self.env, docnames) # check if we should do parallel or serial read if parallel_available and len(docnames) > 5 and self.app.parallel > 1: par_ok = self.app.is_parallel_allowed('read') else: par_ok = False if par_ok: self._read_parallel(docnames, nproc=self.app.parallel) else: self._read_serial(docnames) if self.config.root_doc not in self.env.all_docs: raise SphinxError('root file %s not found' % self.env.doc2path(self.config.root_doc)) for retval in self.events.emit('env-updated', self.env): if retval is not None: docnames.extend(retval) # workaround: marked as okay to call builder.read() twice in same process self.env.config_status = CONFIG_OK return sorted(docnames) def _read_serial(self, docnames: List[str]) -> None: for docname in status_iterator(docnames, __('reading sources... '), "purple", len(docnames), self.app.verbosity): # remove all inventory entries for that file self.events.emit('env-purge-doc', self.env, docname) self.env.clear_doc(docname) self.read_doc(docname) def _read_parallel(self, docnames: List[str], nproc: int) -> None: # clear all outdated docs at once for docname in docnames: self.events.emit('env-purge-doc', self.env, docname) self.env.clear_doc(docname) def read_process(docs: List[str]) -> bytes: self.env.app = self.app for docname in docs: self.read_doc(docname) # allow pickling self to send it back return pickle.dumps(self.env, pickle.HIGHEST_PROTOCOL) def merge(docs: List[str], otherenv: bytes) -> None: env = pickle.loads(otherenv) self.env.merge_info_from(docs, env, self.app) tasks = ParallelTasks(nproc) chunks = make_chunks(docnames, nproc) for chunk in status_iterator(chunks, __('reading sources... '), "purple", len(chunks), self.app.verbosity): tasks.add_task(read_process, chunk, merge) # make sure all threads have finished logger.info(bold(__('waiting for workers...'))) tasks.join() def read_doc(self, docname: str) -> None: """Parse a file and add/update inventory entries for the doctree.""" self.env.prepare_settings(docname) # Add confdir/docutils.conf to dependencies list if exists docutilsconf = path.join(self.confdir, 'docutils.conf') if path.isfile(docutilsconf): self.env.note_dependency(docutilsconf) with sphinx_domains(self.env), rst.default_role(docname, self.config.default_role): doctree = read_doc(self.app, self.env, self.env.doc2path(docname)) # store time of reading, for outdated files detection # (Some filesystems have coarse timestamp resolution; # therefore time.time() can be older than filesystem's timestamp. # For example, FAT32 has 2sec timestamp resolution.) self.env.all_docs[docname] = max(time.time(), path.getmtime(self.env.doc2path(docname))) # cleanup self.env.temp_data.clear() self.env.ref_context.clear() self.write_doctree(docname, doctree) def write_doctree(self, docname: str, doctree: nodes.document) -> None: """Write the doctree to a file.""" # make it picklable doctree.reporter = None doctree.transformer = None doctree.settings.warning_stream = None doctree.settings.env = None doctree.settings.record_dependencies = None doctree_filename = path.join(self.doctreedir, docname + '.doctree') ensuredir(path.dirname(doctree_filename)) with open(doctree_filename, 'wb') as f: pickle.dump(doctree, f, pickle.HIGHEST_PROTOCOL) def write(self, build_docnames: Iterable[str], updated_docnames: Sequence[str], method: str = 'update') -> None: # NOQA if build_docnames is None or build_docnames == ['__all__']: # build_all build_docnames = self.env.found_docs if method == 'update': # build updated ones as well docnames = set(build_docnames) | set(updated_docnames) else: docnames = set(build_docnames) logger.debug(__('docnames to write: %s'), ', '.join(sorted(docnames))) # add all toctree-containing files that may have changed for docname in list(docnames): for tocdocname in self.env.files_to_rebuild.get(docname, set()): if tocdocname in self.env.found_docs: docnames.add(tocdocname) docnames.add(self.config.root_doc) with progress_message(__('preparing documents')): self.prepare_writing(docnames) if self.parallel_ok: # number of subprocesses is parallel-1 because the main process # is busy loading doctrees and doing write_doc_serialized() self._write_parallel(sorted(docnames), nproc=self.app.parallel - 1) else: self._write_serial(sorted(docnames)) def _write_serial(self, docnames: Sequence[str]) -> None: with logging.pending_warnings(): for docname in status_iterator(docnames, __('writing output... '), "darkgreen", len(docnames), self.app.verbosity): self.app.phase = BuildPhase.RESOLVING doctree = self.env.get_and_resolve_doctree(docname, self) self.app.phase = BuildPhase.WRITING self.write_doc_serialized(docname, doctree) self.write_doc(docname, doctree) def _write_parallel(self, docnames: Sequence[str], nproc: int) -> None: def write_process(docs: List[Tuple[str, nodes.document]]) -> None: self.app.phase = BuildPhase.WRITING for docname, doctree in docs: self.write_doc(docname, doctree) # warm up caches/compile templates using the first document firstname, docnames = docnames[0], docnames[1:] self.app.phase = BuildPhase.RESOLVING doctree = self.env.get_and_resolve_doctree(firstname, self) self.app.phase = BuildPhase.WRITING self.write_doc_serialized(firstname, doctree) self.write_doc(firstname, doctree) tasks = ParallelTasks(nproc) chunks = make_chunks(docnames, nproc) self.app.phase = BuildPhase.RESOLVING for chunk in status_iterator(chunks, __('writing output... '), "darkgreen", len(chunks), self.app.verbosity): arg = [] for i, docname in enumerate(chunk): doctree = self.env.get_and_resolve_doctree(docname, self) self.write_doc_serialized(docname, doctree) arg.append((docname, doctree)) tasks.add_task(write_process, arg) # make sure all threads have finished logger.info(bold(__('waiting for workers...'))) tasks.join() def prepare_writing(self, docnames: Set[str]) -> None: """A place where you can add logic before :meth:`write_doc` is run""" raise NotImplementedError def write_doc(self, docname: str, doctree: nodes.document) -> None: """Where you actually write something to the filesystem.""" raise NotImplementedError def write_doc_serialized(self, docname: str, doctree: nodes.document) -> None: """Handle parts of write_doc that must be called in the main process if parallel build is active. """ pass def finish(self) -> None: """Finish the building process. The default implementation does nothing. """ pass def cleanup(self) -> None: """Cleanup any resources. The default implementation does nothing. """ pass def get_builder_config(self, option: str, default: str) -> Any: """Return a builder specific option. This method allows customization of common builder settings by inserting the name of the current builder in the option key. If the key does not exist, use default as builder name. """ # At the moment, only XXX_use_index is looked up this way. # Every new builder variant must be registered in Config.config_values. try: optname = '%s_%s' % (self.name, option) return getattr(self.config, optname) except AttributeError: optname = '%s_%s' % (default, option) return getattr(self.config, optname) ��������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/_epub_base.py����������������������������������������������������������0000644�0000766�0000024�00000071002�00000000000�020113� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders._epub_base ~~~~~~~~~~~~~~~~~~~~~~~~~~ Base class of epub2/epub3 builders. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import html import os import re from os import path from typing import Any, Dict, List, NamedTuple, Set, Tuple from zipfile import ZIP_DEFLATED, ZIP_STORED, ZipFile from docutils import nodes from docutils.nodes import Element, Node from docutils.utils import smartquotes from sphinx import addnodes from sphinx.builders.html import BuildInfo, StandaloneHTMLBuilder from sphinx.locale import __ from sphinx.util import logging, status_iterator from sphinx.util.fileutil import copy_asset_file from sphinx.util.i18n import format_date from sphinx.util.osutil import copyfile, ensuredir try: from PIL import Image except ImportError: Image = None logger = logging.getLogger(__name__) # (Fragment) templates from which the metainfo files content.opf and # toc.ncx are created. # This template section also defines strings that are embedded in the html # output but that may be customized by (re-)setting module attributes, # e.g. from conf.py. COVERPAGE_NAME = 'epub-cover.xhtml' TOCTREE_TEMPLATE = 'toctree-l%d' LINK_TARGET_TEMPLATE = ' [%(uri)s]' FOOTNOTE_LABEL_TEMPLATE = '#%d' FOOTNOTES_RUBRIC_NAME = 'Footnotes' CSS_LINK_TARGET_CLASS = 'link-target' # XXX These strings should be localized according to epub_language GUIDE_TITLES = { 'toc': 'Table of Contents', 'cover': 'Cover' } MEDIA_TYPES = { '.xhtml': 'application/xhtml+xml', '.css': 'text/css', '.png': 'image/png', '.gif': 'image/gif', '.svg': 'image/svg+xml', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.otf': 'application/x-font-otf', '.ttf': 'application/x-font-ttf', '.woff': 'application/font-woff', } VECTOR_GRAPHICS_EXTENSIONS = ('.svg',) # Regular expression to match colons only in local fragment identifiers. # If the URI contains a colon before the #, # it is an external link that should not change. REFURI_RE = re.compile("([^#:]*#)(.*)") class ManifestItem(NamedTuple): href: str id: str media_type: str class Spine(NamedTuple): idref: str linear: bool class Guide(NamedTuple): type: str title: str uri: str class NavPoint(NamedTuple): navpoint: str playorder: int text: str refuri: str children: List[Any] # mypy does not support recursive types # https://github.com/python/mypy/issues/7069 def sphinx_smarty_pants(t: str, language: str = 'en') -> str: t = t.replace('"', '"') t = smartquotes.educateDashesOldSchool(t) t = smartquotes.educateQuotes(t, language) t = t.replace('"', '"') return t ssp = sphinx_smarty_pants # The epub publisher class EpubBuilder(StandaloneHTMLBuilder): """ Builder that outputs epub files. It creates the metainfo files container.opf, toc.ncx, mimetype, and META-INF/container.xml. Afterwards, all necessary files are zipped to an epub file. """ # don't copy the reST source copysource = False supported_image_types = ['image/svg+xml', 'image/png', 'image/gif', 'image/jpeg'] supported_remote_images = False # don't add links add_permalinks = False # don't use # as current path. ePub check reject it. allow_sharp_as_current_path = False # don't add sidebar etc. embedded = True # disable download role download_support = False # don't create links to original images from images html_scaled_image_link = False # don't generate search index or include search page search = False coverpage_name = COVERPAGE_NAME toctree_template = TOCTREE_TEMPLATE link_target_template = LINK_TARGET_TEMPLATE css_link_target_class = CSS_LINK_TARGET_CLASS guide_titles = GUIDE_TITLES media_types = MEDIA_TYPES refuri_re = REFURI_RE template_dir = "" doctype = "" def init(self) -> None: super().init() # the output files for epub must be .html only self.out_suffix = '.xhtml' self.link_suffix = '.xhtml' self.playorder = 0 self.tocid = 0 self.id_cache: Dict[str, str] = {} self.use_index = self.get_builder_config('use_index', 'epub') self.refnodes: List[Dict[str, Any]] = [] def create_build_info(self) -> BuildInfo: return BuildInfo(self.config, self.tags, ['html', 'epub']) def get_theme_config(self) -> Tuple[str, Dict]: return self.config.epub_theme, self.config.epub_theme_options # generic support functions def make_id(self, name: str) -> str: # id_cache is intentionally mutable """Return a unique id for name.""" id = self.id_cache.get(name) if not id: id = 'epub-%d' % self.env.new_serialno('epub') self.id_cache[name] = id return id def get_refnodes(self, doctree: Node, result: List[Dict[str, Any]]) -> List[Dict[str, Any]]: # NOQA """Collect section titles, their depth in the toc and the refuri.""" # XXX: is there a better way than checking the attribute # toctree-l[1-8] on the parent node? if isinstance(doctree, nodes.reference) and doctree.get('refuri'): refuri = doctree['refuri'] if refuri.startswith('http://') or refuri.startswith('https://') \ or refuri.startswith('irc:') or refuri.startswith('mailto:'): return result classes = doctree.parent.attributes['classes'] for level in range(8, 0, -1): # or range(1, 8)? if (self.toctree_template % level) in classes: result.append({ 'level': level, 'refuri': html.escape(refuri), 'text': ssp(html.escape(doctree.astext())) }) break elif isinstance(doctree, nodes.Element): for elem in doctree: result = self.get_refnodes(elem, result) return result def check_refnodes(self, nodes: List[Dict[str, Any]]) -> None: appeared: Set[str] = set() for node in nodes: if node['refuri'] in appeared: logger.warning( __('duplicated ToC entry found: %s'), node['refuri'], type="epub", subtype="duplicated_toc_entry", ) else: appeared.add(node['refuri']) def get_toc(self) -> None: """Get the total table of contents, containing the root_doc and pre and post files not managed by sphinx. """ doctree = self.env.get_and_resolve_doctree(self.config.root_doc, self, prune_toctrees=False, includehidden=True) self.refnodes = self.get_refnodes(doctree, []) master_dir = path.dirname(self.config.root_doc) if master_dir: master_dir += '/' # XXX or os.sep? for item in self.refnodes: item['refuri'] = master_dir + item['refuri'] self.toc_add_files(self.refnodes) def toc_add_files(self, refnodes: List[Dict[str, Any]]) -> None: """Add the root_doc, pre and post files to a list of refnodes. """ refnodes.insert(0, { 'level': 1, 'refuri': html.escape(self.config.root_doc + self.out_suffix), 'text': ssp(html.escape( self.env.titles[self.config.root_doc].astext())) }) for file, text in reversed(self.config.epub_pre_files): refnodes.insert(0, { 'level': 1, 'refuri': html.escape(file), 'text': ssp(html.escape(text)) }) for file, text in self.config.epub_post_files: refnodes.append({ 'level': 1, 'refuri': html.escape(file), 'text': ssp(html.escape(text)) }) def fix_fragment(self, prefix: str, fragment: str) -> str: """Return a href/id attribute with colons replaced by hyphens.""" return prefix + fragment.replace(':', '-') def fix_ids(self, tree: nodes.document) -> None: """Replace colons with hyphens in href and id attributes. Some readers crash because they interpret the part as a transport protocol specification. """ def update_node_id(node: Element) -> None: """Update IDs of given *node*.""" new_ids: List[str] = [] for node_id in node['ids']: new_id = self.fix_fragment('', node_id) if new_id not in new_ids: new_ids.append(new_id) node['ids'] = new_ids for reference in tree.traverse(nodes.reference): if 'refuri' in reference: m = self.refuri_re.match(reference['refuri']) if m: reference['refuri'] = self.fix_fragment(m.group(1), m.group(2)) if 'refid' in reference: reference['refid'] = self.fix_fragment('', reference['refid']) for target in tree.traverse(nodes.target): update_node_id(target) next_node: Node = target.next_node(ascend=True) if isinstance(next_node, nodes.Element): update_node_id(next_node) for desc_signature in tree.traverse(addnodes.desc_signature): update_node_id(desc_signature) def add_visible_links(self, tree: nodes.document, show_urls: str = 'inline') -> None: """Add visible link targets for external links""" def make_footnote_ref(doc: nodes.document, label: str) -> nodes.footnote_reference: """Create a footnote_reference node with children""" footnote_ref = nodes.footnote_reference('[#]_') footnote_ref.append(nodes.Text(label)) doc.note_autofootnote_ref(footnote_ref) return footnote_ref def make_footnote(doc: nodes.document, label: str, uri: str) -> nodes.footnote: """Create a footnote node with children""" footnote = nodes.footnote(uri) para = nodes.paragraph() para.append(nodes.Text(uri)) footnote.append(para) footnote.insert(0, nodes.label('', label)) doc.note_autofootnote(footnote) return footnote def footnote_spot(tree: nodes.document) -> Tuple[Element, int]: """Find or create a spot to place footnotes. The function returns the tuple (parent, index).""" # The code uses the following heuristic: # a) place them after the last existing footnote # b) place them after an (empty) Footnotes rubric # c) create an empty Footnotes rubric at the end of the document fns = list(tree.traverse(nodes.footnote)) if fns: fn = fns[-1] return fn.parent, fn.parent.index(fn) + 1 for node in tree.traverse(nodes.rubric): if len(node) == 1 and node.astext() == FOOTNOTES_RUBRIC_NAME: return node.parent, node.parent.index(node) + 1 doc = list(tree.traverse(nodes.document))[0] rub = nodes.rubric() rub.append(nodes.Text(FOOTNOTES_RUBRIC_NAME)) doc.append(rub) return doc, doc.index(rub) + 1 if show_urls == 'no': return if show_urls == 'footnote': doc = list(tree.traverse(nodes.document))[0] fn_spot, fn_idx = footnote_spot(tree) nr = 1 for node in list(tree.traverse(nodes.reference)): uri = node.get('refuri', '') if (uri.startswith('http:') or uri.startswith('https:') or uri.startswith('ftp:')) and uri not in node.astext(): idx = node.parent.index(node) + 1 if show_urls == 'inline': uri = self.link_target_template % {'uri': uri} link = nodes.inline(uri, uri) link['classes'].append(self.css_link_target_class) node.parent.insert(idx, link) elif show_urls == 'footnote': label = FOOTNOTE_LABEL_TEMPLATE % nr nr += 1 footnote_ref = make_footnote_ref(doc, label) node.parent.insert(idx, footnote_ref) footnote = make_footnote(doc, label, uri) fn_spot.insert(fn_idx, footnote) footnote_ref['refid'] = footnote['ids'][0] footnote.add_backref(footnote_ref['ids'][0]) fn_idx += 1 def write_doc(self, docname: str, doctree: nodes.document) -> None: """Write one document file. This method is overwritten in order to fix fragment identifiers and to add visible external links. """ self.fix_ids(doctree) self.add_visible_links(doctree, self.config.epub_show_urls) super().write_doc(docname, doctree) def fix_genindex(self, tree: List[Tuple[str, List[Tuple[str, Any]]]]) -> None: """Fix href attributes for genindex pages.""" # XXX: modifies tree inline # Logic modeled from themes/basic/genindex.html for key, columns in tree: for entryname, (links, subitems, key_) in columns: for (i, (ismain, link)) in enumerate(links): m = self.refuri_re.match(link) if m: links[i] = (ismain, self.fix_fragment(m.group(1), m.group(2))) for subentryname, subentrylinks in subitems: for (i, (ismain, link)) in enumerate(subentrylinks): m = self.refuri_re.match(link) if m: subentrylinks[i] = (ismain, self.fix_fragment(m.group(1), m.group(2))) def is_vector_graphics(self, filename: str) -> bool: """Does the filename extension indicate a vector graphic format?""" ext = path.splitext(filename)[-1] return ext in VECTOR_GRAPHICS_EXTENSIONS def copy_image_files_pil(self) -> None: """Copy images using Pillow, the Python Imaging Library. The method tries to read and write the files with Pillow, converting the format and resizing the image if necessary/possible. """ ensuredir(path.join(self.outdir, self.imagedir)) for src in status_iterator(self.images, __('copying images... '), "brown", len(self.images), self.app.verbosity): dest = self.images[src] try: img = Image.open(path.join(self.srcdir, src)) except OSError: if not self.is_vector_graphics(src): logger.warning(__('cannot read image file %r: copying it instead'), path.join(self.srcdir, src)) try: copyfile(path.join(self.srcdir, src), path.join(self.outdir, self.imagedir, dest)) except OSError as err: logger.warning(__('cannot copy image file %r: %s'), path.join(self.srcdir, src), err) continue if self.config.epub_fix_images: if img.mode in ('P',): # See the Pillow documentation for Image.convert() # https://pillow.readthedocs.io/en/stable/reference/Image.html#PIL.Image.Image.convert img = img.convert() if self.config.epub_max_image_width > 0: (width, height) = img.size nw = self.config.epub_max_image_width if width > nw: nh = (height * nw) / width img = img.resize((nw, nh), Image.BICUBIC) try: img.save(path.join(self.outdir, self.imagedir, dest)) except OSError as err: logger.warning(__('cannot write image file %r: %s'), path.join(self.srcdir, src), err) def copy_image_files(self) -> None: """Copy image files to destination directory. This overwritten method can use Pillow to convert image files. """ if self.images: if self.config.epub_fix_images or self.config.epub_max_image_width: if not Image: logger.warning(__('Pillow not found - copying image files')) super().copy_image_files() else: self.copy_image_files_pil() else: super().copy_image_files() def copy_download_files(self) -> None: pass def handle_page(self, pagename: str, addctx: Dict, templatename: str = 'page.html', outfilename: str = None, event_arg: Any = None) -> None: """Create a rendered page. This method is overwritten for genindex pages in order to fix href link attributes. """ if pagename.startswith('genindex') and 'genindexentries' in addctx: if not self.use_index: return self.fix_genindex(addctx['genindexentries']) addctx['doctype'] = self.doctype super().handle_page(pagename, addctx, templatename, outfilename, event_arg) def build_mimetype(self) -> None: """Write the metainfo file mimetype.""" logger.info(__('writing mimetype file...')) copy_asset_file(path.join(self.template_dir, 'mimetype'), self.outdir) def build_container(self, outname: str = 'META-INF/container.xml') -> None: # NOQA """Write the metainfo file META-INF/container.xml.""" logger.info(__('writing META-INF/container.xml file...')) outdir = path.join(self.outdir, 'META-INF') ensuredir(outdir) copy_asset_file(path.join(self.template_dir, 'container.xml'), outdir) def content_metadata(self) -> Dict[str, Any]: """Create a dictionary with all metadata for the content.opf file properly escaped. """ metadata: Dict[str, Any] = {} metadata['title'] = html.escape(self.config.epub_title) metadata['author'] = html.escape(self.config.epub_author) metadata['uid'] = html.escape(self.config.epub_uid) metadata['lang'] = html.escape(self.config.epub_language) metadata['publisher'] = html.escape(self.config.epub_publisher) metadata['copyright'] = html.escape(self.config.epub_copyright) metadata['scheme'] = html.escape(self.config.epub_scheme) metadata['id'] = html.escape(self.config.epub_identifier) metadata['date'] = html.escape(format_date("%Y-%m-%d")) metadata['manifest_items'] = [] metadata['spines'] = [] metadata['guides'] = [] return metadata def build_content(self) -> None: """Write the metainfo file content.opf It contains bibliographic data, a file list and the spine (the reading order). """ logger.info(__('writing content.opf file...')) metadata = self.content_metadata() # files if not self.outdir.endswith(os.sep): self.outdir += os.sep olen = len(self.outdir) self.files: List[str] = [] self.ignored_files = ['.buildinfo', 'mimetype', 'content.opf', 'toc.ncx', 'META-INF/container.xml', 'Thumbs.db', 'ehthumbs.db', '.DS_Store', 'nav.xhtml', self.config.epub_basename + '.epub'] + \ self.config.epub_exclude_files if not self.use_index: self.ignored_files.append('genindex' + self.out_suffix) for root, dirs, files in os.walk(self.outdir): dirs.sort() for fn in sorted(files): filename = path.join(root, fn)[olen:] if filename in self.ignored_files: continue ext = path.splitext(filename)[-1] if ext not in self.media_types: # we always have JS and potentially OpenSearch files, don't # always warn about them if ext not in ('.js', '.xml'): logger.warning(__('unknown mimetype for %s, ignoring'), filename, type='epub', subtype='unknown_project_files') continue filename = filename.replace(os.sep, '/') item = ManifestItem(html.escape(filename), html.escape(self.make_id(filename)), html.escape(self.media_types[ext])) metadata['manifest_items'].append(item) self.files.append(filename) # spine spinefiles = set() for refnode in self.refnodes: if '#' in refnode['refuri']: continue if refnode['refuri'] in self.ignored_files: continue spine = Spine(html.escape(self.make_id(refnode['refuri'])), True) metadata['spines'].append(spine) spinefiles.add(refnode['refuri']) for info in self.domain_indices: spine = Spine(html.escape(self.make_id(info[0] + self.out_suffix)), True) metadata['spines'].append(spine) spinefiles.add(info[0] + self.out_suffix) if self.use_index: spine = Spine(html.escape(self.make_id('genindex' + self.out_suffix)), True) metadata['spines'].append(spine) spinefiles.add('genindex' + self.out_suffix) # add auto generated files for name in self.files: if name not in spinefiles and name.endswith(self.out_suffix): spine = Spine(html.escape(self.make_id(name)), False) metadata['spines'].append(spine) # add the optional cover html_tmpl = None if self.config.epub_cover: image, html_tmpl = self.config.epub_cover image = image.replace(os.sep, '/') metadata['cover'] = html.escape(self.make_id(image)) if html_tmpl: spine = Spine(html.escape(self.make_id(self.coverpage_name)), True) metadata['spines'].insert(0, spine) if self.coverpage_name not in self.files: ext = path.splitext(self.coverpage_name)[-1] self.files.append(self.coverpage_name) item = ManifestItem(html.escape(self.coverpage_name), html.escape(self.make_id(self.coverpage_name)), html.escape(self.media_types[ext])) metadata['manifest_items'].append(item) ctx = {'image': html.escape(image), 'title': self.config.project} self.handle_page( path.splitext(self.coverpage_name)[0], ctx, html_tmpl) spinefiles.add(self.coverpage_name) auto_add_cover = True auto_add_toc = True if self.config.epub_guide: for type, uri, title in self.config.epub_guide: file = uri.split('#')[0] if file not in self.files: self.files.append(file) if type == 'cover': auto_add_cover = False if type == 'toc': auto_add_toc = False metadata['guides'].append(Guide(html.escape(type), html.escape(title), html.escape(uri))) if auto_add_cover and html_tmpl: metadata['guides'].append(Guide('cover', self.guide_titles['cover'], html.escape(self.coverpage_name))) if auto_add_toc and self.refnodes: metadata['guides'].append(Guide('toc', self.guide_titles['toc'], html.escape(self.refnodes[0]['refuri']))) # write the project file copy_asset_file(path.join(self.template_dir, 'content.opf_t'), self.outdir, metadata) def new_navpoint(self, node: Dict[str, Any], level: int, incr: bool = True) -> NavPoint: """Create a new entry in the toc from the node at given level.""" # XXX Modifies the node if incr: self.playorder += 1 self.tocid += 1 return NavPoint('navPoint%d' % self.tocid, self.playorder, node['text'], node['refuri'], []) def build_navpoints(self, nodes: List[Dict[str, Any]]) -> List[NavPoint]: """Create the toc navigation structure. Subelements of a node are nested inside the navpoint. For nested nodes the parent node is reinserted in the subnav. """ navstack: List[NavPoint] = [] navstack.append(NavPoint('dummy', 0, '', '', [])) level = 0 lastnode = None for node in nodes: if not node['text']: continue file = node['refuri'].split('#')[0] if file in self.ignored_files: continue if node['level'] > self.config.epub_tocdepth: continue if node['level'] == level: navpoint = self.new_navpoint(node, level) navstack.pop() navstack[-1].children.append(navpoint) navstack.append(navpoint) elif node['level'] == level + 1: level += 1 if lastnode and self.config.epub_tocdup: # Insert starting point in subtoc with same playOrder navstack[-1].children.append(self.new_navpoint(lastnode, level, False)) navpoint = self.new_navpoint(node, level) navstack[-1].children.append(navpoint) navstack.append(navpoint) elif node['level'] < level: while node['level'] < len(navstack): navstack.pop() level = node['level'] navpoint = self.new_navpoint(node, level) navstack[-1].children.append(navpoint) navstack.append(navpoint) else: raise lastnode = node return navstack[0].children def toc_metadata(self, level: int, navpoints: List[NavPoint]) -> Dict[str, Any]: """Create a dictionary with all metadata for the toc.ncx file properly escaped. """ metadata: Dict[str, Any] = {} metadata['uid'] = self.config.epub_uid metadata['title'] = html.escape(self.config.epub_title) metadata['level'] = level metadata['navpoints'] = navpoints return metadata def build_toc(self) -> None: """Write the metainfo file toc.ncx.""" logger.info(__('writing toc.ncx file...')) if self.config.epub_tocscope == 'default': doctree = self.env.get_and_resolve_doctree(self.config.root_doc, self, prune_toctrees=False, includehidden=False) refnodes = self.get_refnodes(doctree, []) self.toc_add_files(refnodes) else: # 'includehidden' refnodes = self.refnodes self.check_refnodes(refnodes) navpoints = self.build_navpoints(refnodes) level = max(item['level'] for item in self.refnodes) level = min(level, self.config.epub_tocdepth) copy_asset_file(path.join(self.template_dir, 'toc.ncx_t'), self.outdir, self.toc_metadata(level, navpoints)) def build_epub(self) -> None: """Write the epub file. It is a zip file with the mimetype file stored uncompressed as the first entry. """ outname = self.config.epub_basename + '.epub' logger.info(__('writing %s file...'), outname) epub_filename = path.join(self.outdir, outname) with ZipFile(epub_filename, 'w', ZIP_DEFLATED) as epub: epub.write(path.join(self.outdir, 'mimetype'), 'mimetype', ZIP_STORED) for filename in ['META-INF/container.xml', 'content.opf', 'toc.ncx']: epub.write(path.join(self.outdir, filename), filename, ZIP_DEFLATED) for filename in self.files: epub.write(path.join(self.outdir, filename), filename, ZIP_DEFLATED) ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/changes.py�������������������������������������������������������������0000644�0000766�0000024�00000015212�00000000000�017440� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.changes ~~~~~~~~~~~~~~~~~~~~~~~ Changelog builder. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import html from os import path from typing import Any, Dict, List, Tuple, cast from sphinx import package_dir from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.domains.changeset import ChangeSetDomain from sphinx.locale import _, __ from sphinx.theming import HTMLThemeFactory from sphinx.util import logging from sphinx.util.console import bold # type: ignore from sphinx.util.fileutil import copy_asset_file from sphinx.util.osutil import ensuredir, os_path logger = logging.getLogger(__name__) class ChangesBuilder(Builder): """ Write a summary with all versionadded/changed directives. """ name = 'changes' epilog = __('The overview file is in %(outdir)s.') def init(self) -> None: self.create_template_bridge() theme_factory = HTMLThemeFactory(self.app) self.theme = theme_factory.create('default') self.templates.init(self, self.theme) def get_outdated_docs(self) -> str: return self.outdir typemap = { 'versionadded': 'added', 'versionchanged': 'changed', 'deprecated': 'deprecated', } def write(self, *ignored: Any) -> None: version = self.config.version domain = cast(ChangeSetDomain, self.env.get_domain('changeset')) libchanges: Dict[str, List[Tuple[str, str, int]]] = {} apichanges: List[Tuple[str, str, int]] = [] otherchanges: Dict[Tuple[str, str], List[Tuple[str, str, int]]] = {} changesets = domain.get_changesets_for(version) if not changesets: logger.info(bold(__('no changes in version %s.') % version)) return logger.info(bold(__('writing summary file...'))) for changeset in changesets: if isinstance(changeset.descname, tuple): descname = changeset.descname[0] else: descname = changeset.descname ttext = self.typemap[changeset.type] context = changeset.content.replace('\n', ' ') if descname and changeset.docname.startswith('c-api'): if context: entry = '<b>%s</b>: <i>%s:</i> %s' % (descname, ttext, context) else: entry = '<b>%s</b>: <i>%s</i>.' % (descname, ttext) apichanges.append((entry, changeset.docname, changeset.lineno)) elif descname or changeset.module: module = changeset.module or _('Builtins') if not descname: descname = _('Module level') if context: entry = '<b>%s</b>: <i>%s:</i> %s' % (descname, ttext, context) else: entry = '<b>%s</b>: <i>%s</i>.' % (descname, ttext) libchanges.setdefault(module, []).append((entry, changeset.docname, changeset.lineno)) else: if not context: continue entry = '<i>%s:</i> %s' % (ttext.capitalize(), context) title = self.env.titles[changeset.docname].astext() otherchanges.setdefault((changeset.docname, title), []).append( (entry, changeset.docname, changeset.lineno)) ctx = { 'project': self.config.project, 'version': version, 'docstitle': self.config.html_title, 'shorttitle': self.config.html_short_title, 'libchanges': sorted(libchanges.items()), 'apichanges': sorted(apichanges), 'otherchanges': sorted(otherchanges.items()), 'show_copyright': self.config.html_show_copyright, 'show_sphinx': self.config.html_show_sphinx, } with open(path.join(self.outdir, 'index.html'), 'w', encoding='utf8') as f: f.write(self.templates.render('changes/frameset.html', ctx)) with open(path.join(self.outdir, 'changes.html'), 'w', encoding='utf8') as f: f.write(self.templates.render('changes/versionchanges.html', ctx)) hltext = ['.. versionadded:: %s' % version, '.. versionchanged:: %s' % version, '.. deprecated:: %s' % version] def hl(no: int, line: str) -> str: line = '<a name="L%s"> </a>' % no + html.escape(line) for x in hltext: if x in line: line = '<span class="hl">%s</span>' % line break return line logger.info(bold(__('copying source files...'))) for docname in self.env.all_docs: with open(self.env.doc2path(docname), encoding=self.env.config.source_encoding) as f: try: lines = f.readlines() except UnicodeDecodeError: logger.warning(__('could not read %r for changelog creation'), docname) continue targetfn = path.join(self.outdir, 'rst', os_path(docname)) + '.html' ensuredir(path.dirname(targetfn)) with open(targetfn, 'w', encoding='utf-8') as f: text = ''.join(hl(i + 1, line) for (i, line) in enumerate(lines)) ctx = { 'filename': self.env.doc2path(docname, None), 'text': text } f.write(self.templates.render('changes/rstsource.html', ctx)) themectx = {'theme_' + key: val for (key, val) in self.theme.get_options({}).items()} copy_asset_file(path.join(package_dir, 'themes', 'default', 'static', 'default.css_t'), self.outdir, context=themectx, renderer=self.templates) copy_asset_file(path.join(package_dir, 'themes', 'basic', 'static', 'basic.css'), self.outdir) def hl(self, text: str, version: str) -> str: text = html.escape(text) for directive in ['versionchanged', 'versionadded', 'deprecated']: text = text.replace('.. %s:: %s' % (directive, version), '<b>.. %s:: %s</b>' % (directive, version)) return text def finish(self) -> None: pass def setup(app: Sphinx) -> Dict[str, Any]: app.add_builder(ChangesBuilder) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/dirhtml.py�������������������������������������������������������������0000644�0000766�0000024�00000003154�00000000000�017475� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.dirhtml ~~~~~~~~~~~~~~~~~~~~~~~ Directory HTML builders. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from os import path from typing import Any, Dict from sphinx.application import Sphinx from sphinx.builders.html import StandaloneHTMLBuilder from sphinx.util import logging from sphinx.util.osutil import SEP, os_path logger = logging.getLogger(__name__) class DirectoryHTMLBuilder(StandaloneHTMLBuilder): """ A StandaloneHTMLBuilder that creates all HTML pages as "index.html" in a directory given by their pagename, so that generated URLs don't have ``.html`` in them. """ name = 'dirhtml' def get_target_uri(self, docname: str, typ: str = None) -> str: if docname == 'index': return '' if docname.endswith(SEP + 'index'): return docname[:-5] # up to sep return docname + SEP def get_outfilename(self, pagename: str) -> str: if pagename == 'index' or pagename.endswith(SEP + 'index'): outfilename = path.join(self.outdir, os_path(pagename) + self.out_suffix) else: outfilename = path.join(self.outdir, os_path(pagename), 'index' + self.out_suffix) return outfilename def setup(app: Sphinx) -> Dict[str, Any]: app.setup_extension('sphinx.builders.html') app.add_builder(DirectoryHTMLBuilder) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/dummy.py���������������������������������������������������������������0000644�0000766�0000024�00000002143�00000000000�017162� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.dummy ~~~~~~~~~~~~~~~~~~~~~ Do syntax checks, but no writing. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Any, Dict, Set from docutils.nodes import Node from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.locale import __ class DummyBuilder(Builder): name = 'dummy' epilog = __('The dummy builder generates no files.') allow_parallel = True def init(self) -> None: pass def get_outdated_docs(self) -> Set[str]: return self.env.found_docs def get_target_uri(self, docname: str, typ: str = None) -> str: return '' def prepare_writing(self, docnames: Set[str]) -> None: pass def write_doc(self, docname: str, doctree: Node) -> None: pass def finish(self) -> None: pass def setup(app: Sphinx) -> Dict[str, Any]: app.add_builder(DummyBuilder) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/epub3.py���������������������������������������������������������������0000644�0000766�0000024�00000025304�00000000000�017051� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.epub3 ~~~~~~~~~~~~~~~~~~~~~ Build epub3 files. Originally derived from epub.py. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import html from os import path from typing import Any, Dict, List, NamedTuple, Set, Tuple from sphinx import package_dir from sphinx.application import Sphinx from sphinx.builders import _epub_base from sphinx.config import ENUM, Config from sphinx.locale import __ from sphinx.util import logging, xmlname_checker from sphinx.util.fileutil import copy_asset_file from sphinx.util.i18n import format_date from sphinx.util.osutil import make_filename logger = logging.getLogger(__name__) class NavPoint(NamedTuple): text: str refuri: str children: List[Any] # mypy does not support recursive types # https://github.com/python/mypy/issues/7069 # writing modes PAGE_PROGRESSION_DIRECTIONS = { 'horizontal': 'ltr', 'vertical': 'rtl', } IBOOK_SCROLL_AXIS = { 'horizontal': 'vertical', 'vertical': 'horizontal', } THEME_WRITING_MODES = { 'vertical': 'vertical-rl', 'horizontal': 'horizontal-tb', } DOCTYPE = '''<!DOCTYPE html>''' HTML_TAG = ( '<html xmlns="http://www.w3.org/1999/xhtml" ' 'xmlns:epub="http://www.idpf.org/2007/ops">' ) class Epub3Builder(_epub_base.EpubBuilder): """ Builder that outputs epub3 files. It creates the metainfo files content.opf, nav.xhtml, toc.ncx, mimetype, and META-INF/container.xml. Afterwards, all necessary files are zipped to an epub file. """ name = 'epub' epilog = __('The ePub file is in %(outdir)s.') supported_remote_images = False template_dir = path.join(package_dir, 'templates', 'epub3') doctype = DOCTYPE html_tag = HTML_TAG use_meta_charset = True # Finish by building the epub file def handle_finish(self) -> None: """Create the metainfo files and finally the epub.""" self.get_toc() self.build_mimetype() self.build_container() self.build_content() self.build_navigation_doc() self.build_toc() self.build_epub() def content_metadata(self) -> Dict: """Create a dictionary with all metadata for the content.opf file properly escaped. """ writing_mode = self.config.epub_writing_mode metadata = super().content_metadata() metadata['description'] = html.escape(self.config.epub_description) metadata['contributor'] = html.escape(self.config.epub_contributor) metadata['page_progression_direction'] = PAGE_PROGRESSION_DIRECTIONS.get(writing_mode) metadata['ibook_scroll_axis'] = IBOOK_SCROLL_AXIS.get(writing_mode) metadata['date'] = html.escape(format_date("%Y-%m-%dT%H:%M:%SZ")) metadata['version'] = html.escape(self.config.version) metadata['epub_version'] = self.config.epub_version return metadata def prepare_writing(self, docnames: Set[str]) -> None: super().prepare_writing(docnames) writing_mode = self.config.epub_writing_mode self.globalcontext['theme_writing_mode'] = THEME_WRITING_MODES.get(writing_mode) self.globalcontext['html_tag'] = self.html_tag self.globalcontext['use_meta_charset'] = self.use_meta_charset self.globalcontext['skip_ua_compatible'] = True def build_navlist(self, navnodes: List[Dict[str, Any]]) -> List[NavPoint]: """Create the toc navigation structure. This method is almost same as build_navpoints method in epub.py. This is because the logical navigation structure of epub3 is not different from one of epub2. The difference from build_navpoints method is templates which are used when generating navigation documents. """ navstack: List[NavPoint] = [] navstack.append(NavPoint('', '', [])) level = 0 for node in navnodes: if not node['text']: continue file = node['refuri'].split('#')[0] if file in self.ignored_files: continue if node['level'] > self.config.epub_tocdepth: continue navpoint = NavPoint(node['text'], node['refuri'], []) if node['level'] == level: navstack.pop() navstack[-1].children.append(navpoint) navstack.append(navpoint) elif node['level'] == level + 1: level += 1 navstack[-1].children.append(navpoint) navstack.append(navpoint) elif node['level'] < level: while node['level'] < len(navstack): navstack.pop() level = node['level'] navstack[-1].children.append(navpoint) navstack.append(navpoint) else: raise RuntimeError('Should never reach here. It might be a bug.') return navstack[0].children def navigation_doc_metadata(self, navlist: List[NavPoint]) -> Dict: """Create a dictionary with all metadata for the nav.xhtml file properly escaped. """ metadata: Dict = {} metadata['lang'] = html.escape(self.config.epub_language) metadata['toc_locale'] = html.escape(self.guide_titles['toc']) metadata['navlist'] = navlist return metadata def build_navigation_doc(self) -> None: """Write the metainfo file nav.xhtml.""" logger.info(__('writing nav.xhtml file...')) if self.config.epub_tocscope == 'default': doctree = self.env.get_and_resolve_doctree( self.config.root_doc, self, prune_toctrees=False, includehidden=False) refnodes = self.get_refnodes(doctree, []) self.toc_add_files(refnodes) else: # 'includehidden' refnodes = self.refnodes navlist = self.build_navlist(refnodes) copy_asset_file(path.join(self.template_dir, 'nav.xhtml_t'), self.outdir, self.navigation_doc_metadata(navlist)) # Add nav.xhtml to epub file if 'nav.xhtml' not in self.files: self.files.append('nav.xhtml') def validate_config_values(app: Sphinx) -> None: if app.builder.name != 'epub': return # <package> lang attribute, dc:language if not app.config.epub_language: logger.warning(__('conf value "epub_language" (or "language") ' 'should not be empty for EPUB3')) # <package> unique-identifier attribute if not xmlname_checker().match(app.config.epub_uid): logger.warning(__('conf value "epub_uid" should be XML NAME for EPUB3')) # dc:title if not app.config.epub_title: logger.warning(__('conf value "epub_title" (or "html_title") ' 'should not be empty for EPUB3')) # dc:creator if not app.config.epub_author: logger.warning(__('conf value "epub_author" should not be empty for EPUB3')) # dc:contributor if not app.config.epub_contributor: logger.warning(__('conf value "epub_contributor" should not be empty for EPUB3')) # dc:description if not app.config.epub_description: logger.warning(__('conf value "epub_description" should not be empty for EPUB3')) # dc:publisher if not app.config.epub_publisher: logger.warning(__('conf value "epub_publisher" should not be empty for EPUB3')) # dc:rights if not app.config.epub_copyright: logger.warning(__('conf value "epub_copyright" (or "copyright")' 'should not be empty for EPUB3')) # dc:identifier if not app.config.epub_identifier: logger.warning(__('conf value "epub_identifier" should not be empty for EPUB3')) # meta ibooks:version if not app.config.version: logger.warning(__('conf value "version" should not be empty for EPUB3')) def convert_epub_css_files(app: Sphinx, config: Config) -> None: """This converts string styled epub_css_files to tuple styled one.""" epub_css_files: List[Tuple[str, Dict]] = [] for entry in config.epub_css_files: if isinstance(entry, str): epub_css_files.append((entry, {})) else: try: filename, attrs = entry epub_css_files.append((filename, attrs)) except Exception: logger.warning(__('invalid css_file: %r, ignored'), entry) continue config.epub_css_files = epub_css_files # type: ignore def setup(app: Sphinx) -> Dict[str, Any]: app.add_builder(Epub3Builder) # config values app.add_config_value('epub_basename', lambda self: make_filename(self.project), None) app.add_config_value('epub_version', 3.0, 'epub') # experimental app.add_config_value('epub_theme', 'epub', 'epub') app.add_config_value('epub_theme_options', {}, 'epub') app.add_config_value('epub_title', lambda self: self.project, 'epub') app.add_config_value('epub_author', lambda self: self.author, 'epub') app.add_config_value('epub_language', lambda self: self.language or 'en', 'epub') app.add_config_value('epub_publisher', lambda self: self.author, 'epub') app.add_config_value('epub_copyright', lambda self: self.copyright, 'epub') app.add_config_value('epub_identifier', 'unknown', 'epub') app.add_config_value('epub_scheme', 'unknown', 'epub') app.add_config_value('epub_uid', 'unknown', 'env') app.add_config_value('epub_cover', (), 'env') app.add_config_value('epub_guide', (), 'env') app.add_config_value('epub_pre_files', [], 'env') app.add_config_value('epub_post_files', [], 'env') app.add_config_value('epub_css_files', lambda config: config.html_css_files, 'epub') app.add_config_value('epub_exclude_files', [], 'env') app.add_config_value('epub_tocdepth', 3, 'env') app.add_config_value('epub_tocdup', True, 'env') app.add_config_value('epub_tocscope', 'default', 'env') app.add_config_value('epub_fix_images', False, 'env') app.add_config_value('epub_max_image_width', 0, 'env') app.add_config_value('epub_show_urls', 'inline', 'epub') app.add_config_value('epub_use_index', lambda self: self.html_use_index, 'epub') app.add_config_value('epub_description', 'unknown', 'epub') app.add_config_value('epub_contributor', 'unknown', 'epub') app.add_config_value('epub_writing_mode', 'horizontal', 'epub', ENUM('horizontal', 'vertical')) # event handlers app.connect('config-inited', convert_epub_css_files, priority=800) app.connect('builder-inited', validate_config_values) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902837.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/gettext.py�������������������������������������������������������������0000644�0000766�0000024�00000026224�00000000000�017521� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.gettext ~~~~~~~~~~~~~~~~~~~~~~~ The MessageCatalogBuilder class. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from codecs import open from collections import OrderedDict, defaultdict from datetime import datetime, timedelta, tzinfo from os import getenv, path, walk from time import time from typing import Any, DefaultDict, Dict, Generator, Iterable, List, Set, Tuple, Union from uuid import uuid4 from docutils import nodes from docutils.nodes import Element from sphinx import addnodes, package_dir from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.domains.python import pairindextypes from sphinx.errors import ThemeError from sphinx.locale import __ from sphinx.util import logging, split_index_msg, status_iterator from sphinx.util.console import bold # type: ignore from sphinx.util.i18n import CatalogInfo, docname_to_domain from sphinx.util.nodes import extract_messages, traverse_translatable_index from sphinx.util.osutil import canon_path, ensuredir, relpath from sphinx.util.tags import Tags from sphinx.util.template import SphinxRenderer logger = logging.getLogger(__name__) class Message: """An entry of translatable message.""" def __init__(self, text: str, locations: List[Tuple[str, int]], uuids: List[str]): self.text = text self.locations = locations self.uuids = uuids class Catalog: """Catalog of translatable messages.""" def __init__(self) -> None: self.messages: List[str] = [] # retain insertion order, a la OrderedDict # msgid -> file, line, uid self.metadata: Dict[str, List[Tuple[str, int, str]]] = OrderedDict() def add(self, msg: str, origin: Union[Element, "MsgOrigin"]) -> None: if not hasattr(origin, 'uid'): # Nodes that are replicated like todo don't have a uid, # however i18n is also unnecessary. return if msg not in self.metadata: # faster lookup in hash self.messages.append(msg) self.metadata[msg] = [] self.metadata[msg].append((origin.source, origin.line, origin.uid)) # type: ignore def __iter__(self) -> Generator[Message, None, None]: for message in self.messages: positions = [(source, line) for source, line, uuid in self.metadata[message]] uuids = [uuid for source, line, uuid in self.metadata[message]] yield Message(message, positions, uuids) class MsgOrigin: """ Origin holder for Catalog message origin. """ def __init__(self, source: str, line: int) -> None: self.source = source self.line = line self.uid = uuid4().hex class GettextRenderer(SphinxRenderer): def __init__(self, template_path: str = None, outdir: str = None) -> None: self.outdir = outdir if template_path is None: template_path = path.join(package_dir, 'templates', 'gettext') super().__init__(template_path) def escape(s: str) -> str: s = s.replace('\\', r'\\') s = s.replace('"', r'\"') return s.replace('\n', '\\n"\n"') # use texescape as escape filter self.env.filters['e'] = escape self.env.filters['escape'] = escape def render(self, filename: str, context: Dict) -> str: def _relpath(s: str) -> str: return canon_path(relpath(s, self.outdir)) context['relpath'] = _relpath return super().render(filename, context) class I18nTags(Tags): """Dummy tags module for I18nBuilder. To translate all text inside of only nodes, this class always returns True value even if no tags are defined. """ def eval_condition(self, condition: Any) -> bool: return True class I18nBuilder(Builder): """ General i18n builder. """ name = 'i18n' versioning_method = 'text' versioning_compare: bool = None # be set by `gettext_uuid` use_message_catalog = False def init(self) -> None: super().init() self.env.set_versioning_method(self.versioning_method, self.env.config.gettext_uuid) self.tags = I18nTags() self.catalogs: DefaultDict[str, Catalog] = defaultdict(Catalog) def get_target_uri(self, docname: str, typ: str = None) -> str: return '' def get_outdated_docs(self) -> Set[str]: return self.env.found_docs def prepare_writing(self, docnames: Set[str]) -> None: return def compile_catalogs(self, catalogs: Set[CatalogInfo], message: str) -> None: return def write_doc(self, docname: str, doctree: nodes.document) -> None: catalog = self.catalogs[docname_to_domain(docname, self.config.gettext_compact)] for toctree in self.env.tocs[docname].traverse(addnodes.toctree): for node, msg in extract_messages(toctree): node.uid = '' # type: ignore # Hack UUID model catalog.add(msg, node) for node, msg in extract_messages(doctree): catalog.add(msg, node) if 'index' in self.env.config.gettext_additional_targets: # Extract translatable messages from index entries. for node, entries in traverse_translatable_index(doctree): for typ, msg, tid, main, key_ in entries: for m in split_index_msg(typ, msg): if typ == 'pair' and m in pairindextypes.values(): # avoid built-in translated message was incorporated # in 'sphinx.util.nodes.process_index_entry' continue catalog.add(m, node) # determine tzoffset once to remain unaffected by DST change during build timestamp = time() tzdelta = datetime.fromtimestamp(timestamp) - \ datetime.utcfromtimestamp(timestamp) # set timestamp from SOURCE_DATE_EPOCH if set # see https://reproducible-builds.org/specs/source-date-epoch/ source_date_epoch = getenv('SOURCE_DATE_EPOCH') if source_date_epoch is not None: timestamp = float(source_date_epoch) tzdelta = timedelta(0) class LocalTimeZone(tzinfo): def __init__(self, *args: Any, **kwargs: Any) -> None: super().__init__(*args, **kwargs) self.tzdelta = tzdelta def utcoffset(self, dt: datetime) -> timedelta: return self.tzdelta def dst(self, dt: datetime) -> timedelta: return timedelta(0) ltz = LocalTimeZone() def should_write(filepath: str, new_content: str) -> bool: if not path.exists(filepath): return True try: with open(filepath, encoding='utf-8') as oldpot: old_content = oldpot.read() old_header_index = old_content.index('"POT-Creation-Date:') new_header_index = new_content.index('"POT-Creation-Date:') old_body_index = old_content.index('"PO-Revision-Date:') new_body_index = new_content.index('"PO-Revision-Date:') return ((old_content[:old_header_index] != new_content[:new_header_index]) or (new_content[new_body_index:] != old_content[old_body_index:])) except ValueError: pass return True class MessageCatalogBuilder(I18nBuilder): """ Builds gettext-style message catalogs (.pot files). """ name = 'gettext' epilog = __('The message catalogs are in %(outdir)s.') def init(self) -> None: super().init() self.create_template_bridge() self.templates.init(self) def _collect_templates(self) -> Set[str]: template_files = set() for template_path in self.config.templates_path: tmpl_abs_path = path.join(self.app.srcdir, template_path) for dirpath, dirs, files in walk(tmpl_abs_path): for fn in files: if fn.endswith('.html'): filename = canon_path(path.join(dirpath, fn)) template_files.add(filename) return template_files def _extract_from_template(self) -> None: files = list(self._collect_templates()) files.sort() logger.info(bold(__('building [%s]: ') % self.name), nonl=True) logger.info(__('targets for %d template files'), len(files)) extract_translations = self.templates.environment.extract_translations for template in status_iterator(files, __('reading templates... '), "purple", len(files), self.app.verbosity): try: with open(template, encoding='utf-8') as f: context = f.read() for line, meth, msg in extract_translations(context): origin = MsgOrigin(template, line) self.catalogs['sphinx'].add(msg, origin) except Exception as exc: raise ThemeError('%s: %r' % (template, exc)) from exc def build(self, docnames: Iterable[str], summary: str = None, method: str = 'update') -> None: # NOQA self._extract_from_template() super().build(docnames, summary, method) def finish(self) -> None: super().finish() context = { 'version': self.config.version, 'copyright': self.config.copyright, 'project': self.config.project, 'last_translator': self.config.gettext_last_translator, 'language_team': self.config.gettext_language_team, 'ctime': datetime.fromtimestamp(timestamp, ltz).strftime('%Y-%m-%d %H:%M%z'), 'display_location': self.config.gettext_location, 'display_uuid': self.config.gettext_uuid, } for textdomain, catalog in status_iterator(self.catalogs.items(), __("writing message catalogs... "), "darkgreen", len(self.catalogs), self.app.verbosity, lambda textdomain__: textdomain__[0]): # noop if config.gettext_compact is set ensuredir(path.join(self.outdir, path.dirname(textdomain))) context['messages'] = list(catalog) content = GettextRenderer(outdir=self.outdir).render('message.pot_t', context) pofn = path.join(self.outdir, textdomain + '.pot') if should_write(pofn, content): with open(pofn, 'w', encoding='utf-8') as pofile: pofile.write(content) def setup(app: Sphinx) -> Dict[str, Any]: app.add_builder(MessageCatalogBuilder) app.add_config_value('gettext_compact', True, 'gettext', {bool, str}) app.add_config_value('gettext_location', True, 'gettext') app.add_config_value('gettext_uuid', False, 'gettext') app.add_config_value('gettext_auto_build', True, 'env') app.add_config_value('gettext_additional_targets', [], 'env') app.add_config_value('gettext_last_translator', 'FULL NAME <EMAIL@ADDRESS>', 'gettext') app.add_config_value('gettext_language_team', 'LANGUAGE <LL@li.org>', 'gettext') return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4481955 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/html/������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016421� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/html/__init__.py�������������������������������������������������������0000644�0000766�0000024�00000160506�00000000000�020542� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.html ~~~~~~~~~~~~~~~~~~~~ Several HTML builders. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import html import os import posixpath import re import sys from datetime import datetime from os import path from typing import IO, Any, Dict, Iterable, Iterator, List, Set, Tuple, Type from urllib.parse import quote from docutils import nodes from docutils.core import publish_parts from docutils.frontend import OptionParser from docutils.io import DocTreeInput, StringOutput from docutils.nodes import Node from docutils.utils import relative_path from sphinx import __display_version__, package_dir from sphinx import version_info as sphinx_version from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.config import ENUM, Config from sphinx.domains import Domain, Index, IndexEntry from sphinx.environment.adapters.asset import ImageAdapter from sphinx.environment.adapters.indexentries import IndexEntries from sphinx.environment.adapters.toctree import TocTree from sphinx.errors import ConfigError, ThemeError from sphinx.highlighting import PygmentsBridge from sphinx.locale import _, __ from sphinx.search import js_index from sphinx.theming import HTMLThemeFactory from sphinx.util import isurl, logging, md5, progress_message, status_iterator from sphinx.util.docutils import is_html5_writer_available, new_document from sphinx.util.fileutil import copy_asset from sphinx.util.i18n import format_date from sphinx.util.inventory import InventoryFile from sphinx.util.matching import DOTFILES, Matcher, patmatch from sphinx.util.osutil import copyfile, ensuredir, os_path, relative_uri from sphinx.util.tags import Tags from sphinx.writers.html import HTMLTranslator, HTMLWriter # HTML5 Writer is available or not if is_html5_writer_available(): from sphinx.writers.html5 import HTML5Translator html5_ready = True else: html5_ready = False #: the filename for the inventory of objects INVENTORY_FILENAME = 'objects.inv' logger = logging.getLogger(__name__) return_codes_re = re.compile('[\r\n]+') def get_stable_hash(obj: Any) -> str: """ Return a stable hash for a Python data structure. We can't just use the md5 of str(obj) since for example dictionary items are enumerated in unpredictable order due to hash randomization in newer Pythons. """ if isinstance(obj, dict): return get_stable_hash(list(obj.items())) elif isinstance(obj, (list, tuple)): obj = sorted(get_stable_hash(o) for o in obj) return md5(str(obj).encode()).hexdigest() class Stylesheet(str): """A metadata of stylesheet. To keep compatibility with old themes, an instance of stylesheet behaves as its filename (str). """ attributes: Dict[str, str] = None filename: str = None priority: int = None def __new__(cls, filename: str, *args: str, priority: int = 500, **attributes: Any ) -> "Stylesheet": self = str.__new__(cls, filename) self.filename = filename self.priority = priority self.attributes = attributes self.attributes.setdefault('rel', 'stylesheet') self.attributes.setdefault('type', 'text/css') if args: # old style arguments (rel, title) self.attributes['rel'] = args[0] self.attributes['title'] = args[1] return self class JavaScript(str): """A metadata of javascript file. To keep compatibility with old themes, an instance of javascript behaves as its filename (str). """ attributes: Dict[str, str] = None filename: str = None priority: int = None def __new__(cls, filename: str, priority: int = 500, **attributes: str) -> "JavaScript": self = str.__new__(cls, filename) self.filename = filename self.priority = priority self.attributes = attributes return self class BuildInfo: """buildinfo file manipulator. HTMLBuilder and its family are storing their own envdata to ``.buildinfo``. This class is a manipulator for the file. """ @classmethod def load(cls, f: IO) -> "BuildInfo": try: lines = f.readlines() assert lines[0].rstrip() == '# Sphinx build info version 1' assert lines[2].startswith('config: ') assert lines[3].startswith('tags: ') build_info = BuildInfo() build_info.config_hash = lines[2].split()[1].strip() build_info.tags_hash = lines[3].split()[1].strip() return build_info except Exception as exc: raise ValueError(__('build info file is broken: %r') % exc) from exc def __init__(self, config: Config = None, tags: Tags = None, config_categories: List[str] = []) -> None: # NOQA self.config_hash = '' self.tags_hash = '' if config: values = {c.name: c.value for c in config.filter(config_categories)} self.config_hash = get_stable_hash(values) if tags: self.tags_hash = get_stable_hash(sorted(tags)) def __eq__(self, other: "BuildInfo") -> bool: # type: ignore return (self.config_hash == other.config_hash and self.tags_hash == other.tags_hash) def dump(self, f: IO) -> None: f.write('# Sphinx build info version 1\n' '# This file hashes the configuration used when building these files.' ' When it is not found, a full rebuild will be done.\n' 'config: %s\n' 'tags: %s\n' % (self.config_hash, self.tags_hash)) class StandaloneHTMLBuilder(Builder): """ Builds standalone HTML docs. """ name = 'html' format = 'html' epilog = __('The HTML pages are in %(outdir)s.') copysource = True allow_parallel = True out_suffix = '.html' link_suffix = '.html' # defaults to matching out_suffix indexer_format: Any = js_index indexer_dumps_unicode = True # create links to original images from images [True/False] html_scaled_image_link = True supported_image_types = ['image/svg+xml', 'image/png', 'image/gif', 'image/jpeg'] supported_remote_images = True supported_data_uri_images = True searchindex_filename = 'searchindex.js' add_permalinks = True allow_sharp_as_current_path = True embedded = False # for things like HTML help or Qt help: suppresses sidebar search = True # for things like HTML help and Apple help: suppress search use_index = False download_support = True # enable download role imgpath: str = None domain_indices: List[Tuple[str, Type[Index], List[Tuple[str, List[IndexEntry]]], bool]] = [] # NOQA def __init__(self, app: Sphinx) -> None: super().__init__(app) # CSS files self.css_files: List[Stylesheet] = [] # JS files self.script_files: List[JavaScript] = [] def init(self) -> None: self.build_info = self.create_build_info() # basename of images directory self.imagedir = '_images' # section numbers for headings in the currently visited document self.secnumbers: Dict[str, Tuple[int, ...]] = {} # currently written docname self.current_docname: str = None self.init_templates() self.init_highlighter() self.init_css_files() self.init_js_files() html_file_suffix = self.get_builder_config('file_suffix', 'html') if html_file_suffix is not None: self.out_suffix = html_file_suffix html_link_suffix = self.get_builder_config('link_suffix', 'html') if html_link_suffix is not None: self.link_suffix = html_link_suffix else: self.link_suffix = self.out_suffix self.use_index = self.get_builder_config('use_index', 'html') def create_build_info(self) -> BuildInfo: return BuildInfo(self.config, self.tags, ['html']) def _get_translations_js(self) -> str: candidates = [path.join(dir, self.config.language, 'LC_MESSAGES', 'sphinx.js') for dir in self.config.locale_dirs] + \ [path.join(package_dir, 'locale', self.config.language, 'LC_MESSAGES', 'sphinx.js'), path.join(sys.prefix, 'share/sphinx/locale', self.config.language, 'sphinx.js')] for jsfile in candidates: if path.isfile(jsfile): return jsfile return None def _get_style_filename(self) -> str: if self.config.html_style is not None: return self.config.html_style elif self.theme: return self.theme.get_config('theme', 'stylesheet') else: return 'default.css' def get_theme_config(self) -> Tuple[str, Dict]: return self.config.html_theme, self.config.html_theme_options def init_templates(self) -> None: theme_factory = HTMLThemeFactory(self.app) themename, themeoptions = self.get_theme_config() self.theme = theme_factory.create(themename) self.theme_options = themeoptions.copy() self.create_template_bridge() self.templates.init(self, self.theme) def init_highlighter(self) -> None: # determine Pygments style and create the highlighter if self.config.pygments_style is not None: style = self.config.pygments_style elif self.theme: style = self.theme.get_config('theme', 'pygments_style', 'none') else: style = 'sphinx' self.highlighter = PygmentsBridge('html', style) if self.theme: dark_style = self.theme.get_config('theme', 'pygments_dark_style', None) else: dark_style = None if dark_style is not None: self.dark_highlighter = PygmentsBridge('html', dark_style) self.app.add_css_file('pygments_dark.css', media='(prefers-color-scheme: dark)', id='pygments_dark_css') else: self.dark_highlighter = None def init_css_files(self) -> None: self.css_files = [] self.add_css_file('pygments.css', priority=200) self.add_css_file(self._get_style_filename(), priority=200) for filename, attrs in self.app.registry.css_files: self.add_css_file(filename, **attrs) for filename, attrs in self.get_builder_config('css_files', 'html'): attrs.setdefault('priority', 800) # User's CSSs are loaded after extensions' self.add_css_file(filename, **attrs) def add_css_file(self, filename: str, **kwargs: Any) -> None: if '://' not in filename: filename = posixpath.join('_static', filename) self.css_files.append(Stylesheet(filename, **kwargs)) def init_js_files(self) -> None: self.script_files = [] self.add_js_file('documentation_options.js', id="documentation_options", data_url_root='', priority=200) self.add_js_file('jquery.js', priority=200) self.add_js_file('underscore.js', priority=200) self.add_js_file('doctools.js', priority=200) for filename, attrs in self.app.registry.js_files: self.add_js_file(filename, **attrs) for filename, attrs in self.get_builder_config('js_files', 'html'): attrs.setdefault('priority', 800) # User's JSs are loaded after extensions' self.add_js_file(filename, **attrs) if self.config.language and self._get_translations_js(): self.add_js_file('translations.js') def add_js_file(self, filename: str, **kwargs: Any) -> None: if filename and '://' not in filename: filename = posixpath.join('_static', filename) self.script_files.append(JavaScript(filename, **kwargs)) @property def default_translator_class(self) -> Type[nodes.NodeVisitor]: # type: ignore if not html5_ready or self.config.html4_writer: return HTMLTranslator else: return HTML5Translator @property def math_renderer_name(self) -> str: name = self.get_builder_config('math_renderer', 'html') if name is not None: # use given name return name else: # not given: choose a math_renderer from registered ones as possible renderers = list(self.app.registry.html_inline_math_renderers) if len(renderers) == 1: # only default math_renderer (mathjax) is registered return renderers[0] elif len(renderers) == 2: # default and another math_renderer are registered; prior the another renderers.remove('mathjax') return renderers[0] else: # many math_renderers are registered. can't choose automatically! return None def get_outdated_docs(self) -> Iterator[str]: try: with open(path.join(self.outdir, '.buildinfo')) as fp: buildinfo = BuildInfo.load(fp) if self.build_info != buildinfo: logger.debug('[build target] did not match: build_info ') yield from self.env.found_docs return except ValueError as exc: logger.warning(__('Failed to read build info file: %r'), exc) except OSError: # ignore errors on reading pass if self.templates: template_mtime = self.templates.newest_template_mtime() else: template_mtime = 0 for docname in self.env.found_docs: if docname not in self.env.all_docs: logger.debug('[build target] did not in env: %r', docname) yield docname continue targetname = self.get_outfilename(docname) try: targetmtime = path.getmtime(targetname) except Exception: targetmtime = 0 try: srcmtime = max(path.getmtime(self.env.doc2path(docname)), template_mtime) if srcmtime > targetmtime: logger.debug( '[build target] targetname %r(%s), template(%s), docname %r(%s)', targetname, datetime.utcfromtimestamp(targetmtime), datetime.utcfromtimestamp(template_mtime), docname, datetime.utcfromtimestamp(path.getmtime(self.env.doc2path(docname))), ) yield docname except OSError: # source doesn't exist anymore pass def get_asset_paths(self) -> List[str]: return self.config.html_extra_path + self.config.html_static_path def render_partial(self, node: Node) -> Dict[str, str]: """Utility: Render a lone doctree node.""" if node is None: return {'fragment': ''} doc = new_document('<partial node>') doc.append(node) writer = HTMLWriter(self) return publish_parts(reader_name='doctree', writer=writer, source_class=DocTreeInput, settings_overrides={'output_encoding': 'unicode'}, source=doc) def prepare_writing(self, docnames: Set[str]) -> None: # create the search indexer self.indexer = None if self.search: from sphinx.search import IndexBuilder lang = self.config.html_search_language or self.config.language if not lang: lang = 'en' self.indexer = IndexBuilder(self.env, lang, self.config.html_search_options, self.config.html_search_scorer) self.load_indexer(docnames) self.docwriter = HTMLWriter(self) self.docsettings: Any = OptionParser( defaults=self.env.settings, components=(self.docwriter,), read_config_files=True).get_default_values() self.docsettings.compact_lists = bool(self.config.html_compact_lists) # determine the additional indices to include self.domain_indices = [] # html_domain_indices can be False/True or a list of index names indices_config = self.config.html_domain_indices if indices_config: for domain_name in sorted(self.env.domains): domain: Domain = self.env.domains[domain_name] for indexcls in domain.indices: indexname = '%s-%s' % (domain.name, indexcls.name) if isinstance(indices_config, list): if indexname not in indices_config: continue content, collapse = indexcls(domain).generate() if content: self.domain_indices.append( (indexname, indexcls, content, collapse)) # format the "last updated on" string, only once is enough since it # typically doesn't include the time of day lufmt = self.config.html_last_updated_fmt if lufmt is not None: self.last_updated = format_date(lufmt or _('%b %d, %Y'), language=self.config.language) else: self.last_updated = None # If the logo or favicon are urls, keep them as-is, otherwise # strip the relative path as the files will be copied into _static. logo = self.config.html_logo or '' favicon = self.config.html_favicon or '' if not isurl(logo): logo = path.basename(logo) if not isurl(favicon): favicon = path.basename(favicon) self.relations = self.env.collect_relations() rellinks: List[Tuple[str, str, str, str]] = [] if self.use_index: rellinks.append(('genindex', _('General Index'), 'I', _('index'))) for indexname, indexcls, content, collapse in self.domain_indices: # if it has a short name if indexcls.shortname: rellinks.append((indexname, indexcls.localname, '', indexcls.shortname)) # back up script_files and css_files to allow adding JS/CSS files to a specific page. self._script_files = list(self.script_files) self._css_files = list(self.css_files) self.globalcontext = { 'embedded': self.embedded, 'project': self.config.project, 'release': return_codes_re.sub('', self.config.release), 'version': self.config.version, 'last_updated': self.last_updated, 'copyright': self.config.copyright, 'master_doc': self.config.root_doc, 'root_doc': self.config.root_doc, 'use_opensearch': self.config.html_use_opensearch, 'docstitle': self.config.html_title, 'shorttitle': self.config.html_short_title, 'show_copyright': self.config.html_show_copyright, 'show_sphinx': self.config.html_show_sphinx, 'has_source': self.config.html_copy_source, 'show_source': self.config.html_show_sourcelink, 'sourcelink_suffix': self.config.html_sourcelink_suffix, 'file_suffix': self.out_suffix, 'link_suffix': self.link_suffix, 'script_files': self.script_files, 'language': self.config.language, 'css_files': self.css_files, 'sphinx_version': __display_version__, 'sphinx_version_tuple': sphinx_version, 'style': self._get_style_filename(), 'rellinks': rellinks, 'builder': self.name, 'parents': [], 'logo': logo, 'favicon': favicon, 'html5_doctype': html5_ready and not self.config.html4_writer, } if self.theme: self.globalcontext.update( ('theme_' + key, val) for (key, val) in self.theme.get_options(self.theme_options).items()) self.globalcontext.update(self.config.html_context) def get_doc_context(self, docname: str, body: str, metatags: str) -> Dict[str, Any]: """Collect items for the template context of a page.""" # find out relations prev = next = None parents = [] rellinks = self.globalcontext['rellinks'][:] related = self.relations.get(docname) titles = self.env.titles if related and related[2]: try: next = { 'link': self.get_relative_uri(docname, related[2]), 'title': self.render_partial(titles[related[2]])['title'] } rellinks.append((related[2], next['title'], 'N', _('next'))) except KeyError: next = None if related and related[1]: try: prev = { 'link': self.get_relative_uri(docname, related[1]), 'title': self.render_partial(titles[related[1]])['title'] } rellinks.append((related[1], prev['title'], 'P', _('previous'))) except KeyError: # the relation is (somehow) not in the TOC tree, handle # that gracefully prev = None while related and related[0]: try: parents.append( {'link': self.get_relative_uri(docname, related[0]), 'title': self.render_partial(titles[related[0]])['title']}) except KeyError: pass related = self.relations.get(related[0]) if parents: # remove link to the master file; we have a generic # "back to index" link already parents.pop() parents.reverse() # title rendered as HTML title_node = self.env.longtitles.get(docname) title = self.render_partial(title_node)['title'] if title_node else '' # Suffix for the document source_suffix = self.env.doc2path(docname, False)[len(docname):] # the name for the copied source if self.config.html_copy_source: sourcename = docname + source_suffix if source_suffix != self.config.html_sourcelink_suffix: sourcename += self.config.html_sourcelink_suffix else: sourcename = '' # metadata for the document meta = self.env.metadata.get(docname) # local TOC and global TOC tree self_toc = TocTree(self.env).get_toc_for(docname, self) toc = self.render_partial(self_toc)['fragment'] return { 'parents': parents, 'prev': prev, 'next': next, 'title': title, 'meta': meta, 'body': body, 'metatags': metatags, 'rellinks': rellinks, 'sourcename': sourcename, 'toc': toc, # only display a TOC if there's more than one item to show 'display_toc': (self.env.toc_num_entries[docname] > 1), 'page_source_suffix': source_suffix, } def write_doc(self, docname: str, doctree: nodes.document) -> None: destination = StringOutput(encoding='utf-8') doctree.settings = self.docsettings self.secnumbers = self.env.toc_secnumbers.get(docname, {}) self.fignumbers = self.env.toc_fignumbers.get(docname, {}) self.imgpath = relative_uri(self.get_target_uri(docname), '_images') self.dlpath = relative_uri(self.get_target_uri(docname), '_downloads') self.current_docname = docname self.docwriter.write(doctree, destination) self.docwriter.assemble_parts() body = self.docwriter.parts['fragment'] metatags = self.docwriter.clean_meta ctx = self.get_doc_context(docname, body, metatags) self.handle_page(docname, ctx, event_arg=doctree) def write_doc_serialized(self, docname: str, doctree: nodes.document) -> None: self.imgpath = relative_uri(self.get_target_uri(docname), self.imagedir) self.post_process_images(doctree) title_node = self.env.longtitles.get(docname) title = self.render_partial(title_node)['title'] if title_node else '' self.index_page(docname, doctree, title) def finish(self) -> None: self.finish_tasks.add_task(self.gen_indices) self.finish_tasks.add_task(self.gen_pages_from_extensions) self.finish_tasks.add_task(self.gen_additional_pages) self.finish_tasks.add_task(self.copy_image_files) self.finish_tasks.add_task(self.copy_download_files) self.finish_tasks.add_task(self.copy_static_files) self.finish_tasks.add_task(self.copy_extra_files) self.finish_tasks.add_task(self.write_buildinfo) # dump the search index self.handle_finish() @progress_message(__('generating indices')) def gen_indices(self) -> None: # the global general index if self.use_index: self.write_genindex() # the global domain-specific indices self.write_domain_indices() def gen_pages_from_extensions(self) -> None: # pages from extensions for pagelist in self.events.emit('html-collect-pages'): for pagename, context, template in pagelist: self.handle_page(pagename, context, template) @progress_message(__('writing additional pages')) def gen_additional_pages(self) -> None: # additional pages from conf.py for pagename, template in self.config.html_additional_pages.items(): logger.info(pagename + ' ', nonl=True) self.handle_page(pagename, {}, template) # the search page if self.search: logger.info('search ', nonl=True) self.handle_page('search', {}, 'search.html') # the opensearch xml file if self.config.html_use_opensearch and self.search: logger.info('opensearch ', nonl=True) fn = path.join(self.outdir, '_static', 'opensearch.xml') self.handle_page('opensearch', {}, 'opensearch.xml', outfilename=fn) def write_genindex(self) -> None: # the total count of lines for each index letter, used to distribute # the entries into two columns genindex = IndexEntries(self.env).create_index(self) indexcounts = [] for _k, entries in genindex: indexcounts.append(sum(1 + len(subitems) for _, (_, subitems, _) in entries)) genindexcontext = { 'genindexentries': genindex, 'genindexcounts': indexcounts, 'split_index': self.config.html_split_index, } logger.info('genindex ', nonl=True) if self.config.html_split_index: self.handle_page('genindex', genindexcontext, 'genindex-split.html') self.handle_page('genindex-all', genindexcontext, 'genindex.html') for (key, entries), count in zip(genindex, indexcounts): ctx = {'key': key, 'entries': entries, 'count': count, 'genindexentries': genindex} self.handle_page('genindex-' + key, ctx, 'genindex-single.html') else: self.handle_page('genindex', genindexcontext, 'genindex.html') def write_domain_indices(self) -> None: for indexname, indexcls, content, collapse in self.domain_indices: indexcontext = { 'indextitle': indexcls.localname, 'content': content, 'collapse_index': collapse, } logger.info(indexname + ' ', nonl=True) self.handle_page(indexname, indexcontext, 'domainindex.html') def copy_image_files(self) -> None: if self.images: stringify_func = ImageAdapter(self.app.env).get_original_image_uri ensuredir(path.join(self.outdir, self.imagedir)) for src in status_iterator(self.images, __('copying images... '), "brown", len(self.images), self.app.verbosity, stringify_func=stringify_func): dest = self.images[src] try: copyfile(path.join(self.srcdir, src), path.join(self.outdir, self.imagedir, dest)) except Exception as err: logger.warning(__('cannot copy image file %r: %s'), path.join(self.srcdir, src), err) def copy_download_files(self) -> None: def to_relpath(f: str) -> str: return relative_path(self.srcdir, f) # copy downloadable files if self.env.dlfiles: ensuredir(path.join(self.outdir, '_downloads')) for src in status_iterator(self.env.dlfiles, __('copying downloadable files... '), "brown", len(self.env.dlfiles), self.app.verbosity, stringify_func=to_relpath): try: dest = path.join(self.outdir, '_downloads', self.env.dlfiles[src][1]) ensuredir(path.dirname(dest)) copyfile(path.join(self.srcdir, src), dest) except OSError as err: logger.warning(__('cannot copy downloadable file %r: %s'), path.join(self.srcdir, src), err) def create_pygments_style_file(self) -> None: """create a style file for pygments.""" with open(path.join(self.outdir, '_static', 'pygments.css'), 'w') as f: f.write(self.highlighter.get_stylesheet()) if self.dark_highlighter: with open(path.join(self.outdir, '_static', 'pygments_dark.css'), 'w') as f: f.write(self.dark_highlighter.get_stylesheet()) def copy_translation_js(self) -> None: """Copy a JavaScript file for translations.""" if self.config.language is not None: jsfile = self._get_translations_js() if jsfile: copyfile(jsfile, path.join(self.outdir, '_static', 'translations.js')) def copy_stemmer_js(self) -> None: """Copy a JavaScript file for stemmer.""" if self.indexer is not None: if hasattr(self.indexer, 'get_js_stemmer_rawcodes'): for jsfile in self.indexer.get_js_stemmer_rawcodes(): copyfile(jsfile, path.join(self.outdir, '_static', path.basename(jsfile))) else: jsfile = self.indexer.get_js_stemmer_rawcode() if jsfile: copyfile(jsfile, path.join(self.outdir, '_static', '_stemmer.js')) def copy_theme_static_files(self, context: Dict) -> None: def onerror(filename: str, error: Exception) -> None: logger.warning(__('Failed to copy a file in html_static_file: %s: %r'), filename, error) if self.theme: for entry in self.theme.get_theme_dirs()[::-1]: copy_asset(path.join(entry, 'static'), path.join(self.outdir, '_static'), excluded=DOTFILES, context=context, renderer=self.templates, onerror=onerror) def copy_html_static_files(self, context: Dict) -> None: def onerror(filename: str, error: Exception) -> None: logger.warning(__('Failed to copy a file in html_static_file: %s: %r'), filename, error) excluded = Matcher(self.config.exclude_patterns + ["**/.*"]) for entry in self.config.html_static_path: copy_asset(path.join(self.confdir, entry), path.join(self.outdir, '_static'), excluded, context=context, renderer=self.templates, onerror=onerror) def copy_html_logo(self) -> None: if self.config.html_logo and not isurl(self.config.html_logo): copy_asset(path.join(self.confdir, self.config.html_logo), path.join(self.outdir, '_static')) def copy_html_favicon(self) -> None: if self.config.html_favicon and not isurl(self.config.html_favicon): copy_asset(path.join(self.confdir, self.config.html_favicon), path.join(self.outdir, '_static')) def copy_static_files(self) -> None: try: with progress_message(__('copying static files')): ensuredir(path.join(self.outdir, '_static')) # prepare context for templates context = self.globalcontext.copy() if self.indexer is not None: context.update(self.indexer.context_for_searchtool()) self.create_pygments_style_file() self.copy_translation_js() self.copy_stemmer_js() self.copy_theme_static_files(context) self.copy_html_static_files(context) self.copy_html_logo() self.copy_html_favicon() except OSError as err: logger.warning(__('cannot copy static file %r'), err) def copy_extra_files(self) -> None: """copy html_extra_path files.""" try: with progress_message(__('copying extra files')): excluded = Matcher(self.config.exclude_patterns) for extra_path in self.config.html_extra_path: entry = path.join(self.confdir, extra_path) copy_asset(entry, self.outdir, excluded) except OSError as err: logger.warning(__('cannot copy extra file %r'), err) def write_buildinfo(self) -> None: try: with open(path.join(self.outdir, '.buildinfo'), 'w') as fp: self.build_info.dump(fp) except OSError as exc: logger.warning(__('Failed to write build info file: %r'), exc) def cleanup(self) -> None: # clean up theme stuff if self.theme: self.theme.cleanup() def post_process_images(self, doctree: Node) -> None: """Pick the best candidate for an image and link down-scaled images to their high res version. """ Builder.post_process_images(self, doctree) if self.config.html_scaled_image_link and self.html_scaled_image_link: for node in doctree.traverse(nodes.image): if not any((key in node) for key in ['scale', 'width', 'height']): # resizing options are not given. scaled image link is available # only for resized images. continue elif isinstance(node.parent, nodes.reference): # A image having hyperlink target continue elif 'no-scaled-link' in node['classes']: # scaled image link is disabled for this node continue uri = node['uri'] reference = nodes.reference('', '', internal=True) if uri in self.images: reference['refuri'] = posixpath.join(self.imgpath, self.images[uri]) else: reference['refuri'] = uri node.replace_self(reference) reference.append(node) def load_indexer(self, docnames: Iterable[str]) -> None: keep = set(self.env.all_docs) - set(docnames) try: searchindexfn = path.join(self.outdir, self.searchindex_filename) if self.indexer_dumps_unicode: with open(searchindexfn, encoding='utf-8') as ft: self.indexer.load(ft, self.indexer_format) else: with open(searchindexfn, 'rb') as fb: self.indexer.load(fb, self.indexer_format) except (OSError, ValueError): if keep: logger.warning(__('search index couldn\'t be loaded, but not all ' 'documents will be built: the index will be ' 'incomplete.')) # delete all entries for files that will be rebuilt self.indexer.prune(keep) def index_page(self, pagename: str, doctree: nodes.document, title: str) -> None: # only index pages with title if self.indexer is not None and title: filename = self.env.doc2path(pagename, base=None) metadata = self.env.metadata.get(pagename, {}) if 'nosearch' in metadata: self.indexer.feed(pagename, filename, '', new_document('')) else: self.indexer.feed(pagename, filename, title, doctree) def _get_local_toctree(self, docname: str, collapse: bool = True, **kwargs: Any) -> str: if 'includehidden' not in kwargs: kwargs['includehidden'] = False if kwargs.get('maxdepth') == '': kwargs.pop('maxdepth') return self.render_partial(TocTree(self.env).get_toctree_for( docname, self, collapse, **kwargs))['fragment'] def get_outfilename(self, pagename: str) -> str: return path.join(self.outdir, os_path(pagename) + self.out_suffix) def add_sidebars(self, pagename: str, ctx: Dict) -> None: def has_wildcard(pattern: str) -> bool: return any(char in pattern for char in '*?[') sidebars = None matched = None customsidebar = None # default sidebars settings for selected theme if self.theme.name == 'alabaster': # provide default settings for alabaster (for compatibility) # Note: this will be removed before Sphinx-2.0 try: # get default sidebars settings from alabaster (if defined) theme_default_sidebars = self.theme.config.get('theme', 'sidebars') if theme_default_sidebars: sidebars = [name.strip() for name in theme_default_sidebars.split(',')] except Exception: # fallback to better default settings sidebars = ['about.html', 'navigation.html', 'relations.html', 'searchbox.html', 'donate.html'] else: theme_default_sidebars = self.theme.get_config('theme', 'sidebars', None) if theme_default_sidebars: sidebars = [name.strip() for name in theme_default_sidebars.split(',')] # user sidebar settings html_sidebars = self.get_builder_config('sidebars', 'html') for pattern, patsidebars in html_sidebars.items(): if patmatch(pagename, pattern): if matched: if has_wildcard(pattern): # warn if both patterns contain wildcards if has_wildcard(matched): logger.warning(__('page %s matches two patterns in ' 'html_sidebars: %r and %r'), pagename, matched, pattern) # else the already matched pattern is more specific # than the present one, because it contains no wildcard continue matched = pattern sidebars = patsidebars if sidebars is None: # keep defaults pass ctx['sidebars'] = sidebars ctx['customsidebar'] = customsidebar # --------- these are overwritten by the serialization builder def get_target_uri(self, docname: str, typ: str = None) -> str: return quote(docname) + self.link_suffix def handle_page(self, pagename: str, addctx: Dict, templatename: str = 'page.html', outfilename: str = None, event_arg: Any = None) -> None: ctx = self.globalcontext.copy() # current_page_name is backwards compatibility ctx['pagename'] = ctx['current_page_name'] = pagename ctx['encoding'] = self.config.html_output_encoding default_baseuri = self.get_target_uri(pagename) # in the singlehtml builder, default_baseuri still contains an #anchor # part, which relative_uri doesn't really like... default_baseuri = default_baseuri.rsplit('#', 1)[0] if self.config.html_baseurl: ctx['pageurl'] = posixpath.join(self.config.html_baseurl, pagename + self.out_suffix) else: ctx['pageurl'] = None def pathto(otheruri: str, resource: bool = False, baseuri: str = default_baseuri) -> str: # NOQA if resource and '://' in otheruri: # allow non-local resources given by scheme return otheruri elif not resource: otheruri = self.get_target_uri(otheruri) uri = relative_uri(baseuri, otheruri) or '#' if uri == '#' and not self.allow_sharp_as_current_path: uri = baseuri return uri ctx['pathto'] = pathto def hasdoc(name: str) -> bool: if name in self.env.all_docs: return True elif name == 'search' and self.search: return True elif name == 'genindex' and self.get_builder_config('use_index', 'html'): return True return False ctx['hasdoc'] = hasdoc ctx['toctree'] = lambda **kwargs: self._get_local_toctree(pagename, **kwargs) self.add_sidebars(pagename, ctx) ctx.update(addctx) # revert script_files and css_files self.script_files[:] = self._script_files self.css_files[:] = self._css_files self.update_page_context(pagename, templatename, ctx, event_arg) newtmpl = self.app.emit_firstresult('html-page-context', pagename, templatename, ctx, event_arg) if newtmpl: templatename = newtmpl # sort JS/CSS before rendering HTML try: # Convert script_files to list to support non-list script_files (refs: #8889) ctx['script_files'] = sorted(list(ctx['script_files']), key=lambda js: js.priority) except AttributeError: # Skip sorting if users modifies script_files directly (maybe via `html_context`). # refs: #8885 # # Note: priority sorting feature will not work in this case. pass try: ctx['css_files'] = sorted(list(ctx['css_files']), key=lambda css: css.priority) except AttributeError: pass try: output = self.templates.render(templatename, ctx) except UnicodeError: logger.warning(__("a Unicode error occurred when rendering the page %s. " "Please make sure all config values that contain " "non-ASCII content are Unicode strings."), pagename) return except Exception as exc: raise ThemeError(__("An error happened in rendering the page %s.\nReason: %r") % (pagename, exc)) from exc if not outfilename: outfilename = self.get_outfilename(pagename) # outfilename's path is in general different from self.outdir ensuredir(path.dirname(outfilename)) try: with open(outfilename, 'w', encoding=ctx['encoding'], errors='xmlcharrefreplace') as f: f.write(output) except OSError as err: logger.warning(__("error writing file %s: %s"), outfilename, err) if self.copysource and ctx.get('sourcename'): # copy the source file for the "show source" link source_name = path.join(self.outdir, '_sources', os_path(ctx['sourcename'])) ensuredir(path.dirname(source_name)) copyfile(self.env.doc2path(pagename), source_name) def update_page_context(self, pagename: str, templatename: str, ctx: Dict, event_arg: Any) -> None: pass def handle_finish(self) -> None: if self.indexer: self.finish_tasks.add_task(self.dump_search_index) self.finish_tasks.add_task(self.dump_inventory) @progress_message(__('dumping object inventory')) def dump_inventory(self) -> None: InventoryFile.dump(path.join(self.outdir, INVENTORY_FILENAME), self.env, self) def dump_search_index(self) -> None: with progress_message(__('dumping search index in %s') % self.indexer.label()): self.indexer.prune(self.env.all_docs) searchindexfn = path.join(self.outdir, self.searchindex_filename) # first write to a temporary file, so that if dumping fails, # the existing index won't be overwritten if self.indexer_dumps_unicode: with open(searchindexfn + '.tmp', 'w', encoding='utf-8') as ft: self.indexer.dump(ft, self.indexer_format) else: with open(searchindexfn + '.tmp', 'wb') as fb: self.indexer.dump(fb, self.indexer_format) os.replace(searchindexfn + '.tmp', searchindexfn) def convert_html_css_files(app: Sphinx, config: Config) -> None: """This converts string styled html_css_files to tuple styled one.""" html_css_files: List[Tuple[str, Dict]] = [] for entry in config.html_css_files: if isinstance(entry, str): html_css_files.append((entry, {})) else: try: filename, attrs = entry html_css_files.append((filename, attrs)) except Exception: logger.warning(__('invalid css_file: %r, ignored'), entry) continue config.html_css_files = html_css_files # type: ignore def convert_html_js_files(app: Sphinx, config: Config) -> None: """This converts string styled html_js_files to tuple styled one.""" html_js_files: List[Tuple[str, Dict]] = [] for entry in config.html_js_files: if isinstance(entry, str): html_js_files.append((entry, {})) else: try: filename, attrs = entry html_js_files.append((filename, attrs)) except Exception: logger.warning(__('invalid js_file: %r, ignored'), entry) continue config.html_js_files = html_js_files # type: ignore def setup_css_tag_helper(app: Sphinx, pagename: str, templatename: str, context: Dict, doctree: Node) -> None: """Set up css_tag() template helper. .. note:: This set up function is added to keep compatibility with webhelper. """ pathto = context.get('pathto') def css_tag(css: Stylesheet) -> str: attrs = [] for key in sorted(css.attributes): value = css.attributes[key] if value is not None: attrs.append('%s="%s"' % (key, html.escape(value, True))) attrs.append('href="%s"' % pathto(css.filename, resource=True)) return '<link %s />' % ' '.join(attrs) context['css_tag'] = css_tag def setup_js_tag_helper(app: Sphinx, pagename: str, templatename: str, context: Dict, doctree: Node) -> None: """Set up js_tag() template helper. .. note:: This set up function is added to keep compatibility with webhelper. """ pathto = context.get('pathto') def js_tag(js: JavaScript) -> str: attrs = [] body = '' if isinstance(js, JavaScript): for key in sorted(js.attributes): value = js.attributes[key] if value is not None: if key == 'body': body = value elif key == 'data_url_root': attrs.append('data-url_root="%s"' % pathto('', resource=True)) else: attrs.append('%s="%s"' % (key, html.escape(value, True))) if js.filename: attrs.append('src="%s"' % pathto(js.filename, resource=True)) else: # str value (old styled) attrs.append('src="%s"' % pathto(js, resource=True)) if attrs: return '<script %s>%s</script>' % (' '.join(attrs), body) else: return '<script>%s</script>' % body context['js_tag'] = js_tag def setup_resource_paths(app: Sphinx, pagename: str, templatename: str, context: Dict, doctree: Node) -> None: """Set up relative resource paths.""" pathto = context.get('pathto') # favicon_url favicon = context.get('favicon') if favicon and not isurl(favicon): context['favicon_url'] = pathto('_static/' + favicon, resource=True) else: context['favicon_url'] = favicon # logo_url logo = context.get('logo') if logo and not isurl(logo): context['logo_url'] = pathto('_static/' + logo, resource=True) else: context['logo_url'] = logo def validate_math_renderer(app: Sphinx) -> None: if app.builder.format != 'html': return name = app.builder.math_renderer_name # type: ignore if name is None: raise ConfigError(__('Many math_renderers are registered. ' 'But no math_renderer is selected.')) elif name not in app.registry.html_inline_math_renderers: raise ConfigError(__('Unknown math_renderer %r is given.') % name) def validate_html_extra_path(app: Sphinx, config: Config) -> None: """Check html_extra_paths setting.""" for entry in config.html_extra_path[:]: extra_path = path.normpath(path.join(app.confdir, entry)) if not path.exists(extra_path): logger.warning(__('html_extra_path entry %r does not exist'), entry) config.html_extra_path.remove(entry) elif (path.splitdrive(app.outdir)[0] == path.splitdrive(extra_path)[0] and path.commonpath([app.outdir, extra_path]) == app.outdir): logger.warning(__('html_extra_path entry %r is placed inside outdir'), entry) config.html_extra_path.remove(entry) def validate_html_static_path(app: Sphinx, config: Config) -> None: """Check html_static_paths setting.""" for entry in config.html_static_path[:]: static_path = path.normpath(path.join(app.confdir, entry)) if not path.exists(static_path): logger.warning(__('html_static_path entry %r does not exist'), entry) config.html_static_path.remove(entry) elif (path.splitdrive(app.outdir)[0] == path.splitdrive(static_path)[0] and path.commonpath([app.outdir, static_path]) == app.outdir): logger.warning(__('html_static_path entry %r is placed inside outdir'), entry) config.html_static_path.remove(entry) def validate_html_logo(app: Sphinx, config: Config) -> None: """Check html_logo setting.""" if (config.html_logo and not path.isfile(path.join(app.confdir, config.html_logo)) and not isurl(config.html_logo)): logger.warning(__('logo file %r does not exist'), config.html_logo) config.html_logo = None # type: ignore def validate_html_favicon(app: Sphinx, config: Config) -> None: """Check html_favicon setting.""" if (config.html_favicon and not path.isfile(path.join(app.confdir, config.html_favicon)) and not isurl(config.html_favicon)): logger.warning(__('favicon file %r does not exist'), config.html_favicon) config.html_favicon = None # type: ignore class _stable_repr_object(): def __repr__(self): return '<object>' UNSET = _stable_repr_object() def migrate_html_add_permalinks(app: Sphinx, config: Config) -> None: """Migrate html_add_permalinks to html_permalinks*.""" html_add_permalinks = config.html_add_permalinks if html_add_permalinks is UNSET: return # RemovedInSphinx60Warning logger.warning(__('html_add_permalinks has been deprecated since v3.5.0. ' 'Please use html_permalinks and html_permalinks_icon instead.')) if not html_add_permalinks: config.html_permalinks = False # type: ignore[attr-defined] return config.html_permalinks_icon = html.escape( # type: ignore[attr-defined] html_add_permalinks ) # for compatibility import sphinxcontrib.serializinghtml # NOQA import sphinx.builders.dirhtml # NOQA import sphinx.builders.singlehtml # NOQA def setup(app: Sphinx) -> Dict[str, Any]: # builders app.add_builder(StandaloneHTMLBuilder) # config values app.add_config_value('html_theme', 'alabaster', 'html') app.add_config_value('html_theme_path', [], 'html') app.add_config_value('html_theme_options', {}, 'html') app.add_config_value('html_title', lambda self: _('%s %s documentation') % (self.project, self.release), 'html', [str]) app.add_config_value('html_short_title', lambda self: self.html_title, 'html') app.add_config_value('html_style', None, 'html', [str]) app.add_config_value('html_logo', None, 'html', [str]) app.add_config_value('html_favicon', None, 'html', [str]) app.add_config_value('html_css_files', [], 'html') app.add_config_value('html_js_files', [], 'html') app.add_config_value('html_static_path', [], 'html') app.add_config_value('html_extra_path', [], 'html') app.add_config_value('html_last_updated_fmt', None, 'html', [str]) app.add_config_value('html_sidebars', {}, 'html') app.add_config_value('html_additional_pages', {}, 'html') app.add_config_value('html_domain_indices', True, 'html', [list]) app.add_config_value('html_add_permalinks', UNSET, 'html') app.add_config_value('html_permalinks', True, 'html') app.add_config_value('html_permalinks_icon', '¶', 'html') app.add_config_value('html_use_index', True, 'html') app.add_config_value('html_split_index', False, 'html') app.add_config_value('html_copy_source', True, 'html') app.add_config_value('html_show_sourcelink', True, 'html') app.add_config_value('html_sourcelink_suffix', '.txt', 'html') app.add_config_value('html_use_opensearch', '', 'html') app.add_config_value('html_file_suffix', None, 'html', [str]) app.add_config_value('html_link_suffix', None, 'html', [str]) app.add_config_value('html_show_copyright', True, 'html') app.add_config_value('html_show_sphinx', True, 'html') app.add_config_value('html_context', {}, 'html') app.add_config_value('html_output_encoding', 'utf-8', 'html') app.add_config_value('html_compact_lists', True, 'html') app.add_config_value('html_secnumber_suffix', '. ', 'html') app.add_config_value('html_search_language', None, 'html', [str]) app.add_config_value('html_search_options', {}, 'html') app.add_config_value('html_search_scorer', '', None) app.add_config_value('html_scaled_image_link', True, 'html') app.add_config_value('html_baseurl', '', 'html') app.add_config_value('html_codeblock_linenos_style', 'inline', 'html', # RemovedInSphinx60Warning # NOQA ENUM('table', 'inline')) app.add_config_value('html_math_renderer', None, 'env') app.add_config_value('html4_writer', False, 'html') # events app.add_event('html-collect-pages') app.add_event('html-page-context') # event handlers app.connect('config-inited', convert_html_css_files, priority=800) app.connect('config-inited', convert_html_js_files, priority=800) app.connect('config-inited', migrate_html_add_permalinks, priority=800) app.connect('config-inited', validate_html_extra_path, priority=800) app.connect('config-inited', validate_html_static_path, priority=800) app.connect('config-inited', validate_html_logo, priority=800) app.connect('config-inited', validate_html_favicon, priority=800) app.connect('builder-inited', validate_math_renderer) app.connect('html-page-context', setup_css_tag_helper) app.connect('html-page-context', setup_js_tag_helper) app.connect('html-page-context', setup_resource_paths) # load default math renderer app.setup_extension('sphinx.ext.mathjax') # load transforms for HTML builder app.setup_extension('sphinx.builders.html.transforms') return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/html/transforms.py�����������������������������������������������������0000644�0000766�0000024�00000005076�00000000000�021201� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.html.transforms ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Transforms for HTML builder. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import re from typing import Any, Dict, List from docutils import nodes from sphinx.application import Sphinx from sphinx.transforms.post_transforms import SphinxPostTransform from sphinx.util.nodes import NodeMatcher class KeyboardTransform(SphinxPostTransform): """Transform :kbd: role to more detailed form. Before:: <literal class="kbd"> Control-x After:: <literal class="kbd compound"> <literal class="kbd"> Control - <literal class="kbd"> x """ default_priority = 400 builders = ('html',) pattern = re.compile(r'(?<=.)(-|\+|\^|\s+)(?=.)') multiwords_keys = (('caps', 'lock'), ('page' 'down'), ('page', 'up'), ('scroll' 'lock'), ('num', 'lock'), ('sys' 'rq'), ('back' 'space')) def run(self, **kwargs: Any) -> None: matcher = NodeMatcher(nodes.literal, classes=["kbd"]) for node in self.document.traverse(matcher): # type: nodes.literal parts = self.pattern.split(node[-1].astext()) if len(parts) == 1 or self.is_multiwords_key(parts): continue node['classes'].append('compound') node.pop() while parts: if self.is_multiwords_key(parts): key = ''.join(parts[:3]) parts[:3] = [] else: key = parts.pop(0) node += nodes.literal('', key, classes=["kbd"]) try: # key separator (ex. -, +, ^) sep = parts.pop(0) node += nodes.Text(sep) except IndexError: pass def is_multiwords_key(self, parts: List[str]) -> bool: if len(parts) >= 3 and parts[1].strip() == '': name = parts[0].lower(), parts[2].lower() if name in self.multiwords_keys: return True else: return False else: return False def setup(app: Sphinx) -> Dict[str, Any]: app.add_post_transform(KeyboardTransform) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4495745 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/latex/�����������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016572� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/latex/__init__.py������������������������������������������������������0000644�0000766�0000024�00000057737�00000000000�020726� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.latex ~~~~~~~~~~~~~~~~~~~~~ LaTeX builder. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import os import warnings from os import path from typing import Any, Dict, Iterable, List, Tuple, Union from docutils.frontend import OptionParser from docutils.nodes import Node import sphinx.builders.latex.nodes # NOQA # Workaround: import this before writer to avoid ImportError from sphinx import addnodes, highlighting, package_dir from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.builders.latex.constants import ADDITIONAL_SETTINGS, DEFAULT_SETTINGS, SHORTHANDOFF from sphinx.builders.latex.theming import Theme, ThemeFactory from sphinx.builders.latex.util import ExtBabel from sphinx.config import ENUM, Config from sphinx.deprecation import RemovedInSphinx50Warning from sphinx.environment.adapters.asset import ImageAdapter from sphinx.errors import NoUri, SphinxError from sphinx.locale import _, __ from sphinx.util import logging, progress_message, status_iterator, texescape from sphinx.util.console import bold, darkgreen # type: ignore from sphinx.util.docutils import SphinxFileOutput, new_document from sphinx.util.fileutil import copy_asset_file from sphinx.util.i18n import format_date from sphinx.util.nodes import inline_all_toctrees from sphinx.util.osutil import SEP, make_filename_from_project from sphinx.util.template import LaTeXRenderer from sphinx.writers.latex import LaTeXTranslator, LaTeXWriter # load docutils.nodes after loading sphinx.builders.latex.nodes from docutils import nodes # isort:skip XINDY_LANG_OPTIONS = { # language codes from docutils.writers.latex2e.Babel # ! xindy language names may differ from those in use by LaTeX/babel # ! xindy does not support all Latin scripts as recognized by LaTeX/babel # ! not all xindy-supported languages appear in Babel.language_codes # cd /usr/local/texlive/2018/texmf-dist/xindy/modules/lang # find . -name '*utf8.xdy' # LATIN 'sq': '-L albanian -C utf8 ', 'hr': '-L croatian -C utf8 ', 'cs': '-L czech -C utf8 ', 'da': '-L danish -C utf8 ', 'nl': '-L dutch-ij-as-ij -C utf8 ', 'en': '-L english -C utf8 ', 'eo': '-L esperanto -C utf8 ', 'et': '-L estonian -C utf8 ', 'fi': '-L finnish -C utf8 ', 'fr': '-L french -C utf8 ', 'de': '-L german-din5007 -C utf8 ', 'is': '-L icelandic -C utf8 ', 'it': '-L italian -C utf8 ', 'la': '-L latin -C utf8 ', 'lv': '-L latvian -C utf8 ', 'lt': '-L lithuanian -C utf8 ', 'dsb': '-L lower-sorbian -C utf8 ', 'ds': '-L lower-sorbian -C utf8 ', # trick, no conflict 'nb': '-L norwegian -C utf8 ', 'no': '-L norwegian -C utf8 ', # and what about nynorsk? 'pl': '-L polish -C utf8 ', 'pt': '-L portuguese -C utf8 ', 'ro': '-L romanian -C utf8 ', 'sk': '-L slovak-small -C utf8 ', # there is also slovak-large 'sl': '-L slovenian -C utf8 ', 'es': '-L spanish-modern -C utf8 ', # there is also spanish-traditional 'sv': '-L swedish -C utf8 ', 'tr': '-L turkish -C utf8 ', 'hsb': '-L upper-sorbian -C utf8 ', 'hs': '-L upper-sorbian -C utf8 ', # trick, no conflict 'vi': '-L vietnamese -C utf8 ', # CYRILLIC # for usage with pdflatex, needs also cyrLICRutf8.xdy module 'be': '-L belarusian -C utf8 ', 'bg': '-L bulgarian -C utf8 ', 'mk': '-L macedonian -C utf8 ', 'mn': '-L mongolian-cyrillic -C utf8 ', 'ru': '-L russian -C utf8 ', 'sr': '-L serbian -C utf8 ', 'sh-cyrl': '-L serbian -C utf8 ', 'sh': '-L serbian -C utf8 ', # trick, no conflict 'uk': '-L ukrainian -C utf8 ', # GREEK # can work only with xelatex/lualatex, not supported by texindy+pdflatex 'el': '-L greek -C utf8 ', # FIXME, not compatible with [:2] slice but does Sphinx support Greek ? 'el-polyton': '-L greek-polytonic -C utf8 ', } XINDY_CYRILLIC_SCRIPTS = [ 'be', 'bg', 'mk', 'mn', 'ru', 'sr', 'sh', 'uk', ] logger = logging.getLogger(__name__) class LaTeXBuilder(Builder): """ Builds LaTeX output to create PDF. """ name = 'latex' format = 'latex' epilog = __('The LaTeX files are in %(outdir)s.') if os.name == 'posix': epilog += __("\nRun 'make' in that directory to run these through " "(pdf)latex\n" "(use `make latexpdf' here to do that automatically).") supported_image_types = ['application/pdf', 'image/png', 'image/jpeg'] supported_remote_images = False default_translator_class = LaTeXTranslator def init(self) -> None: self.babel: ExtBabel = None self.context: Dict[str, Any] = {} self.docnames: Iterable[str] = {} self.document_data: List[Tuple[str, str, str, str, str, bool]] = [] self.themes = ThemeFactory(self.app) texescape.init() self.init_context() self.init_babel() self.init_multilingual() def get_outdated_docs(self) -> Union[str, List[str]]: return 'all documents' # for now def get_target_uri(self, docname: str, typ: str = None) -> str: if docname not in self.docnames: raise NoUri(docname, typ) else: return '%' + docname def get_relative_uri(self, from_: str, to: str, typ: str = None) -> str: # ignore source path return self.get_target_uri(to, typ) def init_document_data(self) -> None: preliminary_document_data = [list(x) for x in self.config.latex_documents] if not preliminary_document_data: logger.warning(__('no "latex_documents" config value found; no documents ' 'will be written')) return # assign subdirs to titles self.titles: List[Tuple[str, str]] = [] for entry in preliminary_document_data: docname = entry[0] if docname not in self.env.all_docs: logger.warning(__('"latex_documents" config value references unknown ' 'document %s'), docname) continue self.document_data.append(entry) # type: ignore if docname.endswith(SEP + 'index'): docname = docname[:-5] self.titles.append((docname, entry[2])) def init_context(self) -> None: self.context = DEFAULT_SETTINGS.copy() # Add special settings for latex_engine self.context.update(ADDITIONAL_SETTINGS.get(self.config.latex_engine, {})) # Add special settings for (latex_engine, language_code) if self.config.language: key = (self.config.latex_engine, self.config.language[:2]) self.context.update(ADDITIONAL_SETTINGS.get(key, {})) # Apply user settings to context self.context.update(self.config.latex_elements) self.context['release'] = self.config.release self.context['use_xindy'] = self.config.latex_use_xindy if self.config.today: self.context['date'] = self.config.today else: self.context['date'] = format_date(self.config.today_fmt or _('%b %d, %Y'), language=self.config.language) if self.config.latex_logo: self.context['logofilename'] = path.basename(self.config.latex_logo) # for compatibilities self.context['indexname'] = _('Index') if self.config.release: # Show the release label only if release value exists self.context.setdefault('releasename', _('Release')) def update_context(self) -> None: """Update template variables for .tex file just before writing.""" # Apply extension settings to context registry = self.app.registry self.context['packages'] = registry.latex_packages self.context['packages_after_hyperref'] = registry.latex_packages_after_hyperref def init_babel(self) -> None: self.babel = ExtBabel(self.config.language, not self.context['babel']) if self.config.language and not self.babel.is_supported_language(): # emit warning if specified language is invalid # (only emitting, nothing changed to processing) logger.warning(__('no Babel option known for language %r'), self.config.language) def init_multilingual(self) -> None: if self.context['latex_engine'] == 'pdflatex': if not self.babel.uses_cyrillic(): if 'X2' in self.context['fontenc']: self.context['substitutefont'] = '\\usepackage{substitutefont}' self.context['textcyrillic'] = ('\\usepackage[Xtwo]' '{sphinxpackagecyrillic}') elif 'T2A' in self.context['fontenc']: self.context['substitutefont'] = '\\usepackage{substitutefont}' self.context['textcyrillic'] = ('\\usepackage[TtwoA]' '{sphinxpackagecyrillic}') if 'LGR' in self.context['fontenc']: self.context['substitutefont'] = '\\usepackage{substitutefont}' else: self.context['textgreek'] = '' if self.context['substitutefont'] == '': self.context['fontsubstitution'] = '' # 'babel' key is public and user setting must be obeyed if self.context['babel']: self.context['classoptions'] += ',' + self.babel.get_language() # this branch is not taken for xelatex/lualatex if default settings self.context['multilingual'] = self.context['babel'] if self.config.language: self.context['shorthandoff'] = SHORTHANDOFF # Times fonts don't work with Cyrillic languages if self.babel.uses_cyrillic() and 'fontpkg' not in self.config.latex_elements: self.context['fontpkg'] = '' elif self.context['polyglossia']: self.context['classoptions'] += ',' + self.babel.get_language() options = self.babel.get_mainlanguage_options() if options: language = r'\setmainlanguage[%s]{%s}' % (options, self.babel.get_language()) else: language = r'\setmainlanguage{%s}' % self.babel.get_language() self.context['multilingual'] = '%s\n%s' % (self.context['polyglossia'], language) def write_stylesheet(self) -> None: highlighter = highlighting.PygmentsBridge('latex', self.config.pygments_style) stylesheet = path.join(self.outdir, 'sphinxhighlight.sty') with open(stylesheet, 'w') as f: f.write('\\NeedsTeXFormat{LaTeX2e}[1995/12/01]\n') f.write('\\ProvidesPackage{sphinxhighlight}' '[2016/05/29 stylesheet for highlighting with pygments]\n') f.write('% Its contents depend on pygments_style configuration variable.\n\n') f.write(highlighter.get_stylesheet()) def write(self, *ignored: Any) -> None: docwriter = LaTeXWriter(self) docsettings: Any = OptionParser( defaults=self.env.settings, components=(docwriter,), read_config_files=True).get_default_values() self.init_document_data() self.write_stylesheet() for entry in self.document_data: docname, targetname, title, author, themename = entry[:5] theme = self.themes.get(themename) toctree_only = False if len(entry) > 5: toctree_only = entry[5] destination = SphinxFileOutput(destination_path=path.join(self.outdir, targetname), encoding='utf-8', overwrite_if_changed=True) with progress_message(__("processing %s") % targetname): doctree = self.env.get_doctree(docname) toctree = next(iter(doctree.traverse(addnodes.toctree)), None) if toctree and toctree.get('maxdepth') > 0: tocdepth = toctree.get('maxdepth') else: tocdepth = None doctree = self.assemble_doctree( docname, toctree_only, appendices=(self.config.latex_appendices if theme.name != 'howto' else [])) doctree['docclass'] = theme.docclass doctree['contentsname'] = self.get_contentsname(docname) doctree['tocdepth'] = tocdepth self.post_process_images(doctree) self.update_doc_context(title, author, theme) self.update_context() with progress_message(__("writing")): docsettings._author = author docsettings._title = title docsettings._contentsname = doctree['contentsname'] docsettings._docname = docname docsettings._docclass = theme.name doctree.settings = docsettings docwriter.theme = theme docwriter.write(doctree, destination) def get_contentsname(self, indexfile: str) -> str: tree = self.env.get_doctree(indexfile) contentsname = None for toctree in tree.traverse(addnodes.toctree): if 'caption' in toctree: contentsname = toctree['caption'] break return contentsname def update_doc_context(self, title: str, author: str, theme: Theme) -> None: self.context['title'] = title self.context['author'] = author self.context['docclass'] = theme.docclass self.context['papersize'] = theme.papersize self.context['pointsize'] = theme.pointsize self.context['wrapperclass'] = theme.wrapperclass def assemble_doctree(self, indexfile: str, toctree_only: bool, appendices: List[str]) -> nodes.document: # NOQA self.docnames = set([indexfile] + appendices) logger.info(darkgreen(indexfile) + " ", nonl=True) tree = self.env.get_doctree(indexfile) tree['docname'] = indexfile if toctree_only: # extract toctree nodes from the tree and put them in a # fresh document new_tree = new_document('<latex output>') new_sect = nodes.section() new_sect += nodes.title('<Set title in conf.py>', '<Set title in conf.py>') new_tree += new_sect for node in tree.traverse(addnodes.toctree): new_sect += node tree = new_tree largetree = inline_all_toctrees(self, self.docnames, indexfile, tree, darkgreen, [indexfile]) largetree['docname'] = indexfile for docname in appendices: appendix = self.env.get_doctree(docname) appendix['docname'] = docname largetree.append(appendix) logger.info('') logger.info(__("resolving references...")) self.env.resolve_references(largetree, indexfile, self) # resolve :ref:s to distant tex files -- we can't add a cross-reference, # but append the document name for pendingnode in largetree.traverse(addnodes.pending_xref): docname = pendingnode['refdocname'] sectname = pendingnode['refsectname'] newnodes: List[Node] = [nodes.emphasis(sectname, sectname)] for subdir, title in self.titles: if docname.startswith(subdir): newnodes.append(nodes.Text(_(' (in '), _(' (in '))) newnodes.append(nodes.emphasis(title, title)) newnodes.append(nodes.Text(')', ')')) break else: pass pendingnode.replace_self(newnodes) return largetree def finish(self) -> None: self.copy_image_files() self.write_message_catalog() self.copy_support_files() if self.config.latex_additional_files: self.copy_latex_additional_files() @progress_message(__('copying TeX support files')) def copy_support_files(self) -> None: """copy TeX support files from texinputs.""" # configure usage of xindy (impacts Makefile and latexmkrc) # FIXME: convert this rather to a confval with suitable default # according to language ? but would require extra documentation if self.config.language: xindy_lang_option = \ XINDY_LANG_OPTIONS.get(self.config.language[:2], '-L general -C utf8 ') xindy_cyrillic = self.config.language[:2] in XINDY_CYRILLIC_SCRIPTS else: xindy_lang_option = '-L english -C utf8 ' xindy_cyrillic = False context = { 'latex_engine': self.config.latex_engine, 'xindy_use': self.config.latex_use_xindy, 'xindy_lang_option': xindy_lang_option, 'xindy_cyrillic': xindy_cyrillic, } logger.info(bold(__('copying TeX support files...'))) staticdirname = path.join(package_dir, 'texinputs') for filename in os.listdir(staticdirname): if not filename.startswith('.'): copy_asset_file(path.join(staticdirname, filename), self.outdir, context=context) # use pre-1.6.x Makefile for make latexpdf on Windows if os.name == 'nt': staticdirname = path.join(package_dir, 'texinputs_win') copy_asset_file(path.join(staticdirname, 'Makefile_t'), self.outdir, context=context) @progress_message(__('copying additional files')) def copy_latex_additional_files(self) -> None: for filename in self.config.latex_additional_files: logger.info(' ' + filename, nonl=True) copy_asset_file(path.join(self.confdir, filename), self.outdir) def copy_image_files(self) -> None: if self.images: stringify_func = ImageAdapter(self.app.env).get_original_image_uri for src in status_iterator(self.images, __('copying images... '), "brown", len(self.images), self.app.verbosity, stringify_func=stringify_func): dest = self.images[src] try: copy_asset_file(path.join(self.srcdir, src), path.join(self.outdir, dest)) except Exception as err: logger.warning(__('cannot copy image file %r: %s'), path.join(self.srcdir, src), err) if self.config.latex_logo: if not path.isfile(path.join(self.confdir, self.config.latex_logo)): raise SphinxError(__('logo file %r does not exist') % self.config.latex_logo) else: copy_asset_file(path.join(self.confdir, self.config.latex_logo), self.outdir) def write_message_catalog(self) -> None: formats = self.config.numfig_format context = { 'addtocaptions': r'\@iden', 'figurename': formats.get('figure', '').split('%s', 1), 'tablename': formats.get('table', '').split('%s', 1), 'literalblockname': formats.get('code-block', '').split('%s', 1) } if self.context['babel'] or self.context['polyglossia']: context['addtocaptions'] = r'\addto\captions%s' % self.babel.get_language() filename = path.join(package_dir, 'templates', 'latex', 'sphinxmessages.sty_t') copy_asset_file(filename, self.outdir, context=context, renderer=LaTeXRenderer()) @property def usepackages(self) -> List[Tuple[str, str]]: warnings.warn('LaTeXBuilder.usepackages is deprecated.', RemovedInSphinx50Warning, stacklevel=2) return self.app.registry.latex_packages @property def usepackages_after_hyperref(self) -> List[Tuple[str, str]]: warnings.warn('LaTeXBuilder.usepackages_after_hyperref is deprecated.', RemovedInSphinx50Warning, stacklevel=2) return self.app.registry.latex_packages_after_hyperref def validate_config_values(app: Sphinx, config: Config) -> None: for key in list(config.latex_elements): if key not in DEFAULT_SETTINGS: msg = __("Unknown configure key: latex_elements[%r], ignored.") logger.warning(msg % (key,)) config.latex_elements.pop(key) def validate_latex_theme_options(app: Sphinx, config: Config) -> None: for key in list(config.latex_theme_options): if key not in Theme.UPDATABLE_KEYS: msg = __("Unknown theme option: latex_theme_options[%r], ignored.") logger.warning(msg % (key,)) config.latex_theme_options.pop(key) def install_packages_for_ja(app: Sphinx) -> None: """Install packages for Japanese.""" if app.config.language == 'ja' and app.config.latex_engine in ('platex', 'uplatex'): app.add_latex_package('pxjahyper', after_hyperref=True) def default_latex_engine(config: Config) -> str: """ Better default latex_engine settings for specific languages. """ if config.language == 'ja': return 'uplatex' elif (config.language or '').startswith('zh'): return 'xelatex' elif config.language == 'el': return 'xelatex' else: return 'pdflatex' def default_latex_docclass(config: Config) -> Dict[str, str]: """ Better default latex_docclass settings for specific languages. """ if config.language == 'ja': if config.latex_engine == 'uplatex': return {'manual': 'ujbook', 'howto': 'ujreport'} else: return {'manual': 'jsbook', 'howto': 'jreport'} else: return {} def default_latex_use_xindy(config: Config) -> bool: """ Better default latex_use_xindy settings for specific engines. """ return config.latex_engine in {'xelatex', 'lualatex'} def default_latex_documents(config: Config) -> List[Tuple[str, str, str, str, str]]: """ Better default latex_documents settings. """ project = texescape.escape(config.project, config.latex_engine) author = texescape.escape(config.author, config.latex_engine) return [(config.root_doc, make_filename_from_project(config.project) + '.tex', texescape.escape_abbr(project), texescape.escape_abbr(author), config.latex_theme)] def setup(app: Sphinx) -> Dict[str, Any]: app.setup_extension('sphinx.builders.latex.transforms') app.add_builder(LaTeXBuilder) app.connect('config-inited', validate_config_values, priority=800) app.connect('config-inited', validate_latex_theme_options, priority=800) app.connect('builder-inited', install_packages_for_ja) app.add_config_value('latex_engine', default_latex_engine, None, ENUM('pdflatex', 'xelatex', 'lualatex', 'platex', 'uplatex')) app.add_config_value('latex_documents', default_latex_documents, None) app.add_config_value('latex_logo', None, None, [str]) app.add_config_value('latex_appendices', [], None) app.add_config_value('latex_use_latex_multicolumn', False, None) app.add_config_value('latex_use_xindy', default_latex_use_xindy, None, [bool]) app.add_config_value('latex_toplevel_sectioning', None, None, ENUM(None, 'part', 'chapter', 'section')) app.add_config_value('latex_domain_indices', True, None, [list]) app.add_config_value('latex_show_urls', 'no', None) app.add_config_value('latex_show_pagerefs', False, None) app.add_config_value('latex_elements', {}, None) app.add_config_value('latex_additional_files', [], None) app.add_config_value('latex_theme', 'manual', None, [str]) app.add_config_value('latex_theme_options', {}, None) app.add_config_value('latex_theme_path', [], None, [list]) app.add_config_value('latex_docclass', default_latex_docclass, None) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ���������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/latex/constants.py�����������������������������������������������������0000644�0000766�0000024�00000016551�00000000000�021170� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.latex.constants ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ consntants for LaTeX builder. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Any, Dict PDFLATEX_DEFAULT_FONTPKG = r''' \usepackage{tgtermes} \usepackage{tgheros} \renewcommand{\ttdefault}{txtt} ''' PDFLATEX_DEFAULT_FONTSUBSTITUTION = r''' \expandafter\ifx\csname T@LGR\endcsname\relax \else % LGR was declared as font encoding \substitutefont{LGR}{\rmdefault}{cmr} \substitutefont{LGR}{\sfdefault}{cmss} \substitutefont{LGR}{\ttdefault}{cmtt} \fi \expandafter\ifx\csname T@X2\endcsname\relax \expandafter\ifx\csname T@T2A\endcsname\relax \else % T2A was declared as font encoding \substitutefont{T2A}{\rmdefault}{cmr} \substitutefont{T2A}{\sfdefault}{cmss} \substitutefont{T2A}{\ttdefault}{cmtt} \fi \else % X2 was declared as font encoding \substitutefont{X2}{\rmdefault}{cmr} \substitutefont{X2}{\sfdefault}{cmss} \substitutefont{X2}{\ttdefault}{cmtt} \fi ''' XELATEX_DEFAULT_FONTPKG = r''' \setmainfont{FreeSerif}[ Extension = .otf, UprightFont = *, ItalicFont = *Italic, BoldFont = *Bold, BoldItalicFont = *BoldItalic ] \setsansfont{FreeSans}[ Extension = .otf, UprightFont = *, ItalicFont = *Oblique, BoldFont = *Bold, BoldItalicFont = *BoldOblique, ] \setmonofont{FreeMono}[ Extension = .otf, UprightFont = *, ItalicFont = *Oblique, BoldFont = *Bold, BoldItalicFont = *BoldOblique, ] ''' XELATEX_GREEK_DEFAULT_FONTPKG = (XELATEX_DEFAULT_FONTPKG + '\n\\newfontfamily\\greekfont{FreeSerif}' + '\n\\newfontfamily\\greekfontsf{FreeSans}' + '\n\\newfontfamily\\greekfonttt{FreeMono}') LUALATEX_DEFAULT_FONTPKG = XELATEX_DEFAULT_FONTPKG DEFAULT_SETTINGS: Dict[str, Any] = { 'latex_engine': 'pdflatex', 'papersize': '', 'pointsize': '', 'pxunit': '.75bp', 'classoptions': '', 'extraclassoptions': '', 'maxlistdepth': '', 'sphinxpkgoptions': '', 'sphinxsetup': '', 'fvset': '\\fvset{fontsize=auto}', 'passoptionstopackages': '', 'geometry': '\\usepackage{geometry}', 'inputenc': '', 'utf8extra': '', 'cmappkg': '\\usepackage{cmap}', 'fontenc': '\\usepackage[T1]{fontenc}', 'amsmath': '\\usepackage{amsmath,amssymb,amstext}', 'multilingual': '', 'babel': '\\usepackage{babel}', 'polyglossia': '', 'fontpkg': PDFLATEX_DEFAULT_FONTPKG, 'fontsubstitution': PDFLATEX_DEFAULT_FONTSUBSTITUTION, 'substitutefont': '', 'textcyrillic': '', 'textgreek': '\\usepackage{textalpha}', 'fncychap': '\\usepackage[Bjarne]{fncychap}', 'hyperref': ('% Include hyperref last.\n' '\\usepackage{hyperref}\n' '% Fix anchor placement for figures with captions.\n' '\\usepackage{hypcap}% it must be loaded after hyperref.\n' '% Set up styles of URL: it should be placed after hyperref.\n' '\\urlstyle{same}'), 'contentsname': '', 'extrapackages': '', 'preamble': '', 'title': '', 'release': '', 'author': '', 'releasename': '', 'makeindex': '\\makeindex', 'shorthandoff': '', 'maketitle': '\\sphinxmaketitle', 'tableofcontents': '\\sphinxtableofcontents', 'atendofbody': '', 'printindex': '\\printindex', 'transition': '\n\n\\bigskip\\hrule\\bigskip\n\n', 'figure_align': 'htbp', 'tocdepth': '', 'secnumdepth': '', } ADDITIONAL_SETTINGS: Dict[Any, Dict[str, Any]] = { 'pdflatex': { 'inputenc': '\\usepackage[utf8]{inputenc}', 'utf8extra': ('\\ifdefined\\DeclareUnicodeCharacter\n' '% support both utf8 and utf8x syntaxes\n' ' \\ifdefined\\DeclareUnicodeCharacterAsOptional\n' ' \\def\\sphinxDUC#1{\\DeclareUnicodeCharacter{"#1}}\n' ' \\else\n' ' \\let\\sphinxDUC\\DeclareUnicodeCharacter\n' ' \\fi\n' ' \\sphinxDUC{00A0}{\\nobreakspace}\n' ' \\sphinxDUC{2500}{\\sphinxunichar{2500}}\n' ' \\sphinxDUC{2502}{\\sphinxunichar{2502}}\n' ' \\sphinxDUC{2514}{\\sphinxunichar{2514}}\n' ' \\sphinxDUC{251C}{\\sphinxunichar{251C}}\n' ' \\sphinxDUC{2572}{\\textbackslash}\n' '\\fi'), }, 'xelatex': { 'latex_engine': 'xelatex', 'polyglossia': '\\usepackage{polyglossia}', 'babel': '', 'fontenc': ('\\usepackage{fontspec}\n' '\\defaultfontfeatures[\\rmfamily,\\sffamily,\\ttfamily]{}'), 'fontpkg': XELATEX_DEFAULT_FONTPKG, 'fvset': '\\fvset{fontsize=\\small}', 'fontsubstitution': '', 'textgreek': '', 'utf8extra': ('\\catcode`^^^^00a0\\active\\protected\\def^^^^00a0' '{\\leavevmode\\nobreak\\ }'), }, 'lualatex': { 'latex_engine': 'lualatex', 'polyglossia': '\\usepackage{polyglossia}', 'babel': '', 'fontenc': ('\\usepackage{fontspec}\n' '\\defaultfontfeatures[\\rmfamily,\\sffamily,\\ttfamily]{}'), 'fontpkg': LUALATEX_DEFAULT_FONTPKG, 'fvset': '\\fvset{fontsize=\\small}', 'fontsubstitution': '', 'textgreek': '', 'utf8extra': ('\\catcode`^^^^00a0\\active\\protected\\def^^^^00a0' '{\\leavevmode\\nobreak\\ }'), }, 'platex': { 'latex_engine': 'platex', 'babel': '', 'classoptions': ',dvipdfmx', 'fontpkg': PDFLATEX_DEFAULT_FONTPKG, 'fontsubstitution': '', 'textgreek': '', 'fncychap': '', 'geometry': '\\usepackage[dvipdfm]{geometry}', }, 'uplatex': { 'latex_engine': 'uplatex', 'babel': '', 'classoptions': ',dvipdfmx', 'fontpkg': PDFLATEX_DEFAULT_FONTPKG, 'fontsubstitution': '', 'textgreek': '', 'fncychap': '', 'geometry': '\\usepackage[dvipdfm]{geometry}', }, # special settings for latex_engine + language_code ('xelatex', 'fr'): { # use babel instead of polyglossia by default 'polyglossia': '', 'babel': '\\usepackage{babel}', }, ('xelatex', 'zh'): { 'polyglossia': '', 'babel': '\\usepackage{babel}', 'fontenc': '\\usepackage{xeCJK}', # set formatcom=\xeCJKVerbAddon to prevent xeCJK from adding extra spaces in # fancyvrb Verbatim environment. 'fvset': '\\fvset{fontsize=\\small,formatcom=\\xeCJKVerbAddon}', }, ('xelatex', 'el'): { 'fontpkg': XELATEX_GREEK_DEFAULT_FONTPKG, }, } SHORTHANDOFF = r''' \ifdefined\shorthandoff \ifnum\catcode`\=\string=\active\shorthandoff{=}\fi \ifnum\catcode`\"=\active\shorthandoff{"}\fi \fi ''' �������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/latex/nodes.py���������������������������������������������������������0000644�0000766�0000024�00000002033�00000000000�020252� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.latex.nodes ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Additional nodes for LaTeX writer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from docutils import nodes class captioned_literal_block(nodes.container): """A node for a container of literal_block having a caption.""" pass class footnotemark(nodes.Inline, nodes.Referential, nodes.TextElement): """A node represents ``\footnotemark``.""" pass class footnotetext(nodes.General, nodes.BackLinkable, nodes.Element, nodes.Labeled, nodes.Targetable): """A node represents ``\footnotetext``.""" class math_reference(nodes.Inline, nodes.Referential, nodes.TextElement): """A node for a reference for equation.""" pass class thebibliography(nodes.container): """A node for wrapping bibliographies.""" pass HYPERLINK_SUPPORT_NODES = ( nodes.figure, nodes.literal_block, nodes.table, nodes.section, captioned_literal_block, ) �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/latex/theming.py�������������������������������������������������������0000644�0000766�0000024�00000011044�00000000000�020577� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.latex.theming ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Theming support for LaTeX builder. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import configparser from os import path from typing import Dict from sphinx.application import Sphinx from sphinx.config import Config from sphinx.errors import ThemeError from sphinx.locale import __ from sphinx.util import logging logger = logging.getLogger(__name__) class Theme: """A set of LaTeX configurations.""" LATEX_ELEMENTS_KEYS = ['papersize', 'pointsize'] UPDATABLE_KEYS = ['papersize', 'pointsize'] def __init__(self, name: str) -> None: self.name = name self.docclass = name self.wrapperclass = name self.papersize = 'letterpaper' self.pointsize = '10pt' self.toplevel_sectioning = 'chapter' def update(self, config: Config) -> None: """Override theme settings by user's configuration.""" for key in self.LATEX_ELEMENTS_KEYS: if config.latex_elements.get(key): value = config.latex_elements[key] setattr(self, key, value) for key in self.UPDATABLE_KEYS: if key in config.latex_theme_options: value = config.latex_theme_options[key] setattr(self, key, value) class BuiltInTheme(Theme): """A built-in LaTeX theme.""" def __init__(self, name: str, config: Config) -> None: super().__init__(name) if name == 'howto': self.docclass = config.latex_docclass.get('howto', 'article') else: self.docclass = config.latex_docclass.get('manual', 'report') if name in ('manual', 'howto'): self.wrapperclass = 'sphinx' + name else: self.wrapperclass = name # we assume LaTeX class provides \chapter command except in case # of non-Japanese 'howto' case if name == 'howto' and not self.docclass.startswith('j'): self.toplevel_sectioning = 'section' else: self.toplevel_sectioning = 'chapter' class UserTheme(Theme): """A user defined LaTeX theme.""" REQUIRED_CONFIG_KEYS = ['docclass', 'wrapperclass'] OPTIONAL_CONFIG_KEYS = ['papersize', 'pointsize', 'toplevel_sectioning'] def __init__(self, name: str, filename: str) -> None: super().__init__(name) self.config = configparser.RawConfigParser() self.config.read(path.join(filename)) for key in self.REQUIRED_CONFIG_KEYS: try: value = self.config.get('theme', key) setattr(self, key, value) except configparser.NoSectionError as exc: raise ThemeError(__('%r doesn\'t have "theme" setting') % filename) from exc except configparser.NoOptionError as exc: raise ThemeError(__('%r doesn\'t have "%s" setting') % (filename, exc.args[0])) from exc for key in self.OPTIONAL_CONFIG_KEYS: try: value = self.config.get('theme', key) setattr(self, key, value) except configparser.NoOptionError: pass class ThemeFactory: """A factory class for LaTeX Themes.""" def __init__(self, app: Sphinx) -> None: self.themes: Dict[str, Theme] = {} self.theme_paths = [path.join(app.srcdir, p) for p in app.config.latex_theme_path] self.config = app.config self.load_builtin_themes(app.config) def load_builtin_themes(self, config: Config) -> None: """Load built-in themes.""" self.themes['manual'] = BuiltInTheme('manual', config) self.themes['howto'] = BuiltInTheme('howto', config) def get(self, name: str) -> Theme: """Get a theme for given *name*.""" if name in self.themes: theme = self.themes[name] else: theme = self.find_user_theme(name) if not theme: theme = Theme(name) theme.update(self.config) return theme def find_user_theme(self, name: str) -> Theme: """Find a theme named as *name* from latex_theme_path.""" for theme_path in self.theme_paths: config_path = path.join(theme_path, name, 'theme.conf') if path.isfile(config_path): try: return UserTheme(name, config_path) except ThemeError as exc: logger.warning(exc) return None ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/latex/transforms.py����������������������������������������������������0000644�0000766�0000024�00000050373�00000000000�021352� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.latex.transforms ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Transforms for LaTeX builder. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Any, Dict, List, Set, Tuple, cast from docutils import nodes from docutils.nodes import Element, Node from docutils.transforms.references import Substitutions from sphinx import addnodes from sphinx.application import Sphinx from sphinx.builders.latex.nodes import (captioned_literal_block, footnotemark, footnotetext, math_reference, thebibliography) from sphinx.domains.citation import CitationDomain from sphinx.transforms import SphinxTransform from sphinx.transforms.post_transforms import SphinxPostTransform from sphinx.util.nodes import NodeMatcher URI_SCHEMES = ('mailto:', 'http:', 'https:', 'ftp:') class FootnoteDocnameUpdater(SphinxTransform): """Add docname to footnote and footnote_reference nodes.""" default_priority = 700 TARGET_NODES = (nodes.footnote, nodes.footnote_reference) def apply(self, **kwargs: Any) -> None: matcher = NodeMatcher(*self.TARGET_NODES) for node in self.document.traverse(matcher): # type: Element node['docname'] = self.env.docname class SubstitutionDefinitionsRemover(SphinxPostTransform): """Remove ``substitution_definition node from doctrees.""" # should be invoked after Substitutions process default_priority = Substitutions.default_priority + 1 formats = ('latex',) def run(self, **kwargs: Any) -> None: for node in list(self.document.traverse(nodes.substitution_definition)): node.parent.remove(node) class ShowUrlsTransform(SphinxPostTransform): """Expand references to inline text or footnotes. For more information, see :confval:`latex_show_urls`. .. note:: This transform is used for integrated doctree """ default_priority = 400 formats = ('latex',) # references are expanded to footnotes (or not) expanded = False def run(self, **kwargs: Any) -> None: try: # replace id_prefix temporarily settings: Any = self.document.settings id_prefix = settings.id_prefix settings.id_prefix = 'show_urls' self.expand_show_urls() if self.expanded: self.renumber_footnotes() finally: # restore id_prefix settings.id_prefix = id_prefix def expand_show_urls(self) -> None: show_urls = self.config.latex_show_urls if show_urls is False or show_urls == 'no': return for node in list(self.document.traverse(nodes.reference)): uri = node.get('refuri', '') if uri.startswith(URI_SCHEMES): if uri.startswith('mailto:'): uri = uri[7:] if node.astext() != uri: index = node.parent.index(node) docname = self.get_docname_for_node(node) if show_urls == 'footnote': fn, fnref = self.create_footnote(uri, docname) node.parent.insert(index + 1, fn) node.parent.insert(index + 2, fnref) self.expanded = True else: # all other true values (b/w compat) textnode = nodes.Text(" (%s)" % uri) node.parent.insert(index + 1, textnode) def get_docname_for_node(self, node: Node) -> str: while node: if isinstance(node, nodes.document): return self.env.path2doc(node['source']) elif isinstance(node, addnodes.start_of_file): return node['docname'] else: node = node.parent return None # never reached here. only for type hinting def create_footnote(self, uri: str, docname: str) -> Tuple[nodes.footnote, nodes.footnote_reference]: # NOQA reference = nodes.reference('', nodes.Text(uri), refuri=uri, nolinkurl=True) footnote = nodes.footnote(uri, auto=1, docname=docname) footnote['names'].append('#') footnote += nodes.label('', '#') footnote += nodes.paragraph('', '', reference) self.document.note_autofootnote(footnote) footnote_ref = nodes.footnote_reference('[#]_', auto=1, refid=footnote['ids'][0], docname=docname) footnote_ref += nodes.Text('#') self.document.note_autofootnote_ref(footnote_ref) footnote.add_backref(footnote_ref['ids'][0]) return footnote, footnote_ref def renumber_footnotes(self) -> None: collector = FootnoteCollector(self.document) self.document.walkabout(collector) num = 0 for footnote in collector.auto_footnotes: # search unused footnote number while True: num += 1 if str(num) not in collector.used_footnote_numbers: break # assign new footnote number old_label = cast(nodes.label, footnote[0]) old_label.replace_self(nodes.label('', str(num))) if old_label in footnote['names']: footnote['names'].remove(old_label.astext()) footnote['names'].append(str(num)) # update footnote_references by new footnote number docname = footnote['docname'] for ref in collector.footnote_refs: if docname == ref['docname'] and footnote['ids'][0] == ref['refid']: ref.remove(ref[0]) ref += nodes.Text(str(num)) class FootnoteCollector(nodes.NodeVisitor): """Collect footnotes and footnote references on the document""" def __init__(self, document: nodes.document) -> None: self.auto_footnotes: List[nodes.footnote] = [] self.used_footnote_numbers: Set[str] = set() self.footnote_refs: List[nodes.footnote_reference] = [] super().__init__(document) def unknown_visit(self, node: Node) -> None: pass def unknown_departure(self, node: Node) -> None: pass def visit_footnote(self, node: nodes.footnote) -> None: if node.get('auto'): self.auto_footnotes.append(node) else: for name in node['names']: self.used_footnote_numbers.add(name) def visit_footnote_reference(self, node: nodes.footnote_reference) -> None: self.footnote_refs.append(node) class LaTeXFootnoteTransform(SphinxPostTransform): """Convert footnote definitions and references to appropriate form to LaTeX. * Replace footnotes on restricted zone (e.g. headings) by footnotemark node. In addition, append a footnotetext node after the zone. Before:: <section> <title> headings having footnotes <footnote_reference> 1 <footnote ids="id1"> <label> 1 <paragraph> footnote body After:: <section> <title> headings having footnotes <footnotemark refid="id1"> 1 <footnotetext ids="id1"> <label> 1 <paragraph> footnote body * Integrate footnote definitions and footnote references to single footnote node Before:: blah blah blah <footnote_reference refid="id1"> 1 blah blah blah ... <footnote ids="id1"> <label> 1 <paragraph> footnote body After:: blah blah blah <footnote ids="id1"> <label> 1 <paragraph> footnote body blah blah blah ... * Replace second and subsequent footnote references which refers same footnote definition by footnotemark node. Before:: blah blah blah <footnote_reference refid="id1"> 1 blah blah blah <footnote_reference refid="id1"> 1 blah blah blah ... <footnote ids="id1"> <label> 1 <paragraph> footnote body After:: blah blah blah <footnote ids="id1"> <label> 1 <paragraph> footnote body blah blah blah <footnotemark refid="id1"> 1 blah blah blah ... * Remove unreferenced footnotes Before:: <footnote ids="id1"> <label> 1 <paragraph> Unreferenced footnote! After:: <!-- nothing! --> * Move footnotes in a title of table or thead to head of tbody Before:: <table> <title> title having footnote_reference <footnote_reference refid="id1"> 1 <tgroup> <thead> <row> <entry> header having footnote_reference <footnote_reference refid="id2"> 2 <tbody> <row> ... <footnote ids="id1"> <label> 1 <paragraph> footnote body <footnote ids="id2"> <label> 2 <paragraph> footnote body After:: <table> <title> title having footnote_reference <footnotemark refid="id1"> 1 <tgroup> <thead> <row> <entry> header having footnote_reference <footnotemark refid="id2"> 2 <tbody> <footnotetext ids="id1"> <label> 1 <paragraph> footnote body <footnotetext ids="id2"> <label> 2 <paragraph> footnote body <row> ... """ default_priority = 600 formats = ('latex',) def run(self, **kwargs: Any) -> None: footnotes = list(self.document.traverse(nodes.footnote)) for node in footnotes: node.parent.remove(node) visitor = LaTeXFootnoteVisitor(self.document, footnotes) self.document.walkabout(visitor) class LaTeXFootnoteVisitor(nodes.NodeVisitor): def __init__(self, document: nodes.document, footnotes: List[nodes.footnote]) -> None: self.appeared: Set[Tuple[str, str]] = set() self.footnotes: List[nodes.footnote] = footnotes self.pendings: List[nodes.footnote] = [] self.table_footnotes: List[nodes.footnote] = [] self.restricted: Element = None super().__init__(document) def unknown_visit(self, node: Node) -> None: pass def unknown_departure(self, node: Node) -> None: pass def restrict(self, node: Element) -> None: if self.restricted is None: self.restricted = node def unrestrict(self, node: Element) -> None: if self.restricted == node: self.restricted = None pos = node.parent.index(node) for i, footnote, in enumerate(self.pendings): fntext = footnotetext('', *footnote.children, ids=footnote['ids']) node.parent.insert(pos + i + 1, fntext) self.pendings = [] def visit_figure(self, node: nodes.figure) -> None: self.restrict(node) def depart_figure(self, node: nodes.figure) -> None: self.unrestrict(node) def visit_term(self, node: nodes.term) -> None: self.restrict(node) def depart_term(self, node: nodes.term) -> None: self.unrestrict(node) def visit_caption(self, node: nodes.caption) -> None: self.restrict(node) def depart_caption(self, node: nodes.caption) -> None: self.unrestrict(node) def visit_title(self, node: nodes.title) -> None: if isinstance(node.parent, (nodes.section, nodes.table)): self.restrict(node) def depart_title(self, node: nodes.title) -> None: if isinstance(node.parent, nodes.section): self.unrestrict(node) elif isinstance(node.parent, nodes.table): self.table_footnotes += self.pendings self.pendings = [] self.unrestrict(node) def visit_thead(self, node: nodes.thead) -> None: self.restrict(node) def depart_thead(self, node: nodes.thead) -> None: self.table_footnotes += self.pendings self.pendings = [] self.unrestrict(node) def depart_table(self, node: nodes.table) -> None: tbody = list(node.traverse(nodes.tbody))[0] for footnote in reversed(self.table_footnotes): fntext = footnotetext('', *footnote.children, ids=footnote['ids']) tbody.insert(0, fntext) self.table_footnotes = [] def visit_footnote(self, node: nodes.footnote) -> None: self.restrict(node) def depart_footnote(self, node: nodes.footnote) -> None: self.unrestrict(node) def visit_footnote_reference(self, node: nodes.footnote_reference) -> None: number = node.astext().strip() docname = node['docname'] if self.restricted: mark = footnotemark('', number, refid=node['refid']) node.replace_self(mark) if (docname, number) not in self.appeared: footnote = self.get_footnote_by_reference(node) self.pendings.append(footnote) elif (docname, number) in self.appeared: mark = footnotemark('', number, refid=node['refid']) node.replace_self(mark) else: footnote = self.get_footnote_by_reference(node) self.footnotes.remove(footnote) node.replace_self(footnote) footnote.walkabout(self) self.appeared.add((docname, number)) raise nodes.SkipNode def get_footnote_by_reference(self, node: nodes.footnote_reference) -> nodes.footnote: docname = node['docname'] for footnote in self.footnotes: if docname == footnote['docname'] and footnote['ids'][0] == node['refid']: return footnote return None class BibliographyTransform(SphinxPostTransform): """Gather bibliography entries to tail of document. Before:: <document> <paragraph> blah blah blah <citation> ... <paragraph> blah blah blah <citation> ... ... After:: <document> <paragraph> blah blah blah <paragraph> blah blah blah ... <thebibliography> <citation> ... <citation> ... """ default_priority = 750 formats = ('latex',) def run(self, **kwargs: Any) -> None: citations = thebibliography() for node in list(self.document.traverse(nodes.citation)): node.parent.remove(node) citations += node if len(citations) > 0: self.document += citations class CitationReferenceTransform(SphinxPostTransform): """Replace pending_xref nodes for citation by citation_reference. To handle citation reference easily on LaTeX writer, this converts pending_xref nodes to citation_reference. """ default_priority = 5 # before ReferencesResolver formats = ('latex',) def run(self, **kwargs: Any) -> None: domain = cast(CitationDomain, self.env.get_domain('citation')) matcher = NodeMatcher(addnodes.pending_xref, refdomain='citation', reftype='ref') for node in self.document.traverse(matcher): # type: addnodes.pending_xref docname, labelid, _ = domain.citations.get(node['reftarget'], ('', '', 0)) if docname: citation_ref = nodes.citation_reference('', '', *node.children, docname=docname, refname=labelid) node.replace_self(citation_ref) class MathReferenceTransform(SphinxPostTransform): """Replace pending_xref nodes for math by math_reference. To handle math reference easily on LaTeX writer, this converts pending_xref nodes to math_reference. """ default_priority = 5 # before ReferencesResolver formats = ('latex',) def run(self, **kwargs: Any) -> None: equations = self.env.get_domain('math').data['objects'] for node in self.document.traverse(addnodes.pending_xref): if node['refdomain'] == 'math' and node['reftype'] in ('eq', 'numref'): docname, _ = equations.get(node['reftarget'], (None, None)) if docname: refnode = math_reference('', docname=docname, target=node['reftarget']) node.replace_self(refnode) class LiteralBlockTransform(SphinxPostTransform): """Replace container nodes for literal_block by captioned_literal_block.""" default_priority = 400 formats = ('latex',) def run(self, **kwargs: Any) -> None: matcher = NodeMatcher(nodes.container, literal_block=True) for node in self.document.traverse(matcher): # type: nodes.container newnode = captioned_literal_block('', *node.children, **node.attributes) node.replace_self(newnode) class DocumentTargetTransform(SphinxPostTransform): """Add :doc label to the first section of each document.""" default_priority = 400 formats = ('latex',) def run(self, **kwargs: Any) -> None: for node in self.document.traverse(addnodes.start_of_file): section = node.next_node(nodes.section) if section: section['ids'].append(':doc') # special label for :doc: class IndexInSectionTitleTransform(SphinxPostTransform): """Move index nodes in section title to outside of the title. LaTeX index macro is not compatible with some handling of section titles such as uppercasing done on LaTeX side (cf. fncychap handling of ``\\chapter``). Moving the index node to after the title node fixes that. Before:: <section> <title> blah blah <index entries=[...]/>blah <paragraph> blah blah blah ... After:: <section> <title> blah blah blah <index entries=[...]/> <paragraph> blah blah blah ... """ default_priority = 400 formats = ('latex',) def run(self, **kwargs: Any) -> None: for node in list(self.document.traverse(nodes.title)): if isinstance(node.parent, nodes.section): for i, index in enumerate(list(node.traverse(addnodes.index))): # move the index node next to the section title node.remove(index) node.parent.insert(i + 1, index) def setup(app: Sphinx) -> Dict[str, Any]: app.add_transform(FootnoteDocnameUpdater) app.add_post_transform(SubstitutionDefinitionsRemover) app.add_post_transform(BibliographyTransform) app.add_post_transform(CitationReferenceTransform) app.add_post_transform(DocumentTargetTransform) app.add_post_transform(IndexInSectionTitleTransform) app.add_post_transform(LaTeXFootnoteTransform) app.add_post_transform(LiteralBlockTransform) app.add_post_transform(MathReferenceTransform) app.add_post_transform(ShowUrlsTransform) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/latex/util.py����������������������������������������������������������0000644�0000766�0000024�00000003540�00000000000�020123� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.latex.util ~~~~~~~~~~~~~~~~~~~~~~~~~~ Utilities for LaTeX builder. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Optional from docutils.writers.latex2e import Babel class ExtBabel(Babel): cyrillic_languages = ('bulgarian', 'kazakh', 'mongolian', 'russian', 'ukrainian') def __init__(self, language_code: str, use_polyglossia: bool = False) -> None: self.language_code = language_code self.use_polyglossia = use_polyglossia self.supported = True super().__init__(language_code or '') def uses_cyrillic(self) -> bool: return self.language in self.cyrillic_languages def is_supported_language(self) -> bool: return self.supported def language_name(self, language_code: str) -> str: language = super().language_name(language_code) if language == 'ngerman' and self.use_polyglossia: # polyglossia calls new orthography (Neue Rechtschreibung) as # german (with new spelling option). return 'german' elif language: return language elif language_code.startswith('zh'): return 'english' # fallback to english (behaves like supported) else: self.supported = False return 'english' # fallback to english def get_mainlanguage_options(self) -> Optional[str]: """Return options for polyglossia's ``\\setmainlanguage``.""" if self.use_polyglossia is False: return None elif self.language == 'german': language = super().language_name(self.language_code) if language == 'ngerman': return 'spelling=new' else: return 'spelling=old' else: return None ����������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/linkcheck.py�����������������������������������������������������������0000644�0000766�0000024�00000070155�00000000000�017772� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.linkcheck ~~~~~~~~~~~~~~~~~~~~~~~~~ The CheckExternalLinksBuilder class. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import json import re import socket import time import warnings from datetime import datetime, timezone from email.utils import parsedate_to_datetime from html.parser import HTMLParser from os import path from queue import PriorityQueue, Queue from threading import Thread from typing import (Any, Dict, Generator, List, NamedTuple, Optional, Pattern, Set, Tuple, Union, cast) from urllib.parse import unquote, urlparse, urlunparse from docutils import nodes from docutils.nodes import Element from requests import Response from requests.exceptions import ConnectionError, HTTPError, TooManyRedirects from sphinx.application import Sphinx from sphinx.builders.dummy import DummyBuilder from sphinx.config import Config from sphinx.deprecation import RemovedInSphinx50Warning from sphinx.environment import BuildEnvironment from sphinx.locale import __ from sphinx.transforms.post_transforms import SphinxPostTransform from sphinx.util import encode_uri, logging, requests from sphinx.util.console import darkgray, darkgreen, purple, red, turquoise # type: ignore from sphinx.util.nodes import get_node_line logger = logging.getLogger(__name__) uri_re = re.compile('([a-z]+:)?//') # matches to foo:// and // (a protocol relative URL) Hyperlink = NamedTuple('Hyperlink', (('uri', str), ('docname', str), ('lineno', Optional[int]))) CheckRequest = NamedTuple('CheckRequest', (('next_check', float), ('hyperlink', Optional[Hyperlink]))) CheckResult = NamedTuple('CheckResult', (('uri', str), ('docname', str), ('lineno', int), ('status', str), ('message', str), ('code', int))) RateLimit = NamedTuple('RateLimit', (('delay', float), ('next_check', float))) # Tuple is old styled CheckRequest CheckRequestType = Union[CheckRequest, Tuple[float, str, str, int]] DEFAULT_REQUEST_HEADERS = { 'Accept': 'text/html,application/xhtml+xml;q=0.9,*/*;q=0.8', } CHECK_IMMEDIATELY = 0 QUEUE_POLL_SECS = 1 DEFAULT_DELAY = 60.0 def node_line_or_0(node: Element) -> int: """ PriorityQueue items must be comparable. The line number is part of the tuple used by the PriorityQueue, keep an homogeneous type for comparison. """ warnings.warn('node_line_or_0() is deprecated.', RemovedInSphinx50Warning, stacklevel=2) return get_node_line(node) or 0 class AnchorCheckParser(HTMLParser): """Specialized HTML parser that looks for a specific anchor.""" def __init__(self, search_anchor: str) -> None: super().__init__() self.search_anchor = search_anchor self.found = False def handle_starttag(self, tag: Any, attrs: Any) -> None: for key, value in attrs: if key in ('id', 'name') and value == self.search_anchor: self.found = True break def check_anchor(response: requests.requests.Response, anchor: str) -> bool: """Reads HTML data from a response object `response` searching for `anchor`. Returns True if anchor was found, False otherwise. """ parser = AnchorCheckParser(anchor) # Read file in chunks. If we find a matching anchor, we break # the loop early in hopes not to have to download the whole thing. for chunk in response.iter_content(chunk_size=4096, decode_unicode=True): if isinstance(chunk, bytes): # requests failed to decode chunk = chunk.decode() # manually try to decode it parser.feed(chunk) if parser.found: break parser.close() return parser.found class CheckExternalLinksBuilder(DummyBuilder): """ Checks for broken external links. """ name = 'linkcheck' epilog = __('Look for any errors in the above output or in ' '%(outdir)s/output.txt') def init(self) -> None: self.hyperlinks: Dict[str, Hyperlink] = {} self._good: Set[str] = set() self._broken: Dict[str, str] = {} self._redirected: Dict[str, Tuple[str, int]] = {} # set a timeout for non-responding servers socket.setdefaulttimeout(5.0) # create queues and worker threads self._wqueue: PriorityQueue[CheckRequestType] = PriorityQueue() self._rqueue: Queue[CheckResult] = Queue() @property def anchors_ignore(self) -> List[Pattern]: warnings.warn( "%s.%s is deprecated." % (self.__class__.__name__, "anchors_ignore"), RemovedInSphinx50Warning, stacklevel=2, ) return [re.compile(x) for x in self.config.linkcheck_anchors_ignore] @property def auth(self) -> List[Tuple[Pattern, Any]]: warnings.warn( "%s.%s is deprecated." % (self.__class__.__name__, "auth"), RemovedInSphinx50Warning, stacklevel=2, ) return [(re.compile(pattern), auth_info) for pattern, auth_info in self.config.linkcheck_auth] @property def to_ignore(self) -> List[Pattern]: warnings.warn( "%s.%s is deprecated." % (self.__class__.__name__, "to_ignore"), RemovedInSphinx50Warning, stacklevel=2, ) return [re.compile(x) for x in self.config.linkcheck_ignore] @property def good(self) -> Set[str]: warnings.warn( "%s.%s is deprecated." % (self.__class__.__name__, "good"), RemovedInSphinx50Warning, stacklevel=2, ) return self._good @property def broken(self) -> Dict[str, str]: warnings.warn( "%s.%s is deprecated." % (self.__class__.__name__, "broken"), RemovedInSphinx50Warning, stacklevel=2, ) return self._broken @property def redirected(self) -> Dict[str, Tuple[str, int]]: warnings.warn( "%s.%s is deprecated." % (self.__class__.__name__, "redirected"), RemovedInSphinx50Warning, stacklevel=2, ) return self._redirected def check_thread(self) -> None: warnings.warn( "%s.%s is deprecated." % (self.__class__.__name__, "check_thread"), RemovedInSphinx50Warning, stacklevel=2, ) # do nothing. def limit_rate(self, response: Response) -> Optional[float]: warnings.warn( "%s.%s is deprecated." % (self.__class__.__name__, "limit_rate"), RemovedInSphinx50Warning, stacklevel=2, ) worker = HyperlinkAvailabilityCheckWorker(self.env, self.config, None, None, {}) return worker.limit_rate(response) def rqueue(self, response: Response) -> Queue: warnings.warn( "%s.%s is deprecated." % (self.__class__.__name__, "rqueue"), RemovedInSphinx50Warning, stacklevel=2, ) return self._rqueue def workers(self, response: Response) -> List[Thread]: warnings.warn( "%s.%s is deprecated." % (self.__class__.__name__, "workers"), RemovedInSphinx50Warning, stacklevel=2, ) return [] def wqueue(self, response: Response) -> Queue: warnings.warn( "%s.%s is deprecated." % (self.__class__.__name__, "wqueue"), RemovedInSphinx50Warning, stacklevel=2, ) return self._wqueue def process_result(self, result: CheckResult) -> None: filename = self.env.doc2path(result.docname, None) linkstat = dict(filename=filename, lineno=result.lineno, status=result.status, code=result.code, uri=result.uri, info=result.message) self.write_linkstat(linkstat) if result.status == 'unchecked': return if result.status == 'working' and result.message == 'old': return if result.lineno: logger.info('(%16s: line %4d) ', result.docname, result.lineno, nonl=True) if result.status == 'ignored': if result.message: logger.info(darkgray('-ignored- ') + result.uri + ': ' + result.message) else: logger.info(darkgray('-ignored- ') + result.uri) elif result.status == 'local': logger.info(darkgray('-local- ') + result.uri) self.write_entry('local', result.docname, filename, result.lineno, result.uri) elif result.status == 'working': logger.info(darkgreen('ok ') + result.uri + result.message) elif result.status == 'broken': if self.app.quiet or self.app.warningiserror: logger.warning(__('broken link: %s (%s)'), result.uri, result.message, location=(result.docname, result.lineno)) else: logger.info(red('broken ') + result.uri + red(' - ' + result.message)) self.write_entry('broken', result.docname, filename, result.lineno, result.uri + ': ' + result.message) elif result.status == 'redirected': try: text, color = { 301: ('permanently', purple), 302: ('with Found', purple), 303: ('with See Other', purple), 307: ('temporarily', turquoise), 308: ('permanently', purple), }[result.code] except KeyError: text, color = ('with unknown code', purple) linkstat['text'] = text if self.config.linkcheck_allowed_redirects: logger.warning('redirect ' + result.uri + ' - ' + text + ' to ' + result.message, location=(result.docname, result.lineno)) else: logger.info(color('redirect ') + result.uri + color(' - ' + text + ' to ' + result.message)) self.write_entry('redirected ' + text, result.docname, filename, result.lineno, result.uri + ' to ' + result.message) else: raise ValueError("Unknown status %s." % result.status) def write_entry(self, what: str, docname: str, filename: str, line: int, uri: str) -> None: self.txt_outfile.write("%s:%s: [%s] %s\n" % (filename, line, what, uri)) def write_linkstat(self, data: dict) -> None: self.json_outfile.write(json.dumps(data)) self.json_outfile.write('\n') def finish(self) -> None: checker = HyperlinkAvailabilityChecker(self.env, self.config, self) logger.info('') with open(path.join(self.outdir, 'output.txt'), 'w') as self.txt_outfile,\ open(path.join(self.outdir, 'output.json'), 'w') as self.json_outfile: for result in checker.check(self.hyperlinks): self.process_result(result) if self._broken: self.app.statuscode = 1 class HyperlinkAvailabilityChecker: def __init__(self, env: BuildEnvironment, config: Config, builder: CheckExternalLinksBuilder = None) -> None: # Warning: builder argument will be removed in the sphinx-5.0. # Don't use it from extensions. # tag: RemovedInSphinx50Warning self.builder = builder self.config = config self.env = env self.rate_limits: Dict[str, RateLimit] = {} self.workers: List[Thread] = [] self.to_ignore = [re.compile(x) for x in self.config.linkcheck_ignore] if builder: self.rqueue = builder._rqueue self.wqueue = builder._wqueue else: self.rqueue = Queue() self.wqueue = PriorityQueue() def invoke_threads(self) -> None: for i in range(self.config.linkcheck_workers): thread = HyperlinkAvailabilityCheckWorker(self.env, self.config, self.rqueue, self.wqueue, self.rate_limits, self.builder) thread.start() self.workers.append(thread) def shutdown_threads(self) -> None: self.wqueue.join() for worker in self.workers: self.wqueue.put(CheckRequest(CHECK_IMMEDIATELY, None), False) def check(self, hyperlinks: Dict[str, Hyperlink]) -> Generator[CheckResult, None, None]: self.invoke_threads() total_links = 0 for hyperlink in hyperlinks.values(): if self.is_ignored_uri(hyperlink.uri): yield CheckResult(hyperlink.uri, hyperlink.docname, hyperlink.lineno, 'ignored', '', 0) else: self.wqueue.put(CheckRequest(CHECK_IMMEDIATELY, hyperlink), False) total_links += 1 done = 0 while done < total_links: yield self.rqueue.get() done += 1 self.shutdown_threads() def is_ignored_uri(self, uri: str) -> bool: return any(pat.match(uri) for pat in self.to_ignore) class HyperlinkAvailabilityCheckWorker(Thread): """A worker class for checking the availability of hyperlinks.""" def __init__(self, env: BuildEnvironment, config: Config, rqueue: Queue, wqueue: Queue, rate_limits: Dict[str, RateLimit], builder: CheckExternalLinksBuilder = None) -> None: # Warning: builder argument will be removed in the sphinx-5.0. # Don't use it from extensions. # tag: RemovedInSphinx50Warning self.config = config self.env = env self.rate_limits = rate_limits self.rqueue = rqueue self.wqueue = wqueue self.anchors_ignore = [re.compile(x) for x in self.config.linkcheck_anchors_ignore] self.auth = [(re.compile(pattern), auth_info) for pattern, auth_info in self.config.linkcheck_auth] if builder: # if given, fill the result of checks as cache self._good = builder._good self._broken = builder._broken self._redirected = builder._redirected else: # only for compatibility. Will be removed in Sphinx-5.0 self._good = set() self._broken = {} self._redirected = {} super().__init__(daemon=True) def run(self) -> None: kwargs = {} if self.config.linkcheck_timeout: kwargs['timeout'] = self.config.linkcheck_timeout def get_request_headers() -> Dict: url = urlparse(uri) candidates = ["%s://%s" % (url.scheme, url.netloc), "%s://%s/" % (url.scheme, url.netloc), uri, "*"] for u in candidates: if u in self.config.linkcheck_request_headers: headers = dict(DEFAULT_REQUEST_HEADERS) headers.update(self.config.linkcheck_request_headers[u]) return headers return {} def check_uri() -> Tuple[str, str, int]: # split off anchor if '#' in uri: req_url, anchor = uri.split('#', 1) for rex in self.anchors_ignore: if rex.match(anchor): anchor = None break else: req_url = uri anchor = None # handle non-ASCII URIs try: req_url.encode('ascii') except UnicodeError: req_url = encode_uri(req_url) # Get auth info, if any for pattern, auth_info in self.auth: if pattern.match(uri): break else: auth_info = None # update request headers for the URL kwargs['headers'] = get_request_headers() try: if anchor and self.config.linkcheck_anchors: # Read the whole document and see if #anchor exists response = requests.get(req_url, stream=True, config=self.config, auth=auth_info, **kwargs) response.raise_for_status() found = check_anchor(response, unquote(anchor)) if not found: raise Exception(__("Anchor '%s' not found") % anchor) else: try: # try a HEAD request first, which should be easier on # the server and the network response = requests.head(req_url, allow_redirects=True, config=self.config, auth=auth_info, **kwargs) response.raise_for_status() # Servers drop the connection on HEAD requests, causing # ConnectionError. except (ConnectionError, HTTPError, TooManyRedirects) as err: if isinstance(err, HTTPError) and err.response.status_code == 429: raise # retry with GET request if that fails, some servers # don't like HEAD requests. response = requests.get(req_url, stream=True, config=self.config, auth=auth_info, **kwargs) response.raise_for_status() except HTTPError as err: if err.response.status_code == 401: # We'll take "Unauthorized" as working. return 'working', ' - unauthorized', 0 elif err.response.status_code == 429: next_check = self.limit_rate(err.response) if next_check is not None: self.wqueue.put(CheckRequest(next_check, hyperlink), False) return 'rate-limited', '', 0 return 'broken', str(err), 0 elif err.response.status_code == 503: # We'll take "Service Unavailable" as ignored. return 'ignored', str(err), 0 else: return 'broken', str(err), 0 except Exception as err: return 'broken', str(err), 0 else: netloc = urlparse(req_url).netloc try: del self.rate_limits[netloc] except KeyError: pass if response.url.rstrip('/') == req_url.rstrip('/'): return 'working', '', 0 else: new_url = response.url if anchor: new_url += '#' + anchor if allowed_redirect(req_url, new_url): return 'working', '', 0 elif response.history: # history contains any redirects, get last code = response.history[-1].status_code return 'redirected', new_url, code else: return 'redirected', new_url, 0 def allowed_redirect(url: str, new_url: str) -> bool: for from_url, to_url in self.config.linkcheck_allowed_redirects.items(): if from_url.match(url) and to_url.match(new_url): return True return False def check(docname: str) -> Tuple[str, str, int]: # check for various conditions without bothering the network if len(uri) == 0 or uri.startswith(('#', 'mailto:', 'tel:')): return 'unchecked', '', 0 elif not uri.startswith(('http:', 'https:')): if uri_re.match(uri): # non supported URI schemes (ex. ftp) return 'unchecked', '', 0 else: srcdir = path.dirname(self.env.doc2path(docname)) if path.exists(path.join(srcdir, uri)): return 'working', '', 0 else: self._broken[uri] = '' return 'broken', '', 0 elif uri in self._good: return 'working', 'old', 0 elif uri in self._broken: return 'broken', self._broken[uri], 0 elif uri in self._redirected: return 'redirected', self._redirected[uri][0], self._redirected[uri][1] # need to actually check the URI for _ in range(self.config.linkcheck_retries): status, info, code = check_uri() if status != "broken": break if status == "working": self._good.add(uri) elif status == "broken": self._broken[uri] = info elif status == "redirected": self._redirected[uri] = (info, code) return (status, info, code) while True: check_request = self.wqueue.get() try: next_check, hyperlink = check_request if hyperlink is None: break uri, docname, lineno = hyperlink except ValueError: # old styled check_request (will be deprecated in Sphinx-5.0) next_check, uri, docname, lineno = check_request if uri is None: break netloc = urlparse(uri).netloc try: # Refresh rate limit. # When there are many links in the queue, workers are all stuck waiting # for responses, but the builder keeps queuing. Links in the queue may # have been queued before rate limits were discovered. next_check = self.rate_limits[netloc].next_check except KeyError: pass if next_check > time.time(): # Sleep before putting message back in the queue to avoid # waking up other threads. time.sleep(QUEUE_POLL_SECS) self.wqueue.put(CheckRequest(next_check, hyperlink), False) self.wqueue.task_done() continue status, info, code = check(docname) if status == 'rate-limited': logger.info(darkgray('-rate limited- ') + uri + darkgray(' | sleeping...')) else: self.rqueue.put(CheckResult(uri, docname, lineno, status, info, code)) self.wqueue.task_done() def limit_rate(self, response: Response) -> Optional[float]: next_check = None retry_after = response.headers.get("Retry-After") if retry_after: try: # Integer: time to wait before next attempt. delay = float(retry_after) except ValueError: try: # An HTTP-date: time of next attempt. until = parsedate_to_datetime(retry_after) except (TypeError, ValueError): # TypeError: Invalid date format. # ValueError: Invalid date, e.g. Oct 52th. pass else: next_check = datetime.timestamp(until) delay = (until - datetime.now(timezone.utc)).total_seconds() else: next_check = time.time() + delay netloc = urlparse(response.url).netloc if next_check is None: max_delay = self.config.linkcheck_rate_limit_timeout try: rate_limit = self.rate_limits[netloc] except KeyError: delay = DEFAULT_DELAY else: last_wait_time = rate_limit.delay delay = 2.0 * last_wait_time if delay > max_delay and last_wait_time < max_delay: delay = max_delay if delay > max_delay: return None next_check = time.time() + delay self.rate_limits[netloc] = RateLimit(delay, next_check) return next_check class HyperlinkCollector(SphinxPostTransform): builders = ('linkcheck',) default_priority = 800 def run(self, **kwargs: Any) -> None: builder = cast(CheckExternalLinksBuilder, self.app.builder) hyperlinks = builder.hyperlinks # reference nodes for refnode in self.document.traverse(nodes.reference): if 'refuri' not in refnode: continue uri = refnode['refuri'] newuri = self.app.emit_firstresult('linkcheck-process-uri', uri) if newuri: uri = newuri lineno = get_node_line(refnode) uri_info = Hyperlink(uri, self.env.docname, lineno) if uri not in hyperlinks: hyperlinks[uri] = uri_info # image nodes for imgnode in self.document.traverse(nodes.image): uri = imgnode['candidates'].get('?') if uri and '://' in uri: newuri = self.app.emit_firstresult('linkcheck-process-uri', uri) if newuri: uri = newuri lineno = get_node_line(imgnode) uri_info = Hyperlink(uri, self.env.docname, lineno) if uri not in hyperlinks: hyperlinks[uri] = uri_info def rewrite_github_anchor(app: Sphinx, uri: str) -> Optional[str]: """Rewrite anchor name of the hyperlink to github.com The hyperlink anchors in github.com are dynamically generated. This rewrites them before checking and makes them comparable. """ parsed = urlparse(uri) if parsed.hostname == "github.com" and parsed.fragment: prefixed = parsed.fragment.startswith('user-content-') if not prefixed: fragment = f'user-content-{parsed.fragment}' return urlunparse(parsed._replace(fragment=fragment)) return None def compile_linkcheck_allowed_redirects(app: Sphinx, config: Config) -> None: """Compile patterns in linkcheck_allowed_redirects to the regexp objects.""" for url, pattern in list(app.config.linkcheck_allowed_redirects.items()): try: app.config.linkcheck_allowed_redirects[re.compile(url)] = re.compile(pattern) except re.error as exc: logger.warning(__('Failed to compile regex in linkcheck_allowed_redirects: %r %s'), exc.pattern, exc.msg) finally: # Remove the original regexp-string app.config.linkcheck_allowed_redirects.pop(url) def setup(app: Sphinx) -> Dict[str, Any]: app.add_builder(CheckExternalLinksBuilder) app.add_post_transform(HyperlinkCollector) app.add_config_value('linkcheck_ignore', [], None) app.add_config_value('linkcheck_allowed_redirects', {}, None) app.add_config_value('linkcheck_auth', [], None) app.add_config_value('linkcheck_request_headers', {}, None) app.add_config_value('linkcheck_retries', 1, None) app.add_config_value('linkcheck_timeout', None, None, [int]) app.add_config_value('linkcheck_workers', 5, None) app.add_config_value('linkcheck_anchors', True, None) # Anchors starting with ! are ignored since they are # commonly used for dynamic pages app.add_config_value('linkcheck_anchors_ignore', ["^!"], None) app.add_config_value('linkcheck_rate_limit_timeout', 300.0, None) app.add_event('linkcheck-process-uri') app.connect('config-inited', compile_linkcheck_allowed_redirects, priority=800) # FIXME: Disable URL rewrite handler for github.com temporarily. # ref: https://github.com/sphinx-doc/sphinx/issues/9435 # app.connect('linkcheck-process-uri', rewrite_github_anchor) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/manpage.py�������������������������������������������������������������0000644�0000766�0000024�00000010546�00000000000�017445� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.manpage ~~~~~~~~~~~~~~~~~~~~~~~ Manual pages builder. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from os import path from typing import Any, Dict, List, Set, Tuple, Union from docutils.frontend import OptionParser from docutils.io import FileOutput from sphinx import addnodes from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.config import Config from sphinx.errors import NoUri from sphinx.locale import __ from sphinx.util import logging, progress_message from sphinx.util.console import darkgreen # type: ignore from sphinx.util.nodes import inline_all_toctrees from sphinx.util.osutil import ensuredir, make_filename_from_project from sphinx.writers.manpage import ManualPageTranslator, ManualPageWriter logger = logging.getLogger(__name__) class ManualPageBuilder(Builder): """ Builds groff output in manual page format. """ name = 'man' format = 'man' epilog = __('The manual pages are in %(outdir)s.') default_translator_class = ManualPageTranslator supported_image_types: List[str] = [] def init(self) -> None: if not self.config.man_pages: logger.warning(__('no "man_pages" config value found; no manual pages ' 'will be written')) def get_outdated_docs(self) -> Union[str, List[str]]: return 'all manpages' # for now def get_target_uri(self, docname: str, typ: str = None) -> str: if typ == 'token': return '' raise NoUri(docname, typ) @progress_message(__('writing')) def write(self, *ignored: Any) -> None: docwriter = ManualPageWriter(self) docsettings: Any = OptionParser( defaults=self.env.settings, components=(docwriter,), read_config_files=True).get_default_values() for info in self.config.man_pages: docname, name, description, authors, section = info if docname not in self.env.all_docs: logger.warning(__('"man_pages" config value references unknown ' 'document %s'), docname) continue if isinstance(authors, str): if authors: authors = [authors] else: authors = [] docsettings.title = name docsettings.subtitle = description docsettings.authors = authors docsettings.section = section if self.config.man_make_section_directory: dirname = 'man%s' % section ensuredir(path.join(self.outdir, dirname)) targetname = '%s/%s.%s' % (dirname, name, section) else: targetname = '%s.%s' % (name, section) logger.info(darkgreen(targetname) + ' { ', nonl=True) destination = FileOutput( destination_path=path.join(self.outdir, targetname), encoding='utf-8') tree = self.env.get_doctree(docname) docnames: Set[str] = set() largetree = inline_all_toctrees(self, docnames, docname, tree, darkgreen, [docname]) largetree.settings = docsettings logger.info('} ', nonl=True) self.env.resolve_references(largetree, docname, self) # remove pending_xref nodes for pendingnode in largetree.traverse(addnodes.pending_xref): pendingnode.replace_self(pendingnode.children) docwriter.write(largetree, destination) def finish(self) -> None: pass def default_man_pages(config: Config) -> List[Tuple[str, str, str, List[str], int]]: """ Better default man_pages settings. """ filename = make_filename_from_project(config.project) return [(config.root_doc, filename, '%s %s' % (config.project, config.release), [config.author], 1)] def setup(app: Sphinx) -> Dict[str, Any]: app.add_builder(ManualPageBuilder) app.add_config_value('man_pages', default_man_pages, None) app.add_config_value('man_show_urls', False, None) app.add_config_value('man_make_section_directory', False, None) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ����������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/singlehtml.py����������������������������������������������������������0000644�0000766�0000024�00000016600�00000000000�020200� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.singlehtml ~~~~~~~~~~~~~~~~~~~~~~~~~~ Single HTML builders. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from os import path from typing import Any, Dict, List, Tuple, Union from docutils import nodes from docutils.nodes import Node from sphinx.application import Sphinx from sphinx.builders.html import StandaloneHTMLBuilder from sphinx.environment.adapters.toctree import TocTree from sphinx.locale import __ from sphinx.util import logging, progress_message from sphinx.util.console import darkgreen # type: ignore from sphinx.util.nodes import inline_all_toctrees logger = logging.getLogger(__name__) class SingleFileHTMLBuilder(StandaloneHTMLBuilder): """ A StandaloneHTMLBuilder subclass that puts the whole document tree on one HTML page. """ name = 'singlehtml' epilog = __('The HTML page is in %(outdir)s.') copysource = False def get_outdated_docs(self) -> Union[str, List[str]]: # type: ignore return 'all documents' def get_target_uri(self, docname: str, typ: str = None) -> str: if docname in self.env.all_docs: # all references are on the same page... return self.config.root_doc + self.out_suffix + \ '#document-' + docname else: # chances are this is a html_additional_page return docname + self.out_suffix def get_relative_uri(self, from_: str, to: str, typ: str = None) -> str: # ignore source return self.get_target_uri(to, typ) def fix_refuris(self, tree: Node) -> None: # fix refuris with double anchor fname = self.config.root_doc + self.out_suffix for refnode in tree.traverse(nodes.reference): if 'refuri' not in refnode: continue refuri = refnode['refuri'] hashindex = refuri.find('#') if hashindex < 0: continue hashindex = refuri.find('#', hashindex + 1) if hashindex >= 0: refnode['refuri'] = fname + refuri[hashindex:] def _get_local_toctree(self, docname: str, collapse: bool = True, **kwargs: Any) -> str: if 'includehidden' not in kwargs: kwargs['includehidden'] = False toctree = TocTree(self.env).get_toctree_for(docname, self, collapse, **kwargs) if toctree is not None: self.fix_refuris(toctree) return self.render_partial(toctree)['fragment'] def assemble_doctree(self) -> nodes.document: master = self.config.root_doc tree = self.env.get_doctree(master) tree = inline_all_toctrees(self, set(), master, tree, darkgreen, [master]) tree['docname'] = master self.env.resolve_references(tree, master, self) self.fix_refuris(tree) return tree def assemble_toc_secnumbers(self) -> Dict[str, Dict[str, Tuple[int, ...]]]: # Assemble toc_secnumbers to resolve section numbers on SingleHTML. # Merge all secnumbers to single secnumber. # # Note: current Sphinx has refid confliction in singlehtml mode. # To avoid the problem, it replaces key of secnumbers to # tuple of docname and refid. # # There are related codes in inline_all_toctres() and # HTMLTranslter#add_secnumber(). new_secnumbers: Dict[str, Tuple[int, ...]] = {} for docname, secnums in self.env.toc_secnumbers.items(): for id, secnum in secnums.items(): alias = "%s/%s" % (docname, id) new_secnumbers[alias] = secnum return {self.config.root_doc: new_secnumbers} def assemble_toc_fignumbers(self) -> Dict[str, Dict[str, Dict[str, Tuple[int, ...]]]]: # Assemble toc_fignumbers to resolve figure numbers on SingleHTML. # Merge all fignumbers to single fignumber. # # Note: current Sphinx has refid confliction in singlehtml mode. # To avoid the problem, it replaces key of secnumbers to # tuple of docname and refid. # # There are related codes in inline_all_toctres() and # HTMLTranslter#add_fignumber(). new_fignumbers: Dict[str, Dict[str, Tuple[int, ...]]] = {} # {'foo': {'figure': {'id2': (2,), 'id1': (1,)}}, 'bar': {'figure': {'id1': (3,)}}} for docname, fignumlist in self.env.toc_fignumbers.items(): for figtype, fignums in fignumlist.items(): alias = "%s/%s" % (docname, figtype) new_fignumbers.setdefault(alias, {}) for id, fignum in fignums.items(): new_fignumbers[alias][id] = fignum return {self.config.root_doc: new_fignumbers} def get_doc_context(self, docname: str, body: str, metatags: str) -> Dict: # no relation links... toctree = TocTree(self.env).get_toctree_for(self.config.root_doc, self, False) # if there is no toctree, toc is None if toctree: self.fix_refuris(toctree) toc = self.render_partial(toctree)['fragment'] display_toc = True else: toc = '' display_toc = False return { 'parents': [], 'prev': None, 'next': None, 'docstitle': None, 'title': self.config.html_title, 'meta': None, 'body': body, 'metatags': metatags, 'rellinks': [], 'sourcename': '', 'toc': toc, 'display_toc': display_toc, } def write(self, *ignored: Any) -> None: docnames = self.env.all_docs with progress_message(__('preparing documents')): self.prepare_writing(docnames) # type: ignore with progress_message(__('assembling single document')): doctree = self.assemble_doctree() self.env.toc_secnumbers = self.assemble_toc_secnumbers() self.env.toc_fignumbers = self.assemble_toc_fignumbers() with progress_message(__('writing')): self.write_doc_serialized(self.config.root_doc, doctree) self.write_doc(self.config.root_doc, doctree) def finish(self) -> None: self.write_additional_files() self.copy_image_files() self.copy_download_files() self.copy_static_files() self.copy_extra_files() self.write_buildinfo() self.dump_inventory() @progress_message(__('writing additional files')) def write_additional_files(self) -> None: # no indices or search pages are supported # additional pages from conf.py for pagename, template in self.config.html_additional_pages.items(): logger.info(' ' + pagename, nonl=True) self.handle_page(pagename, {}, template) if self.config.html_use_opensearch: logger.info(' opensearch', nonl=True) fn = path.join(self.outdir, '_static', 'opensearch.xml') self.handle_page('opensearch', {}, 'opensearch.xml', outfilename=fn) def setup(app: Sphinx) -> Dict[str, Any]: app.setup_extension('sphinx.builders.html') app.add_builder(SingleFileHTMLBuilder) app.add_config_value('singlehtml_sidebars', lambda self: self.html_sidebars, 'html') return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ��������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/texinfo.py�������������������������������������������������������������0000644�0000766�0000024�00000022241�00000000000�017504� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.texinfo ~~~~~~~~~~~~~~~~~~~~~~~ Texinfo builder. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import os from os import path from typing import Any, Dict, Iterable, List, Tuple, Union from docutils import nodes from docutils.frontend import OptionParser from docutils.io import FileOutput from docutils.nodes import Node from sphinx import addnodes, package_dir from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.config import Config from sphinx.environment.adapters.asset import ImageAdapter from sphinx.errors import NoUri from sphinx.locale import _, __ from sphinx.util import logging, progress_message, status_iterator from sphinx.util.console import darkgreen # type: ignore from sphinx.util.docutils import new_document from sphinx.util.fileutil import copy_asset_file from sphinx.util.nodes import inline_all_toctrees from sphinx.util.osutil import SEP, ensuredir, make_filename_from_project from sphinx.writers.texinfo import TexinfoTranslator, TexinfoWriter logger = logging.getLogger(__name__) template_dir = os.path.join(package_dir, 'templates', 'texinfo') class TexinfoBuilder(Builder): """ Builds Texinfo output to create Info documentation. """ name = 'texinfo' format = 'texinfo' epilog = __('The Texinfo files are in %(outdir)s.') if os.name == 'posix': epilog += __("\nRun 'make' in that directory to run these through " "makeinfo\n" "(use 'make info' here to do that automatically).") supported_image_types = ['image/png', 'image/jpeg', 'image/gif'] default_translator_class = TexinfoTranslator def init(self) -> None: self.docnames: Iterable[str] = [] self.document_data: List[Tuple[str, str, str, str, str, str, str, bool]] = [] def get_outdated_docs(self) -> Union[str, List[str]]: return 'all documents' # for now def get_target_uri(self, docname: str, typ: str = None) -> str: if docname not in self.docnames: raise NoUri(docname, typ) else: return '%' + docname def get_relative_uri(self, from_: str, to: str, typ: str = None) -> str: # ignore source path return self.get_target_uri(to, typ) def init_document_data(self) -> None: preliminary_document_data = [list(x) for x in self.config.texinfo_documents] if not preliminary_document_data: logger.warning(__('no "texinfo_documents" config value found; no documents ' 'will be written')) return # assign subdirs to titles self.titles: List[Tuple[str, str]] = [] for entry in preliminary_document_data: docname = entry[0] if docname not in self.env.all_docs: logger.warning(__('"texinfo_documents" config value references unknown ' 'document %s'), docname) continue self.document_data.append(entry) # type: ignore if docname.endswith(SEP + 'index'): docname = docname[:-5] self.titles.append((docname, entry[2])) def write(self, *ignored: Any) -> None: self.init_document_data() for entry in self.document_data: docname, targetname, title, author = entry[:4] targetname += '.texi' direntry = description = category = '' if len(entry) > 6: direntry, description, category = entry[4:7] toctree_only = False if len(entry) > 7: toctree_only = entry[7] destination = FileOutput( destination_path=path.join(self.outdir, targetname), encoding='utf-8') with progress_message(__("processing %s") % targetname): appendices = self.config.texinfo_appendices or [] doctree = self.assemble_doctree(docname, toctree_only, appendices=appendices) with progress_message(__("writing")): self.post_process_images(doctree) docwriter = TexinfoWriter(self) settings: Any = OptionParser( defaults=self.env.settings, components=(docwriter,), read_config_files=True).get_default_values() settings.author = author settings.title = title settings.texinfo_filename = targetname[:-5] + '.info' settings.texinfo_elements = self.config.texinfo_elements settings.texinfo_dir_entry = direntry or '' settings.texinfo_dir_category = category or '' settings.texinfo_dir_description = description or '' settings.docname = docname doctree.settings = settings docwriter.write(doctree, destination) self.copy_image_files(targetname[:-5]) def assemble_doctree(self, indexfile: str, toctree_only: bool, appendices: List[str]) -> nodes.document: # NOQA self.docnames = set([indexfile] + appendices) logger.info(darkgreen(indexfile) + " ", nonl=True) tree = self.env.get_doctree(indexfile) tree['docname'] = indexfile if toctree_only: # extract toctree nodes from the tree and put them in a # fresh document new_tree = new_document('<texinfo output>') new_sect = nodes.section() new_sect += nodes.title('<Set title in conf.py>', '<Set title in conf.py>') new_tree += new_sect for node in tree.traverse(addnodes.toctree): new_sect += node tree = new_tree largetree = inline_all_toctrees(self, self.docnames, indexfile, tree, darkgreen, [indexfile]) largetree['docname'] = indexfile for docname in appendices: appendix = self.env.get_doctree(docname) appendix['docname'] = docname largetree.append(appendix) logger.info('') logger.info(__("resolving references...")) self.env.resolve_references(largetree, indexfile, self) # TODO: add support for external :ref:s for pendingnode in largetree.traverse(addnodes.pending_xref): docname = pendingnode['refdocname'] sectname = pendingnode['refsectname'] newnodes: List[Node] = [nodes.emphasis(sectname, sectname)] for subdir, title in self.titles: if docname.startswith(subdir): newnodes.append(nodes.Text(_(' (in '), _(' (in '))) newnodes.append(nodes.emphasis(title, title)) newnodes.append(nodes.Text(')', ')')) break else: pass pendingnode.replace_self(newnodes) return largetree def finish(self) -> None: self.copy_support_files() def copy_image_files(self, targetname: str) -> None: if self.images: stringify_func = ImageAdapter(self.app.env).get_original_image_uri for src in status_iterator(self.images, __('copying images... '), "brown", len(self.images), self.app.verbosity, stringify_func=stringify_func): dest = self.images[src] try: imagedir = path.join(self.outdir, targetname + '-figures') ensuredir(imagedir) copy_asset_file(path.join(self.srcdir, src), path.join(imagedir, dest)) except Exception as err: logger.warning(__('cannot copy image file %r: %s'), path.join(self.srcdir, src), err) def copy_support_files(self) -> None: try: with progress_message(__('copying Texinfo support files')): logger.info('Makefile ', nonl=True) copy_asset_file(os.path.join(template_dir, 'Makefile'), self.outdir) except OSError as err: logger.warning(__("error writing file Makefile: %s"), err) def default_texinfo_documents(config: Config) -> List[Tuple[str, str, str, str, str, str, str]]: # NOQA """ Better default texinfo_documents settings. """ filename = make_filename_from_project(config.project) return [(config.root_doc, filename, config.project, config.author, filename, 'One line description of project', 'Miscellaneous')] def setup(app: Sphinx) -> Dict[str, Any]: app.add_builder(TexinfoBuilder) app.add_config_value('texinfo_documents', default_texinfo_documents, None) app.add_config_value('texinfo_appendices', [], None) app.add_config_value('texinfo_elements', {}, None) app.add_config_value('texinfo_domain_indices', True, None, [list]) app.add_config_value('texinfo_show_urls', 'footnote', None) app.add_config_value('texinfo_no_detailmenu', False, None) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/text.py����������������������������������������������������������������0000644�0000766�0000024�00000005701�00000000000�017016� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.text ~~~~~~~~~~~~~~~~~~~~ Plain-text Sphinx builder. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from os import path from typing import Any, Dict, Iterator, Set, Tuple from docutils.io import StringOutput from docutils.nodes import Node from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.locale import __ from sphinx.util import logging from sphinx.util.osutil import ensuredir, os_path from sphinx.writers.text import TextTranslator, TextWriter logger = logging.getLogger(__name__) class TextBuilder(Builder): name = 'text' format = 'text' epilog = __('The text files are in %(outdir)s.') out_suffix = '.txt' allow_parallel = True default_translator_class = TextTranslator current_docname: str = None def init(self) -> None: # section numbers for headings in the currently visited document self.secnumbers: Dict[str, Tuple[int, ...]] = {} def get_outdated_docs(self) -> Iterator[str]: for docname in self.env.found_docs: if docname not in self.env.all_docs: yield docname continue targetname = path.join(self.outdir, docname + self.out_suffix) try: targetmtime = path.getmtime(targetname) except Exception: targetmtime = 0 try: srcmtime = path.getmtime(self.env.doc2path(docname)) if srcmtime > targetmtime: yield docname except OSError: # source doesn't exist anymore pass def get_target_uri(self, docname: str, typ: str = None) -> str: return '' def prepare_writing(self, docnames: Set[str]) -> None: self.writer = TextWriter(self) def write_doc(self, docname: str, doctree: Node) -> None: self.current_docname = docname self.secnumbers = self.env.toc_secnumbers.get(docname, {}) destination = StringOutput(encoding='utf-8') self.writer.write(doctree, destination) outfilename = path.join(self.outdir, os_path(docname) + self.out_suffix) ensuredir(path.dirname(outfilename)) try: with open(outfilename, 'w', encoding='utf-8') as f: f.write(self.writer.output) except OSError as err: logger.warning(__("error writing file %s: %s"), outfilename, err) def finish(self) -> None: pass def setup(app: Sphinx) -> Dict[str, Any]: app.add_builder(TextBuilder) app.add_config_value('text_sectionchars', '*=-~"+`', 'env') app.add_config_value('text_newlines', 'unix', 'env') app.add_config_value('text_add_secnumbers', True, 'env') app.add_config_value('text_secnumber_suffix', '. ', 'env') return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ���������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/builders/xml.py�����������������������������������������������������������������0000644�0000766�0000024�00000007204�00000000000�016632� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.builders.xml ~~~~~~~~~~~~~~~~~~~ Docutils-native XML and pseudo-XML builders. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from os import path from typing import Any, Dict, Iterator, Set, Type, Union from docutils import nodes from docutils.io import StringOutput from docutils.nodes import Node from docutils.writers.docutils_xml import XMLTranslator from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.locale import __ from sphinx.util import logging from sphinx.util.osutil import ensuredir, os_path from sphinx.writers.xml import PseudoXMLWriter, XMLWriter logger = logging.getLogger(__name__) class XMLBuilder(Builder): """ Builds Docutils-native XML. """ name = 'xml' format = 'xml' epilog = __('The XML files are in %(outdir)s.') out_suffix = '.xml' allow_parallel = True _writer_class: Union[Type[XMLWriter], Type[PseudoXMLWriter]] = XMLWriter default_translator_class = XMLTranslator def init(self) -> None: pass def get_outdated_docs(self) -> Iterator[str]: for docname in self.env.found_docs: if docname not in self.env.all_docs: yield docname continue targetname = path.join(self.outdir, docname + self.out_suffix) try: targetmtime = path.getmtime(targetname) except Exception: targetmtime = 0 try: srcmtime = path.getmtime(self.env.doc2path(docname)) if srcmtime > targetmtime: yield docname except OSError: # source doesn't exist anymore pass def get_target_uri(self, docname: str, typ: str = None) -> str: return docname def prepare_writing(self, docnames: Set[str]) -> None: self.writer = self._writer_class(self) def write_doc(self, docname: str, doctree: Node) -> None: # work around multiple string % tuple issues in docutils; # replace tuples in attribute values with lists doctree = doctree.deepcopy() for node in doctree.traverse(nodes.Element): for att, value in node.attributes.items(): if isinstance(value, tuple): node.attributes[att] = list(value) value = node.attributes[att] if isinstance(value, list): for i, val in enumerate(value): if isinstance(val, tuple): value[i] = list(val) destination = StringOutput(encoding='utf-8') self.writer.write(doctree, destination) outfilename = path.join(self.outdir, os_path(docname) + self.out_suffix) ensuredir(path.dirname(outfilename)) try: with open(outfilename, 'w', encoding='utf-8') as f: f.write(self.writer.output) except OSError as err: logger.warning(__("error writing file %s: %s"), outfilename, err) def finish(self) -> None: pass class PseudoXMLBuilder(XMLBuilder): """ Builds pseudo-XML for display purposes. """ name = 'pseudoxml' format = 'pseudoxml' epilog = __('The pseudo-XML files are in %(outdir)s.') out_suffix = '.pseudoxml' _writer_class = PseudoXMLWriter def setup(app: Sphinx) -> Dict[str, Any]: app.add_builder(XMLBuilder) app.add_builder(PseudoXMLBuilder) app.add_config_value('xml_pretty', True, 'env') return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4504368 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/cmd/����������������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�014407� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/cmd/__init__.py�����������������������������������������������������������������0000644�0000766�0000024�00000000303�00000000000�016514� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.cmd ~~~~~~~~~~ Modules for command line executables. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/cmd/build.py��������������������������������������������������������������������0000644�0000766�0000024�00000030326�00000000000�016064� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.cmd.build ~~~~~~~~~~~~~~~~ Build documentation from a provided source. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import argparse import bdb import locale import multiprocessing import os import pdb import sys import traceback from typing import IO, Any, List from docutils.utils import SystemMessage import sphinx.locale from sphinx import __display_version__, package_dir from sphinx.application import Sphinx from sphinx.errors import SphinxError from sphinx.locale import __ from sphinx.util import Tee, format_exception_cut_frames, save_traceback from sphinx.util.console import color_terminal, nocolor, red, terminal_safe # type: ignore from sphinx.util.docutils import docutils_namespace, patch_docutils def handle_exception(app: Sphinx, args: Any, exception: BaseException, stderr: IO = sys.stderr) -> None: # NOQA if isinstance(exception, bdb.BdbQuit): return if args.pdb: print(red(__('Exception occurred while building, starting debugger:')), file=stderr) traceback.print_exc() pdb.post_mortem(sys.exc_info()[2]) else: print(file=stderr) if args.verbosity or args.traceback: traceback.print_exc(None, stderr) print(file=stderr) if isinstance(exception, KeyboardInterrupt): print(__('Interrupted!'), file=stderr) elif isinstance(exception, SystemMessage): print(red(__('reST markup error:')), file=stderr) print(terminal_safe(exception.args[0]), file=stderr) elif isinstance(exception, SphinxError): print(red('%s:' % exception.category), file=stderr) print(str(exception), file=stderr) elif isinstance(exception, UnicodeError): print(red(__('Encoding error:')), file=stderr) print(terminal_safe(str(exception)), file=stderr) tbpath = save_traceback(app) print(red(__('The full traceback has been saved in %s, if you want ' 'to report the issue to the developers.') % tbpath), file=stderr) elif isinstance(exception, RuntimeError) and 'recursion depth' in str(exception): print(red(__('Recursion error:')), file=stderr) print(terminal_safe(str(exception)), file=stderr) print(file=stderr) print(__('This can happen with very large or deeply nested source ' 'files. You can carefully increase the default Python ' 'recursion limit of 1000 in conf.py with e.g.:'), file=stderr) print(' import sys; sys.setrecursionlimit(1500)', file=stderr) else: print(red(__('Exception occurred:')), file=stderr) print(format_exception_cut_frames().rstrip(), file=stderr) tbpath = save_traceback(app) print(red(__('The full traceback has been saved in %s, if you ' 'want to report the issue to the developers.') % tbpath), file=stderr) print(__('Please also report this if it was a user error, so ' 'that a better error message can be provided next time.'), file=stderr) print(__('A bug report can be filed in the tracker at ' '<https://github.com/sphinx-doc/sphinx/issues>. Thanks!'), file=stderr) def jobs_argument(value: str) -> int: """ Special type to handle 'auto' flags passed to 'sphinx-build' via -j flag. Can be expanded to handle other special scaling requests, such as setting job count to cpu_count. """ if value == 'auto': return multiprocessing.cpu_count() else: jobs = int(value) if jobs <= 0: raise argparse.ArgumentTypeError(__('job number should be a positive number')) else: return jobs def get_parser() -> argparse.ArgumentParser: parser = argparse.ArgumentParser( usage='%(prog)s [OPTIONS] SOURCEDIR OUTPUTDIR [FILENAMES...]', epilog=__('For more information, visit <https://www.sphinx-doc.org/>.'), description=__(""" Generate documentation from source files. sphinx-build generates documentation from the files in SOURCEDIR and places it in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration settings. The 'sphinx-quickstart' tool may be used to generate template files, including 'conf.py' sphinx-build can create documentation in different formats. A format is selected by specifying the builder name on the command line; it defaults to HTML. Builders can also perform other tasks related to documentation processing. By default, everything that is outdated is built. Output only for selected files can be built by specifying individual filenames. """)) parser.add_argument('--version', action='version', dest='show_version', version='%%(prog)s %s' % __display_version__) parser.add_argument('sourcedir', help=__('path to documentation source files')) parser.add_argument('outputdir', help=__('path to output directory')) parser.add_argument('filenames', nargs='*', help=__('a list of specific files to rebuild. Ignored ' 'if -a is specified')) group = parser.add_argument_group(__('general options')) group.add_argument('-b', metavar='BUILDER', dest='builder', default='html', help=__('builder to use (default: html)')) group.add_argument('-a', action='store_true', dest='force_all', help=__('write all files (default: only write new and ' 'changed files)')) group.add_argument('-E', action='store_true', dest='freshenv', help=__('don\'t use a saved environment, always read ' 'all files')) group.add_argument('-d', metavar='PATH', dest='doctreedir', help=__('path for the cached environment and doctree ' 'files (default: OUTPUTDIR/.doctrees)')) group.add_argument('-j', metavar='N', default=1, type=jobs_argument, dest='jobs', help=__('build in parallel with N processes where ' 'possible (special value "auto" will set N to cpu-count)')) group = parser.add_argument_group('build configuration options') group.add_argument('-c', metavar='PATH', dest='confdir', help=__('path where configuration file (conf.py) is ' 'located (default: same as SOURCEDIR)')) group.add_argument('-C', action='store_true', dest='noconfig', help=__('use no config file at all, only -D options')) group.add_argument('-D', metavar='setting=value', action='append', dest='define', default=[], help=__('override a setting in configuration file')) group.add_argument('-A', metavar='name=value', action='append', dest='htmldefine', default=[], help=__('pass a value into HTML templates')) group.add_argument('-t', metavar='TAG', action='append', dest='tags', default=[], help=__('define tag: include "only" blocks with TAG')) group.add_argument('-n', action='store_true', dest='nitpicky', help=__('nit-picky mode, warn about all missing ' 'references')) group = parser.add_argument_group(__('console output options')) group.add_argument('-v', action='count', dest='verbosity', default=0, help=__('increase verbosity (can be repeated)')) group.add_argument('-q', action='store_true', dest='quiet', help=__('no output on stdout, just warnings on stderr')) group.add_argument('-Q', action='store_true', dest='really_quiet', help=__('no output at all, not even warnings')) group.add_argument('--color', action='store_const', const='yes', default='auto', help=__('do emit colored output (default: auto-detect)')) group.add_argument('-N', '--no-color', dest='color', action='store_const', const='no', help=__('do not emit colored output (default: ' 'auto-detect)')) group.add_argument('-w', metavar='FILE', dest='warnfile', help=__('write warnings (and errors) to given file')) group.add_argument('-W', action='store_true', dest='warningiserror', help=__('turn warnings into errors')) group.add_argument('--keep-going', action='store_true', dest='keep_going', help=__("with -W, keep going when getting warnings")) group.add_argument('-T', action='store_true', dest='traceback', help=__('show full traceback on exception')) group.add_argument('-P', action='store_true', dest='pdb', help=__('run Pdb on exception')) return parser def make_main(argv: List[str] = sys.argv[1:]) -> int: """Sphinx build "make mode" entry.""" from sphinx.cmd import make_mode return make_mode.run_make_mode(argv[1:]) def build_main(argv: List[str] = sys.argv[1:]) -> int: """Sphinx build "main" command-line entry.""" parser = get_parser() args = parser.parse_args(argv) if args.noconfig: args.confdir = None elif not args.confdir: args.confdir = args.sourcedir if not args.doctreedir: args.doctreedir = os.path.join(args.outputdir, '.doctrees') # handle remaining filename arguments filenames = args.filenames missing_files = [] for filename in filenames: if not os.path.isfile(filename): missing_files.append(filename) if missing_files: parser.error(__('cannot find files %r') % missing_files) if args.force_all and filenames: parser.error(__('cannot combine -a option and filenames')) if args.color == 'no' or (args.color == 'auto' and not color_terminal()): nocolor() status = sys.stdout warning = sys.stderr error = sys.stderr if args.quiet: status = None if args.really_quiet: status = warning = None if warning and args.warnfile: try: warnfp = open(args.warnfile, 'w') except Exception as exc: parser.error(__('cannot open warning file %r: %s') % ( args.warnfile, exc)) warning = Tee(warning, warnfp) # type: ignore error = warning confoverrides = {} for val in args.define: try: key, val = val.split('=', 1) except ValueError: parser.error(__('-D option argument must be in the form name=value')) confoverrides[key] = val for val in args.htmldefine: try: key, val = val.split('=') except ValueError: parser.error(__('-A option argument must be in the form name=value')) try: val = int(val) except ValueError: pass confoverrides['html_context.%s' % key] = val if args.nitpicky: confoverrides['nitpicky'] = True app = None try: confdir = args.confdir or args.sourcedir with patch_docutils(confdir), docutils_namespace(): app = Sphinx(args.sourcedir, args.confdir, args.outputdir, args.doctreedir, args.builder, confoverrides, status, warning, args.freshenv, args.warningiserror, args.tags, args.verbosity, args.jobs, args.keep_going) app.build(args.force_all, filenames) return app.statuscode except (Exception, KeyboardInterrupt) as exc: handle_exception(app, args, exc, error) return 2 def main(argv: List[str] = sys.argv[1:]) -> int: sphinx.locale.setlocale(locale.LC_ALL, '') sphinx.locale.init_console(os.path.join(package_dir, 'locale'), 'sphinx') if argv[:1] == ['-M']: return make_main(argv) else: return build_main(argv) if __name__ == '__main__': sys.exit(main(sys.argv[1:])) ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/cmd/make_mode.py����������������������������������������������������������������0000644�0000766�0000024�00000014664�00000000000�016715� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.cmd.make_mode ~~~~~~~~~~~~~~~~~~~~ sphinx-build -M command-line handling. This replaces the old, platform-dependent and once-generated content of Makefile / make.bat. This is in its own module so that importing it is fast. It should not import the main Sphinx modules (like sphinx.applications, sphinx.builders). :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import os import subprocess import sys from os import path from typing import List import sphinx from sphinx.cmd.build import build_main from sphinx.util.console import blue, bold, color_terminal, nocolor # type: ignore from sphinx.util.osutil import cd, rmtree BUILDERS = [ ("", "html", "to make standalone HTML files"), ("", "dirhtml", "to make HTML files named index.html in directories"), ("", "singlehtml", "to make a single large HTML file"), ("", "pickle", "to make pickle files"), ("", "json", "to make JSON files"), ("", "htmlhelp", "to make HTML files and an HTML help project"), ("", "qthelp", "to make HTML files and a qthelp project"), ("", "devhelp", "to make HTML files and a Devhelp project"), ("", "epub", "to make an epub"), ("", "latex", "to make LaTeX files, you can set PAPER=a4 or PAPER=letter"), ("posix", "latexpdf", "to make LaTeX and PDF files (default pdflatex)"), ("posix", "latexpdfja", "to make LaTeX files and run them through platex/dvipdfmx"), ("", "text", "to make text files"), ("", "man", "to make manual pages"), ("", "texinfo", "to make Texinfo files"), ("posix", "info", "to make Texinfo files and run them through makeinfo"), ("", "gettext", "to make PO message catalogs"), ("", "changes", "to make an overview of all changed/added/deprecated items"), ("", "xml", "to make Docutils-native XML files"), ("", "pseudoxml", "to make pseudoxml-XML files for display purposes"), ("", "linkcheck", "to check all external links for integrity"), ("", "doctest", "to run all doctests embedded in the documentation " "(if enabled)"), ("", "coverage", "to run coverage check of the documentation (if enabled)"), ("", "clean", "to remove everything in the build directory"), ] class Make: def __init__(self, srcdir: str, builddir: str, opts: List[str]) -> None: self.srcdir = srcdir self.builddir = builddir self.opts = opts self.makecmd = os.environ.get('MAKE', 'make') # refer $MAKE to determine make command def builddir_join(self, *comps: str) -> str: return path.join(self.builddir, *comps) def build_clean(self) -> int: srcdir = path.abspath(self.srcdir) builddir = path.abspath(self.builddir) if not path.exists(self.builddir): return 0 elif not path.isdir(self.builddir): print("Error: %r is not a directory!" % self.builddir) return 1 elif srcdir == builddir: print("Error: %r is same as source directory!" % self.builddir) return 1 elif path.commonpath([srcdir, builddir]) == builddir: print("Error: %r directory contains source directory!" % self.builddir) return 1 print("Removing everything under %r..." % self.builddir) for item in os.listdir(self.builddir): rmtree(self.builddir_join(item)) return 0 def build_help(self) -> None: if not color_terminal(): nocolor() print(bold("Sphinx v%s" % sphinx.__display_version__)) print("Please use `make %s' where %s is one of" % ((blue('target'),) * 2)) for osname, bname, description in BUILDERS: if not osname or os.name == osname: print(' %s %s' % (blue(bname.ljust(10)), description)) def build_latexpdf(self) -> int: if self.run_generic_build('latex') > 0: return 1 if sys.platform == 'win32': makecmd = os.environ.get('MAKE', 'make.bat') else: makecmd = self.makecmd try: with cd(self.builddir_join('latex')): return subprocess.call([makecmd, 'all-pdf']) except OSError: print('Error: Failed to run: %s' % makecmd) return 1 def build_latexpdfja(self) -> int: if self.run_generic_build('latex') > 0: return 1 if sys.platform == 'win32': makecmd = os.environ.get('MAKE', 'make.bat') else: makecmd = self.makecmd try: with cd(self.builddir_join('latex')): return subprocess.call([makecmd, 'all-pdf']) except OSError: print('Error: Failed to run: %s' % makecmd) return 1 def build_info(self) -> int: if self.run_generic_build('texinfo') > 0: return 1 try: with cd(self.builddir_join('texinfo')): return subprocess.call([self.makecmd, 'info']) except OSError: print('Error: Failed to run: %s' % self.makecmd) return 1 def build_gettext(self) -> int: dtdir = self.builddir_join('gettext', '.doctrees') if self.run_generic_build('gettext', doctreedir=dtdir) > 0: return 1 return 0 def run_generic_build(self, builder: str, doctreedir: str = None) -> int: # compatibility with old Makefile papersize = os.getenv('PAPER', '') opts = self.opts if papersize in ('a4', 'letter'): opts.extend(['-D', 'latex_elements.papersize=' + papersize + 'paper']) if doctreedir is None: doctreedir = self.builddir_join('doctrees') args = ['-b', builder, '-d', doctreedir, self.srcdir, self.builddir_join(builder)] return build_main(args + opts) def run_make_mode(args: List[str]) -> int: if len(args) < 3: print('Error: at least 3 arguments (builder, source ' 'dir, build dir) are required.', file=sys.stderr) return 1 make = Make(args[1], args[2], args[3:]) run_method = 'build_' + args[0] if hasattr(make, run_method): return getattr(make, run_method)() return make.run_generic_build(args[0]) ����������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/cmd/quickstart.py���������������������������������������������������������������0000644�0000766�0000024�00000056617�00000000000�017172� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.cmd.quickstart ~~~~~~~~~~~~~~~~~~~~~ Quickly setup documentation source to work with Sphinx. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import argparse import locale import os import sys import time from collections import OrderedDict from os import path from typing import Any, Callable, Dict, List, Union # try to import readline, unix specific enhancement try: import readline if readline.__doc__ and 'libedit' in readline.__doc__: readline.parse_and_bind("bind ^I rl_complete") USE_LIBEDIT = True else: readline.parse_and_bind("tab: complete") USE_LIBEDIT = False except ImportError: readline = None USE_LIBEDIT = False from docutils.utils import column_width import sphinx.locale from sphinx import __display_version__, package_dir from sphinx.locale import __ from sphinx.util.console import bold, color_terminal, colorize, nocolor, red # type: ignore from sphinx.util.osutil import ensuredir from sphinx.util.template import SphinxRenderer EXTENSIONS = OrderedDict([ ('autodoc', __('automatically insert docstrings from modules')), ('doctest', __('automatically test code snippets in doctest blocks')), ('intersphinx', __('link between Sphinx documentation of different projects')), ('todo', __('write "todo" entries that can be shown or hidden on build')), ('coverage', __('checks for documentation coverage')), ('imgmath', __('include math, rendered as PNG or SVG images')), ('mathjax', __('include math, rendered in the browser by MathJax')), ('ifconfig', __('conditional inclusion of content based on config values')), ('viewcode', __('include links to the source code of documented Python objects')), ('githubpages', __('create .nojekyll file to publish the document on GitHub pages')), ]) DEFAULTS = { 'path': '.', 'sep': False, 'dot': '_', 'language': None, 'suffix': '.rst', 'master': 'index', 'makefile': True, 'batchfile': True, } PROMPT_PREFIX = '> ' if sys.platform == 'win32': # On Windows, show questions as bold because of color scheme of PowerShell (refs: #5294). COLOR_QUESTION = 'bold' else: COLOR_QUESTION = 'purple' # function to get input from terminal -- overridden by the test suite def term_input(prompt: str) -> str: if sys.platform == 'win32': # Important: On windows, readline is not enabled by default. In these # environment, escape sequences have been broken. To avoid the # problem, quickstart uses ``print()`` to show prompt. print(prompt, end='') return input('') else: return input(prompt) class ValidationError(Exception): """Raised for validation errors.""" def is_path(x: str) -> str: x = path.expanduser(x) if not path.isdir(x): raise ValidationError(__("Please enter a valid path name.")) return x def is_path_or_empty(x: str) -> str: if x == '': return x return is_path(x) def allow_empty(x: str) -> str: return x def nonempty(x: str) -> str: if not x: raise ValidationError(__("Please enter some text.")) return x def choice(*l: str) -> Callable[[str], str]: def val(x: str) -> str: if x not in l: raise ValidationError(__('Please enter one of %s.') % ', '.join(l)) return x return val def boolean(x: str) -> bool: if x.upper() not in ('Y', 'YES', 'N', 'NO'): raise ValidationError(__("Please enter either 'y' or 'n'.")) return x.upper() in ('Y', 'YES') def suffix(x: str) -> str: if not (x[0:1] == '.' and len(x) > 1): raise ValidationError(__("Please enter a file suffix, e.g. '.rst' or '.txt'.")) return x def ok(x: str) -> str: return x def do_prompt(text: str, default: str = None, validator: Callable[[str], Any] = nonempty) -> Union[str, bool]: # NOQA while True: if default is not None: prompt = PROMPT_PREFIX + '%s [%s]: ' % (text, default) else: prompt = PROMPT_PREFIX + text + ': ' if USE_LIBEDIT: # Note: libedit has a problem for combination of ``input()`` and escape # sequence (see #5335). To avoid the problem, all prompts are not colored # on libedit. pass elif readline: # pass input_mode=True if readline available prompt = colorize(COLOR_QUESTION, prompt, input_mode=True) else: prompt = colorize(COLOR_QUESTION, prompt, input_mode=False) x = term_input(prompt).strip() if default and not x: x = default try: x = validator(x) except ValidationError as err: print(red('* ' + str(err))) continue break return x class QuickstartRenderer(SphinxRenderer): def __init__(self, templatedir: str) -> None: self.templatedir = templatedir or '' super().__init__() def _has_custom_template(self, template_name: str) -> bool: """Check if custom template file exists. Note: Please don't use this function from extensions. It will be removed in the future without deprecation period. """ template = path.join(self.templatedir, path.basename(template_name)) if self.templatedir and path.exists(template): return True else: return False def render(self, template_name: str, context: Dict) -> str: if self._has_custom_template(template_name): custom_template = path.join(self.templatedir, path.basename(template_name)) return self.render_from_file(custom_template, context) else: return super().render(template_name, context) def ask_user(d: Dict) -> None: """Ask the user for quickstart values missing from *d*. Values are: * path: root path * sep: separate source and build dirs (bool) * dot: replacement for dot in _templates etc. * project: project name * author: author names * version: version of project * release: release of project * language: document language * suffix: source file suffix * master: master document name * extensions: extensions to use (list) * makefile: make Makefile * batchfile: make command file """ print(bold(__('Welcome to the Sphinx %s quickstart utility.')) % __display_version__) print() print(__('Please enter values for the following settings (just press Enter to\n' 'accept a default value, if one is given in brackets).')) if 'path' in d: print() print(bold(__('Selected root path: %s')) % d['path']) else: print() print(__('Enter the root path for documentation.')) d['path'] = do_prompt(__('Root path for the documentation'), '.', is_path) while path.isfile(path.join(d['path'], 'conf.py')) or \ path.isfile(path.join(d['path'], 'source', 'conf.py')): print() print(bold(__('Error: an existing conf.py has been found in the ' 'selected root path.'))) print(__('sphinx-quickstart will not overwrite existing Sphinx projects.')) print() d['path'] = do_prompt(__('Please enter a new root path (or just Enter to exit)'), '', is_path_or_empty) if not d['path']: sys.exit(1) if 'sep' not in d: print() print(__('You have two options for placing the build directory for Sphinx output.\n' 'Either, you use a directory "_build" within the root path, or you separate\n' '"source" and "build" directories within the root path.')) d['sep'] = do_prompt(__('Separate source and build directories (y/n)'), 'n', boolean) if 'dot' not in d: print() print(__('Inside the root directory, two more directories will be created; "_templates"\n' # NOQA 'for custom HTML templates and "_static" for custom stylesheets and other static\n' # NOQA 'files. You can enter another prefix (such as ".") to replace the underscore.')) # NOQA d['dot'] = do_prompt(__('Name prefix for templates and static dir'), '_', ok) if 'project' not in d: print() print(__('The project name will occur in several places in the built documentation.')) d['project'] = do_prompt(__('Project name')) if 'author' not in d: d['author'] = do_prompt(__('Author name(s)')) if 'version' not in d: print() print(__('Sphinx has the notion of a "version" and a "release" for the\n' 'software. Each version can have multiple releases. For example, for\n' 'Python the version is something like 2.5 or 3.0, while the release is\n' 'something like 2.5.1 or 3.0a1. If you don\'t need this dual structure,\n' 'just set both to the same value.')) d['version'] = do_prompt(__('Project version'), '', allow_empty) if 'release' not in d: d['release'] = do_prompt(__('Project release'), d['version'], allow_empty) if 'language' not in d: print() print(__('If the documents are to be written in a language other than English,\n' 'you can select a language here by its language code. Sphinx will then\n' 'translate text that it generates into that language.\n' '\n' 'For a list of supported codes, see\n' 'https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.')) # NOQA d['language'] = do_prompt(__('Project language'), 'en') if d['language'] == 'en': d['language'] = None if 'suffix' not in d: print() print(__('The file name suffix for source files. Commonly, this is either ".txt"\n' 'or ".rst". Only files with this suffix are considered documents.')) d['suffix'] = do_prompt(__('Source file suffix'), '.rst', suffix) if 'master' not in d: print() print(__('One document is special in that it is considered the top node of the\n' '"contents tree", that is, it is the root of the hierarchical structure\n' 'of the documents. Normally, this is "index", but if your "index"\n' 'document is a custom template, you can also set this to another filename.')) d['master'] = do_prompt(__('Name of your master document (without suffix)'), 'index') while path.isfile(path.join(d['path'], d['master'] + d['suffix'])) or \ path.isfile(path.join(d['path'], 'source', d['master'] + d['suffix'])): print() print(bold(__('Error: the master file %s has already been found in the ' 'selected root path.') % (d['master'] + d['suffix']))) print(__('sphinx-quickstart will not overwrite the existing file.')) print() d['master'] = do_prompt(__('Please enter a new file name, or rename the ' 'existing file and press Enter'), d['master']) if 'extensions' not in d: print(__('Indicate which of the following Sphinx extensions should be enabled:')) d['extensions'] = [] for name, description in EXTENSIONS.items(): if do_prompt('%s: %s (y/n)' % (name, description), 'n', boolean): d['extensions'].append('sphinx.ext.%s' % name) # Handle conflicting options if {'sphinx.ext.imgmath', 'sphinx.ext.mathjax'}.issubset(d['extensions']): print(__('Note: imgmath and mathjax cannot be enabled at the same time. ' 'imgmath has been deselected.')) d['extensions'].remove('sphinx.ext.imgmath') if 'makefile' not in d: print() print(__('A Makefile and a Windows command file can be generated for you so that you\n' 'only have to run e.g. `make html\' instead of invoking sphinx-build\n' 'directly.')) d['makefile'] = do_prompt(__('Create Makefile? (y/n)'), 'y', boolean) if 'batchfile' not in d: d['batchfile'] = do_prompt(__('Create Windows command file? (y/n)'), 'y', boolean) print() def generate(d: Dict, overwrite: bool = True, silent: bool = False, templatedir: str = None ) -> None: """Generate project based on values in *d*.""" template = QuickstartRenderer(templatedir=templatedir) if 'mastertoctree' not in d: d['mastertoctree'] = '' if 'mastertocmaxdepth' not in d: d['mastertocmaxdepth'] = 2 d['root_doc'] = d['master'] d['now'] = time.asctime() d['project_underline'] = column_width(d['project']) * '=' d.setdefault('extensions', []) d['copyright'] = time.strftime('%Y') + ', ' + d['author'] d["path"] = os.path.abspath(d['path']) ensuredir(d['path']) srcdir = path.join(d['path'], 'source') if d['sep'] else d['path'] ensuredir(srcdir) if d['sep']: builddir = path.join(d['path'], 'build') d['exclude_patterns'] = '' else: builddir = path.join(srcdir, d['dot'] + 'build') exclude_patterns = map(repr, [ d['dot'] + 'build', 'Thumbs.db', '.DS_Store', ]) d['exclude_patterns'] = ', '.join(exclude_patterns) ensuredir(builddir) ensuredir(path.join(srcdir, d['dot'] + 'templates')) ensuredir(path.join(srcdir, d['dot'] + 'static')) def write_file(fpath: str, content: str, newline: str = None) -> None: if overwrite or not path.isfile(fpath): if 'quiet' not in d: print(__('Creating file %s.') % fpath) with open(fpath, 'wt', encoding='utf-8', newline=newline) as f: f.write(content) else: if 'quiet' not in d: print(__('File %s already exists, skipping.') % fpath) conf_path = os.path.join(templatedir, 'conf.py_t') if templatedir else None if not conf_path or not path.isfile(conf_path): conf_path = os.path.join(package_dir, 'templates', 'quickstart', 'conf.py_t') with open(conf_path) as f: conf_text = f.read() write_file(path.join(srcdir, 'conf.py'), template.render_string(conf_text, d)) masterfile = path.join(srcdir, d['master'] + d['suffix']) if template._has_custom_template('quickstart/master_doc.rst_t'): msg = ('A custom template `master_doc.rst_t` found. It has been renamed to ' '`root_doc.rst_t`. Please rename it on your project too.') print(colorize('red', msg)) # RemovedInSphinx60Warning write_file(masterfile, template.render('quickstart/master_doc.rst_t', d)) else: write_file(masterfile, template.render('quickstart/root_doc.rst_t', d)) if d.get('make_mode') is True: makefile_template = 'quickstart/Makefile.new_t' batchfile_template = 'quickstart/make.bat.new_t' else: makefile_template = 'quickstart/Makefile_t' batchfile_template = 'quickstart/make.bat_t' if d['makefile'] is True: d['rsrcdir'] = 'source' if d['sep'] else '.' d['rbuilddir'] = 'build' if d['sep'] else d['dot'] + 'build' # use binary mode, to avoid writing \r\n on Windows write_file(path.join(d['path'], 'Makefile'), template.render(makefile_template, d), '\n') if d['batchfile'] is True: d['rsrcdir'] = 'source' if d['sep'] else '.' d['rbuilddir'] = 'build' if d['sep'] else d['dot'] + 'build' write_file(path.join(d['path'], 'make.bat'), template.render(batchfile_template, d), '\r\n') if silent: return print() print(bold(__('Finished: An initial directory structure has been created.'))) print() print(__('You should now populate your master file %s and create other documentation\n' 'source files. ') % masterfile, end='') if d['makefile'] or d['batchfile']: print(__('Use the Makefile to build the docs, like so:\n' ' make builder')) else: print(__('Use the sphinx-build command to build the docs, like so:\n' ' sphinx-build -b builder %s %s') % (srcdir, builddir)) print(__('where "builder" is one of the supported builders, ' 'e.g. html, latex or linkcheck.')) print() def valid_dir(d: Dict) -> bool: dir = d['path'] if not path.exists(dir): return True if not path.isdir(dir): return False if {'Makefile', 'make.bat'} & set(os.listdir(dir)): return False if d['sep']: dir = os.path.join('source', dir) if not path.exists(dir): return True if not path.isdir(dir): return False reserved_names = [ 'conf.py', d['dot'] + 'static', d['dot'] + 'templates', d['master'] + d['suffix'], ] if set(reserved_names) & set(os.listdir(dir)): return False return True def get_parser() -> argparse.ArgumentParser: description = __( "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" ) parser = argparse.ArgumentParser( usage='%(prog)s [OPTIONS] <PROJECT_DIR>', epilog=__("For more information, visit <https://www.sphinx-doc.org/>."), description=description) parser.add_argument('-q', '--quiet', action='store_true', dest='quiet', default=None, help=__('quiet mode')) parser.add_argument('--version', action='version', dest='show_version', version='%%(prog)s %s' % __display_version__) parser.add_argument('path', metavar='PROJECT_DIR', default='.', nargs='?', help=__('project root')) group = parser.add_argument_group(__('Structure options')) group.add_argument('--sep', action='store_true', dest='sep', default=None, help=__('if specified, separate source and build dirs')) group.add_argument('--no-sep', action='store_false', dest='sep', help=__('if specified, create build dir under source dir')) group.add_argument('--dot', metavar='DOT', default='_', help=__('replacement for dot in _templates etc.')) group = parser.add_argument_group(__('Project basic options')) group.add_argument('-p', '--project', metavar='PROJECT', dest='project', help=__('project name')) group.add_argument('-a', '--author', metavar='AUTHOR', dest='author', help=__('author names')) group.add_argument('-v', metavar='VERSION', dest='version', default='', help=__('version of project')) group.add_argument('-r', '--release', metavar='RELEASE', dest='release', help=__('release of project')) group.add_argument('-l', '--language', metavar='LANGUAGE', dest='language', help=__('document language')) group.add_argument('--suffix', metavar='SUFFIX', default='.rst', help=__('source file suffix')) group.add_argument('--master', metavar='MASTER', default='index', help=__('master document name')) group.add_argument('--epub', action='store_true', default=False, help=__('use epub')) group = parser.add_argument_group(__('Extension options')) for ext in EXTENSIONS: group.add_argument('--ext-%s' % ext, action='append_const', const='sphinx.ext.%s' % ext, dest='extensions', help=__('enable %s extension') % ext) group.add_argument('--extensions', metavar='EXTENSIONS', dest='extensions', action='append', help=__('enable arbitrary extensions')) group = parser.add_argument_group(__('Makefile and Batchfile creation')) group.add_argument('--makefile', action='store_true', dest='makefile', default=True, help=__('create makefile')) group.add_argument('--no-makefile', action='store_false', dest='makefile', help=__('do not create makefile')) group.add_argument('--batchfile', action='store_true', dest='batchfile', default=True, help=__('create batchfile')) group.add_argument('--no-batchfile', action='store_false', dest='batchfile', help=__('do not create batchfile')) group.add_argument('-m', '--use-make-mode', action='store_true', dest='make_mode', default=True, help=__('use make-mode for Makefile/make.bat')) group.add_argument('-M', '--no-use-make-mode', action='store_false', dest='make_mode', help=__('do not use make-mode for Makefile/make.bat')) group = parser.add_argument_group(__('Project templating')) group.add_argument('-t', '--templatedir', metavar='TEMPLATEDIR', dest='templatedir', help=__('template directory for template files')) group.add_argument('-d', metavar='NAME=VALUE', action='append', dest='variables', help=__('define a template variable')) return parser def main(argv: List[str] = sys.argv[1:]) -> int: sphinx.locale.setlocale(locale.LC_ALL, '') sphinx.locale.init_console(os.path.join(package_dir, 'locale'), 'sphinx') if not color_terminal(): nocolor() # parse options parser = get_parser() try: args = parser.parse_args(argv) except SystemExit as err: return err.code d = vars(args) # delete None or False value d = {k: v for k, v in d.items() if v is not None} # handle use of CSV-style extension values d.setdefault('extensions', []) for ext in d['extensions'][:]: if ',' in ext: d['extensions'].remove(ext) d['extensions'].extend(ext.split(',')) try: if 'quiet' in d: if not {'project', 'author'}.issubset(d): print(__('"quiet" is specified, but any of "project" or ' '"author" is not specified.')) return 1 if {'quiet', 'project', 'author'}.issubset(d): # quiet mode with all required params satisfied, use default d.setdefault('version', '') d.setdefault('release', d['version']) d2 = DEFAULTS.copy() d2.update(d) d = d2 if not valid_dir(d): print() print(bold(__('Error: specified path is not a directory, or sphinx' ' files already exist.'))) print(__('sphinx-quickstart only generate into a empty directory.' ' Please specify a new root path.')) return 1 else: ask_user(d) except (KeyboardInterrupt, EOFError): print() print('[Interrupted.]') return 130 # 128 + SIGINT for variable in d.get('variables', []): try: name, value = variable.split('=') d[name] = value except ValueError: print(__('Invalid template variable: %s') % variable) generate(d, overwrite=False, templatedir=args.templatedir) return 0 if __name__ == '__main__': sys.exit(main(sys.argv[1:])) �����������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/config.py�����������������������������������������������������������������������0000644�0000766�0000024�00000047656�00000000000�015505� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.config ~~~~~~~~~~~~~ Build configuration file handling. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import re import traceback import types from collections import OrderedDict from os import getenv, path from typing import (TYPE_CHECKING, Any, Callable, Dict, Generator, Iterator, List, NamedTuple, Optional, Set, Tuple, Union) from sphinx.errors import ConfigError, ExtensionError from sphinx.locale import _, __ from sphinx.util import logging from sphinx.util.i18n import format_date from sphinx.util.osutil import cd, fs_encoding from sphinx.util.tags import Tags from sphinx.util.typing import NoneType if TYPE_CHECKING: from sphinx.application import Sphinx from sphinx.environment import BuildEnvironment logger = logging.getLogger(__name__) CONFIG_FILENAME = 'conf.py' UNSERIALIZABLE_TYPES = (type, types.ModuleType, types.FunctionType) copyright_year_re = re.compile(r'^((\d{4}-)?)(\d{4})(?=[ ,])') class ConfigValue(NamedTuple): name: str value: Any rebuild: Union[bool, str] def is_serializable(obj: Any) -> bool: """Check if object is serializable or not.""" if isinstance(obj, UNSERIALIZABLE_TYPES): return False elif isinstance(obj, dict): for key, value in obj.items(): if not is_serializable(key) or not is_serializable(value): return False elif isinstance(obj, (list, tuple, set)): return all(is_serializable(i) for i in obj) return True class ENUM: """Represents the candidates which a config value should be one of. Example: app.add_config_value('latex_show_urls', 'no', None, ENUM('no', 'footnote', 'inline')) """ def __init__(self, *candidates: str) -> None: self.candidates = candidates def match(self, value: Union[str, List, Tuple]) -> bool: if isinstance(value, (list, tuple)): return all(item in self.candidates for item in value) else: return value in self.candidates class Config: """Configuration file abstraction. The config object makes the values of all config values available as attributes. It is exposed via the :py:attr:`sphinx.application.Application.config` and :py:attr:`sphinx.environment.Environment.config` attributes. For example, to get the value of :confval:`language`, use either ``app.config.language`` or ``env.config.language``. """ # the values are: (default, what needs to be rebuilt if changed) # If you add a value here, don't forget to include it in the # quickstart.py file template as well as in the docs! config_values: Dict[str, Tuple] = { # general options 'project': ('Python', 'env', []), 'author': ('unknown', 'env', []), 'project_copyright': ('', 'html', [str]), 'copyright': (lambda c: c.project_copyright, 'html', [str]), 'version': ('', 'env', []), 'release': ('', 'env', []), 'today': ('', 'env', []), # the real default is locale-dependent 'today_fmt': (None, 'env', [str]), 'language': (None, 'env', [str]), 'locale_dirs': (['locales'], 'env', []), 'figure_language_filename': ('{root}.{language}{ext}', 'env', [str]), 'gettext_allow_fuzzy_translations': (False, 'gettext', []), 'master_doc': ('index', 'env', []), 'root_doc': (lambda config: config.master_doc, 'env', []), 'source_suffix': ({'.rst': 'restructuredtext'}, 'env', Any), 'source_encoding': ('utf-8-sig', 'env', []), 'exclude_patterns': ([], 'env', []), 'default_role': (None, 'env', [str]), 'add_function_parentheses': (True, 'env', []), 'add_module_names': (True, 'env', []), 'trim_footnote_reference_space': (False, 'env', []), 'show_authors': (False, 'env', []), 'pygments_style': (None, 'html', [str]), 'highlight_language': ('default', 'env', []), 'highlight_options': ({}, 'env', []), 'templates_path': ([], 'html', []), 'template_bridge': (None, 'html', [str]), 'keep_warnings': (False, 'env', []), 'suppress_warnings': ([], 'env', []), 'modindex_common_prefix': ([], 'html', []), 'rst_epilog': (None, 'env', [str]), 'rst_prolog': (None, 'env', [str]), 'trim_doctest_flags': (True, 'env', []), 'primary_domain': ('py', 'env', [NoneType]), 'needs_sphinx': (None, None, [str]), 'needs_extensions': ({}, None, []), 'manpages_url': (None, 'env', []), 'nitpicky': (False, None, []), 'nitpick_ignore': ([], None, []), 'nitpick_ignore_regex': ([], None, []), 'numfig': (False, 'env', []), 'numfig_secnum_depth': (1, 'env', []), 'numfig_format': ({}, 'env', []), # will be initialized in init_numfig_format() 'math_number_all': (False, 'env', []), 'math_eqref_format': (None, 'env', [str]), 'math_numfig': (True, 'env', []), 'tls_verify': (True, 'env', []), 'tls_cacerts': (None, 'env', []), 'user_agent': (None, 'env', [str]), 'smartquotes': (True, 'env', []), 'smartquotes_action': ('qDe', 'env', []), 'smartquotes_excludes': ({'languages': ['ja'], 'builders': ['man', 'text']}, 'env', []), } def __init__(self, config: Dict[str, Any] = {}, overrides: Dict[str, Any] = {}) -> None: self.overrides = dict(overrides) self.values = Config.config_values.copy() self._raw_config = config self.setup: Optional[Callable] = config.get('setup', None) if 'extensions' in self.overrides: if isinstance(self.overrides['extensions'], str): config['extensions'] = self.overrides.pop('extensions').split(',') else: config['extensions'] = self.overrides.pop('extensions') self.extensions: List[str] = config.get('extensions', []) @classmethod def read(cls, confdir: str, overrides: Dict = None, tags: Tags = None) -> "Config": """Create a Config object from configuration file.""" filename = path.join(confdir, CONFIG_FILENAME) if not path.isfile(filename): raise ConfigError(__("config directory doesn't contain a conf.py file (%s)") % confdir) namespace = eval_config_file(filename, tags) return cls(namespace, overrides or {}) def convert_overrides(self, name: str, value: Any) -> Any: if not isinstance(value, str): return value else: defvalue = self.values[name][0] if self.values[name][2] == Any: return value elif self.values[name][2] == {bool, str}: if value == '0': # given falsy string from command line option return False elif value == '1': return True else: return value elif type(defvalue) is bool or self.values[name][2] == [bool]: if value == '0': # given falsy string from command line option return False else: return bool(value) elif isinstance(defvalue, dict): raise ValueError(__('cannot override dictionary config setting %r, ' 'ignoring (use %r to set individual elements)') % (name, name + '.key=value')) elif isinstance(defvalue, list): return value.split(',') elif isinstance(defvalue, int): try: return int(value) except ValueError as exc: raise ValueError(__('invalid number %r for config value %r, ignoring') % (value, name)) from exc elif hasattr(defvalue, '__call__'): return value elif defvalue is not None and not isinstance(defvalue, str): raise ValueError(__('cannot override config setting %r with unsupported ' 'type, ignoring') % name) else: return value def pre_init_values(self) -> None: """ Initialize some limited config variables before initializing i18n and loading extensions. """ variables = ['needs_sphinx', 'suppress_warnings', 'language', 'locale_dirs'] for name in variables: try: if name in self.overrides: self.__dict__[name] = self.convert_overrides(name, self.overrides[name]) elif name in self._raw_config: self.__dict__[name] = self._raw_config[name] except ValueError as exc: logger.warning("%s", exc) def init_values(self) -> None: config = self._raw_config for valname, value in self.overrides.items(): try: if '.' in valname: realvalname, key = valname.split('.', 1) config.setdefault(realvalname, {})[key] = value continue elif valname not in self.values: logger.warning(__('unknown config value %r in override, ignoring'), valname) continue if isinstance(value, str): config[valname] = self.convert_overrides(valname, value) else: config[valname] = value except ValueError as exc: logger.warning("%s", exc) for name in config: if name in self.values: self.__dict__[name] = config[name] def __getattr__(self, name: str) -> Any: if name.startswith('_'): raise AttributeError(name) if name not in self.values: raise AttributeError(__('No such config value: %s') % name) default = self.values[name][0] if hasattr(default, '__call__'): return default(self) return default def __getitem__(self, name: str) -> Any: return getattr(self, name) def __setitem__(self, name: str, value: Any) -> None: setattr(self, name, value) def __delitem__(self, name: str) -> None: delattr(self, name) def __contains__(self, name: str) -> bool: return name in self.values def __iter__(self) -> Generator[ConfigValue, None, None]: for name, value in self.values.items(): yield ConfigValue(name, getattr(self, name), value[1]) def add(self, name: str, default: Any, rebuild: Union[bool, str], types: Any) -> None: if name in self.values: raise ExtensionError(__('Config value %r already present') % name) else: self.values[name] = (default, rebuild, types) def filter(self, rebuild: Union[str, List[str]]) -> Iterator[ConfigValue]: if isinstance(rebuild, str): rebuild = [rebuild] return (value for value in self if value.rebuild in rebuild) def __getstate__(self) -> Dict: """Obtains serializable data for pickling.""" # remove potentially pickling-problematic values from config __dict__ = {} for key, value in self.__dict__.items(): if key.startswith('_') or not is_serializable(value): pass else: __dict__[key] = value # create a picklable copy of values list __dict__['values'] = {} for key, value in self.values.items(): real_value = getattr(self, key) if not is_serializable(real_value): # omit unserializable value real_value = None # types column is also omitted __dict__['values'][key] = (real_value, value[1], None) return __dict__ def __setstate__(self, state: Dict) -> None: self.__dict__.update(state) def eval_config_file(filename: str, tags: Optional[Tags]) -> Dict[str, Any]: """Evaluate a config file.""" namespace: Dict[str, Any] = {} namespace['__file__'] = filename namespace['tags'] = tags with cd(path.dirname(filename)): # during executing config file, current dir is changed to ``confdir``. try: with open(filename, 'rb') as f: code = compile(f.read(), filename.encode(fs_encoding), 'exec') exec(code, namespace) except SyntaxError as err: msg = __("There is a syntax error in your configuration file: %s\n") raise ConfigError(msg % err) from err except SystemExit as exc: msg = __("The configuration file (or one of the modules it imports) " "called sys.exit()") raise ConfigError(msg) from exc except ConfigError: # pass through ConfigError from conf.py as is. It will be shown in console. raise except Exception as exc: msg = __("There is a programmable error in your configuration file:\n\n%s") raise ConfigError(msg % traceback.format_exc()) from exc return namespace def convert_source_suffix(app: "Sphinx", config: Config) -> None: """Convert old styled source_suffix to new styled one. * old style: str or list * new style: a dict which maps from fileext to filetype """ source_suffix = config.source_suffix if isinstance(source_suffix, str): # if str, considers as default filetype (None) # # The default filetype is determined on later step. # By default, it is considered as restructuredtext. config.source_suffix = OrderedDict({source_suffix: None}) # type: ignore elif isinstance(source_suffix, (list, tuple)): # if list, considers as all of them are default filetype config.source_suffix = OrderedDict([(s, None) for s in source_suffix]) # type: ignore # NOQA elif isinstance(source_suffix, dict): # if dict, convert it to OrderedDict config.source_suffix = OrderedDict(config.source_suffix) # type: ignore else: logger.warning(__("The config value `source_suffix' expects " "a string, list of strings, or dictionary. " "But `%r' is given." % source_suffix)) def convert_highlight_options(app: "Sphinx", config: Config) -> None: """Convert old styled highlight_options to new styled one. * old style: options * new style: a dict which maps from language name to options """ options = config.highlight_options if options and not all(isinstance(v, dict) for v in options.values()): # old styled option detected because all values are not dictionary. config.highlight_options = {config.highlight_language: options} # type: ignore def init_numfig_format(app: "Sphinx", config: Config) -> None: """Initialize :confval:`numfig_format`.""" numfig_format = {'section': _('Section %s'), 'figure': _('Fig. %s'), 'table': _('Table %s'), 'code-block': _('Listing %s')} # override default labels by configuration numfig_format.update(config.numfig_format) config.numfig_format = numfig_format # type: ignore def correct_copyright_year(app: "Sphinx", config: Config) -> None: """Correct values of copyright year that are not coherent with the SOURCE_DATE_EPOCH environment variable (if set) See https://reproducible-builds.org/specs/source-date-epoch/ """ if getenv('SOURCE_DATE_EPOCH') is not None: for k in ('copyright', 'epub_copyright'): if k in config: replace = r'\g<1>%s' % format_date('%Y') config[k] = copyright_year_re.sub(replace, config[k]) def check_confval_types(app: "Sphinx", config: Config) -> None: """Check all values for deviation from the default value's type, since that can result in TypeErrors all over the place NB. """ for confval in config: default, rebuild, annotations = config.values[confval.name] if hasattr(default, '__call__'): default = default(config) # evaluate default value if default is None and not annotations: continue # neither inferable nor expliclitly annotated types if annotations is Any: # any type of value is accepted pass elif isinstance(annotations, ENUM): if not annotations.match(confval.value): msg = __("The config value `{name}` has to be a one of {candidates}, " "but `{current}` is given.") logger.warning(msg.format(name=confval.name, current=confval.value, candidates=annotations.candidates)) else: if type(confval.value) is type(default): continue if type(confval.value) in annotations: continue common_bases = (set(type(confval.value).__bases__ + (type(confval.value),)) & set(type(default).__bases__)) common_bases.discard(object) if common_bases: continue # at least we share a non-trivial base class if annotations: msg = __("The config value `{name}' has type `{current.__name__}'; " "expected {permitted}.") wrapped_annotations = ["`{}'".format(c.__name__) for c in annotations] if len(wrapped_annotations) > 2: permitted = "{}, or {}".format( ", ".join(wrapped_annotations[:-1]), wrapped_annotations[-1]) else: permitted = " or ".join(wrapped_annotations) logger.warning(msg.format(name=confval.name, current=type(confval.value), permitted=permitted)) else: msg = __("The config value `{name}' has type `{current.__name__}', " "defaults to `{default.__name__}'.") logger.warning(msg.format(name=confval.name, current=type(confval.value), default=type(default))) def check_primary_domain(app: "Sphinx", config: Config) -> None: primary_domain = config.primary_domain if primary_domain and not app.registry.has_domain(primary_domain): logger.warning(__('primary_domain %r not found, ignored.'), primary_domain) config.primary_domain = None # type: ignore def check_root_doc(app: "Sphinx", env: "BuildEnvironment", added: Set[str], changed: Set[str], removed: Set[str]) -> Set[str]: """Adjust root_doc to 'contents' to support an old project which does not have any root_doc setting. """ if (app.config.root_doc == 'index' and 'index' not in app.project.docnames and 'contents' in app.project.docnames): logger.warning(__('Since v2.0, Sphinx uses "index" as root_doc by default. ' 'Please add "root_doc = \'contents\'" to your conf.py.')) app.config.root_doc = "contents" # type: ignore return changed def setup(app: "Sphinx") -> Dict[str, Any]: app.connect('config-inited', convert_source_suffix, priority=800) app.connect('config-inited', convert_highlight_options, priority=800) app.connect('config-inited', init_numfig_format, priority=800) app.connect('config-inited', correct_copyright_year, priority=800) app.connect('config-inited', check_confval_types, priority=800) app.connect('config-inited', check_primary_domain, priority=800) app.connect('env-get-outdated', check_root_doc) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ����������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/deprecation.py������������������������������������������������������������������0000644�0000766�0000024�00000005613�00000000000�016520� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.deprecation ~~~~~~~~~~~~~~~~~~ Sphinx deprecation classes and utilities. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import sys import warnings from importlib import import_module from typing import Any, Dict, Type class RemovedInSphinx50Warning(DeprecationWarning): pass class RemovedInSphinx60Warning(PendingDeprecationWarning): pass RemovedInNextVersionWarning = RemovedInSphinx50Warning def deprecated_alias(modname: str, objects: Dict[str, object], warning: Type[Warning], names: Dict[str, str] = {}) -> None: module = import_module(modname) sys.modules[modname] = _ModuleWrapper( # type: ignore module, modname, objects, warning, names) class _ModuleWrapper: def __init__(self, module: Any, modname: str, objects: Dict[str, object], warning: Type[Warning], names: Dict[str, str]) -> None: self._module = module self._modname = modname self._objects = objects self._warning = warning self._names = names def __getattr__(self, name: str) -> Any: if name not in self._objects: return getattr(self._module, name) canonical_name = self._names.get(name, None) if canonical_name is not None: warnings.warn( "The alias '{}.{}' is deprecated, use '{}' instead. Check CHANGES for " "Sphinx API modifications.".format(self._modname, name, canonical_name), self._warning, stacklevel=3) else: warnings.warn("{}.{} is deprecated. Check CHANGES for Sphinx " "API modifications.".format(self._modname, name), self._warning, stacklevel=3) return self._objects[name] class DeprecatedDict(dict): """A deprecated dict which warns on each access.""" def __init__(self, data: Dict, message: str, warning: Type[Warning]) -> None: self.message = message self.warning = warning super().__init__(data) def __setitem__(self, key: str, value: Any) -> None: warnings.warn(self.message, self.warning, stacklevel=2) super().__setitem__(key, value) def setdefault(self, key: str, default: Any = None) -> Any: warnings.warn(self.message, self.warning, stacklevel=2) return super().setdefault(key, default) def __getitem__(self, key: str) -> None: warnings.warn(self.message, self.warning, stacklevel=2) return super().__getitem__(key) def get(self, key: str, default: Any = None) -> Any: warnings.warn(self.message, self.warning, stacklevel=2) return super().get(key, default) def update(self, other: Dict) -> None: # type: ignore warnings.warn(self.message, self.warning, stacklevel=2) super().update(other) ���������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4513988 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/directives/���������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016005� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/directives/__init__.py����������������������������������������������������������0000644�0000766�0000024�00000024747�00000000000�020134� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.directives ~~~~~~~~~~~~~~~~~ Handlers for additional ReST directives. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import re from typing import TYPE_CHECKING, Any, Dict, Generic, List, Tuple, TypeVar, cast from docutils import nodes from docutils.nodes import Node from docutils.parsers.rst import directives, roles from sphinx import addnodes from sphinx.addnodes import desc_signature from sphinx.deprecation import RemovedInSphinx50Warning, deprecated_alias from sphinx.util import docutils from sphinx.util.docfields import DocFieldTransformer, Field, TypedField from sphinx.util.docutils import SphinxDirective from sphinx.util.typing import OptionSpec if TYPE_CHECKING: from sphinx.application import Sphinx # RE to strip backslash escapes nl_escape_re = re.compile(r'\\\n') strip_backslash_re = re.compile(r'\\(.)') T = TypeVar('T') def optional_int(argument: str) -> int: """ Check for an integer argument or None value; raise ``ValueError`` if not. """ if argument is None: return None else: value = int(argument) if value < 0: raise ValueError('negative value; must be positive or zero') return value class ObjectDescription(SphinxDirective, Generic[T]): """ Directive to describe a class, function or similar object. Not used directly, but subclassed (in domain-specific directives) to add custom behavior. """ has_content = True required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = { 'noindex': directives.flag, } # types of doc fields that this directive handles, see sphinx.util.docfields doc_field_types: List[Field] = [] domain: str = None objtype: str = None indexnode: addnodes.index = None # Warning: this might be removed in future version. Don't touch this from extensions. _doc_field_type_map: Dict[str, Tuple[Field, bool]] = {} def get_field_type_map(self) -> Dict[str, Tuple[Field, bool]]: if self._doc_field_type_map == {}: self._doc_field_type_map = {} for field in self.doc_field_types: for name in field.names: self._doc_field_type_map[name] = (field, False) if field.is_typed: typed_field = cast(TypedField, field) for name in typed_field.typenames: self._doc_field_type_map[name] = (field, True) return self._doc_field_type_map def get_signatures(self) -> List[str]: """ Retrieve the signatures to document from the directive arguments. By default, signatures are given as arguments, one per line. """ lines = nl_escape_re.sub('', self.arguments[0]).split('\n') if self.config.strip_signature_backslash: # remove backslashes to support (dummy) escapes; helps Vim highlighting return [strip_backslash_re.sub(r'\1', line.strip()) for line in lines] else: return [line.strip() for line in lines] def handle_signature(self, sig: str, signode: desc_signature) -> T: """ Parse the signature *sig* into individual nodes and append them to *signode*. If ValueError is raised, parsing is aborted and the whole *sig* is put into a single desc_name node. The return value should be a value that identifies the object. It is passed to :meth:`add_target_and_index()` unchanged, and otherwise only used to skip duplicates. """ raise ValueError def add_target_and_index(self, name: T, sig: str, signode: desc_signature) -> None: """ Add cross-reference IDs and entries to self.indexnode, if applicable. *name* is whatever :meth:`handle_signature()` returned. """ return # do nothing by default def before_content(self) -> None: """ Called before parsing content. Used to set information about the current directive context on the build environment. """ pass def transform_content(self, contentnode: addnodes.desc_content) -> None: """ Called after creating the content through nested parsing, but before the ``object-description-transform`` event is emitted, and before the info-fields are transformed. Can be used to manipulate the content. """ pass def after_content(self) -> None: """ Called after parsing content. Used to reset information about the current directive context on the build environment. """ pass def run(self) -> List[Node]: """ Main directive entry function, called by docutils upon encountering the directive. This directive is meant to be quite easily subclassable, so it delegates to several additional methods. What it does: * find out if called as a domain-specific directive, set self.domain * create a `desc` node to fit all description inside * parse standard options, currently `noindex` * create an index node if needed as self.indexnode * parse all given signatures (as returned by self.get_signatures()) using self.handle_signature(), which should either return a name or raise ValueError * add index entries using self.add_target_and_index() * parse the content and handle doc fields in it """ if ':' in self.name: self.domain, self.objtype = self.name.split(':', 1) else: self.domain, self.objtype = '', self.name self.indexnode = addnodes.index(entries=[]) node = addnodes.desc() node.document = self.state.document node['domain'] = self.domain # 'desctype' is a backwards compatible attribute node['objtype'] = node['desctype'] = self.objtype node['noindex'] = noindex = ('noindex' in self.options) if self.domain: node['classes'].append(self.domain) node['classes'].append(node['objtype']) self.names: List[T] = [] signatures = self.get_signatures() for i, sig in enumerate(signatures): # add a signature node for each signature in the current unit # and add a reference target for it signode = addnodes.desc_signature(sig, '') self.set_source_info(signode) node.append(signode) try: # name can also be a tuple, e.g. (classname, objname); # this is strictly domain-specific (i.e. no assumptions may # be made in this base class) name = self.handle_signature(sig, signode) except ValueError: # signature parsing failed signode.clear() signode += addnodes.desc_name(sig, sig) continue # we don't want an index entry here if name not in self.names: self.names.append(name) if not noindex: # only add target and index entry if this is the first # description of the object with this name in this desc block self.add_target_and_index(name, sig, signode) contentnode = addnodes.desc_content() node.append(contentnode) if self.names: # needed for association of version{added,changed} directives self.env.temp_data['object'] = self.names[0] self.before_content() self.state.nested_parse(self.content, self.content_offset, contentnode) self.transform_content(contentnode) self.env.app.emit('object-description-transform', self.domain, self.objtype, contentnode) DocFieldTransformer(self).transform_all(contentnode) self.env.temp_data['object'] = None self.after_content() return [self.indexnode, node] class DefaultRole(SphinxDirective): """ Set the default interpreted text role. Overridden from docutils. """ optional_arguments = 1 final_argument_whitespace = False def run(self) -> List[Node]: if not self.arguments: docutils.unregister_role('') return [] role_name = self.arguments[0] role, messages = roles.role(role_name, self.state_machine.language, self.lineno, self.state.reporter) if role: docutils.register_role('', role) self.env.temp_data['default_role'] = role_name else: literal_block = nodes.literal_block(self.block_text, self.block_text) reporter = self.state.reporter error = reporter.error('Unknown interpreted text role "%s".' % role_name, literal_block, line=self.lineno) messages += [error] return cast(List[nodes.Node], messages) class DefaultDomain(SphinxDirective): """ Directive to (re-)set the default domain for this source file. """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = False option_spec: OptionSpec = {} def run(self) -> List[Node]: domain_name = self.arguments[0].lower() # if domain_name not in env.domains: # # try searching by label # for domain in env.domains.values(): # if domain.label.lower() == domain_name: # domain_name = domain.name # break self.env.temp_data['default_domain'] = self.env.domains.get(domain_name) return [] deprecated_alias('sphinx.directives', { 'DescDirective': ObjectDescription, }, RemovedInSphinx50Warning, { 'DescDirective': 'sphinx.directives.ObjectDescription', }) def setup(app: "Sphinx") -> Dict[str, Any]: app.add_config_value("strip_signature_backslash", False, 'env') directives.register_directive('default-role', DefaultRole) directives.register_directive('default-domain', DefaultDomain) directives.register_directive('describe', ObjectDescription) # new, more consistent, name directives.register_directive('object', ObjectDescription) app.add_event('object-description-transform') return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } �������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/directives/code.py��������������������������������������������������������������0000644�0000766�0000024�00000043653�00000000000�017304� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.directives.code ~~~~~~~~~~~~~~~~~~~~~~ :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import sys import textwrap from difflib import unified_diff from typing import TYPE_CHECKING, Any, Dict, List, Tuple from docutils import nodes from docutils.nodes import Element, Node from docutils.parsers.rst import directives from docutils.statemachine import StringList from sphinx import addnodes from sphinx.config import Config from sphinx.directives import optional_int from sphinx.locale import __ from sphinx.util import logging, parselinenos from sphinx.util.docutils import SphinxDirective from sphinx.util.typing import OptionSpec if TYPE_CHECKING: from sphinx.application import Sphinx logger = logging.getLogger(__name__) class Highlight(SphinxDirective): """ Directive to set the highlighting language for code blocks, as well as the threshold for line numbers. """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = False option_spec: OptionSpec = { 'force': directives.flag, 'linenothreshold': directives.positive_int, } def run(self) -> List[Node]: language = self.arguments[0].strip() linenothreshold = self.options.get('linenothreshold', sys.maxsize) force = 'force' in self.options self.env.temp_data['highlight_language'] = language return [addnodes.highlightlang(lang=language, force=force, linenothreshold=linenothreshold)] def dedent_lines(lines: List[str], dedent: int, location: Tuple[str, int] = None) -> List[str]: if not dedent: return textwrap.dedent(''.join(lines)).splitlines(True) if any(s[:dedent].strip() for s in lines): logger.warning(__('non-whitespace stripped by dedent'), location=location) new_lines = [] for line in lines: new_line = line[dedent:] if line.endswith('\n') and not new_line: new_line = '\n' # keep CRLF new_lines.append(new_line) return new_lines def container_wrapper(directive: SphinxDirective, literal_node: Node, caption: str) -> nodes.container: # NOQA container_node = nodes.container('', literal_block=True, classes=['literal-block-wrapper']) parsed = nodes.Element() directive.state.nested_parse(StringList([caption], source=''), directive.content_offset, parsed) if isinstance(parsed[0], nodes.system_message): msg = __('Invalid caption: %s' % parsed[0].astext()) raise ValueError(msg) elif isinstance(parsed[0], nodes.Element): caption_node = nodes.caption(parsed[0].rawsource, '', *parsed[0].children) caption_node.source = literal_node.source caption_node.line = literal_node.line container_node += caption_node container_node += literal_node return container_node else: raise RuntimeError # never reached class CodeBlock(SphinxDirective): """ Directive for a code block with special highlighting or line numbering settings. """ has_content = True required_arguments = 0 optional_arguments = 1 final_argument_whitespace = False option_spec: OptionSpec = { 'force': directives.flag, 'linenos': directives.flag, 'dedent': optional_int, 'lineno-start': int, 'emphasize-lines': directives.unchanged_required, 'caption': directives.unchanged_required, 'class': directives.class_option, 'name': directives.unchanged, } def run(self) -> List[Node]: document = self.state.document code = '\n'.join(self.content) location = self.state_machine.get_source_and_line(self.lineno) linespec = self.options.get('emphasize-lines') if linespec: try: nlines = len(self.content) hl_lines = parselinenos(linespec, nlines) if any(i >= nlines for i in hl_lines): logger.warning(__('line number spec is out of range(1-%d): %r') % (nlines, self.options['emphasize-lines']), location=location) hl_lines = [x + 1 for x in hl_lines if x < nlines] except ValueError as err: return [document.reporter.warning(err, line=self.lineno)] else: hl_lines = None if 'dedent' in self.options: location = self.state_machine.get_source_and_line(self.lineno) lines = code.split('\n') lines = dedent_lines(lines, self.options['dedent'], location=location) code = '\n'.join(lines) literal: Element = nodes.literal_block(code, code) if 'linenos' in self.options or 'lineno-start' in self.options: literal['linenos'] = True literal['classes'] += self.options.get('class', []) literal['force'] = 'force' in self.options if self.arguments: # highlight language specified literal['language'] = self.arguments[0] else: # no highlight language specified. Then this directive refers the current # highlight setting via ``highlight`` directive or ``highlight_language`` # configuration. literal['language'] = self.env.temp_data.get('highlight_language', self.config.highlight_language) extra_args = literal['highlight_args'] = {} if hl_lines is not None: extra_args['hl_lines'] = hl_lines if 'lineno-start' in self.options: extra_args['linenostart'] = self.options['lineno-start'] self.set_source_info(literal) caption = self.options.get('caption') if caption: try: literal = container_wrapper(self, literal, caption) except ValueError as exc: return [document.reporter.warning(exc, line=self.lineno)] # literal will be note_implicit_target that is linked from caption and numref. # when options['name'] is provided, it should be primary ID. self.add_name(literal) return [literal] class LiteralIncludeReader: INVALID_OPTIONS_PAIR = [ ('lineno-match', 'lineno-start'), ('lineno-match', 'append'), ('lineno-match', 'prepend'), ('start-after', 'start-at'), ('end-before', 'end-at'), ('diff', 'pyobject'), ('diff', 'lineno-start'), ('diff', 'lineno-match'), ('diff', 'lines'), ('diff', 'start-after'), ('diff', 'end-before'), ('diff', 'start-at'), ('diff', 'end-at'), ] def __init__(self, filename: str, options: Dict, config: Config) -> None: self.filename = filename self.options = options self.encoding = options.get('encoding', config.source_encoding) self.lineno_start = self.options.get('lineno-start', 1) self.parse_options() def parse_options(self) -> None: for option1, option2 in self.INVALID_OPTIONS_PAIR: if option1 in self.options and option2 in self.options: raise ValueError(__('Cannot use both "%s" and "%s" options') % (option1, option2)) def read_file(self, filename: str, location: Tuple[str, int] = None) -> List[str]: try: with open(filename, encoding=self.encoding, errors='strict') as f: text = f.read() if 'tab-width' in self.options: text = text.expandtabs(self.options['tab-width']) return text.splitlines(True) except OSError as exc: raise OSError(__('Include file %r not found or reading it failed') % filename) from exc except UnicodeError as exc: raise UnicodeError(__('Encoding %r used for reading included file %r seems to ' 'be wrong, try giving an :encoding: option') % (self.encoding, filename)) from exc def read(self, location: Tuple[str, int] = None) -> Tuple[str, int]: if 'diff' in self.options: lines = self.show_diff() else: filters = [self.pyobject_filter, self.start_filter, self.end_filter, self.lines_filter, self.prepend_filter, self.append_filter, self.dedent_filter] lines = self.read_file(self.filename, location=location) for func in filters: lines = func(lines, location=location) return ''.join(lines), len(lines) def show_diff(self, location: Tuple[str, int] = None) -> List[str]: new_lines = self.read_file(self.filename) old_filename = self.options.get('diff') old_lines = self.read_file(old_filename) diff = unified_diff(old_lines, new_lines, old_filename, self.filename) return list(diff) def pyobject_filter(self, lines: List[str], location: Tuple[str, int] = None) -> List[str]: pyobject = self.options.get('pyobject') if pyobject: from sphinx.pycode import ModuleAnalyzer analyzer = ModuleAnalyzer.for_file(self.filename, '') tags = analyzer.find_tags() if pyobject not in tags: raise ValueError(__('Object named %r not found in include file %r') % (pyobject, self.filename)) else: start = tags[pyobject][1] end = tags[pyobject][2] lines = lines[start - 1:end] if 'lineno-match' in self.options: self.lineno_start = start return lines def lines_filter(self, lines: List[str], location: Tuple[str, int] = None) -> List[str]: linespec = self.options.get('lines') if linespec: linelist = parselinenos(linespec, len(lines)) if any(i >= len(lines) for i in linelist): logger.warning(__('line number spec is out of range(1-%d): %r') % (len(lines), linespec), location=location) if 'lineno-match' in self.options: # make sure the line list is not "disjoint". first = linelist[0] if all(first + i == n for i, n in enumerate(linelist)): self.lineno_start += linelist[0] else: raise ValueError(__('Cannot use "lineno-match" with a disjoint ' 'set of "lines"')) lines = [lines[n] for n in linelist if n < len(lines)] if lines == []: raise ValueError(__('Line spec %r: no lines pulled from include file %r') % (linespec, self.filename)) return lines def start_filter(self, lines: List[str], location: Tuple[str, int] = None) -> List[str]: if 'start-at' in self.options: start = self.options.get('start-at') inclusive = False elif 'start-after' in self.options: start = self.options.get('start-after') inclusive = True else: start = None if start: for lineno, line in enumerate(lines): if start in line: if inclusive: if 'lineno-match' in self.options: self.lineno_start += lineno + 1 return lines[lineno + 1:] else: if 'lineno-match' in self.options: self.lineno_start += lineno return lines[lineno:] if inclusive is True: raise ValueError('start-after pattern not found: %s' % start) else: raise ValueError('start-at pattern not found: %s' % start) return lines def end_filter(self, lines: List[str], location: Tuple[str, int] = None) -> List[str]: if 'end-at' in self.options: end = self.options.get('end-at') inclusive = True elif 'end-before' in self.options: end = self.options.get('end-before') inclusive = False else: end = None if end: for lineno, line in enumerate(lines): if end in line: if inclusive: return lines[:lineno + 1] else: if lineno == 0: pass # end-before ignores first line else: return lines[:lineno] if inclusive is True: raise ValueError('end-at pattern not found: %s' % end) else: raise ValueError('end-before pattern not found: %s' % end) return lines def prepend_filter(self, lines: List[str], location: Tuple[str, int] = None) -> List[str]: prepend = self.options.get('prepend') if prepend: lines.insert(0, prepend + '\n') return lines def append_filter(self, lines: List[str], location: Tuple[str, int] = None) -> List[str]: append = self.options.get('append') if append: lines.append(append + '\n') return lines def dedent_filter(self, lines: List[str], location: Tuple[str, int] = None) -> List[str]: if 'dedent' in self.options: return dedent_lines(lines, self.options.get('dedent'), location=location) else: return lines class LiteralInclude(SphinxDirective): """ Like ``.. include:: :literal:``, but only warns if the include file is not found, and does not raise errors. Also has several options for selecting what to include. """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = { 'dedent': optional_int, 'linenos': directives.flag, 'lineno-start': int, 'lineno-match': directives.flag, 'tab-width': int, 'language': directives.unchanged_required, 'force': directives.flag, 'encoding': directives.encoding, 'pyobject': directives.unchanged_required, 'lines': directives.unchanged_required, 'start-after': directives.unchanged_required, 'end-before': directives.unchanged_required, 'start-at': directives.unchanged_required, 'end-at': directives.unchanged_required, 'prepend': directives.unchanged_required, 'append': directives.unchanged_required, 'emphasize-lines': directives.unchanged_required, 'caption': directives.unchanged, 'class': directives.class_option, 'name': directives.unchanged, 'diff': directives.unchanged_required, } def run(self) -> List[Node]: document = self.state.document if not document.settings.file_insertion_enabled: return [document.reporter.warning('File insertion disabled', line=self.lineno)] # convert options['diff'] to absolute path if 'diff' in self.options: _, path = self.env.relfn2path(self.options['diff']) self.options['diff'] = path try: location = self.state_machine.get_source_and_line(self.lineno) rel_filename, filename = self.env.relfn2path(self.arguments[0]) self.env.note_dependency(rel_filename) reader = LiteralIncludeReader(filename, self.options, self.config) text, lines = reader.read(location=location) retnode: Element = nodes.literal_block(text, text, source=filename) retnode['force'] = 'force' in self.options self.set_source_info(retnode) if self.options.get('diff'): # if diff is set, set udiff retnode['language'] = 'udiff' elif 'language' in self.options: retnode['language'] = self.options['language'] if ('linenos' in self.options or 'lineno-start' in self.options or 'lineno-match' in self.options): retnode['linenos'] = True retnode['classes'] += self.options.get('class', []) extra_args = retnode['highlight_args'] = {} if 'emphasize-lines' in self.options: hl_lines = parselinenos(self.options['emphasize-lines'], lines) if any(i >= lines for i in hl_lines): logger.warning(__('line number spec is out of range(1-%d): %r') % (lines, self.options['emphasize-lines']), location=location) extra_args['hl_lines'] = [x + 1 for x in hl_lines if x < lines] extra_args['linenostart'] = reader.lineno_start if 'caption' in self.options: caption = self.options['caption'] or self.arguments[0] retnode = container_wrapper(self, retnode, caption) # retnode will be note_implicit_target that is linked from caption and numref. # when options['name'] is provided, it should be primary ID. self.add_name(retnode) return [retnode] except Exception as exc: return [document.reporter.warning(exc, line=self.lineno)] def setup(app: "Sphinx") -> Dict[str, Any]: directives.register_directive('highlight', Highlight) directives.register_directive('code-block', CodeBlock) directives.register_directive('sourcecode', CodeBlock) directives.register_directive('literalinclude', LiteralInclude) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } �������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/directives/other.py�������������������������������������������������������������0000644�0000766�0000024�00000034323�00000000000�017505� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.directives.other ~~~~~~~~~~~~~~~~~~~~~~~ :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import re from typing import TYPE_CHECKING, Any, Dict, List, cast from docutils import nodes from docutils.nodes import Element, Node from docutils.parsers.rst import directives from docutils.parsers.rst.directives.admonitions import BaseAdmonition from docutils.parsers.rst.directives.misc import Class from docutils.parsers.rst.directives.misc import Include as BaseInclude from sphinx import addnodes from sphinx.domains.changeset import VersionChange # NOQA # for compatibility from sphinx.locale import _, __ from sphinx.util import docname_join, logging, url_re from sphinx.util.docutils import SphinxDirective from sphinx.util.matching import Matcher, patfilter from sphinx.util.nodes import explicit_title_re from sphinx.util.typing import OptionSpec if TYPE_CHECKING: from sphinx.application import Sphinx glob_re = re.compile(r'.*[*?\[].*') logger = logging.getLogger(__name__) def int_or_nothing(argument: str) -> int: if not argument: return 999 return int(argument) class TocTree(SphinxDirective): """ Directive to notify Sphinx about the hierarchical structure of the docs, and to include a table-of-contents like tree in the current document. """ has_content = True required_arguments = 0 optional_arguments = 0 final_argument_whitespace = False option_spec = { 'maxdepth': int, 'name': directives.unchanged, 'caption': directives.unchanged_required, 'glob': directives.flag, 'hidden': directives.flag, 'includehidden': directives.flag, 'numbered': int_or_nothing, 'titlesonly': directives.flag, 'reversed': directives.flag, } def run(self) -> List[Node]: subnode = addnodes.toctree() subnode['parent'] = self.env.docname # (title, ref) pairs, where ref may be a document, or an external link, # and title may be None if the document's title is to be used subnode['entries'] = [] subnode['includefiles'] = [] subnode['maxdepth'] = self.options.get('maxdepth', -1) subnode['caption'] = self.options.get('caption') subnode['glob'] = 'glob' in self.options subnode['hidden'] = 'hidden' in self.options subnode['includehidden'] = 'includehidden' in self.options subnode['numbered'] = self.options.get('numbered', 0) subnode['titlesonly'] = 'titlesonly' in self.options self.set_source_info(subnode) wrappernode = nodes.compound(classes=['toctree-wrapper']) wrappernode.append(subnode) self.add_name(wrappernode) ret = self.parse_content(subnode) ret.append(wrappernode) return ret def parse_content(self, toctree: addnodes.toctree) -> List[Node]: suffixes = self.config.source_suffix # glob target documents all_docnames = self.env.found_docs.copy() all_docnames.remove(self.env.docname) # remove current document ret: List[Node] = [] excluded = Matcher(self.config.exclude_patterns) for entry in self.content: if not entry: continue # look for explicit titles ("Some Title <document>") explicit = explicit_title_re.match(entry) if (toctree['glob'] and glob_re.match(entry) and not explicit and not url_re.match(entry)): patname = docname_join(self.env.docname, entry) docnames = sorted(patfilter(all_docnames, patname)) for docname in docnames: all_docnames.remove(docname) # don't include it again toctree['entries'].append((None, docname)) toctree['includefiles'].append(docname) if not docnames: logger.warning(__('toctree glob pattern %r didn\'t match any documents'), entry, location=toctree) else: if explicit: ref = explicit.group(2) title = explicit.group(1) docname = ref else: ref = docname = entry title = None # remove suffixes (backwards compatibility) for suffix in suffixes: if docname.endswith(suffix): docname = docname[:-len(suffix)] break # absolutize filenames docname = docname_join(self.env.docname, docname) if url_re.match(ref) or ref == 'self': toctree['entries'].append((title, ref)) elif docname not in self.env.found_docs: if excluded(self.env.doc2path(docname, None)): message = __('toctree contains reference to excluded document %r') subtype = 'excluded' else: message = __('toctree contains reference to nonexisting document %r') subtype = 'not_readable' logger.warning(message, docname, type='toc', subtype=subtype, location=toctree) self.env.note_reread() else: if docname in all_docnames: all_docnames.remove(docname) else: logger.warning(__('duplicated entry found in toctree: %s'), docname, location=toctree) toctree['entries'].append((title, docname)) toctree['includefiles'].append(docname) # entries contains all entries (self references, external links etc.) if 'reversed' in self.options: toctree['entries'] = list(reversed(toctree['entries'])) toctree['includefiles'] = list(reversed(toctree['includefiles'])) return ret class Author(SphinxDirective): """ Directive to give the name of the author of the current document or section. Shown in the output only if the show_authors option is on. """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: if not self.config.show_authors: return [] para: Element = nodes.paragraph(translatable=False) emph = nodes.emphasis() para += emph if self.name == 'sectionauthor': text = _('Section author: ') elif self.name == 'moduleauthor': text = _('Module author: ') elif self.name == 'codeauthor': text = _('Code author: ') else: text = _('Author: ') emph += nodes.Text(text, text) inodes, messages = self.state.inline_text(self.arguments[0], self.lineno) emph.extend(inodes) ret: List[Node] = [para] ret += messages return ret class SeeAlso(BaseAdmonition): """ An admonition mentioning things to look at as reference. """ node_class = addnodes.seealso class TabularColumns(SphinxDirective): """ Directive to give an explicit tabulary column definition to LaTeX. """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: node = addnodes.tabular_col_spec() node['spec'] = self.arguments[0] self.set_source_info(node) return [node] class Centered(SphinxDirective): """ Directive to create a centered line of bold text. """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: if not self.arguments: return [] subnode: Element = addnodes.centered() inodes, messages = self.state.inline_text(self.arguments[0], self.lineno) subnode.extend(inodes) ret: List[Node] = [subnode] ret += messages return ret class Acks(SphinxDirective): """ Directive for a list of names. """ has_content = True required_arguments = 0 optional_arguments = 0 final_argument_whitespace = False option_spec: OptionSpec = {} def run(self) -> List[Node]: node = addnodes.acks() node.document = self.state.document self.state.nested_parse(self.content, self.content_offset, node) if len(node.children) != 1 or not isinstance(node.children[0], nodes.bullet_list): logger.warning(__('.. acks content is not a list'), location=(self.env.docname, self.lineno)) return [] return [node] class HList(SphinxDirective): """ Directive for a list that gets compacted horizontally. """ has_content = True required_arguments = 0 optional_arguments = 0 final_argument_whitespace = False option_spec: OptionSpec = { 'columns': int, } def run(self) -> List[Node]: ncolumns = self.options.get('columns', 2) node = nodes.paragraph() node.document = self.state.document self.state.nested_parse(self.content, self.content_offset, node) if len(node.children) != 1 or not isinstance(node.children[0], nodes.bullet_list): logger.warning(__('.. hlist content is not a list'), location=(self.env.docname, self.lineno)) return [] fulllist = node.children[0] # create a hlist node where the items are distributed npercol, nmore = divmod(len(fulllist), ncolumns) index = 0 newnode = addnodes.hlist() newnode['ncolumns'] = str(ncolumns) for column in range(ncolumns): endindex = index + ((npercol + 1) if column < nmore else npercol) bullet_list = nodes.bullet_list() bullet_list += fulllist.children[index:endindex] newnode += addnodes.hlistcol('', bullet_list) index = endindex return [newnode] class Only(SphinxDirective): """ Directive to only include text if the given tag(s) are enabled. """ has_content = True required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: node = addnodes.only() node.document = self.state.document self.set_source_info(node) node['expr'] = self.arguments[0] # Same as util.nested_parse_with_titles but try to handle nested # sections which should be raised higher up the doctree. memo: Any = self.state.memo surrounding_title_styles = memo.title_styles surrounding_section_level = memo.section_level memo.title_styles = [] memo.section_level = 0 try: self.state.nested_parse(self.content, self.content_offset, node, match_titles=True) title_styles = memo.title_styles if (not surrounding_title_styles or not title_styles or title_styles[0] not in surrounding_title_styles or not self.state.parent): # No nested sections so no special handling needed. return [node] # Calculate the depths of the current and nested sections. current_depth = 0 parent = self.state.parent while parent: current_depth += 1 parent = parent.parent current_depth -= 2 title_style = title_styles[0] nested_depth = len(surrounding_title_styles) if title_style in surrounding_title_styles: nested_depth = surrounding_title_styles.index(title_style) # Use these depths to determine where the nested sections should # be placed in the doctree. n_sects_to_raise = current_depth - nested_depth + 1 parent = cast(nodes.Element, self.state.parent) for i in range(n_sects_to_raise): if parent.parent: parent = parent.parent parent.append(node) return [] finally: memo.title_styles = surrounding_title_styles memo.section_level = surrounding_section_level class Include(BaseInclude, SphinxDirective): """ Like the standard "Include" directive, but interprets absolute paths "correctly", i.e. relative to source directory. """ def run(self) -> List[Node]: if self.arguments[0].startswith('<') and \ self.arguments[0].endswith('>'): # docutils "standard" includes, do not do path processing return super().run() rel_filename, filename = self.env.relfn2path(self.arguments[0]) self.arguments[0] = filename self.env.note_included(filename) return super().run() def setup(app: "Sphinx") -> Dict[str, Any]: directives.register_directive('toctree', TocTree) directives.register_directive('sectionauthor', Author) directives.register_directive('moduleauthor', Author) directives.register_directive('codeauthor', Author) directives.register_directive('seealso', SeeAlso) directives.register_directive('tabularcolumns', TabularColumns) directives.register_directive('centered', Centered) directives.register_directive('acks', Acks) directives.register_directive('hlist', HList) directives.register_directive('only', Only) directives.register_directive('include', Include) # register the standard rst class directive under a different name # only for backwards compatibility now directives.register_directive('cssclass', Class) # new standard name when default-domain with "class" is in effect directives.register_directive('rst-class', Class) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/directives/patches.py�����������������������������������������������������������0000644�0000766�0000024�00000021510�00000000000�020005� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.directives.patches ~~~~~~~~~~~~~~~~~~~~~~~~~ :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import os import warnings from os import path from typing import TYPE_CHECKING, Any, Dict, List, Tuple, cast from docutils import nodes from docutils.nodes import Node, make_id, system_message from docutils.parsers.rst import directives from docutils.parsers.rst.directives import images, tables from docutils.parsers.rst.roles import set_classes from sphinx import addnodes from sphinx.deprecation import RemovedInSphinx60Warning from sphinx.directives import optional_int from sphinx.domains.math import MathDomain from sphinx.locale import __ from sphinx.util import logging from sphinx.util.docutils import SphinxDirective from sphinx.util.nodes import set_source_info from sphinx.util.osutil import SEP, os_path, relpath from sphinx.util.typing import OptionSpec try: from docutils.nodes import meta as meta_node # type: ignore from docutils.parsers.rst.directives.misc import Meta as MetaBase # type: ignore except ImportError: # docutils-0.17 or older from docutils.parsers.rst.directives.html import Meta as MetaBase from docutils.parsers.rst.directives.html import MetaBody meta_node = MetaBody.meta if TYPE_CHECKING: from sphinx.application import Sphinx logger = logging.getLogger(__name__) class Figure(images.Figure): """The figure directive which applies `:name:` option to the figure node instead of the image node. """ def run(self) -> List[Node]: name = self.options.pop('name', None) result = super().run() if len(result) == 2 or isinstance(result[0], nodes.system_message): return result assert len(result) == 1 figure_node = cast(nodes.figure, result[0]) if name: # set ``name`` to figure_node if given self.options['name'] = name self.add_name(figure_node) # copy lineno from image node if figure_node.line is None and len(figure_node) == 2: caption = cast(nodes.caption, figure_node[1]) figure_node.line = caption.line return [figure_node] class Meta(MetaBase, SphinxDirective): def run(self) -> List[Node]: result = super().run() for node in result: if (isinstance(node, nodes.pending) and isinstance(node.details['nodes'][0], meta_node)): meta = node.details['nodes'][0] meta.source = self.env.doc2path(self.env.docname) meta.line = self.lineno meta.rawcontent = meta['content'] # docutils' meta nodes aren't picklable because the class is nested meta.__class__ = addnodes.meta return result class RSTTable(tables.RSTTable): """The table directive which sets source and line information to its caption. Only for docutils-0.13 or older version.""" def run(self) -> List[Node]: warnings.warn('RSTTable is deprecated.', RemovedInSphinx60Warning) return super().run() def make_title(self) -> Tuple[nodes.title, List[system_message]]: title, message = super().make_title() if title: set_source_info(self, title) return title, message class CSVTable(tables.CSVTable): """The csv-table directive which searches a CSV file from Sphinx project's source directory when an absolute path is given via :file: option. """ def run(self) -> List[Node]: if 'file' in self.options and self.options['file'].startswith((SEP, os.sep)): env = self.state.document.settings.env filename = self.options['file'] if path.exists(filename): logger.warning(__('":file:" option for csv-table directive now recognizes ' 'an absolute path as a relative path from source directory. ' 'Please update your document.'), location=(env.docname, self.lineno)) else: abspath = path.join(env.srcdir, os_path(self.options['file'][1:])) docdir = path.dirname(env.doc2path(env.docname)) self.options['file'] = relpath(abspath, docdir) return super().run() class ListTable(tables.ListTable): """The list-table directive which sets source and line information to its caption. Only for docutils-0.13 or older version.""" def run(self) -> List[Node]: warnings.warn('ListTable is deprecated.', RemovedInSphinx60Warning) return super().run() def make_title(self) -> Tuple[nodes.title, List[system_message]]: title, message = super().make_title() if title: set_source_info(self, title) return title, message class Code(SphinxDirective): """Parse and mark up content of a code block. This is compatible with docutils' :rst:dir:`code` directive. """ optional_arguments = 1 option_spec: OptionSpec = { 'class': directives.class_option, 'force': directives.flag, 'name': directives.unchanged, 'number-lines': optional_int, } has_content = True def run(self) -> List[Node]: self.assert_has_content() set_classes(self.options) code = '\n'.join(self.content) node = nodes.literal_block(code, code, classes=self.options.get('classes', []), force='force' in self.options, highlight_args={}) self.add_name(node) set_source_info(self, node) if self.arguments: # highlight language specified node['language'] = self.arguments[0] else: # no highlight language specified. Then this directive refers the current # highlight setting via ``highlight`` directive or ``highlight_language`` # configuration. node['language'] = self.env.temp_data.get('highlight_language', self.config.highlight_language) if 'number-lines' in self.options: node['linenos'] = True # if number given, treat as lineno-start. if self.options['number-lines']: node['highlight_args']['linenostart'] = self.options['number-lines'] return [node] class MathDirective(SphinxDirective): has_content = True required_arguments = 0 optional_arguments = 1 final_argument_whitespace = True option_spec: OptionSpec = { 'label': directives.unchanged, 'name': directives.unchanged, 'class': directives.class_option, 'nowrap': directives.flag, } def run(self) -> List[Node]: latex = '\n'.join(self.content) if self.arguments and self.arguments[0]: latex = self.arguments[0] + '\n\n' + latex label = self.options.get('label', self.options.get('name')) node = nodes.math_block(latex, latex, classes=self.options.get('class', []), docname=self.env.docname, number=None, label=label, nowrap='nowrap' in self.options) self.add_name(node) self.set_source_info(node) ret: List[Node] = [node] self.add_target(ret) return ret def add_target(self, ret: List[Node]) -> None: node = cast(nodes.math_block, ret[0]) # assign label automatically if math_number_all enabled if node['label'] == '' or (self.config.math_number_all and not node['label']): seq = self.env.new_serialno('sphinx.ext.math#equations') node['label'] = "%s:%d" % (self.env.docname, seq) # no targets and numbers are needed if not node['label']: return # register label to domain domain = cast(MathDomain, self.env.get_domain('math')) domain.note_equation(self.env.docname, node['label'], location=node) node['number'] = domain.get_equation_number_for(node['label']) # add target node node_id = make_id('equation-%s' % node['label']) target = nodes.target('', '', ids=[node_id]) self.state.document.note_explicit_target(target) ret.insert(0, target) def setup(app: "Sphinx") -> Dict[str, Any]: directives.register_directive('figure', Figure) directives.register_directive('meta', Meta) directives.register_directive('csv-table', CSVTable) directives.register_directive('code', Code) directives.register_directive('math', MathDirective) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4544978 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/domains/������������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015276� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/domains/__init__.py�������������������������������������������������������������0000644�0000766�0000024�00000036073�00000000000�017420� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.domains ~~~~~~~~~~~~~~ Support for domains, which are groupings of description directives and roles describing e.g. constructs of one programming language. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import copy from abc import ABC, abstractmethod from typing import (TYPE_CHECKING, Any, Callable, Dict, Iterable, List, NamedTuple, Optional, Tuple, Type, Union, cast) from docutils import nodes from docutils.nodes import Element, Node, system_message from docutils.parsers.rst.states import Inliner from sphinx.addnodes import pending_xref from sphinx.errors import SphinxError from sphinx.locale import _ from sphinx.roles import XRefRole from sphinx.util.typing import RoleFunction if TYPE_CHECKING: from sphinx.builders import Builder from sphinx.environment import BuildEnvironment class ObjType: """ An ObjType is the description for a type of object that a domain can document. In the object_types attribute of Domain subclasses, object type names are mapped to instances of this class. Constructor arguments: - *lname*: localized name of the type (do not include domain name) - *roles*: all the roles that can refer to an object of this type - *attrs*: object attributes -- currently only "searchprio" is known, which defines the object's priority in the full-text search index, see :meth:`Domain.get_objects()`. """ known_attrs = { 'searchprio': 1, } def __init__(self, lname: str, *roles: Any, **attrs: Any) -> None: self.lname = lname self.roles: Tuple = roles self.attrs: Dict = self.known_attrs.copy() self.attrs.update(attrs) class IndexEntry(NamedTuple): name: str subtype: int docname: str anchor: str extra: str qualifier: str descr: str class Index(ABC): """ An Index is the description for a domain-specific index. To add an index to a domain, subclass Index, overriding the three name attributes: * `name` is an identifier used for generating file names. It is also used for a hyperlink target for the index. Therefore, users can refer the index page using ``ref`` role and a string which is combined domain name and ``name`` attribute (ex. ``:ref:`py-modindex```). * `localname` is the section title for the index. * `shortname` is a short name for the index, for use in the relation bar in HTML output. Can be empty to disable entries in the relation bar. and providing a :meth:`generate()` method. Then, add the index class to your domain's `indices` list. Extensions can add indices to existing domains using :meth:`~sphinx.application.Sphinx.add_index_to_domain()`. .. versionchanged:: 3.0 Index pages can be referred by domain name and index name via :rst:role:`ref` role. """ name: str = None localname: str = None shortname: str = None def __init__(self, domain: "Domain") -> None: if self.name is None or self.localname is None: raise SphinxError('Index subclass %s has no valid name or localname' % self.__class__.__name__) self.domain = domain @abstractmethod def generate(self, docnames: Iterable[str] = None ) -> Tuple[List[Tuple[str, List[IndexEntry]]], bool]: """Get entries for the index. If ``docnames`` is given, restrict to entries referring to these docnames. The return value is a tuple of ``(content, collapse)``: ``collapse`` A boolean that determines if sub-entries should start collapsed (for output formats that support collapsing sub-entries). ``content``: A sequence of ``(letter, entries)`` tuples, where ``letter`` is the "heading" for the given ``entries``, usually the starting letter, and ``entries`` is a sequence of single entries. Each entry is a sequence ``[name, subtype, docname, anchor, extra, qualifier, descr]``. The items in this sequence have the following meaning: ``name`` The name of the index entry to be displayed. ``subtype`` The sub-entry related type. One of: ``0`` A normal entry. ``1`` An entry with sub-entries. ``2`` A sub-entry. ``docname`` *docname* where the entry is located. ``anchor`` Anchor for the entry within ``docname`` ``extra`` Extra info for the entry. ``qualifier`` Qualifier for the description. ``descr`` Description for the entry. Qualifier and description are not rendered for some output formats such as LaTeX. """ raise NotImplementedError class Domain: """ A Domain is meant to be a group of "object" description directives for objects of a similar nature, and corresponding roles to create references to them. Examples would be Python modules, classes, functions etc., elements of a templating language, Sphinx roles and directives, etc. Each domain has a separate storage for information about existing objects and how to reference them in `self.data`, which must be a dictionary. It also must implement several functions that expose the object information in a uniform way to parts of Sphinx that allow the user to reference or search for objects in a domain-agnostic way. About `self.data`: since all object and cross-referencing information is stored on a BuildEnvironment instance, the `domain.data` object is also stored in the `env.domaindata` dict under the key `domain.name`. Before the build process starts, every active domain is instantiated and given the environment object; the `domaindata` dict must then either be nonexistent or a dictionary whose 'version' key is equal to the domain class' :attr:`data_version` attribute. Otherwise, `OSError` is raised and the pickled environment is discarded. """ #: domain name: should be short, but unique name = '' #: domain label: longer, more descriptive (used in messages) label = '' #: type (usually directive) name -> ObjType instance object_types: Dict[str, ObjType] = {} #: directive name -> directive class directives: Dict[str, Any] = {} #: role name -> role callable roles: Dict[str, Union[RoleFunction, XRefRole]] = {} #: a list of Index subclasses indices: List[Type[Index]] = [] #: role name -> a warning message if reference is missing dangling_warnings: Dict[str, str] = {} #: node_class -> (enum_node_type, title_getter) enumerable_nodes: Dict[Type[Node], Tuple[str, Callable]] = {} #: data value for a fresh environment initial_data: Dict = {} #: data value data: Dict #: data version, bump this when the format of `self.data` changes data_version = 0 def __init__(self, env: "BuildEnvironment") -> None: self.env: BuildEnvironment = env self._role_cache: Dict[str, Callable] = {} self._directive_cache: Dict[str, Callable] = {} self._role2type: Dict[str, List[str]] = {} self._type2role: Dict[str, str] = {} # convert class variables to instance one (to enhance through API) self.object_types = dict(self.object_types) self.directives = dict(self.directives) self.roles = dict(self.roles) self.indices = list(self.indices) if self.name not in env.domaindata: assert isinstance(self.initial_data, dict) new_data = copy.deepcopy(self.initial_data) new_data['version'] = self.data_version self.data = env.domaindata[self.name] = new_data else: self.data = env.domaindata[self.name] if self.data['version'] != self.data_version: raise OSError('data of %r domain out of date' % self.label) for name, obj in self.object_types.items(): for rolename in obj.roles: self._role2type.setdefault(rolename, []).append(name) self._type2role[name] = obj.roles[0] if obj.roles else '' self.objtypes_for_role: Callable[[str], List[str]] = self._role2type.get self.role_for_objtype: Callable[[str], str] = self._type2role.get def setup(self) -> None: """Set up domain object.""" from sphinx.domains.std import StandardDomain # Add special hyperlink target for index pages (ex. py-modindex) std = cast(StandardDomain, self.env.get_domain('std')) for index in self.indices: if index.name and index.localname: docname = "%s-%s" % (self.name, index.name) std.note_hyperlink_target(docname, docname, '', index.localname) def add_object_type(self, name: str, objtype: ObjType) -> None: """Add an object type.""" self.object_types[name] = objtype if objtype.roles: self._type2role[name] = objtype.roles[0] else: self._type2role[name] = '' for role in objtype.roles: self._role2type.setdefault(role, []).append(name) def role(self, name: str) -> Optional[RoleFunction]: """Return a role adapter function that always gives the registered role its full name ('domain:name') as the first argument. """ if name in self._role_cache: return self._role_cache[name] if name not in self.roles: return None fullname = '%s:%s' % (self.name, name) def role_adapter(typ: str, rawtext: str, text: str, lineno: int, inliner: Inliner, options: Dict = {}, content: List[str] = [] ) -> Tuple[List[Node], List[system_message]]: return self.roles[name](fullname, rawtext, text, lineno, inliner, options, content) self._role_cache[name] = role_adapter return role_adapter def directive(self, name: str) -> Optional[Callable]: """Return a directive adapter class that always gives the registered directive its full name ('domain:name') as ``self.name``. """ if name in self._directive_cache: return self._directive_cache[name] if name not in self.directives: return None fullname = '%s:%s' % (self.name, name) BaseDirective = self.directives[name] class DirectiveAdapter(BaseDirective): # type: ignore def run(self) -> List[Node]: self.name = fullname return super().run() self._directive_cache[name] = DirectiveAdapter return DirectiveAdapter # methods that should be overwritten def clear_doc(self, docname: str) -> None: """Remove traces of a document in the domain-specific inventories.""" pass def merge_domaindata(self, docnames: List[str], otherdata: Dict) -> None: """Merge in data regarding *docnames* from a different domaindata inventory (coming from a subprocess in parallel builds). """ raise NotImplementedError('merge_domaindata must be implemented in %s ' 'to be able to do parallel builds!' % self.__class__) def process_doc(self, env: "BuildEnvironment", docname: str, document: nodes.document) -> None: """Process a document after it is read by the environment.""" pass def check_consistency(self) -> None: """Do consistency checks (**experimental**).""" pass def process_field_xref(self, pnode: pending_xref) -> None: """Process a pending xref created in a doc field. For example, attach information about the current scope. """ pass def resolve_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder", typ: str, target: str, node: pending_xref, contnode: Element ) -> Optional[Element]: """Resolve the pending_xref *node* with the given *typ* and *target*. This method should return a new node, to replace the xref node, containing the *contnode* which is the markup content of the cross-reference. If no resolution can be found, None can be returned; the xref node will then given to the :event:`missing-reference` event, and if that yields no resolution, replaced by *contnode*. The method can also raise :exc:`sphinx.environment.NoUri` to suppress the :event:`missing-reference` event being emitted. """ pass def resolve_any_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder", target: str, node: pending_xref, contnode: Element ) -> List[Tuple[str, Element]]: """Resolve the pending_xref *node* with the given *target*. The reference comes from an "any" or similar role, which means that we don't know the type. Otherwise, the arguments are the same as for :meth:`resolve_xref`. The method must return a list (potentially empty) of tuples ``('domain:role', newnode)``, where ``'domain:role'`` is the name of a role that could have created the same reference, e.g. ``'py:func'``. ``newnode`` is what :meth:`resolve_xref` would return. .. versionadded:: 1.3 """ raise NotImplementedError def get_objects(self) -> Iterable[Tuple[str, str, str, str, str, int]]: """Return an iterable of "object descriptions". Object descriptions are tuples with six items: ``name`` Fully qualified name. ``dispname`` Name to display when searching/linking. ``type`` Object type, a key in ``self.object_types``. ``docname`` The document where it is to be found. ``anchor`` The anchor name for the object. ``priority`` How "important" the object is (determines placement in search results). One of: ``1`` Default priority (placed before full-text matches). ``0`` Object is important (placed before default-priority objects). ``2`` Object is unimportant (placed after full-text matches). ``-1`` Object should not show up in search at all. """ return [] def get_type_name(self, type: ObjType, primary: bool = False) -> str: """Return full name for given ObjType.""" if primary: return type.lname return _('%s %s') % (self.label, type.lname) def get_enumerable_node_type(self, node: Node) -> Optional[str]: """Get type of enumerable nodes (experimental).""" enum_node_type, _ = self.enumerable_nodes.get(node.__class__, (None, None)) return enum_node_type def get_full_qualified_name(self, node: Element) -> Optional[str]: """Return full qualified name for given node.""" return None ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902837.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/domains/c.py��������������������������������������������������������������������0000644�0000766�0000024�00000456017�00000000000�016107� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.domains.c ~~~~~~~~~~~~~~~~ The C language domain. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import re from typing import (Any, Callable, Dict, Generator, Iterator, List, Optional, Tuple, TypeVar, Union, cast) from docutils import nodes from docutils.nodes import Element, Node, TextElement, system_message from docutils.parsers.rst import directives from sphinx import addnodes from sphinx.addnodes import pending_xref from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.deprecation import RemovedInSphinx50Warning from sphinx.directives import ObjectDescription from sphinx.domains import Domain, ObjType from sphinx.environment import BuildEnvironment from sphinx.locale import _, __ from sphinx.roles import SphinxRole, XRefRole from sphinx.transforms import SphinxTransform from sphinx.transforms.post_transforms import ReferencesResolver from sphinx.util import logging from sphinx.util.cfamily import (ASTAttribute, ASTBaseBase, ASTBaseParenExprList, BaseParser, DefinitionError, NoOldIdError, StringifyTransform, UnsupportedMultiCharacterCharLiteral, anon_identifier_re, binary_literal_re, char_literal_re, float_literal_re, float_literal_suffix_re, hex_literal_re, identifier_re, integer_literal_re, integers_literal_suffix_re, octal_literal_re, verify_description_mode) from sphinx.util.docfields import Field, GroupedField, TypedField from sphinx.util.docutils import SphinxDirective from sphinx.util.nodes import make_refnode from sphinx.util.typing import OptionSpec logger = logging.getLogger(__name__) T = TypeVar('T') DeclarationType = Union[ "ASTStruct", "ASTUnion", "ASTEnum", "ASTEnumerator", "ASTType", "ASTTypeWithInit", "ASTMacro", ] # https://en.cppreference.com/w/c/keyword _keywords = [ 'auto', 'break', 'case', 'char', 'const', 'continue', 'default', 'do', 'double', 'else', 'enum', 'extern', 'float', 'for', 'goto', 'if', 'inline', 'int', 'long', 'register', 'restrict', 'return', 'short', 'signed', 'sizeof', 'static', 'struct', 'switch', 'typedef', 'union', 'unsigned', 'void', 'volatile', 'while', '_Alignas', '_Alignof', '_Atomic', '_Bool', '_Complex', '_Decimal32', '_Decimal64', '_Decimal128', '_Generic', '_Imaginary', '_Noreturn', '_Static_assert', '_Thread_local', ] # These are only keyword'y when the corresponding headers are included. # They are used as default value for c_extra_keywords. _macroKeywords = [ 'alignas', 'alignof', 'bool', 'complex', 'imaginary', 'noreturn', 'static_assert', 'thread_local', ] # these are ordered by preceedence _expression_bin_ops = [ ['||', 'or'], ['&&', 'and'], ['|', 'bitor'], ['^', 'xor'], ['&', 'bitand'], ['==', '!=', 'not_eq'], ['<=', '>=', '<', '>'], ['<<', '>>'], ['+', '-'], ['*', '/', '%'], ['.*', '->*'] ] _expression_unary_ops = ["++", "--", "*", "&", "+", "-", "!", "not", "~", "compl"] _expression_assignment_ops = ["=", "*=", "/=", "%=", "+=", "-=", ">>=", "<<=", "&=", "and_eq", "^=", "xor_eq", "|=", "or_eq"] _max_id = 1 _id_prefix = [None, 'c.', 'Cv2.'] # Ids are used in lookup keys which are used across pickled files, # so when _max_id changes, make sure to update the ENV_VERSION. _string_re = re.compile(r"[LuU8]?('([^'\\]*(?:\\.[^'\\]*)*)'" r'|"([^"\\]*(?:\\.[^"\\]*)*)")', re.S) # bool, complex, and imaginary are macro "keywords", so they are handled seperately _simple_type_specifiers_re = re.compile(r"""(?x) \b( void|_Bool |signed|unsigned |short|long |char |int |__uint128|__int128 |__int(8|16|32|64|128) # extension |float|double |_Decimal(32|64|128) |_Complex|_Imaginary |__float80|_Float64x|__float128|_Float128|__ibm128 # extension |__fp16 # extension |_Sat|_Fract|fract|_Accum|accum # extension )\b """) class _DuplicateSymbolError(Exception): def __init__(self, symbol: "Symbol", declaration: "ASTDeclaration") -> None: assert symbol assert declaration self.symbol = symbol self.declaration = declaration def __str__(self) -> str: return "Internal C duplicate symbol error:\n%s" % self.symbol.dump(0) class ASTBase(ASTBaseBase): def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: raise NotImplementedError(repr(self)) # Names ################################################################################ class ASTIdentifier(ASTBaseBase): def __init__(self, identifier: str) -> None: assert identifier is not None assert len(identifier) != 0 self.identifier = identifier def __eq__(self, other: Any) -> bool: return type(other) is ASTIdentifier and self.identifier == other.identifier def is_anon(self) -> bool: return self.identifier[0] == '@' # and this is where we finally make a difference between __str__ and the display string def __str__(self) -> str: return self.identifier def get_display_string(self) -> str: return "[anonymous]" if self.is_anon() else self.identifier def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", prefix: str, symbol: "Symbol") -> None: # note: slightly different signature of describe_signature due to the prefix verify_description_mode(mode) if self.is_anon(): node = addnodes.desc_sig_name(text="[anonymous]") else: node = addnodes.desc_sig_name(self.identifier, self.identifier) if mode == 'markType': targetText = prefix + self.identifier pnode = addnodes.pending_xref('', refdomain='c', reftype='identifier', reftarget=targetText, modname=None, classname=None) pnode['c:parent_key'] = symbol.get_lookup_key() pnode += node signode += pnode elif mode == 'lastIsName': nameNode = addnodes.desc_name() nameNode += node signode += nameNode elif mode == 'noneIsName': signode += node else: raise Exception('Unknown description mode: %s' % mode) class ASTNestedName(ASTBase): def __init__(self, names: List[ASTIdentifier], rooted: bool) -> None: assert len(names) > 0 self.names = names self.rooted = rooted @property def name(self) -> "ASTNestedName": return self def get_id(self, version: int) -> str: return '.'.join(str(n) for n in self.names) def _stringify(self, transform: StringifyTransform) -> str: res = '.'.join(transform(n) for n in self.names) if self.rooted: return '.' + res else: return res def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) # just print the name part, with template args, not template params if mode == 'noneIsName': if self.rooted: assert False, "Can this happen?" # TODO signode += nodes.Text('.') for i in range(len(self.names)): if i != 0: assert False, "Can this happen?" # TODO signode += nodes.Text('.') n = self.names[i] n.describe_signature(signode, mode, env, '', symbol) elif mode == 'param': assert not self.rooted, str(self) assert len(self.names) == 1 self.names[0].describe_signature(signode, 'noneIsName', env, '', symbol) elif mode == 'markType' or mode == 'lastIsName' or mode == 'markName': # Each element should be a pending xref targeting the complete # prefix. prefix = '' first = True names = self.names[:-1] if mode == 'lastIsName' else self.names # If lastIsName, then wrap all of the prefix in a desc_addname, # else append directly to signode. # TODO: also for C? # NOTE: Breathe previously relied on the prefix being in the desc_addname node, # so it can remove it in inner declarations. dest = signode if mode == 'lastIsName': dest = addnodes.desc_addname() if self.rooted: prefix += '.' if mode == 'lastIsName' and len(names) == 0: signode += addnodes.desc_sig_punctuation('.', '.') else: dest += addnodes.desc_sig_punctuation('.', '.') for i in range(len(names)): ident = names[i] if not first: dest += addnodes.desc_sig_punctuation('.', '.') prefix += '.' first = False txt_ident = str(ident) if txt_ident != '': ident.describe_signature(dest, 'markType', env, prefix, symbol) prefix += txt_ident if mode == 'lastIsName': if len(self.names) > 1: dest += addnodes.desc_sig_punctuation('.', '.') signode += dest self.names[-1].describe_signature(signode, mode, env, '', symbol) else: raise Exception('Unknown description mode: %s' % mode) ################################################################################ # Expressions ################################################################################ class ASTExpression(ASTBase): pass # Primary expressions ################################################################################ class ASTLiteral(ASTExpression): pass class ASTBooleanLiteral(ASTLiteral): def __init__(self, value: bool) -> None: self.value = value def _stringify(self, transform: StringifyTransform) -> str: if self.value: return 'true' else: return 'false' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: txt = str(self) signode += addnodes.desc_sig_keyword(txt, txt) class ASTNumberLiteral(ASTLiteral): def __init__(self, data: str) -> None: self.data = data def _stringify(self, transform: StringifyTransform) -> str: return self.data def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: txt = str(self) signode += addnodes.desc_sig_literal_number(txt, txt) class ASTCharLiteral(ASTLiteral): def __init__(self, prefix: str, data: str) -> None: self.prefix = prefix # may be None when no prefix self.data = data decoded = data.encode().decode('unicode-escape') if len(decoded) == 1: self.value = ord(decoded) else: raise UnsupportedMultiCharacterCharLiteral(decoded) def _stringify(self, transform: StringifyTransform) -> str: if self.prefix is None: return "'" + self.data + "'" else: return self.prefix + "'" + self.data + "'" def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: txt = str(self) signode += addnodes.desc_sig_literal_char(txt, txt) class ASTStringLiteral(ASTLiteral): def __init__(self, data: str) -> None: self.data = data def _stringify(self, transform: StringifyTransform) -> str: return self.data def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: txt = str(self) signode += addnodes.desc_sig_literal_string(txt, txt) class ASTIdExpression(ASTExpression): def __init__(self, name: ASTNestedName): # note: this class is basically to cast a nested name as an expression self.name = name def _stringify(self, transform: StringifyTransform) -> str: return transform(self.name) def get_id(self, version: int) -> str: return self.name.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.name.describe_signature(signode, mode, env, symbol) class ASTParenExpr(ASTExpression): def __init__(self, expr): self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: return '(' + transform(self.expr) + ')' def get_id(self, version: int) -> str: return self.expr.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_punctuation('(', '(') self.expr.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') # Postfix expressions ################################################################################ class ASTPostfixOp(ASTBase): pass class ASTPostfixCallExpr(ASTPostfixOp): def __init__(self, lst: Union["ASTParenExprList", "ASTBracedInitList"]) -> None: self.lst = lst def _stringify(self, transform: StringifyTransform) -> str: return transform(self.lst) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.lst.describe_signature(signode, mode, env, symbol) class ASTPostfixArray(ASTPostfixOp): def __init__(self, expr: ASTExpression) -> None: self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: return '[' + transform(self.expr) + ']' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_punctuation('[', '[') self.expr.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(']', ']') class ASTPostfixInc(ASTPostfixOp): def _stringify(self, transform: StringifyTransform) -> str: return '++' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_operator('++', '++') class ASTPostfixDec(ASTPostfixOp): def _stringify(self, transform: StringifyTransform) -> str: return '--' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_operator('--', '--') class ASTPostfixMemberOfPointer(ASTPostfixOp): def __init__(self, name): self.name = name def _stringify(self, transform: StringifyTransform) -> str: return '->' + transform(self.name) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_operator('->', '->') self.name.describe_signature(signode, 'noneIsName', env, symbol) class ASTPostfixExpr(ASTExpression): def __init__(self, prefix: ASTExpression, postFixes: List[ASTPostfixOp]): self.prefix = prefix self.postFixes = postFixes def _stringify(self, transform: StringifyTransform) -> str: res = [transform(self.prefix)] for p in self.postFixes: res.append(transform(p)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.prefix.describe_signature(signode, mode, env, symbol) for p in self.postFixes: p.describe_signature(signode, mode, env, symbol) # Unary expressions ################################################################################ class ASTUnaryOpExpr(ASTExpression): def __init__(self, op: str, expr: ASTExpression): self.op = op self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: if self.op[0] in 'cn': return self.op + " " + transform(self.expr) else: return self.op + transform(self.expr) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: if self.op[0] in 'cn': signode += addnodes.desc_sig_keyword(self.op, self.op) signode += addnodes.desc_sig_space() else: signode += addnodes.desc_sig_operator(self.op, self.op) self.expr.describe_signature(signode, mode, env, symbol) class ASTSizeofType(ASTExpression): def __init__(self, typ): self.typ = typ def _stringify(self, transform: StringifyTransform) -> str: return "sizeof(" + transform(self.typ) + ")" def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('sizeof', 'sizeof') signode += addnodes.desc_sig_punctuation('(', '(') self.typ.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') class ASTSizeofExpr(ASTExpression): def __init__(self, expr: ASTExpression): self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: return "sizeof " + transform(self.expr) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('sizeof', 'sizeof') signode += addnodes.desc_sig_space() self.expr.describe_signature(signode, mode, env, symbol) class ASTAlignofExpr(ASTExpression): def __init__(self, typ: "ASTType"): self.typ = typ def _stringify(self, transform: StringifyTransform) -> str: return "alignof(" + transform(self.typ) + ")" def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('alignof', 'alignof') signode += addnodes.desc_sig_punctuation('(', '(') self.typ.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') # Other expressions ################################################################################ class ASTCastExpr(ASTExpression): def __init__(self, typ: "ASTType", expr: ASTExpression): self.typ = typ self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: res = ['('] res.append(transform(self.typ)) res.append(')') res.append(transform(self.expr)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_punctuation('(', '(') self.typ.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') self.expr.describe_signature(signode, mode, env, symbol) class ASTBinOpExpr(ASTBase): def __init__(self, exprs: List[ASTExpression], ops: List[str]): assert len(exprs) > 0 assert len(exprs) == len(ops) + 1 self.exprs = exprs self.ops = ops def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append(transform(self.exprs[0])) for i in range(1, len(self.exprs)): res.append(' ') res.append(self.ops[i - 1]) res.append(' ') res.append(transform(self.exprs[i])) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.exprs[0].describe_signature(signode, mode, env, symbol) for i in range(1, len(self.exprs)): signode += addnodes.desc_sig_space() op = self.ops[i - 1] if ord(op[0]) >= ord('a') and ord(op[0]) <= ord('z'): signode += addnodes.desc_sig_keyword(op, op) else: signode += addnodes.desc_sig_operator(op, op) signode += addnodes.desc_sig_space() self.exprs[i].describe_signature(signode, mode, env, symbol) class ASTAssignmentExpr(ASTExpression): def __init__(self, exprs: List[ASTExpression], ops: List[str]): assert len(exprs) > 0 assert len(exprs) == len(ops) + 1 self.exprs = exprs self.ops = ops def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append(transform(self.exprs[0])) for i in range(1, len(self.exprs)): res.append(' ') res.append(self.ops[i - 1]) res.append(' ') res.append(transform(self.exprs[i])) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.exprs[0].describe_signature(signode, mode, env, symbol) for i in range(1, len(self.exprs)): signode += addnodes.desc_sig_space() op = self.ops[i - 1] if ord(op[0]) >= ord('a') and ord(op[0]) <= ord('z'): signode += addnodes.desc_sig_keyword(op, op) else: signode += addnodes.desc_sig_operator(op, op) signode += addnodes.desc_sig_space() self.exprs[i].describe_signature(signode, mode, env, symbol) class ASTFallbackExpr(ASTExpression): def __init__(self, expr: str): self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: return self.expr def get_id(self, version: int) -> str: return str(self.expr) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += nodes.literal(self.expr, self.expr) ################################################################################ # Types ################################################################################ class ASTTrailingTypeSpec(ASTBase): pass class ASTTrailingTypeSpecFundamental(ASTTrailingTypeSpec): def __init__(self, names: List[str]) -> None: assert len(names) != 0 self.names = names def _stringify(self, transform: StringifyTransform) -> str: return ' '.join(self.names) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: first = True for n in self.names: if not first: signode += addnodes.desc_sig_space() else: first = False signode += addnodes.desc_sig_keyword_type(n, n) class ASTTrailingTypeSpecName(ASTTrailingTypeSpec): def __init__(self, prefix: str, nestedName: ASTNestedName) -> None: self.prefix = prefix self.nestedName = nestedName @property def name(self) -> ASTNestedName: return self.nestedName def _stringify(self, transform: StringifyTransform) -> str: res = [] if self.prefix: res.append(self.prefix) res.append(' ') res.append(transform(self.nestedName)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: if self.prefix: signode += addnodes.desc_sig_keyword(self.prefix, self.prefix) signode += addnodes.desc_sig_space() self.nestedName.describe_signature(signode, mode, env, symbol=symbol) class ASTFunctionParameter(ASTBase): def __init__(self, arg: "ASTTypeWithInit", ellipsis: bool = False) -> None: self.arg = arg self.ellipsis = ellipsis def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str: # the anchor will be our parent return symbol.parent.declaration.get_id(version, prefixed=False) def _stringify(self, transform: StringifyTransform) -> str: if self.ellipsis: return '...' else: return transform(self.arg) def describe_signature(self, signode: Any, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) if self.ellipsis: signode += addnodes.desc_sig_punctuation('...', '...') else: self.arg.describe_signature(signode, mode, env, symbol=symbol) class ASTParameters(ASTBase): def __init__(self, args: List[ASTFunctionParameter], attrs: List[ASTAttribute]) -> None: self.args = args self.attrs = attrs @property def function_params(self) -> List[ASTFunctionParameter]: return self.args def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append('(') first = True for a in self.args: if not first: res.append(', ') first = False res.append(str(a)) res.append(')') for attr in self.attrs: res.append(' ') res.append(transform(attr)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) # only use the desc_parameterlist for the outer list, not for inner lists if mode == 'lastIsName': paramlist = addnodes.desc_parameterlist() for arg in self.args: param = addnodes.desc_parameter('', '', noemph=True) arg.describe_signature(param, 'param', env, symbol=symbol) paramlist += param signode += paramlist else: signode += addnodes.desc_sig_punctuation('(', '(') first = True for arg in self.args: if not first: signode += addnodes.desc_sig_punctuation(',', ',') signode += addnodes.desc_sig_space() first = False arg.describe_signature(signode, 'markType', env, symbol=symbol) signode += addnodes.desc_sig_punctuation(')', ')') for attr in self.attrs: signode += addnodes.desc_sig_space() attr.describe_signature(signode) class ASTDeclSpecsSimple(ASTBaseBase): def __init__(self, storage: str, threadLocal: str, inline: bool, restrict: bool, volatile: bool, const: bool, attrs: List[Any]) -> None: self.storage = storage self.threadLocal = threadLocal self.inline = inline self.restrict = restrict self.volatile = volatile self.const = const self.attrs = attrs def mergeWith(self, other: "ASTDeclSpecsSimple") -> "ASTDeclSpecsSimple": if not other: return self return ASTDeclSpecsSimple(self.storage or other.storage, self.threadLocal or other.threadLocal, self.inline or other.inline, self.volatile or other.volatile, self.const or other.const, self.restrict or other.restrict, self.attrs + other.attrs) def _stringify(self, transform: StringifyTransform) -> str: res: List[str] = [] res.extend(transform(attr) for attr in self.attrs) if self.storage: res.append(self.storage) if self.threadLocal: res.append(self.threadLocal) if self.inline: res.append('inline') if self.restrict: res.append('restrict') if self.volatile: res.append('volatile') if self.const: res.append('const') return ' '.join(res) def describe_signature(self, modifiers: List[Node]) -> None: def _add(modifiers: List[Node], text: str) -> None: if len(modifiers) > 0: modifiers.append(addnodes.desc_sig_space()) modifiers.append(addnodes.desc_sig_keyword(text, text)) for attr in self.attrs: if len(modifiers) > 0: modifiers.append(addnodes.desc_sig_space()) modifiers.append(attr.describe_signature(modifiers)) if self.storage: _add(modifiers, self.storage) if self.threadLocal: _add(modifiers, self.threadLocal) if self.inline: _add(modifiers, 'inline') if self.restrict: _add(modifiers, 'restrict') if self.volatile: _add(modifiers, 'volatile') if self.const: _add(modifiers, 'const') class ASTDeclSpecs(ASTBase): def __init__(self, outer: str, leftSpecs: ASTDeclSpecsSimple, rightSpecs: ASTDeclSpecsSimple, trailing: ASTTrailingTypeSpec) -> None: # leftSpecs and rightSpecs are used for output # allSpecs are used for id generation TODO: remove? self.outer = outer self.leftSpecs = leftSpecs self.rightSpecs = rightSpecs self.allSpecs = self.leftSpecs.mergeWith(self.rightSpecs) self.trailingTypeSpec = trailing def _stringify(self, transform: StringifyTransform) -> str: res: List[str] = [] l = transform(self.leftSpecs) if len(l) > 0: res.append(l) if self.trailingTypeSpec: if len(res) > 0: res.append(" ") res.append(transform(self.trailingTypeSpec)) r = str(self.rightSpecs) if len(r) > 0: if len(res) > 0: res.append(" ") res.append(r) return "".join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) modifiers: List[Node] = [] self.leftSpecs.describe_signature(modifiers) for m in modifiers: signode += m if self.trailingTypeSpec: if len(modifiers) > 0: signode += addnodes.desc_sig_space() self.trailingTypeSpec.describe_signature(signode, mode, env, symbol=symbol) modifiers = [] self.rightSpecs.describe_signature(modifiers) if len(modifiers) > 0: signode += addnodes.desc_sig_space() for m in modifiers: signode += m # Declarator ################################################################################ class ASTArray(ASTBase): def __init__(self, static: bool, const: bool, volatile: bool, restrict: bool, vla: bool, size: ASTExpression): self.static = static self.const = const self.volatile = volatile self.restrict = restrict self.vla = vla self.size = size if vla: assert size is None if size is not None: assert not vla def _stringify(self, transform: StringifyTransform) -> str: el = [] if self.static: el.append('static') if self.restrict: el.append('restrict') if self.volatile: el.append('volatile') if self.const: el.append('const') if self.vla: return '[' + ' '.join(el) + '*]' elif self.size: el.append(transform(self.size)) return '[' + ' '.join(el) + ']' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) signode += addnodes.desc_sig_punctuation('[', '[') addSpace = False def _add(signode: TextElement, text: str) -> bool: if addSpace: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_keyword(text, text) return True if self.static: addSpace = _add(signode, 'static') if self.restrict: addSpace = _add(signode, 'restrict') if self.volatile: addSpace = _add(signode, 'volatile') if self.const: addSpace = _add(signode, 'const') if self.vla: signode += addnodes.desc_sig_punctuation('*', '*') elif self.size: if addSpace: signode += addnodes.desc_sig_space() self.size.describe_signature(signode, 'markType', env, symbol) signode += addnodes.desc_sig_punctuation(']', ']') class ASTDeclarator(ASTBase): @property def name(self) -> ASTNestedName: raise NotImplementedError(repr(self)) @property def function_params(self) -> List[ASTFunctionParameter]: raise NotImplementedError(repr(self)) def require_space_after_declSpecs(self) -> bool: raise NotImplementedError(repr(self)) class ASTDeclaratorNameParam(ASTDeclarator): def __init__(self, declId: ASTNestedName, arrayOps: List[ASTArray], param: ASTParameters) -> None: self.declId = declId self.arrayOps = arrayOps self.param = param @property def name(self) -> ASTNestedName: return self.declId @property def function_params(self) -> List[ASTFunctionParameter]: return self.param.function_params # ------------------------------------------------------------------------ def require_space_after_declSpecs(self) -> bool: return self.declId is not None def _stringify(self, transform: StringifyTransform) -> str: res = [] if self.declId: res.append(transform(self.declId)) for op in self.arrayOps: res.append(transform(op)) if self.param: res.append(transform(self.param)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) if self.declId: self.declId.describe_signature(signode, mode, env, symbol) for op in self.arrayOps: op.describe_signature(signode, mode, env, symbol) if self.param: self.param.describe_signature(signode, mode, env, symbol) class ASTDeclaratorNameBitField(ASTDeclarator): def __init__(self, declId: ASTNestedName, size: ASTExpression): self.declId = declId self.size = size @property def name(self) -> ASTNestedName: return self.declId # ------------------------------------------------------------------------ def require_space_after_declSpecs(self) -> bool: return self.declId is not None def _stringify(self, transform: StringifyTransform) -> str: res = [] if self.declId: res.append(transform(self.declId)) res.append(" : ") res.append(transform(self.size)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) if self.declId: self.declId.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_punctuation(':', ':') signode += addnodes.desc_sig_space() self.size.describe_signature(signode, mode, env, symbol) class ASTDeclaratorPtr(ASTDeclarator): def __init__(self, next: ASTDeclarator, restrict: bool, volatile: bool, const: bool, attrs: Any) -> None: assert next self.next = next self.restrict = restrict self.volatile = volatile self.const = const self.attrs = attrs @property def name(self) -> ASTNestedName: return self.next.name @property def function_params(self) -> List[ASTFunctionParameter]: return self.next.function_params def require_space_after_declSpecs(self) -> bool: return self.const or self.volatile or self.restrict or \ len(self.attrs) > 0 or \ self.next.require_space_after_declSpecs() def _stringify(self, transform: StringifyTransform) -> str: res = ['*'] for a in self.attrs: res.append(transform(a)) if len(self.attrs) > 0 and (self.restrict or self.volatile or self.const): res.append(' ') if self.restrict: res.append('restrict') if self.volatile: if self.restrict: res.append(' ') res.append('volatile') if self.const: if self.restrict or self.volatile: res.append(' ') res.append('const') if self.const or self.volatile or self.restrict or len(self.attrs) > 0: if self.next.require_space_after_declSpecs(): res.append(' ') res.append(transform(self.next)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) signode += addnodes.desc_sig_punctuation('*', '*') for a in self.attrs: a.describe_signature(signode) if len(self.attrs) > 0 and (self.restrict or self.volatile or self.const): signode += addnodes.desc_sig_space() def _add_anno(signode: TextElement, text: str) -> None: signode += addnodes.desc_sig_keyword(text, text) if self.restrict: _add_anno(signode, 'restrict') if self.volatile: if self.restrict: signode += addnodes.desc_sig_space() _add_anno(signode, 'volatile') if self.const: if self.restrict or self.volatile: signode += addnodes.desc_sig_space() _add_anno(signode, 'const') if self.const or self.volatile or self.restrict or len(self.attrs) > 0: if self.next.require_space_after_declSpecs(): signode += addnodes.desc_sig_space() self.next.describe_signature(signode, mode, env, symbol) class ASTDeclaratorParen(ASTDeclarator): def __init__(self, inner: ASTDeclarator, next: ASTDeclarator) -> None: assert inner assert next self.inner = inner self.next = next # TODO: we assume the name and params are in inner @property def name(self) -> ASTNestedName: return self.inner.name @property def function_params(self) -> List[ASTFunctionParameter]: return self.inner.function_params def require_space_after_declSpecs(self) -> bool: return True def _stringify(self, transform: StringifyTransform) -> str: res = ['('] res.append(transform(self.inner)) res.append(')') res.append(transform(self.next)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) signode += addnodes.desc_sig_punctuation('(', '(') self.inner.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') self.next.describe_signature(signode, "noneIsName", env, symbol) # Initializer ################################################################################ class ASTParenExprList(ASTBaseParenExprList): def __init__(self, exprs: List[ASTExpression]) -> None: self.exprs = exprs def _stringify(self, transform: StringifyTransform) -> str: exprs = [transform(e) for e in self.exprs] return '(%s)' % ', '.join(exprs) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) signode += addnodes.desc_sig_punctuation('(', '(') first = True for e in self.exprs: if not first: signode += addnodes.desc_sig_punctuation(',', ',') signode += addnodes.desc_sig_space() else: first = False e.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') class ASTBracedInitList(ASTBase): def __init__(self, exprs: List[ASTExpression], trailingComma: bool) -> None: self.exprs = exprs self.trailingComma = trailingComma def _stringify(self, transform: StringifyTransform) -> str: exprs = [transform(e) for e in self.exprs] trailingComma = ',' if self.trailingComma else '' return '{%s%s}' % (', '.join(exprs), trailingComma) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) signode += addnodes.desc_sig_punctuation('{', '{') first = True for e in self.exprs: if not first: signode += addnodes.desc_sig_punctuation(',', ',') signode += addnodes.desc_sig_space() else: first = False e.describe_signature(signode, mode, env, symbol) if self.trailingComma: signode += addnodes.desc_sig_punctuation(',', ',') signode += addnodes.desc_sig_punctuation('}', '}') class ASTInitializer(ASTBase): def __init__(self, value: Union[ASTBracedInitList, ASTExpression], hasAssign: bool = True) -> None: self.value = value self.hasAssign = hasAssign def _stringify(self, transform: StringifyTransform) -> str: val = transform(self.value) if self.hasAssign: return ' = ' + val else: return val def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) if self.hasAssign: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_punctuation('=', '=') signode += addnodes.desc_sig_space() self.value.describe_signature(signode, 'markType', env, symbol) class ASTType(ASTBase): def __init__(self, declSpecs: ASTDeclSpecs, decl: ASTDeclarator) -> None: assert declSpecs assert decl self.declSpecs = declSpecs self.decl = decl @property def name(self) -> ASTNestedName: return self.decl.name def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str: return symbol.get_full_nested_name().get_id(version) @property def function_params(self) -> List[ASTFunctionParameter]: return self.decl.function_params def _stringify(self, transform: StringifyTransform) -> str: res = [] declSpecs = transform(self.declSpecs) res.append(declSpecs) if self.decl.require_space_after_declSpecs() and len(declSpecs) > 0: res.append(' ') res.append(transform(self.decl)) return ''.join(res) def get_type_declaration_prefix(self) -> str: if self.declSpecs.trailingTypeSpec: return 'typedef' else: return 'type' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.declSpecs.describe_signature(signode, 'markType', env, symbol) if (self.decl.require_space_after_declSpecs() and len(str(self.declSpecs)) > 0): signode += addnodes.desc_sig_space() # for parameters that don't really declare new names we get 'markType', # this should not be propagated, but be 'noneIsName'. if mode == 'markType': mode = 'noneIsName' self.decl.describe_signature(signode, mode, env, symbol) class ASTTypeWithInit(ASTBase): def __init__(self, type: ASTType, init: ASTInitializer) -> None: self.type = type self.init = init @property def name(self) -> ASTNestedName: return self.type.name def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str: return self.type.get_id(version, objectType, symbol) def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append(transform(self.type)) if self.init: res.append(transform(self.init)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.type.describe_signature(signode, mode, env, symbol) if self.init: self.init.describe_signature(signode, mode, env, symbol) class ASTMacroParameter(ASTBase): def __init__(self, arg: ASTNestedName, ellipsis: bool = False, variadic: bool = False) -> None: self.arg = arg self.ellipsis = ellipsis self.variadic = variadic def _stringify(self, transform: StringifyTransform) -> str: if self.ellipsis: return '...' elif self.variadic: return transform(self.arg) + '...' else: return transform(self.arg) def describe_signature(self, signode: Any, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) if self.ellipsis: signode += addnodes.desc_sig_punctuation('...', '...') elif self.variadic: name = str(self) signode += addnodes.desc_sig_name(name, name) else: self.arg.describe_signature(signode, mode, env, symbol=symbol) class ASTMacro(ASTBase): def __init__(self, ident: ASTNestedName, args: List[ASTMacroParameter]) -> None: self.ident = ident self.args = args @property def name(self) -> ASTNestedName: return self.ident def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str: return symbol.get_full_nested_name().get_id(version) def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append(transform(self.ident)) if self.args is not None: res.append('(') first = True for arg in self.args: if not first: res.append(', ') first = False res.append(transform(arg)) res.append(')') return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.ident.describe_signature(signode, mode, env, symbol) if self.args is None: return paramlist = addnodes.desc_parameterlist() for arg in self.args: param = addnodes.desc_parameter('', '', noemph=True) arg.describe_signature(param, 'param', env, symbol=symbol) paramlist += param signode += paramlist class ASTStruct(ASTBase): def __init__(self, name: ASTNestedName) -> None: self.name = name def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str: return symbol.get_full_nested_name().get_id(version) def _stringify(self, transform: StringifyTransform) -> str: return transform(self.name) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.name.describe_signature(signode, mode, env, symbol=symbol) class ASTUnion(ASTBase): def __init__(self, name: ASTNestedName) -> None: self.name = name def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str: return symbol.get_full_nested_name().get_id(version) def _stringify(self, transform: StringifyTransform) -> str: return transform(self.name) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.name.describe_signature(signode, mode, env, symbol=symbol) class ASTEnum(ASTBase): def __init__(self, name: ASTNestedName) -> None: self.name = name def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str: return symbol.get_full_nested_name().get_id(version) def _stringify(self, transform: StringifyTransform) -> str: return transform(self.name) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.name.describe_signature(signode, mode, env, symbol=symbol) class ASTEnumerator(ASTBase): def __init__(self, name: ASTNestedName, init: ASTInitializer) -> None: self.name = name self.init = init def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str: return symbol.get_full_nested_name().get_id(version) def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append(transform(self.name)) if self.init: res.append(transform(self.init)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.name.describe_signature(signode, mode, env, symbol) if self.init: self.init.describe_signature(signode, 'markType', env, symbol) class ASTDeclaration(ASTBaseBase): def __init__(self, objectType: str, directiveType: str, declaration: Union[DeclarationType, ASTFunctionParameter], semicolon: bool = False) -> None: self.objectType = objectType self.directiveType = directiveType self.declaration = declaration self.semicolon = semicolon self.symbol: Symbol = None # set by CObject._add_enumerator_to_parent self.enumeratorScopedSymbol: Symbol = None def clone(self) -> "ASTDeclaration": return ASTDeclaration(self.objectType, self.directiveType, self.declaration.clone(), self.semicolon) @property def name(self) -> ASTNestedName: decl = cast(DeclarationType, self.declaration) return decl.name @property def function_params(self) -> List[ASTFunctionParameter]: if self.objectType != 'function': return None decl = cast(ASTType, self.declaration) return decl.function_params def get_id(self, version: int, prefixed: bool = True) -> str: if self.objectType == 'enumerator' and self.enumeratorScopedSymbol: return self.enumeratorScopedSymbol.declaration.get_id(version, prefixed) id_ = self.declaration.get_id(version, self.objectType, self.symbol) if prefixed: return _id_prefix[version] + id_ else: return id_ def get_newest_id(self) -> str: return self.get_id(_max_id, True) def _stringify(self, transform: StringifyTransform) -> str: res = transform(self.declaration) if self.semicolon: res += ';' return res def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", options: Dict) -> None: verify_description_mode(mode) assert self.symbol # The caller of the domain added a desc_signature node. # Always enable multiline: signode['is_multiline'] = True # Put each line in a desc_signature_line node. mainDeclNode = addnodes.desc_signature_line() mainDeclNode.sphinx_line_type = 'declarator' mainDeclNode['add_permalink'] = not self.symbol.isRedeclaration signode += mainDeclNode if self.objectType == 'member': pass elif self.objectType == 'function': pass elif self.objectType == 'macro': pass elif self.objectType == 'struct': mainDeclNode += addnodes.desc_sig_keyword('struct', 'struct') mainDeclNode += addnodes.desc_sig_space() elif self.objectType == 'union': mainDeclNode += addnodes.desc_sig_keyword('union', 'union') mainDeclNode += addnodes.desc_sig_space() elif self.objectType == 'enum': mainDeclNode += addnodes.desc_sig_keyword('enum', 'enum') mainDeclNode += addnodes.desc_sig_space() elif self.objectType == 'enumerator': mainDeclNode += addnodes.desc_sig_keyword('enumerator', 'enumerator') mainDeclNode += addnodes.desc_sig_space() elif self.objectType == 'type': decl = cast(ASTType, self.declaration) prefix = decl.get_type_declaration_prefix() mainDeclNode += addnodes.desc_sig_keyword(prefix, prefix) mainDeclNode += addnodes.desc_sig_space() else: assert False self.declaration.describe_signature(mainDeclNode, mode, env, self.symbol) if self.semicolon: mainDeclNode += addnodes.desc_sig_punctuation(';', ';') class SymbolLookupResult: def __init__(self, symbols: Iterator["Symbol"], parentSymbol: "Symbol", ident: ASTIdentifier) -> None: self.symbols = symbols self.parentSymbol = parentSymbol self.ident = ident class LookupKey: def __init__(self, data: List[Tuple[ASTIdentifier, str]]) -> None: self.data = data def __str__(self) -> str: return '[{}]'.format(', '.join("({}, {})".format( ident, id_) for ident, id_ in self.data)) class Symbol: debug_indent = 0 debug_indent_string = " " debug_lookup = False debug_show_tree = False def __copy__(self): assert False # shouldn't happen def __deepcopy__(self, memo): if self.parent: assert False # shouldn't happen else: # the domain base class makes a copy of the initial data, which is fine return Symbol(None, None, None, None, None) @staticmethod def debug_print(*args: Any) -> None: print(Symbol.debug_indent_string * Symbol.debug_indent, end="") print(*args) def _assert_invariants(self) -> None: if not self.parent: # parent == None means global scope, so declaration means a parent assert not self.declaration assert not self.docname else: if self.declaration: assert self.docname def __setattr__(self, key: str, value: Any) -> None: if key == "children": assert False else: return super().__setattr__(key, value) def __init__(self, parent: "Symbol", ident: ASTIdentifier, declaration: ASTDeclaration, docname: str, line: int) -> None: self.parent = parent # declarations in a single directive are linked together self.siblingAbove: Symbol = None self.siblingBelow: Symbol = None self.ident = ident self.declaration = declaration self.docname = docname self.line = line self.isRedeclaration = False self._assert_invariants() # Remember to modify Symbol.remove if modifications to the parent change. self._children: List[Symbol] = [] self._anonChildren: List[Symbol] = [] # note: _children includes _anonChildren if self.parent: self.parent._children.append(self) if self.declaration: self.declaration.symbol = self # Do symbol addition after self._children has been initialised. self._add_function_params() def _fill_empty(self, declaration: ASTDeclaration, docname: str, line: int) -> None: self._assert_invariants() assert self.declaration is None assert self.docname is None assert self.line is None assert declaration is not None assert docname is not None assert line is not None self.declaration = declaration self.declaration.symbol = self self.docname = docname self.line = line self._assert_invariants() # and symbol addition should be done as well self._add_function_params() def _add_function_params(self) -> None: if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("_add_function_params:") # Note: we may be called from _fill_empty, so the symbols we want # to add may actually already be present (as empty symbols). # add symbols for function parameters, if any if self.declaration is not None and self.declaration.function_params is not None: for p in self.declaration.function_params: if p.arg is None: continue nn = p.arg.name if nn is None: continue # (comparing to the template params: we have checked that we are a declaration) decl = ASTDeclaration('functionParam', None, p) assert not nn.rooted assert len(nn.names) == 1 self._add_symbols(nn, decl, self.docname, self.line) if Symbol.debug_lookup: Symbol.debug_indent -= 1 def remove(self) -> None: if self.parent is None: return assert self in self.parent._children self.parent._children.remove(self) self.parent = None def clear_doc(self, docname: str) -> None: for sChild in self._children: sChild.clear_doc(docname) if sChild.declaration and sChild.docname == docname: sChild.declaration = None sChild.docname = None sChild.line = None if sChild.siblingAbove is not None: sChild.siblingAbove.siblingBelow = sChild.siblingBelow if sChild.siblingBelow is not None: sChild.siblingBelow.siblingAbove = sChild.siblingAbove sChild.siblingAbove = None sChild.siblingBelow = None def get_all_symbols(self) -> Iterator["Symbol"]: yield self for sChild in self._children: yield from sChild.get_all_symbols() @property def children(self) -> Iterator["Symbol"]: yield from self._children @property def children_recurse_anon(self) -> Iterator["Symbol"]: for c in self._children: yield c if not c.ident.is_anon(): continue yield from c.children_recurse_anon def get_lookup_key(self) -> "LookupKey": # The pickle files for the environment and for each document are distinct. # The environment has all the symbols, but the documents has xrefs that # must know their scope. A lookup key is essentially a specification of # how to find a specific symbol. symbols = [] s = self while s.parent: symbols.append(s) s = s.parent symbols.reverse() key = [] for s in symbols: if s.declaration is not None: # TODO: do we need the ID? key.append((s.ident, s.declaration.get_newest_id())) else: key.append((s.ident, None)) return LookupKey(key) def get_full_nested_name(self) -> ASTNestedName: symbols = [] s = self while s.parent: symbols.append(s) s = s.parent symbols.reverse() names = [] for s in symbols: names.append(s.ident) return ASTNestedName(names, rooted=False) def _find_first_named_symbol(self, ident: ASTIdentifier, matchSelf: bool, recurseInAnon: bool) -> "Symbol": # TODO: further simplification from C++ to C if Symbol.debug_lookup: Symbol.debug_print("_find_first_named_symbol ->") res = self._find_named_symbols(ident, matchSelf, recurseInAnon, searchInSiblings=False) try: return next(res) except StopIteration: return None def _find_named_symbols(self, ident: ASTIdentifier, matchSelf: bool, recurseInAnon: bool, searchInSiblings: bool) -> Iterator["Symbol"]: # TODO: further simplification from C++ to C if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("_find_named_symbols:") Symbol.debug_indent += 1 Symbol.debug_print("self:") print(self.to_string(Symbol.debug_indent + 1), end="") Symbol.debug_print("ident: ", ident) Symbol.debug_print("matchSelf: ", matchSelf) Symbol.debug_print("recurseInAnon: ", recurseInAnon) Symbol.debug_print("searchInSiblings: ", searchInSiblings) def candidates() -> Generator["Symbol", None, None]: s = self if Symbol.debug_lookup: Symbol.debug_print("searching in self:") print(s.to_string(Symbol.debug_indent + 1), end="") while True: if matchSelf: yield s if recurseInAnon: yield from s.children_recurse_anon else: yield from s._children if s.siblingAbove is None: break s = s.siblingAbove if Symbol.debug_lookup: Symbol.debug_print("searching in sibling:") print(s.to_string(Symbol.debug_indent + 1), end="") for s in candidates(): if Symbol.debug_lookup: Symbol.debug_print("candidate:") print(s.to_string(Symbol.debug_indent + 1), end="") if s.ident == ident: if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("matches") Symbol.debug_indent -= 3 yield s if Symbol.debug_lookup: Symbol.debug_indent += 2 if Symbol.debug_lookup: Symbol.debug_indent -= 2 def _symbol_lookup(self, nestedName: ASTNestedName, onMissingQualifiedSymbol: Callable[["Symbol", ASTIdentifier], "Symbol"], # NOQA ancestorLookupType: str, matchSelf: bool, recurseInAnon: bool, searchInSiblings: bool) -> SymbolLookupResult: # TODO: further simplification from C++ to C # ancestorLookupType: if not None, specifies the target type of the lookup if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("_symbol_lookup:") Symbol.debug_indent += 1 Symbol.debug_print("self:") print(self.to_string(Symbol.debug_indent + 1), end="") Symbol.debug_print("nestedName: ", nestedName) Symbol.debug_print("ancestorLookupType:", ancestorLookupType) Symbol.debug_print("matchSelf: ", matchSelf) Symbol.debug_print("recurseInAnon: ", recurseInAnon) Symbol.debug_print("searchInSiblings: ", searchInSiblings) names = nestedName.names # find the right starting point for lookup parentSymbol = self if nestedName.rooted: while parentSymbol.parent: parentSymbol = parentSymbol.parent if ancestorLookupType is not None: # walk up until we find the first identifier firstName = names[0] while parentSymbol.parent: if parentSymbol.find_identifier(firstName, matchSelf=matchSelf, recurseInAnon=recurseInAnon, searchInSiblings=searchInSiblings): break parentSymbol = parentSymbol.parent if Symbol.debug_lookup: Symbol.debug_print("starting point:") print(parentSymbol.to_string(Symbol.debug_indent + 1), end="") # and now the actual lookup for ident in names[:-1]: symbol = parentSymbol._find_first_named_symbol( ident, matchSelf=matchSelf, recurseInAnon=recurseInAnon) if symbol is None: symbol = onMissingQualifiedSymbol(parentSymbol, ident) if symbol is None: if Symbol.debug_lookup: Symbol.debug_indent -= 2 return None # We have now matched part of a nested name, and need to match more # so even if we should matchSelf before, we definitely shouldn't # even more. (see also issue #2666) matchSelf = False parentSymbol = symbol if Symbol.debug_lookup: Symbol.debug_print("handle last name from:") print(parentSymbol.to_string(Symbol.debug_indent + 1), end="") # handle the last name ident = names[-1] symbols = parentSymbol._find_named_symbols( ident, matchSelf=matchSelf, recurseInAnon=recurseInAnon, searchInSiblings=searchInSiblings) if Symbol.debug_lookup: symbols = list(symbols) # type: ignore Symbol.debug_indent -= 2 return SymbolLookupResult(symbols, parentSymbol, ident) def _add_symbols(self, nestedName: ASTNestedName, declaration: ASTDeclaration, docname: str, line: int) -> "Symbol": # TODO: further simplification from C++ to C # Used for adding a whole path of symbols, where the last may or may not # be an actual declaration. if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("_add_symbols:") Symbol.debug_indent += 1 Symbol.debug_print("nn: ", nestedName) Symbol.debug_print("decl: ", declaration) Symbol.debug_print("location: {}:{}".format(docname, line)) def onMissingQualifiedSymbol(parentSymbol: "Symbol", ident: ASTIdentifier) -> "Symbol": if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("_add_symbols, onMissingQualifiedSymbol:") Symbol.debug_indent += 1 Symbol.debug_print("ident: ", ident) Symbol.debug_indent -= 2 return Symbol(parent=parentSymbol, ident=ident, declaration=None, docname=None, line=None) lookupResult = self._symbol_lookup(nestedName, onMissingQualifiedSymbol, ancestorLookupType=None, matchSelf=False, recurseInAnon=False, searchInSiblings=False) assert lookupResult is not None # we create symbols all the way, so that can't happen symbols = list(lookupResult.symbols) if len(symbols) == 0: if Symbol.debug_lookup: Symbol.debug_print("_add_symbols, result, no symbol:") Symbol.debug_indent += 1 Symbol.debug_print("ident: ", lookupResult.ident) Symbol.debug_print("declaration: ", declaration) Symbol.debug_print("location: {}:{}".format(docname, line)) Symbol.debug_indent -= 1 symbol = Symbol(parent=lookupResult.parentSymbol, ident=lookupResult.ident, declaration=declaration, docname=docname, line=line) if Symbol.debug_lookup: Symbol.debug_indent -= 2 return symbol if Symbol.debug_lookup: Symbol.debug_print("_add_symbols, result, symbols:") Symbol.debug_indent += 1 Symbol.debug_print("number symbols:", len(symbols)) Symbol.debug_indent -= 1 if not declaration: if Symbol.debug_lookup: Symbol.debug_print("no declaration") Symbol.debug_indent -= 2 # good, just a scope creation # TODO: what if we have more than one symbol? return symbols[0] noDecl = [] withDecl = [] dupDecl = [] for s in symbols: if s.declaration is None: noDecl.append(s) elif s.isRedeclaration: dupDecl.append(s) else: withDecl.append(s) if Symbol.debug_lookup: Symbol.debug_print("#noDecl: ", len(noDecl)) Symbol.debug_print("#withDecl:", len(withDecl)) Symbol.debug_print("#dupDecl: ", len(dupDecl)) # With partial builds we may start with a large symbol tree stripped of declarations. # Essentially any combination of noDecl, withDecl, and dupDecls seems possible. # TODO: make partial builds fully work. What should happen when the primary symbol gets # deleted, and other duplicates exist? The full document should probably be rebuild. # First check if one of those with a declaration matches. # If it's a function, we need to compare IDs, # otherwise there should be only one symbol with a declaration. def makeCandSymbol() -> "Symbol": if Symbol.debug_lookup: Symbol.debug_print("begin: creating candidate symbol") symbol = Symbol(parent=lookupResult.parentSymbol, ident=lookupResult.ident, declaration=declaration, docname=docname, line=line) if Symbol.debug_lookup: Symbol.debug_print("end: creating candidate symbol") return symbol if len(withDecl) == 0: candSymbol = None else: candSymbol = makeCandSymbol() def handleDuplicateDeclaration(symbol: "Symbol", candSymbol: "Symbol") -> None: if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("redeclaration") Symbol.debug_indent -= 1 Symbol.debug_indent -= 2 # Redeclaration of the same symbol. # Let the new one be there, but raise an error to the client # so it can use the real symbol as subscope. # This will probably result in a duplicate id warning. candSymbol.isRedeclaration = True raise _DuplicateSymbolError(symbol, declaration) if declaration.objectType != "function": assert len(withDecl) <= 1 handleDuplicateDeclaration(withDecl[0], candSymbol) # (not reachable) # a function, so compare IDs candId = declaration.get_newest_id() if Symbol.debug_lookup: Symbol.debug_print("candId:", candId) for symbol in withDecl: oldId = symbol.declaration.get_newest_id() if Symbol.debug_lookup: Symbol.debug_print("oldId: ", oldId) if candId == oldId: handleDuplicateDeclaration(symbol, candSymbol) # (not reachable) # no candidate symbol found with matching ID # if there is an empty symbol, fill that one if len(noDecl) == 0: if Symbol.debug_lookup: Symbol.debug_print("no match, no empty, candSybmol is not None?:", candSymbol is not None) # NOQA Symbol.debug_indent -= 2 if candSymbol is not None: return candSymbol else: return makeCandSymbol() else: if Symbol.debug_lookup: Symbol.debug_print( "no match, but fill an empty declaration, candSybmol is not None?:", candSymbol is not None) # NOQA Symbol.debug_indent -= 2 if candSymbol is not None: candSymbol.remove() # assert len(noDecl) == 1 # TODO: enable assertion when we at some point find out how to do cleanup # for now, just take the first one, it should work fine ... right? symbol = noDecl[0] # If someone first opened the scope, and then later # declares it, e.g, # .. namespace:: Test # .. namespace:: nullptr # .. class:: Test symbol._fill_empty(declaration, docname, line) return symbol def merge_with(self, other: "Symbol", docnames: List[str], env: "BuildEnvironment") -> None: if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("merge_with:") assert other is not None for otherChild in other._children: ourChild = self._find_first_named_symbol( ident=otherChild.ident, matchSelf=False, recurseInAnon=False) if ourChild is None: # TODO: hmm, should we prune by docnames? self._children.append(otherChild) otherChild.parent = self otherChild._assert_invariants() continue if otherChild.declaration and otherChild.docname in docnames: if not ourChild.declaration: ourChild._fill_empty(otherChild.declaration, otherChild.docname, otherChild.line) elif ourChild.docname != otherChild.docname: name = str(ourChild.declaration) msg = __("Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'.") msg = msg % (ourChild.docname, ourChild.line, ourChild.declaration.directiveType, name) logger.warning(msg, location=(otherChild.docname, otherChild.line)) else: # Both have declarations, and in the same docname. # This can apparently happen, it should be safe to # just ignore it, right? pass ourChild.merge_with(otherChild, docnames, env) if Symbol.debug_lookup: Symbol.debug_indent -= 1 def add_name(self, nestedName: ASTNestedName) -> "Symbol": if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("add_name:") res = self._add_symbols(nestedName, declaration=None, docname=None, line=None) if Symbol.debug_lookup: Symbol.debug_indent -= 1 return res def add_declaration(self, declaration: ASTDeclaration, docname: str, line: int) -> "Symbol": if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("add_declaration:") assert declaration is not None assert docname is not None assert line is not None nestedName = declaration.name res = self._add_symbols(nestedName, declaration, docname, line) if Symbol.debug_lookup: Symbol.debug_indent -= 1 return res def find_identifier(self, ident: ASTIdentifier, matchSelf: bool, recurseInAnon: bool, searchInSiblings: bool ) -> "Symbol": if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("find_identifier:") Symbol.debug_indent += 1 Symbol.debug_print("ident: ", ident) Symbol.debug_print("matchSelf: ", matchSelf) Symbol.debug_print("recurseInAnon: ", recurseInAnon) Symbol.debug_print("searchInSiblings:", searchInSiblings) print(self.to_string(Symbol.debug_indent + 1), end="") Symbol.debug_indent -= 2 current = self while current is not None: if Symbol.debug_lookup: Symbol.debug_indent += 2 Symbol.debug_print("trying:") print(current.to_string(Symbol.debug_indent + 1), end="") Symbol.debug_indent -= 2 if matchSelf and current.ident == ident: return current children = current.children_recurse_anon if recurseInAnon else current._children for s in children: if s.ident == ident: return s if not searchInSiblings: break current = current.siblingAbove return None def direct_lookup(self, key: "LookupKey") -> "Symbol": if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("direct_lookup:") Symbol.debug_indent += 1 s = self for name, id_ in key.data: res = None for cand in s._children: if cand.ident == name: res = cand break s = res if Symbol.debug_lookup: Symbol.debug_print("name: ", name) Symbol.debug_print("id: ", id_) if s is not None: print(s.to_string(Symbol.debug_indent + 1), end="") else: Symbol.debug_print("not found") if s is None: if Symbol.debug_lookup: Symbol.debug_indent -= 2 return None if Symbol.debug_lookup: Symbol.debug_indent -= 2 return s def find_declaration(self, nestedName: ASTNestedName, typ: str, matchSelf: bool, recurseInAnon: bool) -> "Symbol": # templateShorthand: missing template parameter lists for templates is ok if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("find_declaration:") def onMissingQualifiedSymbol(parentSymbol: "Symbol", ident: ASTIdentifier) -> "Symbol": return None lookupResult = self._symbol_lookup(nestedName, onMissingQualifiedSymbol, ancestorLookupType=typ, matchSelf=matchSelf, recurseInAnon=recurseInAnon, searchInSiblings=False) if Symbol.debug_lookup: Symbol.debug_indent -= 1 if lookupResult is None: return None symbols = list(lookupResult.symbols) if len(symbols) == 0: return None return symbols[0] def to_string(self, indent: int) -> str: res = [Symbol.debug_indent_string * indent] if not self.parent: res.append('::') else: if self.ident: res.append(str(self.ident)) else: res.append(str(self.declaration)) if self.declaration: res.append(": ") if self.isRedeclaration: res.append('!!duplicate!! ') res.append(str(self.declaration)) if self.docname: res.append('\t(') res.append(self.docname) res.append(')') res.append('\n') return ''.join(res) def dump(self, indent: int) -> str: res = [self.to_string(indent)] for c in self._children: res.append(c.dump(indent + 1)) return ''.join(res) class DefinitionParser(BaseParser): @property def language(self) -> str: return 'C' @property def id_attributes(self): return self.config.c_id_attributes @property def paren_attributes(self): return self.config.c_paren_attributes def _parse_string(self) -> str: if self.current_char != '"': return None startPos = self.pos self.pos += 1 escape = False while True: if self.eof: self.fail("Unexpected end during inside string.") elif self.current_char == '"' and not escape: self.pos += 1 break elif self.current_char == '\\': escape = True else: escape = False self.pos += 1 return self.definition[startPos:self.pos] def _parse_literal(self) -> ASTLiteral: # -> integer-literal # | character-literal # | floating-literal # | string-literal # | boolean-literal -> "false" | "true" self.skip_ws() if self.skip_word('true'): return ASTBooleanLiteral(True) if self.skip_word('false'): return ASTBooleanLiteral(False) pos = self.pos if self.match(float_literal_re): self.match(float_literal_suffix_re) return ASTNumberLiteral(self.definition[pos:self.pos]) for regex in [binary_literal_re, hex_literal_re, integer_literal_re, octal_literal_re]: if self.match(regex): self.match(integers_literal_suffix_re) return ASTNumberLiteral(self.definition[pos:self.pos]) string = self._parse_string() if string is not None: return ASTStringLiteral(string) # character-literal if self.match(char_literal_re): prefix = self.last_match.group(1) # may be None when no prefix data = self.last_match.group(2) try: return ASTCharLiteral(prefix, data) except UnicodeDecodeError as e: self.fail("Can not handle character literal. Internal error was: %s" % e) except UnsupportedMultiCharacterCharLiteral: self.fail("Can not handle character literal" " resulting in multiple decoded characters.") return None def _parse_paren_expression(self) -> ASTExpression: # "(" expression ")" if self.current_char != '(': return None self.pos += 1 res = self._parse_expression() self.skip_ws() if not self.skip_string(')'): self.fail("Expected ')' in end of parenthesized expression.") return ASTParenExpr(res) def _parse_primary_expression(self) -> ASTExpression: # literal # "(" expression ")" # id-expression -> we parse this with _parse_nested_name self.skip_ws() res: ASTExpression = self._parse_literal() if res is not None: return res res = self._parse_paren_expression() if res is not None: return res nn = self._parse_nested_name() if nn is not None: return ASTIdExpression(nn) return None def _parse_initializer_list(self, name: str, open: str, close: str ) -> Tuple[List[ASTExpression], bool]: # Parse open and close with the actual initializer-list in between # -> initializer-clause '...'[opt] # | initializer-list ',' initializer-clause '...'[opt] # TODO: designators self.skip_ws() if not self.skip_string_and_ws(open): return None, None if self.skip_string(close): return [], False exprs = [] trailingComma = False while True: self.skip_ws() expr = self._parse_expression() self.skip_ws() exprs.append(expr) self.skip_ws() if self.skip_string(close): break if not self.skip_string_and_ws(','): self.fail("Error in %s, expected ',' or '%s'." % (name, close)) if self.current_char == close and close == '}': self.pos += 1 trailingComma = True break return exprs, trailingComma def _parse_paren_expression_list(self) -> ASTParenExprList: # -> '(' expression-list ')' # though, we relax it to also allow empty parens # as it's needed in some cases # # expression-list # -> initializer-list exprs, trailingComma = self._parse_initializer_list("parenthesized expression-list", '(', ')') if exprs is None: return None return ASTParenExprList(exprs) def _parse_braced_init_list(self) -> ASTBracedInitList: # -> '{' initializer-list ','[opt] '}' # | '{' '}' exprs, trailingComma = self._parse_initializer_list("braced-init-list", '{', '}') if exprs is None: return None return ASTBracedInitList(exprs, trailingComma) def _parse_postfix_expression(self) -> ASTPostfixExpr: # -> primary # | postfix "[" expression "]" # | postfix "[" braced-init-list [opt] "]" # | postfix "(" expression-list [opt] ")" # | postfix "." id-expression // taken care of in primary by nested name # | postfix "->" id-expression # | postfix "++" # | postfix "--" prefix = self._parse_primary_expression() # and now parse postfixes postFixes: List[ASTPostfixOp] = [] while True: self.skip_ws() if self.skip_string_and_ws('['): expr = self._parse_expression() self.skip_ws() if not self.skip_string(']'): self.fail("Expected ']' in end of postfix expression.") postFixes.append(ASTPostfixArray(expr)) continue if self.skip_string('->'): if self.skip_string('*'): # don't steal the arrow self.pos -= 3 else: name = self._parse_nested_name() postFixes.append(ASTPostfixMemberOfPointer(name)) continue if self.skip_string('++'): postFixes.append(ASTPostfixInc()) continue if self.skip_string('--'): postFixes.append(ASTPostfixDec()) continue lst = self._parse_paren_expression_list() if lst is not None: postFixes.append(ASTPostfixCallExpr(lst)) continue break return ASTPostfixExpr(prefix, postFixes) def _parse_unary_expression(self) -> ASTExpression: # -> postfix # | "++" cast # | "--" cast # | unary-operator cast -> (* | & | + | - | ! | ~) cast # The rest: # | "sizeof" unary # | "sizeof" "(" type-id ")" # | "alignof" "(" type-id ")" self.skip_ws() for op in _expression_unary_ops: # TODO: hmm, should we be able to backtrack here? if op[0] in 'cn': res = self.skip_word(op) else: res = self.skip_string(op) if res: expr = self._parse_cast_expression() return ASTUnaryOpExpr(op, expr) if self.skip_word_and_ws('sizeof'): if self.skip_string_and_ws('('): typ = self._parse_type(named=False) self.skip_ws() if not self.skip_string(')'): self.fail("Expecting ')' to end 'sizeof'.") return ASTSizeofType(typ) expr = self._parse_unary_expression() return ASTSizeofExpr(expr) if self.skip_word_and_ws('alignof'): if not self.skip_string_and_ws('('): self.fail("Expecting '(' after 'alignof'.") typ = self._parse_type(named=False) self.skip_ws() if not self.skip_string(')'): self.fail("Expecting ')' to end 'alignof'.") return ASTAlignofExpr(typ) return self._parse_postfix_expression() def _parse_cast_expression(self) -> ASTExpression: # -> unary | "(" type-id ")" cast pos = self.pos self.skip_ws() if self.skip_string('('): try: typ = self._parse_type(False) if not self.skip_string(')'): self.fail("Expected ')' in cast expression.") expr = self._parse_cast_expression() return ASTCastExpr(typ, expr) except DefinitionError as exCast: self.pos = pos try: return self._parse_unary_expression() except DefinitionError as exUnary: errs = [] errs.append((exCast, "If type cast expression")) errs.append((exUnary, "If unary expression")) raise self._make_multi_error(errs, "Error in cast expression.") from exUnary else: return self._parse_unary_expression() def _parse_logical_or_expression(self) -> ASTExpression: # logical-or = logical-and || # logical-and = inclusive-or && # inclusive-or = exclusive-or | # exclusive-or = and ^ # and = equality & # equality = relational ==, != # relational = shift <, >, <=, >= # shift = additive <<, >> # additive = multiplicative +, - # multiplicative = pm *, /, % # pm = cast .*, ->* def _parse_bin_op_expr(self, opId): if opId + 1 == len(_expression_bin_ops): def parser() -> ASTExpression: return self._parse_cast_expression() else: def parser() -> ASTExpression: return _parse_bin_op_expr(self, opId + 1) exprs = [] ops = [] exprs.append(parser()) while True: self.skip_ws() pos = self.pos oneMore = False for op in _expression_bin_ops[opId]: if op[0] in 'abcnox': if not self.skip_word(op): continue else: if not self.skip_string(op): continue if op == '&' and self.current_char == '&': # don't split the && 'token' self.pos -= 1 # and btw. && has lower precedence, so we are done break try: expr = parser() exprs.append(expr) ops.append(op) oneMore = True break except DefinitionError: self.pos = pos if not oneMore: break return ASTBinOpExpr(exprs, ops) return _parse_bin_op_expr(self, 0) def _parse_conditional_expression_tail(self, orExprHead: Any) -> ASTExpression: # -> "?" expression ":" assignment-expression return None def _parse_assignment_expression(self) -> ASTExpression: # -> conditional-expression # | logical-or-expression assignment-operator initializer-clause # -> conditional-expression -> # logical-or-expression # | logical-or-expression "?" expression ":" assignment-expression # | logical-or-expression assignment-operator initializer-clause exprs = [] ops = [] orExpr = self._parse_logical_or_expression() exprs.append(orExpr) # TODO: handle ternary with _parse_conditional_expression_tail while True: oneMore = False self.skip_ws() for op in _expression_assignment_ops: if op[0] in 'abcnox': if not self.skip_word(op): continue else: if not self.skip_string(op): continue expr = self._parse_logical_or_expression() exprs.append(expr) ops.append(op) oneMore = True if not oneMore: break return ASTAssignmentExpr(exprs, ops) def _parse_constant_expression(self) -> ASTExpression: # -> conditional-expression orExpr = self._parse_logical_or_expression() # TODO: use _parse_conditional_expression_tail return orExpr def _parse_expression(self) -> ASTExpression: # -> assignment-expression # | expression "," assignment-expression # TODO: actually parse the second production return self._parse_assignment_expression() def _parse_expression_fallback( self, end: List[str], parser: Callable[[], ASTExpression], allow: bool = True) -> ASTExpression: # Stupidly "parse" an expression. # 'end' should be a list of characters which ends the expression. # first try to use the provided parser prevPos = self.pos try: return parser() except DefinitionError as e: # some places (e.g., template parameters) we really don't want to use fallback, # and for testing we may want to globally disable it if not allow or not self.allowFallbackExpressionParsing: raise self.warn("Parsing of expression failed. Using fallback parser." " Error was:\n%s" % e) self.pos = prevPos # and then the fallback scanning assert end is not None self.skip_ws() startPos = self.pos if self.match(_string_re): value = self.matched_text else: # TODO: add handling of more bracket-like things, and quote handling brackets = {'(': ')', '{': '}', '[': ']'} symbols: List[str] = [] while not self.eof: if (len(symbols) == 0 and self.current_char in end): break if self.current_char in brackets.keys(): symbols.append(brackets[self.current_char]) elif len(symbols) > 0 and self.current_char == symbols[-1]: symbols.pop() self.pos += 1 if len(end) > 0 and self.eof: self.fail("Could not find end of expression starting at %d." % startPos) value = self.definition[startPos:self.pos].strip() return ASTFallbackExpr(value.strip()) def _parse_nested_name(self) -> ASTNestedName: names: List[Any] = [] self.skip_ws() rooted = False if self.skip_string('.'): rooted = True while 1: self.skip_ws() if not self.match(identifier_re): self.fail("Expected identifier in nested name.") identifier = self.matched_text # make sure there isn't a keyword if identifier in _keywords: self.fail("Expected identifier in nested name, " "got keyword: %s" % identifier) if self.matched_text in self.config.c_extra_keywords: msg = "Expected identifier, got user-defined keyword: %s." \ + " Remove it from c_extra_keywords to allow it as identifier.\n" \ + "Currently c_extra_keywords is %s." self.fail(msg % (self.matched_text, str(self.config.c_extra_keywords))) ident = ASTIdentifier(identifier) names.append(ident) self.skip_ws() if not self.skip_string('.'): break return ASTNestedName(names, rooted) def _parse_simple_type_specifier(self) -> Optional[str]: if self.match(_simple_type_specifiers_re): return self.matched_text for t in ('bool', 'complex', 'imaginary'): if t in self.config.c_extra_keywords: if self.skip_word(t): return t return None def _parse_simple_type_specifiers(self) -> ASTTrailingTypeSpecFundamental: names: List[str] = [] self.skip_ws() while True: t = self._parse_simple_type_specifier() if t is None: break names.append(t) self.skip_ws() if len(names) == 0: return None return ASTTrailingTypeSpecFundamental(names) def _parse_trailing_type_spec(self) -> ASTTrailingTypeSpec: # fundamental types, https://en.cppreference.com/w/c/language/type # and extensions self.skip_ws() res = self._parse_simple_type_specifiers() if res is not None: return res # prefixed prefix = None self.skip_ws() for k in ('struct', 'enum', 'union'): if self.skip_word_and_ws(k): prefix = k break nestedName = self._parse_nested_name() return ASTTrailingTypeSpecName(prefix, nestedName) def _parse_parameters(self, paramMode: str) -> ASTParameters: self.skip_ws() if not self.skip_string('('): if paramMode == 'function': self.fail('Expecting "(" in parameters.') else: return None args = [] self.skip_ws() if not self.skip_string(')'): while 1: self.skip_ws() if self.skip_string('...'): args.append(ASTFunctionParameter(None, True)) self.skip_ws() if not self.skip_string(')'): self.fail('Expected ")" after "..." in parameters.') break # note: it seems that function arguments can always be named, # even in function pointers and similar. arg = self._parse_type_with_init(outer=None, named='single') # TODO: parse default parameters # TODO: didn't we just do that? args.append(ASTFunctionParameter(arg)) self.skip_ws() if self.skip_string(','): continue elif self.skip_string(')'): break else: self.fail( 'Expecting "," or ")" in parameters, ' 'got "%s".' % self.current_char) attrs = [] while True: attr = self._parse_attribute() if attr is None: break attrs.append(attr) return ASTParameters(args, attrs) def _parse_decl_specs_simple(self, outer: str, typed: bool) -> ASTDeclSpecsSimple: """Just parse the simple ones.""" storage = None threadLocal = None inline = None restrict = None volatile = None const = None attrs = [] while 1: # accept any permutation of a subset of some decl-specs self.skip_ws() if not storage: if outer == 'member': if self.skip_word('auto'): storage = 'auto' continue if self.skip_word('register'): storage = 'register' continue if outer in ('member', 'function'): if self.skip_word('static'): storage = 'static' continue if self.skip_word('extern'): storage = 'extern' continue if outer == 'member' and not threadLocal: if self.skip_word('thread_local'): threadLocal = 'thread_local' continue if self.skip_word('_Thread_local'): threadLocal = '_Thread_local' continue if outer == 'function' and not inline: inline = self.skip_word('inline') if inline: continue if not restrict and typed: restrict = self.skip_word('restrict') if restrict: continue if not volatile and typed: volatile = self.skip_word('volatile') if volatile: continue if not const and typed: const = self.skip_word('const') if const: continue attr = self._parse_attribute() if attr: attrs.append(attr) continue break return ASTDeclSpecsSimple(storage, threadLocal, inline, restrict, volatile, const, attrs) def _parse_decl_specs(self, outer: str, typed: bool = True) -> ASTDeclSpecs: if outer: if outer not in ('type', 'member', 'function'): raise Exception('Internal error, unknown outer "%s".' % outer) leftSpecs = self._parse_decl_specs_simple(outer, typed) rightSpecs = None if typed: trailing = self._parse_trailing_type_spec() rightSpecs = self._parse_decl_specs_simple(outer, typed) else: trailing = None return ASTDeclSpecs(outer, leftSpecs, rightSpecs, trailing) def _parse_declarator_name_suffix( self, named: Union[bool, str], paramMode: str, typed: bool ) -> ASTDeclarator: assert named in (True, False, 'single') # now we should parse the name, and then suffixes if named == 'single': if self.match(identifier_re): if self.matched_text in _keywords: self.fail("Expected identifier, " "got keyword: %s" % self.matched_text) if self.matched_text in self.config.c_extra_keywords: msg = "Expected identifier, got user-defined keyword: %s." \ + " Remove it from c_extra_keywords to allow it as identifier.\n" \ + "Currently c_extra_keywords is %s." self.fail(msg % (self.matched_text, str(self.config.c_extra_keywords))) identifier = ASTIdentifier(self.matched_text) declId = ASTNestedName([identifier], rooted=False) else: declId = None elif named: declId = self._parse_nested_name() else: declId = None arrayOps = [] while 1: self.skip_ws() if typed and self.skip_string('['): self.skip_ws() static = False const = False volatile = False restrict = False while True: if not static: if self.skip_word_and_ws('static'): static = True continue if not const: if self.skip_word_and_ws('const'): const = True continue if not volatile: if self.skip_word_and_ws('volatile'): volatile = True continue if not restrict: if self.skip_word_and_ws('restrict'): restrict = True continue break vla = False if static else self.skip_string_and_ws('*') if vla: if not self.skip_string(']'): self.fail("Expected ']' in end of array operator.") size = None else: if self.skip_string(']'): size = None else: def parser(): return self._parse_expression() size = self._parse_expression_fallback([']'], parser) self.skip_ws() if not self.skip_string(']'): self.fail("Expected ']' in end of array operator.") arrayOps.append(ASTArray(static, const, volatile, restrict, vla, size)) else: break param = self._parse_parameters(paramMode) if param is None and len(arrayOps) == 0: # perhaps a bit-field if named and paramMode == 'type' and typed: self.skip_ws() if self.skip_string(':'): size = self._parse_constant_expression() return ASTDeclaratorNameBitField(declId=declId, size=size) return ASTDeclaratorNameParam(declId=declId, arrayOps=arrayOps, param=param) def _parse_declarator(self, named: Union[bool, str], paramMode: str, typed: bool = True) -> ASTDeclarator: # 'typed' here means 'parse return type stuff' if paramMode not in ('type', 'function'): raise Exception( "Internal error, unknown paramMode '%s'." % paramMode) prevErrors = [] self.skip_ws() if typed and self.skip_string('*'): self.skip_ws() restrict = False volatile = False const = False attrs = [] while 1: if not restrict: restrict = self.skip_word_and_ws('restrict') if restrict: continue if not volatile: volatile = self.skip_word_and_ws('volatile') if volatile: continue if not const: const = self.skip_word_and_ws('const') if const: continue attr = self._parse_attribute() if attr is not None: attrs.append(attr) continue break next = self._parse_declarator(named, paramMode, typed) return ASTDeclaratorPtr(next=next, restrict=restrict, volatile=volatile, const=const, attrs=attrs) if typed and self.current_char == '(': # note: peeking, not skipping # maybe this is the beginning of params, try that first, # otherwise assume it's noptr->declarator > ( ptr-declarator ) pos = self.pos try: # assume this is params res = self._parse_declarator_name_suffix(named, paramMode, typed) return res except DefinitionError as exParamQual: msg = "If declarator-id with parameters" if paramMode == 'function': msg += " (e.g., 'void f(int arg)')" prevErrors.append((exParamQual, msg)) self.pos = pos try: assert self.current_char == '(' self.skip_string('(') # TODO: hmm, if there is a name, it must be in inner, right? # TODO: hmm, if there must be parameters, they must b # inside, right? inner = self._parse_declarator(named, paramMode, typed) if not self.skip_string(')'): self.fail("Expected ')' in \"( ptr-declarator )\"") next = self._parse_declarator(named=False, paramMode="type", typed=typed) return ASTDeclaratorParen(inner=inner, next=next) except DefinitionError as exNoPtrParen: self.pos = pos msg = "If parenthesis in noptr-declarator" if paramMode == 'function': msg += " (e.g., 'void (*f(int arg))(double)')" prevErrors.append((exNoPtrParen, msg)) header = "Error in declarator" raise self._make_multi_error(prevErrors, header) from exNoPtrParen pos = self.pos try: return self._parse_declarator_name_suffix(named, paramMode, typed) except DefinitionError as e: self.pos = pos prevErrors.append((e, "If declarator-id")) header = "Error in declarator or parameters" raise self._make_multi_error(prevErrors, header) from e def _parse_initializer(self, outer: str = None, allowFallback: bool = True ) -> ASTInitializer: self.skip_ws() if outer == 'member' and False: # TODO bracedInit = self._parse_braced_init_list() if bracedInit is not None: return ASTInitializer(bracedInit, hasAssign=False) if not self.skip_string('='): return None bracedInit = self._parse_braced_init_list() if bracedInit is not None: return ASTInitializer(bracedInit) if outer == 'member': fallbackEnd: List[str] = [] elif outer is None: # function parameter fallbackEnd = [',', ')'] else: self.fail("Internal error, initializer for outer '%s' not " "implemented." % outer) def parser(): return self._parse_assignment_expression() value = self._parse_expression_fallback(fallbackEnd, parser, allow=allowFallback) return ASTInitializer(value) def _parse_type(self, named: Union[bool, str], outer: str = None) -> ASTType: """ named=False|'single'|True: 'single' is e.g., for function objects which doesn't need to name the arguments, but otherwise is a single name """ if outer: # always named if outer not in ('type', 'member', 'function'): raise Exception('Internal error, unknown outer "%s".' % outer) assert named if outer == 'type': # We allow type objects to just be a name. prevErrors = [] startPos = self.pos # first try without the type try: declSpecs = self._parse_decl_specs(outer=outer, typed=False) decl = self._parse_declarator(named=True, paramMode=outer, typed=False) self.assert_end(allowSemicolon=True) except DefinitionError as exUntyped: desc = "If just a name" prevErrors.append((exUntyped, desc)) self.pos = startPos try: declSpecs = self._parse_decl_specs(outer=outer) decl = self._parse_declarator(named=True, paramMode=outer) except DefinitionError as exTyped: self.pos = startPos desc = "If typedef-like declaration" prevErrors.append((exTyped, desc)) # Retain the else branch for easier debugging. # TODO: it would be nice to save the previous stacktrace # and output it here. if True: header = "Type must be either just a name or a " header += "typedef-like declaration." raise self._make_multi_error(prevErrors, header) from exTyped else: # For testing purposes. # do it again to get the proper traceback (how do you # reliably save a traceback when an exception is # constructed?) self.pos = startPos typed = True declSpecs = self._parse_decl_specs(outer=outer, typed=typed) decl = self._parse_declarator(named=True, paramMode=outer, typed=typed) elif outer == 'function': declSpecs = self._parse_decl_specs(outer=outer) decl = self._parse_declarator(named=True, paramMode=outer) else: paramMode = 'type' if outer == 'member': # i.e., member named = True declSpecs = self._parse_decl_specs(outer=outer) decl = self._parse_declarator(named=named, paramMode=paramMode) return ASTType(declSpecs, decl) def _parse_type_with_init(self, named: Union[bool, str], outer: str) -> ASTTypeWithInit: if outer: assert outer in ('type', 'member', 'function') type = self._parse_type(outer=outer, named=named) init = self._parse_initializer(outer=outer) return ASTTypeWithInit(type, init) def _parse_macro(self) -> ASTMacro: self.skip_ws() ident = self._parse_nested_name() if ident is None: self.fail("Expected identifier in macro definition.") self.skip_ws() if not self.skip_string_and_ws('('): return ASTMacro(ident, None) if self.skip_string(')'): return ASTMacro(ident, []) args = [] while 1: self.skip_ws() if self.skip_string('...'): args.append(ASTMacroParameter(None, True)) self.skip_ws() if not self.skip_string(')'): self.fail('Expected ")" after "..." in macro parameters.') break if not self.match(identifier_re): self.fail("Expected identifier in macro parameters.") nn = ASTNestedName([ASTIdentifier(self.matched_text)], rooted=False) # Allow named variadic args: # https://gcc.gnu.org/onlinedocs/cpp/Variadic-Macros.html self.skip_ws() if self.skip_string_and_ws('...'): args.append(ASTMacroParameter(nn, False, True)) self.skip_ws() if not self.skip_string(')'): self.fail('Expected ")" after "..." in macro parameters.') break args.append(ASTMacroParameter(nn)) if self.skip_string_and_ws(','): continue elif self.skip_string_and_ws(')'): break else: self.fail("Expected identifier, ')', or ',' in macro parameter list.") return ASTMacro(ident, args) def _parse_struct(self) -> ASTStruct: name = self._parse_nested_name() return ASTStruct(name) def _parse_union(self) -> ASTUnion: name = self._parse_nested_name() return ASTUnion(name) def _parse_enum(self) -> ASTEnum: name = self._parse_nested_name() return ASTEnum(name) def _parse_enumerator(self) -> ASTEnumerator: name = self._parse_nested_name() self.skip_ws() init = None if self.skip_string('='): self.skip_ws() def parser() -> ASTExpression: return self._parse_constant_expression() initVal = self._parse_expression_fallback([], parser) init = ASTInitializer(initVal) return ASTEnumerator(name, init) def parse_pre_v3_type_definition(self) -> ASTDeclaration: self.skip_ws() declaration: DeclarationType = None if self.skip_word('struct'): typ = 'struct' declaration = self._parse_struct() elif self.skip_word('union'): typ = 'union' declaration = self._parse_union() elif self.skip_word('enum'): typ = 'enum' declaration = self._parse_enum() else: self.fail("Could not parse pre-v3 type directive." " Must start with 'struct', 'union', or 'enum'.") return ASTDeclaration(typ, typ, declaration, False) def parse_declaration(self, objectType: str, directiveType: str) -> ASTDeclaration: if objectType not in ('function', 'member', 'macro', 'struct', 'union', 'enum', 'enumerator', 'type'): raise Exception('Internal error, unknown objectType "%s".' % objectType) if directiveType not in ('function', 'member', 'var', 'macro', 'struct', 'union', 'enum', 'enumerator', 'type'): raise Exception('Internal error, unknown directiveType "%s".' % directiveType) declaration: DeclarationType = None if objectType == 'member': declaration = self._parse_type_with_init(named=True, outer='member') elif objectType == 'function': declaration = self._parse_type(named=True, outer='function') elif objectType == 'macro': declaration = self._parse_macro() elif objectType == 'struct': declaration = self._parse_struct() elif objectType == 'union': declaration = self._parse_union() elif objectType == 'enum': declaration = self._parse_enum() elif objectType == 'enumerator': declaration = self._parse_enumerator() elif objectType == 'type': declaration = self._parse_type(named=True, outer='type') else: assert False if objectType != 'macro': self.skip_ws() semicolon = self.skip_string(';') else: semicolon = False return ASTDeclaration(objectType, directiveType, declaration, semicolon) def parse_namespace_object(self) -> ASTNestedName: return self._parse_nested_name() def parse_xref_object(self) -> ASTNestedName: name = self._parse_nested_name() # if there are '()' left, just skip them self.skip_ws() self.skip_string('()') self.assert_end() return name def parse_expression(self) -> Union[ASTExpression, ASTType]: pos = self.pos res: Union[ASTExpression, ASTType] = None try: res = self._parse_expression() self.skip_ws() self.assert_end() except DefinitionError as exExpr: self.pos = pos try: res = self._parse_type(False) self.skip_ws() self.assert_end() except DefinitionError as exType: header = "Error when parsing (type) expression." errs = [] errs.append((exExpr, "If expression")) errs.append((exType, "If type")) raise self._make_multi_error(errs, header) from exType return res def _make_phony_error_name() -> ASTNestedName: return ASTNestedName([ASTIdentifier("PhonyNameDueToError")], rooted=False) class CObject(ObjectDescription[ASTDeclaration]): """ Description of a C language object. """ option_spec: OptionSpec = { 'noindexentry': directives.flag, } def _add_enumerator_to_parent(self, ast: ASTDeclaration) -> None: assert ast.objectType == 'enumerator' # find the parent, if it exists && is an enum # then add the name to the parent scope symbol = ast.symbol assert symbol assert symbol.ident is not None parentSymbol = symbol.parent assert parentSymbol if parentSymbol.parent is None: # TODO: we could warn, but it is somewhat equivalent to # enumeratorss, without the enum return # no parent parentDecl = parentSymbol.declaration if parentDecl is None: # the parent is not explicitly declared # TODO: we could warn, but? return if parentDecl.objectType != 'enum': # TODO: maybe issue a warning, enumerators in non-enums is weird, # but it is somewhat equivalent to enumeratorss, without the enum return if parentDecl.directiveType != 'enum': return targetSymbol = parentSymbol.parent s = targetSymbol.find_identifier(symbol.ident, matchSelf=False, recurseInAnon=True, searchInSiblings=False) if s is not None: # something is already declared with that name return declClone = symbol.declaration.clone() declClone.enumeratorScopedSymbol = symbol Symbol(parent=targetSymbol, ident=symbol.ident, declaration=declClone, docname=self.env.docname, line=self.get_source_info()[1]) def add_target_and_index(self, ast: ASTDeclaration, sig: str, signode: TextElement) -> None: ids = [] for i in range(1, _max_id + 1): try: id = ast.get_id(version=i) ids.append(id) except NoOldIdError: assert i < _max_id # let's keep the newest first ids = list(reversed(ids)) newestId = ids[0] assert newestId # shouldn't be None name = ast.symbol.get_full_nested_name().get_display_string().lstrip('.') if newestId not in self.state.document.ids: # always add the newest id assert newestId signode['ids'].append(newestId) # only add compatibility ids when there are no conflicts for id in ids[1:]: if not id: # is None when the element didn't exist in that version continue if id not in self.state.document.ids: signode['ids'].append(id) self.state.document.note_explicit_target(signode) if 'noindexentry' not in self.options: indexText = self.get_index_text(name) self.indexnode['entries'].append(('single', indexText, newestId, '', None)) @property def object_type(self) -> str: raise NotImplementedError() @property def display_object_type(self) -> str: return self.object_type def get_index_text(self, name: str) -> str: return _('%s (C %s)') % (name, self.display_object_type) def parse_definition(self, parser: DefinitionParser) -> ASTDeclaration: return parser.parse_declaration(self.object_type, self.objtype) def parse_pre_v3_type_definition(self, parser: DefinitionParser) -> ASTDeclaration: return parser.parse_pre_v3_type_definition() def describe_signature(self, signode: TextElement, ast: ASTDeclaration, options: Dict) -> None: ast.describe_signature(signode, 'lastIsName', self.env, options) def run(self) -> List[Node]: env = self.state.document.settings.env # from ObjectDescription.run if 'c:parent_symbol' not in env.temp_data: root = env.domaindata['c']['root_symbol'] env.temp_data['c:parent_symbol'] = root env.ref_context['c:parent_key'] = root.get_lookup_key() # When multiple declarations are made in the same directive # they need to know about each other to provide symbol lookup for function parameters. # We use last_symbol to store the latest added declaration in a directive. env.temp_data['c:last_symbol'] = None return super().run() def handle_signature(self, sig: str, signode: TextElement) -> ASTDeclaration: parentSymbol: Symbol = self.env.temp_data['c:parent_symbol'] parser = DefinitionParser(sig, location=signode, config=self.env.config) try: try: ast = self.parse_definition(parser) parser.assert_end() except DefinitionError as eOrig: if not self.env.config['c_allow_pre_v3']: raise if self.objtype != 'type': raise try: ast = self.parse_pre_v3_type_definition(parser) parser.assert_end() except DefinitionError: raise eOrig self.object_type = ast.objectType # type: ignore if self.env.config['c_warn_on_allowed_pre_v3']: msg = "{}: Pre-v3 C type directive '.. c:type:: {}' converted to " \ "'.. c:{}:: {}'." \ "\nThe original parsing error was:\n{}" msg = msg.format(RemovedInSphinx50Warning.__name__, sig, ast.objectType, ast, eOrig) logger.warning(msg, location=signode) except DefinitionError as e: logger.warning(e, location=signode) # It is easier to assume some phony name than handling the error in # the possibly inner declarations. name = _make_phony_error_name() symbol = parentSymbol.add_name(name) self.env.temp_data['c:last_symbol'] = symbol raise ValueError from e try: symbol = parentSymbol.add_declaration( ast, docname=self.env.docname, line=self.get_source_info()[1]) # append the new declaration to the sibling list assert symbol.siblingAbove is None assert symbol.siblingBelow is None symbol.siblingAbove = self.env.temp_data['c:last_symbol'] if symbol.siblingAbove is not None: assert symbol.siblingAbove.siblingBelow is None symbol.siblingAbove.siblingBelow = symbol self.env.temp_data['c:last_symbol'] = symbol except _DuplicateSymbolError as e: # Assume we are actually in the old symbol, # instead of the newly created duplicate. self.env.temp_data['c:last_symbol'] = e.symbol msg = __("Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'.") msg = msg % (e.symbol.docname, e.symbol.line, self.display_object_type, sig) logger.warning(msg, location=signode) if ast.objectType == 'enumerator': self._add_enumerator_to_parent(ast) # note: handle_signature may be called multiple time per directive, # if it has multiple signatures, so don't mess with the original options. options = dict(self.options) self.describe_signature(signode, ast, options) return ast def before_content(self) -> None: lastSymbol: Symbol = self.env.temp_data['c:last_symbol'] assert lastSymbol self.oldParentSymbol = self.env.temp_data['c:parent_symbol'] self.oldParentKey: LookupKey = self.env.ref_context['c:parent_key'] self.env.temp_data['c:parent_symbol'] = lastSymbol self.env.ref_context['c:parent_key'] = lastSymbol.get_lookup_key() def after_content(self) -> None: self.env.temp_data['c:parent_symbol'] = self.oldParentSymbol self.env.ref_context['c:parent_key'] = self.oldParentKey def make_old_id(self, name: str) -> str: """Generate old styled node_id for C objects. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. """ return 'c.' + name class CMemberObject(CObject): object_type = 'member' @property def display_object_type(self) -> str: # the distinction between var and member is only cosmetic assert self.objtype in ('member', 'var') return self.objtype _function_doc_field_types = [ TypedField('parameter', label=_('Parameters'), names=('param', 'parameter', 'arg', 'argument'), typerolename='expr', typenames=('type',)), GroupedField('retval', label=_('Return values'), names=('retvals', 'retval'), can_collapse=True), Field('returnvalue', label=_('Returns'), has_arg=False, names=('returns', 'return')), Field('returntype', label=_('Return type'), has_arg=False, names=('rtype',)), ] class CFunctionObject(CObject): object_type = 'function' doc_field_types = _function_doc_field_types.copy() class CMacroObject(CObject): object_type = 'macro' doc_field_types = _function_doc_field_types.copy() class CStructObject(CObject): object_type = 'struct' class CUnionObject(CObject): object_type = 'union' class CEnumObject(CObject): object_type = 'enum' class CEnumeratorObject(CObject): object_type = 'enumerator' class CTypeObject(CObject): object_type = 'type' class CNamespaceObject(SphinxDirective): """ This directive is just to tell Sphinx that we're documenting stuff in namespace foo. """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: rootSymbol = self.env.domaindata['c']['root_symbol'] if self.arguments[0].strip() in ('NULL', '0', 'nullptr'): symbol = rootSymbol stack: List[Symbol] = [] else: parser = DefinitionParser(self.arguments[0], location=self.get_location(), config=self.env.config) try: name = parser.parse_namespace_object() parser.assert_end() except DefinitionError as e: logger.warning(e, location=self.get_location()) name = _make_phony_error_name() symbol = rootSymbol.add_name(name) stack = [symbol] self.env.temp_data['c:parent_symbol'] = symbol self.env.temp_data['c:namespace_stack'] = stack self.env.ref_context['c:parent_key'] = symbol.get_lookup_key() return [] class CNamespacePushObject(SphinxDirective): has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: if self.arguments[0].strip() in ('NULL', '0', 'nullptr'): return [] parser = DefinitionParser(self.arguments[0], location=self.get_location(), config=self.env.config) try: name = parser.parse_namespace_object() parser.assert_end() except DefinitionError as e: logger.warning(e, location=self.get_location()) name = _make_phony_error_name() oldParent = self.env.temp_data.get('c:parent_symbol', None) if not oldParent: oldParent = self.env.domaindata['c']['root_symbol'] symbol = oldParent.add_name(name) stack = self.env.temp_data.get('c:namespace_stack', []) stack.append(symbol) self.env.temp_data['c:parent_symbol'] = symbol self.env.temp_data['c:namespace_stack'] = stack self.env.ref_context['c:parent_key'] = symbol.get_lookup_key() return [] class CNamespacePopObject(SphinxDirective): has_content = False required_arguments = 0 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: stack = self.env.temp_data.get('c:namespace_stack', None) if not stack or len(stack) == 0: logger.warning("C namespace pop on empty stack. Defaulting to global scope.", location=self.get_location()) stack = [] else: stack.pop() if len(stack) > 0: symbol = stack[-1] else: symbol = self.env.domaindata['c']['root_symbol'] self.env.temp_data['c:parent_symbol'] = symbol self.env.temp_data['c:namespace_stack'] = stack self.env.ref_context['cp:parent_key'] = symbol.get_lookup_key() return [] class AliasNode(nodes.Element): def __init__(self, sig: str, aliasOptions: dict, document: Any, env: "BuildEnvironment" = None, parentKey: LookupKey = None) -> None: super().__init__() self.sig = sig self.aliasOptions = aliasOptions self.document = document if env is not None: if 'c:parent_symbol' not in env.temp_data: root = env.domaindata['c']['root_symbol'] env.temp_data['c:parent_symbol'] = root env.ref_context['c:parent_key'] = root.get_lookup_key() self.parentKey = env.ref_context['c:parent_key'] else: assert parentKey is not None self.parentKey = parentKey def copy(self) -> 'AliasNode': return self.__class__(self.sig, self.aliasOptions, self.document, env=None, parentKey=self.parentKey) class AliasTransform(SphinxTransform): default_priority = ReferencesResolver.default_priority - 1 def _render_symbol(self, s: Symbol, maxdepth: int, skipThis: bool, aliasOptions: dict, renderOptions: dict, document: Any) -> List[Node]: if maxdepth == 0: recurse = True elif maxdepth == 1: recurse = False else: maxdepth -= 1 recurse = True nodes: List[Node] = [] if not skipThis: signode = addnodes.desc_signature('', '') nodes.append(signode) s.declaration.describe_signature(signode, 'markName', self.env, renderOptions) if recurse: if skipThis: childContainer: Union[List[Node], addnodes.desc] = nodes else: content = addnodes.desc_content() desc = addnodes.desc() content.append(desc) desc.document = document desc['domain'] = 'c' # 'desctype' is a backwards compatible attribute desc['objtype'] = desc['desctype'] = 'alias' desc['noindex'] = True childContainer = desc for sChild in s.children: if sChild.declaration is None: continue childNodes = self._render_symbol( sChild, maxdepth=maxdepth, skipThis=False, aliasOptions=aliasOptions, renderOptions=renderOptions, document=document) childContainer.extend(childNodes) if not skipThis and len(desc.children) != 0: nodes.append(content) return nodes def apply(self, **kwargs: Any) -> None: for node in self.document.traverse(AliasNode): node = cast(AliasNode, node) sig = node.sig parentKey = node.parentKey try: parser = DefinitionParser(sig, location=node, config=self.env.config) name = parser.parse_xref_object() except DefinitionError as e: logger.warning(e, location=node) name = None if name is None: # could not be parsed, so stop here signode = addnodes.desc_signature(sig, '') signode.clear() signode += addnodes.desc_name(sig, sig) node.replace_self(signode) continue rootSymbol: Symbol = self.env.domains['c'].data['root_symbol'] parentSymbol: Symbol = rootSymbol.direct_lookup(parentKey) if not parentSymbol: print("Target: ", sig) print("ParentKey: ", parentKey) print(rootSymbol.dump(1)) assert parentSymbol # should be there s = parentSymbol.find_declaration( name, 'any', matchSelf=True, recurseInAnon=True) if s is None: signode = addnodes.desc_signature(sig, '') node.append(signode) signode.clear() signode += addnodes.desc_name(sig, sig) logger.warning("Could not find C declaration for alias '%s'." % name, location=node) node.replace_self(signode) continue # Declarations like .. var:: int Missing::var # may introduce symbols without declarations. # But if we skip the root then it is ok to start recursion from it. if not node.aliasOptions['noroot'] and s.declaration is None: signode = addnodes.desc_signature(sig, '') node.append(signode) signode.clear() signode += addnodes.desc_name(sig, sig) logger.warning( "Can not render C declaration for alias '%s'. No such declaration." % name, location=node) node.replace_self(signode) continue nodes = self._render_symbol(s, maxdepth=node.aliasOptions['maxdepth'], skipThis=node.aliasOptions['noroot'], aliasOptions=node.aliasOptions, renderOptions=dict(), document=node.document) node.replace_self(nodes) class CAliasObject(ObjectDescription): option_spec: OptionSpec = { 'maxdepth': directives.nonnegative_int, 'noroot': directives.flag, } def run(self) -> List[Node]: """ On purpose this doesn't call the ObjectDescription version, but is based on it. Each alias signature may expand into multiple real signatures if 'noroot'. The code is therefore based on the ObjectDescription version. """ if ':' in self.name: self.domain, self.objtype = self.name.split(':', 1) else: self.domain, self.objtype = '', self.name node = addnodes.desc() node.document = self.state.document node['domain'] = self.domain # 'desctype' is a backwards compatible attribute node['objtype'] = node['desctype'] = self.objtype node['noindex'] = True self.names: List[str] = [] aliasOptions = { 'maxdepth': self.options.get('maxdepth', 1), 'noroot': 'noroot' in self.options, } if aliasOptions['noroot'] and aliasOptions['maxdepth'] == 1: logger.warning("Error in C alias declaration." " Requested 'noroot' but 'maxdepth' 1." " When skipping the root declaration," " need 'maxdepth' 0 for infinite or at least 2.", location=self.get_location()) signatures = self.get_signatures() for i, sig in enumerate(signatures): node.append(AliasNode(sig, aliasOptions, self.state.document, env=self.env)) return [node] class CXRefRole(XRefRole): def process_link(self, env: BuildEnvironment, refnode: Element, has_explicit_title: bool, title: str, target: str) -> Tuple[str, str]: refnode.attributes.update(env.ref_context) if not has_explicit_title: # major hax: replace anon names via simple string manipulation. # Can this actually fail? title = anon_identifier_re.sub("[anonymous]", str(title)) if not has_explicit_title: target = target.lstrip('~') # only has a meaning for the title # if the first character is a tilde, don't display the module/class # parts of the contents if title[0:1] == '~': title = title[1:] dot = title.rfind('.') if dot != -1: title = title[dot + 1:] return title, target def run(self) -> Tuple[List[Node], List[system_message]]: if not self.env.config['c_allow_pre_v3']: return super().run() text = self.text.replace('\n', ' ') parser = DefinitionParser(text, location=self.get_location(), config=self.env.config) try: parser.parse_xref_object() # it succeeded, so let it through return super().run() except DefinitionError as eOrig: # try as if it was an c:expr parser.pos = 0 try: ast = parser.parse_expression() except DefinitionError: # that didn't go well, just default back return super().run() classes = ['xref', 'c', 'c-texpr'] parentSymbol = self.env.temp_data.get('cpp:parent_symbol', None) if parentSymbol is None: parentSymbol = self.env.domaindata['c']['root_symbol'] signode = nodes.inline(classes=classes) ast.describe_signature(signode, 'markType', self.env, parentSymbol) if self.env.config['c_warn_on_allowed_pre_v3']: msg = "{}: Pre-v3 C type role ':c:type:`{}`' converted to ':c:expr:`{}`'." msg += "\nThe original parsing error was:\n{}" msg = msg.format(RemovedInSphinx50Warning.__name__, text, text, eOrig) logger.warning(msg, location=self.get_location()) return [signode], [] class CExprRole(SphinxRole): def __init__(self, asCode: bool) -> None: super().__init__() if asCode: # render the expression as inline code self.class_type = 'c-expr' else: # render the expression as inline text self.class_type = 'c-texpr' def run(self) -> Tuple[List[Node], List[system_message]]: text = self.text.replace('\n', ' ') parser = DefinitionParser(text, location=self.get_location(), config=self.env.config) # attempt to mimic XRefRole classes, except that... try: ast = parser.parse_expression() except DefinitionError as ex: logger.warning('Unparseable C expression: %r\n%s', text, ex, location=self.get_location()) # see below return [addnodes.desc_inline('c', text, text, classes=[self.class_type])], [] parentSymbol = self.env.temp_data.get('c:parent_symbol', None) if parentSymbol is None: parentSymbol = self.env.domaindata['c']['root_symbol'] # ...most if not all of these classes should really apply to the individual references, # not the container node signode = addnodes.desc_inline('c', classes=[self.class_type]) ast.describe_signature(signode, 'markType', self.env, parentSymbol) return [signode], [] class CDomain(Domain): """C language domain.""" name = 'c' label = 'C' object_types = { # 'identifier' is the one used for xrefs generated in signatures, not in roles 'member': ObjType(_('member'), 'var', 'member', 'data', 'identifier'), 'var': ObjType(_('variable'), 'var', 'member', 'data', 'identifier'), 'function': ObjType(_('function'), 'func', 'identifier', 'type'), 'macro': ObjType(_('macro'), 'macro', 'identifier'), 'struct': ObjType(_('struct'), 'struct', 'identifier', 'type'), 'union': ObjType(_('union'), 'union', 'identifier', 'type'), 'enum': ObjType(_('enum'), 'enum', 'identifier', 'type'), 'enumerator': ObjType(_('enumerator'), 'enumerator', 'identifier'), 'type': ObjType(_('type'), 'identifier', 'type'), # generated object types 'functionParam': ObjType(_('function parameter'), 'identifier', 'var', 'member', 'data'), # noqa } directives = { 'member': CMemberObject, 'var': CMemberObject, 'function': CFunctionObject, 'macro': CMacroObject, 'struct': CStructObject, 'union': CUnionObject, 'enum': CEnumObject, 'enumerator': CEnumeratorObject, 'type': CTypeObject, # scope control 'namespace': CNamespaceObject, 'namespace-push': CNamespacePushObject, 'namespace-pop': CNamespacePopObject, # other 'alias': CAliasObject } roles = { 'member': CXRefRole(), 'data': CXRefRole(), 'var': CXRefRole(), 'func': CXRefRole(fix_parens=True), 'macro': CXRefRole(), 'struct': CXRefRole(), 'union': CXRefRole(), 'enum': CXRefRole(), 'enumerator': CXRefRole(), 'type': CXRefRole(), 'expr': CExprRole(asCode=True), 'texpr': CExprRole(asCode=False) } initial_data: Dict[str, Union[Symbol, Dict[str, Tuple[str, str, str]]]] = { 'root_symbol': Symbol(None, None, None, None, None), 'objects': {}, # fullname -> docname, node_id, objtype } def clear_doc(self, docname: str) -> None: if Symbol.debug_show_tree: print("clear_doc:", docname) print("\tbefore:") print(self.data['root_symbol'].dump(1)) print("\tbefore end") rootSymbol = self.data['root_symbol'] rootSymbol.clear_doc(docname) if Symbol.debug_show_tree: print("\tafter:") print(self.data['root_symbol'].dump(1)) print("\tafter end") print("clear_doc end:", docname) def process_doc(self, env: BuildEnvironment, docname: str, document: nodes.document) -> None: if Symbol.debug_show_tree: print("process_doc:", docname) print(self.data['root_symbol'].dump(0)) print("process_doc end:", docname) def process_field_xref(self, pnode: pending_xref) -> None: pnode.attributes.update(self.env.ref_context) def merge_domaindata(self, docnames: List[str], otherdata: Dict) -> None: if Symbol.debug_show_tree: print("merge_domaindata:") print("\tself:") print(self.data['root_symbol'].dump(1)) print("\tself end") print("\tother:") print(otherdata['root_symbol'].dump(1)) print("\tother end") print("merge_domaindata end") self.data['root_symbol'].merge_with(otherdata['root_symbol'], docnames, self.env) ourObjects = self.data['objects'] for fullname, (fn, id_, objtype) in otherdata['objects'].items(): if fn in docnames: if fullname not in ourObjects: ourObjects[fullname] = (fn, id_, objtype) # no need to warn on duplicates, the symbol merge already does that def _resolve_xref_inner(self, env: BuildEnvironment, fromdocname: str, builder: Builder, typ: str, target: str, node: pending_xref, contnode: Element) -> Tuple[Optional[Element], Optional[str]]: parser = DefinitionParser(target, location=node, config=env.config) try: name = parser.parse_xref_object() except DefinitionError as e: logger.warning('Unparseable C cross-reference: %r\n%s', target, e, location=node) return None, None parentKey: LookupKey = node.get("c:parent_key", None) rootSymbol = self.data['root_symbol'] if parentKey: parentSymbol: Symbol = rootSymbol.direct_lookup(parentKey) if not parentSymbol: print("Target: ", target) print("ParentKey: ", parentKey) print(rootSymbol.dump(1)) assert parentSymbol # should be there else: parentSymbol = rootSymbol s = parentSymbol.find_declaration(name, typ, matchSelf=True, recurseInAnon=True) if s is None or s.declaration is None: return None, None # TODO: check role type vs. object type declaration = s.declaration displayName = name.get_display_string() docname = s.docname assert docname return make_refnode(builder, fromdocname, docname, declaration.get_newest_id(), contnode, displayName ), declaration.objectType def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder, typ: str, target: str, node: pending_xref, contnode: Element) -> Optional[Element]: return self._resolve_xref_inner(env, fromdocname, builder, typ, target, node, contnode)[0] def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder, target: str, node: pending_xref, contnode: Element ) -> List[Tuple[str, Element]]: with logging.suppress_logging(): retnode, objtype = self._resolve_xref_inner(env, fromdocname, builder, 'any', target, node, contnode) if retnode: return [('c:' + self.role_for_objtype(objtype), retnode)] return [] def get_objects(self) -> Iterator[Tuple[str, str, str, str, str, int]]: rootSymbol = self.data['root_symbol'] for symbol in rootSymbol.get_all_symbols(): if symbol.declaration is None: continue assert symbol.docname fullNestedName = symbol.get_full_nested_name() name = str(fullNestedName).lstrip('.') dispname = fullNestedName.get_display_string().lstrip('.') objectType = symbol.declaration.objectType docname = symbol.docname newestId = symbol.declaration.get_newest_id() yield (name, dispname, objectType, docname, newestId, 1) def setup(app: Sphinx) -> Dict[str, Any]: app.add_domain(CDomain) app.add_config_value("c_id_attributes", [], 'env') app.add_config_value("c_paren_attributes", [], 'env') app.add_config_value("c_extra_keywords", _macroKeywords, 'env') app.add_post_transform(AliasTransform) app.add_config_value("c_allow_pre_v3", False, 'env') app.add_config_value("c_warn_on_allowed_pre_v3", True, 'env') return { 'version': 'builtin', 'env_version': 2, 'parallel_read_safe': True, 'parallel_write_safe': True, } �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/domains/changeset.py������������������������������������������������������������0000644�0000766�0000024�00000013051�00000000000�017611� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.domains.changeset ~~~~~~~~~~~~~~~~~~~~~~~~ The changeset domain. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import TYPE_CHECKING, Any, Dict, List, NamedTuple, cast from docutils import nodes from docutils.nodes import Node from sphinx import addnodes from sphinx.domains import Domain from sphinx.locale import _ from sphinx.util.docutils import SphinxDirective from sphinx.util.typing import OptionSpec if TYPE_CHECKING: from sphinx.application import Sphinx from sphinx.environment import BuildEnvironment versionlabels = { 'versionadded': _('New in version %s'), 'versionchanged': _('Changed in version %s'), 'deprecated': _('Deprecated since version %s'), } versionlabel_classes = { 'versionadded': 'added', 'versionchanged': 'changed', 'deprecated': 'deprecated', } class ChangeSet(NamedTuple): type: str docname: str lineno: int module: str descname: str content: str class VersionChange(SphinxDirective): """ Directive to describe a change/addition/deprecation in a specific version. """ has_content = True required_arguments = 1 optional_arguments = 1 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: node = addnodes.versionmodified() node.document = self.state.document self.set_source_info(node) node['type'] = self.name node['version'] = self.arguments[0] text = versionlabels[self.name] % self.arguments[0] if len(self.arguments) == 2: inodes, messages = self.state.inline_text(self.arguments[1], self.lineno + 1) para = nodes.paragraph(self.arguments[1], '', *inodes, translatable=False) self.set_source_info(para) node.append(para) else: messages = [] if self.content: self.state.nested_parse(self.content, self.content_offset, node) classes = ['versionmodified', versionlabel_classes[self.name]] if len(node) > 0 and isinstance(node[0], nodes.paragraph): # the contents start with a paragraph if node[0].rawsource: # make the first paragraph translatable content = nodes.inline(node[0].rawsource, translatable=True) content.source = node[0].source content.line = node[0].line content += node[0].children node[0].replace_self(nodes.paragraph('', '', content, translatable=False)) para = cast(nodes.paragraph, node[0]) para.insert(0, nodes.inline('', '%s: ' % text, classes=classes)) elif len(node) > 0: # the contents do not starts with a paragraph para = nodes.paragraph('', '', nodes.inline('', '%s: ' % text, classes=classes), translatable=False) node.insert(0, para) else: # the contents are empty para = nodes.paragraph('', '', nodes.inline('', '%s.' % text, classes=classes), translatable=False) node.append(para) domain = cast(ChangeSetDomain, self.env.get_domain('changeset')) domain.note_changeset(node) ret: List[Node] = [node] ret += messages return ret class ChangeSetDomain(Domain): """Domain for changesets.""" name = 'changeset' label = 'changeset' initial_data: Dict = { 'changes': {}, # version -> list of ChangeSet } @property def changesets(self) -> Dict[str, List[ChangeSet]]: return self.data.setdefault('changes', {}) # version -> list of ChangeSet def note_changeset(self, node: addnodes.versionmodified) -> None: version = node['version'] module = self.env.ref_context.get('py:module') objname = self.env.temp_data.get('object') changeset = ChangeSet(node['type'], self.env.docname, node.line, module, objname, node.astext()) self.changesets.setdefault(version, []).append(changeset) def clear_doc(self, docname: str) -> None: for version, changes in self.changesets.items(): for changeset in changes[:]: if changeset.docname == docname: changes.remove(changeset) def merge_domaindata(self, docnames: List[str], otherdata: Dict) -> None: # XXX duplicates? for version, otherchanges in otherdata['changes'].items(): changes = self.changesets.setdefault(version, []) for changeset in otherchanges: if changeset.docname in docnames: changes.append(changeset) def process_doc(self, env: "BuildEnvironment", docname: str, document: nodes.document) -> None: # NOQA pass # nothing to do here. All changesets are registered on calling directive. def get_changesets_for(self, version: str) -> List[ChangeSet]: return self.changesets.get(version, []) def setup(app: "Sphinx") -> Dict[str, Any]: app.add_domain(ChangeSetDomain) app.add_directive('deprecated', VersionChange) app.add_directive('versionadded', VersionChange) app.add_directive('versionchanged', VersionChange) return { 'version': 'builtin', 'env_version': 1, 'parallel_read_safe': True, 'parallel_write_safe': True, } ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/domains/citation.py�������������������������������������������������������������0000644�0000766�0000024�00000013334�00000000000�017466� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.domains.citation ~~~~~~~~~~~~~~~~~~~~~~~ The citation domain. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import TYPE_CHECKING, Any, Dict, List, Optional, Set, Tuple, cast from docutils import nodes from docutils.nodes import Element from sphinx.addnodes import pending_xref from sphinx.domains import Domain from sphinx.locale import __ from sphinx.transforms import SphinxTransform from sphinx.util import logging from sphinx.util.nodes import copy_source_info, make_refnode if TYPE_CHECKING: from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.environment import BuildEnvironment logger = logging.getLogger(__name__) class CitationDomain(Domain): """Domain for citations.""" name = 'citation' label = 'citation' dangling_warnings = { 'ref': 'citation not found: %(target)s', } @property def citations(self) -> Dict[str, Tuple[str, str, int]]: return self.data.setdefault('citations', {}) @property def citation_refs(self) -> Dict[str, Set[str]]: return self.data.setdefault('citation_refs', {}) def clear_doc(self, docname: str) -> None: for key, (fn, _l, lineno) in list(self.citations.items()): if fn == docname: del self.citations[key] for key, docnames in list(self.citation_refs.items()): if docnames == {docname}: del self.citation_refs[key] elif docname in docnames: docnames.remove(docname) def merge_domaindata(self, docnames: List[str], otherdata: Dict) -> None: # XXX duplicates? for key, data in otherdata['citations'].items(): if data[0] in docnames: self.citations[key] = data for key, data in otherdata['citation_refs'].items(): citation_refs = self.citation_refs.setdefault(key, set()) for docname in data: if docname in docnames: citation_refs.add(docname) def note_citation(self, node: nodes.citation) -> None: label = node[0].astext() if label in self.citations: path = self.env.doc2path(self.citations[label][0]) logger.warning(__('duplicate citation %s, other instance in %s'), label, path, location=node, type='ref', subtype='citation') self.citations[label] = (node['docname'], node['ids'][0], node.line) def note_citation_reference(self, node: pending_xref) -> None: docnames = self.citation_refs.setdefault(node['reftarget'], set()) docnames.add(self.env.docname) def check_consistency(self) -> None: for name, (docname, labelid, lineno) in self.citations.items(): if name not in self.citation_refs: logger.warning(__('Citation [%s] is not referenced.'), name, type='ref', subtype='citation', location=(docname, lineno)) def resolve_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder", typ: str, target: str, node: pending_xref, contnode: Element ) -> Optional[Element]: docname, labelid, lineno = self.citations.get(target, ('', '', 0)) if not docname: return None return make_refnode(builder, fromdocname, docname, labelid, contnode) def resolve_any_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder", target: str, node: pending_xref, contnode: Element ) -> List[Tuple[str, Element]]: refnode = self.resolve_xref(env, fromdocname, builder, 'ref', target, node, contnode) if refnode is None: return [] else: return [('ref', refnode)] class CitationDefinitionTransform(SphinxTransform): """Mark citation definition labels as not smartquoted.""" default_priority = 619 def apply(self, **kwargs: Any) -> None: domain = cast(CitationDomain, self.env.get_domain('citation')) for node in self.document.traverse(nodes.citation): # register citation node to domain node['docname'] = self.env.docname domain.note_citation(node) # mark citation labels as not smartquoted label = cast(nodes.label, node[0]) label['support_smartquotes'] = False class CitationReferenceTransform(SphinxTransform): """ Replace citation references by pending_xref nodes before the default docutils transform tries to resolve them. """ default_priority = 619 def apply(self, **kwargs: Any) -> None: domain = cast(CitationDomain, self.env.get_domain('citation')) for node in self.document.traverse(nodes.citation_reference): target = node.astext() ref = pending_xref(target, refdomain='citation', reftype='ref', reftarget=target, refwarn=True, support_smartquotes=False, ids=node["ids"], classes=node.get('classes', [])) ref += nodes.inline(target, '[%s]' % target) copy_source_info(node, ref) node.replace_self(ref) # register reference node to domain domain.note_citation_reference(ref) def setup(app: "Sphinx") -> Dict[str, Any]: app.add_domain(CitationDomain) app.add_transform(CitationDefinitionTransform) app.add_transform(CitationReferenceTransform) return { 'version': 'builtin', 'env_version': 1, 'parallel_read_safe': True, 'parallel_write_safe': True, } ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902837.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/domains/cpp.py������������������������������������������������������������������0000644�0000766�0000024�00001170161�00000000000�016441� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.domains.cpp ~~~~~~~~~~~~~~~~~~ The C++ language domain. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import re from typing import (Any, Callable, Dict, Generator, Iterator, List, Optional, Tuple, TypeVar, Union, cast) from docutils import nodes from docutils.nodes import Element, Node, TextElement, system_message from docutils.parsers.rst import directives from sphinx import addnodes from sphinx.addnodes import desc_signature, pending_xref from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.directives import ObjectDescription from sphinx.domains import Domain, ObjType from sphinx.environment import BuildEnvironment from sphinx.errors import NoUri from sphinx.locale import _, __ from sphinx.roles import SphinxRole, XRefRole from sphinx.transforms import SphinxTransform from sphinx.transforms.post_transforms import ReferencesResolver from sphinx.util import logging from sphinx.util.cfamily import (ASTAttribute, ASTBaseBase, ASTBaseParenExprList, BaseParser, DefinitionError, NoOldIdError, StringifyTransform, UnsupportedMultiCharacterCharLiteral, anon_identifier_re, binary_literal_re, char_literal_re, float_literal_re, float_literal_suffix_re, hex_literal_re, identifier_re, integer_literal_re, integers_literal_suffix_re, octal_literal_re, verify_description_mode) from sphinx.util.docfields import Field, GroupedField from sphinx.util.docutils import SphinxDirective from sphinx.util.nodes import make_refnode from sphinx.util.typing import OptionSpec logger = logging.getLogger(__name__) T = TypeVar('T') """ Important note on ids ---------------------------------------------------------------------------- Multiple id generation schemes are used due to backwards compatibility. - v1: 1.2.3 <= version < 1.3 The style used before the rewrite. It is not the actual old code, but a replication of the behaviour. - v2: 1.3 <= version < now Standardised mangling scheme from https://itanium-cxx-abi.github.io/cxx-abi/abi.html#mangling though not completely implemented. All versions are generated and attached to elements. The newest is used for the index. All of the versions should work as permalinks. Signature Nodes and Tagnames ---------------------------------------------------------------------------- Each signature is in a desc_signature node, where all children are desc_signature_line nodes. Each of these lines will have the attribute 'sphinx_line_type' set to one of the following (prioritized): - 'declarator', if the line contains the name of the declared object. - 'templateParams', if the line starts a template parameter list, - 'templateParams', if the line has template parameters Note: such lines might get a new tag in the future. - 'templateIntroduction, if the line is on the form 'conceptName{...}' No other desc_signature nodes should exist (so far). Grammar ---------------------------------------------------------------------------- See https://www.nongnu.org/hcb/ for the grammar, and https://github.com/cplusplus/draft/blob/master/source/grammar.tex, and https://github.com/cplusplus/concepts-ts for the newest grammar. common grammar things: template-declaration -> "template" "<" template-parameter-list ">" declaration template-parameter-list -> template-parameter | template-parameter-list "," template-parameter template-parameter -> type-parameter | parameter-declaration # i.e., same as a function argument type-parameter -> "class" "..."[opt] identifier[opt] | "class" identifier[opt] "=" type-id | "typename" "..."[opt] identifier[opt] | "typename" identifier[opt] "=" type-id | "template" "<" template-parameter-list ">" "class" "..."[opt] identifier[opt] | "template" "<" template-parameter-list ">" "class" identifier[opt] "=" id-expression # also, from C++17 we can have "typename" in template templates templateDeclPrefix -> "template" "<" template-parameter-list ">" simple-declaration -> attribute-specifier-seq[opt] decl-specifier-seq[opt] init-declarator-list[opt] ; # Make the semicolon optional. # For now: drop the attributes (TODO). # Use at most 1 init-declarator. -> decl-specifier-seq init-declarator -> decl-specifier-seq declarator initializer decl-specifier -> storage-class-specifier -> ( "static" (only for member_object and function_object) | "extern" (only for member_object and function_object) | "register" ) thread_local[opt] (only for member_object) (it can also appear before the others) | type-specifier -> trailing-type-specifier | function-specifier -> "inline" | "virtual" | "explicit" (only for function_object) | "friend" (only for function_object) | "constexpr" (only for member_object and function_object) trailing-type-specifier -> simple-type-specifier | elaborated-type-specifier | typename-specifier | cv-qualifier -> "const" | "volatile" stricter grammar for decl-specifier-seq (with everything, each object uses a subset): visibility storage-class-specifier function-specifier "friend" "constexpr" "volatile" "const" trailing-type-specifier # where trailing-type-specifier can no be cv-qualifier # Inside e.g., template parameters a strict subset is used # (see type-specifier-seq) trailing-type-specifier -> simple-type-specifier -> ::[opt] nested-name-specifier[opt] type-name | ::[opt] nested-name-specifier "template" simple-template-id | "char" | "bool" | etc. | decltype-specifier | elaborated-type-specifier -> class-key attribute-specifier-seq[opt] ::[opt] nested-name-specifier[opt] identifier | class-key ::[opt] nested-name-specifier[opt] template[opt] simple-template-id | "enum" ::[opt] nested-name-specifier[opt] identifier | typename-specifier -> "typename" ::[opt] nested-name-specifier identifier | "typename" ::[opt] nested-name-specifier template[opt] simple-template-id class-key -> "class" | "struct" | "union" type-name ->* identifier | simple-template-id # ignoring attributes and decltype, and then some left-factoring trailing-type-specifier -> rest-of-trailing ("class" | "struct" | "union" | "typename") rest-of-trailing built-in -> "char" | "bool" | etc. decltype-specifier rest-of-trailing -> (with some simplification) "::"[opt] list-of-elements-separated-by-:: element -> "template"[opt] identifier ("<" template-argument-list ">")[opt] template-argument-list -> template-argument "..."[opt] | template-argument-list "," template-argument "..."[opt] template-argument -> constant-expression | type-specifier-seq abstract-declarator | id-expression declarator -> ptr-declarator | noptr-declarator parameters-and-qualifiers trailing-return-type ptr-declarator -> noptr-declarator | ptr-operator ptr-declarator noptr-declarator -> declarator-id attribute-specifier-seq[opt] -> "..."[opt] id-expression | rest-of-trailing | noptr-declarator parameters-and-qualifiers | noptr-declarator "[" constant-expression[opt] "]" attribute-specifier-seq[opt] | "(" ptr-declarator ")" ptr-operator -> "*" attribute-specifier-seq[opt] cv-qualifier-seq[opt] | "& attribute-specifier-seq[opt] | "&&" attribute-specifier-seq[opt] | "::"[opt] nested-name-specifier "*" attribute-specifier-seq[opt] cv-qualifier-seq[opt] # function_object must use a parameters-and-qualifiers, the others may # use it (e.g., function pointers) parameters-and-qualifiers -> "(" parameter-clause ")" attribute-specifier-seq[opt] cv-qualifier-seq[opt] ref-qualifier[opt] exception-specification[opt] ref-qualifier -> "&" | "&&" exception-specification -> "noexcept" ("(" constant-expression ")")[opt] "throw" ("(" type-id-list ")")[opt] # TODO: we don't implement attributes # member functions can have initializers, but we fold them into here memberFunctionInit -> "=" "0" # (note: only "0" is allowed as the value, according to the standard, # right?) enum-head -> enum-key attribute-specifier-seq[opt] nested-name-specifier[opt] identifier enum-base[opt] enum-key -> "enum" | "enum struct" | "enum class" enum-base -> ":" type enumerator-definition -> identifier | identifier "=" constant-expression We additionally add the possibility for specifying the visibility as the first thing. concept_object: goal: just a declaration of the name (for now) grammar: only a single template parameter list, and the nested name may not have any template argument lists "template" "<" template-parameter-list ">" nested-name-specifier type_object: goal: either a single type (e.g., "MyClass:Something_T" or a typedef-like thing (e.g. "Something Something_T" or "int I_arr[]" grammar, single type: based on a type in a function parameter, but without a name: parameter-declaration -> attribute-specifier-seq[opt] decl-specifier-seq abstract-declarator[opt] # Drop the attributes -> decl-specifier-seq abstract-declarator[opt] grammar, typedef-like: no initilizer decl-specifier-seq declarator Can start with a templateDeclPrefix. member_object: goal: as a type_object which must have a declarator, and optionally with a initializer grammar: decl-specifier-seq declarator initializer Can start with a templateDeclPrefix. function_object: goal: a function declaration, TODO: what about templates? for now: skip grammar: no initializer decl-specifier-seq declarator Can start with a templateDeclPrefix. class_object: goal: a class declaration, but with specification of a base class grammar: nested-name "final"[opt] (":" base-specifier-list)[opt] base-specifier-list -> base-specifier "..."[opt] | base-specifier-list, base-specifier "..."[opt] base-specifier -> base-type-specifier | "virtual" access-spe"cifier[opt] base-type-specifier | access-specifier[opt] "virtual"[opt] base-type-specifier Can start with a templateDeclPrefix. enum_object: goal: an unscoped enum or a scoped enum, optionally with the underlying type specified grammar: ("class" | "struct")[opt] visibility[opt] nested-name (":" type)[opt] enumerator_object: goal: an element in a scoped or unscoped enum. The name should be injected according to the scopedness. grammar: nested-name ("=" constant-expression) namespace_object: goal: a directive to put all following declarations in a specific scope grammar: nested-name """ udl_identifier_re = re.compile(r'''(?x) [a-zA-Z_][a-zA-Z0-9_]*\b # note, no word boundary in the beginning ''') _string_re = re.compile(r"[LuU8]?('([^'\\]*(?:\\.[^'\\]*)*)'" r'|"([^"\\]*(?:\\.[^"\\]*)*)")', re.S) _visibility_re = re.compile(r'\b(public|private|protected)\b') _operator_re = re.compile(r'''(?x) \[\s*\] | \(\s*\) | \+\+ | -- | ->\*? | \, | (<<|>>)=? | && | \|\| | <=> | [!<>=/*%+|&^~-]=? | (\b(and|and_eq|bitand|bitor|compl|not|not_eq|or|or_eq|xor|xor_eq)\b) ''') _fold_operator_re = re.compile(r'''(?x) ->\* | \.\* | \, | (<<|>>)=? | && | \|\| | != | [<>=/*%+|&^~-]=? ''') # see https://en.cppreference.com/w/cpp/keyword _keywords = [ 'alignas', 'alignof', 'and', 'and_eq', 'asm', 'auto', 'bitand', 'bitor', 'bool', 'break', 'case', 'catch', 'char', 'char8_t', 'char16_t', 'char32_t', 'class', 'compl', 'concept', 'const', 'consteval', 'constexpr', 'constinit', 'const_cast', 'continue', 'decltype', 'default', 'delete', 'do', 'double', 'dynamic_cast', 'else', 'enum', 'explicit', 'export', 'extern', 'false', 'float', 'for', 'friend', 'goto', 'if', 'inline', 'int', 'long', 'mutable', 'namespace', 'new', 'noexcept', 'not', 'not_eq', 'nullptr', 'operator', 'or', 'or_eq', 'private', 'protected', 'public', 'register', 'reinterpret_cast', 'requires', 'return', 'short', 'signed', 'sizeof', 'static', 'static_assert', 'static_cast', 'struct', 'switch', 'template', 'this', 'thread_local', 'throw', 'true', 'try', 'typedef', 'typeid', 'typename', 'union', 'unsigned', 'using', 'virtual', 'void', 'volatile', 'wchar_t', 'while', 'xor', 'xor_eq' ] _simple_type_specifiers_re = re.compile(r"""(?x) \b( auto|void|bool |signed|unsigned |short|long |char|wchar_t|char(8|16|32)_t |int |__int(64|128) # extension |float|double |__float80|_Float64x|__float128|_Float128 # extension |_Complex|_Imaginary # extension )\b """) _max_id = 4 _id_prefix = [None, '', '_CPPv2', '_CPPv3', '_CPPv4'] # Ids are used in lookup keys which are used across pickled files, # so when _max_id changes, make sure to update the ENV_VERSION. # ------------------------------------------------------------------------------ # Id v1 constants # ------------------------------------------------------------------------------ _id_fundamental_v1 = { 'char': 'c', 'signed char': 'c', 'unsigned char': 'C', 'int': 'i', 'signed int': 'i', 'unsigned int': 'U', 'long': 'l', 'signed long': 'l', 'unsigned long': 'L', 'bool': 'b' } _id_shorthands_v1 = { 'std::string': 'ss', 'std::ostream': 'os', 'std::istream': 'is', 'std::iostream': 'ios', 'std::vector': 'v', 'std::map': 'm' } _id_operator_v1 = { 'new': 'new-operator', 'new[]': 'new-array-operator', 'delete': 'delete-operator', 'delete[]': 'delete-array-operator', # the arguments will make the difference between unary and binary # '+(unary)' : 'ps', # '-(unary)' : 'ng', # '&(unary)' : 'ad', # '*(unary)' : 'de', '~': 'inv-operator', '+': 'add-operator', '-': 'sub-operator', '*': 'mul-operator', '/': 'div-operator', '%': 'mod-operator', '&': 'and-operator', '|': 'or-operator', '^': 'xor-operator', '=': 'assign-operator', '+=': 'add-assign-operator', '-=': 'sub-assign-operator', '*=': 'mul-assign-operator', '/=': 'div-assign-operator', '%=': 'mod-assign-operator', '&=': 'and-assign-operator', '|=': 'or-assign-operator', '^=': 'xor-assign-operator', '<<': 'lshift-operator', '>>': 'rshift-operator', '<<=': 'lshift-assign-operator', '>>=': 'rshift-assign-operator', '==': 'eq-operator', '!=': 'neq-operator', '<': 'lt-operator', '>': 'gt-operator', '<=': 'lte-operator', '>=': 'gte-operator', '!': 'not-operator', '&&': 'sand-operator', '||': 'sor-operator', '++': 'inc-operator', '--': 'dec-operator', ',': 'comma-operator', '->*': 'pointer-by-pointer-operator', '->': 'pointer-operator', '()': 'call-operator', '[]': 'subscript-operator' } # ------------------------------------------------------------------------------ # Id v > 1 constants # ------------------------------------------------------------------------------ _id_fundamental_v2 = { # not all of these are actually parsed as fundamental types, TODO: do that 'void': 'v', 'bool': 'b', 'char': 'c', 'signed char': 'a', 'unsigned char': 'h', 'wchar_t': 'w', 'char32_t': 'Di', 'char16_t': 'Ds', 'char8_t': 'Du', 'short': 's', 'short int': 's', 'signed short': 's', 'signed short int': 's', 'unsigned short': 't', 'unsigned short int': 't', 'int': 'i', 'signed': 'i', 'signed int': 'i', 'unsigned': 'j', 'unsigned int': 'j', 'long': 'l', 'long int': 'l', 'signed long': 'l', 'signed long int': 'l', 'unsigned long': 'm', 'unsigned long int': 'm', 'long long': 'x', 'long long int': 'x', 'signed long long': 'x', 'signed long long int': 'x', '__int64': 'x', 'unsigned long long': 'y', 'unsigned long long int': 'y', '__int128': 'n', 'signed __int128': 'n', 'unsigned __int128': 'o', 'float': 'f', 'double': 'd', 'long double': 'e', '__float80': 'e', '_Float64x': 'e', '__float128': 'g', '_Float128': 'g', '_Complex float': 'Cf', '_Complex double': 'Cd', '_Complex long double': 'Ce', '_Imaginary float': 'f', '_Imaginary double': 'd', '_Imaginary long double': 'e', 'auto': 'Da', 'decltype(auto)': 'Dc', 'std::nullptr_t': 'Dn' } _id_operator_v2 = { 'new': 'nw', 'new[]': 'na', 'delete': 'dl', 'delete[]': 'da', # the arguments will make the difference between unary and binary # in operator definitions # '+(unary)' : 'ps', # '-(unary)' : 'ng', # '&(unary)' : 'ad', # '*(unary)' : 'de', '~': 'co', 'compl': 'co', '+': 'pl', '-': 'mi', '*': 'ml', '/': 'dv', '%': 'rm', '&': 'an', 'bitand': 'an', '|': 'or', 'bitor': 'or', '^': 'eo', 'xor': 'eo', '=': 'aS', '+=': 'pL', '-=': 'mI', '*=': 'mL', '/=': 'dV', '%=': 'rM', '&=': 'aN', 'and_eq': 'aN', '|=': 'oR', 'or_eq': 'oR', '^=': 'eO', 'xor_eq': 'eO', '<<': 'ls', '>>': 'rs', '<<=': 'lS', '>>=': 'rS', '==': 'eq', '!=': 'ne', 'not_eq': 'ne', '<': 'lt', '>': 'gt', '<=': 'le', '>=': 'ge', '<=>': 'ss', '!': 'nt', 'not': 'nt', '&&': 'aa', 'and': 'aa', '||': 'oo', 'or': 'oo', '++': 'pp', '--': 'mm', ',': 'cm', '->*': 'pm', '->': 'pt', '()': 'cl', '[]': 'ix', '.*': 'ds' # this one is not overloadable, but we need it for expressions } _id_operator_unary_v2 = { '++': 'pp_', '--': 'mm_', '*': 'de', '&': 'ad', '+': 'ps', '-': 'ng', '!': 'nt', 'not': 'nt', '~': 'co', 'compl': 'co' } _id_char_from_prefix: Dict[Optional[str], str] = { None: 'c', 'u8': 'c', 'u': 'Ds', 'U': 'Di', 'L': 'w' } # these are ordered by preceedence _expression_bin_ops = [ ['||', 'or'], ['&&', 'and'], ['|', 'bitor'], ['^', 'xor'], ['&', 'bitand'], ['==', '!=', 'not_eq'], ['<=>', '<=', '>=', '<', '>'], ['<<', '>>'], ['+', '-'], ['*', '/', '%'], ['.*', '->*'] ] _expression_unary_ops = ["++", "--", "*", "&", "+", "-", "!", "not", "~", "compl"] _expression_assignment_ops = ["=", "*=", "/=", "%=", "+=", "-=", ">>=", "<<=", "&=", "and_eq", "^=", "|=", "xor_eq", "or_eq"] _id_explicit_cast = { 'dynamic_cast': 'dc', 'static_cast': 'sc', 'const_cast': 'cc', 'reinterpret_cast': 'rc' } class _DuplicateSymbolError(Exception): def __init__(self, symbol: "Symbol", declaration: "ASTDeclaration") -> None: assert symbol assert declaration self.symbol = symbol self.declaration = declaration def __str__(self) -> str: return "Internal C++ duplicate symbol error:\n%s" % self.symbol.dump(0) class ASTBase(ASTBaseBase): pass # Names ################################################################################ class ASTIdentifier(ASTBase): def __init__(self, identifier: str) -> None: assert identifier is not None assert len(identifier) != 0 self.identifier = identifier def is_anon(self) -> bool: return self.identifier[0] == '@' def get_id(self, version: int) -> str: if self.is_anon() and version < 3: raise NoOldIdError() if version == 1: if self.identifier == 'size_t': return 's' else: return self.identifier if self.identifier == "std": return 'St' elif self.identifier[0] == "~": # a destructor, just use an arbitrary version of dtors return 'D0' else: if self.is_anon(): return 'Ut%d_%s' % (len(self.identifier) - 1, self.identifier[1:]) else: return str(len(self.identifier)) + self.identifier # and this is where we finally make a difference between __str__ and the display string def __str__(self) -> str: return self.identifier def get_display_string(self) -> str: return "[anonymous]" if self.is_anon() else self.identifier def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", prefix: str, templateArgs: str, symbol: "Symbol") -> None: verify_description_mode(mode) if self.is_anon(): node = addnodes.desc_sig_name(text="[anonymous]") else: node = addnodes.desc_sig_name(self.identifier, self.identifier) if mode == 'markType': targetText = prefix + self.identifier + templateArgs pnode = addnodes.pending_xref('', refdomain='cpp', reftype='identifier', reftarget=targetText, modname=None, classname=None) pnode['cpp:parent_key'] = symbol.get_lookup_key() pnode += node signode += pnode elif mode == 'lastIsName': nameNode = addnodes.desc_name() nameNode += node signode += nameNode elif mode == 'noneIsName': signode += node elif mode == 'param': node['classes'].append('sig-param') signode += node elif mode == 'udl': # the target is 'operator""id' instead of just 'id' assert len(prefix) == 0 assert len(templateArgs) == 0 assert not self.is_anon() targetText = 'operator""' + self.identifier pnode = addnodes.pending_xref('', refdomain='cpp', reftype='identifier', reftarget=targetText, modname=None, classname=None) pnode['cpp:parent_key'] = symbol.get_lookup_key() pnode += node signode += pnode else: raise Exception('Unknown description mode: %s' % mode) class ASTNestedNameElement(ASTBase): def __init__(self, identOrOp: Union[ASTIdentifier, "ASTOperator"], templateArgs: "ASTTemplateArgs") -> None: self.identOrOp = identOrOp self.templateArgs = templateArgs def is_operator(self) -> bool: return False def get_id(self, version: int) -> str: res = self.identOrOp.get_id(version) if self.templateArgs: res += self.templateArgs.get_id(version) return res def _stringify(self, transform: StringifyTransform) -> str: res = transform(self.identOrOp) if self.templateArgs: res += transform(self.templateArgs) return res def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", prefix: str, symbol: "Symbol") -> None: tArgs = str(self.templateArgs) if self.templateArgs is not None else '' self.identOrOp.describe_signature(signode, mode, env, prefix, tArgs, symbol) if self.templateArgs is not None: self.templateArgs.describe_signature(signode, 'markType', env, symbol) class ASTNestedName(ASTBase): def __init__(self, names: List[ASTNestedNameElement], templates: List[bool], rooted: bool) -> None: assert len(names) > 0 self.names = names self.templates = templates assert len(self.names) == len(self.templates) self.rooted = rooted @property def name(self) -> "ASTNestedName": return self def num_templates(self) -> int: count = 0 for n in self.names: if n.is_operator(): continue if n.templateArgs: count += 1 return count def get_id(self, version: int, modifiers: str = '') -> str: if version == 1: tt = str(self) if tt in _id_shorthands_v1: return _id_shorthands_v1[tt] else: return '::'.join(n.get_id(version) for n in self.names) res = [] if len(self.names) > 1 or len(modifiers) > 0: res.append('N') res.append(modifiers) for n in self.names: res.append(n.get_id(version)) if len(self.names) > 1 or len(modifiers) > 0: res.append('E') return ''.join(res) def _stringify(self, transform: StringifyTransform) -> str: res = [] if self.rooted: res.append('') for i in range(len(self.names)): n = self.names[i] if self.templates[i]: res.append("template " + transform(n)) else: res.append(transform(n)) return '::'.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) # just print the name part, with template args, not template params if mode == 'noneIsName': if self.rooted: assert False, "Can this happen?" # TODO signode += nodes.Text('::') for i in range(len(self.names)): if i != 0: assert False, "Can this happen?" # TODO signode += nodes.Text('::blah') n = self.names[i] if self.templates[i]: assert False, "Can this happen?" # TODO signode += nodes.Text("template") signode += nodes.Text(" ") n.describe_signature(signode, mode, env, '', symbol) elif mode == 'param': assert not self.rooted, str(self) assert len(self.names) == 1 assert not self.templates[0] self.names[0].describe_signature(signode, 'param', env, '', symbol) elif mode == 'markType' or mode == 'lastIsName' or mode == 'markName': # Each element should be a pending xref targeting the complete # prefix. however, only the identifier part should be a link, such # that template args can be a link as well. # For 'lastIsName' we should also prepend template parameter lists. templateParams: List[Any] = [] if mode == 'lastIsName': assert symbol is not None if symbol.declaration.templatePrefix is not None: templateParams = symbol.declaration.templatePrefix.templates iTemplateParams = 0 templateParamsPrefix = '' prefix = '' first = True names = self.names[:-1] if mode == 'lastIsName' else self.names # If lastIsName, then wrap all of the prefix in a desc_addname, # else append directly to signode. # NOTE: Breathe previously relied on the prefix being in the desc_addname node, # so it can remove it in inner declarations. dest = signode if mode == 'lastIsName': dest = addnodes.desc_addname() if self.rooted: prefix += '::' if mode == 'lastIsName' and len(names) == 0: signode += addnodes.desc_sig_punctuation('::', '::') else: dest += addnodes.desc_sig_punctuation('::', '::') for i in range(len(names)): nne = names[i] template = self.templates[i] if not first: dest += addnodes.desc_sig_punctuation('::', '::') prefix += '::' if template: dest += addnodes.desc_sig_keyword('template', 'template') dest += addnodes.desc_sig_space() first = False txt_nne = str(nne) if txt_nne != '': if nne.templateArgs and iTemplateParams < len(templateParams): templateParamsPrefix += str(templateParams[iTemplateParams]) iTemplateParams += 1 nne.describe_signature(dest, 'markType', env, templateParamsPrefix + prefix, symbol) prefix += txt_nne if mode == 'lastIsName': if len(self.names) > 1: dest += addnodes.desc_sig_punctuation('::', '::') signode += dest if self.templates[-1]: signode += addnodes.desc_sig_keyword('template', 'template') signode += addnodes.desc_sig_space() self.names[-1].describe_signature(signode, mode, env, '', symbol) else: raise Exception('Unknown description mode: %s' % mode) ################################################################################ # Expressions ################################################################################ class ASTExpression(ASTBase): def get_id(self, version: int) -> str: raise NotImplementedError(repr(self)) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: raise NotImplementedError(repr(self)) # Primary expressions ################################################################################ class ASTLiteral(ASTExpression): pass class ASTPointerLiteral(ASTLiteral): def _stringify(self, transform: StringifyTransform) -> str: return 'nullptr' def get_id(self, version: int) -> str: return 'LDnE' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('nullptr', 'nullptr') class ASTBooleanLiteral(ASTLiteral): def __init__(self, value: bool) -> None: self.value = value def _stringify(self, transform: StringifyTransform) -> str: if self.value: return 'true' else: return 'false' def get_id(self, version: int) -> str: if self.value: return 'L1E' else: return 'L0E' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword(str(self), str(self)) class ASTNumberLiteral(ASTLiteral): def __init__(self, data: str) -> None: self.data = data def _stringify(self, transform: StringifyTransform) -> str: return self.data def get_id(self, version: int) -> str: # TODO: floats should be mangled by writing the hex of the binary representation return "L%sE" % self.data.replace("'", "") def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_literal_number(self.data, self.data) class ASTStringLiteral(ASTLiteral): def __init__(self, data: str) -> None: self.data = data def _stringify(self, transform: StringifyTransform) -> str: return self.data def get_id(self, version: int) -> str: # note: the length is not really correct with escaping return "LA%d_KcE" % (len(self.data) - 2) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_literal_string(self.data, self.data) class ASTCharLiteral(ASTLiteral): def __init__(self, prefix: str, data: str) -> None: self.prefix = prefix # may be None when no prefix self.data = data assert prefix in _id_char_from_prefix self.type = _id_char_from_prefix[prefix] decoded = data.encode().decode('unicode-escape') if len(decoded) == 1: self.value = ord(decoded) else: raise UnsupportedMultiCharacterCharLiteral(decoded) def _stringify(self, transform: StringifyTransform) -> str: if self.prefix is None: return "'" + self.data + "'" else: return self.prefix + "'" + self.data + "'" def get_id(self, version: int) -> str: # TODO: the ID should be have L E around it return self.type + str(self.value) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: if self.prefix is not None: signode += addnodes.desc_sig_keyword(self.prefix, self.prefix) txt = "'" + self.data + "'" signode += addnodes.desc_sig_literal_char(txt, txt) class ASTUserDefinedLiteral(ASTLiteral): def __init__(self, literal: ASTLiteral, ident: ASTIdentifier): self.literal = literal self.ident = ident def _stringify(self, transform: StringifyTransform) -> str: return transform(self.literal) + transform(self.ident) def get_id(self, version: int) -> str: # mangle as if it was a function call: ident(literal) return 'clL_Zli{}E{}E'.format(self.ident.get_id(version), self.literal.get_id(version)) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.literal.describe_signature(signode, mode, env, symbol) self.ident.describe_signature(signode, "udl", env, "", "", symbol) ################################################################################ class ASTThisLiteral(ASTExpression): def _stringify(self, transform: StringifyTransform) -> str: return "this" def get_id(self, version: int) -> str: return "fpT" def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('this', 'this') class ASTFoldExpr(ASTExpression): def __init__(self, leftExpr: ASTExpression, op: str, rightExpr: ASTExpression) -> None: assert leftExpr is not None or rightExpr is not None self.leftExpr = leftExpr self.op = op self.rightExpr = rightExpr def _stringify(self, transform: StringifyTransform) -> str: res = ['('] if self.leftExpr: res.append(transform(self.leftExpr)) res.append(' ') res.append(self.op) res.append(' ') res.append('...') if self.rightExpr: res.append(' ') res.append(self.op) res.append(' ') res.append(transform(self.rightExpr)) res.append(')') return ''.join(res) def get_id(self, version: int) -> str: assert version >= 3 if version == 3: return str(self) # https://github.com/itanium-cxx-abi/cxx-abi/pull/67 res = [] if self.leftExpr is None: # (... op expr) res.append('fl') elif self.rightExpr is None: # (expr op ...) res.append('fr') else: # (expr op ... op expr) # we don't check where the parameter pack is, # we just always call this a binary left fold res.append('fL') res.append(_id_operator_v2[self.op]) if self.leftExpr: res.append(self.leftExpr.get_id(version)) if self.rightExpr: res.append(self.rightExpr.get_id(version)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_punctuation('(', '(') if self.leftExpr: self.leftExpr.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_operator(self.op, self.op) signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_punctuation('...', '...') if self.rightExpr: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_operator(self.op, self.op) signode += addnodes.desc_sig_space() self.rightExpr.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') class ASTParenExpr(ASTExpression): def __init__(self, expr: ASTExpression): self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: return '(' + transform(self.expr) + ')' def get_id(self, version: int) -> str: return self.expr.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_punctuation('(', '(') self.expr.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') class ASTIdExpression(ASTExpression): def __init__(self, name: ASTNestedName): # note: this class is basically to cast a nested name as an expression self.name = name def _stringify(self, transform: StringifyTransform) -> str: return transform(self.name) def get_id(self, version: int) -> str: return self.name.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.name.describe_signature(signode, mode, env, symbol) # Postfix expressions ################################################################################ class ASTPostfixOp(ASTBase): def get_id(self, idPrefix: str, version: int) -> str: raise NotImplementedError(repr(self)) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: raise NotImplementedError(repr(self)) class ASTPostfixArray(ASTPostfixOp): def __init__(self, expr: ASTExpression): self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: return '[' + transform(self.expr) + ']' def get_id(self, idPrefix: str, version: int) -> str: return 'ix' + idPrefix + self.expr.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_punctuation('[', '[') self.expr.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(']', ']') class ASTPostfixMember(ASTPostfixOp): def __init__(self, name: ASTNestedName): self.name = name def _stringify(self, transform: StringifyTransform) -> str: return '.' + transform(self.name) def get_id(self, idPrefix: str, version: int) -> str: return 'dt' + idPrefix + self.name.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_punctuation('.', '.') self.name.describe_signature(signode, 'noneIsName', env, symbol) class ASTPostfixMemberOfPointer(ASTPostfixOp): def __init__(self, name: ASTNestedName): self.name = name def _stringify(self, transform: StringifyTransform) -> str: return '->' + transform(self.name) def get_id(self, idPrefix: str, version: int) -> str: return 'pt' + idPrefix + self.name.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_operator('->', '->') self.name.describe_signature(signode, 'noneIsName', env, symbol) class ASTPostfixInc(ASTPostfixOp): def _stringify(self, transform: StringifyTransform) -> str: return '++' def get_id(self, idPrefix: str, version: int) -> str: return 'pp' + idPrefix def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_operator('++', '++') class ASTPostfixDec(ASTPostfixOp): def _stringify(self, transform: StringifyTransform) -> str: return '--' def get_id(self, idPrefix: str, version: int) -> str: return 'mm' + idPrefix def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_operator('--', '--') class ASTPostfixCallExpr(ASTPostfixOp): def __init__(self, lst: Union["ASTParenExprList", "ASTBracedInitList"]) -> None: self.lst = lst def _stringify(self, transform: StringifyTransform) -> str: return transform(self.lst) def get_id(self, idPrefix: str, version: int) -> str: res = ['cl', idPrefix] for e in self.lst.exprs: res.append(e.get_id(version)) res.append('E') return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.lst.describe_signature(signode, mode, env, symbol) class ASTPostfixExpr(ASTExpression): def __init__(self, prefix: "ASTType", postFixes: List[ASTPostfixOp]): self.prefix = prefix self.postFixes = postFixes def _stringify(self, transform: StringifyTransform) -> str: res = [transform(self.prefix)] for p in self.postFixes: res.append(transform(p)) return ''.join(res) def get_id(self, version: int) -> str: id = self.prefix.get_id(version) for p in self.postFixes: id = p.get_id(id, version) return id def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.prefix.describe_signature(signode, mode, env, symbol) for p in self.postFixes: p.describe_signature(signode, mode, env, symbol) class ASTExplicitCast(ASTExpression): def __init__(self, cast: str, typ: "ASTType", expr: ASTExpression): assert cast in _id_explicit_cast self.cast = cast self.typ = typ self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: res = [self.cast] res.append('<') res.append(transform(self.typ)) res.append('>(') res.append(transform(self.expr)) res.append(')') return ''.join(res) def get_id(self, version: int) -> str: return (_id_explicit_cast[self.cast] + self.typ.get_id(version) + self.expr.get_id(version)) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword(self.cast, self.cast) signode += addnodes.desc_sig_punctuation('<', '<') self.typ.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation('>', '>') signode += addnodes.desc_sig_punctuation('(', '(') self.expr.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') class ASTTypeId(ASTExpression): def __init__(self, typeOrExpr: Union["ASTType", ASTExpression], isType: bool): self.typeOrExpr = typeOrExpr self.isType = isType def _stringify(self, transform: StringifyTransform) -> str: return 'typeid(' + transform(self.typeOrExpr) + ')' def get_id(self, version: int) -> str: prefix = 'ti' if self.isType else 'te' return prefix + self.typeOrExpr.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('typeid', 'typeid') signode += addnodes.desc_sig_punctuation('(', '(') self.typeOrExpr.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') # Unary expressions ################################################################################ class ASTUnaryOpExpr(ASTExpression): def __init__(self, op: str, expr: ASTExpression): self.op = op self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: if self.op[0] in 'cn': return self.op + " " + transform(self.expr) else: return self.op + transform(self.expr) def get_id(self, version: int) -> str: return _id_operator_unary_v2[self.op] + self.expr.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: if self.op[0] in 'cn': signode += addnodes.desc_sig_keyword(self.op, self.op) signode += addnodes.desc_sig_space() else: signode += addnodes.desc_sig_operator(self.op, self.op) self.expr.describe_signature(signode, mode, env, symbol) class ASTSizeofParamPack(ASTExpression): def __init__(self, identifier: ASTIdentifier): self.identifier = identifier def _stringify(self, transform: StringifyTransform) -> str: return "sizeof...(" + transform(self.identifier) + ")" def get_id(self, version: int) -> str: return 'sZ' + self.identifier.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('sizeof', 'sizeof') signode += addnodes.desc_sig_punctuation('...', '...') signode += addnodes.desc_sig_punctuation('(', '(') self.identifier.describe_signature(signode, 'markType', env, symbol=symbol, prefix="", templateArgs="") signode += addnodes.desc_sig_punctuation(')', ')') class ASTSizeofType(ASTExpression): def __init__(self, typ: "ASTType"): self.typ = typ def _stringify(self, transform: StringifyTransform) -> str: return "sizeof(" + transform(self.typ) + ")" def get_id(self, version: int) -> str: return 'st' + self.typ.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('sizeof', 'sizeof') signode += addnodes.desc_sig_punctuation('(', '(') self.typ.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') class ASTSizeofExpr(ASTExpression): def __init__(self, expr: ASTExpression): self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: return "sizeof " + transform(self.expr) def get_id(self, version: int) -> str: return 'sz' + self.expr.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('sizeof', 'sizeof') signode += addnodes.desc_sig_space() self.expr.describe_signature(signode, mode, env, symbol) class ASTAlignofExpr(ASTExpression): def __init__(self, typ: "ASTType"): self.typ = typ def _stringify(self, transform: StringifyTransform) -> str: return "alignof(" + transform(self.typ) + ")" def get_id(self, version: int) -> str: return 'at' + self.typ.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('alignof', 'alignof') signode += addnodes.desc_sig_punctuation('(', '(') self.typ.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') class ASTNoexceptExpr(ASTExpression): def __init__(self, expr: ASTExpression): self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: return 'noexcept(' + transform(self.expr) + ')' def get_id(self, version: int) -> str: return 'nx' + self.expr.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('noexcept', 'noexcept') signode += addnodes.desc_sig_punctuation('(', '(') self.expr.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') class ASTNewExpr(ASTExpression): def __init__(self, rooted: bool, isNewTypeId: bool, typ: "ASTType", initList: Union["ASTParenExprList", "ASTBracedInitList"]) -> None: self.rooted = rooted self.isNewTypeId = isNewTypeId self.typ = typ self.initList = initList def _stringify(self, transform: StringifyTransform) -> str: res = [] if self.rooted: res.append('::') res.append('new ') # TODO: placement if self.isNewTypeId: res.append(transform(self.typ)) else: assert False if self.initList is not None: res.append(transform(self.initList)) return ''.join(res) def get_id(self, version: int) -> str: # the array part will be in the type mangling, so na is not used res = ['nw'] # TODO: placement res.append('_') res.append(self.typ.get_id(version)) if self.initList is not None: res.append(self.initList.get_id(version)) else: res.append('E') return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: if self.rooted: signode += addnodes.desc_sig_punctuation('::', '::') signode += addnodes.desc_sig_keyword('new', 'new') signode += addnodes.desc_sig_space() # TODO: placement if self.isNewTypeId: self.typ.describe_signature(signode, mode, env, symbol) else: assert False if self.initList is not None: self.initList.describe_signature(signode, mode, env, symbol) class ASTDeleteExpr(ASTExpression): def __init__(self, rooted: bool, array: bool, expr: ASTExpression): self.rooted = rooted self.array = array self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: res = [] if self.rooted: res.append('::') res.append('delete ') if self.array: res.append('[] ') res.append(transform(self.expr)) return ''.join(res) def get_id(self, version: int) -> str: if self.array: id = "da" else: id = "dl" return id + self.expr.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: if self.rooted: signode += addnodes.desc_sig_punctuation('::', '::') signode += addnodes.desc_sig_keyword('delete', 'delete') signode += addnodes.desc_sig_space() if self.array: signode += addnodes.desc_sig_punctuation('[]', '[]') signode += addnodes.desc_sig_space() self.expr.describe_signature(signode, mode, env, symbol) # Other expressions ################################################################################ class ASTCastExpr(ASTExpression): def __init__(self, typ: "ASTType", expr: ASTExpression): self.typ = typ self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: res = ['('] res.append(transform(self.typ)) res.append(')') res.append(transform(self.expr)) return ''.join(res) def get_id(self, version: int) -> str: return 'cv' + self.typ.get_id(version) + self.expr.get_id(version) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_punctuation('(', '(') self.typ.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') self.expr.describe_signature(signode, mode, env, symbol) class ASTBinOpExpr(ASTExpression): def __init__(self, exprs: List[ASTExpression], ops: List[str]): assert len(exprs) > 0 assert len(exprs) == len(ops) + 1 self.exprs = exprs self.ops = ops def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append(transform(self.exprs[0])) for i in range(1, len(self.exprs)): res.append(' ') res.append(self.ops[i - 1]) res.append(' ') res.append(transform(self.exprs[i])) return ''.join(res) def get_id(self, version: int) -> str: assert version >= 2 res = [] for i in range(len(self.ops)): res.append(_id_operator_v2[self.ops[i]]) res.append(self.exprs[i].get_id(version)) res.append(self.exprs[-1].get_id(version)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.exprs[0].describe_signature(signode, mode, env, symbol) for i in range(1, len(self.exprs)): signode += addnodes.desc_sig_space() op = self.ops[i - 1] if ord(op[0]) >= ord('a') and ord(op[0]) <= ord('z'): signode += addnodes.desc_sig_keyword(op, op) else: signode += addnodes.desc_sig_operator(op, op) signode += addnodes.desc_sig_space() self.exprs[i].describe_signature(signode, mode, env, symbol) class ASTBracedInitList(ASTBase): def __init__(self, exprs: List[Union[ASTExpression, "ASTBracedInitList"]], trailingComma: bool) -> None: self.exprs = exprs self.trailingComma = trailingComma def get_id(self, version: int) -> str: return "il%sE" % ''.join(e.get_id(version) for e in self.exprs) def _stringify(self, transform: StringifyTransform) -> str: exprs = [transform(e) for e in self.exprs] trailingComma = ',' if self.trailingComma else '' return '{%s%s}' % (', '.join(exprs), trailingComma) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) signode += addnodes.desc_sig_punctuation('{', '{') first = True for e in self.exprs: if not first: signode += addnodes.desc_sig_punctuation(',', ',') signode += addnodes.desc_sig_space() else: first = False e.describe_signature(signode, mode, env, symbol) if self.trailingComma: signode += addnodes.desc_sig_punctuation(',', ',') signode += addnodes.desc_sig_punctuation('}', '}') class ASTAssignmentExpr(ASTExpression): def __init__(self, exprs: List[Union[ASTExpression, ASTBracedInitList]], ops: List[str]): assert len(exprs) > 0 assert len(exprs) == len(ops) + 1 self.exprs = exprs self.ops = ops def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append(transform(self.exprs[0])) for i in range(1, len(self.exprs)): res.append(' ') res.append(self.ops[i - 1]) res.append(' ') res.append(transform(self.exprs[i])) return ''.join(res) def get_id(self, version: int) -> str: res = [] for i in range(len(self.ops)): res.append(_id_operator_v2[self.ops[i]]) res.append(self.exprs[i].get_id(version)) res.append(self.exprs[-1].get_id(version)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.exprs[0].describe_signature(signode, mode, env, symbol) for i in range(1, len(self.exprs)): signode += addnodes.desc_sig_space() op = self.ops[i - 1] if ord(op[0]) >= ord('a') and ord(op[0]) <= ord('z'): signode += addnodes.desc_sig_keyword(op, op) else: signode += addnodes.desc_sig_operator(op, op) signode += addnodes.desc_sig_space() self.exprs[i].describe_signature(signode, mode, env, symbol) class ASTCommaExpr(ASTExpression): def __init__(self, exprs: List[ASTExpression]): assert len(exprs) > 0 self.exprs = exprs def _stringify(self, transform: StringifyTransform) -> str: return ', '.join(transform(e) for e in self.exprs) def get_id(self, version: int) -> str: id_ = _id_operator_v2[','] res = [] for i in range(len(self.exprs) - 1): res.append(id_) res.append(self.exprs[i].get_id(version)) res.append(self.exprs[-1].get_id(version)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.exprs[0].describe_signature(signode, mode, env, symbol) for i in range(1, len(self.exprs)): signode += addnodes.desc_sig_punctuation(',', ',') signode += addnodes.desc_sig_space() self.exprs[i].describe_signature(signode, mode, env, symbol) class ASTFallbackExpr(ASTExpression): def __init__(self, expr: str): self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: return self.expr def get_id(self, version: int) -> str: return str(self.expr) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += nodes.literal(self.expr, self.expr) ################################################################################ # Types ################################################################################ # Things for ASTNestedName ################################################################################ class ASTOperator(ASTBase): def is_anon(self) -> bool: return False def is_operator(self) -> bool: return True def get_id(self, version: int) -> str: raise NotImplementedError() def _describe_identifier(self, signode: TextElement, identnode: TextElement, env: "BuildEnvironment", symbol: "Symbol") -> None: """Render the prefix into signode, and the last part into identnode.""" raise NotImplementedError() def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", prefix: str, templateArgs: str, symbol: "Symbol") -> None: verify_description_mode(mode) if mode == 'lastIsName': mainName = addnodes.desc_name() self._describe_identifier(mainName, mainName, env, symbol) signode += mainName elif mode == 'markType': targetText = prefix + str(self) + templateArgs pnode = addnodes.pending_xref('', refdomain='cpp', reftype='identifier', reftarget=targetText, modname=None, classname=None) pnode['cpp:parent_key'] = symbol.get_lookup_key() # Render the identifier part, but collapse it into a string # and make that the a link to this operator. # E.g., if it is 'operator SomeType', then 'SomeType' becomes # a link to the operator, not to 'SomeType'. container = nodes.literal() self._describe_identifier(signode, container, env, symbol) txt = container.astext() pnode += addnodes.desc_name(txt, txt) signode += pnode else: addName = addnodes.desc_addname() self._describe_identifier(addName, addName, env, symbol) signode += addName class ASTOperatorBuildIn(ASTOperator): def __init__(self, op: str) -> None: self.op = op def get_id(self, version: int) -> str: if version == 1: ids = _id_operator_v1 if self.op not in ids: raise NoOldIdError() else: ids = _id_operator_v2 if self.op not in ids: raise Exception('Internal error: Built-in operator "%s" can not ' 'be mapped to an id.' % self.op) return ids[self.op] def _stringify(self, transform: StringifyTransform) -> str: if self.op in ('new', 'new[]', 'delete', 'delete[]') or self.op[0] in "abcnox": return 'operator ' + self.op else: return 'operator' + self.op def _describe_identifier(self, signode: TextElement, identnode: TextElement, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('operator', 'operator') if self.op in ('new', 'new[]', 'delete', 'delete[]') or self.op[0] in "abcnox": signode += addnodes.desc_sig_space() identnode += addnodes.desc_sig_operator(self.op, self.op) class ASTOperatorLiteral(ASTOperator): def __init__(self, identifier: ASTIdentifier) -> None: self.identifier = identifier def get_id(self, version: int) -> str: if version == 1: raise NoOldIdError() else: return 'li' + self.identifier.get_id(version) def _stringify(self, transform: StringifyTransform) -> str: return 'operator""' + transform(self.identifier) def _describe_identifier(self, signode: TextElement, identnode: TextElement, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('operator', 'operator') signode += addnodes.desc_sig_literal_string('""', '""') self.identifier.describe_signature(identnode, 'markType', env, '', '', symbol) class ASTOperatorType(ASTOperator): def __init__(self, type: "ASTType") -> None: self.type = type def get_id(self, version: int) -> str: if version == 1: return 'castto-%s-operator' % self.type.get_id(version) else: return 'cv' + self.type.get_id(version) def _stringify(self, transform: StringifyTransform) -> str: return ''.join(['operator ', transform(self.type)]) def get_name_no_template(self) -> str: return str(self) def _describe_identifier(self, signode: TextElement, identnode: TextElement, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('operator', 'operator') signode += addnodes.desc_sig_space() self.type.describe_signature(identnode, 'markType', env, symbol) class ASTTemplateArgConstant(ASTBase): def __init__(self, value: ASTExpression) -> None: self.value = value def _stringify(self, transform: StringifyTransform) -> str: return transform(self.value) def get_id(self, version: int) -> str: if version == 1: return str(self).replace(' ', '-') if version == 2: return 'X' + str(self) + 'E' return 'X' + self.value.get_id(version) + 'E' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.value.describe_signature(signode, mode, env, symbol) class ASTTemplateArgs(ASTBase): def __init__(self, args: List[Union["ASTType", ASTTemplateArgConstant]], packExpansion: bool) -> None: assert args is not None self.args = args self.packExpansion = packExpansion def get_id(self, version: int) -> str: if version == 1: res = [] res.append(':') res.append('.'.join(a.get_id(version) for a in self.args)) res.append(':') return ''.join(res) res = [] res.append('I') if len(self.args) > 0: for a in self.args[:-1]: res.append(a.get_id(version)) if self.packExpansion: res.append('J') res.append(self.args[-1].get_id(version)) if self.packExpansion: res.append('E') res.append('E') return ''.join(res) def _stringify(self, transform: StringifyTransform) -> str: res = ', '.join(transform(a) for a in self.args) if self.packExpansion: res += '...' return '<' + res + '>' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) signode += addnodes.desc_sig_punctuation('<', '<') first = True for a in self.args: if not first: signode += addnodes.desc_sig_punctuation(',', ',') signode += addnodes.desc_sig_space() first = False a.describe_signature(signode, 'markType', env, symbol=symbol) if self.packExpansion: signode += addnodes.desc_sig_punctuation('...', '...') signode += addnodes.desc_sig_punctuation('>', '>') # Main part of declarations ################################################################################ class ASTTrailingTypeSpec(ASTBase): def get_id(self, version: int) -> str: raise NotImplementedError(repr(self)) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: raise NotImplementedError(repr(self)) class ASTTrailingTypeSpecFundamental(ASTTrailingTypeSpec): def __init__(self, names: List[str], canonNames: List[str]) -> None: assert len(names) != 0 assert len(names) == len(canonNames), (names, canonNames) self.names = names # the canonical name list is for ID lookup self.canonNames = canonNames def _stringify(self, transform: StringifyTransform) -> str: return ' '.join(self.names) def get_id(self, version: int) -> str: if version == 1: res = [] for a in self.canonNames: if a in _id_fundamental_v1: res.append(_id_fundamental_v1[a]) else: res.append(a) return '-'.join(res) txt = ' '.join(self.canonNames) if txt not in _id_fundamental_v2: raise Exception( 'Semi-internal error: Fundamental type "%s" can not be mapped ' 'to an ID. Is it a true fundamental type? If not so, the ' 'parser should have rejected it.' % txt) return _id_fundamental_v2[txt] def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: first = True for n in self.names: if not first: signode += addnodes.desc_sig_space() else: first = False signode += addnodes.desc_sig_keyword_type(n, n) class ASTTrailingTypeSpecDecltypeAuto(ASTTrailingTypeSpec): def _stringify(self, transform: StringifyTransform) -> str: return 'decltype(auto)' def get_id(self, version: int) -> str: if version == 1: raise NoOldIdError() return 'Dc' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('decltype', 'decltype') signode += addnodes.desc_sig_punctuation('(', '(') signode += addnodes.desc_sig_keyword('auto', 'auto') signode += addnodes.desc_sig_punctuation(')', ')') class ASTTrailingTypeSpecDecltype(ASTTrailingTypeSpec): def __init__(self, expr: ASTExpression): self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: return 'decltype(' + transform(self.expr) + ')' def get_id(self, version: int) -> str: if version == 1: raise NoOldIdError() return 'DT' + self.expr.get_id(version) + "E" def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('decltype', 'decltype') signode += addnodes.desc_sig_punctuation('(', '(') self.expr.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') class ASTTrailingTypeSpecName(ASTTrailingTypeSpec): def __init__(self, prefix: str, nestedName: ASTNestedName, placeholderType: Optional[str]) -> None: self.prefix = prefix self.nestedName = nestedName self.placeholderType = placeholderType @property def name(self) -> ASTNestedName: return self.nestedName def get_id(self, version: int) -> str: return self.nestedName.get_id(version) def _stringify(self, transform: StringifyTransform) -> str: res = [] if self.prefix: res.append(self.prefix) res.append(' ') res.append(transform(self.nestedName)) if self.placeholderType is not None: res.append(' ') res.append(self.placeholderType) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: if self.prefix: signode += addnodes.desc_sig_keyword(self.prefix, self.prefix) signode += addnodes.desc_sig_space() self.nestedName.describe_signature(signode, mode, env, symbol=symbol) if self.placeholderType is not None: signode += addnodes.desc_sig_space() if self.placeholderType == 'auto': signode += addnodes.desc_sig_keyword('auto', 'auto') elif self.placeholderType == 'decltype(auto)': signode += addnodes.desc_sig_keyword('decltype', 'decltype') signode += addnodes.desc_sig_punctuation('(', '(') signode += addnodes.desc_sig_keyword('auto', 'auto') signode += addnodes.desc_sig_punctuation(')', ')') else: assert False, self.placeholderType class ASTFunctionParameter(ASTBase): def __init__(self, arg: Union["ASTTypeWithInit", "ASTTemplateParamConstrainedTypeWithInit"], ellipsis: bool = False) -> None: self.arg = arg self.ellipsis = ellipsis def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str: # this is not part of the normal name mangling in C++ if symbol: # the anchor will be our parent return symbol.parent.declaration.get_id(version, prefixed=False) # else, do the usual if self.ellipsis: return 'z' else: return self.arg.get_id(version) def _stringify(self, transform: StringifyTransform) -> str: if self.ellipsis: return '...' else: return transform(self.arg) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) if self.ellipsis: signode += addnodes.desc_sig_punctuation('...', '...') else: self.arg.describe_signature(signode, mode, env, symbol=symbol) class ASTNoexceptSpec(ASTBase): def __init__(self, expr: Optional[ASTExpression]): self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: if self.expr: return 'noexcept(' + transform(self.expr) + ')' return 'noexcept' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('noexcept', 'noexcept') if self.expr: signode += addnodes.desc_sig_punctuation('(', '(') self.expr.describe_signature(signode, 'markType', env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') class ASTParametersQualifiers(ASTBase): def __init__(self, args: List[ASTFunctionParameter], volatile: bool, const: bool, refQual: Optional[str], exceptionSpec: ASTNoexceptSpec, trailingReturn: "ASTType", override: bool, final: bool, attrs: List[ASTAttribute], initializer: Optional[str]) -> None: self.args = args self.volatile = volatile self.const = const self.refQual = refQual self.exceptionSpec = exceptionSpec self.trailingReturn = trailingReturn self.override = override self.final = final self.attrs = attrs self.initializer = initializer @property def function_params(self) -> List[ASTFunctionParameter]: return self.args def get_modifiers_id(self, version: int) -> str: res = [] if self.volatile: res.append('V') if self.const: if version == 1: res.append('C') else: res.append('K') if self.refQual == '&&': res.append('O') elif self.refQual == '&': res.append('R') return ''.join(res) def get_param_id(self, version: int) -> str: if version == 1: if len(self.args) == 0: return '' else: return '__' + '.'.join(a.get_id(version) for a in self.args) if len(self.args) == 0: return 'v' else: return ''.join(a.get_id(version) for a in self.args) def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append('(') first = True for a in self.args: if not first: res.append(', ') first = False res.append(str(a)) res.append(')') if self.volatile: res.append(' volatile') if self.const: res.append(' const') if self.refQual: res.append(' ') res.append(self.refQual) if self.exceptionSpec: res.append(' ') res.append(transform(self.exceptionSpec)) if self.trailingReturn: res.append(' -> ') res.append(transform(self.trailingReturn)) if self.final: res.append(' final') if self.override: res.append(' override') for attr in self.attrs: res.append(' ') res.append(transform(attr)) if self.initializer: res.append(' = ') res.append(self.initializer) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) # only use the desc_parameterlist for the outer list, not for inner lists if mode == 'lastIsName': paramlist = addnodes.desc_parameterlist() for arg in self.args: param = addnodes.desc_parameter('', '', noemph=True) arg.describe_signature(param, 'param', env, symbol=symbol) paramlist += param signode += paramlist else: signode += addnodes.desc_sig_punctuation('(', '(') first = True for arg in self.args: if not first: signode += addnodes.desc_sig_punctuation(',', ',') signode += addnodes.desc_sig_space() first = False arg.describe_signature(signode, 'markType', env, symbol=symbol) signode += addnodes.desc_sig_punctuation(')', ')') def _add_anno(signode: TextElement, text: str) -> None: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_keyword(text, text) if self.volatile: _add_anno(signode, 'volatile') if self.const: _add_anno(signode, 'const') if self.refQual: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_punctuation(self.refQual, self.refQual) if self.exceptionSpec: signode += addnodes.desc_sig_space() self.exceptionSpec.describe_signature(signode, mode, env, symbol) if self.trailingReturn: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_operator('->', '->') signode += addnodes.desc_sig_space() self.trailingReturn.describe_signature(signode, mode, env, symbol) if self.final: _add_anno(signode, 'final') if self.override: _add_anno(signode, 'override') for attr in self.attrs: signode += addnodes.desc_sig_space() attr.describe_signature(signode) if self.initializer: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_punctuation('=', '=') signode += addnodes.desc_sig_space() assert self.initializer in ('0', 'delete', 'default') if self.initializer == '0': signode += addnodes.desc_sig_literal_number('0', '0') else: signode += addnodes.desc_sig_keyword(self.initializer, self.initializer) class ASTExplicitSpec(ASTBase): def __init__(self, expr: Optional[ASTExpression]) -> None: self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: res = ['explicit'] if self.expr is not None: res.append('(') res.append(transform(self.expr)) res.append(')') return ''.join(res) def describe_signature(self, signode: TextElement, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('explicit', 'explicit') if self.expr is not None: signode += addnodes.desc_sig_punctuation('(', '(') self.expr.describe_signature(signode, 'markType', env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') class ASTDeclSpecsSimple(ASTBase): def __init__(self, storage: str, threadLocal: bool, inline: bool, virtual: bool, explicitSpec: Optional[ASTExplicitSpec], consteval: bool, constexpr: bool, constinit: bool, volatile: bool, const: bool, friend: bool, attrs: List[ASTAttribute]) -> None: self.storage = storage self.threadLocal = threadLocal self.inline = inline self.virtual = virtual self.explicitSpec = explicitSpec self.consteval = consteval self.constexpr = constexpr self.constinit = constinit self.volatile = volatile self.const = const self.friend = friend self.attrs = attrs def mergeWith(self, other: "ASTDeclSpecsSimple") -> "ASTDeclSpecsSimple": if not other: return self return ASTDeclSpecsSimple(self.storage or other.storage, self.threadLocal or other.threadLocal, self.inline or other.inline, self.virtual or other.virtual, self.explicitSpec or other.explicitSpec, self.consteval or other.consteval, self.constexpr or other.constexpr, self.constinit or other.constinit, self.volatile or other.volatile, self.const or other.const, self.friend or other.friend, self.attrs + other.attrs) def _stringify(self, transform: StringifyTransform) -> str: res: List[str] = [] res.extend(transform(attr) for attr in self.attrs) if self.storage: res.append(self.storage) if self.threadLocal: res.append('thread_local') if self.inline: res.append('inline') if self.friend: res.append('friend') if self.virtual: res.append('virtual') if self.explicitSpec: res.append(transform(self.explicitSpec)) if self.consteval: res.append('consteval') if self.constexpr: res.append('constexpr') if self.constinit: res.append('constinit') if self.volatile: res.append('volatile') if self.const: res.append('const') return ' '.join(res) def describe_signature(self, signode: TextElement, env: "BuildEnvironment", symbol: "Symbol") -> None: addSpace = False for attr in self.attrs: if addSpace: signode += addnodes.desc_sig_space() addSpace = True attr.describe_signature(signode) def _add(signode: TextElement, text: str) -> bool: if addSpace: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_keyword(text, text) return True if self.storage: addSpace = _add(signode, self.storage) if self.threadLocal: addSpace = _add(signode, 'thread_local') if self.inline: addSpace = _add(signode, 'inline') if self.friend: addSpace = _add(signode, 'friend') if self.virtual: addSpace = _add(signode, 'virtual') if self.explicitSpec: if addSpace: signode += addnodes.desc_sig_space() self.explicitSpec.describe_signature(signode, env, symbol) addSpace = True if self.consteval: addSpace = _add(signode, 'consteval') if self.constexpr: addSpace = _add(signode, 'constexpr') if self.constinit: addSpace = _add(signode, 'constinit') if self.volatile: addSpace = _add(signode, 'volatile') if self.const: addSpace = _add(signode, 'const') class ASTDeclSpecs(ASTBase): def __init__(self, outer: str, leftSpecs: ASTDeclSpecsSimple, rightSpecs: ASTDeclSpecsSimple, trailing: ASTTrailingTypeSpec) -> None: # leftSpecs and rightSpecs are used for output # allSpecs are used for id generation self.outer = outer self.leftSpecs = leftSpecs self.rightSpecs = rightSpecs self.allSpecs = self.leftSpecs.mergeWith(self.rightSpecs) self.trailingTypeSpec = trailing def get_id(self, version: int) -> str: if version == 1: res = [] res.append(self.trailingTypeSpec.get_id(version)) if self.allSpecs.volatile: res.append('V') if self.allSpecs.const: res.append('C') return ''.join(res) res = [] if self.allSpecs.volatile: res.append('V') if self.allSpecs.const: res.append('K') if self.trailingTypeSpec is not None: res.append(self.trailingTypeSpec.get_id(version)) return ''.join(res) def _stringify(self, transform: StringifyTransform) -> str: res: List[str] = [] l = transform(self.leftSpecs) if len(l) > 0: res.append(l) if self.trailingTypeSpec: if len(res) > 0: res.append(" ") res.append(transform(self.trailingTypeSpec)) r = str(self.rightSpecs) if len(r) > 0: if len(res) > 0: res.append(" ") res.append(r) return "".join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) numChildren = len(signode) self.leftSpecs.describe_signature(signode, env, symbol) addSpace = len(signode) != numChildren if self.trailingTypeSpec: if addSpace: signode += addnodes.desc_sig_space() numChildren = len(signode) self.trailingTypeSpec.describe_signature(signode, mode, env, symbol=symbol) addSpace = len(signode) != numChildren if len(str(self.rightSpecs)) > 0: if addSpace: signode += addnodes.desc_sig_space() self.rightSpecs.describe_signature(signode, env, symbol) # Declarator ################################################################################ class ASTArray(ASTBase): def __init__(self, size: ASTExpression): self.size = size def _stringify(self, transform: StringifyTransform) -> str: if self.size: return '[' + transform(self.size) + ']' else: return '[]' def get_id(self, version: int) -> str: if version == 1: return 'A' if version == 2: if self.size: return 'A' + str(self.size) + '_' else: return 'A_' if self.size: return 'A' + self.size.get_id(version) + '_' else: return 'A_' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) signode += addnodes.desc_sig_punctuation('[', '[') if self.size: self.size.describe_signature(signode, 'markType', env, symbol) signode += addnodes.desc_sig_punctuation(']', ']') class ASTDeclarator(ASTBase): @property def name(self) -> ASTNestedName: raise NotImplementedError(repr(self)) @name.setter def name(self, name: ASTNestedName) -> None: raise NotImplementedError(repr(self)) @property def isPack(self) -> bool: raise NotImplementedError(repr(self)) @property def function_params(self) -> List[ASTFunctionParameter]: raise NotImplementedError(repr(self)) @property def trailingReturn(self) -> "ASTType": raise NotImplementedError(repr(self)) def require_space_after_declSpecs(self) -> bool: raise NotImplementedError(repr(self)) def get_modifiers_id(self, version: int) -> str: raise NotImplementedError(repr(self)) def get_param_id(self, version: int) -> str: raise NotImplementedError(repr(self)) def get_ptr_suffix_id(self, version: int) -> str: raise NotImplementedError(repr(self)) def get_type_id(self, version: int, returnTypeId: str) -> str: raise NotImplementedError(repr(self)) def is_function_type(self) -> bool: raise NotImplementedError(repr(self)) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: raise NotImplementedError(repr(self)) class ASTDeclaratorNameParamQual(ASTDeclarator): def __init__(self, declId: ASTNestedName, arrayOps: List[ASTArray], paramQual: ASTParametersQualifiers) -> None: self.declId = declId self.arrayOps = arrayOps self.paramQual = paramQual @property def name(self) -> ASTNestedName: return self.declId @name.setter def name(self, name: ASTNestedName) -> None: self.declId = name @property def isPack(self) -> bool: return False @property def function_params(self) -> List[ASTFunctionParameter]: return self.paramQual.function_params @property def trailingReturn(self) -> "ASTType": return self.paramQual.trailingReturn # only the modifiers for a function, e.g., def get_modifiers_id(self, version: int) -> str: # cv-qualifiers if self.paramQual: return self.paramQual.get_modifiers_id(version) raise Exception("This should only be called on a function: %s" % self) def get_param_id(self, version: int) -> str: # only the parameters (if any) if self.paramQual: return self.paramQual.get_param_id(version) else: return '' def get_ptr_suffix_id(self, version: int) -> str: # only the array specifiers return ''.join(a.get_id(version) for a in self.arrayOps) def get_type_id(self, version: int, returnTypeId: str) -> str: assert version >= 2 res = [] # TODO: can we actually have both array ops and paramQual? res.append(self.get_ptr_suffix_id(version)) if self.paramQual: res.append(self.get_modifiers_id(version)) res.append('F') res.append(returnTypeId) res.append(self.get_param_id(version)) res.append('E') else: res.append(returnTypeId) return ''.join(res) # ------------------------------------------------------------------------ def require_space_after_declSpecs(self) -> bool: return self.declId is not None def is_function_type(self) -> bool: return self.paramQual is not None def _stringify(self, transform: StringifyTransform) -> str: res = [] if self.declId: res.append(transform(self.declId)) for op in self.arrayOps: res.append(transform(op)) if self.paramQual: res.append(transform(self.paramQual)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) if self.declId: self.declId.describe_signature(signode, mode, env, symbol) for op in self.arrayOps: op.describe_signature(signode, mode, env, symbol) if self.paramQual: self.paramQual.describe_signature(signode, mode, env, symbol) class ASTDeclaratorNameBitField(ASTDeclarator): def __init__(self, declId: ASTNestedName, size: ASTExpression): self.declId = declId self.size = size @property def name(self) -> ASTNestedName: return self.declId @name.setter def name(self, name: ASTNestedName) -> None: self.declId = name def get_param_id(self, version: int) -> str: # only the parameters (if any) return '' def get_ptr_suffix_id(self, version: int) -> str: # only the array specifiers return '' # ------------------------------------------------------------------------ def require_space_after_declSpecs(self) -> bool: return self.declId is not None def is_function_type(self) -> bool: return False def _stringify(self, transform: StringifyTransform) -> str: res = [] if self.declId: res.append(transform(self.declId)) res.append(" : ") res.append(transform(self.size)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) if self.declId: self.declId.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_punctuation(':', ':') signode += addnodes.desc_sig_space() self.size.describe_signature(signode, mode, env, symbol) class ASTDeclaratorPtr(ASTDeclarator): def __init__(self, next: ASTDeclarator, volatile: bool, const: bool, attrs: List[ASTAttribute]) -> None: assert next self.next = next self.volatile = volatile self.const = const self.attrs = attrs @property def name(self) -> ASTNestedName: return self.next.name @name.setter def name(self, name: ASTNestedName) -> None: self.next.name = name @property def function_params(self) -> List[ASTFunctionParameter]: return self.next.function_params @property def trailingReturn(self) -> "ASTType": return self.next.trailingReturn def require_space_after_declSpecs(self) -> bool: return self.next.require_space_after_declSpecs() def _stringify(self, transform: StringifyTransform) -> str: res = ['*'] for a in self.attrs: res.append(transform(a)) if len(self.attrs) > 0 and (self.volatile or self.const): res.append(' ') if self.volatile: res.append('volatile') if self.const: if self.volatile: res.append(' ') res.append('const') if self.const or self.volatile or len(self.attrs) > 0: if self.next.require_space_after_declSpecs(): res.append(' ') res.append(transform(self.next)) return ''.join(res) def get_modifiers_id(self, version: int) -> str: return self.next.get_modifiers_id(version) def get_param_id(self, version: int) -> str: return self.next.get_param_id(version) def get_ptr_suffix_id(self, version: int) -> str: if version == 1: res = ['P'] if self.volatile: res.append('V') if self.const: res.append('C') res.append(self.next.get_ptr_suffix_id(version)) return ''.join(res) res = [self.next.get_ptr_suffix_id(version)] res.append('P') if self.volatile: res.append('V') if self.const: res.append('C') return ''.join(res) def get_type_id(self, version: int, returnTypeId: str) -> str: # ReturnType *next, so we are part of the return type of 'next res = ['P'] if self.volatile: res.append('V') if self.const: res.append('C') res.append(returnTypeId) return self.next.get_type_id(version, returnTypeId=''.join(res)) def is_function_type(self) -> bool: return self.next.is_function_type() def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) signode += addnodes.desc_sig_punctuation('*', '*') for a in self.attrs: a.describe_signature(signode) if len(self.attrs) > 0 and (self.volatile or self.const): signode += addnodes.desc_sig_space() def _add_anno(signode: TextElement, text: str) -> None: signode += addnodes.desc_sig_keyword(text, text) if self.volatile: _add_anno(signode, 'volatile') if self.const: if self.volatile: signode += addnodes.desc_sig_space() _add_anno(signode, 'const') if self.const or self.volatile or len(self.attrs) > 0: if self.next.require_space_after_declSpecs(): signode += addnodes.desc_sig_space() self.next.describe_signature(signode, mode, env, symbol) class ASTDeclaratorRef(ASTDeclarator): def __init__(self, next: ASTDeclarator, attrs: List[ASTAttribute]) -> None: assert next self.next = next self.attrs = attrs @property def name(self) -> ASTNestedName: return self.next.name @name.setter def name(self, name: ASTNestedName) -> None: self.next.name = name @property def isPack(self) -> bool: return True @property def function_params(self) -> List[ASTFunctionParameter]: return self.next.function_params @property def trailingReturn(self) -> "ASTType": return self.next.trailingReturn def require_space_after_declSpecs(self) -> bool: return self.next.require_space_after_declSpecs() def _stringify(self, transform: StringifyTransform) -> str: res = ['&'] for a in self.attrs: res.append(transform(a)) if len(self.attrs) > 0 and self.next.require_space_after_declSpecs(): res.append(' ') res.append(transform(self.next)) return ''.join(res) def get_modifiers_id(self, version: int) -> str: return self.next.get_modifiers_id(version) def get_param_id(self, version: int) -> str: # only the parameters (if any) return self.next.get_param_id(version) def get_ptr_suffix_id(self, version: int) -> str: if version == 1: return 'R' + self.next.get_ptr_suffix_id(version) else: return self.next.get_ptr_suffix_id(version) + 'R' def get_type_id(self, version: int, returnTypeId: str) -> str: assert version >= 2 # ReturnType &next, so we are part of the return type of 'next return self.next.get_type_id(version, returnTypeId='R' + returnTypeId) def is_function_type(self) -> bool: return self.next.is_function_type() def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) signode += addnodes.desc_sig_punctuation('&', '&') for a in self.attrs: a.describe_signature(signode) if len(self.attrs) > 0 and self.next.require_space_after_declSpecs(): signode += addnodes.desc_sig_space() self.next.describe_signature(signode, mode, env, symbol) class ASTDeclaratorParamPack(ASTDeclarator): def __init__(self, next: ASTDeclarator) -> None: assert next self.next = next @property def name(self) -> ASTNestedName: return self.next.name @name.setter def name(self, name: ASTNestedName) -> None: self.next.name = name @property def function_params(self) -> List[ASTFunctionParameter]: return self.next.function_params @property def trailingReturn(self) -> "ASTType": return self.next.trailingReturn def require_space_after_declSpecs(self) -> bool: return False def _stringify(self, transform: StringifyTransform) -> str: res = transform(self.next) if self.next.name: res = ' ' + res return '...' + res def get_modifiers_id(self, version: int) -> str: return self.next.get_modifiers_id(version) def get_param_id(self, version: int) -> str: # only the parameters (if any) return self.next.get_param_id(version) def get_ptr_suffix_id(self, version: int) -> str: if version == 1: return 'Dp' + self.next.get_ptr_suffix_id(version) else: return self.next.get_ptr_suffix_id(version) + 'Dp' def get_type_id(self, version: int, returnTypeId: str) -> str: assert version >= 2 # ReturnType... next, so we are part of the return type of 'next return self.next.get_type_id(version, returnTypeId='Dp' + returnTypeId) def is_function_type(self) -> bool: return self.next.is_function_type() def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) signode += addnodes.desc_sig_punctuation('...', '...') if self.next.name: signode += addnodes.desc_sig_space() self.next.describe_signature(signode, mode, env, symbol) class ASTDeclaratorMemPtr(ASTDeclarator): def __init__(self, className: ASTNestedName, const: bool, volatile: bool, next: ASTDeclarator) -> None: assert className assert next self.className = className self.const = const self.volatile = volatile self.next = next @property def name(self) -> ASTNestedName: return self.next.name @name.setter def name(self, name: ASTNestedName) -> None: self.next.name = name @property def function_params(self) -> List[ASTFunctionParameter]: return self.next.function_params @property def trailingReturn(self) -> "ASTType": return self.next.trailingReturn def require_space_after_declSpecs(self) -> bool: return True def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append(transform(self.className)) res.append('::*') if self.volatile: res.append('volatile') if self.const: if self.volatile: res.append(' ') res.append('const') if self.next.require_space_after_declSpecs(): res.append(' ') res.append(transform(self.next)) return ''.join(res) def get_modifiers_id(self, version: int) -> str: if version == 1: raise NoOldIdError() else: return self.next.get_modifiers_id(version) def get_param_id(self, version: int) -> str: # only the parameters (if any) if version == 1: raise NoOldIdError() else: return self.next.get_param_id(version) def get_ptr_suffix_id(self, version: int) -> str: if version == 1: raise NoOldIdError() else: raise NotImplementedError() return self.next.get_ptr_suffix_id(version) + 'Dp' def get_type_id(self, version: int, returnTypeId: str) -> str: assert version >= 2 # ReturnType name::* next, so we are part of the return type of next nextReturnTypeId = '' if self.volatile: nextReturnTypeId += 'V' if self.const: nextReturnTypeId += 'K' nextReturnTypeId += 'M' nextReturnTypeId += self.className.get_id(version) nextReturnTypeId += returnTypeId return self.next.get_type_id(version, nextReturnTypeId) def is_function_type(self) -> bool: return self.next.is_function_type() def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.className.describe_signature(signode, 'markType', env, symbol) signode += addnodes.desc_sig_punctuation('::', '::') signode += addnodes.desc_sig_punctuation('*', '*') def _add_anno(signode: TextElement, text: str) -> None: signode += addnodes.desc_sig_keyword(text, text) if self.volatile: _add_anno(signode, 'volatile') if self.const: if self.volatile: signode += addnodes.desc_sig_space() _add_anno(signode, 'const') if self.next.require_space_after_declSpecs(): signode += addnodes.desc_sig_space() self.next.describe_signature(signode, mode, env, symbol) class ASTDeclaratorParen(ASTDeclarator): def __init__(self, inner: ASTDeclarator, next: ASTDeclarator) -> None: assert inner assert next self.inner = inner self.next = next # TODO: we assume the name, params, and qualifiers are in inner @property def name(self) -> ASTNestedName: return self.inner.name @name.setter def name(self, name: ASTNestedName) -> None: self.inner.name = name @property def function_params(self) -> List[ASTFunctionParameter]: return self.inner.function_params @property def trailingReturn(self) -> "ASTType": return self.inner.trailingReturn def require_space_after_declSpecs(self) -> bool: return True def _stringify(self, transform: StringifyTransform) -> str: res = ['('] res.append(transform(self.inner)) res.append(')') res.append(transform(self.next)) return ''.join(res) def get_modifiers_id(self, version: int) -> str: return self.inner.get_modifiers_id(version) def get_param_id(self, version: int) -> str: # only the parameters (if any) return self.inner.get_param_id(version) def get_ptr_suffix_id(self, version: int) -> str: if version == 1: raise NoOldIdError() # TODO: was this implemented before? return self.next.get_ptr_suffix_id(version) + \ self.inner.get_ptr_suffix_id(version) else: return self.inner.get_ptr_suffix_id(version) + \ self.next.get_ptr_suffix_id(version) def get_type_id(self, version: int, returnTypeId: str) -> str: assert version >= 2 # ReturnType (inner)next, so 'inner' returns everything outside nextId = self.next.get_type_id(version, returnTypeId) return self.inner.get_type_id(version, returnTypeId=nextId) def is_function_type(self) -> bool: return self.inner.is_function_type() def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) signode += addnodes.desc_sig_punctuation('(', '(') self.inner.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') self.next.describe_signature(signode, "noneIsName", env, symbol) # Type and initializer stuff ############################################################################################## class ASTPackExpansionExpr(ASTExpression): def __init__(self, expr: Union[ASTExpression, ASTBracedInitList]): self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: return transform(self.expr) + '...' def get_id(self, version: int) -> str: id = self.expr.get_id(version) return 'sp' + id def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.expr.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation('...', '...') class ASTParenExprList(ASTBaseParenExprList): def __init__(self, exprs: List[Union[ASTExpression, ASTBracedInitList]]) -> None: self.exprs = exprs def get_id(self, version: int) -> str: return "pi%sE" % ''.join(e.get_id(version) for e in self.exprs) def _stringify(self, transform: StringifyTransform) -> str: exprs = [transform(e) for e in self.exprs] return '(%s)' % ', '.join(exprs) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) signode += addnodes.desc_sig_punctuation('(', '(') first = True for e in self.exprs: if not first: signode += addnodes.desc_sig_punctuation(',', ',') signode += addnodes.desc_sig_space() else: first = False e.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation(')', ')') class ASTInitializer(ASTBase): def __init__(self, value: Union[ASTExpression, ASTBracedInitList], hasAssign: bool = True) -> None: self.value = value self.hasAssign = hasAssign def _stringify(self, transform: StringifyTransform) -> str: val = transform(self.value) if self.hasAssign: return ' = ' + val else: return val def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) if self.hasAssign: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_punctuation('=', '=') signode += addnodes.desc_sig_space() self.value.describe_signature(signode, 'markType', env, symbol) class ASTType(ASTBase): def __init__(self, declSpecs: ASTDeclSpecs, decl: ASTDeclarator) -> None: assert declSpecs assert decl self.declSpecs = declSpecs self.decl = decl @property def name(self) -> ASTNestedName: return self.decl.name @name.setter def name(self, name: ASTNestedName) -> None: self.decl.name = name @property def isPack(self) -> bool: return self.decl.isPack @property def function_params(self) -> List[ASTFunctionParameter]: return self.decl.function_params @property def trailingReturn(self) -> "ASTType": return self.decl.trailingReturn def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str: if version == 1: res = [] if objectType: # needs the name if objectType == 'function': # also modifiers res.append(symbol.get_full_nested_name().get_id(version)) res.append(self.decl.get_param_id(version)) res.append(self.decl.get_modifiers_id(version)) if (self.declSpecs.leftSpecs.constexpr or (self.declSpecs.rightSpecs and self.declSpecs.rightSpecs.constexpr)): res.append('CE') elif objectType == 'type': # just the name res.append(symbol.get_full_nested_name().get_id(version)) else: print(objectType) assert False else: # only type encoding if self.decl.is_function_type(): raise NoOldIdError() res.append(self.declSpecs.get_id(version)) res.append(self.decl.get_ptr_suffix_id(version)) res.append(self.decl.get_param_id(version)) return ''.join(res) # other versions res = [] if objectType: # needs the name if objectType == 'function': # also modifiers modifiers = self.decl.get_modifiers_id(version) res.append(symbol.get_full_nested_name().get_id(version, modifiers)) if version >= 4: # with templates we need to mangle the return type in as well templ = symbol.declaration.templatePrefix if templ is not None: typeId = self.decl.get_ptr_suffix_id(version) if self.trailingReturn: returnTypeId = self.trailingReturn.get_id(version) else: returnTypeId = self.declSpecs.get_id(version) res.append(typeId) res.append(returnTypeId) res.append(self.decl.get_param_id(version)) elif objectType == 'type': # just the name res.append(symbol.get_full_nested_name().get_id(version)) else: print(objectType) assert False else: # only type encoding # the 'returnType' of a non-function type is simply just the last # type, i.e., for 'int*' it is 'int' returnTypeId = self.declSpecs.get_id(version) typeId = self.decl.get_type_id(version, returnTypeId) res.append(typeId) return ''.join(res) def _stringify(self, transform: StringifyTransform) -> str: res = [] declSpecs = transform(self.declSpecs) res.append(declSpecs) if self.decl.require_space_after_declSpecs() and len(declSpecs) > 0: res.append(' ') res.append(transform(self.decl)) return ''.join(res) def get_type_declaration_prefix(self) -> str: if self.declSpecs.trailingTypeSpec: return 'typedef' else: return 'type' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.declSpecs.describe_signature(signode, 'markType', env, symbol) if (self.decl.require_space_after_declSpecs() and len(str(self.declSpecs)) > 0): signode += addnodes.desc_sig_space() # for parameters that don't really declare new names we get 'markType', # this should not be propagated, but be 'noneIsName'. if mode == 'markType': mode = 'noneIsName' self.decl.describe_signature(signode, mode, env, symbol) class ASTTemplateParamConstrainedTypeWithInit(ASTBase): def __init__(self, type: ASTType, init: ASTType) -> None: assert type self.type = type self.init = init @property def name(self) -> ASTNestedName: return self.type.name @property def isPack(self) -> bool: return self.type.isPack def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str: # this is not part of the normal name mangling in C++ assert version >= 2 if symbol: # the anchor will be our parent return symbol.parent.declaration.get_id(version, prefixed=False) else: return self.type.get_id(version) def _stringify(self, transform: StringifyTransform) -> str: res = transform(self.type) if self.init: res += " = " res += transform(self.init) return res def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.type.describe_signature(signode, mode, env, symbol) if self.init: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_punctuation('=', '=') signode += addnodes.desc_sig_space() self.init.describe_signature(signode, mode, env, symbol) class ASTTypeWithInit(ASTBase): def __init__(self, type: ASTType, init: ASTInitializer) -> None: self.type = type self.init = init @property def name(self) -> ASTNestedName: return self.type.name @property def isPack(self) -> bool: return self.type.isPack def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str: if objectType != 'member': return self.type.get_id(version, objectType) if version == 1: return (symbol.get_full_nested_name().get_id(version) + '__' + self.type.get_id(version)) return symbol.get_full_nested_name().get_id(version) def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append(transform(self.type)) if self.init: res.append(transform(self.init)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.type.describe_signature(signode, mode, env, symbol) if self.init: self.init.describe_signature(signode, mode, env, symbol) class ASTTypeUsing(ASTBase): def __init__(self, name: ASTNestedName, type: ASTType) -> None: self.name = name self.type = type def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str: if version == 1: raise NoOldIdError() return symbol.get_full_nested_name().get_id(version) def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append(transform(self.name)) if self.type: res.append(' = ') res.append(transform(self.type)) return ''.join(res) def get_type_declaration_prefix(self) -> str: return 'using' def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.name.describe_signature(signode, mode, env, symbol=symbol) if self.type: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_punctuation('=', '=') signode += addnodes.desc_sig_space() self.type.describe_signature(signode, 'markType', env, symbol=symbol) # Other declarations ############################################################################################## class ASTConcept(ASTBase): def __init__(self, nestedName: ASTNestedName, initializer: ASTInitializer) -> None: self.nestedName = nestedName self.initializer = initializer @property def name(self) -> ASTNestedName: return self.nestedName def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str: if version == 1: raise NoOldIdError() return symbol.get_full_nested_name().get_id(version) def _stringify(self, transform: StringifyTransform) -> str: res = transform(self.nestedName) if self.initializer: res += transform(self.initializer) return res def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.nestedName.describe_signature(signode, mode, env, symbol) if self.initializer: self.initializer.describe_signature(signode, mode, env, symbol) class ASTBaseClass(ASTBase): def __init__(self, name: ASTNestedName, visibility: str, virtual: bool, pack: bool) -> None: self.name = name self.visibility = visibility self.virtual = virtual self.pack = pack def _stringify(self, transform: StringifyTransform) -> str: res = [] if self.visibility is not None: res.append(self.visibility) res.append(' ') if self.virtual: res.append('virtual ') res.append(transform(self.name)) if self.pack: res.append('...') return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) if self.visibility is not None: signode += addnodes.desc_sig_keyword(self.visibility, self.visibility) signode += addnodes.desc_sig_space() if self.virtual: signode += addnodes.desc_sig_keyword('virtual', 'virtual') signode += addnodes.desc_sig_space() self.name.describe_signature(signode, 'markType', env, symbol=symbol) if self.pack: signode += addnodes.desc_sig_punctuation('...', '...') class ASTClass(ASTBase): def __init__(self, name: ASTNestedName, final: bool, bases: List[ASTBaseClass]) -> None: self.name = name self.final = final self.bases = bases def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str: return symbol.get_full_nested_name().get_id(version) def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append(transform(self.name)) if self.final: res.append(' final') if len(self.bases) > 0: res.append(' : ') first = True for b in self.bases: if not first: res.append(', ') first = False res.append(transform(b)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.name.describe_signature(signode, mode, env, symbol=symbol) if self.final: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_keyword('final', 'final') if len(self.bases) > 0: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_punctuation(':', ':') signode += addnodes.desc_sig_space() for b in self.bases: b.describe_signature(signode, mode, env, symbol=symbol) signode += addnodes.desc_sig_punctuation(',', ',') signode += addnodes.desc_sig_space() signode.pop() signode.pop() class ASTUnion(ASTBase): def __init__(self, name: ASTNestedName) -> None: self.name = name def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str: if version == 1: raise NoOldIdError() return symbol.get_full_nested_name().get_id(version) def _stringify(self, transform: StringifyTransform) -> str: return transform(self.name) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.name.describe_signature(signode, mode, env, symbol=symbol) class ASTEnum(ASTBase): def __init__(self, name: ASTNestedName, scoped: str, underlyingType: ASTType) -> None: self.name = name self.scoped = scoped self.underlyingType = underlyingType def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str: if version == 1: raise NoOldIdError() return symbol.get_full_nested_name().get_id(version) def _stringify(self, transform: StringifyTransform) -> str: res = [] if self.scoped: res.append(self.scoped) res.append(' ') res.append(transform(self.name)) if self.underlyingType: res.append(' : ') res.append(transform(self.underlyingType)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) # self.scoped has been done by the CPPEnumObject self.name.describe_signature(signode, mode, env, symbol=symbol) if self.underlyingType: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_punctuation(':', ':') signode += addnodes.desc_sig_space() self.underlyingType.describe_signature(signode, 'noneIsName', env, symbol=symbol) class ASTEnumerator(ASTBase): def __init__(self, name: ASTNestedName, init: ASTInitializer) -> None: self.name = name self.init = init def get_id(self, version: int, objectType: str, symbol: "Symbol") -> str: if version == 1: raise NoOldIdError() return symbol.get_full_nested_name().get_id(version) def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append(transform(self.name)) if self.init: res.append(transform(self.init)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: verify_description_mode(mode) self.name.describe_signature(signode, mode, env, symbol) if self.init: self.init.describe_signature(signode, 'markType', env, symbol) ################################################################################ # Templates ################################################################################ # Parameters ################################################################################ class ASTTemplateParam(ASTBase): def get_identifier(self) -> ASTIdentifier: raise NotImplementedError(repr(self)) def get_id(self, version: int) -> str: raise NotImplementedError(repr(self)) def describe_signature(self, parentNode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: raise NotImplementedError(repr(self)) class ASTTemplateKeyParamPackIdDefault(ASTTemplateParam): def __init__(self, key: str, identifier: ASTIdentifier, parameterPack: bool, default: ASTType) -> None: assert key if parameterPack: assert default is None self.key = key self.identifier = identifier self.parameterPack = parameterPack self.default = default def get_identifier(self) -> ASTIdentifier: return self.identifier def get_id(self, version: int) -> str: assert version >= 2 # this is not part of the normal name mangling in C++ res = [] if self.parameterPack: res.append('Dp') else: res.append('0') # we need to put something return ''.join(res) def _stringify(self, transform: StringifyTransform) -> str: res = [self.key] if self.parameterPack: if self.identifier: res.append(' ') res.append('...') if self.identifier: if not self.parameterPack: res.append(' ') res.append(transform(self.identifier)) if self.default: res.append(' = ') res.append(transform(self.default)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword(self.key, self.key) if self.parameterPack: if self.identifier: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_punctuation('...', '...') if self.identifier: if not self.parameterPack: signode += addnodes.desc_sig_space() self.identifier.describe_signature(signode, mode, env, '', '', symbol) if self.default: signode += addnodes.desc_sig_space() signode += addnodes.desc_sig_punctuation('=', '=') signode += addnodes.desc_sig_space() self.default.describe_signature(signode, 'markType', env, symbol) class ASTTemplateParamType(ASTTemplateParam): def __init__(self, data: ASTTemplateKeyParamPackIdDefault) -> None: assert data self.data = data @property def name(self) -> ASTNestedName: id = self.get_identifier() return ASTNestedName([ASTNestedNameElement(id, None)], [False], rooted=False) @property def isPack(self) -> bool: return self.data.parameterPack def get_identifier(self) -> ASTIdentifier: return self.data.get_identifier() def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str: # this is not part of the normal name mangling in C++ assert version >= 2 if symbol: # the anchor will be our parent return symbol.parent.declaration.get_id(version, prefixed=False) else: return self.data.get_id(version) def _stringify(self, transform: StringifyTransform) -> str: return transform(self.data) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.data.describe_signature(signode, mode, env, symbol) class ASTTemplateParamTemplateType(ASTTemplateParam): def __init__(self, nestedParams: "ASTTemplateParams", data: ASTTemplateKeyParamPackIdDefault) -> None: assert nestedParams assert data self.nestedParams = nestedParams self.data = data @property def name(self) -> ASTNestedName: id = self.get_identifier() return ASTNestedName([ASTNestedNameElement(id, None)], [False], rooted=False) @property def isPack(self) -> bool: return self.data.parameterPack def get_identifier(self) -> ASTIdentifier: return self.data.get_identifier() def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str: assert version >= 2 # this is not part of the normal name mangling in C++ if symbol: # the anchor will be our parent return symbol.parent.declaration.get_id(version, prefixed=None) else: return self.nestedParams.get_id(version) + self.data.get_id(version) def _stringify(self, transform: StringifyTransform) -> str: return transform(self.nestedParams) + transform(self.data) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.nestedParams.describe_signature(signode, 'noneIsName', env, symbol) signode += addnodes.desc_sig_space() self.data.describe_signature(signode, mode, env, symbol) class ASTTemplateParamNonType(ASTTemplateParam): def __init__(self, param: Union[ASTTypeWithInit, ASTTemplateParamConstrainedTypeWithInit]) -> None: assert param self.param = param @property def name(self) -> ASTNestedName: id = self.get_identifier() return ASTNestedName([ASTNestedNameElement(id, None)], [False], rooted=False) @property def isPack(self) -> bool: return self.param.isPack def get_identifier(self) -> ASTIdentifier: name = self.param.name if name: assert len(name.names) == 1 assert name.names[0].identOrOp assert not name.names[0].templateArgs res = name.names[0].identOrOp assert isinstance(res, ASTIdentifier) return res else: return None def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str: assert version >= 2 # this is not part of the normal name mangling in C++ if symbol: # the anchor will be our parent return symbol.parent.declaration.get_id(version, prefixed=None) else: return '_' + self.param.get_id(version) def _stringify(self, transform: StringifyTransform) -> str: return transform(self.param) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: self.param.describe_signature(signode, mode, env, symbol) class ASTTemplateParams(ASTBase): def __init__(self, params: List[ASTTemplateParam]) -> None: assert params is not None self.params = params def get_id(self, version: int) -> str: assert version >= 2 res = [] res.append("I") for param in self.params: res.append(param.get_id(version)) res.append("E") return ''.join(res) def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append("template<") res.append(", ".join(transform(a) for a in self.params)) res.append("> ") return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('template', 'template') signode += addnodes.desc_sig_punctuation('<', '<') first = True for param in self.params: if not first: signode += addnodes.desc_sig_punctuation(',', ',') signode += addnodes.desc_sig_space() first = False param.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation('>', '>') def describe_signature_as_introducer( self, parentNode: desc_signature, mode: str, env: "BuildEnvironment", symbol: "Symbol", lineSpec: bool) -> None: def makeLine(parentNode: desc_signature) -> addnodes.desc_signature_line: signode = addnodes.desc_signature_line() parentNode += signode signode.sphinx_line_type = 'templateParams' return signode lineNode = makeLine(parentNode) lineNode += addnodes.desc_sig_keyword('template', 'template') lineNode += addnodes.desc_sig_punctuation('<', '<') first = True for param in self.params: if not first: lineNode += addnodes.desc_sig_punctuation(',', ',') lineNode += addnodes.desc_sig_space() first = False if lineSpec: lineNode = makeLine(parentNode) param.describe_signature(lineNode, mode, env, symbol) if lineSpec and not first: lineNode = makeLine(parentNode) lineNode += addnodes.desc_sig_punctuation('>', '>') # Template introducers ################################################################################ class ASTTemplateIntroductionParameter(ASTBase): def __init__(self, identifier: ASTIdentifier, parameterPack: bool) -> None: self.identifier = identifier self.parameterPack = parameterPack @property def name(self) -> ASTNestedName: id = self.get_identifier() return ASTNestedName([ASTNestedNameElement(id, None)], [False], rooted=False) @property def isPack(self) -> bool: return self.parameterPack def get_identifier(self) -> ASTIdentifier: return self.identifier def get_id(self, version: int, objectType: str = None, symbol: "Symbol" = None) -> str: assert version >= 2 # this is not part of the normal name mangling in C++ if symbol: # the anchor will be our parent return symbol.parent.declaration.get_id(version, prefixed=None) else: if self.parameterPack: return 'Dp' else: return '0' # we need to put something def get_id_as_arg(self, version: int) -> str: assert version >= 2 # used for the implicit requires clause res = self.identifier.get_id(version) if self.parameterPack: return 'sp' + res else: return res def _stringify(self, transform: StringifyTransform) -> str: res = [] if self.parameterPack: res.append('...') res.append(transform(self.identifier)) return ''.join(res) def describe_signature(self, signode: TextElement, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: if self.parameterPack: signode += addnodes.desc_sig_punctuation('...', '...') self.identifier.describe_signature(signode, mode, env, '', '', symbol) class ASTTemplateIntroduction(ASTBase): def __init__(self, concept: ASTNestedName, params: List[ASTTemplateIntroductionParameter]) -> None: assert len(params) > 0 self.concept = concept self.params = params def get_id(self, version: int) -> str: assert version >= 2 # first do the same as a normal template parameter list res = [] res.append("I") for param in self.params: res.append(param.get_id(version)) res.append("E") # let's use X expr E, which is otherwise for constant template args res.append("X") res.append(self.concept.get_id(version)) res.append("I") for param in self.params: res.append(param.get_id_as_arg(version)) res.append("E") res.append("E") return ''.join(res) def _stringify(self, transform: StringifyTransform) -> str: res = [] res.append(transform(self.concept)) res.append('{') res.append(', '.join(transform(param) for param in self.params)) res.append('} ') return ''.join(res) def describe_signature_as_introducer( self, parentNode: desc_signature, mode: str, env: "BuildEnvironment", symbol: "Symbol", lineSpec: bool) -> None: # Note: 'lineSpec' has no effect on template introductions. signode = addnodes.desc_signature_line() parentNode += signode signode.sphinx_line_type = 'templateIntroduction' self.concept.describe_signature(signode, 'markType', env, symbol) signode += addnodes.desc_sig_punctuation('{', '{') first = True for param in self.params: if not first: signode += addnodes.desc_sig_punctuation(',', ',') signode += addnodes.desc_sig_space() first = False param.describe_signature(signode, mode, env, symbol) signode += addnodes.desc_sig_punctuation('}', '}') ################################################################################ class ASTTemplateDeclarationPrefix(ASTBase): def __init__(self, templates: List[Union[ASTTemplateParams, ASTTemplateIntroduction]]) -> None: # templates is None means it's an explicit instantiation of a variable self.templates = templates def get_id(self, version: int) -> str: assert version >= 2 # this is not part of a normal name mangling system res = [] for t in self.templates: res.append(t.get_id(version)) return ''.join(res) def _stringify(self, transform: StringifyTransform) -> str: res = [] for t in self.templates: res.append(transform(t)) return ''.join(res) def describe_signature(self, signode: desc_signature, mode: str, env: "BuildEnvironment", symbol: "Symbol", lineSpec: bool) -> None: verify_description_mode(mode) for t in self.templates: t.describe_signature_as_introducer(signode, 'lastIsName', env, symbol, lineSpec) class ASTRequiresClause(ASTBase): def __init__(self, expr: ASTExpression) -> None: self.expr = expr def _stringify(self, transform: StringifyTransform) -> str: return 'requires ' + transform(self.expr) def describe_signature(self, signode: addnodes.desc_signature_line, mode: str, env: "BuildEnvironment", symbol: "Symbol") -> None: signode += addnodes.desc_sig_keyword('requires', 'requires') signode += addnodes.desc_sig_space() self.expr.describe_signature(signode, mode, env, symbol) ################################################################################ ################################################################################ class ASTDeclaration(ASTBase): def __init__(self, objectType: str, directiveType: str, visibility: str, templatePrefix: ASTTemplateDeclarationPrefix, requiresClause: ASTRequiresClause, declaration: Any, trailingRequiresClause: ASTRequiresClause, semicolon: bool = False) -> None: self.objectType = objectType self.directiveType = directiveType self.visibility = visibility self.templatePrefix = templatePrefix self.requiresClause = requiresClause self.declaration = declaration self.trailingRequiresClause = trailingRequiresClause self.semicolon = semicolon self.symbol: Symbol = None # set by CPPObject._add_enumerator_to_parent self.enumeratorScopedSymbol: Symbol = None def clone(self) -> "ASTDeclaration": templatePrefixClone = self.templatePrefix.clone() if self.templatePrefix else None requiresClasueClone = self.requiresClause.clone() if self.requiresClause else None trailingRequiresClasueClone = self.trailingRequiresClause.clone() \ if self.trailingRequiresClause else None return ASTDeclaration(self.objectType, self.directiveType, self.visibility, templatePrefixClone, requiresClasueClone, self.declaration.clone(), trailingRequiresClasueClone, self.semicolon) @property def name(self) -> ASTNestedName: return self.declaration.name @property def function_params(self) -> List[ASTFunctionParameter]: if self.objectType != 'function': return None return self.declaration.function_params def get_id(self, version: int, prefixed: bool = True) -> str: if version == 1: if self.templatePrefix: raise NoOldIdError() if self.objectType == 'enumerator' and self.enumeratorScopedSymbol: return self.enumeratorScopedSymbol.declaration.get_id(version) return self.declaration.get_id(version, self.objectType, self.symbol) # version >= 2 if self.objectType == 'enumerator' and self.enumeratorScopedSymbol: return self.enumeratorScopedSymbol.declaration.get_id(version, prefixed) if prefixed: res = [_id_prefix[version]] else: res = [] if self.templatePrefix: res.append(self.templatePrefix.get_id(version)) if self.requiresClause or self.trailingRequiresClause: if version < 4: raise NoOldIdError() res.append('IQ') if self.requiresClause and self.trailingRequiresClause: res.append('aa') if self.requiresClause: res.append(self.requiresClause.expr.get_id(version)) if self.trailingRequiresClause: res.append(self.trailingRequiresClause.expr.get_id(version)) res.append('E') res.append(self.declaration.get_id(version, self.objectType, self.symbol)) return ''.join(res) def get_newest_id(self) -> str: return self.get_id(_max_id, True) def _stringify(self, transform: StringifyTransform) -> str: res = [] if self.visibility and self.visibility != "public": res.append(self.visibility) res.append(' ') if self.templatePrefix: res.append(transform(self.templatePrefix)) if self.requiresClause: res.append(transform(self.requiresClause)) res.append(' ') res.append(transform(self.declaration)) if self.trailingRequiresClause: res.append(' ') res.append(transform(self.trailingRequiresClause)) if self.semicolon: res.append(';') return ''.join(res) def describe_signature(self, signode: desc_signature, mode: str, env: "BuildEnvironment", options: Dict) -> None: verify_description_mode(mode) assert self.symbol # The caller of the domain added a desc_signature node. # Always enable multiline: signode['is_multiline'] = True # Put each line in a desc_signature_line node. mainDeclNode = addnodes.desc_signature_line() mainDeclNode.sphinx_line_type = 'declarator' mainDeclNode['add_permalink'] = not self.symbol.isRedeclaration if self.templatePrefix: self.templatePrefix.describe_signature(signode, mode, env, symbol=self.symbol, lineSpec=options.get('tparam-line-spec')) if self.requiresClause: reqNode = addnodes.desc_signature_line() reqNode.sphinx_line_type = 'requiresClause' signode.append(reqNode) self.requiresClause.describe_signature(reqNode, 'markType', env, self.symbol) signode += mainDeclNode if self.visibility and self.visibility != "public": mainDeclNode += addnodes.desc_sig_keyword(self.visibility, self.visibility) mainDeclNode += addnodes.desc_sig_space() if self.objectType == 'type': prefix = self.declaration.get_type_declaration_prefix() mainDeclNode += addnodes.desc_sig_keyword(prefix, prefix) mainDeclNode += addnodes.desc_sig_space() elif self.objectType == 'concept': mainDeclNode += addnodes.desc_sig_keyword('concept', 'concept') mainDeclNode += addnodes.desc_sig_space() elif self.objectType == 'member': pass elif self.objectType == 'function': pass elif self.objectType == 'class': assert self.directiveType in ('class', 'struct') mainDeclNode += addnodes.desc_sig_keyword(self.directiveType, self.directiveType) mainDeclNode += addnodes.desc_sig_space() elif self.objectType == 'union': mainDeclNode += addnodes.desc_sig_keyword('union', 'union') mainDeclNode += addnodes.desc_sig_space() elif self.objectType == 'enum': mainDeclNode += addnodes.desc_sig_keyword('enum', 'enum') mainDeclNode += addnodes.desc_sig_space() if self.directiveType == 'enum-class': mainDeclNode += addnodes.desc_sig_keyword('class', 'class') mainDeclNode += addnodes.desc_sig_space() elif self.directiveType == 'enum-struct': mainDeclNode += addnodes.desc_sig_keyword('struct', 'struct') mainDeclNode += addnodes.desc_sig_space() else: assert self.directiveType == 'enum', self.directiveType elif self.objectType == 'enumerator': mainDeclNode += addnodes.desc_sig_keyword('enumerator', 'enumerator') mainDeclNode += addnodes.desc_sig_space() else: assert False, self.objectType self.declaration.describe_signature(mainDeclNode, mode, env, self.symbol) lastDeclNode = mainDeclNode if self.trailingRequiresClause: trailingReqNode = addnodes.desc_signature_line() trailingReqNode.sphinx_line_type = 'trailingRequiresClause' signode.append(trailingReqNode) lastDeclNode = trailingReqNode self.trailingRequiresClause.describe_signature( trailingReqNode, 'markType', env, self.symbol) if self.semicolon: lastDeclNode += addnodes.desc_sig_punctuation(';', ';') class ASTNamespace(ASTBase): def __init__(self, nestedName: ASTNestedName, templatePrefix: ASTTemplateDeclarationPrefix) -> None: self.nestedName = nestedName self.templatePrefix = templatePrefix def _stringify(self, transform: StringifyTransform) -> str: res = [] if self.templatePrefix: res.append(transform(self.templatePrefix)) res.append(transform(self.nestedName)) return ''.join(res) class SymbolLookupResult: def __init__(self, symbols: Iterator["Symbol"], parentSymbol: "Symbol", identOrOp: Union[ASTIdentifier, ASTOperator], templateParams: Any, templateArgs: ASTTemplateArgs) -> None: self.symbols = symbols self.parentSymbol = parentSymbol self.identOrOp = identOrOp self.templateParams = templateParams self.templateArgs = templateArgs class LookupKey: def __init__(self, data: List[Tuple[ASTNestedNameElement, Union[ASTTemplateParams, ASTTemplateIntroduction], str]]) -> None: self.data = data class Symbol: debug_indent = 0 debug_indent_string = " " debug_lookup = False # overridden by the corresponding config value debug_show_tree = False # overridden by the corresponding config value def __copy__(self): assert False # shouldn't happen def __deepcopy__(self, memo): if self.parent: assert False # shouldn't happen else: # the domain base class makes a copy of the initial data, which is fine return Symbol(None, None, None, None, None, None, None) @staticmethod def debug_print(*args: Any) -> None: print(Symbol.debug_indent_string * Symbol.debug_indent, end="") print(*args) def _assert_invariants(self) -> None: if not self.parent: # parent == None means global scope, so declaration means a parent assert not self.identOrOp assert not self.templateParams assert not self.templateArgs assert not self.declaration assert not self.docname else: if self.declaration: assert self.docname def __setattr__(self, key: str, value: Any) -> None: if key == "children": assert False else: return super().__setattr__(key, value) def __init__(self, parent: "Symbol", identOrOp: Union[ASTIdentifier, ASTOperator], templateParams: Union[ASTTemplateParams, ASTTemplateIntroduction], templateArgs: Any, declaration: ASTDeclaration, docname: str, line: int) -> None: self.parent = parent # declarations in a single directive are linked together self.siblingAbove: Symbol = None self.siblingBelow: Symbol = None self.identOrOp = identOrOp self.templateParams = templateParams # template<templateParams> self.templateArgs = templateArgs # identifier<templateArgs> self.declaration = declaration self.docname = docname self.line = line self.isRedeclaration = False self._assert_invariants() # Remember to modify Symbol.remove if modifications to the parent change. self._children: List[Symbol] = [] self._anonChildren: List[Symbol] = [] # note: _children includes _anonChildren if self.parent: self.parent._children.append(self) if self.declaration: self.declaration.symbol = self # Do symbol addition after self._children has been initialised. self._add_template_and_function_params() def _fill_empty(self, declaration: ASTDeclaration, docname: str, line: int) -> None: self._assert_invariants() assert self.declaration is None assert self.docname is None assert self.line is None assert declaration is not None assert docname is not None assert line is not None self.declaration = declaration self.declaration.symbol = self self.docname = docname self.line = line self._assert_invariants() # and symbol addition should be done as well self._add_template_and_function_params() def _add_template_and_function_params(self) -> None: if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("_add_template_and_function_params:") # Note: we may be called from _fill_empty, so the symbols we want # to add may actually already be present (as empty symbols). # add symbols for the template params if self.templateParams: for tp in self.templateParams.params: if not tp.get_identifier(): continue # only add a declaration if we our self are from a declaration if self.declaration: decl = ASTDeclaration('templateParam', None, None, None, None, tp, None) else: decl = None nne = ASTNestedNameElement(tp.get_identifier(), None) nn = ASTNestedName([nne], [False], rooted=False) self._add_symbols(nn, [], decl, self.docname, self.line) # add symbols for function parameters, if any if self.declaration is not None and self.declaration.function_params is not None: for fp in self.declaration.function_params: if fp.arg is None: continue nn = fp.arg.name if nn is None: continue # (comparing to the template params: we have checked that we are a declaration) decl = ASTDeclaration('functionParam', None, None, None, None, fp, None) assert not nn.rooted assert len(nn.names) == 1 self._add_symbols(nn, [], decl, self.docname, self.line) if Symbol.debug_lookup: Symbol.debug_indent -= 1 def remove(self) -> None: if self.parent is None: return assert self in self.parent._children self.parent._children.remove(self) self.parent = None def clear_doc(self, docname: str) -> None: newChildren: List[Symbol] = [] for sChild in self._children: sChild.clear_doc(docname) if sChild.declaration and sChild.docname == docname: sChild.declaration = None sChild.docname = None sChild.line = None if sChild.siblingAbove is not None: sChild.siblingAbove.siblingBelow = sChild.siblingBelow if sChild.siblingBelow is not None: sChild.siblingBelow.siblingAbove = sChild.siblingAbove sChild.siblingAbove = None sChild.siblingBelow = None newChildren.append(sChild) self._children = newChildren def get_all_symbols(self) -> Iterator[Any]: yield self for sChild in self._children: yield from sChild.get_all_symbols() @property def children_recurse_anon(self) -> Generator["Symbol", None, None]: for c in self._children: yield c if not c.identOrOp.is_anon(): continue yield from c.children_recurse_anon def get_lookup_key(self) -> "LookupKey": # The pickle files for the environment and for each document are distinct. # The environment has all the symbols, but the documents has xrefs that # must know their scope. A lookup key is essentially a specification of # how to find a specific symbol. symbols = [] s = self while s.parent: symbols.append(s) s = s.parent symbols.reverse() key = [] for s in symbols: nne = ASTNestedNameElement(s.identOrOp, s.templateArgs) if s.declaration is not None: key.append((nne, s.templateParams, s.declaration.get_newest_id())) else: key.append((nne, s.templateParams, None)) return LookupKey(key) def get_full_nested_name(self) -> ASTNestedName: symbols = [] s = self while s.parent: symbols.append(s) s = s.parent symbols.reverse() names = [] templates = [] for s in symbols: names.append(ASTNestedNameElement(s.identOrOp, s.templateArgs)) templates.append(False) return ASTNestedName(names, templates, rooted=False) def _find_first_named_symbol(self, identOrOp: Union[ASTIdentifier, ASTOperator], templateParams: Any, templateArgs: ASTTemplateArgs, templateShorthand: bool, matchSelf: bool, recurseInAnon: bool, correctPrimaryTemplateArgs: bool ) -> "Symbol": if Symbol.debug_lookup: Symbol.debug_print("_find_first_named_symbol ->") res = self._find_named_symbols(identOrOp, templateParams, templateArgs, templateShorthand, matchSelf, recurseInAnon, correctPrimaryTemplateArgs, searchInSiblings=False) try: return next(res) except StopIteration: return None def _find_named_symbols(self, identOrOp: Union[ASTIdentifier, ASTOperator], templateParams: Any, templateArgs: ASTTemplateArgs, templateShorthand: bool, matchSelf: bool, recurseInAnon: bool, correctPrimaryTemplateArgs: bool, searchInSiblings: bool) -> Iterator["Symbol"]: if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("_find_named_symbols:") Symbol.debug_indent += 1 Symbol.debug_print("self:") print(self.to_string(Symbol.debug_indent + 1), end="") Symbol.debug_print("identOrOp: ", identOrOp) Symbol.debug_print("templateParams: ", templateParams) Symbol.debug_print("templateArgs: ", templateArgs) Symbol.debug_print("templateShorthand: ", templateShorthand) Symbol.debug_print("matchSelf: ", matchSelf) Symbol.debug_print("recurseInAnon: ", recurseInAnon) Symbol.debug_print("correctPrimaryTemplateAargs:", correctPrimaryTemplateArgs) Symbol.debug_print("searchInSiblings: ", searchInSiblings) def isSpecialization() -> bool: # the names of the template parameters must be given exactly as args # and params that are packs must in the args be the name expanded if len(templateParams.params) != len(templateArgs.args): return True # having no template params and no arguments is also a specialization if len(templateParams.params) == 0: return True for i in range(len(templateParams.params)): param = templateParams.params[i] arg = templateArgs.args[i] # TODO: doing this by string manipulation is probably not the most efficient paramName = str(param.name) argTxt = str(arg) isArgPackExpansion = argTxt.endswith('...') if param.isPack != isArgPackExpansion: return True argName = argTxt[:-3] if isArgPackExpansion else argTxt if paramName != argName: return True return False if correctPrimaryTemplateArgs: if templateParams is not None and templateArgs is not None: # If both are given, but it's not a specialization, then do lookup as if # there is no argument list. # For example: template<typename T> int A<T>::var; if not isSpecialization(): templateArgs = None def matches(s: "Symbol") -> bool: if s.identOrOp != identOrOp: return False if (s.templateParams is None) != (templateParams is None): if templateParams is not None: # we query with params, they must match params return False if not templateShorthand: # we don't query with params, and we do care about them return False if templateParams: # TODO: do better comparison if str(s.templateParams) != str(templateParams): return False if (s.templateArgs is None) != (templateArgs is None): return False if s.templateArgs: # TODO: do better comparison if str(s.templateArgs) != str(templateArgs): return False return True def candidates() -> Generator[Symbol, None, None]: s = self if Symbol.debug_lookup: Symbol.debug_print("searching in self:") print(s.to_string(Symbol.debug_indent + 1), end="") while True: if matchSelf: yield s if recurseInAnon: yield from s.children_recurse_anon else: yield from s._children if s.siblingAbove is None: break s = s.siblingAbove if Symbol.debug_lookup: Symbol.debug_print("searching in sibling:") print(s.to_string(Symbol.debug_indent + 1), end="") for s in candidates(): if Symbol.debug_lookup: Symbol.debug_print("candidate:") print(s.to_string(Symbol.debug_indent + 1), end="") if matches(s): if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("matches") Symbol.debug_indent -= 3 yield s if Symbol.debug_lookup: Symbol.debug_indent += 2 if Symbol.debug_lookup: Symbol.debug_indent -= 2 def _symbol_lookup(self, nestedName: ASTNestedName, templateDecls: List[Any], onMissingQualifiedSymbol: Callable[["Symbol", Union[ASTIdentifier, ASTOperator], Any, ASTTemplateArgs], "Symbol"], # NOQA strictTemplateParamArgLists: bool, ancestorLookupType: str, templateShorthand: bool, matchSelf: bool, recurseInAnon: bool, correctPrimaryTemplateArgs: bool, searchInSiblings: bool) -> SymbolLookupResult: # ancestorLookupType: if not None, specifies the target type of the lookup if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("_symbol_lookup:") Symbol.debug_indent += 1 Symbol.debug_print("self:") print(self.to_string(Symbol.debug_indent + 1), end="") Symbol.debug_print("nestedName: ", nestedName) Symbol.debug_print("templateDecls: ", ",".join(str(t) for t in templateDecls)) Symbol.debug_print("strictTemplateParamArgLists:", strictTemplateParamArgLists) Symbol.debug_print("ancestorLookupType:", ancestorLookupType) Symbol.debug_print("templateShorthand: ", templateShorthand) Symbol.debug_print("matchSelf: ", matchSelf) Symbol.debug_print("recurseInAnon: ", recurseInAnon) Symbol.debug_print("correctPrimaryTemplateArgs: ", correctPrimaryTemplateArgs) Symbol.debug_print("searchInSiblings: ", searchInSiblings) if strictTemplateParamArgLists: # Each template argument list must have a template parameter list. # But to declare a template there must be an additional template parameter list. assert (nestedName.num_templates() == len(templateDecls) or nestedName.num_templates() + 1 == len(templateDecls)) else: assert len(templateDecls) <= nestedName.num_templates() + 1 names = nestedName.names # find the right starting point for lookup parentSymbol = self if nestedName.rooted: while parentSymbol.parent: parentSymbol = parentSymbol.parent if ancestorLookupType is not None: # walk up until we find the first identifier firstName = names[0] if not firstName.is_operator(): while parentSymbol.parent: if parentSymbol.find_identifier(firstName.identOrOp, matchSelf=matchSelf, recurseInAnon=recurseInAnon, searchInSiblings=searchInSiblings): # if we are in the scope of a constructor but wants to # reference the class we need to walk one extra up if (len(names) == 1 and ancestorLookupType == 'class' and matchSelf and parentSymbol.parent and parentSymbol.parent.identOrOp == firstName.identOrOp): pass else: break parentSymbol = parentSymbol.parent if Symbol.debug_lookup: Symbol.debug_print("starting point:") print(parentSymbol.to_string(Symbol.debug_indent + 1), end="") # and now the actual lookup iTemplateDecl = 0 for name in names[:-1]: identOrOp = name.identOrOp templateArgs = name.templateArgs if strictTemplateParamArgLists: # there must be a parameter list if templateArgs: assert iTemplateDecl < len(templateDecls) templateParams = templateDecls[iTemplateDecl] iTemplateDecl += 1 else: templateParams = None else: # take the next template parameter list if there is one # otherwise it's ok if templateArgs and iTemplateDecl < len(templateDecls): templateParams = templateDecls[iTemplateDecl] iTemplateDecl += 1 else: templateParams = None symbol = parentSymbol._find_first_named_symbol( identOrOp, templateParams, templateArgs, templateShorthand=templateShorthand, matchSelf=matchSelf, recurseInAnon=recurseInAnon, correctPrimaryTemplateArgs=correctPrimaryTemplateArgs) if symbol is None: symbol = onMissingQualifiedSymbol(parentSymbol, identOrOp, templateParams, templateArgs) if symbol is None: if Symbol.debug_lookup: Symbol.debug_indent -= 2 return None # We have now matched part of a nested name, and need to match more # so even if we should matchSelf before, we definitely shouldn't # even more. (see also issue #2666) matchSelf = False parentSymbol = symbol if Symbol.debug_lookup: Symbol.debug_print("handle last name from:") print(parentSymbol.to_string(Symbol.debug_indent + 1), end="") # handle the last name name = names[-1] identOrOp = name.identOrOp templateArgs = name.templateArgs if iTemplateDecl < len(templateDecls): assert iTemplateDecl + 1 == len(templateDecls) templateParams = templateDecls[iTemplateDecl] else: assert iTemplateDecl == len(templateDecls) templateParams = None symbols = parentSymbol._find_named_symbols( identOrOp, templateParams, templateArgs, templateShorthand=templateShorthand, matchSelf=matchSelf, recurseInAnon=recurseInAnon, correctPrimaryTemplateArgs=False, searchInSiblings=searchInSiblings) if Symbol.debug_lookup: symbols = list(symbols) # type: ignore Symbol.debug_indent -= 2 return SymbolLookupResult(symbols, parentSymbol, identOrOp, templateParams, templateArgs) def _add_symbols(self, nestedName: ASTNestedName, templateDecls: List[Any], declaration: ASTDeclaration, docname: str, line: int) -> "Symbol": # Used for adding a whole path of symbols, where the last may or may not # be an actual declaration. if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("_add_symbols:") Symbol.debug_indent += 1 Symbol.debug_print("tdecls:", ",".join(str(t) for t in templateDecls)) Symbol.debug_print("nn: ", nestedName) Symbol.debug_print("decl: ", declaration) Symbol.debug_print("location: {}:{}".format(docname, line)) def onMissingQualifiedSymbol(parentSymbol: "Symbol", identOrOp: Union[ASTIdentifier, ASTOperator], templateParams: Any, templateArgs: ASTTemplateArgs ) -> "Symbol": if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("_add_symbols, onMissingQualifiedSymbol:") Symbol.debug_indent += 1 Symbol.debug_print("templateParams:", templateParams) Symbol.debug_print("identOrOp: ", identOrOp) Symbol.debug_print("templateARgs: ", templateArgs) Symbol.debug_indent -= 2 return Symbol(parent=parentSymbol, identOrOp=identOrOp, templateParams=templateParams, templateArgs=templateArgs, declaration=None, docname=None, line=None) lookupResult = self._symbol_lookup(nestedName, templateDecls, onMissingQualifiedSymbol, strictTemplateParamArgLists=True, ancestorLookupType=None, templateShorthand=False, matchSelf=False, recurseInAnon=False, correctPrimaryTemplateArgs=True, searchInSiblings=False) assert lookupResult is not None # we create symbols all the way, so that can't happen symbols = list(lookupResult.symbols) if len(symbols) == 0: if Symbol.debug_lookup: Symbol.debug_print("_add_symbols, result, no symbol:") Symbol.debug_indent += 1 Symbol.debug_print("templateParams:", lookupResult.templateParams) Symbol.debug_print("identOrOp: ", lookupResult.identOrOp) Symbol.debug_print("templateArgs: ", lookupResult.templateArgs) Symbol.debug_print("declaration: ", declaration) Symbol.debug_print("location: {}:{}".format(docname, line)) Symbol.debug_indent -= 1 symbol = Symbol(parent=lookupResult.parentSymbol, identOrOp=lookupResult.identOrOp, templateParams=lookupResult.templateParams, templateArgs=lookupResult.templateArgs, declaration=declaration, docname=docname, line=line) if Symbol.debug_lookup: Symbol.debug_indent -= 2 return symbol if Symbol.debug_lookup: Symbol.debug_print("_add_symbols, result, symbols:") Symbol.debug_indent += 1 Symbol.debug_print("number symbols:", len(symbols)) Symbol.debug_indent -= 1 if not declaration: if Symbol.debug_lookup: Symbol.debug_print("no declaration") Symbol.debug_indent -= 2 # good, just a scope creation # TODO: what if we have more than one symbol? return symbols[0] noDecl = [] withDecl = [] dupDecl = [] for s in symbols: if s.declaration is None: noDecl.append(s) elif s.isRedeclaration: dupDecl.append(s) else: withDecl.append(s) if Symbol.debug_lookup: Symbol.debug_print("#noDecl: ", len(noDecl)) Symbol.debug_print("#withDecl:", len(withDecl)) Symbol.debug_print("#dupDecl: ", len(dupDecl)) # With partial builds we may start with a large symbol tree stripped of declarations. # Essentially any combination of noDecl, withDecl, and dupDecls seems possible. # TODO: make partial builds fully work. What should happen when the primary symbol gets # deleted, and other duplicates exist? The full document should probably be rebuild. # First check if one of those with a declaration matches. # If it's a function, we need to compare IDs, # otherwise there should be only one symbol with a declaration. def makeCandSymbol() -> "Symbol": if Symbol.debug_lookup: Symbol.debug_print("begin: creating candidate symbol") symbol = Symbol(parent=lookupResult.parentSymbol, identOrOp=lookupResult.identOrOp, templateParams=lookupResult.templateParams, templateArgs=lookupResult.templateArgs, declaration=declaration, docname=docname, line=line) if Symbol.debug_lookup: Symbol.debug_print("end: creating candidate symbol") return symbol if len(withDecl) == 0: candSymbol = None else: candSymbol = makeCandSymbol() def handleDuplicateDeclaration(symbol: "Symbol", candSymbol: "Symbol") -> None: if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("redeclaration") Symbol.debug_indent -= 1 Symbol.debug_indent -= 2 # Redeclaration of the same symbol. # Let the new one be there, but raise an error to the client # so it can use the real symbol as subscope. # This will probably result in a duplicate id warning. candSymbol.isRedeclaration = True raise _DuplicateSymbolError(symbol, declaration) if declaration.objectType != "function": assert len(withDecl) <= 1 handleDuplicateDeclaration(withDecl[0], candSymbol) # (not reachable) # a function, so compare IDs candId = declaration.get_newest_id() if Symbol.debug_lookup: Symbol.debug_print("candId:", candId) for symbol in withDecl: # but all existing must be functions as well, # otherwise we declare it to be a duplicate if symbol.declaration.objectType != 'function': handleDuplicateDeclaration(symbol, candSymbol) # (not reachable) oldId = symbol.declaration.get_newest_id() if Symbol.debug_lookup: Symbol.debug_print("oldId: ", oldId) if candId == oldId: handleDuplicateDeclaration(symbol, candSymbol) # (not reachable) # no candidate symbol found with matching ID # if there is an empty symbol, fill that one if len(noDecl) == 0: if Symbol.debug_lookup: Symbol.debug_print("no match, no empty") if candSymbol is not None: Symbol.debug_print("result is already created candSymbol") else: Symbol.debug_print("result is makeCandSymbol()") Symbol.debug_indent -= 2 if candSymbol is not None: return candSymbol else: return makeCandSymbol() else: if Symbol.debug_lookup: Symbol.debug_print("no match, but fill an empty declaration, candSybmol is not None?:", candSymbol is not None) # NOQA Symbol.debug_indent -= 2 if candSymbol is not None: candSymbol.remove() # assert len(noDecl) == 1 # TODO: enable assertion when we at some point find out how to do cleanup # for now, just take the first one, it should work fine ... right? symbol = noDecl[0] # If someone first opened the scope, and then later # declares it, e.g, # .. namespace:: Test # .. namespace:: nullptr # .. class:: Test symbol._fill_empty(declaration, docname, line) return symbol def merge_with(self, other: "Symbol", docnames: List[str], env: "BuildEnvironment") -> None: if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("merge_with:") assert other is not None def unconditionalAdd(self, otherChild): # TODO: hmm, should we prune by docnames? self._children.append(otherChild) otherChild.parent = self otherChild._assert_invariants() if Symbol.debug_lookup: Symbol.debug_indent += 1 for otherChild in other._children: if Symbol.debug_lookup: Symbol.debug_print("otherChild:\n", otherChild.to_string(Symbol.debug_indent)) Symbol.debug_indent += 1 if otherChild.isRedeclaration: unconditionalAdd(self, otherChild) if Symbol.debug_lookup: Symbol.debug_print("isRedeclaration") Symbol.debug_indent -= 1 continue candiateIter = self._find_named_symbols( identOrOp=otherChild.identOrOp, templateParams=otherChild.templateParams, templateArgs=otherChild.templateArgs, templateShorthand=False, matchSelf=False, recurseInAnon=False, correctPrimaryTemplateArgs=False, searchInSiblings=False) candidates = list(candiateIter) if Symbol.debug_lookup: Symbol.debug_print("raw candidate symbols:", len(candidates)) symbols = [s for s in candidates if not s.isRedeclaration] if Symbol.debug_lookup: Symbol.debug_print("non-duplicate candidate symbols:", len(symbols)) if len(symbols) == 0: unconditionalAdd(self, otherChild) if Symbol.debug_lookup: Symbol.debug_indent -= 1 continue ourChild = None if otherChild.declaration is None: if Symbol.debug_lookup: Symbol.debug_print("no declaration in other child") ourChild = symbols[0] else: queryId = otherChild.declaration.get_newest_id() if Symbol.debug_lookup: Symbol.debug_print("queryId: ", queryId) for symbol in symbols: if symbol.declaration is None: if Symbol.debug_lookup: Symbol.debug_print("empty candidate") # if in the end we have non matching, but have an empty one, # then just continue with that ourChild = symbol continue candId = symbol.declaration.get_newest_id() if Symbol.debug_lookup: Symbol.debug_print("candidate:", candId) if candId == queryId: ourChild = symbol break if Symbol.debug_lookup: Symbol.debug_indent -= 1 if ourChild is None: unconditionalAdd(self, otherChild) continue if otherChild.declaration and otherChild.docname in docnames: if not ourChild.declaration: ourChild._fill_empty(otherChild.declaration, otherChild.docname, otherChild.line) elif ourChild.docname != otherChild.docname: name = str(ourChild.declaration) msg = __("Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'.") msg = msg % (ourChild.docname, ourChild.line, ourChild.declaration.directiveType, name) logger.warning(msg, location=(otherChild.docname, otherChild.line)) else: # Both have declarations, and in the same docname. # This can apparently happen, it should be safe to # just ignore it, right? # Hmm, only on duplicate declarations, right? msg = "Internal C++ domain error during symbol merging.\n" msg += "ourChild:\n" + ourChild.to_string(1) msg += "\notherChild:\n" + otherChild.to_string(1) logger.warning(msg, location=otherChild.docname) ourChild.merge_with(otherChild, docnames, env) if Symbol.debug_lookup: Symbol.debug_indent -= 2 def add_name(self, nestedName: ASTNestedName, templatePrefix: ASTTemplateDeclarationPrefix = None) -> "Symbol": if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("add_name:") if templatePrefix: templateDecls = templatePrefix.templates else: templateDecls = [] res = self._add_symbols(nestedName, templateDecls, declaration=None, docname=None, line=None) if Symbol.debug_lookup: Symbol.debug_indent -= 1 return res def add_declaration(self, declaration: ASTDeclaration, docname: str, line: int) -> "Symbol": if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("add_declaration:") assert declaration is not None assert docname is not None assert line is not None nestedName = declaration.name if declaration.templatePrefix: templateDecls = declaration.templatePrefix.templates else: templateDecls = [] res = self._add_symbols(nestedName, templateDecls, declaration, docname, line) if Symbol.debug_lookup: Symbol.debug_indent -= 1 return res def find_identifier(self, identOrOp: Union[ASTIdentifier, ASTOperator], matchSelf: bool, recurseInAnon: bool, searchInSiblings: bool ) -> "Symbol": if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("find_identifier:") Symbol.debug_indent += 1 Symbol.debug_print("identOrOp: ", identOrOp) Symbol.debug_print("matchSelf: ", matchSelf) Symbol.debug_print("recurseInAnon: ", recurseInAnon) Symbol.debug_print("searchInSiblings:", searchInSiblings) print(self.to_string(Symbol.debug_indent + 1), end="") Symbol.debug_indent -= 2 current = self while current is not None: if Symbol.debug_lookup: Symbol.debug_indent += 2 Symbol.debug_print("trying:") print(current.to_string(Symbol.debug_indent + 1), end="") Symbol.debug_indent -= 2 if matchSelf and current.identOrOp == identOrOp: return current children = current.children_recurse_anon if recurseInAnon else current._children for s in children: if s.identOrOp == identOrOp: return s if not searchInSiblings: break current = current.siblingAbove return None def direct_lookup(self, key: "LookupKey") -> "Symbol": if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("direct_lookup:") Symbol.debug_indent += 1 s = self for name, templateParams, id_ in key.data: if id_ is not None: res = None for cand in s._children: if cand.declaration is None: continue if cand.declaration.get_newest_id() == id_: res = cand break s = res else: identOrOp = name.identOrOp templateArgs = name.templateArgs s = s._find_first_named_symbol(identOrOp, templateParams, templateArgs, templateShorthand=False, matchSelf=False, recurseInAnon=False, correctPrimaryTemplateArgs=False) if Symbol.debug_lookup: Symbol.debug_print("name: ", name) Symbol.debug_print("templateParams:", templateParams) Symbol.debug_print("id: ", id_) if s is not None: print(s.to_string(Symbol.debug_indent + 1), end="") else: Symbol.debug_print("not found") if s is None: if Symbol.debug_lookup: Symbol.debug_indent -= 2 return None if Symbol.debug_lookup: Symbol.debug_indent -= 2 return s def find_name(self, nestedName: ASTNestedName, templateDecls: List[Any], typ: str, templateShorthand: bool, matchSelf: bool, recurseInAnon: bool, searchInSiblings: bool) -> Tuple[List["Symbol"], str]: # templateShorthand: missing template parameter lists for templates is ok # If the first component is None, # then the second component _may_ be a string explaining why. if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("find_name:") Symbol.debug_indent += 1 Symbol.debug_print("self:") print(self.to_string(Symbol.debug_indent + 1), end="") Symbol.debug_print("nestedName: ", nestedName) Symbol.debug_print("templateDecls: ", templateDecls) Symbol.debug_print("typ: ", typ) Symbol.debug_print("templateShorthand:", templateShorthand) Symbol.debug_print("matchSelf: ", matchSelf) Symbol.debug_print("recurseInAnon: ", recurseInAnon) Symbol.debug_print("searchInSiblings: ", searchInSiblings) class QualifiedSymbolIsTemplateParam(Exception): pass def onMissingQualifiedSymbol(parentSymbol: "Symbol", identOrOp: Union[ASTIdentifier, ASTOperator], templateParams: Any, templateArgs: ASTTemplateArgs) -> "Symbol": # TODO: Maybe search without template args? # Though, the correctPrimaryTemplateArgs does # that for primary templates. # Is there another case where it would be good? if parentSymbol.declaration is not None: if parentSymbol.declaration.objectType == 'templateParam': raise QualifiedSymbolIsTemplateParam() return None try: lookupResult = self._symbol_lookup(nestedName, templateDecls, onMissingQualifiedSymbol, strictTemplateParamArgLists=False, ancestorLookupType=typ, templateShorthand=templateShorthand, matchSelf=matchSelf, recurseInAnon=recurseInAnon, correctPrimaryTemplateArgs=False, searchInSiblings=searchInSiblings) except QualifiedSymbolIsTemplateParam: return None, "templateParamInQualified" if lookupResult is None: # if it was a part of the qualification that could not be found if Symbol.debug_lookup: Symbol.debug_indent -= 2 return None, None res = list(lookupResult.symbols) if len(res) != 0: if Symbol.debug_lookup: Symbol.debug_indent -= 2 return res, None if lookupResult.parentSymbol.declaration is not None: if lookupResult.parentSymbol.declaration.objectType == 'templateParam': return None, "templateParamInQualified" # try without template params and args symbol = lookupResult.parentSymbol._find_first_named_symbol( lookupResult.identOrOp, None, None, templateShorthand=templateShorthand, matchSelf=matchSelf, recurseInAnon=recurseInAnon, correctPrimaryTemplateArgs=False) if Symbol.debug_lookup: Symbol.debug_indent -= 2 if symbol is not None: return [symbol], None else: return None, None def find_declaration(self, declaration: ASTDeclaration, typ: str, templateShorthand: bool, matchSelf: bool, recurseInAnon: bool) -> "Symbol": # templateShorthand: missing template parameter lists for templates is ok if Symbol.debug_lookup: Symbol.debug_indent += 1 Symbol.debug_print("find_declaration:") nestedName = declaration.name if declaration.templatePrefix: templateDecls = declaration.templatePrefix.templates else: templateDecls = [] def onMissingQualifiedSymbol(parentSymbol: "Symbol", identOrOp: Union[ASTIdentifier, ASTOperator], templateParams: Any, templateArgs: ASTTemplateArgs) -> "Symbol": return None lookupResult = self._symbol_lookup(nestedName, templateDecls, onMissingQualifiedSymbol, strictTemplateParamArgLists=False, ancestorLookupType=typ, templateShorthand=templateShorthand, matchSelf=matchSelf, recurseInAnon=recurseInAnon, correctPrimaryTemplateArgs=False, searchInSiblings=False) if Symbol.debug_lookup: Symbol.debug_indent -= 1 if lookupResult is None: return None symbols = list(lookupResult.symbols) if len(symbols) == 0: return None querySymbol = Symbol(parent=lookupResult.parentSymbol, identOrOp=lookupResult.identOrOp, templateParams=lookupResult.templateParams, templateArgs=lookupResult.templateArgs, declaration=declaration, docname='fakeDocnameForQuery', line=42) queryId = declaration.get_newest_id() for symbol in symbols: if symbol.declaration is None: continue candId = symbol.declaration.get_newest_id() if candId == queryId: querySymbol.remove() return symbol querySymbol.remove() return None def to_string(self, indent: int) -> str: res = [Symbol.debug_indent_string * indent] if not self.parent: res.append('::') else: if self.templateParams: res.append(str(self.templateParams)) res.append('\n') res.append(Symbol.debug_indent_string * indent) if self.identOrOp: res.append(str(self.identOrOp)) else: res.append(str(self.declaration)) if self.templateArgs: res.append(str(self.templateArgs)) if self.declaration: res.append(": ") if self.isRedeclaration: res.append('!!duplicate!! ') res.append(str(self.declaration)) if self.docname: res.append('\t(') res.append(self.docname) res.append(')') res.append('\n') return ''.join(res) def dump(self, indent: int) -> str: res = [self.to_string(indent)] for c in self._children: res.append(c.dump(indent + 1)) return ''.join(res) class DefinitionParser(BaseParser): @property def language(self) -> str: return 'C++' @property def id_attributes(self): return self.config.cpp_id_attributes @property def paren_attributes(self): return self.config.cpp_paren_attributes def _parse_string(self) -> str: if self.current_char != '"': return None startPos = self.pos self.pos += 1 escape = False while True: if self.eof: self.fail("Unexpected end during inside string.") elif self.current_char == '"' and not escape: self.pos += 1 break elif self.current_char == '\\': escape = True else: escape = False self.pos += 1 return self.definition[startPos:self.pos] def _parse_literal(self) -> ASTLiteral: # -> integer-literal # | character-literal # | floating-literal # | string-literal # | boolean-literal -> "false" | "true" # | pointer-literal -> "nullptr" # | user-defined-literal def _udl(literal: ASTLiteral) -> ASTLiteral: if not self.match(udl_identifier_re): return literal # hmm, should we care if it's a keyword? # it looks like GCC does not disallow keywords ident = ASTIdentifier(self.matched_text) return ASTUserDefinedLiteral(literal, ident) self.skip_ws() if self.skip_word('nullptr'): return ASTPointerLiteral() if self.skip_word('true'): return ASTBooleanLiteral(True) if self.skip_word('false'): return ASTBooleanLiteral(False) pos = self.pos if self.match(float_literal_re): hasSuffix = self.match(float_literal_suffix_re) floatLit = ASTNumberLiteral(self.definition[pos:self.pos]) if hasSuffix: return floatLit else: return _udl(floatLit) for regex in [binary_literal_re, hex_literal_re, integer_literal_re, octal_literal_re]: if self.match(regex): hasSuffix = self.match(integers_literal_suffix_re) intLit = ASTNumberLiteral(self.definition[pos:self.pos]) if hasSuffix: return intLit else: return _udl(intLit) string = self._parse_string() if string is not None: return _udl(ASTStringLiteral(string)) # character-literal if self.match(char_literal_re): prefix = self.last_match.group(1) # may be None when no prefix data = self.last_match.group(2) try: charLit = ASTCharLiteral(prefix, data) except UnicodeDecodeError as e: self.fail("Can not handle character literal. Internal error was: %s" % e) except UnsupportedMultiCharacterCharLiteral: self.fail("Can not handle character literal" " resulting in multiple decoded characters.") return _udl(charLit) return None def _parse_fold_or_paren_expression(self) -> ASTExpression: # "(" expression ")" # fold-expression # -> ( cast-expression fold-operator ... ) # | ( ... fold-operator cast-expression ) # | ( cast-expression fold-operator ... fold-operator cast-expression if self.current_char != '(': return None self.pos += 1 self.skip_ws() if self.skip_string_and_ws("..."): # ( ... fold-operator cast-expression ) if not self.match(_fold_operator_re): self.fail("Expected fold operator after '...' in fold expression.") op = self.matched_text rightExpr = self._parse_cast_expression() if not self.skip_string(')'): self.fail("Expected ')' in end of fold expression.") return ASTFoldExpr(None, op, rightExpr) # try first parsing a unary right fold, or a binary fold pos = self.pos try: self.skip_ws() leftExpr = self._parse_cast_expression() self.skip_ws() if not self.match(_fold_operator_re): self.fail("Expected fold operator after left expression in fold expression.") op = self.matched_text self.skip_ws() if not self.skip_string_and_ws('...'): self.fail("Expected '...' after fold operator in fold expression.") except DefinitionError as eFold: self.pos = pos # fall back to a paren expression try: res = self._parse_expression() self.skip_ws() if not self.skip_string(')'): self.fail("Expected ')' in end of parenthesized expression.") except DefinitionError as eExpr: raise self._make_multi_error([ (eFold, "If fold expression"), (eExpr, "If parenthesized expression") ], "Error in fold expression or parenthesized expression.") from eExpr return ASTParenExpr(res) # now it definitely is a fold expression if self.skip_string(')'): return ASTFoldExpr(leftExpr, op, None) if not self.match(_fold_operator_re): self.fail("Expected fold operator or ')' after '...' in fold expression.") if op != self.matched_text: self.fail("Operators are different in binary fold: '%s' and '%s'." % (op, self.matched_text)) rightExpr = self._parse_cast_expression() self.skip_ws() if not self.skip_string(')'): self.fail("Expected ')' to end binary fold expression.") return ASTFoldExpr(leftExpr, op, rightExpr) def _parse_primary_expression(self) -> ASTExpression: # literal # "this" # lambda-expression # "(" expression ")" # fold-expression # id-expression -> we parse this with _parse_nested_name self.skip_ws() res: ASTExpression = self._parse_literal() if res is not None: return res self.skip_ws() if self.skip_word("this"): return ASTThisLiteral() # TODO: try lambda expression res = self._parse_fold_or_paren_expression() if res is not None: return res nn = self._parse_nested_name() if nn is not None: return ASTIdExpression(nn) return None def _parse_initializer_list(self, name: str, open: str, close: str ) -> Tuple[List[Union[ASTExpression, ASTBracedInitList]], bool]: # Parse open and close with the actual initializer-list in between # -> initializer-clause '...'[opt] # | initializer-list ',' initializer-clause '...'[opt] self.skip_ws() if not self.skip_string_and_ws(open): return None, None if self.skip_string(close): return [], False exprs: List[Union[ASTExpression, ASTBracedInitList]] = [] trailingComma = False while True: self.skip_ws() expr = self._parse_initializer_clause() self.skip_ws() if self.skip_string('...'): exprs.append(ASTPackExpansionExpr(expr)) else: exprs.append(expr) self.skip_ws() if self.skip_string(close): break if not self.skip_string_and_ws(','): self.fail("Error in %s, expected ',' or '%s'." % (name, close)) if self.current_char == close and close == '}': self.pos += 1 trailingComma = True break return exprs, trailingComma def _parse_paren_expression_list(self) -> ASTParenExprList: # -> '(' expression-list ')' # though, we relax it to also allow empty parens # as it's needed in some cases # # expression-list # -> initializer-list exprs, trailingComma = self._parse_initializer_list("parenthesized expression-list", '(', ')') if exprs is None: return None return ASTParenExprList(exprs) def _parse_initializer_clause(self) -> Union[ASTExpression, ASTBracedInitList]: bracedInitList = self._parse_braced_init_list() if bracedInitList is not None: return bracedInitList return self._parse_assignment_expression(inTemplate=False) def _parse_braced_init_list(self) -> ASTBracedInitList: # -> '{' initializer-list ','[opt] '}' # | '{' '}' exprs, trailingComma = self._parse_initializer_list("braced-init-list", '{', '}') if exprs is None: return None return ASTBracedInitList(exprs, trailingComma) def _parse_expression_list_or_braced_init_list( self ) -> Union[ASTParenExprList, ASTBracedInitList]: paren = self._parse_paren_expression_list() if paren is not None: return paren return self._parse_braced_init_list() def _parse_postfix_expression(self) -> ASTPostfixExpr: # -> primary # | postfix "[" expression "]" # | postfix "[" braced-init-list [opt] "]" # | postfix "(" expression-list [opt] ")" # | postfix "." "template" [opt] id-expression # | postfix "->" "template" [opt] id-expression # | postfix "." pseudo-destructor-name # | postfix "->" pseudo-destructor-name # | postfix "++" # | postfix "--" # | simple-type-specifier "(" expression-list [opt] ")" # | simple-type-specifier braced-init-list # | typename-specifier "(" expression-list [opt] ")" # | typename-specifier braced-init-list # | "dynamic_cast" "<" type-id ">" "(" expression ")" # | "static_cast" "<" type-id ">" "(" expression ")" # | "reinterpret_cast" "<" type-id ">" "(" expression ")" # | "const_cast" "<" type-id ">" "(" expression ")" # | "typeid" "(" expression ")" # | "typeid" "(" type-id ")" prefixType = None prefix: Any = None self.skip_ws() cast = None for c in _id_explicit_cast: if self.skip_word_and_ws(c): cast = c break if cast is not None: prefixType = "cast" if not self.skip_string("<"): self.fail("Expected '<' after '%s'." % cast) typ = self._parse_type(False) self.skip_ws() if not self.skip_string_and_ws(">"): self.fail("Expected '>' after type in '%s'." % cast) if not self.skip_string("("): self.fail("Expected '(' in '%s'." % cast) def parser() -> ASTExpression: return self._parse_expression() expr = self._parse_expression_fallback([')'], parser) self.skip_ws() if not self.skip_string(")"): self.fail("Expected ')' to end '%s'." % cast) prefix = ASTExplicitCast(cast, typ, expr) elif self.skip_word_and_ws("typeid"): prefixType = "typeid" if not self.skip_string_and_ws('('): self.fail("Expected '(' after 'typeid'.") pos = self.pos try: typ = self._parse_type(False) prefix = ASTTypeId(typ, isType=True) if not self.skip_string(')'): self.fail("Expected ')' to end 'typeid' of type.") except DefinitionError as eType: self.pos = pos try: def parser() -> ASTExpression: return self._parse_expression() expr = self._parse_expression_fallback([')'], parser) prefix = ASTTypeId(expr, isType=False) if not self.skip_string(')'): self.fail("Expected ')' to end 'typeid' of expression.") except DefinitionError as eExpr: self.pos = pos header = "Error in 'typeid(...)'." header += " Expected type or expression." errors = [] errors.append((eType, "If type")) errors.append((eExpr, "If expression")) raise self._make_multi_error(errors, header) from eExpr else: # a primary expression or a type pos = self.pos try: prefix = self._parse_primary_expression() prefixType = 'expr' except DefinitionError as eOuter: self.pos = pos try: # we are potentially casting, so save parens for us # TODO: hmm, would we need to try both with operatorCast and with None? prefix = self._parse_type(False, 'operatorCast') prefixType = 'typeOperatorCast' # | simple-type-specifier "(" expression-list [opt] ")" # | simple-type-specifier braced-init-list # | typename-specifier "(" expression-list [opt] ")" # | typename-specifier braced-init-list self.skip_ws() if self.current_char != '(' and self.current_char != '{': self.fail("Expecting '(' or '{' after type in cast expression.") except DefinitionError as eInner: self.pos = pos header = "Error in postfix expression," header += " expected primary expression or type." errors = [] errors.append((eOuter, "If primary expression")) errors.append((eInner, "If type")) raise self._make_multi_error(errors, header) from eInner # and now parse postfixes postFixes: List[ASTPostfixOp] = [] while True: self.skip_ws() if prefixType in ['expr', 'cast', 'typeid']: if self.skip_string_and_ws('['): expr = self._parse_expression() self.skip_ws() if not self.skip_string(']'): self.fail("Expected ']' in end of postfix expression.") postFixes.append(ASTPostfixArray(expr)) continue if self.skip_string('.'): if self.skip_string('*'): # don't steal the dot self.pos -= 2 elif self.skip_string('..'): # don't steal the dot self.pos -= 3 else: name = self._parse_nested_name() postFixes.append(ASTPostfixMember(name)) continue if self.skip_string('->'): if self.skip_string('*'): # don't steal the arrow self.pos -= 3 else: name = self._parse_nested_name() postFixes.append(ASTPostfixMemberOfPointer(name)) continue if self.skip_string('++'): postFixes.append(ASTPostfixInc()) continue if self.skip_string('--'): postFixes.append(ASTPostfixDec()) continue lst = self._parse_expression_list_or_braced_init_list() if lst is not None: postFixes.append(ASTPostfixCallExpr(lst)) continue break return ASTPostfixExpr(prefix, postFixes) def _parse_unary_expression(self) -> ASTExpression: # -> postfix # | "++" cast # | "--" cast # | unary-operator cast -> (* | & | + | - | ! | ~) cast # The rest: # | "sizeof" unary # | "sizeof" "(" type-id ")" # | "sizeof" "..." "(" identifier ")" # | "alignof" "(" type-id ")" # | noexcept-expression -> noexcept "(" expression ")" # | new-expression # | delete-expression self.skip_ws() for op in _expression_unary_ops: # TODO: hmm, should we be able to backtrack here? if op[0] in 'cn': res = self.skip_word(op) else: res = self.skip_string(op) if res: expr = self._parse_cast_expression() return ASTUnaryOpExpr(op, expr) if self.skip_word_and_ws('sizeof'): if self.skip_string_and_ws('...'): if not self.skip_string_and_ws('('): self.fail("Expecting '(' after 'sizeof...'.") if not self.match(identifier_re): self.fail("Expecting identifier for 'sizeof...'.") ident = ASTIdentifier(self.matched_text) self.skip_ws() if not self.skip_string(")"): self.fail("Expecting ')' to end 'sizeof...'.") return ASTSizeofParamPack(ident) if self.skip_string_and_ws('('): typ = self._parse_type(named=False) self.skip_ws() if not self.skip_string(')'): self.fail("Expecting ')' to end 'sizeof'.") return ASTSizeofType(typ) expr = self._parse_unary_expression() return ASTSizeofExpr(expr) if self.skip_word_and_ws('alignof'): if not self.skip_string_and_ws('('): self.fail("Expecting '(' after 'alignof'.") typ = self._parse_type(named=False) self.skip_ws() if not self.skip_string(')'): self.fail("Expecting ')' to end 'alignof'.") return ASTAlignofExpr(typ) if self.skip_word_and_ws('noexcept'): if not self.skip_string_and_ws('('): self.fail("Expecting '(' after 'noexcept'.") expr = self._parse_expression() self.skip_ws() if not self.skip_string(')'): self.fail("Expecting ')' to end 'noexcept'.") return ASTNoexceptExpr(expr) # new-expression pos = self.pos rooted = self.skip_string('::') self.skip_ws() if not self.skip_word_and_ws('new'): self.pos = pos else: # new-placement[opt] new-type-id new-initializer[opt] # new-placement[opt] ( type-id ) new-initializer[opt] isNewTypeId = True if self.skip_string_and_ws('('): # either this is a new-placement or it's the second production # without placement, and it's actually the ( type-id ) part self.fail("Sorry, neither new-placement nor parenthesised type-id " "in new-epression is supported yet.") # set isNewTypeId = False if it's (type-id) if isNewTypeId: declSpecs = self._parse_decl_specs(outer=None) decl = self._parse_declarator(named=False, paramMode="new") else: self.fail("Sorry, parenthesised type-id in new expression not yet supported.") lst = self._parse_expression_list_or_braced_init_list() return ASTNewExpr(rooted, isNewTypeId, ASTType(declSpecs, decl), lst) # delete-expression pos = self.pos rooted = self.skip_string('::') self.skip_ws() if not self.skip_word_and_ws('delete'): self.pos = pos else: array = self.skip_string_and_ws('[') if array and not self.skip_string_and_ws(']'): self.fail("Expected ']' in array delete-expression.") expr = self._parse_cast_expression() return ASTDeleteExpr(rooted, array, expr) return self._parse_postfix_expression() def _parse_cast_expression(self) -> ASTExpression: # -> unary | "(" type-id ")" cast pos = self.pos self.skip_ws() if self.skip_string('('): try: typ = self._parse_type(False) if not self.skip_string(')'): self.fail("Expected ')' in cast expression.") expr = self._parse_cast_expression() return ASTCastExpr(typ, expr) except DefinitionError as exCast: self.pos = pos try: return self._parse_unary_expression() except DefinitionError as exUnary: errs = [] errs.append((exCast, "If type cast expression")) errs.append((exUnary, "If unary expression")) raise self._make_multi_error(errs, "Error in cast expression.") from exUnary else: return self._parse_unary_expression() def _parse_logical_or_expression(self, inTemplate: bool) -> ASTExpression: # logical-or = logical-and || # logical-and = inclusive-or && # inclusive-or = exclusive-or | # exclusive-or = and ^ # and = equality & # equality = relational ==, != # relational = shift <, >, <=, >=, <=> # shift = additive <<, >> # additive = multiplicative +, - # multiplicative = pm *, /, % # pm = cast .*, ->* def _parse_bin_op_expr(self: DefinitionParser, opId: int, inTemplate: bool) -> ASTExpression: if opId + 1 == len(_expression_bin_ops): def parser(inTemplate: bool) -> ASTExpression: return self._parse_cast_expression() else: def parser(inTemplate: bool) -> ASTExpression: return _parse_bin_op_expr(self, opId + 1, inTemplate=inTemplate) exprs = [] ops = [] exprs.append(parser(inTemplate=inTemplate)) while True: self.skip_ws() if inTemplate and self.current_char == '>': break pos = self.pos oneMore = False for op in _expression_bin_ops[opId]: if op[0] in 'abcnox': if not self.skip_word(op): continue else: if not self.skip_string(op): continue if op == '&' and self.current_char == '&': # don't split the && 'token' self.pos -= 1 # and btw. && has lower precedence, so we are done break try: expr = parser(inTemplate=inTemplate) exprs.append(expr) ops.append(op) oneMore = True break except DefinitionError: self.pos = pos if not oneMore: break return ASTBinOpExpr(exprs, ops) return _parse_bin_op_expr(self, 0, inTemplate=inTemplate) def _parse_conditional_expression_tail(self, orExprHead: Any) -> None: # -> "?" expression ":" assignment-expression return None def _parse_assignment_expression(self, inTemplate: bool) -> ASTExpression: # -> conditional-expression # | logical-or-expression assignment-operator initializer-clause # | throw-expression # TODO: parse throw-expression: "throw" assignment-expression [opt] # if not a throw expression, then: # -> conditional-expression -> # logical-or-expression # | logical-or-expression "?" expression ":" assignment-expression # | logical-or-expression assignment-operator initializer-clause exprs: List[Union[ASTExpression, ASTBracedInitList]] = [] ops = [] orExpr = self._parse_logical_or_expression(inTemplate=inTemplate) exprs.append(orExpr) # TODO: handle ternary with _parse_conditional_expression_tail while True: oneMore = False self.skip_ws() for op in _expression_assignment_ops: if op[0] in 'anox': if not self.skip_word(op): continue else: if not self.skip_string(op): continue expr = self._parse_initializer_clause() exprs.append(expr) ops.append(op) oneMore = True if not oneMore: break if len(ops) == 0: return orExpr else: return ASTAssignmentExpr(exprs, ops) def _parse_constant_expression(self, inTemplate: bool) -> ASTExpression: # -> conditional-expression orExpr = self._parse_logical_or_expression(inTemplate=inTemplate) # TODO: use _parse_conditional_expression_tail return orExpr def _parse_expression(self) -> ASTExpression: # -> assignment-expression # | expression "," assignment-expression exprs = [self._parse_assignment_expression(inTemplate=False)] while True: self.skip_ws() if not self.skip_string(','): break exprs.append(self._parse_assignment_expression(inTemplate=False)) if len(exprs) == 1: return exprs[0] else: return ASTCommaExpr(exprs) def _parse_expression_fallback(self, end: List[str], parser: Callable[[], ASTExpression], allow: bool = True) -> ASTExpression: # Stupidly "parse" an expression. # 'end' should be a list of characters which ends the expression. # first try to use the provided parser prevPos = self.pos try: return parser() except DefinitionError as e: # some places (e.g., template parameters) we really don't want to use fallback, # and for testing we may want to globally disable it if not allow or not self.allowFallbackExpressionParsing: raise self.warn("Parsing of expression failed. Using fallback parser." " Error was:\n%s" % e) self.pos = prevPos # and then the fallback scanning assert end is not None self.skip_ws() startPos = self.pos if self.match(_string_re): value = self.matched_text else: # TODO: add handling of more bracket-like things, and quote handling brackets = {'(': ')', '{': '}', '[': ']', '<': '>'} symbols: List[str] = [] while not self.eof: if (len(symbols) == 0 and self.current_char in end): break if self.current_char in brackets.keys(): symbols.append(brackets[self.current_char]) elif len(symbols) > 0 and self.current_char == symbols[-1]: symbols.pop() self.pos += 1 if len(end) > 0 and self.eof: self.fail("Could not find end of expression starting at %d." % startPos) value = self.definition[startPos:self.pos].strip() return ASTFallbackExpr(value.strip()) # ========================================================================== def _parse_operator(self) -> ASTOperator: self.skip_ws() # adapted from the old code # yay, a regular operator definition if self.match(_operator_re): return ASTOperatorBuildIn(self.matched_text) # new/delete operator? for op in 'new', 'delete': if not self.skip_word(op): continue self.skip_ws() if self.skip_string('['): self.skip_ws() if not self.skip_string(']'): self.fail('Expected "]" after "operator ' + op + '["') op += '[]' return ASTOperatorBuildIn(op) # user-defined literal? if self.skip_string('""'): self.skip_ws() if not self.match(identifier_re): self.fail("Expected user-defined literal suffix.") identifier = ASTIdentifier(self.matched_text) return ASTOperatorLiteral(identifier) # oh well, looks like a cast operator definition. # In that case, eat another type. type = self._parse_type(named=False, outer="operatorCast") return ASTOperatorType(type) def _parse_template_argument_list(self) -> ASTTemplateArgs: # template-argument-list: (but we include the < and > here # template-argument ...[opt] # template-argument-list, template-argument ...[opt] # template-argument: # constant-expression # type-id # id-expression self.skip_ws() if not self.skip_string_and_ws('<'): return None if self.skip_string('>'): return ASTTemplateArgs([], False) prevErrors = [] templateArgs: List[Union[ASTType, ASTTemplateArgConstant]] = [] packExpansion = False while 1: pos = self.pos parsedComma = False parsedEnd = False try: type = self._parse_type(named=False) self.skip_ws() if self.skip_string_and_ws('...'): packExpansion = True parsedEnd = True if not self.skip_string('>'): self.fail('Expected ">" after "..." in template argument list.') elif self.skip_string('>'): parsedEnd = True elif self.skip_string(','): parsedComma = True else: self.fail('Expected "...>", ">" or "," in template argument list.') templateArgs.append(type) except DefinitionError as e: prevErrors.append((e, "If type argument")) self.pos = pos try: value = self._parse_constant_expression(inTemplate=True) self.skip_ws() if self.skip_string_and_ws('...'): packExpansion = True parsedEnd = True if not self.skip_string('>'): self.fail('Expected ">" after "..." in template argument list.') elif self.skip_string('>'): parsedEnd = True elif self.skip_string(','): parsedComma = True else: self.fail('Expected "...>", ">" or "," in template argument list.') templateArgs.append(ASTTemplateArgConstant(value)) except DefinitionError as e: self.pos = pos prevErrors.append((e, "If non-type argument")) header = "Error in parsing template argument list." raise self._make_multi_error(prevErrors, header) from e if parsedEnd: assert not parsedComma break else: assert not packExpansion return ASTTemplateArgs(templateArgs, packExpansion) def _parse_nested_name(self, memberPointer: bool = False) -> ASTNestedName: names: List[ASTNestedNameElement] = [] templates: List[bool] = [] self.skip_ws() rooted = False if self.skip_string('::'): rooted = True while 1: self.skip_ws() if len(names) > 0: template = self.skip_word_and_ws('template') else: template = False templates.append(template) identOrOp: Union[ASTIdentifier, ASTOperator] = None if self.skip_word_and_ws('operator'): identOrOp = self._parse_operator() else: if not self.match(identifier_re): if memberPointer and len(names) > 0: templates.pop() break self.fail("Expected identifier in nested name.") identifier = self.matched_text # make sure there isn't a keyword if identifier in _keywords: self.fail("Expected identifier in nested name, " "got keyword: %s" % identifier) identOrOp = ASTIdentifier(identifier) # try greedily to get template arguments, # but otherwise a < might be because we are in an expression pos = self.pos try: templateArgs = self._parse_template_argument_list() except DefinitionError as ex: self.pos = pos templateArgs = None self.otherErrors.append(ex) names.append(ASTNestedNameElement(identOrOp, templateArgs)) self.skip_ws() if not self.skip_string('::'): if memberPointer: self.fail("Expected '::' in pointer to member (function).") break return ASTNestedName(names, templates, rooted) # ========================================================================== def _parse_simple_type_specifiers(self) -> ASTTrailingTypeSpecFundamental: modifier: Optional[str] = None signedness: Optional[str] = None width: List[str] = [] typ: Optional[str] = None names: List[str] = [] # the parsed sequence self.skip_ws() while self.match(_simple_type_specifiers_re): t = self.matched_text names.append(t) if t in ('auto', 'void', 'bool', 'char', 'wchar_t', 'char8_t', 'char16_t', 'char32_t', 'int', '__int64', '__int128', 'float', 'double', '__float80', '_Float64x', '__float128', '_Float128'): if typ is not None: self.fail("Can not have both {} and {}.".format(t, typ)) typ = t elif t in ('signed', 'unsigned'): if signedness is not None: self.fail("Can not have both {} and {}.".format(t, signedness)) signedness = t elif t == 'short': if len(width) != 0: self.fail("Can not have both {} and {}.".format(t, width[0])) width.append(t) elif t == 'long': if len(width) != 0 and width[0] != 'long': self.fail("Can not have both {} and {}.".format(t, width[0])) width.append(t) elif t in ('_Imaginary', '_Complex'): if modifier is not None: self.fail("Can not have both {} and {}.".format(t, modifier)) modifier = t self.skip_ws() if len(names) == 0: return None if typ in ('auto', 'void', 'bool', 'wchar_t', 'char8_t', 'char16_t', 'char32_t', '__float80', '_Float64x', '__float128', '_Float128'): if modifier is not None: self.fail("Can not have both {} and {}.".format(typ, modifier)) if signedness is not None: self.fail("Can not have both {} and {}.".format(typ, signedness)) if len(width) != 0: self.fail("Can not have both {} and {}.".format(typ, ' '.join(width))) elif typ == 'char': if modifier is not None: self.fail("Can not have both {} and {}.".format(typ, modifier)) if len(width) != 0: self.fail("Can not have both {} and {}.".format(typ, ' '.join(width))) elif typ == 'int': if modifier is not None: self.fail("Can not have both {} and {}.".format(typ, modifier)) elif typ in ('__int64', '__int128'): if modifier is not None: self.fail("Can not have both {} and {}.".format(typ, modifier)) if len(width) != 0: self.fail("Can not have both {} and {}.".format(typ, ' '.join(width))) elif typ == 'float': if signedness is not None: self.fail("Can not have both {} and {}.".format(typ, signedness)) if len(width) != 0: self.fail("Can not have both {} and {}.".format(typ, ' '.join(width))) elif typ == 'double': if signedness is not None: self.fail("Can not have both {} and {}.".format(typ, signedness)) if len(width) > 1: self.fail("Can not have both {} and {}.".format(typ, ' '.join(width))) if len(width) == 1 and width[0] != 'long': self.fail("Can not have both {} and {}.".format(typ, ' '.join(width))) elif typ is None: if modifier is not None: self.fail("Can not have {} without a floating point type.".format(modifier)) else: assert False, "Unhandled type {}".format(typ) canonNames: List[str] = [] if modifier is not None: canonNames.append(modifier) if signedness is not None: canonNames.append(signedness) canonNames.extend(width) if typ is not None: canonNames.append(typ) return ASTTrailingTypeSpecFundamental(names, canonNames) def _parse_trailing_type_spec(self) -> ASTTrailingTypeSpec: # fundamental types, https://en.cppreference.com/w/cpp/language/type # and extensions self.skip_ws() res = self._parse_simple_type_specifiers() if res is not None: return res # decltype self.skip_ws() if self.skip_word_and_ws('decltype'): if not self.skip_string_and_ws('('): self.fail("Expected '(' after 'decltype'.") if self.skip_word_and_ws('auto'): if not self.skip_string(')'): self.fail("Expected ')' after 'decltype(auto'.") return ASTTrailingTypeSpecDecltypeAuto() expr = self._parse_expression() self.skip_ws() if not self.skip_string(')'): self.fail("Expected ')' after 'decltype(<expr>'.") return ASTTrailingTypeSpecDecltype(expr) # prefixed prefix = None self.skip_ws() for k in ('class', 'struct', 'enum', 'union', 'typename'): if self.skip_word_and_ws(k): prefix = k break nestedName = self._parse_nested_name() self.skip_ws() placeholderType = None if self.skip_word('auto'): placeholderType = 'auto' elif self.skip_word_and_ws('decltype'): if not self.skip_string_and_ws('('): self.fail("Expected '(' after 'decltype' in placeholder type specifier.") if not self.skip_word_and_ws('auto'): self.fail("Expected 'auto' after 'decltype(' in placeholder type specifier.") if not self.skip_string_and_ws(')'): self.fail("Expected ')' after 'decltype(auto' in placeholder type specifier.") placeholderType = 'decltype(auto)' return ASTTrailingTypeSpecName(prefix, nestedName, placeholderType) def _parse_parameters_and_qualifiers(self, paramMode: str) -> ASTParametersQualifiers: if paramMode == 'new': return None self.skip_ws() if not self.skip_string('('): if paramMode == 'function': self.fail('Expecting "(" in parameters-and-qualifiers.') else: return None args = [] self.skip_ws() if not self.skip_string(')'): while 1: self.skip_ws() if self.skip_string('...'): args.append(ASTFunctionParameter(None, True)) self.skip_ws() if not self.skip_string(')'): self.fail('Expected ")" after "..." in ' 'parameters-and-qualifiers.') break # note: it seems that function arguments can always be named, # even in function pointers and similar. arg = self._parse_type_with_init(outer=None, named='single') # TODO: parse default parameters # TODO: didn't we just do that? args.append(ASTFunctionParameter(arg)) self.skip_ws() if self.skip_string(','): continue elif self.skip_string(')'): break else: self.fail( 'Expecting "," or ")" in parameters-and-qualifiers, ' 'got "%s".' % self.current_char) self.skip_ws() const = self.skip_word_and_ws('const') volatile = self.skip_word_and_ws('volatile') if not const: # the can be permuted const = self.skip_word_and_ws('const') refQual = None if self.skip_string('&&'): refQual = '&&' if not refQual and self.skip_string('&'): refQual = '&' exceptionSpec = None self.skip_ws() if self.skip_string('noexcept'): if self.skip_string_and_ws('('): expr = self._parse_constant_expression(False) self.skip_ws() if not self.skip_string(')'): self.fail("Expecting ')' to end 'noexcept'.") exceptionSpec = ASTNoexceptSpec(expr) else: exceptionSpec = ASTNoexceptSpec(None) self.skip_ws() if self.skip_string('->'): trailingReturn = self._parse_type(named=False) else: trailingReturn = None self.skip_ws() override = self.skip_word_and_ws('override') final = self.skip_word_and_ws('final') if not override: override = self.skip_word_and_ws( 'override') # they can be permuted attrs = [] while True: attr = self._parse_attribute() if attr is None: break attrs.append(attr) self.skip_ws() initializer = None # if this is a function pointer we should not swallow an initializer if paramMode == 'function' and self.skip_string('='): self.skip_ws() valid = ('0', 'delete', 'default') for w in valid: if self.skip_word_and_ws(w): initializer = w break if not initializer: self.fail( 'Expected "%s" in initializer-specifier.' % '" or "'.join(valid)) return ASTParametersQualifiers( args, volatile, const, refQual, exceptionSpec, trailingReturn, override, final, attrs, initializer) def _parse_decl_specs_simple(self, outer: str, typed: bool) -> ASTDeclSpecsSimple: """Just parse the simple ones.""" storage = None threadLocal = None inline = None virtual = None explicitSpec = None consteval = None constexpr = None constinit = None volatile = None const = None friend = None attrs = [] while 1: # accept any permutation of a subset of some decl-specs self.skip_ws() if not const and typed: const = self.skip_word('const') if const: continue if not volatile and typed: volatile = self.skip_word('volatile') if volatile: continue if not storage: if outer in ('member', 'function'): if self.skip_word('static'): storage = 'static' continue if self.skip_word('extern'): storage = 'extern' continue if outer == 'member': if self.skip_word('mutable'): storage = 'mutable' continue if self.skip_word('register'): storage = 'register' continue if not inline and outer in ('function', 'member'): inline = self.skip_word('inline') if inline: continue if not constexpr and outer in ('member', 'function'): constexpr = self.skip_word("constexpr") if constexpr: continue if outer == 'member': if not constinit: constinit = self.skip_word('constinit') if constinit: continue if not threadLocal: threadLocal = self.skip_word('thread_local') if threadLocal: continue if outer == 'function': if not consteval: consteval = self.skip_word('consteval') if consteval: continue if not friend: friend = self.skip_word('friend') if friend: continue if not virtual: virtual = self.skip_word('virtual') if virtual: continue if not explicitSpec: explicit = self.skip_word_and_ws('explicit') if explicit: expr: ASTExpression = None if self.skip_string('('): expr = self._parse_constant_expression(inTemplate=False) if not expr: self.fail("Expected constant expression after '('" + " in explicit specifier.") self.skip_ws() if not self.skip_string(')'): self.fail("Expected ')' to end explicit specifier.") explicitSpec = ASTExplicitSpec(expr) continue attr = self._parse_attribute() if attr: attrs.append(attr) continue break return ASTDeclSpecsSimple(storage, threadLocal, inline, virtual, explicitSpec, consteval, constexpr, constinit, volatile, const, friend, attrs) def _parse_decl_specs(self, outer: str, typed: bool = True) -> ASTDeclSpecs: if outer: if outer not in ('type', 'member', 'function', 'templateParam'): raise Exception('Internal error, unknown outer "%s".' % outer) """ storage-class-specifier function-specifier "constexpr" "volatile" "const" trailing-type-specifier storage-class-specifier -> "static" (only for member_object and function_object) | "register" function-specifier -> "inline" | "virtual" | "explicit" (only for function_object) "constexpr" (only for member_object and function_object) """ leftSpecs = self._parse_decl_specs_simple(outer, typed) rightSpecs = None if typed: trailing = self._parse_trailing_type_spec() rightSpecs = self._parse_decl_specs_simple(outer, typed) else: trailing = None return ASTDeclSpecs(outer, leftSpecs, rightSpecs, trailing) def _parse_declarator_name_suffix( self, named: Union[bool, str], paramMode: str, typed: bool ) -> Union[ASTDeclaratorNameParamQual, ASTDeclaratorNameBitField]: # now we should parse the name, and then suffixes if named == 'maybe': pos = self.pos try: declId = self._parse_nested_name() except DefinitionError: self.pos = pos declId = None elif named == 'single': if self.match(identifier_re): identifier = ASTIdentifier(self.matched_text) nne = ASTNestedNameElement(identifier, None) declId = ASTNestedName([nne], [False], rooted=False) # if it's a member pointer, we may have '::', which should be an error self.skip_ws() if self.current_char == ':': self.fail("Unexpected ':' after identifier.") else: declId = None elif named: declId = self._parse_nested_name() else: declId = None arrayOps = [] while 1: self.skip_ws() if typed and self.skip_string('['): self.skip_ws() if self.skip_string(']'): arrayOps.append(ASTArray(None)) continue def parser() -> ASTExpression: return self._parse_expression() value = self._parse_expression_fallback([']'], parser) if not self.skip_string(']'): self.fail("Expected ']' in end of array operator.") arrayOps.append(ASTArray(value)) continue else: break paramQual = self._parse_parameters_and_qualifiers(paramMode) if paramQual is None and len(arrayOps) == 0: # perhaps a bit-field if named and paramMode == 'type' and typed: self.skip_ws() if self.skip_string(':'): size = self._parse_constant_expression(inTemplate=False) return ASTDeclaratorNameBitField(declId=declId, size=size) return ASTDeclaratorNameParamQual(declId=declId, arrayOps=arrayOps, paramQual=paramQual) def _parse_declarator(self, named: Union[bool, str], paramMode: str, typed: bool = True ) -> ASTDeclarator: # 'typed' here means 'parse return type stuff' if paramMode not in ('type', 'function', 'operatorCast', 'new'): raise Exception( "Internal error, unknown paramMode '%s'." % paramMode) prevErrors = [] self.skip_ws() if typed and self.skip_string('*'): self.skip_ws() volatile = False const = False attrs = [] while 1: if not volatile: volatile = self.skip_word_and_ws('volatile') if volatile: continue if not const: const = self.skip_word_and_ws('const') if const: continue attr = self._parse_attribute() if attr is not None: attrs.append(attr) continue break next = self._parse_declarator(named, paramMode, typed) return ASTDeclaratorPtr(next=next, volatile=volatile, const=const, attrs=attrs) # TODO: shouldn't we parse an R-value ref here first? if typed and self.skip_string("&"): attrs = [] while 1: attr = self._parse_attribute() if attr is None: break attrs.append(attr) next = self._parse_declarator(named, paramMode, typed) return ASTDeclaratorRef(next=next, attrs=attrs) if typed and self.skip_string("..."): next = self._parse_declarator(named, paramMode, False) return ASTDeclaratorParamPack(next=next) if typed and self.current_char == '(': # note: peeking, not skipping if paramMode == "operatorCast": # TODO: we should be able to parse cast operators which return # function pointers. For now, just hax it and ignore. return ASTDeclaratorNameParamQual(declId=None, arrayOps=[], paramQual=None) # maybe this is the beginning of params and quals,try that first, # otherwise assume it's noptr->declarator > ( ptr-declarator ) pos = self.pos try: # assume this is params and quals res = self._parse_declarator_name_suffix(named, paramMode, typed) return res except DefinitionError as exParamQual: prevErrors.append((exParamQual, "If declarator-id with parameters-and-qualifiers")) self.pos = pos try: assert self.current_char == '(' self.skip_string('(') # TODO: hmm, if there is a name, it must be in inner, right? # TODO: hmm, if there must be parameters, they must be # inside, right? inner = self._parse_declarator(named, paramMode, typed) if not self.skip_string(')'): self.fail("Expected ')' in \"( ptr-declarator )\"") next = self._parse_declarator(named=False, paramMode="type", typed=typed) return ASTDeclaratorParen(inner=inner, next=next) except DefinitionError as exNoPtrParen: self.pos = pos prevErrors.append((exNoPtrParen, "If parenthesis in noptr-declarator")) header = "Error in declarator" raise self._make_multi_error(prevErrors, header) from exNoPtrParen if typed: # pointer to member pos = self.pos try: name = self._parse_nested_name(memberPointer=True) self.skip_ws() if not self.skip_string('*'): self.fail("Expected '*' in pointer to member declarator.") self.skip_ws() except DefinitionError as e: self.pos = pos prevErrors.append((e, "If pointer to member declarator")) else: volatile = False const = False while 1: if not volatile: volatile = self.skip_word_and_ws('volatile') if volatile: continue if not const: const = self.skip_word_and_ws('const') if const: continue break next = self._parse_declarator(named, paramMode, typed) return ASTDeclaratorMemPtr(name, const, volatile, next=next) pos = self.pos try: res = self._parse_declarator_name_suffix(named, paramMode, typed) # this is a heuristic for error messages, for when there is a < after a # nested name, but it was not a successful template argument list if self.current_char == '<': self.otherErrors.append(self._make_multi_error(prevErrors, "")) return res except DefinitionError as e: self.pos = pos prevErrors.append((e, "If declarator-id")) header = "Error in declarator or parameters-and-qualifiers" raise self._make_multi_error(prevErrors, header) from e def _parse_initializer(self, outer: str = None, allowFallback: bool = True ) -> ASTInitializer: # initializer # global vars # -> brace-or-equal-initializer # | '(' expression-list ')' # # brace-or-equal-initializer # member vars # -> '=' initializer-clause # | braced-init-list # # initializer-clause # function params, non-type template params (with '=' in front) # -> assignment-expression # | braced-init-list # # we don't distinguish between global and member vars, so disallow paren: # # -> braced-init-list # var only # | '=' assignment-expression # | '=' braced-init-list self.skip_ws() if outer == 'member': bracedInit = self._parse_braced_init_list() if bracedInit is not None: return ASTInitializer(bracedInit, hasAssign=False) if not self.skip_string('='): return None bracedInit = self._parse_braced_init_list() if bracedInit is not None: return ASTInitializer(bracedInit) if outer == 'member': fallbackEnd: List[str] = [] elif outer == 'templateParam': fallbackEnd = [',', '>'] elif outer is None: # function parameter fallbackEnd = [',', ')'] else: self.fail("Internal error, initializer for outer '%s' not " "implemented." % outer) inTemplate = outer == 'templateParam' def parser() -> ASTExpression: return self._parse_assignment_expression(inTemplate=inTemplate) value = self._parse_expression_fallback(fallbackEnd, parser, allow=allowFallback) return ASTInitializer(value) def _parse_type(self, named: Union[bool, str], outer: str = None) -> ASTType: """ named=False|'maybe'|True: 'maybe' is e.g., for function objects which doesn't need to name the arguments outer == operatorCast: annoying case, we should not take the params """ if outer: # always named if outer not in ('type', 'member', 'function', 'operatorCast', 'templateParam'): raise Exception('Internal error, unknown outer "%s".' % outer) if outer != 'operatorCast': assert named if outer in ('type', 'function'): # We allow type objects to just be a name. # Some functions don't have normal return types: constructors, # destructors, cast operators prevErrors = [] startPos = self.pos # first try without the type try: declSpecs = self._parse_decl_specs(outer=outer, typed=False) decl = self._parse_declarator(named=True, paramMode=outer, typed=False) self.assert_end(allowSemicolon=True) except DefinitionError as exUntyped: if outer == 'type': desc = "If just a name" elif outer == 'function': desc = "If the function has no return type" else: assert False prevErrors.append((exUntyped, desc)) self.pos = startPos try: declSpecs = self._parse_decl_specs(outer=outer) decl = self._parse_declarator(named=True, paramMode=outer) except DefinitionError as exTyped: self.pos = startPos if outer == 'type': desc = "If typedef-like declaration" elif outer == 'function': desc = "If the function has a return type" else: assert False prevErrors.append((exTyped, desc)) # Retain the else branch for easier debugging. # TODO: it would be nice to save the previous stacktrace # and output it here. if True: if outer == 'type': header = "Type must be either just a name or a " header += "typedef-like declaration." elif outer == 'function': header = "Error when parsing function declaration." else: assert False raise self._make_multi_error(prevErrors, header) from exTyped else: # For testing purposes. # do it again to get the proper traceback (how do you # reliably save a traceback when an exception is # constructed?) self.pos = startPos typed = True declSpecs = self._parse_decl_specs(outer=outer, typed=typed) decl = self._parse_declarator(named=True, paramMode=outer, typed=typed) else: paramMode = 'type' if outer == 'member': named = True elif outer == 'operatorCast': paramMode = 'operatorCast' outer = None elif outer == 'templateParam': named = 'single' declSpecs = self._parse_decl_specs(outer=outer) decl = self._parse_declarator(named=named, paramMode=paramMode) return ASTType(declSpecs, decl) def _parse_type_with_init( self, named: Union[bool, str], outer: str) -> Union[ASTTypeWithInit, ASTTemplateParamConstrainedTypeWithInit]: if outer: assert outer in ('type', 'member', 'function', 'templateParam') type = self._parse_type(outer=outer, named=named) if outer != 'templateParam': init = self._parse_initializer(outer=outer) return ASTTypeWithInit(type, init) # it could also be a constrained type parameter, e.g., C T = int& pos = self.pos eExpr = None try: init = self._parse_initializer(outer=outer, allowFallback=False) # note: init may be None if there is no = if init is None: return ASTTypeWithInit(type, None) # we parsed an expression, so we must have a , or a >, # otherwise the expression didn't get everything self.skip_ws() if self.current_char != ',' and self.current_char != '>': # pretend it didn't happen self.pos = pos init = None else: # we assume that it was indeed an expression return ASTTypeWithInit(type, init) except DefinitionError as e: self.pos = pos eExpr = e if not self.skip_string("="): return ASTTypeWithInit(type, None) try: typeInit = self._parse_type(named=False, outer=None) return ASTTemplateParamConstrainedTypeWithInit(type, typeInit) except DefinitionError as eType: if eExpr is None: raise eType errs = [] errs.append((eExpr, "If default template argument is an expression")) errs.append((eType, "If default template argument is a type")) msg = "Error in non-type template parameter" msg += " or constrained template parameter." raise self._make_multi_error(errs, msg) from eType def _parse_type_using(self) -> ASTTypeUsing: name = self._parse_nested_name() self.skip_ws() if not self.skip_string('='): return ASTTypeUsing(name, None) type = self._parse_type(False, None) return ASTTypeUsing(name, type) def _parse_concept(self) -> ASTConcept: nestedName = self._parse_nested_name() self.skip_ws() initializer = self._parse_initializer('member') return ASTConcept(nestedName, initializer) def _parse_class(self) -> ASTClass: name = self._parse_nested_name() self.skip_ws() final = self.skip_word_and_ws('final') bases = [] self.skip_ws() if self.skip_string(':'): while 1: self.skip_ws() visibility = None virtual = False pack = False if self.skip_word_and_ws('virtual'): virtual = True if self.match(_visibility_re): visibility = self.matched_text self.skip_ws() if not virtual and self.skip_word_and_ws('virtual'): virtual = True baseName = self._parse_nested_name() self.skip_ws() pack = self.skip_string('...') bases.append(ASTBaseClass(baseName, visibility, virtual, pack)) self.skip_ws() if self.skip_string(','): continue else: break return ASTClass(name, final, bases) def _parse_union(self) -> ASTUnion: name = self._parse_nested_name() return ASTUnion(name) def _parse_enum(self) -> ASTEnum: scoped = None # is set by CPPEnumObject self.skip_ws() name = self._parse_nested_name() self.skip_ws() underlyingType = None if self.skip_string(':'): underlyingType = self._parse_type(named=False) return ASTEnum(name, scoped, underlyingType) def _parse_enumerator(self) -> ASTEnumerator: name = self._parse_nested_name() self.skip_ws() init = None if self.skip_string('='): self.skip_ws() def parser() -> ASTExpression: return self._parse_constant_expression(inTemplate=False) initVal = self._parse_expression_fallback([], parser) init = ASTInitializer(initVal) return ASTEnumerator(name, init) # ========================================================================== def _parse_template_parameter(self) -> ASTTemplateParam: self.skip_ws() if self.skip_word('template'): # declare a tenplate template parameter nestedParams = self._parse_template_parameter_list() else: nestedParams = None pos = self.pos try: # Unconstrained type parameter or template type parameter key = None self.skip_ws() if self.skip_word_and_ws('typename'): key = 'typename' elif self.skip_word_and_ws('class'): key = 'class' elif nestedParams: self.fail("Expected 'typename' or 'class' after " "template template parameter list.") else: self.fail("Expected 'typename' or 'class' in the " "beginning of template type parameter.") self.skip_ws() parameterPack = self.skip_string('...') self.skip_ws() if self.match(identifier_re): identifier = ASTIdentifier(self.matched_text) else: identifier = None self.skip_ws() if not parameterPack and self.skip_string('='): default = self._parse_type(named=False, outer=None) else: default = None if self.current_char not in ',>': self.fail('Expected "," or ">" after (template) type parameter.') data = ASTTemplateKeyParamPackIdDefault(key, identifier, parameterPack, default) if nestedParams: return ASTTemplateParamTemplateType(nestedParams, data) else: return ASTTemplateParamType(data) except DefinitionError as eType: if nestedParams: raise try: # non-type parameter or constrained type parameter self.pos = pos param = self._parse_type_with_init('maybe', 'templateParam') return ASTTemplateParamNonType(param) except DefinitionError as eNonType: self.pos = pos header = "Error when parsing template parameter." errs = [] errs.append( (eType, "If unconstrained type parameter or template type parameter")) errs.append( (eNonType, "If constrained type parameter or non-type parameter")) raise self._make_multi_error(errs, header) def _parse_template_parameter_list(self) -> ASTTemplateParams: # only: '<' parameter-list '>' # we assume that 'template' has just been parsed templateParams: List[ASTTemplateParam] = [] self.skip_ws() if not self.skip_string("<"): self.fail("Expected '<' after 'template'") while 1: pos = self.pos err = None try: param = self._parse_template_parameter() templateParams.append(param) except DefinitionError as eParam: self.pos = pos err = eParam self.skip_ws() if self.skip_string('>'): return ASTTemplateParams(templateParams) elif self.skip_string(','): continue else: header = "Error in template parameter list." errs = [] if err: errs.append((err, "If parameter")) try: self.fail('Expected "," or ">".') except DefinitionError as e: errs.append((e, "If no parameter")) print(errs) raise self._make_multi_error(errs, header) def _parse_template_introduction(self) -> ASTTemplateIntroduction: pos = self.pos try: concept = self._parse_nested_name() except Exception: self.pos = pos return None self.skip_ws() if not self.skip_string('{'): self.pos = pos return None # for sure it must be a template introduction now params = [] while 1: self.skip_ws() parameterPack = self.skip_string('...') self.skip_ws() if not self.match(identifier_re): self.fail("Expected identifier in template introduction list.") txt_identifier = self.matched_text # make sure there isn't a keyword if txt_identifier in _keywords: self.fail("Expected identifier in template introduction list, " "got keyword: %s" % txt_identifier) identifier = ASTIdentifier(txt_identifier) params.append(ASTTemplateIntroductionParameter(identifier, parameterPack)) self.skip_ws() if self.skip_string('}'): break elif self.skip_string(','): continue else: self.fail("Error in template introduction list. " 'Expected ",", or "}".') return ASTTemplateIntroduction(concept, params) def _parse_requires_clause(self) -> Optional[ASTRequiresClause]: # requires-clause -> 'requires' constraint-logical-or-expression # constraint-logical-or-expression # -> constraint-logical-and-expression # | constraint-logical-or-expression '||' constraint-logical-and-expression # constraint-logical-and-expression # -> primary-expression # | constraint-logical-and-expression '&&' primary-expression self.skip_ws() if not self.skip_word('requires'): return None def parse_and_expr(self: DefinitionParser) -> ASTExpression: andExprs = [] ops = [] andExprs.append(self._parse_primary_expression()) while True: self.skip_ws() oneMore = False if self.skip_string('&&'): oneMore = True ops.append('&&') elif self.skip_word('and'): oneMore = True ops.append('and') if not oneMore: break andExprs.append(self._parse_primary_expression()) if len(andExprs) == 1: return andExprs[0] else: return ASTBinOpExpr(andExprs, ops) orExprs = [] ops = [] orExprs.append(parse_and_expr(self)) while True: self.skip_ws() oneMore = False if self.skip_string('||'): oneMore = True ops.append('||') elif self.skip_word('or'): oneMore = True ops.append('or') if not oneMore: break orExprs.append(parse_and_expr(self)) if len(orExprs) == 1: return ASTRequiresClause(orExprs[0]) else: return ASTRequiresClause(ASTBinOpExpr(orExprs, ops)) def _parse_template_declaration_prefix(self, objectType: str ) -> Optional[ASTTemplateDeclarationPrefix]: templates: List[Union[ASTTemplateParams, ASTTemplateIntroduction]] = [] while 1: self.skip_ws() # the saved position is only used to provide a better error message params: Union[ASTTemplateParams, ASTTemplateIntroduction] = None pos = self.pos if self.skip_word("template"): try: params = self._parse_template_parameter_list() except DefinitionError as e: if objectType == 'member' and len(templates) == 0: return ASTTemplateDeclarationPrefix(None) else: raise e else: params = self._parse_template_introduction() if not params: break if objectType == 'concept' and len(templates) > 0: self.pos = pos self.fail("More than 1 template parameter list for concept.") templates.append(params) if len(templates) == 0 and objectType == 'concept': self.fail('Missing template parameter list for concept.') if len(templates) == 0: return None else: return ASTTemplateDeclarationPrefix(templates) def _check_template_consistency(self, nestedName: ASTNestedName, templatePrefix: ASTTemplateDeclarationPrefix, fullSpecShorthand: bool, isMember: bool = False ) -> ASTTemplateDeclarationPrefix: numArgs = nestedName.num_templates() isMemberInstantiation = False if not templatePrefix: numParams = 0 else: if isMember and templatePrefix.templates is None: numParams = 0 isMemberInstantiation = True else: numParams = len(templatePrefix.templates) if numArgs + 1 < numParams: self.fail("Too few template argument lists comapred to parameter" " lists. Argument lists: %d, Parameter lists: %d." % (numArgs, numParams)) if numArgs > numParams: numExtra = numArgs - numParams if not fullSpecShorthand and not isMemberInstantiation: msg = "Too many template argument lists compared to parameter" \ " lists. Argument lists: %d, Parameter lists: %d," \ " Extra empty parameters lists prepended: %d." \ % (numArgs, numParams, numExtra) msg += " Declaration:\n\t" if templatePrefix: msg += "%s\n\t" % templatePrefix msg += str(nestedName) self.warn(msg) newTemplates: List[Union[ASTTemplateParams, ASTTemplateIntroduction]] = [] for i in range(numExtra): newTemplates.append(ASTTemplateParams([])) if templatePrefix and not isMemberInstantiation: newTemplates.extend(templatePrefix.templates) templatePrefix = ASTTemplateDeclarationPrefix(newTemplates) return templatePrefix def parse_declaration(self, objectType: str, directiveType: str) -> ASTDeclaration: if objectType not in ('class', 'union', 'function', 'member', 'type', 'concept', 'enum', 'enumerator'): raise Exception('Internal error, unknown objectType "%s".' % objectType) if directiveType not in ('class', 'struct', 'union', 'function', 'member', 'var', 'type', 'concept', 'enum', 'enum-struct', 'enum-class', 'enumerator'): raise Exception('Internal error, unknown directiveType "%s".' % directiveType) visibility = None templatePrefix = None requiresClause = None trailingRequiresClause = None declaration: Any = None self.skip_ws() if self.match(_visibility_re): visibility = self.matched_text if objectType in ('type', 'concept', 'member', 'function', 'class'): templatePrefix = self._parse_template_declaration_prefix(objectType) if objectType == 'function' and templatePrefix is not None: requiresClause = self._parse_requires_clause() if objectType == 'type': prevErrors = [] pos = self.pos try: if not templatePrefix: declaration = self._parse_type(named=True, outer='type') except DefinitionError as e: prevErrors.append((e, "If typedef-like declaration")) self.pos = pos pos = self.pos try: if not declaration: declaration = self._parse_type_using() except DefinitionError as e: self.pos = pos prevErrors.append((e, "If type alias or template alias")) header = "Error in type declaration." raise self._make_multi_error(prevErrors, header) from e elif objectType == 'concept': declaration = self._parse_concept() elif objectType == 'member': declaration = self._parse_type_with_init(named=True, outer='member') elif objectType == 'function': declaration = self._parse_type(named=True, outer='function') if templatePrefix is not None: trailingRequiresClause = self._parse_requires_clause() elif objectType == 'class': declaration = self._parse_class() elif objectType == 'union': declaration = self._parse_union() elif objectType == 'enum': declaration = self._parse_enum() elif objectType == 'enumerator': declaration = self._parse_enumerator() else: assert False templatePrefix = self._check_template_consistency(declaration.name, templatePrefix, fullSpecShorthand=False, isMember=objectType == 'member') self.skip_ws() semicolon = self.skip_string(';') return ASTDeclaration(objectType, directiveType, visibility, templatePrefix, requiresClause, declaration, trailingRequiresClause, semicolon) def parse_namespace_object(self) -> ASTNamespace: templatePrefix = self._parse_template_declaration_prefix(objectType="namespace") name = self._parse_nested_name() templatePrefix = self._check_template_consistency(name, templatePrefix, fullSpecShorthand=False) res = ASTNamespace(name, templatePrefix) res.objectType = 'namespace' # type: ignore return res def parse_xref_object(self) -> Tuple[Union[ASTNamespace, ASTDeclaration], bool]: pos = self.pos try: templatePrefix = self._parse_template_declaration_prefix(objectType="xref") name = self._parse_nested_name() # if there are '()' left, just skip them self.skip_ws() self.skip_string('()') self.assert_end() templatePrefix = self._check_template_consistency(name, templatePrefix, fullSpecShorthand=True) res1 = ASTNamespace(name, templatePrefix) res1.objectType = 'xref' # type: ignore return res1, True except DefinitionError as e1: try: self.pos = pos res2 = self.parse_declaration('function', 'function') # if there are '()' left, just skip them self.skip_ws() self.skip_string('()') self.assert_end() return res2, False except DefinitionError as e2: errs = [] errs.append((e1, "If shorthand ref")) errs.append((e2, "If full function ref")) msg = "Error in cross-reference." raise self._make_multi_error(errs, msg) from e2 def parse_expression(self) -> Union[ASTExpression, ASTType]: pos = self.pos try: expr = self._parse_expression() self.skip_ws() self.assert_end() return expr except DefinitionError as exExpr: self.pos = pos try: typ = self._parse_type(False) self.skip_ws() self.assert_end() return typ except DefinitionError as exType: header = "Error when parsing (type) expression." errs = [] errs.append((exExpr, "If expression")) errs.append((exType, "If type")) raise self._make_multi_error(errs, header) from exType def _make_phony_error_name() -> ASTNestedName: nne = ASTNestedNameElement(ASTIdentifier("PhonyNameDueToError"), None) return ASTNestedName([nne], [False], rooted=False) class CPPObject(ObjectDescription[ASTDeclaration]): """Description of a C++ language object.""" doc_field_types: List[Field] = [ GroupedField('template parameter', label=_('Template Parameters'), names=('tparam', 'template parameter'), can_collapse=True), ] option_spec: OptionSpec = { 'noindexentry': directives.flag, 'tparam-line-spec': directives.flag, } def _add_enumerator_to_parent(self, ast: ASTDeclaration) -> None: assert ast.objectType == 'enumerator' # find the parent, if it exists && is an enum # && it's unscoped, # then add the name to the parent scope symbol = ast.symbol assert symbol assert symbol.identOrOp is not None assert symbol.templateParams is None assert symbol.templateArgs is None parentSymbol = symbol.parent assert parentSymbol if parentSymbol.parent is None: # TODO: we could warn, but it is somewhat equivalent to unscoped # enums, without the enum return # no parent parentDecl = parentSymbol.declaration if parentDecl is None: # the parent is not explicitly declared # TODO: we could warn, but it could be a style to just assume # enumerator parents to be scoped return if parentDecl.objectType != 'enum': # TODO: maybe issue a warning, enumerators in non-enums is weird, # but it is somewhat equivalent to unscoped enums, without the enum return if parentDecl.directiveType != 'enum': return targetSymbol = parentSymbol.parent s = targetSymbol.find_identifier(symbol.identOrOp, matchSelf=False, recurseInAnon=True, searchInSiblings=False) if s is not None: # something is already declared with that name return declClone = symbol.declaration.clone() declClone.enumeratorScopedSymbol = symbol Symbol(parent=targetSymbol, identOrOp=symbol.identOrOp, templateParams=None, templateArgs=None, declaration=declClone, docname=self.env.docname, line=self.get_source_info()[1]) def add_target_and_index(self, ast: ASTDeclaration, sig: str, signode: TextElement) -> None: # general note: name must be lstrip(':')'ed, to remove "::" ids = [] for i in range(1, _max_id + 1): try: id = ast.get_id(version=i) ids.append(id) except NoOldIdError: assert i < _max_id # let's keep the newest first ids = list(reversed(ids)) newestId = ids[0] assert newestId # shouldn't be None if not re.compile(r'^[a-zA-Z0-9_]*$').match(newestId): logger.warning('Index id generation for C++ object "%s" failed, please ' 'report as bug (id=%s).', ast, newestId, location=self.get_location()) name = ast.symbol.get_full_nested_name().get_display_string().lstrip(':') # Add index entry, but not if it's a declaration inside a concept isInConcept = False s = ast.symbol.parent while s is not None: decl = s.declaration s = s.parent if decl is None: continue if decl.objectType == 'concept': isInConcept = True break if not isInConcept and 'noindexentry' not in self.options: strippedName = name for prefix in self.env.config.cpp_index_common_prefix: if name.startswith(prefix): strippedName = strippedName[len(prefix):] break indexText = self.get_index_text(strippedName) self.indexnode['entries'].append(('single', indexText, newestId, '', None)) if newestId not in self.state.document.ids: # if the name is not unique, the first one will win names = self.env.domaindata['cpp']['names'] if name not in names: names[name] = ast.symbol.docname # always add the newest id assert newestId signode['ids'].append(newestId) # only add compatibility ids when there are no conflicts for id in ids[1:]: if not id: # is None when the element didn't exist in that version continue if id not in self.state.document.ids: signode['ids'].append(id) self.state.document.note_explicit_target(signode) @property def object_type(self) -> str: raise NotImplementedError() @property def display_object_type(self) -> str: return self.object_type def get_index_text(self, name: str) -> str: return _('%s (C++ %s)') % (name, self.display_object_type) def parse_definition(self, parser: DefinitionParser) -> ASTDeclaration: return parser.parse_declaration(self.object_type, self.objtype) def describe_signature(self, signode: desc_signature, ast: ASTDeclaration, options: Dict) -> None: ast.describe_signature(signode, 'lastIsName', self.env, options) def run(self) -> List[Node]: env = self.state.document.settings.env # from ObjectDescription.run if 'cpp:parent_symbol' not in env.temp_data: root = env.domaindata['cpp']['root_symbol'] env.temp_data['cpp:parent_symbol'] = root env.ref_context['cpp:parent_key'] = root.get_lookup_key() # The lookup keys assume that no nested scopes exists inside overloaded functions. # (see also #5191) # Example: # .. cpp:function:: void f(int) # .. cpp:function:: void f(double) # # .. cpp:function:: void g() # # :cpp:any:`boom` # # So we disallow any signatures inside functions. parentSymbol = env.temp_data['cpp:parent_symbol'] parentDecl = parentSymbol.declaration if parentDecl is not None and parentDecl.objectType == 'function': msg = "C++ declarations inside functions are not supported." \ " Parent function: {}\nDirective name: {}\nDirective arg: {}" logger.warning(msg.format( str(parentSymbol.get_full_nested_name()), self.name, self.arguments[0] ), location=self.get_location()) name = _make_phony_error_name() symbol = parentSymbol.add_name(name) env.temp_data['cpp:last_symbol'] = symbol return [] # When multiple declarations are made in the same directive # they need to know about each other to provide symbol lookup for function parameters. # We use last_symbol to store the latest added declaration in a directive. env.temp_data['cpp:last_symbol'] = None return super().run() def handle_signature(self, sig: str, signode: desc_signature) -> ASTDeclaration: parentSymbol: Symbol = self.env.temp_data['cpp:parent_symbol'] parser = DefinitionParser(sig, location=signode, config=self.env.config) try: ast = self.parse_definition(parser) parser.assert_end() except DefinitionError as e: logger.warning(e, location=signode) # It is easier to assume some phony name than handling the error in # the possibly inner declarations. name = _make_phony_error_name() symbol = parentSymbol.add_name(name) self.env.temp_data['cpp:last_symbol'] = symbol raise ValueError from e try: symbol = parentSymbol.add_declaration( ast, docname=self.env.docname, line=self.get_source_info()[1]) # append the new declaration to the sibling list assert symbol.siblingAbove is None assert symbol.siblingBelow is None symbol.siblingAbove = self.env.temp_data['cpp:last_symbol'] if symbol.siblingAbove is not None: assert symbol.siblingAbove.siblingBelow is None symbol.siblingAbove.siblingBelow = symbol self.env.temp_data['cpp:last_symbol'] = symbol except _DuplicateSymbolError as e: # Assume we are actually in the old symbol, # instead of the newly created duplicate. self.env.temp_data['cpp:last_symbol'] = e.symbol msg = __("Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'.") msg = msg % (e.symbol.docname, e.symbol.line, self.display_object_type, sig) logger.warning(msg, location=signode) if ast.objectType == 'enumerator': self._add_enumerator_to_parent(ast) # note: handle_signature may be called multiple time per directive, # if it has multiple signatures, so don't mess with the original options. options = dict(self.options) options['tparam-line-spec'] = 'tparam-line-spec' in self.options self.describe_signature(signode, ast, options) return ast def before_content(self) -> None: lastSymbol: Symbol = self.env.temp_data['cpp:last_symbol'] assert lastSymbol self.oldParentSymbol = self.env.temp_data['cpp:parent_symbol'] self.oldParentKey: LookupKey = self.env.ref_context['cpp:parent_key'] self.env.temp_data['cpp:parent_symbol'] = lastSymbol self.env.ref_context['cpp:parent_key'] = lastSymbol.get_lookup_key() def after_content(self) -> None: self.env.temp_data['cpp:parent_symbol'] = self.oldParentSymbol self.env.ref_context['cpp:parent_key'] = self.oldParentKey class CPPTypeObject(CPPObject): object_type = 'type' class CPPConceptObject(CPPObject): object_type = 'concept' class CPPMemberObject(CPPObject): object_type = 'member' class CPPFunctionObject(CPPObject): object_type = 'function' doc_field_types = CPPObject.doc_field_types + [ GroupedField('parameter', label=_('Parameters'), names=('param', 'parameter', 'arg', 'argument'), can_collapse=True), GroupedField('exceptions', label=_('Throws'), rolename='expr', names=('throws', 'throw', 'exception'), can_collapse=True), GroupedField('retval', label=_('Return values'), names=('retvals', 'retval'), can_collapse=True), Field('returnvalue', label=_('Returns'), has_arg=False, names=('returns', 'return')), ] class CPPClassObject(CPPObject): object_type = 'class' @property def display_object_type(self) -> str: # the distinction between class and struct is only cosmetic assert self.objtype in ('class', 'struct') return self.objtype class CPPUnionObject(CPPObject): object_type = 'union' class CPPEnumObject(CPPObject): object_type = 'enum' class CPPEnumeratorObject(CPPObject): object_type = 'enumerator' class CPPNamespaceObject(SphinxDirective): """ This directive is just to tell Sphinx that we're documenting stuff in namespace foo. """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: rootSymbol = self.env.domaindata['cpp']['root_symbol'] if self.arguments[0].strip() in ('NULL', '0', 'nullptr'): symbol = rootSymbol stack: List[Symbol] = [] else: parser = DefinitionParser(self.arguments[0], location=self.get_location(), config=self.config) try: ast = parser.parse_namespace_object() parser.assert_end() except DefinitionError as e: logger.warning(e, location=self.get_location()) name = _make_phony_error_name() ast = ASTNamespace(name, None) symbol = rootSymbol.add_name(ast.nestedName, ast.templatePrefix) stack = [symbol] self.env.temp_data['cpp:parent_symbol'] = symbol self.env.temp_data['cpp:namespace_stack'] = stack self.env.ref_context['cpp:parent_key'] = symbol.get_lookup_key() return [] class CPPNamespacePushObject(SphinxDirective): has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: if self.arguments[0].strip() in ('NULL', '0', 'nullptr'): return [] parser = DefinitionParser(self.arguments[0], location=self.get_location(), config=self.config) try: ast = parser.parse_namespace_object() parser.assert_end() except DefinitionError as e: logger.warning(e, location=self.get_location()) name = _make_phony_error_name() ast = ASTNamespace(name, None) oldParent = self.env.temp_data.get('cpp:parent_symbol', None) if not oldParent: oldParent = self.env.domaindata['cpp']['root_symbol'] symbol = oldParent.add_name(ast.nestedName, ast.templatePrefix) stack = self.env.temp_data.get('cpp:namespace_stack', []) stack.append(symbol) self.env.temp_data['cpp:parent_symbol'] = symbol self.env.temp_data['cpp:namespace_stack'] = stack self.env.ref_context['cpp:parent_key'] = symbol.get_lookup_key() return [] class CPPNamespacePopObject(SphinxDirective): has_content = False required_arguments = 0 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: stack = self.env.temp_data.get('cpp:namespace_stack', None) if not stack or len(stack) == 0: logger.warning("C++ namespace pop on empty stack. Defaulting to global scope.", location=self.get_location()) stack = [] else: stack.pop() if len(stack) > 0: symbol = stack[-1] else: symbol = self.env.domaindata['cpp']['root_symbol'] self.env.temp_data['cpp:parent_symbol'] = symbol self.env.temp_data['cpp:namespace_stack'] = stack self.env.ref_context['cpp:parent_key'] = symbol.get_lookup_key() return [] class AliasNode(nodes.Element): def __init__(self, sig: str, aliasOptions: dict, env: "BuildEnvironment" = None, parentKey: LookupKey = None) -> None: super().__init__() self.sig = sig self.aliasOptions = aliasOptions if env is not None: if 'cpp:parent_symbol' not in env.temp_data: root = env.domaindata['cpp']['root_symbol'] env.temp_data['cpp:parent_symbol'] = root env.ref_context['cpp:parent_key'] = root.get_lookup_key() self.parentKey = env.ref_context['cpp:parent_key'] else: assert parentKey is not None self.parentKey = parentKey def copy(self) -> 'AliasNode': return self.__class__(self.sig, self.aliasOptions, env=None, parentKey=self.parentKey) class AliasTransform(SphinxTransform): default_priority = ReferencesResolver.default_priority - 1 def _render_symbol(self, s: Symbol, maxdepth: int, skipThis: bool, aliasOptions: dict, renderOptions: dict, document: Any) -> List[Node]: if maxdepth == 0: recurse = True elif maxdepth == 1: recurse = False else: maxdepth -= 1 recurse = True nodes: List[Node] = [] if not skipThis: signode = addnodes.desc_signature('', '') nodes.append(signode) s.declaration.describe_signature(signode, 'markName', self.env, renderOptions) if recurse: if skipThis: childContainer: Union[List[Node], addnodes.desc] = nodes else: content = addnodes.desc_content() desc = addnodes.desc() content.append(desc) desc.document = document desc['domain'] = 'cpp' # 'desctype' is a backwards compatible attribute desc['objtype'] = desc['desctype'] = 'alias' desc['noindex'] = True childContainer = desc for sChild in s._children: if sChild.declaration is None: continue if sChild.declaration.objectType in ("templateParam", "functionParam"): continue childNodes = self._render_symbol( sChild, maxdepth=maxdepth, skipThis=False, aliasOptions=aliasOptions, renderOptions=renderOptions, document=document) childContainer.extend(childNodes) if not skipThis and len(desc.children) != 0: nodes.append(content) return nodes def apply(self, **kwargs: Any) -> None: for node in self.document.traverse(AliasNode): node = cast(AliasNode, node) sig = node.sig parentKey = node.parentKey try: parser = DefinitionParser(sig, location=node, config=self.env.config) ast, isShorthand = parser.parse_xref_object() parser.assert_end() except DefinitionError as e: logger.warning(e, location=node) ast, isShorthand = None, None if ast is None: # could not be parsed, so stop here signode = addnodes.desc_signature(sig, '') signode.clear() signode += addnodes.desc_name(sig, sig) node.replace_self(signode) continue rootSymbol: Symbol = self.env.domains['cpp'].data['root_symbol'] parentSymbol: Symbol = rootSymbol.direct_lookup(parentKey) if not parentSymbol: print("Target: ", sig) print("ParentKey: ", parentKey) print(rootSymbol.dump(1)) assert parentSymbol # should be there symbols: List[Symbol] = [] if isShorthand: assert isinstance(ast, ASTNamespace) ns = ast name = ns.nestedName if ns.templatePrefix: templateDecls = ns.templatePrefix.templates else: templateDecls = [] symbols, failReason = parentSymbol.find_name( nestedName=name, templateDecls=templateDecls, typ='any', templateShorthand=True, matchSelf=True, recurseInAnon=True, searchInSiblings=False) if symbols is None: symbols = [] else: assert isinstance(ast, ASTDeclaration) decl = ast name = decl.name s = parentSymbol.find_declaration(decl, 'any', templateShorthand=True, matchSelf=True, recurseInAnon=True) if s is not None: symbols.append(s) symbols = [s for s in symbols if s.declaration is not None] if len(symbols) == 0: signode = addnodes.desc_signature(sig, '') node.append(signode) signode.clear() signode += addnodes.desc_name(sig, sig) logger.warning("Can not find C++ declaration for alias '%s'." % ast, location=node) node.replace_self(signode) else: nodes = [] renderOptions = { 'tparam-line-spec': False, } for s in symbols: assert s.declaration is not None res = self._render_symbol( s, maxdepth=node.aliasOptions['maxdepth'], skipThis=node.aliasOptions['noroot'], aliasOptions=node.aliasOptions, renderOptions=renderOptions, document=node.document) nodes.extend(res) node.replace_self(nodes) class CPPAliasObject(ObjectDescription): option_spec: OptionSpec = { 'maxdepth': directives.nonnegative_int, 'noroot': directives.flag, } def run(self) -> List[Node]: """ On purpose this doesn't call the ObjectDescription version, but is based on it. Each alias signature may expand into multiple real signatures (an overload set). The code is therefore based on the ObjectDescription version. """ if ':' in self.name: self.domain, self.objtype = self.name.split(':', 1) else: self.domain, self.objtype = '', self.name node = addnodes.desc() node.document = self.state.document node['domain'] = self.domain # 'desctype' is a backwards compatible attribute node['objtype'] = node['desctype'] = self.objtype self.names: List[str] = [] aliasOptions = { 'maxdepth': self.options.get('maxdepth', 1), 'noroot': 'noroot' in self.options, } if aliasOptions['noroot'] and aliasOptions['maxdepth'] == 1: logger.warning("Error in C++ alias declaration." " Requested 'noroot' but 'maxdepth' 1." " When skipping the root declaration," " need 'maxdepth' 0 for infinite or at least 2.", location=self.get_location()) signatures = self.get_signatures() for i, sig in enumerate(signatures): node.append(AliasNode(sig, aliasOptions, env=self.env)) contentnode = addnodes.desc_content() node.append(contentnode) self.before_content() self.state.nested_parse(self.content, self.content_offset, contentnode) self.env.temp_data['object'] = None self.after_content() return [node] class CPPXRefRole(XRefRole): def process_link(self, env: BuildEnvironment, refnode: Element, has_explicit_title: bool, title: str, target: str) -> Tuple[str, str]: refnode.attributes.update(env.ref_context) if not has_explicit_title: # major hax: replace anon names via simple string manipulation. # Can this actually fail? title = anon_identifier_re.sub("[anonymous]", str(title)) if refnode['reftype'] == 'any': # Assume the removal part of fix_parens for :any: refs. # The addition part is done with the reference is resolved. if not has_explicit_title and title.endswith('()'): title = title[:-2] if target.endswith('()'): target = target[:-2] # TODO: should this really be here? if not has_explicit_title: target = target.lstrip('~') # only has a meaning for the title # if the first character is a tilde, don't display the module/class # parts of the contents if title[:1] == '~': title = title[1:] dcolon = title.rfind('::') if dcolon != -1: title = title[dcolon + 2:] return title, target class CPPExprRole(SphinxRole): def __init__(self, asCode: bool) -> None: super().__init__() if asCode: # render the expression as inline code self.class_type = 'cpp-expr' else: # render the expression as inline text self.class_type = 'cpp-texpr' def run(self) -> Tuple[List[Node], List[system_message]]: text = self.text.replace('\n', ' ') parser = DefinitionParser(text, location=self.get_location(), config=self.config) # attempt to mimic XRefRole classes, except that... try: ast = parser.parse_expression() except DefinitionError as ex: logger.warning('Unparseable C++ expression: %r\n%s', text, ex, location=self.get_location()) # see below return [addnodes.desc_inline('cpp', text, text, classes=[self.class_type])], [] parentSymbol = self.env.temp_data.get('cpp:parent_symbol', None) if parentSymbol is None: parentSymbol = self.env.domaindata['cpp']['root_symbol'] # ...most if not all of these classes should really apply to the individual references, # not the container node signode = addnodes.desc_inline('cpp', classes=[self.class_type]) ast.describe_signature(signode, 'markType', self.env, parentSymbol) return [signode], [] class CPPDomain(Domain): """C++ language domain. There are two 'object type' attributes being used:: - Each object created from directives gets an assigned .objtype from ObjectDescription.run. This is simply the directive name. - Each declaration (see the distinction in the directives dict below) has a nested .ast of type ASTDeclaration. That object has .objectType which corresponds to the keys in the object_types dict below. They are the core different types of declarations in C++ that one can document. """ name = 'cpp' label = 'C++' object_types = { 'class': ObjType(_('class'), 'class', 'struct', 'identifier', 'type'), 'union': ObjType(_('union'), 'union', 'identifier', 'type'), 'function': ObjType(_('function'), 'func', 'identifier', 'type'), 'member': ObjType(_('member'), 'member', 'var', 'identifier'), 'type': ObjType(_('type'), 'identifier', 'type'), 'concept': ObjType(_('concept'), 'concept', 'identifier'), 'enum': ObjType(_('enum'), 'enum', 'identifier', 'type'), 'enumerator': ObjType(_('enumerator'), 'enumerator', 'identifier'), # generated object types 'functionParam': ObjType(_('function parameter'), 'identifier', 'member', 'var'), # noqa 'templateParam': ObjType(_('template parameter'), 'identifier', 'class', 'struct', 'union', 'member', 'var', 'type'), # noqa } directives = { # declarations 'class': CPPClassObject, 'struct': CPPClassObject, 'union': CPPUnionObject, 'function': CPPFunctionObject, 'member': CPPMemberObject, 'var': CPPMemberObject, 'type': CPPTypeObject, 'concept': CPPConceptObject, 'enum': CPPEnumObject, 'enum-struct': CPPEnumObject, 'enum-class': CPPEnumObject, 'enumerator': CPPEnumeratorObject, # scope control 'namespace': CPPNamespaceObject, 'namespace-push': CPPNamespacePushObject, 'namespace-pop': CPPNamespacePopObject, # other 'alias': CPPAliasObject } roles = { 'any': CPPXRefRole(), 'class': CPPXRefRole(), 'struct': CPPXRefRole(), 'union': CPPXRefRole(), 'func': CPPXRefRole(fix_parens=True), 'member': CPPXRefRole(), 'var': CPPXRefRole(), 'type': CPPXRefRole(), 'concept': CPPXRefRole(), 'enum': CPPXRefRole(), 'enumerator': CPPXRefRole(), 'expr': CPPExprRole(asCode=True), 'texpr': CPPExprRole(asCode=False) } initial_data = { 'root_symbol': Symbol(None, None, None, None, None, None, None), 'names': {} # full name for indexing -> docname } def clear_doc(self, docname: str) -> None: if Symbol.debug_show_tree: print("clear_doc:", docname) print("\tbefore:") print(self.data['root_symbol'].dump(1)) print("\tbefore end") rootSymbol = self.data['root_symbol'] rootSymbol.clear_doc(docname) if Symbol.debug_show_tree: print("\tafter:") print(self.data['root_symbol'].dump(1)) print("\tafter end") print("clear_doc end:", docname) for name, nDocname in list(self.data['names'].items()): if nDocname == docname: del self.data['names'][name] def process_doc(self, env: BuildEnvironment, docname: str, document: nodes.document) -> None: if Symbol.debug_show_tree: print("process_doc:", docname) print(self.data['root_symbol'].dump(0)) print("process_doc end:", docname) def process_field_xref(self, pnode: pending_xref) -> None: pnode.attributes.update(self.env.ref_context) def merge_domaindata(self, docnames: List[str], otherdata: Dict) -> None: if Symbol.debug_show_tree: print("merge_domaindata:") print("\tself:") print(self.data['root_symbol'].dump(1)) print("\tself end") print("\tother:") print(otherdata['root_symbol'].dump(1)) print("\tother end") self.data['root_symbol'].merge_with(otherdata['root_symbol'], docnames, self.env) ourNames = self.data['names'] for name, docname in otherdata['names'].items(): if docname in docnames: if name not in ourNames: ourNames[name] = docname # no need to warn on duplicates, the symbol merge already does that if Symbol.debug_show_tree: print("\tresult:") print(self.data['root_symbol'].dump(1)) print("\tresult end") print("merge_domaindata end") def _resolve_xref_inner(self, env: BuildEnvironment, fromdocname: str, builder: Builder, typ: str, target: str, node: pending_xref, contnode: Element) -> Tuple[Optional[Element], Optional[str]]: # add parens again for those that could be functions if typ == 'any' or typ == 'func': target += '()' parser = DefinitionParser(target, location=node, config=env.config) try: ast, isShorthand = parser.parse_xref_object() except DefinitionError as e: # as arg to stop flake8 from complaining def findWarning(e: Exception) -> Tuple[str, Exception]: if typ != 'any' and typ != 'func': return target, e # hax on top of the paren hax to try to get correct errors parser2 = DefinitionParser(target[:-2], location=node, config=env.config) try: parser2.parse_xref_object() except DefinitionError as e2: return target[:-2], e2 # strange, that we don't get the error now, use the original return target, e t, ex = findWarning(e) logger.warning('Unparseable C++ cross-reference: %r\n%s', t, ex, location=node) return None, None parentKey: LookupKey = node.get("cpp:parent_key", None) rootSymbol = self.data['root_symbol'] if parentKey: parentSymbol: Symbol = rootSymbol.direct_lookup(parentKey) if not parentSymbol: print("Target: ", target) print("ParentKey: ", parentKey.data) print(rootSymbol.dump(1)) assert parentSymbol # should be there else: parentSymbol = rootSymbol if isShorthand: assert isinstance(ast, ASTNamespace) ns = ast name = ns.nestedName if ns.templatePrefix: templateDecls = ns.templatePrefix.templates else: templateDecls = [] # let's be conservative with the sibling lookup for now searchInSiblings = (not name.rooted) and len(name.names) == 1 symbols, failReason = parentSymbol.find_name( name, templateDecls, typ, templateShorthand=True, matchSelf=True, recurseInAnon=True, searchInSiblings=searchInSiblings) if symbols is None: if typ == 'identifier': if failReason == 'templateParamInQualified': # this is an xref we created as part of a signature, # so don't warn for names nested in template parameters raise NoUri(str(name), typ) s = None else: # just refer to the arbitrarily first symbol s = symbols[0] else: assert isinstance(ast, ASTDeclaration) decl = ast name = decl.name s = parentSymbol.find_declaration(decl, typ, templateShorthand=True, matchSelf=True, recurseInAnon=True) if s is None or s.declaration is None: txtName = str(name) if txtName.startswith('std::') or txtName == 'std': raise NoUri(txtName, typ) return None, None if typ.startswith('cpp:'): typ = typ[4:] declTyp = s.declaration.objectType def checkType() -> bool: if typ == 'any': return True objtypes = self.objtypes_for_role(typ) if objtypes: return declTyp in objtypes print("Type is %s, declaration type is %s" % (typ, declTyp)) assert False if not checkType(): logger.warning("cpp:%s targets a %s (%s).", typ, s.declaration.objectType, s.get_full_nested_name(), location=node) declaration = s.declaration if isShorthand: fullNestedName = s.get_full_nested_name() displayName = fullNestedName.get_display_string().lstrip(':') else: displayName = decl.get_display_string() docname = s.docname assert docname # the non-identifier refs are cross-references, which should be processed: # - fix parenthesis due to operator() and add_function_parentheses if typ != "identifier": title = contnode.pop(0).astext() # If it's operator(), we need to add '()' if explicit function parens # are requested. Then the Sphinx machinery will add another pair. # Also, if it's an 'any' ref that resolves to a function, we need to add # parens as well. # However, if it's a non-shorthand function ref, for a function that # takes no arguments, then we may need to add parens again as well. addParen = 0 if not node.get('refexplicit', False) and declaration.objectType == 'function': if isShorthand: # this is just the normal haxing for 'any' roles if env.config.add_function_parentheses and typ == 'any': addParen += 1 # and now this stuff for operator() if (env.config.add_function_parentheses and typ == 'func' and title.endswith('operator()')): addParen += 1 if ((typ == 'any' or typ == 'func') and title.endswith('operator') and displayName.endswith('operator()')): addParen += 1 else: # our job here is to essentially nullify add_function_parentheses if env.config.add_function_parentheses: if typ == 'any' and displayName.endswith('()'): addParen += 1 elif typ == 'func': if title.endswith('()') and not displayName.endswith('()'): title = title[:-2] else: if displayName.endswith('()'): addParen += 1 if addParen > 0: title += '()' * addParen # and reconstruct the title again contnode += nodes.Text(title) res = make_refnode(builder, fromdocname, docname, declaration.get_newest_id(), contnode, displayName ), declaration.objectType return res def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder, typ: str, target: str, node: pending_xref, contnode: Element ) -> Optional[Element]: return self._resolve_xref_inner(env, fromdocname, builder, typ, target, node, contnode)[0] def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder, target: str, node: pending_xref, contnode: Element ) -> List[Tuple[str, Element]]: with logging.suppress_logging(): retnode, objtype = self._resolve_xref_inner(env, fromdocname, builder, 'any', target, node, contnode) if retnode: if objtype == 'templateParam': return [('cpp:templateParam', retnode)] else: return [('cpp:' + self.role_for_objtype(objtype), retnode)] return [] def get_objects(self) -> Iterator[Tuple[str, str, str, str, str, int]]: rootSymbol = self.data['root_symbol'] for symbol in rootSymbol.get_all_symbols(): if symbol.declaration is None: continue assert symbol.docname fullNestedName = symbol.get_full_nested_name() name = str(fullNestedName).lstrip(':') dispname = fullNestedName.get_display_string().lstrip(':') objectType = symbol.declaration.objectType docname = symbol.docname newestId = symbol.declaration.get_newest_id() yield (name, dispname, objectType, docname, newestId, 1) def get_full_qualified_name(self, node: Element) -> str: target = node.get('reftarget', None) if target is None: return None parentKey: LookupKey = node.get("cpp:parent_key", None) if parentKey is None or len(parentKey.data) <= 0: return None rootSymbol = self.data['root_symbol'] parentSymbol = rootSymbol.direct_lookup(parentKey) parentName = parentSymbol.get_full_nested_name() return '::'.join([str(parentName), target]) def setup(app: Sphinx) -> Dict[str, Any]: app.add_domain(CPPDomain) app.add_config_value("cpp_index_common_prefix", [], 'env') app.add_config_value("cpp_id_attributes", [], 'env') app.add_config_value("cpp_paren_attributes", [], 'env') app.add_post_transform(AliasTransform) # debug stuff app.add_config_value("cpp_debug_lookup", False, '') app.add_config_value("cpp_debug_show_tree", False, '') def initStuff(app): Symbol.debug_lookup = app.config.cpp_debug_lookup Symbol.debug_show_tree = app.config.cpp_debug_show_tree app.config.cpp_index_common_prefix.sort(reverse=True) app.connect("builder-inited", initStuff) return { 'version': 'builtin', 'env_version': 4, 'parallel_read_safe': True, 'parallel_write_safe': True, } ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/domains/index.py����������������������������������������������������������������0000644�0000766�0000024�00000010220�00000000000�016752� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.domains.index ~~~~~~~~~~~~~~~~~~~~ The index domain. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Tuple from docutils import nodes from docutils.nodes import Node, system_message from docutils.parsers.rst import directives from sphinx import addnodes from sphinx.domains import Domain from sphinx.environment import BuildEnvironment from sphinx.util import logging, split_index_msg from sphinx.util.docutils import ReferenceRole, SphinxDirective from sphinx.util.nodes import process_index_entry from sphinx.util.typing import OptionSpec if TYPE_CHECKING: from sphinx.application import Sphinx logger = logging.getLogger(__name__) class IndexDomain(Domain): """Mathematics domain.""" name = 'index' label = 'index' @property def entries(self) -> Dict[str, List[Tuple[str, str, str, str, str]]]: return self.data.setdefault('entries', {}) def clear_doc(self, docname: str) -> None: self.entries.pop(docname, None) def merge_domaindata(self, docnames: Iterable[str], otherdata: Dict) -> None: for docname in docnames: self.entries[docname] = otherdata['entries'][docname] def process_doc(self, env: BuildEnvironment, docname: str, document: Node) -> None: """Process a document after it is read by the environment.""" entries = self.entries.setdefault(env.docname, []) for node in list(document.traverse(addnodes.index)): try: for entry in node['entries']: split_index_msg(entry[0], entry[1]) except ValueError as exc: logger.warning(str(exc), location=node) node.parent.remove(node) else: for entry in node['entries']: entries.append(entry) class IndexDirective(SphinxDirective): """ Directive to add entries to the index. """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = { 'name': directives.unchanged, } def run(self) -> List[Node]: arguments = self.arguments[0].split('\n') if 'name' in self.options: targetname = self.options['name'] targetnode = nodes.target('', '', names=[targetname]) else: targetid = 'index-%s' % self.env.new_serialno('index') targetnode = nodes.target('', '', ids=[targetid]) self.state.document.note_explicit_target(targetnode) indexnode = addnodes.index() indexnode['entries'] = [] indexnode['inline'] = False self.set_source_info(indexnode) for entry in arguments: indexnode['entries'].extend(process_index_entry(entry, targetnode['ids'][0])) return [indexnode, targetnode] class IndexRole(ReferenceRole): def run(self) -> Tuple[List[Node], List[system_message]]: target_id = 'index-%s' % self.env.new_serialno('index') if self.has_explicit_title: # if an explicit target is given, process it as a full entry title = self.title entries = process_index_entry(self.target, target_id) else: # otherwise we just create a single entry if self.target.startswith('!'): title = self.title[1:] entries = [('single', self.target[1:], target_id, 'main', None)] else: title = self.title entries = [('single', self.target, target_id, '', None)] index = addnodes.index(entries=entries) target = nodes.target('', '', ids=[target_id]) text = nodes.Text(title, title) self.set_source_info(index) return [index, target, text], [] def setup(app: "Sphinx") -> Dict[str, Any]: app.add_domain(IndexDomain) app.add_directive('index', IndexDirective) app.add_role('index', IndexRole()) return { 'version': 'builtin', 'env_version': 1, 'parallel_read_safe': True, 'parallel_write_safe': True, } ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/domains/javascript.py�����������������������������������������������������������0000644�0000766�0000024�00000043243�00000000000�020024� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.domains.javascript ~~~~~~~~~~~~~~~~~~~~~~~~~ The JavaScript domain. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Any, Dict, Iterator, List, Optional, Tuple, cast from docutils import nodes from docutils.nodes import Element, Node from docutils.parsers.rst import directives from sphinx import addnodes from sphinx.addnodes import desc_signature, pending_xref from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.directives import ObjectDescription from sphinx.domains import Domain, ObjType from sphinx.domains.python import _pseudo_parse_arglist from sphinx.environment import BuildEnvironment from sphinx.locale import _, __ from sphinx.roles import XRefRole from sphinx.util import logging from sphinx.util.docfields import Field, GroupedField, TypedField from sphinx.util.docutils import SphinxDirective from sphinx.util.nodes import make_id, make_refnode from sphinx.util.typing import OptionSpec logger = logging.getLogger(__name__) class JSObject(ObjectDescription[Tuple[str, str]]): """ Description of a JavaScript object. """ #: If set to ``True`` this object is callable and a `desc_parameterlist` is #: added has_arguments = False #: If ``allow_nesting`` is ``True``, the object prefixes will be accumulated #: based on directive nesting allow_nesting = False option_spec: OptionSpec = { 'noindex': directives.flag, 'noindexentry': directives.flag, } def get_display_prefix(self) -> List[Node]: #: what is displayed right before the documentation entry return [] def handle_signature(self, sig: str, signode: desc_signature) -> Tuple[str, str]: """Breaks down construct signatures Parses out prefix and argument list from construct definition. The namespace and class will be determined by the nesting of domain directives. """ sig = sig.strip() if '(' in sig and sig[-1:] == ')': member, arglist = sig.split('(', 1) member = member.strip() arglist = arglist[:-1].strip() else: member = sig arglist = None # If construct is nested, prefix the current prefix prefix = self.env.ref_context.get('js:object', None) mod_name = self.env.ref_context.get('js:module') name = member try: member_prefix, member_name = member.rsplit('.', 1) except ValueError: member_name = name member_prefix = '' finally: name = member_name if prefix and member_prefix: prefix = '.'.join([prefix, member_prefix]) elif prefix is None and member_prefix: prefix = member_prefix fullname = name if prefix: fullname = '.'.join([prefix, name]) signode['module'] = mod_name signode['object'] = prefix signode['fullname'] = fullname display_prefix = self.get_display_prefix() if display_prefix: signode += addnodes.desc_annotation('', '', *display_prefix) actual_prefix = None if prefix: actual_prefix = prefix elif mod_name: actual_prefix = mod_name if actual_prefix: addName = addnodes.desc_addname('', '') for p in actual_prefix.split('.'): addName += addnodes.desc_sig_name(p, p) addName += addnodes.desc_sig_punctuation('.', '.') signode += addName signode += addnodes.desc_name('', '', addnodes.desc_sig_name(name, name)) if self.has_arguments: if not arglist: signode += addnodes.desc_parameterlist() else: _pseudo_parse_arglist(signode, arglist) return fullname, prefix def add_target_and_index(self, name_obj: Tuple[str, str], sig: str, signode: desc_signature) -> None: mod_name = self.env.ref_context.get('js:module') fullname = (mod_name + '.' if mod_name else '') + name_obj[0] node_id = make_id(self.env, self.state.document, '', fullname) signode['ids'].append(node_id) # Assign old styled node_id not to break old hyperlinks (if possible) # Note: Will be removed in Sphinx-5.0 (RemovedInSphinx50Warning) old_node_id = self.make_old_id(fullname) if old_node_id not in self.state.document.ids and old_node_id not in signode['ids']: signode['ids'].append(old_node_id) self.state.document.note_explicit_target(signode) domain = cast(JavaScriptDomain, self.env.get_domain('js')) domain.note_object(fullname, self.objtype, node_id, location=signode) if 'noindexentry' not in self.options: indextext = self.get_index_text(mod_name, name_obj) if indextext: self.indexnode['entries'].append(('single', indextext, node_id, '', None)) def get_index_text(self, objectname: str, name_obj: Tuple[str, str]) -> str: name, obj = name_obj if self.objtype == 'function': if not obj: return _('%s() (built-in function)') % name return _('%s() (%s method)') % (name, obj) elif self.objtype == 'class': return _('%s() (class)') % name elif self.objtype == 'data': return _('%s (global variable or constant)') % name elif self.objtype == 'attribute': return _('%s (%s attribute)') % (name, obj) return '' def before_content(self) -> None: """Handle object nesting before content :py:class:`JSObject` represents JavaScript language constructs. For constructs that are nestable, this method will build up a stack of the nesting hierarchy so that it can be later de-nested correctly, in :py:meth:`after_content`. For constructs that aren't nestable, the stack is bypassed, and instead only the most recent object is tracked. This object prefix name will be removed with :py:meth:`after_content`. The following keys are used in ``self.env.ref_context``: js:objects Stores the object prefix history. With each nested element, we add the object prefix to this list. When we exit that object's nesting level, :py:meth:`after_content` is triggered and the prefix is removed from the end of the list. js:object Current object prefix. This should generally reflect the last element in the prefix history """ prefix = None if self.names: (obj_name, obj_name_prefix) = self.names.pop() prefix = obj_name_prefix.strip('.') if obj_name_prefix else None if self.allow_nesting: prefix = obj_name if prefix: self.env.ref_context['js:object'] = prefix if self.allow_nesting: objects = self.env.ref_context.setdefault('js:objects', []) objects.append(prefix) def after_content(self) -> None: """Handle object de-nesting after content If this class is a nestable object, removing the last nested class prefix ends further nesting in the object. If this class is not a nestable object, the list of classes should not be altered as we didn't affect the nesting levels in :py:meth:`before_content`. """ objects = self.env.ref_context.setdefault('js:objects', []) if self.allow_nesting: try: objects.pop() except IndexError: pass self.env.ref_context['js:object'] = (objects[-1] if len(objects) > 0 else None) def make_old_id(self, fullname: str) -> str: """Generate old styled node_id for JS objects. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. """ return fullname.replace('$', '_S_') class JSCallable(JSObject): """Description of a JavaScript function, method or constructor.""" has_arguments = True doc_field_types = [ TypedField('arguments', label=_('Arguments'), names=('argument', 'arg', 'parameter', 'param'), typerolename='func', typenames=('paramtype', 'type')), GroupedField('errors', label=_('Throws'), rolename='func', names=('throws', ), can_collapse=True), Field('returnvalue', label=_('Returns'), has_arg=False, names=('returns', 'return')), Field('returntype', label=_('Return type'), has_arg=False, names=('rtype',)), ] class JSConstructor(JSCallable): """Like a callable but with a different prefix.""" allow_nesting = True def get_display_prefix(self) -> List[Node]: return [addnodes.desc_sig_keyword('class', 'class'), addnodes.desc_sig_space()] class JSModule(SphinxDirective): """ Directive to mark description of a new JavaScript module. This directive specifies the module name that will be used by objects that follow this directive. Options ------- noindex If the ``noindex`` option is specified, no linkable elements will be created, and the module won't be added to the global module index. This is useful for splitting up the module definition across multiple sections or files. :param mod_name: Module name """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = False option_spec: OptionSpec = { 'noindex': directives.flag } def run(self) -> List[Node]: mod_name = self.arguments[0].strip() self.env.ref_context['js:module'] = mod_name noindex = 'noindex' in self.options ret: List[Node] = [] if not noindex: domain = cast(JavaScriptDomain, self.env.get_domain('js')) node_id = make_id(self.env, self.state.document, 'module', mod_name) domain.note_module(mod_name, node_id) # Make a duplicate entry in 'objects' to facilitate searching for # the module in JavaScriptDomain.find_obj() domain.note_object(mod_name, 'module', node_id, location=(self.env.docname, self.lineno)) target = nodes.target('', '', ids=[node_id], ismod=True) # Assign old styled node_id not to break old hyperlinks (if possible) # Note: Will be removed in Sphinx-5.0 (RemovedInSphinx50Warning) old_node_id = self.make_old_id(mod_name) if old_node_id not in self.state.document.ids and old_node_id not in target['ids']: target['ids'].append(old_node_id) self.state.document.note_explicit_target(target) ret.append(target) indextext = _('%s (module)') % mod_name inode = addnodes.index(entries=[('single', indextext, node_id, '', None)]) ret.append(inode) return ret def make_old_id(self, modname: str) -> str: """Generate old styled node_id for JS modules. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. """ return 'module-' + modname class JSXRefRole(XRefRole): def process_link(self, env: BuildEnvironment, refnode: Element, has_explicit_title: bool, title: str, target: str) -> Tuple[str, str]: # basically what sphinx.domains.python.PyXRefRole does refnode['js:object'] = env.ref_context.get('js:object') refnode['js:module'] = env.ref_context.get('js:module') if not has_explicit_title: title = title.lstrip('.') target = target.lstrip('~') if title[0:1] == '~': title = title[1:] dot = title.rfind('.') if dot != -1: title = title[dot + 1:] if target[0:1] == '.': target = target[1:] refnode['refspecific'] = True return title, target class JavaScriptDomain(Domain): """JavaScript language domain.""" name = 'js' label = 'JavaScript' # if you add a new object type make sure to edit JSObject.get_index_string object_types = { 'function': ObjType(_('function'), 'func'), 'method': ObjType(_('method'), 'meth'), 'class': ObjType(_('class'), 'class'), 'data': ObjType(_('data'), 'data'), 'attribute': ObjType(_('attribute'), 'attr'), 'module': ObjType(_('module'), 'mod'), } directives = { 'function': JSCallable, 'method': JSCallable, 'class': JSConstructor, 'data': JSObject, 'attribute': JSObject, 'module': JSModule, } roles = { 'func': JSXRefRole(fix_parens=True), 'meth': JSXRefRole(fix_parens=True), 'class': JSXRefRole(fix_parens=True), 'data': JSXRefRole(), 'attr': JSXRefRole(), 'mod': JSXRefRole(), } initial_data: Dict[str, Dict[str, Tuple[str, str]]] = { 'objects': {}, # fullname -> docname, node_id, objtype 'modules': {}, # modname -> docname, node_id } @property def objects(self) -> Dict[str, Tuple[str, str, str]]: return self.data.setdefault('objects', {}) # fullname -> docname, node_id, objtype def note_object(self, fullname: str, objtype: str, node_id: str, location: Any = None) -> None: if fullname in self.objects: docname = self.objects[fullname][0] logger.warning(__('duplicate %s description of %s, other %s in %s'), objtype, fullname, objtype, docname, location=location) self.objects[fullname] = (self.env.docname, node_id, objtype) @property def modules(self) -> Dict[str, Tuple[str, str]]: return self.data.setdefault('modules', {}) # modname -> docname, node_id def note_module(self, modname: str, node_id: str) -> None: self.modules[modname] = (self.env.docname, node_id) def clear_doc(self, docname: str) -> None: for fullname, (pkg_docname, node_id, _l) in list(self.objects.items()): if pkg_docname == docname: del self.objects[fullname] for modname, (pkg_docname, node_id) in list(self.modules.items()): if pkg_docname == docname: del self.modules[modname] def merge_domaindata(self, docnames: List[str], otherdata: Dict) -> None: # XXX check duplicates for fullname, (fn, node_id, objtype) in otherdata['objects'].items(): if fn in docnames: self.objects[fullname] = (fn, node_id, objtype) for mod_name, (pkg_docname, node_id) in otherdata['modules'].items(): if pkg_docname in docnames: self.modules[mod_name] = (pkg_docname, node_id) def find_obj(self, env: BuildEnvironment, mod_name: str, prefix: str, name: str, typ: str, searchorder: int = 0) -> Tuple[str, Tuple[str, str, str]]: if name[-2:] == '()': name = name[:-2] searches = [] if mod_name and prefix: searches.append('.'.join([mod_name, prefix, name])) if mod_name: searches.append('.'.join([mod_name, name])) if prefix: searches.append('.'.join([prefix, name])) searches.append(name) if searchorder == 0: searches.reverse() newname = None for search_name in searches: if search_name in self.objects: newname = search_name return newname, self.objects.get(newname) def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder, typ: str, target: str, node: pending_xref, contnode: Element ) -> Optional[Element]: mod_name = node.get('js:module') prefix = node.get('js:object') searchorder = 1 if node.hasattr('refspecific') else 0 name, obj = self.find_obj(env, mod_name, prefix, target, typ, searchorder) if not obj: return None return make_refnode(builder, fromdocname, obj[0], obj[1], contnode, name) def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder, target: str, node: pending_xref, contnode: Element ) -> List[Tuple[str, Element]]: mod_name = node.get('js:module') prefix = node.get('js:object') name, obj = self.find_obj(env, mod_name, prefix, target, None, 1) if not obj: return [] return [('js:' + self.role_for_objtype(obj[2]), make_refnode(builder, fromdocname, obj[0], obj[1], contnode, name))] def get_objects(self) -> Iterator[Tuple[str, str, str, str, str, int]]: for refname, (docname, node_id, typ) in list(self.objects.items()): yield refname, refname, typ, docname, node_id, 1 def get_full_qualified_name(self, node: Element) -> str: modname = node.get('js:module') prefix = node.get('js:object') target = node.get('reftarget') if target is None: return None else: return '.'.join(filter(None, [modname, prefix, target])) def setup(app: Sphinx) -> Dict[str, Any]: app.add_domain(JavaScriptDomain) return { 'version': 'builtin', 'env_version': 2, 'parallel_read_safe': True, 'parallel_write_safe': True, } �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/domains/math.py�����������������������������������������������������������������0000644�0000766�0000024�00000012644�00000000000�016610� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.domains.math ~~~~~~~~~~~~~~~~~~~ The math domain. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import TYPE_CHECKING, Any, Dict, Iterable, List, Optional, Tuple from docutils import nodes from docutils.nodes import Element, Node, make_id, system_message from sphinx.addnodes import pending_xref from sphinx.domains import Domain from sphinx.environment import BuildEnvironment from sphinx.locale import __ from sphinx.roles import XRefRole from sphinx.util import logging from sphinx.util.nodes import make_refnode if TYPE_CHECKING: from sphinx.application import Sphinx from sphinx.builders import Builder logger = logging.getLogger(__name__) class MathReferenceRole(XRefRole): def result_nodes(self, document: nodes.document, env: BuildEnvironment, node: Element, is_ref: bool) -> Tuple[List[Node], List[system_message]]: node['refdomain'] = 'math' return [node], [] class MathDomain(Domain): """Mathematics domain.""" name = 'math' label = 'mathematics' initial_data: Dict = { 'objects': {}, # labelid -> (docname, eqno) 'has_equations': {}, # docname -> bool } dangling_warnings = { 'eq': 'equation not found: %(target)s', } enumerable_nodes = { # node_class -> (figtype, title_getter) nodes.math_block: ('displaymath', None), } roles = { 'numref': MathReferenceRole(), } @property def equations(self) -> Dict[str, Tuple[str, int]]: return self.data.setdefault('objects', {}) # labelid -> (docname, eqno) def note_equation(self, docname: str, labelid: str, location: Any = None) -> None: if labelid in self.equations: other = self.equations[labelid][0] logger.warning(__('duplicate label of equation %s, other instance in %s') % (labelid, other), location=location) self.equations[labelid] = (docname, self.env.new_serialno('eqno') + 1) def get_equation_number_for(self, labelid: str) -> int: if labelid in self.equations: return self.equations[labelid][1] else: return None def process_doc(self, env: BuildEnvironment, docname: str, document: nodes.document) -> None: def math_node(node: Node) -> bool: return isinstance(node, (nodes.math, nodes.math_block)) self.data['has_equations'][docname] = any(document.traverse(math_node)) def clear_doc(self, docname: str) -> None: for equation_id, (doc, eqno) in list(self.equations.items()): if doc == docname: del self.equations[equation_id] self.data['has_equations'].pop(docname, None) def merge_domaindata(self, docnames: Iterable[str], otherdata: Dict) -> None: for labelid, (doc, eqno) in otherdata['objects'].items(): if doc in docnames: self.equations[labelid] = (doc, eqno) for docname in docnames: self.data['has_equations'][docname] = otherdata['has_equations'][docname] def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: "Builder", typ: str, target: str, node: pending_xref, contnode: Element ) -> Optional[Element]: assert typ in ('eq', 'numref') docname, number = self.equations.get(target, (None, None)) if docname: # TODO: perhaps use rather a sphinx-core provided prefix here? node_id = make_id('equation-%s' % target) if env.config.math_numfig and env.config.numfig: if docname in env.toc_fignumbers: numbers = env.toc_fignumbers[docname]['displaymath'].get(node_id, ()) eqno = '.'.join(map(str, numbers)) else: eqno = '' else: eqno = str(number) try: eqref_format = env.config.math_eqref_format or "({number})" title = nodes.Text(eqref_format.format(number=eqno)) except KeyError as exc: logger.warning(__('Invalid math_eqref_format: %r'), exc, location=node) title = nodes.Text("(%d)" % number) title = nodes.Text("(%d)" % number) return make_refnode(builder, fromdocname, docname, node_id, title) else: return None def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: "Builder", target: str, node: pending_xref, contnode: Element ) -> List[Tuple[str, Element]]: refnode = self.resolve_xref(env, fromdocname, builder, 'eq', target, node, contnode) if refnode is None: return [] else: return [('eq', refnode)] def get_objects(self) -> List: return [] def has_equations(self, docname: str = None) -> bool: if docname: return self.data['has_equations'].get(docname, False) else: return any(self.data['has_equations'].values()) def setup(app: "Sphinx") -> Dict[str, Any]: app.add_domain(MathDomain) app.add_role('eq', MathReferenceRole(warn_dangling=True)) return { 'version': 'builtin', 'env_version': 2, 'parallel_read_safe': True, 'parallel_write_safe': True, } ��������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/domains/python.py���������������������������������������������������������������0000644�0000766�0000024�00000164141�00000000000�017200� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.domains.python ~~~~~~~~~~~~~~~~~~~~~ The Python domain. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import builtins import inspect import re import sys import typing import warnings from inspect import Parameter from typing import Any, Dict, Iterable, Iterator, List, NamedTuple, Optional, Tuple, Type, cast from docutils import nodes from docutils.nodes import Element, Node from docutils.parsers.rst import directives from docutils.parsers.rst.states import Inliner from sphinx import addnodes from sphinx.addnodes import desc_signature, pending_xref, pending_xref_condition from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.deprecation import RemovedInSphinx50Warning, RemovedInSphinx60Warning from sphinx.directives import ObjectDescription from sphinx.domains import Domain, Index, IndexEntry, ObjType from sphinx.environment import BuildEnvironment from sphinx.locale import _, __ from sphinx.pycode.ast import ast from sphinx.pycode.ast import parse as ast_parse from sphinx.roles import XRefRole from sphinx.util import logging from sphinx.util.docfields import Field, GroupedField, TypedField from sphinx.util.docutils import SphinxDirective from sphinx.util.inspect import signature_from_str from sphinx.util.nodes import find_pending_xref_condition, make_id, make_refnode from sphinx.util.typing import OptionSpec, TextlikeNode logger = logging.getLogger(__name__) # REs for Python signatures py_sig_re = re.compile( r'''^ ([\w.]*\.)? # class name(s) (\w+) \s* # thing name (?: \(\s*(.*)\s*\) # optional: arguments (?:\s* -> \s* (.*))? # return annotation )? $ # and nothing more ''', re.VERBOSE) pairindextypes = { 'module': _('module'), 'keyword': _('keyword'), 'operator': _('operator'), 'object': _('object'), 'exception': _('exception'), 'statement': _('statement'), 'builtin': _('built-in function'), } class ObjectEntry(NamedTuple): docname: str node_id: str objtype: str aliased: bool class ModuleEntry(NamedTuple): docname: str node_id: str synopsis: str platform: str deprecated: bool def type_to_xref(text: str, env: BuildEnvironment = None) -> addnodes.pending_xref: """Convert a type string to a cross reference node.""" if text == 'None': reftype = 'obj' else: reftype = 'class' if env: kwargs = {'py:module': env.ref_context.get('py:module'), 'py:class': env.ref_context.get('py:class')} else: kwargs = {} if env.config.python_use_unqualified_type_names: # Note: It would be better to use qualname to describe the object to support support # nested classes. But python domain can't access the real python object because this # module should work not-dynamically. shortname = text.split('.')[-1] contnodes: List[Node] = [pending_xref_condition('', shortname, condition='resolved'), pending_xref_condition('', text, condition='*')] else: contnodes = [nodes.Text(text)] return pending_xref('', *contnodes, refdomain='py', reftype=reftype, reftarget=text, **kwargs) def _parse_annotation(annotation: str, env: BuildEnvironment = None) -> List[Node]: """Parse type annotation.""" def unparse(node: ast.AST) -> List[Node]: if isinstance(node, ast.Attribute): return [nodes.Text("%s.%s" % (unparse(node.value)[0], node.attr))] elif isinstance(node, ast.BinOp): result: List[Node] = unparse(node.left) result.extend(unparse(node.op)) result.extend(unparse(node.right)) return result elif isinstance(node, ast.BitOr): return [addnodes.desc_sig_space(), addnodes.desc_sig_punctuation('', '|'), addnodes.desc_sig_space()] elif isinstance(node, ast.Constant): # type: ignore if node.value is Ellipsis: return [addnodes.desc_sig_punctuation('', "...")] elif isinstance(node.value, bool): return [addnodes.desc_sig_keyword('', repr(node.value))] elif isinstance(node.value, int): return [addnodes.desc_sig_literal_number('', repr(node.value))] elif isinstance(node.value, str): return [addnodes.desc_sig_literal_string('', repr(node.value))] else: # handles None, which is further handled by type_to_xref later # and fallback for other types that should be converted return [nodes.Text(repr(node.value))] elif isinstance(node, ast.Expr): return unparse(node.value) elif isinstance(node, ast.Index): return unparse(node.value) elif isinstance(node, ast.List): result = [addnodes.desc_sig_punctuation('', '[')] if node.elts: # check if there are elements in node.elts to only pop the # last element of result if the for-loop was run at least # once for elem in node.elts: result.extend(unparse(elem)) result.append(addnodes.desc_sig_punctuation('', ',')) result.append(addnodes.desc_sig_space()) result.pop() result.pop() result.append(addnodes.desc_sig_punctuation('', ']')) return result elif isinstance(node, ast.Module): return sum((unparse(e) for e in node.body), []) elif isinstance(node, ast.Name): return [nodes.Text(node.id)] elif isinstance(node, ast.Subscript): result = unparse(node.value) result.append(addnodes.desc_sig_punctuation('', '[')) result.extend(unparse(node.slice)) result.append(addnodes.desc_sig_punctuation('', ']')) # Wrap the Text nodes inside brackets by literal node if the subscript is a Literal if result[0] in ('Literal', 'typing.Literal'): for i, subnode in enumerate(result[1:], start=1): if isinstance(subnode, nodes.Text): result[i] = nodes.literal('', '', subnode) return result elif isinstance(node, ast.Tuple): if node.elts: result = [] for elem in node.elts: result.extend(unparse(elem)) result.append(addnodes.desc_sig_punctuation('', ',')) result.append(addnodes.desc_sig_space()) result.pop() result.pop() else: result = [addnodes.desc_sig_punctuation('', '('), addnodes.desc_sig_punctuation('', ')')] return result else: if sys.version_info < (3, 8): if isinstance(node, ast.Ellipsis): return [addnodes.desc_sig_punctuation('', "...")] elif isinstance(node, ast.NameConstant): return [nodes.Text(node.value)] raise SyntaxError # unsupported syntax if env is None: warnings.warn("The env parameter for _parse_annotation becomes required now.", RemovedInSphinx50Warning, stacklevel=2) try: tree = ast_parse(annotation) result = unparse(tree) for i, node in enumerate(result): if isinstance(node, nodes.literal): result[i] = node[0] elif isinstance(node, nodes.Text) and node.strip(): result[i] = type_to_xref(str(node), env) return result except SyntaxError: return [type_to_xref(annotation, env)] def _parse_arglist(arglist: str, env: BuildEnvironment = None) -> addnodes.desc_parameterlist: """Parse a list of arguments using AST parser""" params = addnodes.desc_parameterlist(arglist) sig = signature_from_str('(%s)' % arglist) last_kind = None for param in sig.parameters.values(): if param.kind != param.POSITIONAL_ONLY and last_kind == param.POSITIONAL_ONLY: # PEP-570: Separator for Positional Only Parameter: / params += addnodes.desc_parameter('', '', addnodes.desc_sig_operator('', '/')) if param.kind == param.KEYWORD_ONLY and last_kind in (param.POSITIONAL_OR_KEYWORD, param.POSITIONAL_ONLY, None): # PEP-3102: Separator for Keyword Only Parameter: * params += addnodes.desc_parameter('', '', addnodes.desc_sig_operator('', '*')) node = addnodes.desc_parameter() if param.kind == param.VAR_POSITIONAL: node += addnodes.desc_sig_operator('', '*') node += addnodes.desc_sig_name('', param.name) elif param.kind == param.VAR_KEYWORD: node += addnodes.desc_sig_operator('', '**') node += addnodes.desc_sig_name('', param.name) else: node += addnodes.desc_sig_name('', param.name) if param.annotation is not param.empty: children = _parse_annotation(param.annotation, env) node += addnodes.desc_sig_punctuation('', ':') node += addnodes.desc_sig_space() node += addnodes.desc_sig_name('', '', *children) # type: ignore if param.default is not param.empty: if param.annotation is not param.empty: node += addnodes.desc_sig_space() node += addnodes.desc_sig_operator('', '=') node += addnodes.desc_sig_space() else: node += addnodes.desc_sig_operator('', '=') node += nodes.inline('', param.default, classes=['default_value'], support_smartquotes=False) params += node last_kind = param.kind if last_kind == Parameter.POSITIONAL_ONLY: # PEP-570: Separator for Positional Only Parameter: / params += addnodes.desc_parameter('', '', addnodes.desc_sig_operator('', '/')) return params def _pseudo_parse_arglist(signode: desc_signature, arglist: str) -> None: """"Parse" a list of arguments separated by commas. Arguments can have "optional" annotations given by enclosing them in brackets. Currently, this will split at any comma, even if it's inside a string literal (e.g. default argument value). """ paramlist = addnodes.desc_parameterlist() stack: List[Element] = [paramlist] try: for argument in arglist.split(','): argument = argument.strip() ends_open = ends_close = 0 while argument.startswith('['): stack.append(addnodes.desc_optional()) stack[-2] += stack[-1] argument = argument[1:].strip() while argument.startswith(']'): stack.pop() argument = argument[1:].strip() while argument.endswith(']') and not argument.endswith('[]'): ends_close += 1 argument = argument[:-1].strip() while argument.endswith('['): ends_open += 1 argument = argument[:-1].strip() if argument: stack[-1] += addnodes.desc_parameter( '', '', addnodes.desc_sig_name(argument, argument)) while ends_open: stack.append(addnodes.desc_optional()) stack[-2] += stack[-1] ends_open -= 1 while ends_close: stack.pop() ends_close -= 1 if len(stack) != 1: raise IndexError except IndexError: # if there are too few or too many elements on the stack, just give up # and treat the whole argument list as one argument, discarding the # already partially populated paramlist node paramlist = addnodes.desc_parameterlist() paramlist += addnodes.desc_parameter(arglist, arglist) signode += paramlist else: signode += paramlist # This override allows our inline type specifiers to behave like :class: link # when it comes to handling "." and "~" prefixes. class PyXrefMixin: def make_xref(self, rolename: str, domain: str, target: str, innernode: Type[TextlikeNode] = nodes.emphasis, contnode: Node = None, env: BuildEnvironment = None, inliner: Inliner = None, location: Node = None) -> Node: # we use inliner=None to make sure we get the old behaviour with a single # pending_xref node result = super().make_xref(rolename, domain, target, # type: ignore innernode, contnode, env, inliner=None, location=None) result['refspecific'] = True result['py:module'] = env.ref_context.get('py:module') result['py:class'] = env.ref_context.get('py:class') if target.startswith(('.', '~')): prefix, result['reftarget'] = target[0], target[1:] if prefix == '.': text = target[1:] elif prefix == '~': text = target.split('.')[-1] for node in list(result.traverse(nodes.Text)): node.parent[node.parent.index(node)] = nodes.Text(text) break elif isinstance(result, pending_xref) and env.config.python_use_unqualified_type_names: children = result.children result.clear() shortname = target.split('.')[-1] textnode = innernode('', shortname) contnodes = [pending_xref_condition('', '', textnode, condition='resolved'), pending_xref_condition('', '', *children, condition='*')] result.extend(contnodes) return result def make_xrefs(self, rolename: str, domain: str, target: str, innernode: Type[TextlikeNode] = nodes.emphasis, contnode: Node = None, env: BuildEnvironment = None, inliner: Inliner = None, location: Node = None) -> List[Node]: delims = r'(\s*[\[\]\(\),](?:\s*or\s)?\s*|\s+or\s+|\s*\|\s*|\.\.\.)' delims_re = re.compile(delims) sub_targets = re.split(delims, target) split_contnode = bool(contnode and contnode.astext() == target) in_literal = False results = [] for sub_target in filter(None, sub_targets): if split_contnode: contnode = nodes.Text(sub_target) if in_literal or delims_re.match(sub_target): results.append(contnode or innernode(sub_target, sub_target)) else: results.append(self.make_xref(rolename, domain, sub_target, innernode, contnode, env, inliner, location)) if sub_target in ('Literal', 'typing.Literal'): in_literal = True return results class PyField(PyXrefMixin, Field): def make_xref(self, rolename: str, domain: str, target: str, innernode: Type[TextlikeNode] = nodes.emphasis, contnode: Node = None, env: BuildEnvironment = None, inliner: Inliner = None, location: Node = None) -> Node: if rolename == 'class' and target == 'None': # None is not a type, so use obj role instead. rolename = 'obj' return super().make_xref(rolename, domain, target, innernode, contnode, env, inliner, location) class PyGroupedField(PyXrefMixin, GroupedField): pass class PyTypedField(PyXrefMixin, TypedField): def make_xref(self, rolename: str, domain: str, target: str, innernode: Type[TextlikeNode] = nodes.emphasis, contnode: Node = None, env: BuildEnvironment = None, inliner: Inliner = None, location: Node = None) -> Node: if rolename == 'class' and target == 'None': # None is not a type, so use obj role instead. rolename = 'obj' return super().make_xref(rolename, domain, target, innernode, contnode, env, inliner, location) class PyObject(ObjectDescription[Tuple[str, str]]): """ Description of a general Python object. :cvar allow_nesting: Class is an object that allows for nested namespaces :vartype allow_nesting: bool """ option_spec: OptionSpec = { 'noindex': directives.flag, 'noindexentry': directives.flag, 'module': directives.unchanged, 'canonical': directives.unchanged, 'annotation': directives.unchanged, } doc_field_types = [ PyTypedField('parameter', label=_('Parameters'), names=('param', 'parameter', 'arg', 'argument', 'keyword', 'kwarg', 'kwparam'), typerolename='class', typenames=('paramtype', 'type'), can_collapse=True), PyTypedField('variable', label=_('Variables'), names=('var', 'ivar', 'cvar'), typerolename='class', typenames=('vartype',), can_collapse=True), PyGroupedField('exceptions', label=_('Raises'), rolename='exc', names=('raises', 'raise', 'exception', 'except'), can_collapse=True), Field('returnvalue', label=_('Returns'), has_arg=False, names=('returns', 'return')), PyField('returntype', label=_('Return type'), has_arg=False, names=('rtype',), bodyrolename='class'), ] allow_nesting = False def get_signature_prefix(self, sig: str) -> List[nodes.Node]: """May return a prefix to put before the object name in the signature. """ return [] def needs_arglist(self) -> bool: """May return true if an empty argument list is to be generated even if the document contains none. """ return False def handle_signature(self, sig: str, signode: desc_signature) -> Tuple[str, str]: """Transform a Python signature into RST nodes. Return (fully qualified name of the thing, classname if any). If inside a class, the current class name is handled intelligently: * it is stripped from the displayed name if present * it is added to the full name (return value) if not present """ m = py_sig_re.match(sig) if m is None: raise ValueError prefix, name, arglist, retann = m.groups() # determine module and class name (if applicable), as well as full name modname = self.options.get('module', self.env.ref_context.get('py:module')) classname = self.env.ref_context.get('py:class') if classname: add_module = False if prefix and (prefix == classname or prefix.startswith(classname + ".")): fullname = prefix + name # class name is given again in the signature prefix = prefix[len(classname):].lstrip('.') elif prefix: # class name is given in the signature, but different # (shouldn't happen) fullname = classname + '.' + prefix + name else: # class name is not given in the signature fullname = classname + '.' + name else: add_module = True if prefix: classname = prefix.rstrip('.') fullname = prefix + name else: classname = '' fullname = name signode['module'] = modname signode['class'] = classname signode['fullname'] = fullname sig_prefix = self.get_signature_prefix(sig) if sig_prefix: if type(sig_prefix) is str: warnings.warn( "Python directive method get_signature_prefix()" " returning a string is deprecated." " It must now return a list of nodes." " Return value was '{}'.".format(sig_prefix), RemovedInSphinx60Warning) signode += addnodes.desc_annotation(sig_prefix, '', # type: ignore nodes.Text(sig_prefix)) # type: ignore else: signode += addnodes.desc_annotation(str(sig_prefix), '', *sig_prefix) if prefix: signode += addnodes.desc_addname(prefix, prefix) elif modname and add_module and self.env.config.add_module_names: nodetext = modname + '.' signode += addnodes.desc_addname(nodetext, nodetext) signode += addnodes.desc_name(name, name) if arglist: try: signode += _parse_arglist(arglist, self.env) except SyntaxError: # fallback to parse arglist original parser. # it supports to represent optional arguments (ex. "func(foo [, bar])") _pseudo_parse_arglist(signode, arglist) except NotImplementedError as exc: logger.warning("could not parse arglist (%r): %s", arglist, exc, location=signode) _pseudo_parse_arglist(signode, arglist) else: if self.needs_arglist(): # for callables, add an empty parameter list signode += addnodes.desc_parameterlist() if retann: children = _parse_annotation(retann, self.env) signode += addnodes.desc_returns(retann, '', *children) anno = self.options.get('annotation') if anno: signode += addnodes.desc_annotation(' ' + anno, '', addnodes.desc_sig_space(), nodes.Text(anno)) return fullname, prefix def get_index_text(self, modname: str, name: Tuple[str, str]) -> str: """Return the text for the index entry of the object.""" raise NotImplementedError('must be implemented in subclasses') def add_target_and_index(self, name_cls: Tuple[str, str], sig: str, signode: desc_signature) -> None: modname = self.options.get('module', self.env.ref_context.get('py:module')) fullname = (modname + '.' if modname else '') + name_cls[0] node_id = make_id(self.env, self.state.document, '', fullname) signode['ids'].append(node_id) # Assign old styled node_id(fullname) not to break old hyperlinks (if possible) # Note: Will removed in Sphinx-5.0 (RemovedInSphinx50Warning) if node_id != fullname and fullname not in self.state.document.ids: signode['ids'].append(fullname) self.state.document.note_explicit_target(signode) domain = cast(PythonDomain, self.env.get_domain('py')) domain.note_object(fullname, self.objtype, node_id, location=signode) canonical_name = self.options.get('canonical') if canonical_name: domain.note_object(canonical_name, self.objtype, node_id, aliased=True, location=signode) if 'noindexentry' not in self.options: indextext = self.get_index_text(modname, name_cls) if indextext: self.indexnode['entries'].append(('single', indextext, node_id, '', None)) def before_content(self) -> None: """Handle object nesting before content :py:class:`PyObject` represents Python language constructs. For constructs that are nestable, such as a Python classes, this method will build up a stack of the nesting hierarchy so that it can be later de-nested correctly, in :py:meth:`after_content`. For constructs that aren't nestable, the stack is bypassed, and instead only the most recent object is tracked. This object prefix name will be removed with :py:meth:`after_content`. """ prefix = None if self.names: # fullname and name_prefix come from the `handle_signature` method. # fullname represents the full object name that is constructed using # object nesting and explicit prefixes. `name_prefix` is the # explicit prefix given in a signature (fullname, name_prefix) = self.names[-1] if self.allow_nesting: prefix = fullname elif name_prefix: prefix = name_prefix.strip('.') if prefix: self.env.ref_context['py:class'] = prefix if self.allow_nesting: classes = self.env.ref_context.setdefault('py:classes', []) classes.append(prefix) if 'module' in self.options: modules = self.env.ref_context.setdefault('py:modules', []) modules.append(self.env.ref_context.get('py:module')) self.env.ref_context['py:module'] = self.options['module'] def after_content(self) -> None: """Handle object de-nesting after content If this class is a nestable object, removing the last nested class prefix ends further nesting in the object. If this class is not a nestable object, the list of classes should not be altered as we didn't affect the nesting levels in :py:meth:`before_content`. """ classes = self.env.ref_context.setdefault('py:classes', []) if self.allow_nesting: try: classes.pop() except IndexError: pass self.env.ref_context['py:class'] = (classes[-1] if len(classes) > 0 else None) if 'module' in self.options: modules = self.env.ref_context.setdefault('py:modules', []) if modules: self.env.ref_context['py:module'] = modules.pop() else: self.env.ref_context.pop('py:module') class PyFunction(PyObject): """Description of a function.""" option_spec: OptionSpec = PyObject.option_spec.copy() option_spec.update({ 'async': directives.flag, }) def get_signature_prefix(self, sig: str) -> List[nodes.Node]: if 'async' in self.options: return [addnodes.desc_sig_keyword('', 'async'), addnodes.desc_sig_space()] else: return [] def needs_arglist(self) -> bool: return True def add_target_and_index(self, name_cls: Tuple[str, str], sig: str, signode: desc_signature) -> None: super().add_target_and_index(name_cls, sig, signode) if 'noindexentry' not in self.options: modname = self.options.get('module', self.env.ref_context.get('py:module')) node_id = signode['ids'][0] name, cls = name_cls if modname: text = _('%s() (in module %s)') % (name, modname) self.indexnode['entries'].append(('single', text, node_id, '', None)) else: text = '%s; %s()' % (pairindextypes['builtin'], name) self.indexnode['entries'].append(('pair', text, node_id, '', None)) def get_index_text(self, modname: str, name_cls: Tuple[str, str]) -> str: # add index in own add_target_and_index() instead. return None class PyDecoratorFunction(PyFunction): """Description of a decorator.""" def run(self) -> List[Node]: # a decorator function is a function after all self.name = 'py:function' return super().run() def handle_signature(self, sig: str, signode: desc_signature) -> Tuple[str, str]: ret = super().handle_signature(sig, signode) signode.insert(0, addnodes.desc_addname('@', '@')) return ret def needs_arglist(self) -> bool: return False class PyVariable(PyObject): """Description of a variable.""" option_spec: OptionSpec = PyObject.option_spec.copy() option_spec.update({ 'type': directives.unchanged, 'value': directives.unchanged, }) def handle_signature(self, sig: str, signode: desc_signature) -> Tuple[str, str]: fullname, prefix = super().handle_signature(sig, signode) typ = self.options.get('type') if typ: annotations = _parse_annotation(typ, self.env) signode += addnodes.desc_annotation(typ, '', addnodes.desc_sig_punctuation('', ':'), addnodes.desc_sig_space(), *annotations) value = self.options.get('value') if value: signode += addnodes.desc_annotation(value, '', addnodes.desc_sig_space(), addnodes.desc_sig_punctuation('', '='), addnodes.desc_sig_space(), nodes.Text(value)) return fullname, prefix def get_index_text(self, modname: str, name_cls: Tuple[str, str]) -> str: name, cls = name_cls if modname: return _('%s (in module %s)') % (name, modname) else: return _('%s (built-in variable)') % name class PyClasslike(PyObject): """ Description of a class-like object (classes, interfaces, exceptions). """ option_spec: OptionSpec = PyObject.option_spec.copy() option_spec.update({ 'final': directives.flag, }) allow_nesting = True def get_signature_prefix(self, sig: str) -> List[nodes.Node]: if 'final' in self.options: return [nodes.Text('final'), addnodes.desc_sig_space(), nodes.Text(self.objtype), addnodes.desc_sig_space()] else: return [nodes.Text(self.objtype), addnodes.desc_sig_space()] def get_index_text(self, modname: str, name_cls: Tuple[str, str]) -> str: if self.objtype == 'class': if not modname: return _('%s (built-in class)') % name_cls[0] return _('%s (class in %s)') % (name_cls[0], modname) elif self.objtype == 'exception': return name_cls[0] else: return '' class PyMethod(PyObject): """Description of a method.""" option_spec: OptionSpec = PyObject.option_spec.copy() option_spec.update({ 'abstractmethod': directives.flag, 'async': directives.flag, 'classmethod': directives.flag, 'final': directives.flag, 'property': directives.flag, 'staticmethod': directives.flag, }) def needs_arglist(self) -> bool: if 'property' in self.options: return False else: return True def get_signature_prefix(self, sig: str) -> List[nodes.Node]: prefix: List[nodes.Node] = [] if 'final' in self.options: prefix.append(nodes.Text('final')) prefix.append(addnodes.desc_sig_space()) if 'abstractmethod' in self.options: prefix.append(nodes.Text('abstract')) prefix.append(addnodes.desc_sig_space()) if 'async' in self.options: prefix.append(nodes.Text('async')) prefix.append(addnodes.desc_sig_space()) if 'classmethod' in self.options: prefix.append(nodes.Text('classmethod')) prefix.append(addnodes.desc_sig_space()) if 'property' in self.options: prefix.append(nodes.Text('property')) prefix.append(addnodes.desc_sig_space()) if 'staticmethod' in self.options: prefix.append(nodes.Text('static')) prefix.append(addnodes.desc_sig_space()) return prefix def get_index_text(self, modname: str, name_cls: Tuple[str, str]) -> str: name, cls = name_cls try: clsname, methname = name.rsplit('.', 1) if modname and self.env.config.add_module_names: clsname = '.'.join([modname, clsname]) except ValueError: if modname: return _('%s() (in module %s)') % (name, modname) else: return '%s()' % name if 'classmethod' in self.options: return _('%s() (%s class method)') % (methname, clsname) elif 'property' in self.options: return _('%s (%s property)') % (methname, clsname) elif 'staticmethod' in self.options: return _('%s() (%s static method)') % (methname, clsname) else: return _('%s() (%s method)') % (methname, clsname) class PyClassMethod(PyMethod): """Description of a classmethod.""" option_spec: OptionSpec = PyObject.option_spec.copy() def run(self) -> List[Node]: self.name = 'py:method' self.options['classmethod'] = True return super().run() class PyStaticMethod(PyMethod): """Description of a staticmethod.""" option_spec: OptionSpec = PyObject.option_spec.copy() def run(self) -> List[Node]: self.name = 'py:method' self.options['staticmethod'] = True return super().run() class PyDecoratorMethod(PyMethod): """Description of a decoratormethod.""" def run(self) -> List[Node]: self.name = 'py:method' return super().run() def handle_signature(self, sig: str, signode: desc_signature) -> Tuple[str, str]: ret = super().handle_signature(sig, signode) signode.insert(0, addnodes.desc_addname('@', '@')) return ret def needs_arglist(self) -> bool: return False class PyAttribute(PyObject): """Description of an attribute.""" option_spec: OptionSpec = PyObject.option_spec.copy() option_spec.update({ 'type': directives.unchanged, 'value': directives.unchanged, }) def handle_signature(self, sig: str, signode: desc_signature) -> Tuple[str, str]: fullname, prefix = super().handle_signature(sig, signode) typ = self.options.get('type') if typ: annotations = _parse_annotation(typ, self.env) signode += addnodes.desc_annotation(typ, '', addnodes.desc_sig_punctuation('', ':'), addnodes.desc_sig_space(), *annotations) value = self.options.get('value') if value: signode += addnodes.desc_annotation(value, '', addnodes.desc_sig_space(), addnodes.desc_sig_punctuation('', '='), addnodes.desc_sig_space(), nodes.Text(value)) return fullname, prefix def get_index_text(self, modname: str, name_cls: Tuple[str, str]) -> str: name, cls = name_cls try: clsname, attrname = name.rsplit('.', 1) if modname and self.env.config.add_module_names: clsname = '.'.join([modname, clsname]) except ValueError: if modname: return _('%s (in module %s)') % (name, modname) else: return name return _('%s (%s attribute)') % (attrname, clsname) class PyProperty(PyObject): """Description of an attribute.""" option_spec = PyObject.option_spec.copy() option_spec.update({ 'abstractmethod': directives.flag, 'classmethod': directives.flag, 'type': directives.unchanged, }) def handle_signature(self, sig: str, signode: desc_signature) -> Tuple[str, str]: fullname, prefix = super().handle_signature(sig, signode) typ = self.options.get('type') if typ: annotations = _parse_annotation(typ, self.env) signode += addnodes.desc_annotation(typ, '', addnodes.desc_sig_punctuation('', ':'), addnodes.desc_sig_space(), *annotations) return fullname, prefix def get_signature_prefix(self, sig: str) -> List[nodes.Node]: prefix: List[nodes.Node] = [] if 'abstractmethod' in self.options: prefix.append(nodes.Text('abstract')) prefix.append(addnodes.desc_sig_space()) if 'classmethod' in self.options: prefix.append(nodes.Text('class')) prefix.append(addnodes.desc_sig_space()) prefix.append(nodes.Text('property')) prefix.append(addnodes.desc_sig_space()) return prefix def get_index_text(self, modname: str, name_cls: Tuple[str, str]) -> str: name, cls = name_cls try: clsname, attrname = name.rsplit('.', 1) if modname and self.env.config.add_module_names: clsname = '.'.join([modname, clsname]) except ValueError: if modname: return _('%s (in module %s)') % (name, modname) else: return name return _('%s (%s property)') % (attrname, clsname) class PyDecoratorMixin: """ Mixin for decorator directives. """ def handle_signature(self, sig: str, signode: desc_signature) -> Tuple[str, str]: for cls in self.__class__.__mro__: if cls.__name__ != 'DirectiveAdapter': warnings.warn('PyDecoratorMixin is deprecated. ' 'Please check the implementation of %s' % cls, RemovedInSphinx50Warning, stacklevel=2) break else: warnings.warn('PyDecoratorMixin is deprecated', RemovedInSphinx50Warning, stacklevel=2) ret = super().handle_signature(sig, signode) # type: ignore signode.insert(0, addnodes.desc_addname('@', '@')) return ret def needs_arglist(self) -> bool: return False class PyModule(SphinxDirective): """ Directive to mark description of a new module. """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = False option_spec: OptionSpec = { 'platform': lambda x: x, 'synopsis': lambda x: x, 'noindex': directives.flag, 'deprecated': directives.flag, } def run(self) -> List[Node]: domain = cast(PythonDomain, self.env.get_domain('py')) modname = self.arguments[0].strip() noindex = 'noindex' in self.options self.env.ref_context['py:module'] = modname ret: List[Node] = [] if not noindex: # note module to the domain node_id = make_id(self.env, self.state.document, 'module', modname) target = nodes.target('', '', ids=[node_id], ismod=True) self.set_source_info(target) # Assign old styled node_id not to break old hyperlinks (if possible) # Note: Will removed in Sphinx-5.0 (RemovedInSphinx50Warning) old_node_id = self.make_old_id(modname) if node_id != old_node_id and old_node_id not in self.state.document.ids: target['ids'].append(old_node_id) self.state.document.note_explicit_target(target) domain.note_module(modname, node_id, self.options.get('synopsis', ''), self.options.get('platform', ''), 'deprecated' in self.options) domain.note_object(modname, 'module', node_id, location=target) # the platform and synopsis aren't printed; in fact, they are only # used in the modindex currently ret.append(target) indextext = '%s; %s' % (pairindextypes['module'], modname) inode = addnodes.index(entries=[('pair', indextext, node_id, '', None)]) ret.append(inode) return ret def make_old_id(self, name: str) -> str: """Generate old styled node_id. Old styled node_id is incompatible with docutils' node_id. It can contain dots and hyphens. .. note:: Old styled node_id was mainly used until Sphinx-3.0. """ return 'module-%s' % name class PyCurrentModule(SphinxDirective): """ This directive is just to tell Sphinx that we're documenting stuff in module foo, but links to module foo won't lead here. """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = False option_spec: OptionSpec = {} def run(self) -> List[Node]: modname = self.arguments[0].strip() if modname == 'None': self.env.ref_context.pop('py:module', None) else: self.env.ref_context['py:module'] = modname return [] class PyXRefRole(XRefRole): def process_link(self, env: BuildEnvironment, refnode: Element, has_explicit_title: bool, title: str, target: str) -> Tuple[str, str]: refnode['py:module'] = env.ref_context.get('py:module') refnode['py:class'] = env.ref_context.get('py:class') if not has_explicit_title: title = title.lstrip('.') # only has a meaning for the target target = target.lstrip('~') # only has a meaning for the title # if the first character is a tilde, don't display the module/class # parts of the contents if title[0:1] == '~': title = title[1:] dot = title.rfind('.') if dot != -1: title = title[dot + 1:] # if the first character is a dot, search more specific namespaces first # else search builtins first if target[0:1] == '.': target = target[1:] refnode['refspecific'] = True return title, target def filter_meta_fields(app: Sphinx, domain: str, objtype: str, content: Element) -> None: """Filter ``:meta:`` field from its docstring.""" if domain != 'py': return for node in content: if isinstance(node, nodes.field_list): fields = cast(List[nodes.field], node) for field in fields: field_name = cast(nodes.field_body, field[0]).astext().strip() if field_name == 'meta' or field_name.startswith('meta '): node.remove(field) break class PythonModuleIndex(Index): """ Index subclass to provide the Python module index. """ name = 'modindex' localname = _('Python Module Index') shortname = _('modules') def generate(self, docnames: Iterable[str] = None ) -> Tuple[List[Tuple[str, List[IndexEntry]]], bool]: content: Dict[str, List[IndexEntry]] = {} # list of prefixes to ignore ignores: List[str] = self.domain.env.config['modindex_common_prefix'] ignores = sorted(ignores, key=len, reverse=True) # list of all modules, sorted by module name modules = sorted(self.domain.data['modules'].items(), key=lambda x: x[0].lower()) # sort out collapsible modules prev_modname = '' num_toplevels = 0 for modname, (docname, node_id, synopsis, platforms, deprecated) in modules: if docnames and docname not in docnames: continue for ignore in ignores: if modname.startswith(ignore): modname = modname[len(ignore):] stripped = ignore break else: stripped = '' # we stripped the whole module name? if not modname: modname, stripped = stripped, '' entries = content.setdefault(modname[0].lower(), []) package = modname.split('.')[0] if package != modname: # it's a submodule if prev_modname == package: # first submodule - make parent a group head if entries: last = entries[-1] entries[-1] = IndexEntry(last[0], 1, last[2], last[3], last[4], last[5], last[6]) elif not prev_modname.startswith(package): # submodule without parent in list, add dummy entry entries.append(IndexEntry(stripped + package, 1, '', '', '', '', '')) subtype = 2 else: num_toplevels += 1 subtype = 0 qualifier = _('Deprecated') if deprecated else '' entries.append(IndexEntry(stripped + modname, subtype, docname, node_id, platforms, qualifier, synopsis)) prev_modname = modname # apply heuristics when to collapse modindex at page load: # only collapse if number of toplevel modules is larger than # number of submodules collapse = len(modules) - num_toplevels < num_toplevels # sort by first letter sorted_content = sorted(content.items()) return sorted_content, collapse class PythonDomain(Domain): """Python language domain.""" name = 'py' label = 'Python' object_types: Dict[str, ObjType] = { 'function': ObjType(_('function'), 'func', 'obj'), 'data': ObjType(_('data'), 'data', 'obj'), 'class': ObjType(_('class'), 'class', 'exc', 'obj'), 'exception': ObjType(_('exception'), 'exc', 'class', 'obj'), 'method': ObjType(_('method'), 'meth', 'obj'), 'classmethod': ObjType(_('class method'), 'meth', 'obj'), 'staticmethod': ObjType(_('static method'), 'meth', 'obj'), 'attribute': ObjType(_('attribute'), 'attr', 'obj'), 'property': ObjType(_('property'), 'attr', '_prop', 'obj'), 'module': ObjType(_('module'), 'mod', 'obj'), } directives = { 'function': PyFunction, 'data': PyVariable, 'class': PyClasslike, 'exception': PyClasslike, 'method': PyMethod, 'classmethod': PyClassMethod, 'staticmethod': PyStaticMethod, 'attribute': PyAttribute, 'property': PyProperty, 'module': PyModule, 'currentmodule': PyCurrentModule, 'decorator': PyDecoratorFunction, 'decoratormethod': PyDecoratorMethod, } roles = { 'data': PyXRefRole(), 'exc': PyXRefRole(), 'func': PyXRefRole(fix_parens=True), 'class': PyXRefRole(), 'const': PyXRefRole(), 'attr': PyXRefRole(), 'meth': PyXRefRole(fix_parens=True), 'mod': PyXRefRole(), 'obj': PyXRefRole(), } initial_data: Dict[str, Dict[str, Tuple[Any]]] = { 'objects': {}, # fullname -> docname, objtype 'modules': {}, # modname -> docname, synopsis, platform, deprecated } indices = [ PythonModuleIndex, ] @property def objects(self) -> Dict[str, ObjectEntry]: return self.data.setdefault('objects', {}) # fullname -> ObjectEntry def note_object(self, name: str, objtype: str, node_id: str, aliased: bool = False, location: Any = None) -> None: """Note a python object for cross reference. .. versionadded:: 2.1 """ if name in self.objects: other = self.objects[name] if other.aliased and aliased is False: # The original definition found. Override it! pass elif other.aliased is False and aliased: # The original definition is already registered. return else: # duplicated logger.warning(__('duplicate object description of %s, ' 'other instance in %s, use :noindex: for one of them'), name, other.docname, location=location) self.objects[name] = ObjectEntry(self.env.docname, node_id, objtype, aliased) @property def modules(self) -> Dict[str, ModuleEntry]: return self.data.setdefault('modules', {}) # modname -> ModuleEntry def note_module(self, name: str, node_id: str, synopsis: str, platform: str, deprecated: bool) -> None: """Note a python module for cross reference. .. versionadded:: 2.1 """ self.modules[name] = ModuleEntry(self.env.docname, node_id, synopsis, platform, deprecated) def clear_doc(self, docname: str) -> None: for fullname, obj in list(self.objects.items()): if obj.docname == docname: del self.objects[fullname] for modname, mod in list(self.modules.items()): if mod.docname == docname: del self.modules[modname] def merge_domaindata(self, docnames: List[str], otherdata: Dict) -> None: # XXX check duplicates? for fullname, obj in otherdata['objects'].items(): if obj.docname in docnames: self.objects[fullname] = obj for modname, mod in otherdata['modules'].items(): if mod.docname in docnames: self.modules[modname] = mod def find_obj(self, env: BuildEnvironment, modname: str, classname: str, name: str, type: str, searchmode: int = 0 ) -> List[Tuple[str, ObjectEntry]]: """Find a Python object for "name", perhaps using the given module and/or classname. Returns a list of (name, object entry) tuples. """ # skip parens if name[-2:] == '()': name = name[:-2] if not name: return [] matches: List[Tuple[str, ObjectEntry]] = [] newname = None if searchmode == 1: if type is None: objtypes = list(self.object_types) else: objtypes = self.objtypes_for_role(type) if objtypes is not None: if modname and classname: fullname = modname + '.' + classname + '.' + name if fullname in self.objects and self.objects[fullname].objtype in objtypes: newname = fullname if not newname: if modname and modname + '.' + name in self.objects and \ self.objects[modname + '.' + name].objtype in objtypes: newname = modname + '.' + name elif name in self.objects and self.objects[name].objtype in objtypes: newname = name else: # "fuzzy" searching mode searchname = '.' + name matches = [(oname, self.objects[oname]) for oname in self.objects if oname.endswith(searchname) and self.objects[oname].objtype in objtypes] else: # NOTE: searching for exact match, object type is not considered if name in self.objects: newname = name elif type == 'mod': # only exact matches allowed for modules return [] elif classname and classname + '.' + name in self.objects: newname = classname + '.' + name elif modname and modname + '.' + name in self.objects: newname = modname + '.' + name elif modname and classname and \ modname + '.' + classname + '.' + name in self.objects: newname = modname + '.' + classname + '.' + name if newname is not None: matches.append((newname, self.objects[newname])) return matches def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder, type: str, target: str, node: pending_xref, contnode: Element ) -> Optional[Element]: modname = node.get('py:module') clsname = node.get('py:class') searchmode = 1 if node.hasattr('refspecific') else 0 matches = self.find_obj(env, modname, clsname, target, type, searchmode) if not matches and type == 'attr': # fallback to meth (for property; Sphinx-2.4.x) # this ensures that `:attr:` role continues to refer to the old property entry # that defined by ``method`` directive in old reST files. matches = self.find_obj(env, modname, clsname, target, 'meth', searchmode) if not matches and type == 'meth': # fallback to attr (for property) # this ensures that `:meth:` in the old reST files can refer to the property # entry that defined by ``property`` directive. # # Note: _prop is a secret role only for internal look-up. matches = self.find_obj(env, modname, clsname, target, '_prop', searchmode) if not matches: return None elif len(matches) > 1: canonicals = [m for m in matches if not m[1].aliased] if len(canonicals) == 1: matches = canonicals else: logger.warning(__('more than one target found for cross-reference %r: %s'), target, ', '.join(match[0] for match in matches), type='ref', subtype='python', location=node) name, obj = matches[0] if obj[2] == 'module': return self._make_module_refnode(builder, fromdocname, name, contnode) else: # determine the content of the reference by conditions content = find_pending_xref_condition(node, 'resolved') if content: children = content.children else: # if not found, use contnode children = [contnode] return make_refnode(builder, fromdocname, obj[0], obj[1], children, name) def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder, target: str, node: pending_xref, contnode: Element ) -> List[Tuple[str, Element]]: modname = node.get('py:module') clsname = node.get('py:class') results: List[Tuple[str, Element]] = [] # always search in "refspecific" mode with the :any: role matches = self.find_obj(env, modname, clsname, target, None, 1) for name, obj in matches: if obj[2] == 'module': results.append(('py:mod', self._make_module_refnode(builder, fromdocname, name, contnode))) else: # determine the content of the reference by conditions content = find_pending_xref_condition(node, 'resolved') if content: children = content.children else: # if not found, use contnode children = [contnode] results.append(('py:' + self.role_for_objtype(obj[2]), make_refnode(builder, fromdocname, obj[0], obj[1], children, name))) return results def _make_module_refnode(self, builder: Builder, fromdocname: str, name: str, contnode: Node) -> Element: # get additional info for modules module = self.modules[name] title = name if module.synopsis: title += ': ' + module.synopsis if module.deprecated: title += _(' (deprecated)') if module.platform: title += ' (' + module.platform + ')' return make_refnode(builder, fromdocname, module.docname, module.node_id, contnode, title) def get_objects(self) -> Iterator[Tuple[str, str, str, str, str, int]]: for modname, mod in self.modules.items(): yield (modname, modname, 'module', mod.docname, mod.node_id, 0) for refname, obj in self.objects.items(): if obj.objtype != 'module': # modules are already handled if obj.aliased: # aliased names are not full-text searchable. yield (refname, refname, obj.objtype, obj.docname, obj.node_id, -1) else: yield (refname, refname, obj.objtype, obj.docname, obj.node_id, 1) def get_full_qualified_name(self, node: Element) -> Optional[str]: modname = node.get('py:module') clsname = node.get('py:class') target = node.get('reftarget') if target is None: return None else: return '.'.join(filter(None, [modname, clsname, target])) def builtin_resolver(app: Sphinx, env: BuildEnvironment, node: pending_xref, contnode: Element) -> Element: """Do not emit nitpicky warnings for built-in types.""" def istyping(s: str) -> bool: if s.startswith('typing.'): s = s.split('.', 1)[1] return s in typing.__all__ # type: ignore if node.get('refdomain') != 'py': return None elif node.get('reftype') in ('class', 'obj') and node.get('reftarget') == 'None': return contnode elif node.get('reftype') in ('class', 'exc'): reftarget = node.get('reftarget') if inspect.isclass(getattr(builtins, reftarget, None)): # built-in class return contnode elif istyping(reftarget): # typing class return contnode return None def setup(app: Sphinx) -> Dict[str, Any]: app.setup_extension('sphinx.directives') app.add_domain(PythonDomain) app.add_config_value('python_use_unqualified_type_names', False, 'env') app.connect('object-description-transform', filter_meta_fields) app.connect('missing-reference', builtin_resolver, priority=900) return { 'version': 'builtin', 'env_version': 3, 'parallel_read_safe': True, 'parallel_write_safe': True, } �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/domains/rst.py������������������������������������������������������������������0000644�0000766�0000024�00000024053�00000000000�016464� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.domains.rst ~~~~~~~~~~~~~~~~~~ The reStructuredText domain. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import re from typing import Any, Dict, Iterator, List, Optional, Tuple, cast from docutils.nodes import Element from docutils.parsers.rst import directives from sphinx import addnodes from sphinx.addnodes import desc_signature, pending_xref from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.directives import ObjectDescription from sphinx.domains import Domain, ObjType from sphinx.environment import BuildEnvironment from sphinx.locale import _, __ from sphinx.roles import XRefRole from sphinx.util import logging from sphinx.util.nodes import make_id, make_refnode from sphinx.util.typing import OptionSpec logger = logging.getLogger(__name__) dir_sig_re = re.compile(r'\.\. (.+?)::(.*)$') class ReSTMarkup(ObjectDescription[str]): """ Description of generic reST markup. """ def add_target_and_index(self, name: str, sig: str, signode: desc_signature) -> None: node_id = make_id(self.env, self.state.document, self.objtype, name) signode['ids'].append(node_id) # Assign old styled node_id not to break old hyperlinks (if possible) # Note: Will be removed in Sphinx-5.0 (RemovedInSphinx50Warning) old_node_id = self.make_old_id(name) if old_node_id not in self.state.document.ids and old_node_id not in signode['ids']: signode['ids'].append(old_node_id) self.state.document.note_explicit_target(signode) domain = cast(ReSTDomain, self.env.get_domain('rst')) domain.note_object(self.objtype, name, node_id, location=signode) indextext = self.get_index_text(self.objtype, name) if indextext: self.indexnode['entries'].append(('single', indextext, node_id, '', None)) def get_index_text(self, objectname: str, name: str) -> str: return '' def make_old_id(self, name: str) -> str: """Generate old styled node_id for reST markups. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. """ return self.objtype + '-' + name def parse_directive(d: str) -> Tuple[str, str]: """Parse a directive signature. Returns (directive, arguments) string tuple. If no arguments are given, returns (directive, ''). """ dir = d.strip() if not dir.startswith('.'): # Assume it is a directive without syntax return (dir, '') m = dir_sig_re.match(dir) if not m: return (dir, '') parsed_dir, parsed_args = m.groups() if parsed_args.strip(): return (parsed_dir.strip(), ' ' + parsed_args.strip()) else: return (parsed_dir.strip(), '') class ReSTDirective(ReSTMarkup): """ Description of a reST directive. """ def handle_signature(self, sig: str, signode: desc_signature) -> str: name, args = parse_directive(sig) desc_name = '.. %s::' % name signode += addnodes.desc_name(desc_name, desc_name) if len(args) > 0: signode += addnodes.desc_addname(args, args) return name def get_index_text(self, objectname: str, name: str) -> str: return _('%s (directive)') % name def before_content(self) -> None: if self.names: directives = self.env.ref_context.setdefault('rst:directives', []) directives.append(self.names[0]) def after_content(self) -> None: directives = self.env.ref_context.setdefault('rst:directives', []) if directives: directives.pop() class ReSTDirectiveOption(ReSTMarkup): """ Description of an option for reST directive. """ option_spec: OptionSpec = ReSTMarkup.option_spec.copy() option_spec.update({ 'type': directives.unchanged, }) def handle_signature(self, sig: str, signode: desc_signature) -> str: try: name, argument = re.split(r'\s*:\s+', sig.strip(), 1) except ValueError: name, argument = sig, None signode += addnodes.desc_name(':%s:' % name, ':%s:' % name) if argument: signode += addnodes.desc_annotation(' ' + argument, ' ' + argument) if self.options.get('type'): text = ' (%s)' % self.options['type'] signode += addnodes.desc_annotation(text, text) return name def add_target_and_index(self, name: str, sig: str, signode: desc_signature) -> None: domain = cast(ReSTDomain, self.env.get_domain('rst')) directive_name = self.current_directive if directive_name: prefix = '-'.join([self.objtype, directive_name]) objname = ':'.join([directive_name, name]) else: prefix = self.objtype objname = name node_id = make_id(self.env, self.state.document, prefix, name) signode['ids'].append(node_id) # Assign old styled node_id not to break old hyperlinks (if possible) # Note: Will be removed in Sphinx-5.0 (RemovedInSphinx50Warning) old_node_id = self.make_old_id(name) if old_node_id not in self.state.document.ids and old_node_id not in signode['ids']: signode['ids'].append(old_node_id) self.state.document.note_explicit_target(signode) domain.note_object(self.objtype, objname, node_id, location=signode) if directive_name: key = name[0].upper() pair = [_('%s (directive)') % directive_name, _(':%s: (directive option)') % name] self.indexnode['entries'].append(('pair', '; '.join(pair), node_id, '', key)) else: key = name[0].upper() text = _(':%s: (directive option)') % name self.indexnode['entries'].append(('single', text, node_id, '', key)) @property def current_directive(self) -> str: directives = self.env.ref_context.get('rst:directives') if directives: return directives[-1] else: return '' def make_old_id(self, name: str) -> str: """Generate old styled node_id for directive options. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. """ return '-'.join([self.objtype, self.current_directive, name]) class ReSTRole(ReSTMarkup): """ Description of a reST role. """ def handle_signature(self, sig: str, signode: desc_signature) -> str: signode += addnodes.desc_name(':%s:' % sig, ':%s:' % sig) return sig def get_index_text(self, objectname: str, name: str) -> str: return _('%s (role)') % name class ReSTDomain(Domain): """ReStructuredText domain.""" name = 'rst' label = 'reStructuredText' object_types = { 'directive': ObjType(_('directive'), 'dir'), 'directive:option': ObjType(_('directive-option'), 'dir'), 'role': ObjType(_('role'), 'role'), } directives = { 'directive': ReSTDirective, 'directive:option': ReSTDirectiveOption, 'role': ReSTRole, } roles = { 'dir': XRefRole(), 'role': XRefRole(), } initial_data: Dict[str, Dict[Tuple[str, str], str]] = { 'objects': {}, # fullname -> docname, objtype } @property def objects(self) -> Dict[Tuple[str, str], Tuple[str, str]]: return self.data.setdefault('objects', {}) # (objtype, fullname) -> (docname, node_id) def note_object(self, objtype: str, name: str, node_id: str, location: Any = None) -> None: if (objtype, name) in self.objects: docname, node_id = self.objects[objtype, name] logger.warning(__('duplicate description of %s %s, other instance in %s') % (objtype, name, docname), location=location) self.objects[objtype, name] = (self.env.docname, node_id) def clear_doc(self, docname: str) -> None: for (typ, name), (doc, node_id) in list(self.objects.items()): if doc == docname: del self.objects[typ, name] def merge_domaindata(self, docnames: List[str], otherdata: Dict) -> None: # XXX check duplicates for (typ, name), (doc, node_id) in otherdata['objects'].items(): if doc in docnames: self.objects[typ, name] = (doc, node_id) def resolve_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder, typ: str, target: str, node: pending_xref, contnode: Element ) -> Optional[Element]: objtypes = self.objtypes_for_role(typ) for objtype in objtypes: todocname, node_id = self.objects.get((objtype, target), (None, None)) if todocname: return make_refnode(builder, fromdocname, todocname, node_id, contnode, target + ' ' + objtype) return None def resolve_any_xref(self, env: BuildEnvironment, fromdocname: str, builder: Builder, target: str, node: pending_xref, contnode: Element ) -> List[Tuple[str, Element]]: results: List[Tuple[str, Element]] = [] for objtype in self.object_types: todocname, node_id = self.objects.get((objtype, target), (None, None)) if todocname: results.append(('rst:' + self.role_for_objtype(objtype), make_refnode(builder, fromdocname, todocname, node_id, contnode, target + ' ' + objtype))) return results def get_objects(self) -> Iterator[Tuple[str, str, str, str, str, int]]: for (typ, name), (docname, node_id) in self.data['objects'].items(): yield name, name, typ, docname, node_id, 1 def setup(app: Sphinx) -> Dict[str, Any]: app.add_domain(ReSTDomain) return { 'version': 'builtin', 'env_version': 2, 'parallel_read_safe': True, 'parallel_write_safe': True, } �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/domains/std.py������������������������������������������������������������������0000644�0000766�0000024�00000132444�00000000000�016452� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.domains.std ~~~~~~~~~~~~~~~~~~ The standard domain. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import re import unicodedata import warnings from copy import copy from typing import (TYPE_CHECKING, Any, Callable, Dict, Iterable, Iterator, List, Optional, Tuple, Type, Union, cast) from docutils import nodes from docutils.nodes import Element, Node, system_message from docutils.parsers.rst import Directive, directives from docutils.statemachine import StringList from sphinx import addnodes from sphinx.addnodes import desc_signature, pending_xref from sphinx.deprecation import RemovedInSphinx50Warning from sphinx.directives import ObjectDescription from sphinx.domains import Domain, ObjType from sphinx.locale import _, __ from sphinx.roles import XRefRole from sphinx.util import docname_join, logging, ws_re from sphinx.util.docutils import SphinxDirective from sphinx.util.nodes import clean_astext, make_id, make_refnode from sphinx.util.typing import OptionSpec, RoleFunction if TYPE_CHECKING: from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.environment import BuildEnvironment logger = logging.getLogger(__name__) # RE for option descriptions option_desc_re = re.compile(r'((?:/|--|-|\+)?[^\s=]+)(=?\s*.*)') # RE for grammar tokens token_re = re.compile(r'`((~?\w*:)?\w+)`', re.U) class GenericObject(ObjectDescription[str]): """ A generic x-ref directive registered with Sphinx.add_object_type(). """ indextemplate: str = '' parse_node: Callable[["GenericObject", "BuildEnvironment", str, desc_signature], str] = None # NOQA def handle_signature(self, sig: str, signode: desc_signature) -> str: if self.parse_node: name = self.parse_node(self.env, sig, signode) else: signode.clear() signode += addnodes.desc_name(sig, sig) # normalize whitespace like XRefRole does name = ws_re.sub(' ', sig) return name def add_target_and_index(self, name: str, sig: str, signode: desc_signature) -> None: node_id = make_id(self.env, self.state.document, self.objtype, name) signode['ids'].append(node_id) # Assign old styled node_id not to break old hyperlinks (if possible) # Note: Will be removed in Sphinx-5.0 (RemovedInSphinx50Warning) old_node_id = self.make_old_id(name) if old_node_id not in self.state.document.ids and old_node_id not in signode['ids']: signode['ids'].append(old_node_id) self.state.document.note_explicit_target(signode) if self.indextemplate: colon = self.indextemplate.find(':') if colon != -1: indextype = self.indextemplate[:colon].strip() indexentry = self.indextemplate[colon + 1:].strip() % (name,) else: indextype = 'single' indexentry = self.indextemplate % (name,) self.indexnode['entries'].append((indextype, indexentry, node_id, '', None)) std = cast(StandardDomain, self.env.get_domain('std')) std.note_object(self.objtype, name, node_id, location=signode) def make_old_id(self, name: str) -> str: """Generate old styled node_id for generic objects. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. """ return self.objtype + '-' + name class EnvVar(GenericObject): indextemplate = _('environment variable; %s') class EnvVarXRefRole(XRefRole): """ Cross-referencing role for environment variables (adds an index entry). """ def result_nodes(self, document: nodes.document, env: "BuildEnvironment", node: Element, is_ref: bool) -> Tuple[List[Node], List[system_message]]: if not is_ref: return [node], [] varname = node['reftarget'] tgtid = 'index-%s' % env.new_serialno('index') indexnode = addnodes.index() indexnode['entries'] = [ ('single', varname, tgtid, '', None), ('single', _('environment variable; %s') % varname, tgtid, '', None) ] targetnode = nodes.target('', '', ids=[tgtid]) document.note_explicit_target(targetnode) return [indexnode, targetnode, node], [] class Target(SphinxDirective): """ Generic target for user-defined cross-reference types. """ indextemplate = '' has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: # normalize whitespace in fullname like XRefRole does fullname = ws_re.sub(' ', self.arguments[0].strip()) node_id = make_id(self.env, self.state.document, self.name, fullname) node = nodes.target('', '', ids=[node_id]) self.set_source_info(node) # Assign old styled node_id not to break old hyperlinks (if possible) # Note: Will be removed in Sphinx-5.0 (RemovedInSphinx50Warning) old_node_id = self.make_old_id(fullname) if old_node_id not in self.state.document.ids and old_node_id not in node['ids']: node['ids'].append(old_node_id) self.state.document.note_explicit_target(node) ret: List[Node] = [node] if self.indextemplate: indexentry = self.indextemplate % (fullname,) indextype = 'single' colon = indexentry.find(':') if colon != -1: indextype = indexentry[:colon].strip() indexentry = indexentry[colon + 1:].strip() inode = addnodes.index(entries=[(indextype, indexentry, node_id, '', None)]) ret.insert(0, inode) name = self.name if ':' in self.name: _, name = self.name.split(':', 1) std = cast(StandardDomain, self.env.get_domain('std')) std.note_object(name, fullname, node_id, location=node) return ret def make_old_id(self, name: str) -> str: """Generate old styled node_id for targets. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. """ return self.name + '-' + name class Cmdoption(ObjectDescription[str]): """ Description of a command-line option (.. option). """ def handle_signature(self, sig: str, signode: desc_signature) -> str: """Transform an option description into RST nodes.""" count = 0 firstname = '' for potential_option in sig.split(', '): potential_option = potential_option.strip() m = option_desc_re.match(potential_option) if not m: logger.warning(__('Malformed option description %r, should ' 'look like "opt", "-opt args", "--opt args", ' '"/opt args" or "+opt args"'), potential_option, location=signode) continue optname, args = m.groups() if optname.endswith('[') and args.endswith(']'): # optional value surrounded by brackets (ex. foo[=bar]) optname = optname[:-1] args = '[' + args if count: signode += addnodes.desc_addname(', ', ', ') signode += addnodes.desc_name(optname, optname) signode += addnodes.desc_addname(args, args) if not count: firstname = optname signode['allnames'] = [optname] else: signode['allnames'].append(optname) count += 1 if not firstname: raise ValueError return firstname def add_target_and_index(self, firstname: str, sig: str, signode: desc_signature) -> None: currprogram = self.env.ref_context.get('std:program') for optname in signode.get('allnames', []): prefixes = ['cmdoption'] if currprogram: prefixes.append(currprogram) if not optname.startswith(('-', '/')): prefixes.append('arg') prefix = '-'.join(prefixes) node_id = make_id(self.env, self.state.document, prefix, optname) signode['ids'].append(node_id) old_node_id = self.make_old_id(prefix, optname) if old_node_id not in self.state.document.ids and \ old_node_id not in signode['ids']: signode['ids'].append(old_node_id) self.state.document.note_explicit_target(signode) domain = cast(StandardDomain, self.env.get_domain('std')) for optname in signode.get('allnames', []): domain.add_program_option(currprogram, optname, self.env.docname, signode['ids'][0]) # create an index entry if currprogram: descr = _('%s command line option') % currprogram else: descr = _('command line option') for option in sig.split(', '): entry = '; '.join([descr, option]) self.indexnode['entries'].append(('pair', entry, signode['ids'][0], '', None)) def make_old_id(self, prefix: str, optname: str) -> str: """Generate old styled node_id for cmdoption. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. """ return nodes.make_id(prefix + '-' + optname) class Program(SphinxDirective): """ Directive to name the program for which options are documented. """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: program = ws_re.sub('-', self.arguments[0].strip()) if program == 'None': self.env.ref_context.pop('std:program', None) else: self.env.ref_context['std:program'] = program return [] class OptionXRefRole(XRefRole): def process_link(self, env: "BuildEnvironment", refnode: Element, has_explicit_title: bool, title: str, target: str) -> Tuple[str, str]: refnode['std:program'] = env.ref_context.get('std:program') return title, target def split_term_classifiers(line: str) -> List[Optional[str]]: # split line into a term and classifiers. if no classifier, None is used.. parts: List[Optional[str]] = re.split(' +: +', line) + [None] return parts def make_glossary_term(env: "BuildEnvironment", textnodes: Iterable[Node], index_key: str, source: str, lineno: int, node_id: str, document: nodes.document ) -> nodes.term: # get a text-only representation of the term and register it # as a cross-reference target term = nodes.term('', '', *textnodes) term.source = source term.line = lineno termtext = term.astext() if node_id: # node_id is given from outside (mainly i18n module), use it forcedly term['ids'].append(node_id) else: node_id = make_id(env, document, 'term', termtext) term['ids'].append(node_id) document.note_explicit_target(term) std = cast(StandardDomain, env.get_domain('std')) std._note_term(termtext, node_id, location=term) # add an index entry too indexnode = addnodes.index() indexnode['entries'] = [('single', termtext, node_id, 'main', index_key)] indexnode.source, indexnode.line = term.source, term.line term.append(indexnode) return term class Glossary(SphinxDirective): """ Directive to create a glossary with cross-reference targets for :term: roles. """ has_content = True required_arguments = 0 optional_arguments = 0 final_argument_whitespace = False option_spec: OptionSpec = { 'sorted': directives.flag, } def run(self) -> List[Node]: node = addnodes.glossary() node.document = self.state.document # This directive implements a custom format of the reST definition list # that allows multiple lines of terms before the definition. This is # easy to parse since we know that the contents of the glossary *must # be* a definition list. # first, collect single entries entries: List[Tuple[List[Tuple[str, str, int]], StringList]] = [] in_definition = True in_comment = False was_empty = True messages: List[Node] = [] for line, (source, lineno) in zip(self.content, self.content.items): # empty line -> add to last definition if not line: if in_definition and entries: entries[-1][1].append('', source, lineno) was_empty = True continue # unindented line -> a term if line and not line[0].isspace(): # enable comments if line.startswith('.. '): in_comment = True continue else: in_comment = False # first term of definition if in_definition: if not was_empty: messages.append(self.state.reporter.warning( _('glossary term must be preceded by empty line'), source=source, line=lineno)) entries.append(([(line, source, lineno)], StringList())) in_definition = False # second term and following else: if was_empty: messages.append(self.state.reporter.warning( _('glossary terms must not be separated by empty lines'), source=source, line=lineno)) if entries: entries[-1][0].append((line, source, lineno)) else: messages.append(self.state.reporter.warning( _('glossary seems to be misformatted, check indentation'), source=source, line=lineno)) elif in_comment: pass else: if not in_definition: # first line of definition, determines indentation in_definition = True indent_len = len(line) - len(line.lstrip()) if entries: entries[-1][1].append(line[indent_len:], source, lineno) else: messages.append(self.state.reporter.warning( _('glossary seems to be misformatted, check indentation'), source=source, line=lineno)) was_empty = False # now, parse all the entries into a big definition list items = [] for terms, definition in entries: termtexts: List[str] = [] termnodes: List[Node] = [] system_messages: List[Node] = [] for line, source, lineno in terms: parts = split_term_classifiers(line) # parse the term with inline markup # classifiers (parts[1:]) will not be shown on doctree textnodes, sysmsg = self.state.inline_text(parts[0], lineno) # use first classifier as a index key term = make_glossary_term(self.env, textnodes, parts[1], source, lineno, node_id=None, document=self.state.document) term.rawsource = line system_messages.extend(sysmsg) termtexts.append(term.astext()) termnodes.append(term) termnodes.extend(system_messages) defnode = nodes.definition() if definition: self.state.nested_parse(definition, definition.items[0][1], defnode) termnodes.append(defnode) items.append((termtexts, nodes.definition_list_item('', *termnodes))) if 'sorted' in self.options: items.sort(key=lambda x: unicodedata.normalize('NFD', x[0][0].lower())) dlist = nodes.definition_list() dlist['classes'].append('glossary') dlist.extend(item[1] for item in items) node += dlist return messages + [node] def token_xrefs(text: str, productionGroup: str = '') -> List[Node]: if len(productionGroup) != 0: productionGroup += ':' retnodes: List[Node] = [] pos = 0 for m in token_re.finditer(text): if m.start() > pos: txt = text[pos:m.start()] retnodes.append(nodes.Text(txt, txt)) token = m.group(1) if ':' in token: if token[0] == '~': _, title = token.split(':') target = token[1:] elif token[0] == ':': title = token[1:] target = title else: title = token target = token else: title = token target = productionGroup + token refnode = pending_xref(title, reftype='token', refdomain='std', reftarget=target) refnode += nodes.literal(token, title, classes=['xref']) retnodes.append(refnode) pos = m.end() if pos < len(text): retnodes.append(nodes.Text(text[pos:], text[pos:])) return retnodes class ProductionList(SphinxDirective): """ Directive to list grammar productions. """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: domain = cast(StandardDomain, self.env.get_domain('std')) node: Element = addnodes.productionlist() self.set_source_info(node) # The backslash handling is from ObjectDescription.get_signatures nl_escape_re = re.compile(r'\\\n') lines = nl_escape_re.sub('', self.arguments[0]).split('\n') productionGroup = "" i = 0 for rule in lines: if i == 0 and ':' not in rule: productionGroup = rule.strip() continue i += 1 try: name, tokens = rule.split(':', 1) except ValueError: break subnode = addnodes.production(rule) name = name.strip() subnode['tokenname'] = name if subnode['tokenname']: prefix = 'grammar-token-%s' % productionGroup node_id = make_id(self.env, self.state.document, prefix, name) subnode['ids'].append(node_id) # Assign old styled node_id not to break old hyperlinks (if possible) # Note: Will be removed in Sphinx-5.0 (RemovedInSphinx50Warning) old_node_id = self.make_old_id(name) if (old_node_id not in self.state.document.ids and old_node_id not in subnode['ids']): subnode['ids'].append(old_node_id) self.state.document.note_implicit_target(subnode, subnode) if len(productionGroup) != 0: objName = "%s:%s" % (productionGroup, name) else: objName = name domain.note_object('token', objName, node_id, location=node) subnode.extend(token_xrefs(tokens, productionGroup)) node.append(subnode) return [node] def make_old_id(self, token: str) -> str: """Generate old styled node_id for tokens. .. note:: Old Styled node_id was used until Sphinx-3.0. This will be removed in Sphinx-5.0. """ return nodes.make_id('grammar-token-' + token) class TokenXRefRole(XRefRole): def process_link(self, env: "BuildEnvironment", refnode: Element, has_explicit_title: bool, title: str, target: str) -> Tuple[str, str]: target = target.lstrip('~') # a title-specific thing if not self.has_explicit_title and title[0] == '~': if ':' in title: _, title = title.split(':') else: title = title[1:] return title, target class StandardDomain(Domain): """ Domain for all objects that don't fit into another domain or are added via the application interface. """ name = 'std' label = 'Default' object_types: Dict[str, ObjType] = { 'term': ObjType(_('glossary term'), 'term', searchprio=-1), 'token': ObjType(_('grammar token'), 'token', searchprio=-1), 'label': ObjType(_('reference label'), 'ref', 'keyword', searchprio=-1), 'envvar': ObjType(_('environment variable'), 'envvar'), 'cmdoption': ObjType(_('program option'), 'option'), 'doc': ObjType(_('document'), 'doc', searchprio=-1) } directives: Dict[str, Type[Directive]] = { 'program': Program, 'cmdoption': Cmdoption, # old name for backwards compatibility 'option': Cmdoption, 'envvar': EnvVar, 'glossary': Glossary, 'productionlist': ProductionList, } roles: Dict[str, Union[RoleFunction, XRefRole]] = { 'option': OptionXRefRole(warn_dangling=True), 'envvar': EnvVarXRefRole(), # links to tokens in grammar productions 'token': TokenXRefRole(), # links to terms in glossary 'term': XRefRole(innernodeclass=nodes.inline, warn_dangling=True), # links to headings or arbitrary labels 'ref': XRefRole(lowercase=True, innernodeclass=nodes.inline, warn_dangling=True), # links to labels of numbered figures, tables and code-blocks 'numref': XRefRole(lowercase=True, warn_dangling=True), # links to labels, without a different title 'keyword': XRefRole(warn_dangling=True), # links to documents 'doc': XRefRole(warn_dangling=True, innernodeclass=nodes.inline), } initial_data = { 'progoptions': {}, # (program, name) -> docname, labelid 'objects': {}, # (type, name) -> docname, labelid 'labels': { # labelname -> docname, labelid, sectionname 'genindex': ('genindex', '', _('Index')), 'modindex': ('py-modindex', '', _('Module Index')), 'search': ('search', '', _('Search Page')), }, 'anonlabels': { # labelname -> docname, labelid 'genindex': ('genindex', ''), 'modindex': ('py-modindex', ''), 'search': ('search', ''), }, } dangling_warnings = { 'term': 'term not in glossary: %(target)s', 'numref': 'undefined label: %(target)s', 'keyword': 'unknown keyword: %(target)s', 'doc': 'unknown document: %(target)s', 'option': 'unknown option: %(target)s', } # node_class -> (figtype, title_getter) enumerable_nodes: Dict[Type[Node], Tuple[str, Optional[Callable]]] = { nodes.figure: ('figure', None), nodes.table: ('table', None), nodes.container: ('code-block', None), } def __init__(self, env: "BuildEnvironment") -> None: super().__init__(env) # set up enumerable nodes self.enumerable_nodes = copy(self.enumerable_nodes) # create a copy for this instance for node, settings in env.app.registry.enumerable_nodes.items(): self.enumerable_nodes[node] = settings def note_hyperlink_target(self, name: str, docname: str, node_id: str, title: str = '') -> None: """Add a hyperlink target for cross reference. .. warning:: This is only for internal use. Please don't use this from your extension. ``document.note_explicit_target()`` or ``note_implicit_target()`` are recommended to add a hyperlink target to the document. This only adds a hyperlink target to the StandardDomain. And this does not add a node_id to node. Therefore, it is very fragile to calling this without understanding hyperlink target framework in both docutils and Sphinx. .. versionadded:: 3.0 """ if name in self.anonlabels and self.anonlabels[name] != (docname, node_id): logger.warning(__('duplicate label %s, other instance in %s'), name, self.env.doc2path(self.anonlabels[name][0])) self.anonlabels[name] = (docname, node_id) if title: self.labels[name] = (docname, node_id, title) @property def objects(self) -> Dict[Tuple[str, str], Tuple[str, str]]: return self.data.setdefault('objects', {}) # (objtype, name) -> docname, labelid def note_object(self, objtype: str, name: str, labelid: str, location: Any = None ) -> None: """Note a generic object for cross reference. .. versionadded:: 3.0 """ if (objtype, name) in self.objects: docname = self.objects[objtype, name][0] logger.warning(__('duplicate %s description of %s, other instance in %s'), objtype, name, docname, location=location) self.objects[objtype, name] = (self.env.docname, labelid) def add_object(self, objtype: str, name: str, docname: str, labelid: str) -> None: warnings.warn('StandardDomain.add_object() is deprecated.', RemovedInSphinx50Warning, stacklevel=2) self.objects[objtype, name] = (docname, labelid) @property def _terms(self) -> Dict[str, Tuple[str, str]]: """.. note:: Will be removed soon. internal use only.""" return self.data.setdefault('terms', {}) # (name) -> docname, labelid def _note_term(self, term: str, labelid: str, location: Any = None) -> None: """Note a term for cross reference. .. note:: Will be removed soon. internal use only. """ self.note_object('term', term, labelid, location) self._terms[term.lower()] = (self.env.docname, labelid) @property def progoptions(self) -> Dict[Tuple[str, str], Tuple[str, str]]: return self.data.setdefault('progoptions', {}) # (program, name) -> docname, labelid @property def labels(self) -> Dict[str, Tuple[str, str, str]]: return self.data.setdefault('labels', {}) # labelname -> docname, labelid, sectionname @property def anonlabels(self) -> Dict[str, Tuple[str, str]]: return self.data.setdefault('anonlabels', {}) # labelname -> docname, labelid def clear_doc(self, docname: str) -> None: key: Any = None for key, (fn, _l) in list(self.progoptions.items()): if fn == docname: del self.progoptions[key] for key, (fn, _l) in list(self.objects.items()): if fn == docname: del self.objects[key] for key, (fn, _l) in list(self._terms.items()): if fn == docname: del self._terms[key] for key, (fn, _l, _l) in list(self.labels.items()): if fn == docname: del self.labels[key] for key, (fn, _l) in list(self.anonlabels.items()): if fn == docname: del self.anonlabels[key] def merge_domaindata(self, docnames: List[str], otherdata: Dict) -> None: # XXX duplicates? for key, data in otherdata['progoptions'].items(): if data[0] in docnames: self.progoptions[key] = data for key, data in otherdata['objects'].items(): if data[0] in docnames: self.objects[key] = data for key, data in otherdata['terms'].items(): if data[0] in docnames: self._terms[key] = data for key, data in otherdata['labels'].items(): if data[0] in docnames: self.labels[key] = data for key, data in otherdata['anonlabels'].items(): if data[0] in docnames: self.anonlabels[key] = data def process_doc(self, env: "BuildEnvironment", docname: str, document: nodes.document) -> None: # NOQA for name, explicit in document.nametypes.items(): if not explicit: continue labelid = document.nameids[name] if labelid is None: continue node = document.ids[labelid] if isinstance(node, nodes.target) and 'refid' in node: # indirect hyperlink targets node = document.ids.get(node['refid']) labelid = node['names'][0] if (node.tagname == 'footnote' or 'refuri' in node or node.tagname.startswith('desc_')): # ignore footnote labels, labels automatically generated from a # link and object descriptions continue if name in self.labels: logger.warning(__('duplicate label %s, other instance in %s'), name, env.doc2path(self.labels[name][0]), location=node) self.anonlabels[name] = docname, labelid if node.tagname == 'section': title = cast(nodes.title, node[0]) sectname = clean_astext(title) elif node.tagname == 'rubric': sectname = clean_astext(node) elif self.is_enumerable_node(node): sectname = self.get_numfig_title(node) if not sectname: continue else: toctree = next(iter(node.traverse(addnodes.toctree)), None) if toctree and toctree.get('caption'): sectname = toctree.get('caption') else: # anonymous-only labels continue self.labels[name] = docname, labelid, sectname def add_program_option(self, program: str, name: str, docname: str, labelid: str) -> None: self.progoptions[program, name] = (docname, labelid) def build_reference_node(self, fromdocname: str, builder: "Builder", docname: str, labelid: str, sectname: str, rolename: str, **options: Any ) -> Element: nodeclass = options.pop('nodeclass', nodes.reference) newnode = nodeclass('', '', internal=True, **options) innernode = nodes.inline(sectname, sectname) if innernode.get('classes') is not None: innernode['classes'].append('std') innernode['classes'].append('std-' + rolename) if docname == fromdocname: newnode['refid'] = labelid else: # set more info in contnode; in case the # get_relative_uri call raises NoUri, # the builder will then have to resolve these contnode = pending_xref('') contnode['refdocname'] = docname contnode['refsectname'] = sectname newnode['refuri'] = builder.get_relative_uri( fromdocname, docname) if labelid: newnode['refuri'] += '#' + labelid newnode.append(innernode) return newnode def resolve_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder", typ: str, target: str, node: pending_xref, contnode: Element ) -> Optional[Element]: if typ == 'ref': resolver = self._resolve_ref_xref elif typ == 'numref': resolver = self._resolve_numref_xref elif typ == 'keyword': resolver = self._resolve_keyword_xref elif typ == 'doc': resolver = self._resolve_doc_xref elif typ == 'option': resolver = self._resolve_option_xref elif typ == 'term': resolver = self._resolve_term_xref else: resolver = self._resolve_obj_xref return resolver(env, fromdocname, builder, typ, target, node, contnode) def _resolve_ref_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder", typ: str, target: str, node: pending_xref, contnode: Element) -> Optional[Element]: if node['refexplicit']: # reference to anonymous label; the reference uses # the supplied link caption docname, labelid = self.anonlabels.get(target, ('', '')) sectname = node.astext() else: # reference to named label; the final node will # contain the section name after the label docname, labelid, sectname = self.labels.get(target, ('', '', '')) if not docname: return None return self.build_reference_node(fromdocname, builder, docname, labelid, sectname, 'ref') def _resolve_numref_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder", typ: str, target: str, node: pending_xref, contnode: Element) -> Optional[Element]: if target in self.labels: docname, labelid, figname = self.labels.get(target, ('', '', '')) else: docname, labelid = self.anonlabels.get(target, ('', '')) figname = None if not docname: return None target_node = env.get_doctree(docname).ids.get(labelid) figtype = self.get_enumerable_node_type(target_node) if figtype is None: return None if figtype != 'section' and env.config.numfig is False: logger.warning(__('numfig is disabled. :numref: is ignored.'), location=node) return contnode try: fignumber = self.get_fignumber(env, builder, figtype, docname, target_node) if fignumber is None: return contnode except ValueError: logger.warning(__("Failed to create a cross reference. Any number is not " "assigned: %s"), labelid, location=node) return contnode try: if node['refexplicit']: title = contnode.astext() else: title = env.config.numfig_format.get(figtype, '') if figname is None and '{name}' in title: logger.warning(__('the link has no caption: %s'), title, location=node) return contnode else: fignum = '.'.join(map(str, fignumber)) if '{name}' in title or 'number' in title: # new style format (cf. "Fig.{number}") if figname: newtitle = title.format(name=figname, number=fignum) else: newtitle = title.format(number=fignum) else: # old style format (cf. "Fig.%s") newtitle = title % fignum except KeyError as exc: logger.warning(__('invalid numfig_format: %s (%r)'), title, exc, location=node) return contnode except TypeError: logger.warning(__('invalid numfig_format: %s'), title, location=node) return contnode return self.build_reference_node(fromdocname, builder, docname, labelid, newtitle, 'numref', nodeclass=addnodes.number_reference, title=title) def _resolve_keyword_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder", typ: str, target: str, node: pending_xref, contnode: Element) -> Optional[Element]: # keywords are oddballs: they are referenced by named labels docname, labelid, _ = self.labels.get(target, ('', '', '')) if not docname: return None return make_refnode(builder, fromdocname, docname, labelid, contnode) def _resolve_doc_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder", typ: str, target: str, node: pending_xref, contnode: Element) -> Optional[Element]: # directly reference to document by source name; can be absolute or relative refdoc = node.get('refdoc', fromdocname) docname = docname_join(refdoc, node['reftarget']) if docname not in env.all_docs: return None else: if node['refexplicit']: # reference with explicit title caption = node.astext() else: caption = clean_astext(env.titles[docname]) innernode = nodes.inline(caption, caption, classes=['doc']) return make_refnode(builder, fromdocname, docname, None, innernode) def _resolve_option_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder", typ: str, target: str, node: pending_xref, contnode: Element) -> Optional[Element]: progname = node.get('std:program') target = target.strip() docname, labelid = self.progoptions.get((progname, target), ('', '')) if not docname: commands = [] while ws_re.search(target): subcommand, target = ws_re.split(target, 1) commands.append(subcommand) progname = "-".join(commands) docname, labelid = self.progoptions.get((progname, target), ('', '')) if docname: break else: return None return make_refnode(builder, fromdocname, docname, labelid, contnode) def _resolve_term_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder", typ: str, target: str, node: pending_xref, contnode: Element) -> Element: result = self._resolve_obj_xref(env, fromdocname, builder, typ, target, node, contnode) if result: return result else: # fallback to case insentive match if target.lower() in self._terms: docname, labelid = self._terms[target.lower()] return make_refnode(builder, fromdocname, docname, labelid, contnode) else: return None def _resolve_obj_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder", typ: str, target: str, node: pending_xref, contnode: Element) -> Optional[Element]: objtypes = self.objtypes_for_role(typ) or [] for objtype in objtypes: if (objtype, target) in self.objects: docname, labelid = self.objects[objtype, target] break else: docname, labelid = '', '' if not docname: return None return make_refnode(builder, fromdocname, docname, labelid, contnode) def resolve_any_xref(self, env: "BuildEnvironment", fromdocname: str, builder: "Builder", target: str, node: pending_xref, contnode: Element) -> List[Tuple[str, Element]]: results: List[Tuple[str, Element]] = [] ltarget = target.lower() # :ref: lowercases its target automatically for role in ('ref', 'option'): # do not try "keyword" res = self.resolve_xref(env, fromdocname, builder, role, ltarget if role == 'ref' else target, node, contnode) if res: results.append(('std:' + role, res)) # all others for objtype in self.object_types: key = (objtype, target) if objtype == 'term': key = (objtype, ltarget) if key in self.objects: docname, labelid = self.objects[key] results.append(('std:' + self.role_for_objtype(objtype), make_refnode(builder, fromdocname, docname, labelid, contnode))) return results def get_objects(self) -> Iterator[Tuple[str, str, str, str, str, int]]: # handle the special 'doc' reference here for doc in self.env.all_docs: yield (doc, clean_astext(self.env.titles[doc]), 'doc', doc, '', -1) for (prog, option), info in self.progoptions.items(): if prog: fullname = ".".join([prog, option]) yield (fullname, fullname, 'cmdoption', info[0], info[1], 1) else: yield (option, option, 'cmdoption', info[0], info[1], 1) for (type, name), info in self.objects.items(): yield (name, name, type, info[0], info[1], self.object_types[type].attrs['searchprio']) for name, (docname, labelid, sectionname) in self.labels.items(): yield (name, sectionname, 'label', docname, labelid, -1) # add anonymous-only labels as well non_anon_labels = set(self.labels) for name, (docname, labelid) in self.anonlabels.items(): if name not in non_anon_labels: yield (name, name, 'label', docname, labelid, -1) def get_type_name(self, type: ObjType, primary: bool = False) -> str: # never prepend "Default" return type.lname def is_enumerable_node(self, node: Node) -> bool: return node.__class__ in self.enumerable_nodes def get_numfig_title(self, node: Node) -> Optional[str]: """Get the title of enumerable nodes to refer them using its title""" if self.is_enumerable_node(node): elem = cast(Element, node) _, title_getter = self.enumerable_nodes.get(elem.__class__, (None, None)) if title_getter: return title_getter(elem) else: for subnode in elem: if isinstance(subnode, (nodes.caption, nodes.title)): return clean_astext(subnode) return None def get_enumerable_node_type(self, node: Node) -> Optional[str]: """Get type of enumerable nodes.""" def has_child(node: Element, cls: Type) -> bool: return any(isinstance(child, cls) for child in node) if isinstance(node, nodes.section): return 'section' elif (isinstance(node, nodes.container) and 'literal_block' in node and has_child(node, nodes.literal_block)): # given node is a code-block having caption return 'code-block' else: figtype, _ = self.enumerable_nodes.get(node.__class__, (None, None)) return figtype def get_fignumber(self, env: "BuildEnvironment", builder: "Builder", figtype: str, docname: str, target_node: Element) -> Tuple[int, ...]: if figtype == 'section': if builder.name == 'latex': return tuple() elif docname not in env.toc_secnumbers: raise ValueError # no number assigned else: anchorname = '#' + target_node['ids'][0] if anchorname not in env.toc_secnumbers[docname]: # try first heading which has no anchor return env.toc_secnumbers[docname].get('') else: return env.toc_secnumbers[docname].get(anchorname) else: try: figure_id = target_node['ids'][0] return env.toc_fignumbers[docname][figtype][figure_id] except (KeyError, IndexError) as exc: # target_node is found, but fignumber is not assigned. # Maybe it is defined in orphaned document. raise ValueError from exc def get_full_qualified_name(self, node: Element) -> Optional[str]: if node.get('reftype') == 'option': progname = node.get('std:program') command = ws_re.split(node.get('reftarget')) if progname: command.insert(0, progname) option = command.pop() if command: return '.'.join(['-'.join(command), option]) else: return None else: return None def warn_missing_reference(app: "Sphinx", domain: Domain, node: pending_xref ) -> Optional[bool]: if (domain and domain.name != 'std') or node['reftype'] != 'ref': return None else: target = node['reftarget'] if target not in domain.anonlabels: # type: ignore msg = __('undefined label: %s') else: msg = __('Failed to create a cross reference. A title or caption not found: %s') logger.warning(msg % target, location=node, type='ref', subtype=node['reftype']) return True def setup(app: "Sphinx") -> Dict[str, Any]: app.add_domain(StandardDomain) app.connect('warn-missing-reference', warn_missing_reference) return { 'version': 'builtin', 'env_version': 2, 'parallel_read_safe': True, 'parallel_write_safe': True, } ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4553146 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/environment/��������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016210� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/environment/__init__.py���������������������������������������������������������0000644�0000766�0000024�00000062522�00000000000�020330� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.environment ~~~~~~~~~~~~~~~~~~ Global creation environment. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import os import pickle import warnings from collections import defaultdict from copy import copy from datetime import datetime from os import path from typing import (TYPE_CHECKING, Any, Callable, Dict, Generator, Iterator, List, Optional, Set, Tuple, Union) from docutils import nodes from docutils.nodes import Node from sphinx import addnodes from sphinx.config import Config from sphinx.deprecation import RemovedInSphinx60Warning from sphinx.domains import Domain from sphinx.environment.adapters.toctree import TocTree from sphinx.errors import BuildEnvironmentError, DocumentError, ExtensionError, SphinxError from sphinx.events import EventManager from sphinx.locale import __ from sphinx.project import Project from sphinx.transforms import SphinxTransformer from sphinx.util import DownloadFiles, FilenameUniqDict, logging from sphinx.util.docutils import LoggingReporter from sphinx.util.i18n import CatalogRepository, docname_to_domain from sphinx.util.nodes import is_translatable from sphinx.util.osutil import canon_path, os_path if TYPE_CHECKING: from sphinx.application import Sphinx from sphinx.builders import Builder logger = logging.getLogger(__name__) default_settings: Dict[str, Any] = { 'auto_id_prefix': 'id', 'embed_images': False, 'embed_stylesheet': False, 'cloak_email_addresses': True, 'pep_base_url': 'https://www.python.org/dev/peps/', 'pep_references': None, 'rfc_base_url': 'https://tools.ietf.org/html/', 'rfc_references': None, 'input_encoding': 'utf-8-sig', 'doctitle_xform': False, 'sectsubtitle_xform': False, 'section_self_link': False, 'halt_level': 5, 'file_insertion_enabled': True, 'smartquotes_locales': [], } # This is increased every time an environment attribute is added # or changed to properly invalidate pickle files. ENV_VERSION = 56 # config status CONFIG_OK = 1 CONFIG_NEW = 2 CONFIG_CHANGED = 3 CONFIG_EXTENSIONS_CHANGED = 4 CONFIG_CHANGED_REASON = { CONFIG_NEW: __('new config'), CONFIG_CHANGED: __('config changed'), CONFIG_EXTENSIONS_CHANGED: __('extensions changed'), } versioning_conditions: Dict[str, Union[bool, Callable]] = { 'none': False, 'text': is_translatable, } class BuildEnvironment: """ The environment in which the ReST files are translated. Stores an inventory of cross-file targets and provides doctree transformations to resolve links to them. """ domains: Dict[str, Domain] # --------- ENVIRONMENT INITIALIZATION ------------------------------------- def __init__(self, app: "Sphinx" = None): self.app: Sphinx = None self.doctreedir: str = None self.srcdir: str = None self.config: Config = None self.config_status: int = None self.config_status_extra: str = None self.events: EventManager = None self.project: Project = None self.version: Dict[str, str] = None # the method of doctree versioning; see set_versioning_method self.versioning_condition: Union[bool, Callable] = None self.versioning_compare: bool = None # all the registered domains, set by the application self.domains = {} # the docutils settings for building self.settings = default_settings.copy() self.settings['env'] = self # All "docnames" here are /-separated and relative and exclude # the source suffix. # docname -> mtime at the time of reading # contains all read docnames self.all_docs: Dict[str, float] = {} # docname -> set of dependent file # names, relative to documentation root self.dependencies: Dict[str, Set[str]] = defaultdict(set) # docname -> set of included file # docnames included from other documents self.included: Dict[str, Set[str]] = defaultdict(set) # docnames to re-read unconditionally on next build self.reread_always: Set[str] = set() # File metadata # docname -> dict of metadata items self.metadata: Dict[str, Dict[str, Any]] = defaultdict(dict) # TOC inventory # docname -> title node self.titles: Dict[str, nodes.title] = {} # docname -> title node; only different if # set differently with title directive self.longtitles: Dict[str, nodes.title] = {} # docname -> table of contents nodetree self.tocs: Dict[str, nodes.bullet_list] = {} # docname -> number of real entries self.toc_num_entries: Dict[str, int] = {} # used to determine when to show the TOC # in a sidebar (don't show if it's only one item) # docname -> dict of sectionid -> number self.toc_secnumbers: Dict[str, Dict[str, Tuple[int, ...]]] = {} # docname -> dict of figtype -> dict of figureid -> number self.toc_fignumbers: Dict[str, Dict[str, Dict[str, Tuple[int, ...]]]] = {} # docname -> list of toctree includefiles self.toctree_includes: Dict[str, List[str]] = {} # docname -> set of files (containing its TOCs) to rebuild too self.files_to_rebuild: Dict[str, Set[str]] = {} # docnames that have :glob: toctrees self.glob_toctrees: Set[str] = set() # docnames that have :numbered: toctrees self.numbered_toctrees: Set[str] = set() # domain-specific inventories, here to be pickled # domainname -> domain-specific dict self.domaindata: Dict[str, Dict] = {} # these map absolute path -> (docnames, unique filename) self.images: FilenameUniqDict = FilenameUniqDict() # filename -> (set of docnames, destination) self.dlfiles: DownloadFiles = DownloadFiles() # the original URI for images self.original_image_uri: Dict[str, str] = {} # temporary data storage while reading a document self.temp_data: Dict[str, Any] = {} # context for cross-references (e.g. current module or class) # this is similar to temp_data, but will for example be copied to # attributes of "any" cross references self.ref_context: Dict[str, Any] = {} # set up environment if app: self.setup(app) else: warnings.warn("The 'app' argument for BuildEnvironment() becomes required now.", RemovedInSphinx60Warning, stacklevel=2) def __getstate__(self) -> Dict: """Obtains serializable data for pickling.""" __dict__ = self.__dict__.copy() __dict__.update(app=None, domains={}, events=None) # clear unpickable attributes return __dict__ def __setstate__(self, state: Dict) -> None: self.__dict__.update(state) def setup(self, app: "Sphinx") -> None: """Set up BuildEnvironment object.""" if self.version and self.version != app.registry.get_envversion(app): raise BuildEnvironmentError(__('build environment version not current')) elif self.srcdir and self.srcdir != app.srcdir: raise BuildEnvironmentError(__('source directory has changed')) if self.project: app.project.restore(self.project) self.app = app self.doctreedir = app.doctreedir self.events = app.events self.srcdir = app.srcdir self.project = app.project self.version = app.registry.get_envversion(app) # initialize domains self.domains = {} for domain in app.registry.create_domains(self): self.domains[domain.name] = domain # setup domains (must do after all initialization) for domain in self.domains.values(): domain.setup() # initialize config self._update_config(app.config) # initialie settings self._update_settings(app.config) def _update_config(self, config: Config) -> None: """Update configurations by new one.""" self.config_status = CONFIG_OK self.config_status_extra = '' if self.config is None: self.config_status = CONFIG_NEW elif self.config.extensions != config.extensions: self.config_status = CONFIG_EXTENSIONS_CHANGED extensions = sorted( set(self.config.extensions) ^ set(config.extensions)) if len(extensions) == 1: extension = extensions[0] else: extension = '%d' % (len(extensions),) self.config_status_extra = ' (%r)' % (extension,) else: # check if a config value was changed that affects how # doctrees are read for item in config.filter('env'): if self.config[item.name] != item.value: self.config_status = CONFIG_CHANGED self.config_status_extra = ' (%r)' % (item.name,) break self.config = config def _update_settings(self, config: Config) -> None: """Update settings by new config.""" self.settings['input_encoding'] = config.source_encoding self.settings['trim_footnote_reference_space'] = config.trim_footnote_reference_space self.settings['language_code'] = config.language or 'en' # Allow to disable by 3rd party extension (workaround) self.settings.setdefault('smart_quotes', True) def set_versioning_method(self, method: Union[str, Callable], compare: bool) -> None: """This sets the doctree versioning method for this environment. Versioning methods are a builder property; only builders with the same versioning method can share the same doctree directory. Therefore, we raise an exception if the user tries to use an environment with an incompatible versioning method. """ condition: Union[bool, Callable] if callable(method): condition = method else: if method not in versioning_conditions: raise ValueError('invalid versioning method: %r' % method) condition = versioning_conditions[method] if self.versioning_condition not in (None, condition): raise SphinxError(__('This environment is incompatible with the ' 'selected builder, please choose another ' 'doctree directory.')) self.versioning_condition = condition self.versioning_compare = compare def clear_doc(self, docname: str) -> None: """Remove all traces of a source file in the inventory.""" if docname in self.all_docs: self.all_docs.pop(docname, None) self.included.pop(docname, None) self.reread_always.discard(docname) for domain in self.domains.values(): domain.clear_doc(docname) def merge_info_from(self, docnames: List[str], other: "BuildEnvironment", app: "Sphinx") -> None: """Merge global information gathered about *docnames* while reading them from the *other* environment. This possibly comes from a parallel build process. """ docnames = set(docnames) # type: ignore for docname in docnames: self.all_docs[docname] = other.all_docs[docname] self.included[docname] = other.included[docname] if docname in other.reread_always: self.reread_always.add(docname) for domainname, domain in self.domains.items(): domain.merge_domaindata(docnames, other.domaindata[domainname]) self.events.emit('env-merge-info', self, docnames, other) def path2doc(self, filename: str) -> Optional[str]: """Return the docname for the filename if the file is document. *filename* should be absolute or relative to the source directory. """ return self.project.path2doc(filename) def doc2path(self, docname: str, base: bool = True) -> str: """Return the filename for the document name. If *base* is True, return absolute path under self.srcdir. If *base* is False, return relative path to self.srcdir. """ return self.project.doc2path(docname, base) def relfn2path(self, filename: str, docname: str = None) -> Tuple[str, str]: """Return paths to a file referenced from a document, relative to documentation root and absolute. In the input "filename", absolute filenames are taken as relative to the source dir, while relative filenames are relative to the dir of the containing document. """ filename = os_path(filename) if filename.startswith('/') or filename.startswith(os.sep): rel_fn = filename[1:] else: docdir = path.dirname(self.doc2path(docname or self.docname, base=None)) rel_fn = path.join(docdir, filename) return (canon_path(path.normpath(rel_fn)), path.normpath(path.join(self.srcdir, rel_fn))) @property def found_docs(self) -> Set[str]: """contains all existing docnames.""" return self.project.docnames def find_files(self, config: Config, builder: "Builder") -> None: """Find all source files in the source dir and put them in self.found_docs. """ try: exclude_paths = (self.config.exclude_patterns + self.config.templates_path + builder.get_asset_paths()) self.project.discover(exclude_paths) # Current implementation is applying translated messages in the reading # phase.Therefore, in order to apply the updated message catalog, it is # necessary to re-process from the reading phase. Here, if dependency # is set for the doc source and the mo file, it is processed again from # the reading phase when mo is updated. In the future, we would like to # move i18n process into the writing phase, and remove these lines. if builder.use_message_catalog: # add catalog mo file dependency repo = CatalogRepository(self.srcdir, self.config.locale_dirs, self.config.language, self.config.source_encoding) mo_paths = {c.domain: c.mo_path for c in repo.catalogs} for docname in self.found_docs: domain = docname_to_domain(docname, self.config.gettext_compact) if domain in mo_paths: self.dependencies[docname].add(mo_paths[domain]) except OSError as exc: raise DocumentError(__('Failed to scan documents in %s: %r') % (self.srcdir, exc)) from exc def get_outdated_files(self, config_changed: bool) -> Tuple[Set[str], Set[str], Set[str]]: """Return (added, changed, removed) sets.""" # clear all files no longer present removed = set(self.all_docs) - self.found_docs added: Set[str] = set() changed: Set[str] = set() if config_changed: # config values affect e.g. substitutions added = self.found_docs else: for docname in self.found_docs: if docname not in self.all_docs: logger.debug('[build target] added %r', docname) added.add(docname) continue # if the doctree file is not there, rebuild filename = path.join(self.doctreedir, docname + '.doctree') if not path.isfile(filename): logger.debug('[build target] changed %r', docname) changed.add(docname) continue # check the "reread always" list if docname in self.reread_always: logger.debug('[build target] changed %r', docname) changed.add(docname) continue # check the mtime of the document mtime = self.all_docs[docname] newmtime = path.getmtime(self.doc2path(docname)) if newmtime > mtime: logger.debug('[build target] outdated %r: %s -> %s', docname, datetime.utcfromtimestamp(mtime), datetime.utcfromtimestamp(newmtime)) changed.add(docname) continue # finally, check the mtime of dependencies for dep in self.dependencies[docname]: try: # this will do the right thing when dep is absolute too deppath = path.join(self.srcdir, dep) if not path.isfile(deppath): changed.add(docname) break depmtime = path.getmtime(deppath) if depmtime > mtime: changed.add(docname) break except OSError: # give it another chance changed.add(docname) break return added, changed, removed def check_dependents(self, app: "Sphinx", already: Set[str]) -> Generator[str, None, None]: to_rewrite: List[str] = [] for docnames in self.events.emit('env-get-updated', self): to_rewrite.extend(docnames) for docname in set(to_rewrite): if docname not in already: yield docname # --------- SINGLE FILE READING -------------------------------------------- def prepare_settings(self, docname: str) -> None: """Prepare to set up environment for reading.""" self.temp_data['docname'] = docname # defaults to the global default, but can be re-set in a document self.temp_data['default_role'] = self.config.default_role self.temp_data['default_domain'] = \ self.domains.get(self.config.primary_domain) # utilities to use while reading a document @property def docname(self) -> str: """Returns the docname of the document currently being parsed.""" return self.temp_data['docname'] def new_serialno(self, category: str = '') -> int: """Return a serial number, e.g. for index entry targets. The number is guaranteed to be unique in the current document. """ key = category + 'serialno' cur = self.temp_data.get(key, 0) self.temp_data[key] = cur + 1 return cur def note_dependency(self, filename: str) -> None: """Add *filename* as a dependency of the current document. This means that the document will be rebuilt if this file changes. *filename* should be absolute or relative to the source directory. """ self.dependencies[self.docname].add(filename) def note_included(self, filename: str) -> None: """Add *filename* as a included from other document. This means the document is not orphaned. *filename* should be absolute or relative to the source directory. """ self.included[self.docname].add(self.path2doc(filename)) def note_reread(self) -> None: """Add the current document to the list of documents that will automatically be re-read at the next build. """ self.reread_always.add(self.docname) def get_domain(self, domainname: str) -> Domain: """Return the domain instance with the specified name. Raises an ExtensionError if the domain is not registered. """ try: return self.domains[domainname] except KeyError as exc: raise ExtensionError(__('Domain %r is not registered') % domainname) from exc # --------- RESOLVING REFERENCES AND TOCTREES ------------------------------ def get_doctree(self, docname: str) -> nodes.document: """Read the doctree for a file from the pickle and return it.""" filename = path.join(self.doctreedir, docname + '.doctree') with open(filename, 'rb') as f: doctree = pickle.load(f) doctree.settings.env = self doctree.reporter = LoggingReporter(self.doc2path(docname)) return doctree def get_and_resolve_doctree(self, docname: str, builder: "Builder", doctree: nodes.document = None, prune_toctrees: bool = True, includehidden: bool = False) -> nodes.document: """Read the doctree from the pickle, resolve cross-references and toctrees and return it. """ if doctree is None: doctree = self.get_doctree(docname) # resolve all pending cross-references self.apply_post_transforms(doctree, docname) # now, resolve all toctree nodes for toctreenode in doctree.traverse(addnodes.toctree): result = TocTree(self).resolve(docname, builder, toctreenode, prune=prune_toctrees, includehidden=includehidden) if result is None: toctreenode.replace_self([]) else: toctreenode.replace_self(result) return doctree def resolve_toctree(self, docname: str, builder: "Builder", toctree: addnodes.toctree, prune: bool = True, maxdepth: int = 0, titles_only: bool = False, collapse: bool = False, includehidden: bool = False) -> Node: """Resolve a *toctree* node into individual bullet lists with titles as items, returning None (if no containing titles are found) or a new node. If *prune* is True, the tree is pruned to *maxdepth*, or if that is 0, to the value of the *maxdepth* option on the *toctree* node. If *titles_only* is True, only toplevel document titles will be in the resulting tree. If *collapse* is True, all branches not containing docname will be collapsed. """ return TocTree(self).resolve(docname, builder, toctree, prune, maxdepth, titles_only, collapse, includehidden) def resolve_references(self, doctree: nodes.document, fromdocname: str, builder: "Builder") -> None: self.apply_post_transforms(doctree, fromdocname) def apply_post_transforms(self, doctree: nodes.document, docname: str) -> None: """Apply all post-transforms.""" try: # set env.docname during applying post-transforms backup = copy(self.temp_data) self.temp_data['docname'] = docname transformer = SphinxTransformer(doctree) transformer.set_environment(self) transformer.add_transforms(self.app.registry.get_post_transforms()) transformer.apply_transforms() finally: self.temp_data = backup # allow custom references to be resolved self.events.emit('doctree-resolved', doctree, docname) def collect_relations(self) -> Dict[str, List[Optional[str]]]: traversed = set() def traverse_toctree(parent: str, docname: str) -> Iterator[Tuple[str, str]]: if parent == docname: logger.warning(__('self referenced toctree found. Ignored.'), location=docname, type='toc', subtype='circular') return # traverse toctree by pre-order yield parent, docname traversed.add(docname) for child in (self.toctree_includes.get(docname) or []): for subparent, subdocname in traverse_toctree(docname, child): if subdocname not in traversed: yield subparent, subdocname traversed.add(subdocname) relations = {} docnames = traverse_toctree(None, self.config.root_doc) prevdoc = None parent, docname = next(docnames) for nextparent, nextdoc in docnames: relations[docname] = [parent, prevdoc, nextdoc] prevdoc = docname docname = nextdoc parent = nextparent relations[docname] = [parent, prevdoc, None] return relations def check_consistency(self) -> None: """Do consistency checks.""" included = set().union(*self.included.values()) # type: ignore for docname in sorted(self.all_docs): if docname not in self.files_to_rebuild: if docname == self.config.root_doc: # the master file is not included anywhere ;) continue if docname in included: # the document is included from other documents continue if 'orphan' in self.metadata[docname]: continue logger.warning(__('document isn\'t included in any toctree'), location=docname) # call check-consistency for all extensions for domain in self.domains.values(): domain.check_consistency() self.events.emit('env-check-consistency', self) ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4565072 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/environment/adapters/�����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�020013� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/environment/adapters/__init__.py������������������������������������������������0000644�0000766�0000024�00000000333�00000000000�022123� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.environment.adapters ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Sphinx environment adapters :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/environment/adapters/asset.py���������������������������������������������������0000644�0000766�0000024�00000001147�00000000000�021507� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.environment.adapters.asset ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Assets adapter for sphinx.environment. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from sphinx.environment import BuildEnvironment class ImageAdapter: def __init__(self, env: BuildEnvironment) -> None: self.env = env def get_original_image_uri(self, name: str) -> str: """Get the original image URI.""" while name in self.env.original_image_uri: name = self.env.original_image_uri[name] return name �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/environment/adapters/indexentries.py��������������������������������������������0000644�0000766�0000024�00000016756�00000000000�023105� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.environment.adapters.indexentries ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Index entries adapters for sphinx.environment. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import re import unicodedata from itertools import groupby from typing import Any, Dict, List, Pattern, Tuple, cast from sphinx.builders import Builder from sphinx.domains.index import IndexDomain from sphinx.environment import BuildEnvironment from sphinx.errors import NoUri from sphinx.locale import _, __ from sphinx.util import logging, split_into logger = logging.getLogger(__name__) class IndexEntries: def __init__(self, env: BuildEnvironment) -> None: self.env = env def create_index(self, builder: Builder, group_entries: bool = True, _fixre: Pattern = re.compile(r'(.*) ([(][^()]*[)])') ) -> List[Tuple[str, List[Tuple[str, Any]]]]: """Create the real index from the collected index entries.""" new: Dict[str, List] = {} def add_entry(word: str, subword: str, main: str, link: bool = True, dic: Dict = new, key: str = None) -> None: # Force the word to be unicode if it's a ASCII bytestring. # This will solve problems with unicode normalization later. # For instance the RFC role will add bytestrings at the moment word = str(word) entry = dic.get(word) if not entry: dic[word] = entry = [[], {}, key] if subword: add_entry(subword, '', main, link=link, dic=entry[1], key=key) elif link: try: uri = builder.get_relative_uri('genindex', fn) + '#' + tid except NoUri: pass else: entry[0].append((main, uri)) domain = cast(IndexDomain, self.env.get_domain('index')) for fn, entries in domain.entries.items(): # new entry types must be listed in directives/other.py! for type, value, tid, main, index_key in entries: try: if type == 'single': try: entry, subentry = split_into(2, 'single', value) except ValueError: entry, = split_into(1, 'single', value) subentry = '' add_entry(entry, subentry, main, key=index_key) elif type == 'pair': first, second = split_into(2, 'pair', value) add_entry(first, second, main, key=index_key) add_entry(second, first, main, key=index_key) elif type == 'triple': first, second, third = split_into(3, 'triple', value) add_entry(first, second + ' ' + third, main, key=index_key) add_entry(second, third + ', ' + first, main, key=index_key) add_entry(third, first + ' ' + second, main, key=index_key) elif type == 'see': first, second = split_into(2, 'see', value) add_entry(first, _('see %s') % second, None, link=False, key=index_key) elif type == 'seealso': first, second = split_into(2, 'see', value) add_entry(first, _('see also %s') % second, None, link=False, key=index_key) else: logger.warning(__('unknown index entry type %r'), type, location=fn) except ValueError as err: logger.warning(str(err), location=fn) # sort the index entries for same keyword. def keyfunc0(entry: Tuple[str, str]) -> Tuple[bool, str]: main, uri = entry return (not main, uri) # show main entries at first for indexentry in new.values(): indexentry[0].sort(key=keyfunc0) for subentry in indexentry[1].values(): subentry[0].sort(key=keyfunc0) # type: ignore # sort the index entries def keyfunc(entry: Tuple[str, List]) -> Tuple[Tuple[int, str], str]: key, (void, void, category_key) = entry if category_key: # using specified category key to sort key = category_key lckey = unicodedata.normalize('NFD', key.lower()) if lckey.startswith('\N{RIGHT-TO-LEFT MARK}'): lckey = lckey[1:] if lckey[0:1].isalpha() or lckey.startswith('_'): # put non-symbol characters at the following group (1) sortkey = (1, lckey) else: # put symbols at the front of the index (0) sortkey = (0, lckey) # ensure a deterministic order *within* letters by also sorting on # the entry itself return (sortkey, entry[0]) newlist = sorted(new.items(), key=keyfunc) if group_entries: # fixup entries: transform # func() (in module foo) # func() (in module bar) # into # func() # (in module foo) # (in module bar) oldkey = '' oldsubitems: Dict[str, List] = None i = 0 while i < len(newlist): key, (targets, subitems, _key) = newlist[i] # cannot move if it has subitems; structure gets too complex if not subitems: m = _fixre.match(key) if m: if oldkey == m.group(1): # prefixes match: add entry as subitem of the # previous entry oldsubitems.setdefault(m.group(2), [[], {}, _key])[0].\ extend(targets) del newlist[i] continue oldkey = m.group(1) else: oldkey = key oldsubitems = subitems i += 1 # sort the sub-index entries def keyfunc2(entry: Tuple[str, List]) -> str: key = unicodedata.normalize('NFD', entry[0].lower()) if key.startswith('\N{RIGHT-TO-LEFT MARK}'): key = key[1:] if key[0:1].isalpha() or key.startswith('_'): key = chr(127) + key return key # group the entries by letter def keyfunc3(item: Tuple[str, List]) -> str: # hack: mutating the subitems dicts to a list in the keyfunc k, v = item v[1] = sorted(((si, se) for (si, (se, void, void)) in v[1].items()), key=keyfunc2) if v[2] is None: # now calculate the key if k.startswith('\N{RIGHT-TO-LEFT MARK}'): k = k[1:] letter = unicodedata.normalize('NFD', k[0])[0].upper() if letter.isalpha() or letter == '_': return letter else: # get all other symbols under one heading return _('Symbols') else: return v[2] return [(key_, list(group)) for (key_, group) in groupby(newlist, keyfunc3)] ������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/environment/adapters/toctree.py�������������������������������������������������0000644�0000766�0000024�00000037351�00000000000�022043� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.environment.adapters.toctree ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Toctree adapter for sphinx.environment. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import TYPE_CHECKING, Any, Iterable, List, Optional, cast from docutils import nodes from docutils.nodes import Element, Node from sphinx import addnodes from sphinx.locale import __ from sphinx.util import logging, url_re from sphinx.util.matching import Matcher from sphinx.util.nodes import clean_astext, process_only_nodes if TYPE_CHECKING: from sphinx.builders import Builder from sphinx.environment import BuildEnvironment logger = logging.getLogger(__name__) class TocTree: def __init__(self, env: "BuildEnvironment") -> None: self.env = env def note(self, docname: str, toctreenode: addnodes.toctree) -> None: """Note a TOC tree directive in a document and gather information about file relations from it. """ if toctreenode['glob']: self.env.glob_toctrees.add(docname) if toctreenode.get('numbered'): self.env.numbered_toctrees.add(docname) includefiles = toctreenode['includefiles'] for includefile in includefiles: # note that if the included file is rebuilt, this one must be # too (since the TOC of the included file could have changed) self.env.files_to_rebuild.setdefault(includefile, set()).add(docname) self.env.toctree_includes.setdefault(docname, []).extend(includefiles) def resolve(self, docname: str, builder: "Builder", toctree: addnodes.toctree, prune: bool = True, maxdepth: int = 0, titles_only: bool = False, collapse: bool = False, includehidden: bool = False) -> Optional[Element]: """Resolve a *toctree* node into individual bullet lists with titles as items, returning None (if no containing titles are found) or a new node. If *prune* is True, the tree is pruned to *maxdepth*, or if that is 0, to the value of the *maxdepth* option on the *toctree* node. If *titles_only* is True, only toplevel document titles will be in the resulting tree. If *collapse* is True, all branches not containing docname will be collapsed. """ if toctree.get('hidden', False) and not includehidden: return None # For reading the following two helper function, it is useful to keep # in mind the node structure of a toctree (using HTML-like node names # for brevity): # # <ul> # <li> # <p><a></p> # <p><a></p> # ... # <ul> # ... # </ul> # </li> # </ul> # # The transformation is made in two passes in order to avoid # interactions between marking and pruning the tree (see bug #1046). toctree_ancestors = self.get_toctree_ancestors(docname) excluded = Matcher(self.env.config.exclude_patterns) def _toctree_add_classes(node: Element, depth: int) -> None: """Add 'toctree-l%d' and 'current' classes to the toctree.""" for subnode in node.children: if isinstance(subnode, (addnodes.compact_paragraph, nodes.list_item)): # for <p> and <li>, indicate the depth level and recurse subnode['classes'].append('toctree-l%d' % (depth - 1)) _toctree_add_classes(subnode, depth) elif isinstance(subnode, nodes.bullet_list): # for <ul>, just recurse _toctree_add_classes(subnode, depth + 1) elif isinstance(subnode, nodes.reference): # for <a>, identify which entries point to the current # document and therefore may not be collapsed if subnode['refuri'] == docname: if not subnode['anchorname']: # give the whole branch a 'current' class # (useful for styling it differently) branchnode: Element = subnode while branchnode: branchnode['classes'].append('current') branchnode = branchnode.parent # mark the list_item as "on current page" if subnode.parent.parent.get('iscurrent'): # but only if it's not already done return while subnode: subnode['iscurrent'] = True subnode = subnode.parent def _entries_from_toctree(toctreenode: addnodes.toctree, parents: List[str], separate: bool = False, subtree: bool = False ) -> List[Element]: """Return TOC entries for a toctree node.""" refs = [(e[0], e[1]) for e in toctreenode['entries']] entries: List[Element] = [] for (title, ref) in refs: try: refdoc = None if url_re.match(ref): if title is None: title = ref reference = nodes.reference('', '', internal=False, refuri=ref, anchorname='', *[nodes.Text(title)]) para = addnodes.compact_paragraph('', '', reference) item = nodes.list_item('', para) toc = nodes.bullet_list('', item) elif ref == 'self': # 'self' refers to the document from which this # toctree originates ref = toctreenode['parent'] if not title: title = clean_astext(self.env.titles[ref]) reference = nodes.reference('', '', internal=True, refuri=ref, anchorname='', *[nodes.Text(title)]) para = addnodes.compact_paragraph('', '', reference) item = nodes.list_item('', para) # don't show subitems toc = nodes.bullet_list('', item) else: if ref in parents: logger.warning(__('circular toctree references ' 'detected, ignoring: %s <- %s'), ref, ' <- '.join(parents), location=ref, type='toc', subtype='circular') continue refdoc = ref toc = self.env.tocs[ref].deepcopy() maxdepth = self.env.metadata[ref].get('tocdepth', 0) if ref not in toctree_ancestors or (prune and maxdepth > 0): self._toctree_prune(toc, 2, maxdepth, collapse) process_only_nodes(toc, builder.tags) if title and toc.children and len(toc.children) == 1: child = toc.children[0] for refnode in child.traverse(nodes.reference): if refnode['refuri'] == ref and \ not refnode['anchorname']: refnode.children = [nodes.Text(title)] if not toc.children: # empty toc means: no titles will show up in the toctree logger.warning(__('toctree contains reference to document %r that ' 'doesn\'t have a title: no link will be generated'), ref, location=toctreenode) except KeyError: # this is raised if the included file does not exist if excluded(self.env.doc2path(ref, None)): message = __('toctree contains reference to excluded document %r') else: message = __('toctree contains reference to nonexisting document %r') logger.warning(message, ref, location=toctreenode) else: # if titles_only is given, only keep the main title and # sub-toctrees if titles_only: # children of toc are: # - list_item + compact_paragraph + (reference and subtoc) # - only + subtoc # - toctree children = cast(Iterable[nodes.Element], toc) # delete everything but the toplevel title(s) # and toctrees for toplevel in children: # nodes with length 1 don't have any children anyway if len(toplevel) > 1: subtrees = list(toplevel.traverse(addnodes.toctree)) if subtrees: toplevel[1][:] = subtrees # type: ignore else: toplevel.pop(1) # resolve all sub-toctrees for subtocnode in list(toc.traverse(addnodes.toctree)): if not (subtocnode.get('hidden', False) and not includehidden): i = subtocnode.parent.index(subtocnode) + 1 for entry in _entries_from_toctree( subtocnode, [refdoc] + parents, subtree=True): subtocnode.parent.insert(i, entry) i += 1 subtocnode.parent.remove(subtocnode) if separate: entries.append(toc) else: children = cast(Iterable[nodes.Element], toc) entries.extend(children) if not subtree and not separate: ret = nodes.bullet_list() ret += entries return [ret] return entries maxdepth = maxdepth or toctree.get('maxdepth', -1) if not titles_only and toctree.get('titlesonly', False): titles_only = True if not includehidden and toctree.get('includehidden', False): includehidden = True # NOTE: previously, this was separate=True, but that leads to artificial # separation when two or more toctree entries form a logical unit, so # separating mode is no longer used -- it's kept here for history's sake tocentries = _entries_from_toctree(toctree, [], separate=False) if not tocentries: return None newnode = addnodes.compact_paragraph('', '') caption = toctree.attributes.get('caption') if caption: caption_node = nodes.title(caption, '', *[nodes.Text(caption)]) caption_node.line = toctree.line caption_node.source = toctree.source caption_node.rawsource = toctree['rawcaption'] if hasattr(toctree, 'uid'): # move uid to caption_node to translate it caption_node.uid = toctree.uid # type: ignore del toctree.uid # type: ignore newnode += caption_node newnode.extend(tocentries) newnode['toctree'] = True # prune the tree to maxdepth, also set toc depth and current classes _toctree_add_classes(newnode, 1) self._toctree_prune(newnode, 1, maxdepth if prune else 0, collapse) if isinstance(newnode[-1], nodes.Element) and len(newnode[-1]) == 0: # No titles found return None # set the target paths in the toctrees (they are not known at TOC # generation time) for refnode in newnode.traverse(nodes.reference): if not url_re.match(refnode['refuri']): refnode['refuri'] = builder.get_relative_uri( docname, refnode['refuri']) + refnode['anchorname'] return newnode def get_toctree_ancestors(self, docname: str) -> List[str]: parent = {} for p, children in self.env.toctree_includes.items(): for child in children: parent[child] = p ancestors: List[str] = [] d = docname while d in parent and d not in ancestors: ancestors.append(d) d = parent[d] return ancestors def _toctree_prune(self, node: Element, depth: int, maxdepth: int, collapse: bool = False ) -> None: """Utility: Cut a TOC at a specified depth.""" for subnode in node.children[:]: if isinstance(subnode, (addnodes.compact_paragraph, nodes.list_item)): # for <p> and <li>, just recurse self._toctree_prune(subnode, depth, maxdepth, collapse) elif isinstance(subnode, nodes.bullet_list): # for <ul>, determine if the depth is too large or if the # entry is to be collapsed if maxdepth > 0 and depth > maxdepth: subnode.parent.replace(subnode, []) else: # cull sub-entries whose parents aren't 'current' if (collapse and depth > 1 and 'iscurrent' not in subnode.parent): subnode.parent.remove(subnode) else: # recurse on visible children self._toctree_prune(subnode, depth + 1, maxdepth, collapse) def get_toc_for(self, docname: str, builder: "Builder") -> Node: """Return a TOC nodetree -- for use on the same page only!""" tocdepth = self.env.metadata[docname].get('tocdepth', 0) try: toc = self.env.tocs[docname].deepcopy() self._toctree_prune(toc, 2, tocdepth) except KeyError: # the document does not exist anymore: return a dummy node that # renders to nothing return nodes.paragraph() process_only_nodes(toc, builder.tags) for node in toc.traverse(nodes.reference): node['refuri'] = node['anchorname'] or '#' return toc def get_toctree_for(self, docname: str, builder: "Builder", collapse: bool, **kwargs: Any) -> Optional[Element]: """Return the global TOC nodetree.""" doctree = self.env.get_doctree(self.env.config.root_doc) toctrees: List[Element] = [] if 'includehidden' not in kwargs: kwargs['includehidden'] = True if 'maxdepth' not in kwargs or not kwargs['maxdepth']: kwargs['maxdepth'] = 0 else: kwargs['maxdepth'] = int(kwargs['maxdepth']) kwargs['collapse'] = collapse for toctreenode in doctree.traverse(addnodes.toctree): toctree = self.resolve(docname, builder, toctreenode, prune=True, **kwargs) if toctree: toctrees.append(toctree) if not toctrees: return None result = toctrees[0] for toctree in toctrees[1:]: result.extend(toctree.children) return result ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4578068 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/environment/collectors/���������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�020361� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/environment/collectors/__init__.py����������������������������������������������0000644�0000766�0000024�00000005645�00000000000�022504� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.environment.collectors ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The data collector components for sphinx.environment. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import TYPE_CHECKING, Dict, List, Optional, Set from docutils import nodes from sphinx.environment import BuildEnvironment if TYPE_CHECKING: from sphinx.application import Sphinx class EnvironmentCollector: """An EnvironmentCollector is a specific data collector from each document. It gathers data and stores :py:class:`BuildEnvironment <sphinx.environment.BuildEnvironment>` as a database. Examples of specific data would be images, download files, section titles, metadatas, index entries and toctrees, etc. """ listener_ids: Optional[Dict[str, int]] = None def enable(self, app: "Sphinx") -> None: assert self.listener_ids is None self.listener_ids = { 'doctree-read': app.connect('doctree-read', self.process_doc), 'env-merge-info': app.connect('env-merge-info', self.merge_other), 'env-purge-doc': app.connect('env-purge-doc', self.clear_doc), 'env-get-updated': app.connect('env-get-updated', self.get_updated_docs), 'env-get-outdated': app.connect('env-get-outdated', self.get_outdated_docs), } def disable(self, app: "Sphinx") -> None: assert self.listener_ids is not None for listener_id in self.listener_ids.values(): app.disconnect(listener_id) self.listener_ids = None def clear_doc(self, app: "Sphinx", env: BuildEnvironment, docname: str) -> None: """Remove specified data of a document. This method is called on the removal of the document.""" raise NotImplementedError def merge_other(self, app: "Sphinx", env: BuildEnvironment, docnames: Set[str], other: BuildEnvironment) -> None: """Merge in specified data regarding docnames from a different `BuildEnvironment` object which coming from a subprocess in parallel builds.""" raise NotImplementedError def process_doc(self, app: "Sphinx", doctree: nodes.document) -> None: """Process a document and gather specific data from it. This method is called after the document is read.""" raise NotImplementedError def get_updated_docs(self, app: "Sphinx", env: BuildEnvironment) -> List[str]: """Return a list of docnames to re-read. This methods is called after reading the whole of documents (experimental). """ return [] def get_outdated_docs(self, app: "Sphinx", env: BuildEnvironment, added: Set[str], changed: Set[str], removed: Set[str]) -> List[str]: """Return a list of docnames to re-read. This methods is called before reading the documents. """ return [] �������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/environment/collectors/asset.py�������������������������������������������������0000644�0000766�0000024�00000014467�00000000000�022066� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.environment.collectors.asset ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The image collector for sphinx.environment. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import os from glob import glob from os import path from typing import Any, Dict, List, Set from docutils import nodes from docutils.nodes import Node from docutils.utils import relative_path from sphinx import addnodes from sphinx.application import Sphinx from sphinx.environment import BuildEnvironment from sphinx.environment.collectors import EnvironmentCollector from sphinx.locale import __ from sphinx.util import logging from sphinx.util.i18n import get_image_filename_for_language, search_image_for_language from sphinx.util.images import guess_mimetype logger = logging.getLogger(__name__) class ImageCollector(EnvironmentCollector): """Image files collector for sphinx.environment.""" def clear_doc(self, app: Sphinx, env: BuildEnvironment, docname: str) -> None: env.images.purge_doc(docname) def merge_other(self, app: Sphinx, env: BuildEnvironment, docnames: Set[str], other: BuildEnvironment) -> None: env.images.merge_other(docnames, other.images) def process_doc(self, app: Sphinx, doctree: nodes.document) -> None: """Process and rewrite image URIs.""" docname = app.env.docname for node in doctree.traverse(nodes.image): # Map the mimetype to the corresponding image. The writer may # choose the best image from these candidates. The special key * is # set if there is only single candidate to be used by a writer. # The special key ? is set for nonlocal URIs. candidates: Dict[str, str] = {} node['candidates'] = candidates imguri = node['uri'] if imguri.startswith('data:'): candidates['?'] = imguri continue elif imguri.find('://') != -1: candidates['?'] = imguri continue if imguri.endswith(os.extsep + '*'): # Update `node['uri']` to a relative path from srcdir # from a relative path from current document. rel_imgpath, full_imgpath = app.env.relfn2path(imguri, docname) node['uri'] = rel_imgpath if app.config.language: # Search language-specific figures at first i18n_imguri = get_image_filename_for_language(imguri, app.env) _, full_i18n_imgpath = app.env.relfn2path(i18n_imguri, docname) self.collect_candidates(app.env, full_i18n_imgpath, candidates, node) self.collect_candidates(app.env, full_imgpath, candidates, node) else: if app.config.language: # substitute imguri by figure_language_filename # (ex. foo.png -> foo.en.png) imguri = search_image_for_language(imguri, app.env) # Update `node['uri']` to a relative path from srcdir # from a relative path from current document. node['uri'], _ = app.env.relfn2path(imguri, docname) candidates['*'] = node['uri'] # map image paths to unique image names (so that they can be put # into a single directory) for imgpath in candidates.values(): app.env.dependencies[docname].add(imgpath) if not os.access(path.join(app.srcdir, imgpath), os.R_OK): logger.warning(__('image file not readable: %s') % imgpath, location=node, type='image', subtype='not_readable') continue app.env.images.add_file(docname, imgpath) def collect_candidates(self, env: BuildEnvironment, imgpath: str, candidates: Dict[str, str], node: Node) -> None: globbed: Dict[str, List[str]] = {} for filename in glob(imgpath): new_imgpath = relative_path(path.join(env.srcdir, 'dummy'), filename) try: mimetype = guess_mimetype(filename) if mimetype is None: basename, suffix = path.splitext(filename) mimetype = 'image/x-' + suffix[1:] if mimetype not in candidates: globbed.setdefault(mimetype, []).append(new_imgpath) except OSError as err: logger.warning(__('image file %s not readable: %s') % (filename, err), location=node, type='image', subtype='not_readable') for key, files in globbed.items(): candidates[key] = sorted(files, key=len)[0] # select by similarity class DownloadFileCollector(EnvironmentCollector): """Download files collector for sphinx.environment.""" def clear_doc(self, app: Sphinx, env: BuildEnvironment, docname: str) -> None: env.dlfiles.purge_doc(docname) def merge_other(self, app: Sphinx, env: BuildEnvironment, docnames: Set[str], other: BuildEnvironment) -> None: env.dlfiles.merge_other(docnames, other.dlfiles) def process_doc(self, app: Sphinx, doctree: nodes.document) -> None: """Process downloadable file paths. """ for node in doctree.traverse(addnodes.download_reference): targetname = node['reftarget'] if '://' in targetname: node['refuri'] = targetname else: rel_filename, filename = app.env.relfn2path(targetname, app.env.docname) app.env.dependencies[app.env.docname].add(rel_filename) if not os.access(filename, os.R_OK): logger.warning(__('download file not readable: %s') % filename, location=node, type='download', subtype='not_readable') continue node['filename'] = app.env.dlfiles.add_file(app.env.docname, rel_filename) def setup(app: Sphinx) -> Dict[str, Any]: app.add_env_collector(ImageCollector) app.add_env_collector(DownloadFileCollector) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/environment/collectors/dependencies.py������������������������������������������0000644�0000766�0000024�00000004035�00000000000�023363� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.environment.collectors.dependencies ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The dependencies collector components for sphinx.environment. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import os from os import path from typing import Any, Dict, Set from docutils import nodes from docutils.utils import relative_path from sphinx.application import Sphinx from sphinx.environment import BuildEnvironment from sphinx.environment.collectors import EnvironmentCollector from sphinx.util.osutil import fs_encoding class DependenciesCollector(EnvironmentCollector): """dependencies collector for sphinx.environment.""" def clear_doc(self, app: Sphinx, env: BuildEnvironment, docname: str) -> None: env.dependencies.pop(docname, None) def merge_other(self, app: Sphinx, env: BuildEnvironment, docnames: Set[str], other: BuildEnvironment) -> None: for docname in docnames: if docname in other.dependencies: env.dependencies[docname] = other.dependencies[docname] def process_doc(self, app: Sphinx, doctree: nodes.document) -> None: """Process docutils-generated dependency info.""" cwd = os.getcwd() frompath = path.join(path.normpath(app.srcdir), 'dummy') deps = doctree.settings.record_dependencies if not deps: return for dep in deps.list: # the dependency path is relative to the working dir, so get # one relative to the srcdir if isinstance(dep, bytes): dep = dep.decode(fs_encoding) relpath = relative_path(frompath, path.normpath(path.join(cwd, dep))) app.env.dependencies[app.env.docname].add(relpath) def setup(app: Sphinx) -> Dict[str, Any]: app.add_env_collector(DependenciesCollector) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/environment/collectors/metadata.py����������������������������������������������0000644�0000766�0000024�00000005341�00000000000�022516� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.environment.collectors.metadata ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The metadata collector components for sphinx.environment. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Any, Dict, List, Set, cast from docutils import nodes from sphinx.application import Sphinx from sphinx.environment import BuildEnvironment from sphinx.environment.collectors import EnvironmentCollector class MetadataCollector(EnvironmentCollector): """metadata collector for sphinx.environment.""" def clear_doc(self, app: Sphinx, env: BuildEnvironment, docname: str) -> None: env.metadata.pop(docname, None) def merge_other(self, app: Sphinx, env: BuildEnvironment, docnames: Set[str], other: BuildEnvironment) -> None: for docname in docnames: env.metadata[docname] = other.metadata[docname] def process_doc(self, app: Sphinx, doctree: nodes.document) -> None: """Process the docinfo part of the doctree as metadata. Keep processing minimal -- just return what docutils says. """ index = doctree.first_child_not_matching_class(nodes.PreBibliographic) if index is None: return elif isinstance(doctree[index], nodes.docinfo): md = app.env.metadata[app.env.docname] for node in doctree[index]: # type: ignore # nodes are multiply inherited... if isinstance(node, nodes.authors): authors = cast(List[nodes.author], node) md['authors'] = [author.astext() for author in authors] elif isinstance(node, nodes.field): assert len(node) == 2 field_name = cast(nodes.field_name, node[0]) field_body = cast(nodes.field_body, node[1]) md[field_name.astext()] = field_body.astext() elif isinstance(node, nodes.TextElement): # other children must be TextElement # see: https://docutils.sourceforge.io/docs/ref/doctree.html#bibliographic-elements # NOQA md[node.__class__.__name__] = node.astext() for name, value in md.items(): if name in ('tocdepth',): try: value = int(value) except ValueError: value = 0 md[name] = value doctree.pop(index) def setup(app: Sphinx) -> Dict[str, Any]: app.add_env_collector(MetadataCollector) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/environment/collectors/title.py�������������������������������������������������0000644�0000766�0000024�00000004421�00000000000�022055� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.environment.collectors.title ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The title collector components for sphinx.environment. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Any, Dict, Set from docutils import nodes from sphinx.application import Sphinx from sphinx.environment import BuildEnvironment from sphinx.environment.collectors import EnvironmentCollector from sphinx.transforms import SphinxContentsFilter class TitleCollector(EnvironmentCollector): """title collector for sphinx.environment.""" def clear_doc(self, app: Sphinx, env: BuildEnvironment, docname: str) -> None: env.titles.pop(docname, None) env.longtitles.pop(docname, None) def merge_other(self, app: Sphinx, env: BuildEnvironment, docnames: Set[str], other: BuildEnvironment) -> None: for docname in docnames: env.titles[docname] = other.titles[docname] env.longtitles[docname] = other.longtitles[docname] def process_doc(self, app: Sphinx, doctree: nodes.document) -> None: """Add a title node to the document (just copy the first section title), and store that title in the environment. """ titlenode = nodes.title() longtitlenode = titlenode # explicit title set with title directive; use this only for # the <title> tag in HTML output if 'title' in doctree: longtitlenode = nodes.title() longtitlenode += nodes.Text(doctree['title']) # look for first section title and use that as the title for node in doctree.traverse(nodes.section): visitor = SphinxContentsFilter(doctree) node[0].walkabout(visitor) titlenode += visitor.get_entry_text() break else: # document has no title titlenode += nodes.Text(doctree.get('title', '<no title>')) app.env.titles[app.env.docname] = titlenode app.env.longtitles[app.env.docname] = longtitlenode def setup(app: Sphinx) -> Dict[str, Any]: app.add_env_collector(TitleCollector) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/environment/collectors/toctree.py�����������������������������������������������0000644�0000766�0000024�00000031650�00000000000�022405� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.environment.collectors.toctree ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Toctree collector for sphinx.environment. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Any, Dict, List, Set, Tuple, Type, TypeVar, cast from docutils import nodes from docutils.nodes import Element, Node from sphinx import addnodes from sphinx.application import Sphinx from sphinx.environment import BuildEnvironment from sphinx.environment.adapters.toctree import TocTree from sphinx.environment.collectors import EnvironmentCollector from sphinx.locale import __ from sphinx.transforms import SphinxContentsFilter from sphinx.util import logging, url_re N = TypeVar('N') logger = logging.getLogger(__name__) class TocTreeCollector(EnvironmentCollector): def clear_doc(self, app: Sphinx, env: BuildEnvironment, docname: str) -> None: env.tocs.pop(docname, None) env.toc_secnumbers.pop(docname, None) env.toc_fignumbers.pop(docname, None) env.toc_num_entries.pop(docname, None) env.toctree_includes.pop(docname, None) env.glob_toctrees.discard(docname) env.numbered_toctrees.discard(docname) for subfn, fnset in list(env.files_to_rebuild.items()): fnset.discard(docname) if not fnset: del env.files_to_rebuild[subfn] def merge_other(self, app: Sphinx, env: BuildEnvironment, docnames: Set[str], other: BuildEnvironment) -> None: for docname in docnames: env.tocs[docname] = other.tocs[docname] env.toc_num_entries[docname] = other.toc_num_entries[docname] if docname in other.toctree_includes: env.toctree_includes[docname] = other.toctree_includes[docname] if docname in other.glob_toctrees: env.glob_toctrees.add(docname) if docname in other.numbered_toctrees: env.numbered_toctrees.add(docname) for subfn, fnset in other.files_to_rebuild.items(): env.files_to_rebuild.setdefault(subfn, set()).update(fnset & set(docnames)) def process_doc(self, app: Sphinx, doctree: nodes.document) -> None: """Build a TOC from the doctree and store it in the inventory.""" docname = app.env.docname numentries = [0] # nonlocal again... def traverse_in_section(node: Element, cls: Type[N]) -> List[N]: """Like traverse(), but stay within the same section.""" result: List[N] = [] if isinstance(node, cls): result.append(node) for child in node.children: if isinstance(child, nodes.section): continue elif isinstance(child, nodes.Element): result.extend(traverse_in_section(child, cls)) return result def build_toc(node: Element, depth: int = 1) -> nodes.bullet_list: entries: List[Element] = [] for sectionnode in node: # find all toctree nodes in this section and add them # to the toc (just copying the toctree node which is then # resolved in self.get_and_resolve_doctree) if isinstance(sectionnode, nodes.section): title = sectionnode[0] # copy the contents of the section title, but without references # and unnecessary stuff visitor = SphinxContentsFilter(doctree) title.walkabout(visitor) nodetext = visitor.get_entry_text() if not numentries[0]: # for the very first toc entry, don't add an anchor # as it is the file's title anyway anchorname = '' else: anchorname = '#' + sectionnode['ids'][0] numentries[0] += 1 # make these nodes: # list_item -> compact_paragraph -> reference reference = nodes.reference( '', '', internal=True, refuri=docname, anchorname=anchorname, *nodetext) para = addnodes.compact_paragraph('', '', reference) item: Element = nodes.list_item('', para) sub_item = build_toc(sectionnode, depth + 1) if sub_item: item += sub_item entries.append(item) elif isinstance(sectionnode, addnodes.only): onlynode = addnodes.only(expr=sectionnode['expr']) blist = build_toc(sectionnode, depth) if blist: onlynode += blist.children entries.append(onlynode) elif isinstance(sectionnode, nodes.Element): for toctreenode in traverse_in_section(sectionnode, addnodes.toctree): item = toctreenode.copy() entries.append(item) # important: do the inventory stuff TocTree(app.env).note(docname, toctreenode) if entries: return nodes.bullet_list('', *entries) return None toc = build_toc(doctree) if toc: app.env.tocs[docname] = toc else: app.env.tocs[docname] = nodes.bullet_list('') app.env.toc_num_entries[docname] = numentries[0] def get_updated_docs(self, app: Sphinx, env: BuildEnvironment) -> List[str]: return self.assign_section_numbers(env) + self.assign_figure_numbers(env) def assign_section_numbers(self, env: BuildEnvironment) -> List[str]: """Assign a section number to each heading under a numbered toctree.""" # a list of all docnames whose section numbers changed rewrite_needed = [] assigned: Set[str] = set() old_secnumbers = env.toc_secnumbers env.toc_secnumbers = {} def _walk_toc(node: Element, secnums: Dict, depth: int, titlenode: nodes.title = None) -> None: # NOQA # titlenode is the title of the document, it will get assigned a # secnumber too, so that it shows up in next/prev/parent rellinks for subnode in node.children: if isinstance(subnode, nodes.bullet_list): numstack.append(0) _walk_toc(subnode, secnums, depth - 1, titlenode) numstack.pop() titlenode = None elif isinstance(subnode, nodes.list_item): _walk_toc(subnode, secnums, depth, titlenode) titlenode = None elif isinstance(subnode, addnodes.only): # at this stage we don't know yet which sections are going # to be included; just include all of them, even if it leads # to gaps in the numbering _walk_toc(subnode, secnums, depth, titlenode) titlenode = None elif isinstance(subnode, addnodes.compact_paragraph): numstack[-1] += 1 reference = cast(nodes.reference, subnode[0]) if depth > 0: number = list(numstack) secnums[reference['anchorname']] = tuple(numstack) else: number = None secnums[reference['anchorname']] = None reference['secnumber'] = number if titlenode: titlenode['secnumber'] = number titlenode = None elif isinstance(subnode, addnodes.toctree): _walk_toctree(subnode, depth) def _walk_toctree(toctreenode: addnodes.toctree, depth: int) -> None: if depth == 0: return for (title, ref) in toctreenode['entries']: if url_re.match(ref) or ref == 'self': # don't mess with those continue elif ref in assigned: logger.warning(__('%s is already assigned section numbers ' '(nested numbered toctree?)'), ref, location=toctreenode, type='toc', subtype='secnum') elif ref in env.tocs: secnums: Dict[str, Tuple[int, ...]] = {} env.toc_secnumbers[ref] = secnums assigned.add(ref) _walk_toc(env.tocs[ref], secnums, depth, env.titles.get(ref)) if secnums != old_secnumbers.get(ref): rewrite_needed.append(ref) for docname in env.numbered_toctrees: assigned.add(docname) doctree = env.get_doctree(docname) for toctreenode in doctree.traverse(addnodes.toctree): depth = toctreenode.get('numbered', 0) if depth: # every numbered toctree gets new numbering numstack = [0] _walk_toctree(toctreenode, depth) return rewrite_needed def assign_figure_numbers(self, env: BuildEnvironment) -> List[str]: """Assign a figure number to each figure under a numbered toctree.""" rewrite_needed = [] assigned: Set[str] = set() old_fignumbers = env.toc_fignumbers env.toc_fignumbers = {} fignum_counter: Dict[str, Dict[Tuple[int, ...], int]] = {} def get_figtype(node: Node) -> str: for domain in env.domains.values(): figtype = domain.get_enumerable_node_type(node) if domain.name == 'std' and not domain.get_numfig_title(node): # type: ignore # Skip if uncaptioned node continue if figtype: return figtype return None def get_section_number(docname: str, section: nodes.section) -> Tuple[int, ...]: anchorname = '#' + section['ids'][0] secnumbers = env.toc_secnumbers.get(docname, {}) if anchorname in secnumbers: secnum = secnumbers.get(anchorname) else: secnum = secnumbers.get('') return secnum or tuple() def get_next_fignumber(figtype: str, secnum: Tuple[int, ...]) -> Tuple[int, ...]: counter = fignum_counter.setdefault(figtype, {}) secnum = secnum[:env.config.numfig_secnum_depth] counter[secnum] = counter.get(secnum, 0) + 1 return secnum + (counter[secnum],) def register_fignumber(docname: str, secnum: Tuple[int, ...], figtype: str, fignode: Element) -> None: env.toc_fignumbers.setdefault(docname, {}) fignumbers = env.toc_fignumbers[docname].setdefault(figtype, {}) figure_id = fignode['ids'][0] fignumbers[figure_id] = get_next_fignumber(figtype, secnum) def _walk_doctree(docname: str, doctree: Element, secnum: Tuple[int, ...]) -> None: for subnode in doctree.children: if isinstance(subnode, nodes.section): next_secnum = get_section_number(docname, subnode) if next_secnum: _walk_doctree(docname, subnode, next_secnum) else: _walk_doctree(docname, subnode, secnum) elif isinstance(subnode, addnodes.toctree): for title, subdocname in subnode['entries']: if url_re.match(subdocname) or subdocname == 'self': # don't mess with those continue _walk_doc(subdocname, secnum) elif isinstance(subnode, nodes.Element): figtype = get_figtype(subnode) if figtype and subnode['ids']: register_fignumber(docname, secnum, figtype, subnode) _walk_doctree(docname, subnode, secnum) def _walk_doc(docname: str, secnum: Tuple[int, ...]) -> None: if docname not in assigned: assigned.add(docname) doctree = env.get_doctree(docname) _walk_doctree(docname, doctree, secnum) if env.config.numfig: _walk_doc(env.config.root_doc, tuple()) for docname, fignums in env.toc_fignumbers.items(): if fignums != old_fignumbers.get(docname): rewrite_needed.append(docname) return rewrite_needed def setup(app: Sphinx) -> Dict[str, Any]: app.add_env_collector(TocTreeCollector) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ����������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/errors.py�����������������������������������������������������������������������0000644�0000766�0000024�00000007004�00000000000�015533� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.errors ~~~~~~~~~~~~~ Contains SphinxError and a few subclasses (in an extra module to avoid circular import problems). :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Any class SphinxError(Exception): """Base class for Sphinx errors. This is the base class for "nice" exceptions. When such an exception is raised, Sphinx will abort the build and present the exception category and message to the user. Extensions are encouraged to derive from this exception for their custom errors. Exceptions *not* derived from :exc:`SphinxError` are treated as unexpected and shown to the user with a part of the traceback (and the full traceback saved in a temporary file). .. attribute:: category Description of the exception "category", used in converting the exception to a string ("category: message"). Should be set accordingly in subclasses. """ category = 'Sphinx error' class SphinxWarning(SphinxError): """Warning, treated as error.""" category = 'Warning, treated as error' class ApplicationError(SphinxError): """Application initialization error.""" category = 'Application error' class ExtensionError(SphinxError): """Extension error.""" def __init__(self, message: str, orig_exc: Exception = None, modname: str = None) -> None: super().__init__(message) self.message = message self.orig_exc = orig_exc self.modname = modname @property def category(self) -> str: # type: ignore if self.modname: return 'Extension error (%s)' % self.modname else: return 'Extension error' def __repr__(self) -> str: if self.orig_exc: return '%s(%r, %r)' % (self.__class__.__name__, self.message, self.orig_exc) return '%s(%r)' % (self.__class__.__name__, self.message) def __str__(self) -> str: parent_str = super().__str__() if self.orig_exc: return '%s (exception: %s)' % (parent_str, self.orig_exc) return parent_str class BuildEnvironmentError(SphinxError): """BuildEnvironment error.""" category = 'BuildEnvironment error' class ConfigError(SphinxError): """Configuration error.""" category = 'Configuration error' class DocumentError(SphinxError): """Document error.""" category = 'Document error' class ThemeError(SphinxError): """Theme error.""" category = 'Theme error' class VersionRequirementError(SphinxError): """Incompatible Sphinx version error.""" category = 'Sphinx version error' class SphinxParallelError(SphinxError): """Sphinx parallel build error.""" category = 'Sphinx parallel build error' def __init__(self, message: str, traceback: Any) -> None: self.message = message self.traceback = traceback def __str__(self) -> str: return self.message class PycodeError(Exception): """Pycode Python source code analyser error.""" def __str__(self) -> str: res = self.args[0] if len(self.args) > 1: res += ' (exception was: %r)' % self.args[1] return res class NoUri(Exception): """Raised by builder.get_relative_uri() or from missing-reference handlers if there is no URI available.""" pass class FiletypeNotFoundError(Exception): """Raised by get_filetype() if a filename matches no source suffix.""" pass ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/events.py�����������������������������������������������������������������������0000644�0000766�0000024�00000010223�00000000000�015520� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.events ~~~~~~~~~~~~~ Sphinx core events. Gracefully adapted from the TextPress system by Armin. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from collections import defaultdict from operator import attrgetter from typing import TYPE_CHECKING, Any, Callable, Dict, List, NamedTuple, Tuple, Type from sphinx.errors import ExtensionError, SphinxError from sphinx.locale import __ from sphinx.util import logging from sphinx.util.inspect import safe_getattr if TYPE_CHECKING: from sphinx.application import Sphinx logger = logging.getLogger(__name__) class EventListener(NamedTuple): id: int handler: Callable priority: int # List of all known core events. Maps name to arguments description. core_events = { 'builder-inited': '', 'config-inited': 'config', 'env-get-outdated': 'env, added, changed, removed', 'env-get-updated': 'env', 'env-purge-doc': 'env, docname', 'env-before-read-docs': 'env, docnames', 'env-check-consistency': 'env', 'source-read': 'docname, source text', 'doctree-read': 'the doctree before being pickled', 'env-merge-info': 'env, read docnames, other env instance', 'missing-reference': 'env, node, contnode', 'warn-missing-reference': 'domain, node', 'doctree-resolved': 'doctree, docname', 'env-updated': 'env', 'build-finished': 'exception', } class EventManager: """Event manager for Sphinx.""" def __init__(self, app: "Sphinx") -> None: self.app = app self.events = core_events.copy() self.listeners: Dict[str, List[EventListener]] = defaultdict(list) self.next_listener_id = 0 def add(self, name: str) -> None: """Register a custom Sphinx event.""" if name in self.events: raise ExtensionError(__('Event %r already present') % name) self.events[name] = '' def connect(self, name: str, callback: Callable, priority: int) -> int: """Connect a handler to specific event.""" if name not in self.events: raise ExtensionError(__('Unknown event name: %s') % name) listener_id = self.next_listener_id self.next_listener_id += 1 self.listeners[name].append(EventListener(listener_id, callback, priority)) return listener_id def disconnect(self, listener_id: int) -> None: """Disconnect a handler.""" for listeners in self.listeners.values(): for listener in listeners[:]: if listener.id == listener_id: listeners.remove(listener) def emit(self, name: str, *args: Any, allowed_exceptions: Tuple[Type[Exception], ...] = ()) -> List: """Emit a Sphinx event.""" try: logger.debug('[app] emitting event: %r%s', name, repr(args)[:100]) except Exception: # not every object likes to be repr()'d (think # random stuff coming via autodoc) pass results = [] listeners = sorted(self.listeners[name], key=attrgetter("priority")) for listener in listeners: try: results.append(listener.handler(self.app, *args)) except allowed_exceptions: # pass through the errors specified as *allowed_exceptions* raise except SphinxError: raise except Exception as exc: modname = safe_getattr(listener.handler, '__module__', None) raise ExtensionError(__("Handler %r for event %r threw an exception") % (listener.handler, name), exc, modname=modname) from exc return results def emit_firstresult(self, name: str, *args: Any, allowed_exceptions: Tuple[Type[Exception], ...] = ()) -> Any: """Emit a Sphinx event and returns first result. This returns the result of the first handler that doesn't return ``None``. """ for result in self.emit(name, *args, allowed_exceptions=allowed_exceptions): if result is not None: return result return None �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4616506 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/����������������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�014444� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/__init__.py�����������������������������������������������������������������0000644�0000766�0000024�00000000320�00000000000�016550� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext ~~~~~~~~~~ Contains Sphinx features not activated by default. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/apidoc.py�������������������������������������������������������������������0000644�0000766�0000024�00000045665�00000000000�016275� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.apidoc ~~~~~~~~~~~~~~~~~ Parses a directory tree looking for Python modules and packages and creates ReST files appropriately to create code documentation with Sphinx. It also creates a modules index (named modules.<suffix>). This is derived from the "sphinx-autopackage" script, which is: Copyright 2008 Société des arts technologiques (SAT), https://sat.qc.ca/ :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import argparse import glob import locale import os import sys from copy import copy from fnmatch import fnmatch from importlib.machinery import EXTENSION_SUFFIXES from os import path from typing import Any, Generator, List, Tuple import sphinx.locale from sphinx import __display_version__, package_dir from sphinx.cmd.quickstart import EXTENSIONS from sphinx.locale import __ from sphinx.util.osutil import FileAvoidWrite, ensuredir from sphinx.util.template import ReSTRenderer # automodule options if 'SPHINX_APIDOC_OPTIONS' in os.environ: OPTIONS = os.environ['SPHINX_APIDOC_OPTIONS'].split(',') else: OPTIONS = [ 'members', 'undoc-members', # 'inherited-members', # disabled because there's a bug in sphinx 'show-inheritance', ] PY_SUFFIXES = ('.py', '.pyx') + tuple(EXTENSION_SUFFIXES) template_dir = path.join(package_dir, 'templates', 'apidoc') def is_initpy(filename: str) -> bool: """Check *filename* is __init__ file or not.""" basename = path.basename(filename) for suffix in sorted(PY_SUFFIXES, key=len, reverse=True): if basename == '__init__' + suffix: return True else: return False def module_join(*modnames: str) -> str: """Join module names with dots.""" return '.'.join(filter(None, modnames)) def is_packagedir(dirname: str = None, files: List[str] = None) -> bool: """Check given *files* contains __init__ file.""" if files is None and dirname is None: return False if files is None: files = os.listdir(dirname) return any(f for f in files if is_initpy(f)) def write_file(name: str, text: str, opts: Any) -> None: """Write the output file for module/package <name>.""" quiet = getattr(opts, 'quiet', None) fname = path.join(opts.destdir, '%s.%s' % (name, opts.suffix)) if opts.dryrun: if not quiet: print(__('Would create file %s.') % fname) return if not opts.force and path.isfile(fname): if not quiet: print(__('File %s already exists, skipping.') % fname) else: if not quiet: print(__('Creating file %s.') % fname) with FileAvoidWrite(fname) as f: f.write(text) def create_module_file(package: str, basename: str, opts: Any, user_template_dir: str = None) -> None: """Build the text of the file and write the file.""" options = copy(OPTIONS) if opts.includeprivate and 'private-members' not in options: options.append('private-members') qualname = module_join(package, basename) context = { 'show_headings': not opts.noheadings, 'basename': basename, 'qualname': qualname, 'automodule_options': options, } text = ReSTRenderer([user_template_dir, template_dir]).render('module.rst_t', context) write_file(qualname, text, opts) def create_package_file(root: str, master_package: str, subroot: str, py_files: List[str], opts: Any, subs: List[str], is_namespace: bool, excludes: List[str] = [], user_template_dir: str = None) -> None: """Build the text of the file and write the file.""" # build a list of sub packages (directories containing an __init__ file) subpackages = [module_join(master_package, subroot, pkgname) for pkgname in subs if not is_skipped_package(path.join(root, pkgname), opts, excludes)] # build a list of sub modules submodules = [sub.split('.')[0] for sub in py_files if not is_skipped_module(path.join(root, sub), opts, excludes) and not is_initpy(sub)] submodules = [module_join(master_package, subroot, modname) for modname in submodules] options = copy(OPTIONS) if opts.includeprivate and 'private-members' not in options: options.append('private-members') pkgname = module_join(master_package, subroot) context = { 'pkgname': pkgname, 'subpackages': subpackages, 'submodules': submodules, 'is_namespace': is_namespace, 'modulefirst': opts.modulefirst, 'separatemodules': opts.separatemodules, 'automodule_options': options, 'show_headings': not opts.noheadings, 'maxdepth': opts.maxdepth, } text = ReSTRenderer([user_template_dir, template_dir]).render('package.rst_t', context) write_file(pkgname, text, opts) if submodules and opts.separatemodules: for submodule in submodules: create_module_file(None, submodule, opts, user_template_dir) def create_modules_toc_file(modules: List[str], opts: Any, name: str = 'modules', user_template_dir: str = None) -> None: """Create the module's index.""" modules.sort() prev_module = '' for module in modules[:]: # look if the module is a subpackage and, if yes, ignore it if module.startswith(prev_module + '.'): modules.remove(module) else: prev_module = module context = { 'header': opts.header, 'maxdepth': opts.maxdepth, 'docnames': modules, } text = ReSTRenderer([user_template_dir, template_dir]).render('toc.rst_t', context) write_file(name, text, opts) def is_skipped_package(dirname: str, opts: Any, excludes: List[str] = []) -> bool: """Check if we want to skip this module.""" if not path.isdir(dirname): return False files = glob.glob(path.join(dirname, '*.py')) regular_package = any(f for f in files if is_initpy(f)) if not regular_package and not opts.implicit_namespaces: # *dirname* is not both a regular package and an implicit namespace pacage return True # Check there is some showable module inside package if all(is_excluded(path.join(dirname, f), excludes) for f in files): # all submodules are excluded return True else: return False def is_skipped_module(filename: str, opts: Any, excludes: List[str]) -> bool: """Check if we want to skip this module.""" if not path.exists(filename): # skip if the file doesn't exist return True elif path.basename(filename).startswith('_') and not opts.includeprivate: # skip if the module has a "private" name return True else: return False def walk(rootpath: str, excludes: List[str], opts: Any ) -> Generator[Tuple[str, List[str], List[str]], None, None]: """Walk through the directory and list files and subdirectories up.""" followlinks = getattr(opts, 'followlinks', False) includeprivate = getattr(opts, 'includeprivate', False) for root, subs, files in os.walk(rootpath, followlinks=followlinks): # document only Python module files (that aren't excluded) files = sorted(f for f in files if f.endswith(PY_SUFFIXES) and not is_excluded(path.join(root, f), excludes)) # remove hidden ('.') and private ('_') directories, as well as # excluded dirs if includeprivate: exclude_prefixes: Tuple[str, ...] = ('.',) else: exclude_prefixes = ('.', '_') subs[:] = sorted(sub for sub in subs if not sub.startswith(exclude_prefixes) and not is_excluded(path.join(root, sub), excludes)) yield root, subs, files def has_child_module(rootpath: str, excludes: List[str], opts: Any) -> bool: """Check the given directory contains child module/s (at least one).""" for root, subs, files in walk(rootpath, excludes, opts): if files: return True return False def recurse_tree(rootpath: str, excludes: List[str], opts: Any, user_template_dir: str = None) -> List[str]: """ Look for every file in the directory tree and create the corresponding ReST files. """ implicit_namespaces = getattr(opts, 'implicit_namespaces', False) # check if the base directory is a package and get its name if is_packagedir(rootpath) or implicit_namespaces: root_package = rootpath.split(path.sep)[-1] else: # otherwise, the base is a directory with packages root_package = None toplevels = [] for root, subs, files in walk(rootpath, excludes, opts): is_pkg = is_packagedir(None, files) is_namespace = not is_pkg and implicit_namespaces if is_pkg: for f in files[:]: if is_initpy(f): files.remove(f) files.insert(0, f) elif root != rootpath: # only accept non-package at toplevel unless using implicit namespaces if not implicit_namespaces: del subs[:] continue if is_pkg or is_namespace: # we are in a package with something to document if subs or len(files) > 1 or not is_skipped_package(root, opts): subpackage = root[len(rootpath):].lstrip(path.sep).\ replace(path.sep, '.') # if this is not a namespace or # a namespace and there is something there to document if not is_namespace or has_child_module(root, excludes, opts): create_package_file(root, root_package, subpackage, files, opts, subs, is_namespace, excludes, user_template_dir) toplevels.append(module_join(root_package, subpackage)) else: # if we are at the root level, we don't require it to be a package assert root == rootpath and root_package is None for py_file in files: if not is_skipped_module(path.join(rootpath, py_file), opts, excludes): module = py_file.split('.')[0] create_module_file(root_package, module, opts, user_template_dir) toplevels.append(module) return toplevels def is_excluded(root: str, excludes: List[str]) -> bool: """Check if the directory is in the exclude list. Note: by having trailing slashes, we avoid common prefix issues, like e.g. an exclude "foo" also accidentally excluding "foobar". """ for exclude in excludes: if fnmatch(root, exclude): return True return False def get_parser() -> argparse.ArgumentParser: parser = argparse.ArgumentParser( usage='%(prog)s [OPTIONS] -o <OUTPUT_PATH> <MODULE_PATH> ' '[EXCLUDE_PATTERN, ...]', epilog=__('For more information, visit <https://www.sphinx-doc.org/>.'), description=__(""" Look recursively in <MODULE_PATH> for Python modules and packages and create one reST file with automodule directives per package in the <OUTPUT_PATH>. The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be excluded from generation. Note: By default this script will not overwrite already created files.""")) parser.add_argument('--version', action='version', dest='show_version', version='%%(prog)s %s' % __display_version__) parser.add_argument('module_path', help=__('path to module to document')) parser.add_argument('exclude_pattern', nargs='*', help=__('fnmatch-style file and/or directory patterns ' 'to exclude from generation')) parser.add_argument('-o', '--output-dir', action='store', dest='destdir', required=True, help=__('directory to place all output')) parser.add_argument('-q', action='store_true', dest='quiet', help=__('no output on stdout, just warnings on stderr')) parser.add_argument('-d', '--maxdepth', action='store', dest='maxdepth', type=int, default=4, help=__('maximum depth of submodules to show in the TOC ' '(default: 4)')) parser.add_argument('-f', '--force', action='store_true', dest='force', help=__('overwrite existing files')) parser.add_argument('-l', '--follow-links', action='store_true', dest='followlinks', default=False, help=__('follow symbolic links. Powerful when combined ' 'with collective.recipe.omelette.')) parser.add_argument('-n', '--dry-run', action='store_true', dest='dryrun', help=__('run the script without creating files')) parser.add_argument('-e', '--separate', action='store_true', dest='separatemodules', help=__('put documentation for each module on its own page')) parser.add_argument('-P', '--private', action='store_true', dest='includeprivate', help=__('include "_private" modules')) parser.add_argument('--tocfile', action='store', dest='tocfile', default='modules', help=__("filename of table of contents (default: modules)")) parser.add_argument('-T', '--no-toc', action='store_false', dest='tocfile', help=__("don't create a table of contents file")) parser.add_argument('-E', '--no-headings', action='store_true', dest='noheadings', help=__("don't create headings for the module/package " "packages (e.g. when the docstrings already " "contain them)")) parser.add_argument('-M', '--module-first', action='store_true', dest='modulefirst', help=__('put module documentation before submodule ' 'documentation')) parser.add_argument('--implicit-namespaces', action='store_true', dest='implicit_namespaces', help=__('interpret module paths according to PEP-0420 ' 'implicit namespaces specification')) parser.add_argument('-s', '--suffix', action='store', dest='suffix', default='rst', help=__('file suffix (default: rst)')) parser.add_argument('-F', '--full', action='store_true', dest='full', help=__('generate a full project with sphinx-quickstart')) parser.add_argument('-a', '--append-syspath', action='store_true', dest='append_syspath', help=__('append module_path to sys.path, used when --full is given')) parser.add_argument('-H', '--doc-project', action='store', dest='header', help=__('project name (default: root module name)')) parser.add_argument('-A', '--doc-author', action='store', dest='author', help=__('project author(s), used when --full is given')) parser.add_argument('-V', '--doc-version', action='store', dest='version', help=__('project version, used when --full is given')) parser.add_argument('-R', '--doc-release', action='store', dest='release', help=__('project release, used when --full is given, ' 'defaults to --doc-version')) group = parser.add_argument_group(__('extension options')) group.add_argument('--extensions', metavar='EXTENSIONS', dest='extensions', action='append', help=__('enable arbitrary extensions')) for ext in EXTENSIONS: group.add_argument('--ext-%s' % ext, action='append_const', const='sphinx.ext.%s' % ext, dest='extensions', help=__('enable %s extension') % ext) group = parser.add_argument_group(__('Project templating')) group.add_argument('-t', '--templatedir', metavar='TEMPLATEDIR', dest='templatedir', help=__('template directory for template files')) return parser def main(argv: List[str] = sys.argv[1:]) -> int: """Parse and check the command line arguments.""" sphinx.locale.setlocale(locale.LC_ALL, '') sphinx.locale.init_console(os.path.join(package_dir, 'locale'), 'sphinx') parser = get_parser() args = parser.parse_args(argv) rootpath = path.abspath(args.module_path) # normalize opts if args.header is None: args.header = rootpath.split(path.sep)[-1] if args.suffix.startswith('.'): args.suffix = args.suffix[1:] if not path.isdir(rootpath): print(__('%s is not a directory.') % rootpath, file=sys.stderr) sys.exit(1) if not args.dryrun: ensuredir(args.destdir) excludes = [path.abspath(exclude) for exclude in args.exclude_pattern] modules = recurse_tree(rootpath, excludes, args, args.templatedir) if args.full: from sphinx.cmd import quickstart as qs modules.sort() prev_module = '' text = '' for module in modules: if module.startswith(prev_module + '.'): continue prev_module = module text += ' %s\n' % module d = { 'path': args.destdir, 'sep': False, 'dot': '_', 'project': args.header, 'author': args.author or 'Author', 'version': args.version or '', 'release': args.release or args.version or '', 'suffix': '.' + args.suffix, 'master': 'index', 'epub': True, 'extensions': ['sphinx.ext.autodoc', 'sphinx.ext.viewcode', 'sphinx.ext.todo'], 'makefile': True, 'batchfile': True, 'make_mode': True, 'mastertocmaxdepth': args.maxdepth, 'mastertoctree': text, 'language': 'en', 'module_path': rootpath, 'append_syspath': args.append_syspath, } if args.extensions: d['extensions'].extend(args.extensions) if args.quiet: d['quiet'] = True for ext in d['extensions'][:]: if ',' in ext: d['extensions'].remove(ext) d['extensions'].extend(ext.split(',')) if not args.dryrun: qs.generate(d, silent=True, overwrite=args.force, templatedir=args.templatedir) elif args.tocfile: create_modules_toc_file(modules, args, args.tocfile, args.templatedir) return 0 # So program can be started with "python -m sphinx.apidoc ..." if __name__ == "__main__": main() ���������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4634998 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autodoc/��������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016102� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autodoc/__init__.py���������������������������������������������������������0000644�0000766�0000024�00000341734�00000000000�020227� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.autodoc ~~~~~~~~~~~~~~~~~~ Automatically insert docstrings for functions, classes or whole modules into the doctree, thus avoiding duplication between docstrings and documentation for those who like elaborate docstrings. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import re import warnings from inspect import Parameter, Signature from types import ModuleType from typing import (TYPE_CHECKING, Any, Callable, Dict, Iterator, List, Optional, Sequence, Set, Tuple, Type, TypeVar, Union) from docutils.statemachine import StringList import sphinx from sphinx.application import Sphinx from sphinx.config import ENUM, Config from sphinx.deprecation import RemovedInSphinx50Warning, RemovedInSphinx60Warning from sphinx.environment import BuildEnvironment from sphinx.ext.autodoc.importer import (get_class_members, get_object_members, import_module, import_object) from sphinx.ext.autodoc.mock import ismock, mock, undecorate from sphinx.locale import _, __ from sphinx.pycode import ModuleAnalyzer, PycodeError from sphinx.util import inspect, logging from sphinx.util.docstrings import prepare_docstring, separate_metadata from sphinx.util.inspect import (evaluate_signature, getdoc, object_description, safe_getattr, stringify_signature) from sphinx.util.typing import OptionSpec, get_type_hints, restify from sphinx.util.typing import stringify as stringify_typehint if TYPE_CHECKING: from sphinx.ext.autodoc.directive import DocumenterBridge logger = logging.getLogger(__name__) # This type isn't exposed directly in any modules, but can be found # here in most Python versions MethodDescriptorType = type(type.__subclasses__) #: extended signature RE: with explicit module name separated by :: py_ext_sig_re = re.compile( r'''^ ([\w.]+::)? # explicit module name ([\w.]+\.)? # module and/or class name(s) (\w+) \s* # thing name (?: \((.*)\) # optional: arguments (?:\s* -> \s* (.*))? # return annotation )? $ # and nothing more ''', re.VERBOSE) special_member_re = re.compile(r'^__\S+__$') def identity(x: Any) -> Any: return x class _All: """A special value for :*-members: that matches to any member.""" def __contains__(self, item: Any) -> bool: return True def append(self, item: Any) -> None: pass # nothing class _Empty: """A special value for :exclude-members: that never matches to any member.""" def __contains__(self, item: Any) -> bool: return False ALL = _All() EMPTY = _Empty() UNINITIALIZED_ATTR = object() INSTANCEATTR = object() SLOTSATTR = object() def members_option(arg: Any) -> Union[object, List[str]]: """Used to convert the :members: option to auto directives.""" if arg in (None, True): return ALL elif arg is False: return None else: return [x.strip() for x in arg.split(',') if x.strip()] def members_set_option(arg: Any) -> Union[object, Set[str]]: """Used to convert the :members: option to auto directives.""" warnings.warn("members_set_option() is deprecated.", RemovedInSphinx50Warning, stacklevel=2) if arg is None: return ALL return {x.strip() for x in arg.split(',') if x.strip()} def exclude_members_option(arg: Any) -> Union[object, Set[str]]: """Used to convert the :exclude-members: option.""" if arg in (None, True): return EMPTY return {x.strip() for x in arg.split(',') if x.strip()} def inherited_members_option(arg: Any) -> Union[object, Set[str]]: """Used to convert the :members: option to auto directives.""" if arg in (None, True): return 'object' else: return arg def member_order_option(arg: Any) -> Optional[str]: """Used to convert the :members: option to auto directives.""" if arg in (None, True): return None elif arg in ('alphabetical', 'bysource', 'groupwise'): return arg else: raise ValueError(__('invalid value for member-order option: %s') % arg) def class_doc_from_option(arg: Any) -> Optional[str]: """Used to convert the :class-doc-from: option to autoclass directives.""" if arg in ('both', 'class', 'init'): return arg else: raise ValueError(__('invalid value for class-doc-from option: %s') % arg) SUPPRESS = object() def annotation_option(arg: Any) -> Any: if arg in (None, True): # suppress showing the representation of the object return SUPPRESS else: return arg def bool_option(arg: Any) -> bool: """Used to convert flag options to auto directives. (Instead of directives.flag(), which returns None). """ return True def merge_special_members_option(options: Dict) -> None: """Merge :special-members: option to :members: option.""" warnings.warn("merge_special_members_option() is deprecated.", RemovedInSphinx50Warning, stacklevel=2) if 'special-members' in options and options['special-members'] is not ALL: if options.get('members') is ALL: pass elif options.get('members'): for member in options['special-members']: if member not in options['members']: options['members'].append(member) else: options['members'] = options['special-members'] def merge_members_option(options: Dict) -> None: """Merge :*-members: option to the :members: option.""" if options.get('members') is ALL: # merging is not needed when members: ALL return members = options.setdefault('members', []) for key in {'private-members', 'special-members'}: if key in options and options[key] not in (ALL, None): for member in options[key]: if member not in members: members.append(member) # Some useful event listener factories for autodoc-process-docstring. def cut_lines(pre: int, post: int = 0, what: str = None) -> Callable: """Return a listener that removes the first *pre* and last *post* lines of every docstring. If *what* is a sequence of strings, only docstrings of a type in *what* will be processed. Use like this (e.g. in the ``setup()`` function of :file:`conf.py`):: from sphinx.ext.autodoc import cut_lines app.connect('autodoc-process-docstring', cut_lines(4, what=['module'])) This can (and should) be used in place of :confval:`automodule_skip_lines`. """ def process(app: Sphinx, what_: str, name: str, obj: Any, options: Any, lines: List[str] ) -> None: if what and what_ not in what: return del lines[:pre] if post: # remove one trailing blank line. if lines and not lines[-1]: lines.pop(-1) del lines[-post:] # make sure there is a blank line at the end if lines and lines[-1]: lines.append('') return process def between(marker: str, what: Sequence[str] = None, keepempty: bool = False, exclude: bool = False) -> Callable: """Return a listener that either keeps, or if *exclude* is True excludes, lines between lines that match the *marker* regular expression. If no line matches, the resulting docstring would be empty, so no change will be made unless *keepempty* is true. If *what* is a sequence of strings, only docstrings of a type in *what* will be processed. """ marker_re = re.compile(marker) def process(app: Sphinx, what_: str, name: str, obj: Any, options: Any, lines: List[str] ) -> None: if what and what_ not in what: return deleted = 0 delete = not exclude orig_lines = lines[:] for i, line in enumerate(orig_lines): if delete: lines.pop(i - deleted) deleted += 1 if marker_re.match(line): delete = not delete if delete: lines.pop(i - deleted) deleted += 1 if not lines and not keepempty: lines[:] = orig_lines # make sure there is a blank line at the end if lines and lines[-1]: lines.append('') return process # This class is used only in ``sphinx.ext.autodoc.directive``, # But we define this class here to keep compatibility (see #4538) class Options(dict): """A dict/attribute hybrid that returns None on nonexisting keys.""" def copy(self) -> "Options": return Options(super().copy()) def __getattr__(self, name: str) -> Any: try: return self[name.replace('_', '-')] except KeyError: return None class ObjectMember(tuple): """A member of object. This is used for the result of `Documenter.get_object_members()` to represent each member of the object. .. Note:: An instance of this class behaves as a tuple of (name, object) for compatibility to old Sphinx. The behavior will be dropped in the future. Therefore extensions should not use the tuple interface. """ def __new__(cls, name: str, obj: Any, **kwargs: Any) -> Any: return super().__new__(cls, (name, obj)) # type: ignore def __init__(self, name: str, obj: Any, docstring: Optional[str] = None, class_: Any = None, skipped: bool = False) -> None: self.__name__ = name self.object = obj self.docstring = docstring self.skipped = skipped self.class_ = class_ ObjectMembers = Union[List[ObjectMember], List[Tuple[str, Any]]] class Documenter: """ A Documenter knows how to autodocument a single object type. When registered with the AutoDirective, it will be used to document objects of that type when needed by autodoc. Its *objtype* attribute selects what auto directive it is assigned to (the directive name is 'auto' + objtype), and what directive it generates by default, though that can be overridden by an attribute called *directivetype*. A Documenter has an *option_spec* that works like a docutils directive's; in fact, it will be used to parse an auto directive's options that matches the Documenter. """ #: name by which the directive is called (auto...) and the default #: generated directive name objtype = 'object' #: indentation by which to indent the directive content content_indent = ' ' #: priority if multiple documenters return True from can_document_member priority = 0 #: order if autodoc_member_order is set to 'groupwise' member_order = 0 #: true if the generated content may contain titles titles_allowed = False option_spec: OptionSpec = { 'noindex': bool_option } def get_attr(self, obj: Any, name: str, *defargs: Any) -> Any: """getattr() override for types such as Zope interfaces.""" return autodoc_attrgetter(self.env.app, obj, name, *defargs) @classmethod def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any ) -> bool: """Called to see if a member can be documented by this Documenter.""" raise NotImplementedError('must be implemented in subclasses') def __init__(self, directive: "DocumenterBridge", name: str, indent: str = '') -> None: self.directive = directive self.config: Config = directive.env.config self.env: BuildEnvironment = directive.env self.options = directive.genopt self.name = name self.indent = indent # the module and object path within the module, and the fully # qualified name (all set after resolve_name succeeds) self.modname: str = None self.module: ModuleType = None self.objpath: List[str] = None self.fullname: str = None # extra signature items (arguments and return annotation, # also set after resolve_name succeeds) self.args: str = None self.retann: str = None # the object to document (set after import_object succeeds) self.object: Any = None self.object_name: str = None # the parent/owner of the object to document self.parent: Any = None # the module analyzer to get at attribute docs, or None self.analyzer: ModuleAnalyzer = None @property def documenters(self) -> Dict[str, Type["Documenter"]]: """Returns registered Documenter classes""" return self.env.app.registry.documenters def add_line(self, line: str, source: str, *lineno: int) -> None: """Append one line of generated reST to the output.""" if line.strip(): # not a blank line self.directive.result.append(self.indent + line, source, *lineno) else: self.directive.result.append('', source, *lineno) def resolve_name(self, modname: str, parents: Any, path: str, base: Any ) -> Tuple[str, List[str]]: """Resolve the module and name of the object to document given by the arguments and the current module/class. Must return a pair of the module name and a chain of attributes; for example, it would return ``('zipfile', ['ZipFile', 'open'])`` for the ``zipfile.ZipFile.open`` method. """ raise NotImplementedError('must be implemented in subclasses') def parse_name(self) -> bool: """Determine what module to import and what attribute to document. Returns True and sets *self.modname*, *self.objpath*, *self.fullname*, *self.args* and *self.retann* if parsing and resolving was successful. """ # first, parse the definition -- auto directives for classes and # functions can contain a signature which is then used instead of # an autogenerated one try: matched = py_ext_sig_re.match(self.name) explicit_modname, path, base, args, retann = matched.groups() except AttributeError: logger.warning(__('invalid signature for auto%s (%r)') % (self.objtype, self.name), type='autodoc') return False # support explicit module and class name separation via :: if explicit_modname is not None: modname = explicit_modname[:-2] parents = path.rstrip('.').split('.') if path else [] else: modname = None parents = [] with mock(self.config.autodoc_mock_imports): self.modname, self.objpath = self.resolve_name(modname, parents, path, base) if not self.modname: return False self.args = args self.retann = retann self.fullname = ((self.modname or '') + ('.' + '.'.join(self.objpath) if self.objpath else '')) return True def import_object(self, raiseerror: bool = False) -> bool: """Import the object given by *self.modname* and *self.objpath* and set it as *self.object*. Returns True if successful, False if an error occurred. """ with mock(self.config.autodoc_mock_imports): try: ret = import_object(self.modname, self.objpath, self.objtype, attrgetter=self.get_attr, warningiserror=self.config.autodoc_warningiserror) self.module, self.parent, self.object_name, self.object = ret if ismock(self.object): self.object = undecorate(self.object) return True except ImportError as exc: if raiseerror: raise else: logger.warning(exc.args[0], type='autodoc', subtype='import_object') self.env.note_reread() return False def get_real_modname(self) -> str: """Get the real module name of an object to document. It can differ from the name of the module through which the object was imported. """ return self.get_attr(self.object, '__module__', None) or self.modname def check_module(self) -> bool: """Check if *self.object* is really defined in the module given by *self.modname*. """ if self.options.imported_members: return True subject = inspect.unpartial(self.object) modname = self.get_attr(subject, '__module__', None) if modname and modname != self.modname: return False return True def format_args(self, **kwargs: Any) -> str: """Format the argument signature of *self.object*. Should return None if the object does not have a signature. """ return None def format_name(self) -> str: """Format the name of *self.object*. This normally should be something that can be parsed by the generated directive, but doesn't need to be (Sphinx will display it unparsed then). """ # normally the name doesn't contain the module (except for module # directives of course) return '.'.join(self.objpath) or self.modname def _call_format_args(self, **kwargs: Any) -> str: if kwargs: try: return self.format_args(**kwargs) except TypeError: # avoid chaining exceptions, by putting nothing here pass # retry without arguments for old documenters return self.format_args() def format_signature(self, **kwargs: Any) -> str: """Format the signature (arguments and return annotation) of the object. Let the user process it via the ``autodoc-process-signature`` event. """ if self.args is not None: # signature given explicitly args = "(%s)" % self.args retann = self.retann else: # try to introspect the signature try: retann = None args = self._call_format_args(**kwargs) if args: matched = re.match(r'^(\(.*\))\s+->\s+(.*)$', args) if matched: args = matched.group(1) retann = matched.group(2) except Exception as exc: logger.warning(__('error while formatting arguments for %s: %s'), self.fullname, exc, type='autodoc') args = None result = self.env.events.emit_firstresult('autodoc-process-signature', self.objtype, self.fullname, self.object, self.options, args, retann) if result: args, retann = result if args is not None: return args + ((' -> %s' % retann) if retann else '') else: return '' def add_directive_header(self, sig: str) -> None: """Add the directive header and options to the generated content.""" domain = getattr(self, 'domain', 'py') directive = getattr(self, 'directivetype', self.objtype) name = self.format_name() sourcename = self.get_sourcename() # one signature per line, indented by column prefix = '.. %s:%s:: ' % (domain, directive) for i, sig_line in enumerate(sig.split("\n")): self.add_line('%s%s%s' % (prefix, name, sig_line), sourcename) if i == 0: prefix = " " * len(prefix) if self.options.noindex: self.add_line(' :noindex:', sourcename) if self.objpath: # Be explicit about the module, this is necessary since .. class:: # etc. don't support a prepended module name self.add_line(' :module: %s' % self.modname, sourcename) def get_doc(self, ignore: int = None) -> Optional[List[List[str]]]: """Decode and return lines of the docstring(s) for the object. When it returns None, autodoc-process-docstring will not be called for this object. """ if ignore is not None: warnings.warn("The 'ignore' argument to autodoc.%s.get_doc() is deprecated." % self.__class__.__name__, RemovedInSphinx50Warning, stacklevel=2) docstring = getdoc(self.object, self.get_attr, self.config.autodoc_inherit_docstrings, self.parent, self.object_name) if docstring: tab_width = self.directive.state.document.settings.tab_width return [prepare_docstring(docstring, ignore, tab_width)] return [] def process_doc(self, docstrings: List[List[str]]) -> Iterator[str]: """Let the user process the docstrings before adding them.""" for docstringlines in docstrings: if self.env.app: # let extensions preprocess docstrings self.env.app.emit('autodoc-process-docstring', self.objtype, self.fullname, self.object, self.options, docstringlines) if docstringlines and docstringlines[-1] != '': # append a blank line to the end of the docstring docstringlines.append('') yield from docstringlines def get_sourcename(self) -> str: if (inspect.safe_getattr(self.object, '__module__', None) and inspect.safe_getattr(self.object, '__qualname__', None)): # Get the correct location of docstring from self.object # to support inherited methods fullname = '%s.%s' % (self.object.__module__, self.object.__qualname__) else: fullname = self.fullname if self.analyzer: return '%s:docstring of %s' % (self.analyzer.srcname, fullname) else: return 'docstring of %s' % fullname def add_content(self, more_content: Optional[StringList], no_docstring: bool = False ) -> None: """Add content from docstrings, attribute documentation and user.""" if no_docstring: warnings.warn("The 'no_docstring' argument to %s.add_content() is deprecated." % self.__class__.__name__, RemovedInSphinx50Warning, stacklevel=2) # set sourcename and add content from attribute documentation sourcename = self.get_sourcename() if self.analyzer: attr_docs = self.analyzer.find_attr_docs() if self.objpath: key = ('.'.join(self.objpath[:-1]), self.objpath[-1]) if key in attr_docs: no_docstring = True # make a copy of docstring for attributes to avoid cache # the change of autodoc-process-docstring event. docstrings = [list(attr_docs[key])] for i, line in enumerate(self.process_doc(docstrings)): self.add_line(line, sourcename, i) # add content from docstrings if not no_docstring: docstrings = self.get_doc() if docstrings is None: # Do not call autodoc-process-docstring on get_doc() returns None. pass else: if not docstrings: # append at least a dummy docstring, so that the event # autodoc-process-docstring is fired and can add some # content if desired docstrings.append([]) for i, line in enumerate(self.process_doc(docstrings)): self.add_line(line, sourcename, i) # add additional content (e.g. from document), if present if more_content: for line, src in zip(more_content.data, more_content.items): self.add_line(line, src[0], src[1]) def get_object_members(self, want_all: bool) -> Tuple[bool, ObjectMembers]: """Return `(members_check_module, members)` where `members` is a list of `(membername, member)` pairs of the members of *self.object*. If *want_all* is True, return all members. Else, only return those members given by *self.options.members* (which may also be None). """ warnings.warn('The implementation of Documenter.get_object_members() will be ' 'removed from Sphinx-6.0.', RemovedInSphinx60Warning) members = get_object_members(self.object, self.objpath, self.get_attr, self.analyzer) if not want_all: if not self.options.members: return False, [] # type: ignore # specific members given selected = [] for name in self.options.members: # type: str if name in members: selected.append((name, members[name].value)) else: logger.warning(__('missing attribute %s in object %s') % (name, self.fullname), type='autodoc') return False, selected elif self.options.inherited_members: return False, [(m.name, m.value) for m in members.values()] else: return False, [(m.name, m.value) for m in members.values() if m.directly_defined] def filter_members(self, members: ObjectMembers, want_all: bool ) -> List[Tuple[str, Any, bool]]: """Filter the given member list. Members are skipped if - they are private (except if given explicitly or the private-members option is set) - they are special methods (except if given explicitly or the special-members option is set) - they are undocumented (except if the undoc-members option is set) The user can override the skipping decision by connecting to the ``autodoc-skip-member`` event. """ def is_filtered_inherited_member(name: str, obj: Any) -> bool: if inspect.isclass(self.object): for cls in self.object.__mro__: if cls.__name__ == self.options.inherited_members and cls != self.object: # given member is a member of specified *super class* return True elif name in cls.__dict__: return False elif name in self.get_attr(cls, '__annotations__', {}): return False elif isinstance(obj, ObjectMember) and obj.class_ is cls: return False return False ret = [] # search for members in source code too namespace = '.'.join(self.objpath) # will be empty for modules if self.analyzer: attr_docs = self.analyzer.find_attr_docs() else: attr_docs = {} # process members and determine which to skip for obj in members: membername, member = obj # if isattr is True, the member is documented as an attribute if member is INSTANCEATTR: isattr = True elif (namespace, membername) in attr_docs: isattr = True else: isattr = False doc = getdoc(member, self.get_attr, self.config.autodoc_inherit_docstrings, self.object, membername) if not isinstance(doc, str): # Ignore non-string __doc__ doc = None # if the member __doc__ is the same as self's __doc__, it's just # inherited and therefore not the member's doc cls = self.get_attr(member, '__class__', None) if cls: cls_doc = self.get_attr(cls, '__doc__', None) if cls_doc == doc: doc = None if isinstance(obj, ObjectMember) and obj.docstring: # hack for ClassDocumenter to inject docstring via ObjectMember doc = obj.docstring doc, metadata = separate_metadata(doc) has_doc = bool(doc) if 'private' in metadata: # consider a member private if docstring has "private" metadata isprivate = True elif 'public' in metadata: # consider a member public if docstring has "public" metadata isprivate = False else: isprivate = membername.startswith('_') keep = False if ismock(member): # mocked module or object pass elif self.options.exclude_members and membername in self.options.exclude_members: # remove members given by exclude-members keep = False elif want_all and special_member_re.match(membername): # special __methods__ if self.options.special_members and membername in self.options.special_members: if membername == '__doc__': keep = False elif is_filtered_inherited_member(membername, obj): keep = False else: keep = has_doc or self.options.undoc_members else: keep = False elif (namespace, membername) in attr_docs: if want_all and isprivate: if self.options.private_members is None: keep = False else: keep = membername in self.options.private_members else: # keep documented attributes keep = True elif want_all and isprivate: if has_doc or self.options.undoc_members: if self.options.private_members is None: keep = False elif is_filtered_inherited_member(membername, obj): keep = False else: keep = membername in self.options.private_members else: keep = False else: if (self.options.members is ALL and is_filtered_inherited_member(membername, obj)): keep = False else: # ignore undocumented members if :undoc-members: is not given keep = has_doc or self.options.undoc_members if isinstance(obj, ObjectMember) and obj.skipped: # forcedly skipped member (ex. a module attribute not defined in __all__) keep = False # give the user a chance to decide whether this member # should be skipped if self.env.app: # let extensions preprocess docstrings try: skip_user = self.env.app.emit_firstresult( 'autodoc-skip-member', self.objtype, membername, member, not keep, self.options) if skip_user is not None: keep = not skip_user except Exception as exc: logger.warning(__('autodoc: failed to determine %r to be documented, ' 'the following exception was raised:\n%s'), member, exc, type='autodoc') keep = False if keep: ret.append((membername, member, isattr)) return ret def document_members(self, all_members: bool = False) -> None: """Generate reST for member documentation. If *all_members* is True, document all members, else those given by *self.options.members*. """ # set current namespace for finding members self.env.temp_data['autodoc:module'] = self.modname if self.objpath: self.env.temp_data['autodoc:class'] = self.objpath[0] want_all = (all_members or self.options.inherited_members or self.options.members is ALL) # find out which members are documentable members_check_module, members = self.get_object_members(want_all) # document non-skipped members memberdocumenters: List[Tuple[Documenter, bool]] = [] for (mname, member, isattr) in self.filter_members(members, want_all): classes = [cls for cls in self.documenters.values() if cls.can_document_member(member, mname, isattr, self)] if not classes: # don't know how to document this member continue # prefer the documenter with the highest priority classes.sort(key=lambda cls: cls.priority) # give explicitly separated module name, so that members # of inner classes can be documented full_mname = self.modname + '::' + '.'.join(self.objpath + [mname]) documenter = classes[-1](self.directive, full_mname, self.indent) memberdocumenters.append((documenter, isattr)) member_order = self.options.member_order or self.config.autodoc_member_order memberdocumenters = self.sort_members(memberdocumenters, member_order) for documenter, isattr in memberdocumenters: documenter.generate( all_members=True, real_modname=self.real_modname, check_module=members_check_module and not isattr) # reset current objects self.env.temp_data['autodoc:module'] = None self.env.temp_data['autodoc:class'] = None def sort_members(self, documenters: List[Tuple["Documenter", bool]], order: str) -> List[Tuple["Documenter", bool]]: """Sort the given member list.""" if order == 'groupwise': # sort by group; alphabetically within groups documenters.sort(key=lambda e: (e[0].member_order, e[0].name)) elif order == 'bysource': if self.analyzer: # sort by source order, by virtue of the module analyzer tagorder = self.analyzer.tagorder def keyfunc(entry: Tuple[Documenter, bool]) -> int: fullname = entry[0].name.split('::')[1] return tagorder.get(fullname, len(tagorder)) documenters.sort(key=keyfunc) else: # Assume that member discovery order matches source order. # This is a reasonable assumption in Python 3.6 and up, where # module.__dict__ is insertion-ordered. pass else: # alphabetical documenters.sort(key=lambda e: e[0].name) return documenters def generate(self, more_content: Optional[StringList] = None, real_modname: str = None, check_module: bool = False, all_members: bool = False) -> None: """Generate reST for the object given by *self.name*, and possibly for its members. If *more_content* is given, include that content. If *real_modname* is given, use that module name to find attribute docs. If *check_module* is True, only generate if the object is defined in the module name it is imported from. If *all_members* is True, document all members. """ if not self.parse_name(): # need a module to import logger.warning( __('don\'t know which module to import for autodocumenting ' '%r (try placing a "module" or "currentmodule" directive ' 'in the document, or giving an explicit module name)') % self.name, type='autodoc') return # now, import the module and get object to document if not self.import_object(): return # If there is no real module defined, figure out which to use. # The real module is used in the module analyzer to look up the module # where the attribute documentation would actually be found in. # This is used for situations where you have a module that collects the # functions and classes of internal submodules. guess_modname = self.get_real_modname() self.real_modname: str = real_modname or guess_modname # try to also get a source code analyzer for attribute docs try: self.analyzer = ModuleAnalyzer.for_module(self.real_modname) # parse right now, to get PycodeErrors on parsing (results will # be cached anyway) self.analyzer.find_attr_docs() except PycodeError as exc: logger.debug('[autodoc] module analyzer failed: %s', exc) # no source file -- e.g. for builtin and C modules self.analyzer = None # at least add the module.__file__ as a dependency if hasattr(self.module, '__file__') and self.module.__file__: self.directive.record_dependencies.add(self.module.__file__) else: self.directive.record_dependencies.add(self.analyzer.srcname) if self.real_modname != guess_modname: # Add module to dependency list if target object is defined in other module. try: analyzer = ModuleAnalyzer.for_module(guess_modname) self.directive.record_dependencies.add(analyzer.srcname) except PycodeError: pass docstrings: List[str] = sum(self.get_doc() or [], []) if ismock(self.object) and not docstrings: logger.warning(__('A mocked object is detected: %r'), self.name, type='autodoc') # check __module__ of object (for members not given explicitly) if check_module: if not self.check_module(): return sourcename = self.get_sourcename() # make sure that the result starts with an empty line. This is # necessary for some situations where another directive preprocesses # reST and no starting newline is present self.add_line('', sourcename) # format the object's signature, if any try: sig = self.format_signature() except Exception as exc: logger.warning(__('error while formatting signature for %s: %s'), self.fullname, exc, type='autodoc') return # generate the directive header and options, if applicable self.add_directive_header(sig) self.add_line('', sourcename) # e.g. the module directive doesn't have content self.indent += self.content_indent # add all content (from docstrings, attribute docs etc.) self.add_content(more_content) # document members, if possible self.document_members(all_members) class ModuleDocumenter(Documenter): """ Specialized Documenter subclass for modules. """ objtype = 'module' content_indent = '' titles_allowed = True option_spec: OptionSpec = { 'members': members_option, 'undoc-members': bool_option, 'noindex': bool_option, 'inherited-members': inherited_members_option, 'show-inheritance': bool_option, 'synopsis': identity, 'platform': identity, 'deprecated': bool_option, 'member-order': member_order_option, 'exclude-members': exclude_members_option, 'private-members': members_option, 'special-members': members_option, 'imported-members': bool_option, 'ignore-module-all': bool_option } def __init__(self, *args: Any) -> None: super().__init__(*args) merge_members_option(self.options) self.__all__: Optional[Sequence[str]] = None @classmethod def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any ) -> bool: # don't document submodules automatically return False def resolve_name(self, modname: str, parents: Any, path: str, base: Any ) -> Tuple[str, List[str]]: if modname is not None: logger.warning(__('"::" in automodule name doesn\'t make sense'), type='autodoc') return (path or '') + base, [] def parse_name(self) -> bool: ret = super().parse_name() if self.args or self.retann: logger.warning(__('signature arguments or return annotation ' 'given for automodule %s') % self.fullname, type='autodoc') return ret def import_object(self, raiseerror: bool = False) -> bool: ret = super().import_object(raiseerror) try: if not self.options.ignore_module_all: self.__all__ = inspect.getall(self.object) except ValueError as exc: # invalid __all__ found. logger.warning(__('__all__ should be a list of strings, not %r ' '(in module %s) -- ignoring __all__') % (exc.args[0], self.fullname), type='autodoc') return ret def add_directive_header(self, sig: str) -> None: Documenter.add_directive_header(self, sig) sourcename = self.get_sourcename() # add some module-specific options if self.options.synopsis: self.add_line(' :synopsis: ' + self.options.synopsis, sourcename) if self.options.platform: self.add_line(' :platform: ' + self.options.platform, sourcename) if self.options.deprecated: self.add_line(' :deprecated:', sourcename) def get_module_members(self) -> Dict[str, ObjectMember]: """Get members of target module.""" if self.analyzer: attr_docs = self.analyzer.attr_docs else: attr_docs = {} members: Dict[str, ObjectMember] = {} for name in dir(self.object): try: value = safe_getattr(self.object, name, None) if ismock(value): value = undecorate(value) docstring = attr_docs.get(('', name), []) members[name] = ObjectMember(name, value, docstring="\n".join(docstring)) except AttributeError: continue # annotation only member (ex. attr: int) for name in inspect.getannotations(self.object): if name not in members: docstring = attr_docs.get(('', name), []) members[name] = ObjectMember(name, INSTANCEATTR, docstring="\n".join(docstring)) return members def get_object_members(self, want_all: bool) -> Tuple[bool, ObjectMembers]: members = self.get_module_members() if want_all: if self.__all__ is None: # for implicit module members, check __module__ to avoid # documenting imported objects return True, list(members.values()) else: for member in members.values(): if member.__name__ not in self.__all__: member.skipped = True return False, list(members.values()) else: memberlist = self.options.members or [] ret = [] for name in memberlist: if name in members: ret.append(members[name]) else: logger.warning(__('missing attribute mentioned in :members: option: ' 'module %s, attribute %s') % (safe_getattr(self.object, '__name__', '???'), name), type='autodoc') return False, ret def sort_members(self, documenters: List[Tuple["Documenter", bool]], order: str) -> List[Tuple["Documenter", bool]]: if order == 'bysource' and self.__all__: # Sort alphabetically first (for members not listed on the __all__) documenters.sort(key=lambda e: e[0].name) # Sort by __all__ def keyfunc(entry: Tuple[Documenter, bool]) -> int: name = entry[0].name.split('::')[1] if self.__all__ and name in self.__all__: return self.__all__.index(name) else: return len(self.__all__) documenters.sort(key=keyfunc) return documenters else: return super().sort_members(documenters, order) class ModuleLevelDocumenter(Documenter): """ Specialized Documenter subclass for objects on module level (functions, classes, data/constants). """ def resolve_name(self, modname: str, parents: Any, path: str, base: Any ) -> Tuple[str, List[str]]: if modname is None: if path: modname = path.rstrip('.') else: # if documenting a toplevel object without explicit module, # it can be contained in another auto directive ... modname = self.env.temp_data.get('autodoc:module') # ... or in the scope of a module directive if not modname: modname = self.env.ref_context.get('py:module') # ... else, it stays None, which means invalid return modname, parents + [base] class ClassLevelDocumenter(Documenter): """ Specialized Documenter subclass for objects on class level (methods, attributes). """ def resolve_name(self, modname: str, parents: Any, path: str, base: Any ) -> Tuple[str, List[str]]: if modname is None: if path: mod_cls = path.rstrip('.') else: mod_cls = None # if documenting a class-level object without path, # there must be a current class, either from a parent # auto directive ... mod_cls = self.env.temp_data.get('autodoc:class') # ... or from a class directive if mod_cls is None: mod_cls = self.env.ref_context.get('py:class') # ... if still None, there's no way to know if mod_cls is None: return None, [] modname, sep, cls = mod_cls.rpartition('.') parents = [cls] # if the module name is still missing, get it like above if not modname: modname = self.env.temp_data.get('autodoc:module') if not modname: modname = self.env.ref_context.get('py:module') # ... else, it stays None, which means invalid return modname, parents + [base] class DocstringSignatureMixin: """ Mixin for FunctionDocumenter and MethodDocumenter to provide the feature of reading the signature from the docstring. """ _new_docstrings: List[List[str]] = None _signatures: List[str] = None def _find_signature(self) -> Tuple[str, str]: # candidates of the object name valid_names = [self.objpath[-1]] # type: ignore if isinstance(self, ClassDocumenter): valid_names.append('__init__') if hasattr(self.object, '__mro__'): valid_names.extend(cls.__name__ for cls in self.object.__mro__) docstrings = self.get_doc() if docstrings is None: return None, None self._new_docstrings = docstrings[:] self._signatures = [] result = None for i, doclines in enumerate(docstrings): for j, line in enumerate(doclines): if not line: # no lines in docstring, no match break if line.endswith('\\'): line = line.rstrip('\\').rstrip() # match first line of docstring against signature RE match = py_ext_sig_re.match(line) if not match: break exmod, path, base, args, retann = match.groups() # the base name must match ours if base not in valid_names: break # re-prepare docstring to ignore more leading indentation tab_width = self.directive.state.document.settings.tab_width # type: ignore self._new_docstrings[i] = prepare_docstring('\n'.join(doclines[j + 1:]), tabsize=tab_width) if result is None: # first signature result = args, retann else: # subsequent signatures self._signatures.append("(%s) -> %s" % (args, retann)) if result: # finish the loop when signature found break return result def get_doc(self, ignore: int = None) -> List[List[str]]: if self._new_docstrings is not None: return self._new_docstrings return super().get_doc(ignore) # type: ignore def format_signature(self, **kwargs: Any) -> str: if self.args is None and self.config.autodoc_docstring_signature: # type: ignore # only act if a signature is not explicitly given already, and if # the feature is enabled result = self._find_signature() if result is not None: self.args, self.retann = result sig = super().format_signature(**kwargs) # type: ignore if self._signatures: return "\n".join([sig] + self._signatures) else: return sig class DocstringStripSignatureMixin(DocstringSignatureMixin): """ Mixin for AttributeDocumenter to provide the feature of stripping any function signature from the docstring. """ def format_signature(self, **kwargs: Any) -> str: if self.args is None and self.config.autodoc_docstring_signature: # type: ignore # only act if a signature is not explicitly given already, and if # the feature is enabled result = self._find_signature() if result is not None: # Discarding _args is a only difference with # DocstringSignatureMixin.format_signature. # Documenter.format_signature use self.args value to format. _args, self.retann = result return super().format_signature(**kwargs) class FunctionDocumenter(DocstringSignatureMixin, ModuleLevelDocumenter): # type: ignore """ Specialized Documenter subclass for functions. """ objtype = 'function' member_order = 30 @classmethod def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any ) -> bool: # supports functions, builtins and bound methods exported at the module level return (inspect.isfunction(member) or inspect.isbuiltin(member) or (inspect.isroutine(member) and isinstance(parent, ModuleDocumenter))) def format_args(self, **kwargs: Any) -> str: if self.config.autodoc_typehints in ('none', 'description'): kwargs.setdefault('show_annotation', False) try: self.env.app.emit('autodoc-before-process-signature', self.object, False) sig = inspect.signature(self.object, type_aliases=self.config.autodoc_type_aliases) args = stringify_signature(sig, **kwargs) except TypeError as exc: logger.warning(__("Failed to get a function signature for %s: %s"), self.fullname, exc) return None except ValueError: args = '' if self.config.strip_signature_backslash: # escape backslashes for reST args = args.replace('\\', '\\\\') return args def document_members(self, all_members: bool = False) -> None: pass def add_directive_header(self, sig: str) -> None: sourcename = self.get_sourcename() super().add_directive_header(sig) if inspect.iscoroutinefunction(self.object) or inspect.isasyncgenfunction(self.object): self.add_line(' :async:', sourcename) def format_signature(self, **kwargs: Any) -> str: sigs = [] if (self.analyzer and '.'.join(self.objpath) in self.analyzer.overloads and self.config.autodoc_typehints != 'none'): # Use signatures for overloaded functions instead of the implementation function. overloaded = True else: overloaded = False sig = super().format_signature(**kwargs) sigs.append(sig) if inspect.is_singledispatch_function(self.object): # append signature of singledispatch'ed functions for typ, func in self.object.registry.items(): if typ is object: pass # default implementation. skipped. else: dispatchfunc = self.annotate_to_first_argument(func, typ) if dispatchfunc: documenter = FunctionDocumenter(self.directive, '') documenter.object = dispatchfunc documenter.objpath = [None] sigs.append(documenter.format_signature()) if overloaded: actual = inspect.signature(self.object, type_aliases=self.config.autodoc_type_aliases) __globals__ = safe_getattr(self.object, '__globals__', {}) for overload in self.analyzer.overloads.get('.'.join(self.objpath)): overload = self.merge_default_value(actual, overload) overload = evaluate_signature(overload, __globals__, self.config.autodoc_type_aliases) sig = stringify_signature(overload, **kwargs) sigs.append(sig) return "\n".join(sigs) def merge_default_value(self, actual: Signature, overload: Signature) -> Signature: """Merge default values of actual implementation to the overload variants.""" parameters = list(overload.parameters.values()) for i, param in enumerate(parameters): actual_param = actual.parameters.get(param.name) if actual_param and param.default == '...': parameters[i] = param.replace(default=actual_param.default) return overload.replace(parameters=parameters) def annotate_to_first_argument(self, func: Callable, typ: Type) -> Optional[Callable]: """Annotate type hint to the first argument of function if needed.""" try: sig = inspect.signature(func, type_aliases=self.config.autodoc_type_aliases) except TypeError as exc: logger.warning(__("Failed to get a function signature for %s: %s"), self.fullname, exc) return None except ValueError: return None if len(sig.parameters) == 0: return None def dummy(): pass params = list(sig.parameters.values()) if params[0].annotation is Parameter.empty: params[0] = params[0].replace(annotation=typ) try: dummy.__signature__ = sig.replace(parameters=params) # type: ignore return dummy except (AttributeError, TypeError): # failed to update signature (ex. built-in or extension types) return None else: return None class DecoratorDocumenter(FunctionDocumenter): """ Specialized Documenter subclass for decorator functions. """ objtype = 'decorator' # must be lower than FunctionDocumenter priority = -1 def format_args(self, **kwargs: Any) -> Any: args = super().format_args(**kwargs) if ',' in args: return args else: return None # Types which have confusing metaclass signatures it would be best not to show. # These are listed by name, rather than storing the objects themselves, to avoid # needing to import the modules. _METACLASS_CALL_BLACKLIST = [ 'enum.EnumMeta.__call__', ] # Types whose __new__ signature is a pass-through. _CLASS_NEW_BLACKLIST = [ 'typing.Generic.__new__', ] class ClassDocumenter(DocstringSignatureMixin, ModuleLevelDocumenter): # type: ignore """ Specialized Documenter subclass for classes. """ objtype = 'class' member_order = 20 option_spec: OptionSpec = { 'members': members_option, 'undoc-members': bool_option, 'noindex': bool_option, 'inherited-members': inherited_members_option, 'show-inheritance': bool_option, 'member-order': member_order_option, 'exclude-members': exclude_members_option, 'private-members': members_option, 'special-members': members_option, 'class-doc-from': class_doc_from_option, } _signature_class: Any = None _signature_method_name: str = None def __init__(self, *args: Any) -> None: super().__init__(*args) if self.config.autodoc_class_signature == 'separated': self.options = self.options.copy() # show __init__() method if self.options.special_members is None: self.options['special-members'] = ['__new__', '__init__'] else: self.options.special_members.append('__new__') self.options.special_members.append('__init__') merge_members_option(self.options) @classmethod def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any ) -> bool: return isinstance(member, type) def import_object(self, raiseerror: bool = False) -> bool: ret = super().import_object(raiseerror) # if the class is documented under another name, document it # as data/attribute if ret: if hasattr(self.object, '__name__'): self.doc_as_attr = (self.objpath[-1] != self.object.__name__) else: self.doc_as_attr = True return ret def _get_signature(self) -> Tuple[Optional[Any], Optional[str], Optional[Signature]]: def get_user_defined_function_or_method(obj: Any, attr: str) -> Any: """ Get the `attr` function or method from `obj`, if it is user-defined. """ if inspect.is_builtin_class_method(obj, attr): return None attr = self.get_attr(obj, attr, None) if not (inspect.ismethod(attr) or inspect.isfunction(attr)): return None return attr # This sequence is copied from inspect._signature_from_callable. # ValueError means that no signature could be found, so we keep going. # First, we check the obj has a __signature__ attribute if (hasattr(self.object, '__signature__') and isinstance(self.object.__signature__, Signature)): return None, None, self.object.__signature__ # Next, let's see if it has an overloaded __call__ defined # in its metaclass call = get_user_defined_function_or_method(type(self.object), '__call__') if call is not None: if "{0.__module__}.{0.__qualname__}".format(call) in _METACLASS_CALL_BLACKLIST: call = None if call is not None: self.env.app.emit('autodoc-before-process-signature', call, True) try: sig = inspect.signature(call, bound_method=True, type_aliases=self.config.autodoc_type_aliases) return type(self.object), '__call__', sig except ValueError: pass # Now we check if the 'obj' class has a '__new__' method new = get_user_defined_function_or_method(self.object, '__new__') if new is not None: if "{0.__module__}.{0.__qualname__}".format(new) in _CLASS_NEW_BLACKLIST: new = None if new is not None: self.env.app.emit('autodoc-before-process-signature', new, True) try: sig = inspect.signature(new, bound_method=True, type_aliases=self.config.autodoc_type_aliases) return self.object, '__new__', sig except ValueError: pass # Finally, we should have at least __init__ implemented init = get_user_defined_function_or_method(self.object, '__init__') if init is not None: self.env.app.emit('autodoc-before-process-signature', init, True) try: sig = inspect.signature(init, bound_method=True, type_aliases=self.config.autodoc_type_aliases) return self.object, '__init__', sig except ValueError: pass # None of the attributes are user-defined, so fall back to let inspect # handle it. # We don't know the exact method that inspect.signature will read # the signature from, so just pass the object itself to our hook. self.env.app.emit('autodoc-before-process-signature', self.object, False) try: sig = inspect.signature(self.object, bound_method=False, type_aliases=self.config.autodoc_type_aliases) return None, None, sig except ValueError: pass # Still no signature: happens e.g. for old-style classes # with __init__ in C and no `__text_signature__`. return None, None, None def format_args(self, **kwargs: Any) -> str: if self.config.autodoc_typehints in ('none', 'description'): kwargs.setdefault('show_annotation', False) try: self._signature_class, self._signature_method_name, sig = self._get_signature() except TypeError as exc: # __signature__ attribute contained junk logger.warning(__("Failed to get a constructor signature for %s: %s"), self.fullname, exc) return None if sig is None: return None return stringify_signature(sig, show_return_annotation=False, **kwargs) def format_signature(self, **kwargs: Any) -> str: if self.doc_as_attr: return '' if self.config.autodoc_class_signature == 'separated': # do not show signatures return '' sig = super().format_signature() sigs = [] overloads = self.get_overloaded_signatures() if overloads and self.config.autodoc_typehints != 'none': # Use signatures for overloaded methods instead of the implementation method. method = safe_getattr(self._signature_class, self._signature_method_name, None) __globals__ = safe_getattr(method, '__globals__', {}) for overload in overloads: overload = evaluate_signature(overload, __globals__, self.config.autodoc_type_aliases) parameters = list(overload.parameters.values()) overload = overload.replace(parameters=parameters[1:], return_annotation=Parameter.empty) sig = stringify_signature(overload, **kwargs) sigs.append(sig) else: sigs.append(sig) return "\n".join(sigs) def get_overloaded_signatures(self) -> List[Signature]: if self._signature_class and self._signature_method_name: for cls in self._signature_class.__mro__: try: analyzer = ModuleAnalyzer.for_module(cls.__module__) analyzer.analyze() qualname = '.'.join([cls.__qualname__, self._signature_method_name]) if qualname in analyzer.overloads: return analyzer.overloads.get(qualname) elif qualname in analyzer.tagorder: # the constructor is defined in the class, but not overridden. return [] except PycodeError: pass return [] def get_canonical_fullname(self) -> Optional[str]: __modname__ = safe_getattr(self.object, '__module__', self.modname) __qualname__ = safe_getattr(self.object, '__qualname__', None) if __qualname__ is None: __qualname__ = safe_getattr(self.object, '__name__', None) if __qualname__ and '<locals>' in __qualname__: # No valid qualname found if the object is defined as locals __qualname__ = None if __modname__ and __qualname__: return '.'.join([__modname__, __qualname__]) else: return None def add_directive_header(self, sig: str) -> None: sourcename = self.get_sourcename() if self.doc_as_attr: self.directivetype = 'attribute' super().add_directive_header(sig) if self.analyzer and '.'.join(self.objpath) in self.analyzer.finals: self.add_line(' :final:', sourcename) canonical_fullname = self.get_canonical_fullname() if not self.doc_as_attr and canonical_fullname and self.fullname != canonical_fullname: self.add_line(' :canonical: %s' % canonical_fullname, sourcename) # add inheritance info, if wanted if not self.doc_as_attr and self.options.show_inheritance: if inspect.getorigbases(self.object): # A subclass of generic types # refs: PEP-560 <https://www.python.org/dev/peps/pep-0560/> bases = list(self.object.__orig_bases__) elif hasattr(self.object, '__bases__') and len(self.object.__bases__): # A normal class bases = list(self.object.__bases__) else: bases = [] self.env.events.emit('autodoc-process-bases', self.fullname, self.object, self.options, bases) base_classes = [restify(cls) for cls in bases] sourcename = self.get_sourcename() self.add_line('', sourcename) self.add_line(' ' + _('Bases: %s') % ', '.join(base_classes), sourcename) def get_object_members(self, want_all: bool) -> Tuple[bool, ObjectMembers]: members = get_class_members(self.object, self.objpath, self.get_attr) if not want_all: if not self.options.members: return False, [] # type: ignore # specific members given selected = [] for name in self.options.members: # type: str if name in members: selected.append(members[name]) else: logger.warning(__('missing attribute %s in object %s') % (name, self.fullname), type='autodoc') return False, selected elif self.options.inherited_members: return False, list(members.values()) else: return False, [m for m in members.values() if m.class_ == self.object] def get_doc(self, ignore: int = None) -> Optional[List[List[str]]]: if self.doc_as_attr: # Don't show the docstring of the class when it is an alias. comment = self.get_variable_comment() if comment: return [] else: return None lines = getattr(self, '_new_docstrings', None) if lines is not None: return lines classdoc_from = self.options.get('class-doc-from', self.config.autoclass_content) docstrings = [] attrdocstring = getdoc(self.object, self.get_attr) if attrdocstring: docstrings.append(attrdocstring) # for classes, what the "docstring" is can be controlled via a # config value; the default is only the class docstring if classdoc_from in ('both', 'init'): __init__ = self.get_attr(self.object, '__init__', None) initdocstring = getdoc(__init__, self.get_attr, self.config.autodoc_inherit_docstrings, self.object, '__init__') # for new-style classes, no __init__ means default __init__ if (initdocstring is not None and (initdocstring == object.__init__.__doc__ or # for pypy initdocstring.strip() == object.__init__.__doc__)): # for !pypy initdocstring = None if not initdocstring: # try __new__ __new__ = self.get_attr(self.object, '__new__', None) initdocstring = getdoc(__new__, self.get_attr, self.config.autodoc_inherit_docstrings, self.object, '__new__') # for new-style classes, no __new__ means default __new__ if (initdocstring is not None and (initdocstring == object.__new__.__doc__ or # for pypy initdocstring.strip() == object.__new__.__doc__)): # for !pypy initdocstring = None if initdocstring: if classdoc_from == 'init': docstrings = [initdocstring] else: docstrings.append(initdocstring) tab_width = self.directive.state.document.settings.tab_width return [prepare_docstring(docstring, ignore, tab_width) for docstring in docstrings] def get_variable_comment(self) -> Optional[List[str]]: try: key = ('', '.'.join(self.objpath)) analyzer = ModuleAnalyzer.for_module(self.get_real_modname()) analyzer.analyze() return list(self.analyzer.attr_docs.get(key, [])) except PycodeError: return None def add_content(self, more_content: Optional[StringList], no_docstring: bool = False ) -> None: if self.doc_as_attr and not self.get_variable_comment(): try: more_content = StringList([_('alias of %s') % restify(self.object)], source='') except AttributeError: pass # Invalid class object is passed. super().add_content(more_content) def document_members(self, all_members: bool = False) -> None: if self.doc_as_attr: return super().document_members(all_members) def generate(self, more_content: Optional[StringList] = None, real_modname: str = None, check_module: bool = False, all_members: bool = False) -> None: # Do not pass real_modname and use the name from the __module__ # attribute of the class. # If a class gets imported into the module real_modname # the analyzer won't find the source of the class, if # it looks in real_modname. return super().generate(more_content=more_content, check_module=check_module, all_members=all_members) class ExceptionDocumenter(ClassDocumenter): """ Specialized ClassDocumenter subclass for exceptions. """ objtype = 'exception' member_order = 10 # needs a higher priority than ClassDocumenter priority = 10 @classmethod def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any ) -> bool: return isinstance(member, type) and issubclass(member, BaseException) class DataDocumenterMixinBase: # define types of instance variables config: Config = None env: BuildEnvironment = None modname: str = None parent: Any = None object: Any = None objpath: List[str] = None def should_suppress_directive_header(self) -> bool: """Check directive header should be suppressed.""" return False def should_suppress_value_header(self) -> bool: """Check :value: header should be suppressed.""" return False def update_content(self, more_content: StringList) -> None: """Update docstring for the NewType object.""" pass class GenericAliasMixin(DataDocumenterMixinBase): """ Mixin for DataDocumenter and AttributeDocumenter to provide the feature for supporting GenericAliases. """ def should_suppress_directive_header(self) -> bool: return (inspect.isgenericalias(self.object) or super().should_suppress_directive_header()) def update_content(self, more_content: StringList) -> None: if inspect.isgenericalias(self.object): more_content.append(_('alias of %s') % restify(self.object), '') more_content.append('', '') super().update_content(more_content) class NewTypeMixin(DataDocumenterMixinBase): """ Mixin for DataDocumenter and AttributeDocumenter to provide the feature for supporting NewTypes. """ def should_suppress_directive_header(self) -> bool: return (inspect.isNewType(self.object) or super().should_suppress_directive_header()) def update_content(self, more_content: StringList) -> None: if inspect.isNewType(self.object): supertype = restify(self.object.__supertype__) more_content.append(_('alias of %s') % supertype, '') more_content.append('', '') super().update_content(more_content) class TypeVarMixin(DataDocumenterMixinBase): """ Mixin for DataDocumenter and AttributeDocumenter to provide the feature for supporting TypeVars. """ def should_suppress_directive_header(self) -> bool: return (isinstance(self.object, TypeVar) or super().should_suppress_directive_header()) def get_doc(self, ignore: int = None) -> Optional[List[List[str]]]: if ignore is not None: warnings.warn("The 'ignore' argument to autodoc.%s.get_doc() is deprecated." % self.__class__.__name__, RemovedInSphinx50Warning, stacklevel=2) if isinstance(self.object, TypeVar): if self.object.__doc__ != TypeVar.__doc__: return super().get_doc() # type: ignore else: return [] else: return super().get_doc() # type: ignore def update_content(self, more_content: StringList) -> None: if isinstance(self.object, TypeVar): attrs = [repr(self.object.__name__)] for constraint in self.object.__constraints__: attrs.append(stringify_typehint(constraint)) if self.object.__bound__: attrs.append(r"bound=\ " + restify(self.object.__bound__)) if self.object.__covariant__: attrs.append("covariant=True") if self.object.__contravariant__: attrs.append("contravariant=True") more_content.append(_('alias of TypeVar(%s)') % ", ".join(attrs), '') more_content.append('', '') super().update_content(more_content) class UninitializedGlobalVariableMixin(DataDocumenterMixinBase): """ Mixin for DataDocumenter to provide the feature for supporting uninitialized (type annotation only) global variables. """ def import_object(self, raiseerror: bool = False) -> bool: try: return super().import_object(raiseerror=True) # type: ignore except ImportError as exc: # annotation only instance variable (PEP-526) try: with mock(self.config.autodoc_mock_imports): parent = import_module(self.modname, self.config.autodoc_warningiserror) annotations = get_type_hints(parent, None, self.config.autodoc_type_aliases) if self.objpath[-1] in annotations: self.object = UNINITIALIZED_ATTR self.parent = parent return True except ImportError: pass if raiseerror: raise else: logger.warning(exc.args[0], type='autodoc', subtype='import_object') self.env.note_reread() return False def should_suppress_value_header(self) -> bool: return (self.object is UNINITIALIZED_ATTR or super().should_suppress_value_header()) def get_doc(self, ignore: int = None) -> Optional[List[List[str]]]: if self.object is UNINITIALIZED_ATTR: return [] else: return super().get_doc(ignore) # type: ignore class DataDocumenter(GenericAliasMixin, NewTypeMixin, TypeVarMixin, UninitializedGlobalVariableMixin, ModuleLevelDocumenter): """ Specialized Documenter subclass for data items. """ objtype = 'data' member_order = 40 priority = -10 option_spec: OptionSpec = dict(ModuleLevelDocumenter.option_spec) option_spec["annotation"] = annotation_option option_spec["no-value"] = bool_option @classmethod def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any ) -> bool: return isinstance(parent, ModuleDocumenter) and isattr def update_annotations(self, parent: Any) -> None: """Update __annotations__ to support type_comment and so on.""" annotations = dict(inspect.getannotations(parent)) parent.__annotations__ = annotations try: analyzer = ModuleAnalyzer.for_module(self.modname) analyzer.analyze() for (classname, attrname), annotation in analyzer.annotations.items(): if classname == '' and attrname not in annotations: annotations[attrname] = annotation except PycodeError: pass def import_object(self, raiseerror: bool = False) -> bool: ret = super().import_object(raiseerror) if self.parent: self.update_annotations(self.parent) return ret def should_suppress_value_header(self) -> bool: if super().should_suppress_value_header(): return True else: doc = self.get_doc() docstring, metadata = separate_metadata('\n'.join(sum(doc, []))) if 'hide-value' in metadata: return True return False def add_directive_header(self, sig: str) -> None: super().add_directive_header(sig) sourcename = self.get_sourcename() if self.options.annotation is SUPPRESS or self.should_suppress_directive_header(): pass elif self.options.annotation: self.add_line(' :annotation: %s' % self.options.annotation, sourcename) else: if self.config.autodoc_typehints != 'none': # obtain annotation for this data annotations = get_type_hints(self.parent, None, self.config.autodoc_type_aliases) if self.objpath[-1] in annotations: objrepr = stringify_typehint(annotations.get(self.objpath[-1])) self.add_line(' :type: ' + objrepr, sourcename) try: if self.options.no_value or self.should_suppress_value_header(): pass else: objrepr = object_description(self.object) self.add_line(' :value: ' + objrepr, sourcename) except ValueError: pass def document_members(self, all_members: bool = False) -> None: pass def get_real_modname(self) -> str: real_modname = self.get_attr(self.parent or self.object, '__module__', None) return real_modname or self.modname def get_module_comment(self, attrname: str) -> Optional[List[str]]: try: analyzer = ModuleAnalyzer.for_module(self.modname) analyzer.analyze() key = ('', attrname) if key in analyzer.attr_docs: return list(analyzer.attr_docs[key]) except PycodeError: pass return None def get_doc(self, ignore: int = None) -> Optional[List[List[str]]]: # Check the variable has a docstring-comment comment = self.get_module_comment(self.objpath[-1]) if comment: return [comment] else: return super().get_doc(ignore) def add_content(self, more_content: Optional[StringList], no_docstring: bool = False ) -> None: # Disable analyzing variable comment on Documenter.add_content() to control it on # DataDocumenter.add_content() self.analyzer = None if not more_content: more_content = StringList() self.update_content(more_content) super().add_content(more_content, no_docstring=no_docstring) class NewTypeDataDocumenter(DataDocumenter): """ Specialized Documenter subclass for NewTypes. Note: This must be invoked before FunctionDocumenter because NewType is a kind of function object. """ objtype = 'newtypedata' directivetype = 'data' priority = FunctionDocumenter.priority + 1 @classmethod def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any ) -> bool: return inspect.isNewType(member) and isattr class MethodDocumenter(DocstringSignatureMixin, ClassLevelDocumenter): # type: ignore """ Specialized Documenter subclass for methods (normal, static and class). """ objtype = 'method' directivetype = 'method' member_order = 50 priority = 1 # must be more than FunctionDocumenter @classmethod def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any ) -> bool: return inspect.isroutine(member) and not isinstance(parent, ModuleDocumenter) def import_object(self, raiseerror: bool = False) -> bool: ret = super().import_object(raiseerror) if not ret: return ret # to distinguish classmethod/staticmethod obj = self.parent.__dict__.get(self.object_name) if obj is None: obj = self.object if (inspect.isclassmethod(obj) or inspect.isstaticmethod(obj, cls=self.parent, name=self.object_name)): # document class and static members before ordinary ones self.member_order = self.member_order - 1 return ret def format_args(self, **kwargs: Any) -> str: if self.config.autodoc_typehints in ('none', 'description'): kwargs.setdefault('show_annotation', False) try: if self.object == object.__init__ and self.parent != object: # Classes not having own __init__() method are shown as no arguments. # # Note: The signature of object.__init__() is (self, /, *args, **kwargs). # But it makes users confused. args = '()' else: if inspect.isstaticmethod(self.object, cls=self.parent, name=self.object_name): self.env.app.emit('autodoc-before-process-signature', self.object, False) sig = inspect.signature(self.object, bound_method=False, type_aliases=self.config.autodoc_type_aliases) else: self.env.app.emit('autodoc-before-process-signature', self.object, True) sig = inspect.signature(self.object, bound_method=True, type_aliases=self.config.autodoc_type_aliases) args = stringify_signature(sig, **kwargs) except TypeError as exc: logger.warning(__("Failed to get a method signature for %s: %s"), self.fullname, exc) return None except ValueError: args = '' if self.config.strip_signature_backslash: # escape backslashes for reST args = args.replace('\\', '\\\\') return args def add_directive_header(self, sig: str) -> None: super().add_directive_header(sig) sourcename = self.get_sourcename() obj = self.parent.__dict__.get(self.object_name, self.object) if inspect.isabstractmethod(obj): self.add_line(' :abstractmethod:', sourcename) if inspect.iscoroutinefunction(obj) or inspect.isasyncgenfunction(obj): self.add_line(' :async:', sourcename) if inspect.isclassmethod(obj): self.add_line(' :classmethod:', sourcename) if inspect.isstaticmethod(obj, cls=self.parent, name=self.object_name): self.add_line(' :staticmethod:', sourcename) if self.analyzer and '.'.join(self.objpath) in self.analyzer.finals: self.add_line(' :final:', sourcename) def document_members(self, all_members: bool = False) -> None: pass def format_signature(self, **kwargs: Any) -> str: sigs = [] if (self.analyzer and '.'.join(self.objpath) in self.analyzer.overloads and self.config.autodoc_typehints != 'none'): # Use signatures for overloaded methods instead of the implementation method. overloaded = True else: overloaded = False sig = super().format_signature(**kwargs) sigs.append(sig) meth = self.parent.__dict__.get(self.objpath[-1]) if inspect.is_singledispatch_method(meth): # append signature of singledispatch'ed functions for typ, func in meth.dispatcher.registry.items(): if typ is object: pass # default implementation. skipped. else: dispatchmeth = self.annotate_to_first_argument(func, typ) if dispatchmeth: documenter = MethodDocumenter(self.directive, '') documenter.parent = self.parent documenter.object = dispatchmeth documenter.objpath = [None] sigs.append(documenter.format_signature()) if overloaded: if inspect.isstaticmethod(self.object, cls=self.parent, name=self.object_name): actual = inspect.signature(self.object, bound_method=False, type_aliases=self.config.autodoc_type_aliases) else: actual = inspect.signature(self.object, bound_method=True, type_aliases=self.config.autodoc_type_aliases) __globals__ = safe_getattr(self.object, '__globals__', {}) for overload in self.analyzer.overloads.get('.'.join(self.objpath)): overload = self.merge_default_value(actual, overload) overload = evaluate_signature(overload, __globals__, self.config.autodoc_type_aliases) if not inspect.isstaticmethod(self.object, cls=self.parent, name=self.object_name): parameters = list(overload.parameters.values()) overload = overload.replace(parameters=parameters[1:]) sig = stringify_signature(overload, **kwargs) sigs.append(sig) return "\n".join(sigs) def merge_default_value(self, actual: Signature, overload: Signature) -> Signature: """Merge default values of actual implementation to the overload variants.""" parameters = list(overload.parameters.values()) for i, param in enumerate(parameters): actual_param = actual.parameters.get(param.name) if actual_param and param.default == '...': parameters[i] = param.replace(default=actual_param.default) return overload.replace(parameters=parameters) def annotate_to_first_argument(self, func: Callable, typ: Type) -> Optional[Callable]: """Annotate type hint to the first argument of function if needed.""" try: sig = inspect.signature(func, type_aliases=self.config.autodoc_type_aliases) except TypeError as exc: logger.warning(__("Failed to get a method signature for %s: %s"), self.fullname, exc) return None except ValueError: return None if len(sig.parameters) == 1: return None def dummy(): pass params = list(sig.parameters.values()) if params[1].annotation is Parameter.empty: params[1] = params[1].replace(annotation=typ) try: dummy.__signature__ = sig.replace(parameters=params) # type: ignore return dummy except (AttributeError, TypeError): # failed to update signature (ex. built-in or extension types) return None else: return None def get_doc(self, ignore: int = None) -> Optional[List[List[str]]]: if self._new_docstrings is not None: # docstring already returned previously, then modified by # `DocstringSignatureMixin`. Just return the previously-computed # result, so that we don't lose the processing done by # `DocstringSignatureMixin`. return self._new_docstrings if self.objpath[-1] == '__init__': docstring = getdoc(self.object, self.get_attr, self.config.autodoc_inherit_docstrings, self.parent, self.object_name) if (docstring is not None and (docstring == object.__init__.__doc__ or # for pypy docstring.strip() == object.__init__.__doc__)): # for !pypy docstring = None if docstring: tab_width = self.directive.state.document.settings.tab_width return [prepare_docstring(docstring, tabsize=tab_width)] else: return [] elif self.objpath[-1] == '__new__': docstring = getdoc(self.object, self.get_attr, self.config.autodoc_inherit_docstrings, self.parent, self.object_name) if (docstring is not None and (docstring == object.__new__.__doc__ or # for pypy docstring.strip() == object.__new__.__doc__)): # for !pypy docstring = None if docstring: tab_width = self.directive.state.document.settings.tab_width return [prepare_docstring(docstring, tabsize=tab_width)] else: return [] else: return super().get_doc() class NonDataDescriptorMixin(DataDocumenterMixinBase): """ Mixin for AttributeDocumenter to provide the feature for supporting non data-descriptors. .. note:: This mix-in must be inherited after other mix-ins. Otherwise, docstring and :value: header will be suppressed unexpectedly. """ def import_object(self, raiseerror: bool = False) -> bool: ret = super().import_object(raiseerror) # type: ignore if ret and not inspect.isattributedescriptor(self.object): self.non_data_descriptor = True else: self.non_data_descriptor = False return ret def should_suppress_value_header(self) -> bool: return (not getattr(self, 'non_data_descriptor', False) or super().should_suppress_directive_header()) def get_doc(self, ignore: int = None) -> Optional[List[List[str]]]: if getattr(self, 'non_data_descriptor', False): # the docstring of non datadescriptor is very probably the wrong thing # to display return None else: return super().get_doc(ignore) # type: ignore class SlotsMixin(DataDocumenterMixinBase): """ Mixin for AttributeDocumenter to provide the feature for supporting __slots__. """ def isslotsattribute(self) -> bool: """Check the subject is an attribute in __slots__.""" try: __slots__ = inspect.getslots(self.parent) if __slots__ and self.objpath[-1] in __slots__: return True else: return False except (ValueError, TypeError): return False def import_object(self, raiseerror: bool = False) -> bool: ret = super().import_object(raiseerror) # type: ignore if self.isslotsattribute(): self.object = SLOTSATTR return ret def should_suppress_value_header(self) -> bool: if self.object is SLOTSATTR: return True else: return super().should_suppress_value_header() def get_doc(self, ignore: int = None) -> Optional[List[List[str]]]: if self.object is SLOTSATTR: try: __slots__ = inspect.getslots(self.parent) if __slots__ and __slots__.get(self.objpath[-1]): docstring = prepare_docstring(__slots__[self.objpath[-1]]) return [docstring] else: return [] except ValueError as exc: logger.warning(__('Invalid __slots__ found on %s. Ignored.'), (self.parent.__qualname__, exc), type='autodoc') return [] else: return super().get_doc(ignore) # type: ignore @property def _datadescriptor(self) -> bool: warnings.warn('AttributeDocumenter._datadescriptor() is deprecated.', RemovedInSphinx60Warning) if self.object is SLOTSATTR: return True else: return False class RuntimeInstanceAttributeMixin(DataDocumenterMixinBase): """ Mixin for AttributeDocumenter to provide the feature for supporting runtime instance attributes (that are defined in __init__() methods with doc-comments). Example: class Foo: def __init__(self): self.attr = None #: This is a target of this mix-in. """ RUNTIME_INSTANCE_ATTRIBUTE = object() def is_runtime_instance_attribute(self, parent: Any) -> bool: """Check the subject is an attribute defined in __init__().""" # An instance variable defined in __init__(). if self.get_attribute_comment(parent, self.objpath[-1]): # type: ignore return True elif self.is_runtime_instance_attribute_not_commented(parent): return True else: return False def is_runtime_instance_attribute_not_commented(self, parent: Any) -> bool: """Check the subject is an attribute defined in __init__() without comment.""" for cls in inspect.getmro(parent): try: module = safe_getattr(cls, '__module__') qualname = safe_getattr(cls, '__qualname__') analyzer = ModuleAnalyzer.for_module(module) analyzer.analyze() if qualname and self.objpath: key = '.'.join([qualname, self.objpath[-1]]) if key in analyzer.tagorder: return True except (AttributeError, PycodeError): pass return None def import_object(self, raiseerror: bool = False) -> bool: """Check the existence of runtime instance attribute after failing to import the attribute.""" try: return super().import_object(raiseerror=True) # type: ignore except ImportError as exc: try: with mock(self.config.autodoc_mock_imports): ret = import_object(self.modname, self.objpath[:-1], 'class', attrgetter=self.get_attr, # type: ignore warningiserror=self.config.autodoc_warningiserror) parent = ret[3] if self.is_runtime_instance_attribute(parent): self.object = self.RUNTIME_INSTANCE_ATTRIBUTE self.parent = parent return True except ImportError: pass if raiseerror: raise else: logger.warning(exc.args[0], type='autodoc', subtype='import_object') self.env.note_reread() return False def should_suppress_value_header(self) -> bool: return (self.object is self.RUNTIME_INSTANCE_ATTRIBUTE or super().should_suppress_value_header()) def get_doc(self, ignore: int = None) -> Optional[List[List[str]]]: if (self.object is self.RUNTIME_INSTANCE_ATTRIBUTE and self.is_runtime_instance_attribute_not_commented(self.parent)): return None else: return super().get_doc(ignore) # type: ignore class UninitializedInstanceAttributeMixin(DataDocumenterMixinBase): """ Mixin for AttributeDocumenter to provide the feature for supporting uninitialized instance attributes (PEP-526 styled, annotation only attributes). Example: class Foo: attr: int #: This is a target of this mix-in. """ def is_uninitialized_instance_attribute(self, parent: Any) -> bool: """Check the subject is an annotation only attribute.""" annotations = get_type_hints(parent, None, self.config.autodoc_type_aliases) if self.objpath[-1] in annotations: return True else: return False def import_object(self, raiseerror: bool = False) -> bool: """Check the exisitence of uninitialized instance attribute when failed to import the attribute.""" try: return super().import_object(raiseerror=True) # type: ignore except ImportError as exc: try: ret = import_object(self.modname, self.objpath[:-1], 'class', attrgetter=self.get_attr, # type: ignore warningiserror=self.config.autodoc_warningiserror) parent = ret[3] if self.is_uninitialized_instance_attribute(parent): self.object = UNINITIALIZED_ATTR self.parent = parent return True except ImportError: pass if raiseerror: raise else: logger.warning(exc.args[0], type='autodoc', subtype='import_object') self.env.note_reread() return False def should_suppress_value_header(self) -> bool: return (self.object is UNINITIALIZED_ATTR or super().should_suppress_value_header()) def get_doc(self, ignore: int = None) -> Optional[List[List[str]]]: if self.object is UNINITIALIZED_ATTR: return None else: return super().get_doc(ignore) # type: ignore class AttributeDocumenter(GenericAliasMixin, NewTypeMixin, SlotsMixin, # type: ignore TypeVarMixin, RuntimeInstanceAttributeMixin, UninitializedInstanceAttributeMixin, NonDataDescriptorMixin, DocstringStripSignatureMixin, ClassLevelDocumenter): """ Specialized Documenter subclass for attributes. """ objtype = 'attribute' member_order = 60 option_spec: OptionSpec = dict(ModuleLevelDocumenter.option_spec) option_spec["annotation"] = annotation_option option_spec["no-value"] = bool_option # must be higher than the MethodDocumenter, else it will recognize # some non-data descriptors as methods priority = 10 @staticmethod def is_function_or_method(obj: Any) -> bool: return inspect.isfunction(obj) or inspect.isbuiltin(obj) or inspect.ismethod(obj) @classmethod def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any ) -> bool: if inspect.isattributedescriptor(member): return True elif (not isinstance(parent, ModuleDocumenter) and not inspect.isroutine(member) and not isinstance(member, type)): return True else: return False def document_members(self, all_members: bool = False) -> None: pass def isinstanceattribute(self) -> bool: """Check the subject is an instance attribute.""" warnings.warn('AttributeDocumenter.isinstanceattribute() is deprecated.', RemovedInSphinx50Warning) # uninitialized instance variable (PEP-526) with mock(self.config.autodoc_mock_imports): try: ret = import_object(self.modname, self.objpath[:-1], 'class', attrgetter=self.get_attr, warningiserror=self.config.autodoc_warningiserror) self.parent = ret[3] annotations = get_type_hints(self.parent, None, self.config.autodoc_type_aliases) if self.objpath[-1] in annotations: self.object = UNINITIALIZED_ATTR return True except ImportError: pass return False def update_annotations(self, parent: Any) -> None: """Update __annotations__ to support type_comment and so on.""" try: annotations = dict(inspect.getannotations(parent)) parent.__annotations__ = annotations for cls in inspect.getmro(parent): try: module = safe_getattr(cls, '__module__') qualname = safe_getattr(cls, '__qualname__') analyzer = ModuleAnalyzer.for_module(module) analyzer.analyze() for (classname, attrname), annotation in analyzer.annotations.items(): if classname == qualname and attrname not in annotations: annotations[attrname] = annotation except (AttributeError, PycodeError): pass except (AttributeError, TypeError): # Failed to set __annotations__ (built-in, extensions, etc.) pass def import_object(self, raiseerror: bool = False) -> bool: ret = super().import_object(raiseerror) if inspect.isenumattribute(self.object): self.object = self.object.value if self.parent: self.update_annotations(self.parent) return ret def get_real_modname(self) -> str: real_modname = self.get_attr(self.parent or self.object, '__module__', None) return real_modname or self.modname def should_suppress_value_header(self) -> bool: if super().should_suppress_value_header(): return True else: doc = self.get_doc() if doc: docstring, metadata = separate_metadata('\n'.join(sum(doc, []))) if 'hide-value' in metadata: return True return False def add_directive_header(self, sig: str) -> None: super().add_directive_header(sig) sourcename = self.get_sourcename() if self.options.annotation is SUPPRESS or self.should_suppress_directive_header(): pass elif self.options.annotation: self.add_line(' :annotation: %s' % self.options.annotation, sourcename) else: if self.config.autodoc_typehints != 'none': # obtain type annotation for this attribute annotations = get_type_hints(self.parent, None, self.config.autodoc_type_aliases) if self.objpath[-1] in annotations: objrepr = stringify_typehint(annotations.get(self.objpath[-1])) self.add_line(' :type: ' + objrepr, sourcename) try: if self.options.no_value or self.should_suppress_value_header(): pass else: objrepr = object_description(self.object) self.add_line(' :value: ' + objrepr, sourcename) except ValueError: pass def get_attribute_comment(self, parent: Any, attrname: str) -> Optional[List[str]]: for cls in inspect.getmro(parent): try: module = safe_getattr(cls, '__module__') qualname = safe_getattr(cls, '__qualname__') analyzer = ModuleAnalyzer.for_module(module) analyzer.analyze() if qualname and self.objpath: key = (qualname, attrname) if key in analyzer.attr_docs: return list(analyzer.attr_docs[key]) except (AttributeError, PycodeError): pass return None def get_doc(self, ignore: int = None) -> Optional[List[List[str]]]: # Check the attribute has a docstring-comment comment = self.get_attribute_comment(self.parent, self.objpath[-1]) if comment: return [comment] try: # Disable `autodoc_inherit_docstring` temporarily to avoid to obtain # a docstring from the value which descriptor returns unexpectedly. # ref: https://github.com/sphinx-doc/sphinx/issues/7805 orig = self.config.autodoc_inherit_docstrings self.config.autodoc_inherit_docstrings = False # type: ignore return super().get_doc(ignore) finally: self.config.autodoc_inherit_docstrings = orig # type: ignore def add_content(self, more_content: Optional[StringList], no_docstring: bool = False ) -> None: # Disable analyzing attribute comment on Documenter.add_content() to control it on # AttributeDocumenter.add_content() self.analyzer = None if more_content is None: more_content = StringList() self.update_content(more_content) super().add_content(more_content, no_docstring) class PropertyDocumenter(DocstringStripSignatureMixin, ClassLevelDocumenter): # type: ignore """ Specialized Documenter subclass for properties. """ objtype = 'property' member_order = 60 # before AttributeDocumenter priority = AttributeDocumenter.priority + 1 @classmethod def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any ) -> bool: if isinstance(parent, ClassDocumenter): if inspect.isproperty(member): return True else: __dict__ = safe_getattr(parent.object, '__dict__', {}) obj = __dict__.get(membername) return isinstance(obj, classmethod) and inspect.isproperty(obj.__func__) else: return False def import_object(self, raiseerror: bool = False) -> bool: """Check the exisitence of uninitialized instance attribute when failed to import the attribute.""" ret = super().import_object(raiseerror) if ret and not inspect.isproperty(self.object): __dict__ = safe_getattr(self.parent, '__dict__', {}) obj = __dict__.get(self.objpath[-1]) if isinstance(obj, classmethod) and inspect.isproperty(obj.__func__): self.object = obj.__func__ self.isclassmethod = True return True else: return False self.isclassmethod = False return ret def document_members(self, all_members: bool = False) -> None: pass def get_real_modname(self) -> str: real_modname = self.get_attr(self.parent or self.object, '__module__', None) return real_modname or self.modname def add_directive_header(self, sig: str) -> None: super().add_directive_header(sig) sourcename = self.get_sourcename() if inspect.isabstractmethod(self.object): self.add_line(' :abstractmethod:', sourcename) if self.isclassmethod: self.add_line(' :classmethod:', sourcename) if safe_getattr(self.object, 'fget', None): # property func = self.object.fget elif safe_getattr(self.object, 'func', None): # cached_property func = self.object.func else: func = None if func and self.config.autodoc_typehints != 'none': try: signature = inspect.signature(func, type_aliases=self.config.autodoc_type_aliases) if signature.return_annotation is not Parameter.empty: objrepr = stringify_typehint(signature.return_annotation) self.add_line(' :type: ' + objrepr, sourcename) except TypeError as exc: logger.warning(__("Failed to get a function signature for %s: %s"), self.fullname, exc) return None except ValueError: return None class NewTypeAttributeDocumenter(AttributeDocumenter): """ Specialized Documenter subclass for NewTypes. Note: This must be invoked before MethodDocumenter because NewType is a kind of function object. """ objtype = 'newvarattribute' directivetype = 'attribute' priority = MethodDocumenter.priority + 1 @classmethod def can_document_member(cls, member: Any, membername: str, isattr: bool, parent: Any ) -> bool: return not isinstance(parent, ModuleDocumenter) and inspect.isNewType(member) def get_documenters(app: Sphinx) -> Dict[str, Type[Documenter]]: """Returns registered Documenter classes""" warnings.warn("get_documenters() is deprecated.", RemovedInSphinx50Warning, stacklevel=2) return app.registry.documenters def autodoc_attrgetter(app: Sphinx, obj: Any, name: str, *defargs: Any) -> Any: """Alternative getattr() for types""" for typ, func in app.registry.autodoc_attrgettrs.items(): if isinstance(obj, typ): return func(obj, name, *defargs) return safe_getattr(obj, name, *defargs) def migrate_autodoc_member_order(app: Sphinx, config: Config) -> None: if config.autodoc_member_order == 'alphabetic': # RemovedInSphinx50Warning logger.warning(__('autodoc_member_order now accepts "alphabetical" ' 'instead of "alphabetic". Please update your setting.')) config.autodoc_member_order = 'alphabetical' # type: ignore # for compatibility from sphinx.ext.autodoc.deprecated import DataDeclarationDocumenter # NOQA from sphinx.ext.autodoc.deprecated import GenericAliasDocumenter # NOQA from sphinx.ext.autodoc.deprecated import InstanceAttributeDocumenter # NOQA from sphinx.ext.autodoc.deprecated import SingledispatchFunctionDocumenter # NOQA from sphinx.ext.autodoc.deprecated import SingledispatchMethodDocumenter # NOQA from sphinx.ext.autodoc.deprecated import SlotsAttributeDocumenter # NOQA from sphinx.ext.autodoc.deprecated import TypeVarDocumenter # NOQA def setup(app: Sphinx) -> Dict[str, Any]: app.add_autodocumenter(ModuleDocumenter) app.add_autodocumenter(ClassDocumenter) app.add_autodocumenter(ExceptionDocumenter) app.add_autodocumenter(DataDocumenter) app.add_autodocumenter(NewTypeDataDocumenter) app.add_autodocumenter(FunctionDocumenter) app.add_autodocumenter(DecoratorDocumenter) app.add_autodocumenter(MethodDocumenter) app.add_autodocumenter(AttributeDocumenter) app.add_autodocumenter(PropertyDocumenter) app.add_autodocumenter(NewTypeAttributeDocumenter) app.add_config_value('autoclass_content', 'class', True, ENUM('both', 'class', 'init')) app.add_config_value('autodoc_member_order', 'alphabetical', True, ENUM('alphabetic', 'alphabetical', 'bysource', 'groupwise')) app.add_config_value('autodoc_class_signature', 'mixed', True, ENUM('mixed', 'separated')) app.add_config_value('autodoc_default_options', {}, True) app.add_config_value('autodoc_docstring_signature', True, True) app.add_config_value('autodoc_mock_imports', [], True) app.add_config_value('autodoc_typehints', "signature", True, ENUM("signature", "description", "none", "both")) app.add_config_value('autodoc_typehints_description_target', 'all', True, ENUM('all', 'documented')) app.add_config_value('autodoc_type_aliases', {}, True) app.add_config_value('autodoc_warningiserror', True, True) app.add_config_value('autodoc_inherit_docstrings', True, True) app.add_event('autodoc-before-process-signature') app.add_event('autodoc-process-docstring') app.add_event('autodoc-process-signature') app.add_event('autodoc-skip-member') app.add_event('autodoc-process-bases') app.connect('config-inited', migrate_autodoc_member_order, priority=800) app.setup_extension('sphinx.ext.autodoc.preserve_defaults') app.setup_extension('sphinx.ext.autodoc.type_comment') app.setup_extension('sphinx.ext.autodoc.typehints') return {'version': sphinx.__display_version__, 'parallel_read_safe': True} ������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autodoc/deprecated.py�������������������������������������������������������0000644�0000766�0000024�00000010006�00000000000�020551� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.autodoc.deprecated ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The deprecated Documenters for autodoc. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import warnings from typing import Any from sphinx.deprecation import RemovedInSphinx50Warning from sphinx.ext.autodoc import (AttributeDocumenter, DataDocumenter, FunctionDocumenter, MethodDocumenter) class SingledispatchFunctionDocumenter(FunctionDocumenter): """ Used to be a specialized Documenter subclass for singledispatch'ed functions. Retained for backwards compatibility, now does the same as the FunctionDocumenter """ def __init__(self, *args: Any, **kwargs: Any) -> None: warnings.warn("%s is deprecated." % self.__class__.__name__, RemovedInSphinx50Warning, stacklevel=2) super().__init__(*args, **kwargs) class DataDeclarationDocumenter(DataDocumenter): """ Specialized Documenter subclass for data that cannot be imported because they are declared without initial value (refs: PEP-526). """ objtype = 'datadecl' directivetype = 'data' member_order = 60 # must be higher than AttributeDocumenter priority = 11 def __init__(self, *args: Any, **kwargs: Any) -> None: warnings.warn("%s is deprecated." % self.__class__.__name__, RemovedInSphinx50Warning, stacklevel=2) super().__init__(*args, **kwargs) class TypeVarDocumenter(DataDocumenter): """ Specialized Documenter subclass for TypeVars. """ objtype = 'typevar' directivetype = 'data' priority = DataDocumenter.priority + 1 # type: ignore def __init__(self, *args: Any, **kwargs: Any) -> None: warnings.warn("%s is deprecated." % self.__class__.__name__, RemovedInSphinx50Warning, stacklevel=2) super().__init__(*args, **kwargs) class SingledispatchMethodDocumenter(MethodDocumenter): """ Used to be a specialized Documenter subclass for singledispatch'ed methods. Retained for backwards compatibility, now does the same as the MethodDocumenter """ def __init__(self, *args: Any, **kwargs: Any) -> None: warnings.warn("%s is deprecated." % self.__class__.__name__, RemovedInSphinx50Warning, stacklevel=2) super().__init__(*args, **kwargs) class InstanceAttributeDocumenter(AttributeDocumenter): """ Specialized Documenter subclass for attributes that cannot be imported because they are instance attributes (e.g. assigned in __init__). """ objtype = 'instanceattribute' directivetype = 'attribute' member_order = 60 # must be higher than AttributeDocumenter priority = 11 def __init__(self, *args: Any, **kwargs: Any) -> None: warnings.warn("%s is deprecated." % self.__class__.__name__, RemovedInSphinx50Warning, stacklevel=2) super().__init__(*args, **kwargs) class SlotsAttributeDocumenter(AttributeDocumenter): """ Specialized Documenter subclass for attributes that cannot be imported because they are attributes in __slots__. """ objtype = 'slotsattribute' directivetype = 'attribute' member_order = 60 # must be higher than AttributeDocumenter priority = 11 def __init__(self, *args: Any, **kwargs: Any) -> None: warnings.warn("%s is deprecated." % self.__class__.__name__, RemovedInSphinx50Warning, stacklevel=2) super().__init__(*args, **kwargs) class GenericAliasDocumenter(DataDocumenter): """ Specialized Documenter subclass for GenericAliases. """ objtype = 'genericalias' directivetype = 'data' priority = DataDocumenter.priority + 1 # type: ignore def __init__(self, *args: Any, **kwargs: Any) -> None: warnings.warn("%s is deprecated." % self.__class__.__name__, RemovedInSphinx50Warning, stacklevel=2) super().__init__(*args, **kwargs) ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autodoc/directive.py��������������������������������������������������������0000644�0000766�0000024�00000015511�00000000000�020435� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.autodoc.directive ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import warnings from typing import Any, Callable, Dict, List, Set, Type from docutils import nodes from docutils.nodes import Element, Node from docutils.parsers.rst.states import RSTState from docutils.statemachine import StringList from docutils.utils import Reporter, assemble_option_dict from sphinx.config import Config from sphinx.deprecation import RemovedInSphinx50Warning, RemovedInSphinx60Warning from sphinx.environment import BuildEnvironment from sphinx.ext.autodoc import Documenter, Options from sphinx.util import logging from sphinx.util.docutils import SphinxDirective, switch_source_input from sphinx.util.nodes import nested_parse_with_titles logger = logging.getLogger(__name__) # common option names for autodoc directives AUTODOC_DEFAULT_OPTIONS = ['members', 'undoc-members', 'inherited-members', 'show-inheritance', 'private-members', 'special-members', 'ignore-module-all', 'exclude-members', 'member-order', 'imported-members', 'class-doc-from'] AUTODOC_EXTENDABLE_OPTIONS = ['members', 'private-members', 'special-members', 'exclude-members'] class DummyOptionSpec(dict): """An option_spec allows any options.""" def __bool__(self) -> bool: """Behaves like some options are defined.""" return True def __getitem__(self, key: str) -> Callable[[str], str]: return lambda x: x class DocumenterBridge: """A parameters container for Documenters.""" def __init__(self, env: BuildEnvironment, reporter: Reporter, options: Options, lineno: int, state: Any) -> None: self.env = env self._reporter = reporter self.genopt = options self.lineno = lineno self.record_dependencies: Set[str] = set() self.result = StringList() self.state = state def warn(self, msg: str) -> None: warnings.warn('DocumenterBridge.warn is deprecated. Please use sphinx.util.logging ' 'module instead.', RemovedInSphinx60Warning, stacklevel=2) logger.warning(msg, location=(self.env.docname, self.lineno)) @property def filename_set(self) -> Set: warnings.warn('DocumenterBridge.filename_set is deprecated.', RemovedInSphinx60Warning, stacklevel=2) return self.record_dependencies @property def reporter(self) -> Reporter: warnings.warn('DocumenterBridge.reporter is deprecated.', RemovedInSphinx50Warning, stacklevel=2) return self._reporter def process_documenter_options(documenter: Type[Documenter], config: Config, options: Dict ) -> Options: """Recognize options of Documenter from user input.""" for name in AUTODOC_DEFAULT_OPTIONS: if name not in documenter.option_spec: continue else: negated = options.pop('no-' + name, True) is None if name in config.autodoc_default_options and not negated: if name in options and isinstance(config.autodoc_default_options[name], str): # take value from options if present or extend it # with autodoc_default_options if necessary if name in AUTODOC_EXTENDABLE_OPTIONS: if options[name] is not None and options[name].startswith('+'): options[name] = ','.join([config.autodoc_default_options[name], options[name][1:]]) else: options[name] = config.autodoc_default_options[name] elif options.get(name) is not None: # remove '+' from option argument if there's nothing to merge it with options[name] = options[name].lstrip('+') return Options(assemble_option_dict(options.items(), documenter.option_spec)) def parse_generated_content(state: RSTState, content: StringList, documenter: Documenter ) -> List[Node]: """Parse an item of content generated by Documenter.""" with switch_source_input(state, content): if documenter.titles_allowed: node: Element = nodes.section() # necessary so that the child nodes get the right source/line set node.document = state.document nested_parse_with_titles(state, content, node) else: node = nodes.paragraph() node.document = state.document state.nested_parse(content, 0, node) return node.children class AutodocDirective(SphinxDirective): """A directive class for all autodoc directives. It works as a dispatcher of Documenters. It invokes a Documenter upon running. After the processing, it parses and returns the content generated by Documenter. """ option_spec = DummyOptionSpec() has_content = True required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True def run(self) -> List[Node]: reporter = self.state.document.reporter try: source, lineno = reporter.get_source_and_line(self.lineno) # type: ignore except AttributeError: source, lineno = (None, None) logger.debug('[autodoc] %s:%s: input:\n%s', source, lineno, self.block_text) # look up target Documenter objtype = self.name[4:] # strip prefix (auto-). doccls = self.env.app.registry.documenters[objtype] # process the options with the selected documenter's option_spec try: documenter_options = process_documenter_options(doccls, self.config, self.options) except (KeyError, ValueError, TypeError) as exc: # an option is either unknown or has a wrong type logger.error('An option to %s is either unknown or has an invalid value: %s' % (self.name, exc), location=(self.env.docname, lineno)) return [] # generate the output params = DocumenterBridge(self.env, reporter, documenter_options, lineno, self.state) documenter = doccls(params, self.arguments[0]) documenter.generate(more_content=self.content) if not params.result: return [] logger.debug('[autodoc] output:\n%s', '\n'.join(params.result)) # record all filenames as dependencies -- this will at least # partially make automatic invalidation possible for fn in params.record_dependencies: self.state.document.settings.record_dependencies.add(fn) result = parse_generated_content(self.state, params.result, documenter) return result ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autodoc/importer.py���������������������������������������������������������0000644�0000766�0000024�00000026432�00000000000�020324� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.autodoc.importer ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Importer utilities for autodoc :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import importlib import traceback import warnings from typing import Any, Callable, Dict, List, NamedTuple, Optional, Tuple from sphinx.deprecation import RemovedInSphinx50Warning from sphinx.ext.autodoc.mock import ismock, undecorate from sphinx.pycode import ModuleAnalyzer, PycodeError from sphinx.util import logging from sphinx.util.inspect import (getannotations, getmro, getslots, isclass, isenumclass, safe_getattr) if False: # For type annotation from typing import Type # NOQA from sphinx.ext.autodoc import ObjectMember logger = logging.getLogger(__name__) def mangle(subject: Any, name: str) -> str: """Mangle the given name.""" try: if isclass(subject) and name.startswith('__') and not name.endswith('__'): return "_%s%s" % (subject.__name__, name) except AttributeError: pass return name def unmangle(subject: Any, name: str) -> Optional[str]: """Unmangle the given name.""" try: if isclass(subject) and not name.endswith('__'): prefix = "_%s__" % subject.__name__ if name.startswith(prefix): return name.replace(prefix, "__", 1) else: for cls in subject.__mro__: prefix = "_%s__" % cls.__name__ if name.startswith(prefix): # mangled attribute defined in parent class return None except AttributeError: pass return name def import_module(modname: str, warningiserror: bool = False) -> Any: """ Call importlib.import_module(modname), convert exceptions to ImportError """ try: with warnings.catch_warnings(): warnings.filterwarnings("ignore", category=ImportWarning) with logging.skip_warningiserror(not warningiserror): return importlib.import_module(modname) except BaseException as exc: # Importing modules may cause any side effects, including # SystemExit, so we need to catch all errors. raise ImportError(exc, traceback.format_exc()) from exc def import_object(modname: str, objpath: List[str], objtype: str = '', attrgetter: Callable[[Any, str], Any] = safe_getattr, warningiserror: bool = False) -> Any: if objpath: logger.debug('[autodoc] from %s import %s', modname, '.'.join(objpath)) else: logger.debug('[autodoc] import %s', modname) try: module = None exc_on_importing = None objpath = list(objpath) while module is None: try: module = import_module(modname, warningiserror=warningiserror) logger.debug('[autodoc] import %s => %r', modname, module) except ImportError as exc: logger.debug('[autodoc] import %s => failed', modname) exc_on_importing = exc if '.' in modname: # retry with parent module modname, name = modname.rsplit('.', 1) objpath.insert(0, name) else: raise obj = module parent = None object_name = None for attrname in objpath: parent = obj logger.debug('[autodoc] getattr(_, %r)', attrname) mangled_name = mangle(obj, attrname) obj = attrgetter(obj, mangled_name) try: logger.debug('[autodoc] => %r', obj) except TypeError: # fallback of failure on logging for broken object # refs: https://github.com/sphinx-doc/sphinx/issues/9095 logger.debug('[autodoc] => %r', (obj,)) object_name = attrname return [module, parent, object_name, obj] except (AttributeError, ImportError) as exc: if isinstance(exc, AttributeError) and exc_on_importing: # restore ImportError exc = exc_on_importing if objpath: errmsg = ('autodoc: failed to import %s %r from module %r' % (objtype, '.'.join(objpath), modname)) else: errmsg = 'autodoc: failed to import %s %r' % (objtype, modname) if isinstance(exc, ImportError): # import_module() raises ImportError having real exception obj and # traceback real_exc, traceback_msg = exc.args if isinstance(real_exc, SystemExit): errmsg += ('; the module executes module level statement ' 'and it might call sys.exit().') elif isinstance(real_exc, ImportError) and real_exc.args: errmsg += '; the following exception was raised:\n%s' % real_exc.args[0] else: errmsg += '; the following exception was raised:\n%s' % traceback_msg else: errmsg += '; the following exception was raised:\n%s' % traceback.format_exc() logger.debug(errmsg) raise ImportError(errmsg) from exc def get_module_members(module: Any) -> List[Tuple[str, Any]]: """Get members of target module.""" from sphinx.ext.autodoc import INSTANCEATTR warnings.warn('sphinx.ext.autodoc.importer.get_module_members() is deprecated.', RemovedInSphinx50Warning) members: Dict[str, Tuple[str, Any]] = {} for name in dir(module): try: value = safe_getattr(module, name, None) members[name] = (name, value) except AttributeError: continue # annotation only member (ex. attr: int) for name in getannotations(module): if name not in members: members[name] = (name, INSTANCEATTR) return sorted(list(members.values())) class Attribute(NamedTuple): name: str directly_defined: bool value: Any def get_object_members(subject: Any, objpath: List[str], attrgetter: Callable, analyzer: ModuleAnalyzer = None) -> Dict[str, Attribute]: """Get members and attributes of target object.""" from sphinx.ext.autodoc import INSTANCEATTR # the members directly defined in the class obj_dict = attrgetter(subject, '__dict__', {}) members: Dict[str, Attribute] = {} # enum members if isenumclass(subject): for name, value in subject.__members__.items(): if name not in members: members[name] = Attribute(name, True, value) superclass = subject.__mro__[1] for name in obj_dict: if name not in superclass.__dict__: value = safe_getattr(subject, name) members[name] = Attribute(name, True, value) # members in __slots__ try: __slots__ = getslots(subject) if __slots__: from sphinx.ext.autodoc import SLOTSATTR for name in __slots__: members[name] = Attribute(name, True, SLOTSATTR) except (TypeError, ValueError): pass # other members for name in dir(subject): try: value = attrgetter(subject, name) directly_defined = name in obj_dict name = unmangle(subject, name) if name and name not in members: members[name] = Attribute(name, directly_defined, value) except AttributeError: continue # annotation only member (ex. attr: int) for i, cls in enumerate(getmro(subject)): for name in getannotations(cls): name = unmangle(cls, name) if name and name not in members: members[name] = Attribute(name, i == 0, INSTANCEATTR) if analyzer: # append instance attributes (cf. self.attr1) if analyzer knows namespace = '.'.join(objpath) for (ns, name) in analyzer.find_attr_docs(): if namespace == ns and name not in members: members[name] = Attribute(name, True, INSTANCEATTR) return members def get_class_members(subject: Any, objpath: List[str], attrgetter: Callable ) -> Dict[str, "ObjectMember"]: """Get members and attributes of target class.""" from sphinx.ext.autodoc import INSTANCEATTR, ObjectMember # the members directly defined in the class obj_dict = attrgetter(subject, '__dict__', {}) members: Dict[str, ObjectMember] = {} # enum members if isenumclass(subject): for name, value in subject.__members__.items(): if name not in members: members[name] = ObjectMember(name, value, class_=subject) superclass = subject.__mro__[1] for name in obj_dict: if name not in superclass.__dict__: value = safe_getattr(subject, name) members[name] = ObjectMember(name, value, class_=subject) # members in __slots__ try: __slots__ = getslots(subject) if __slots__: from sphinx.ext.autodoc import SLOTSATTR for name, docstring in __slots__.items(): members[name] = ObjectMember(name, SLOTSATTR, class_=subject, docstring=docstring) except (TypeError, ValueError): pass # other members for name in dir(subject): try: value = attrgetter(subject, name) if ismock(value): value = undecorate(value) unmangled = unmangle(subject, name) if unmangled and unmangled not in members: if name in obj_dict: members[unmangled] = ObjectMember(unmangled, value, class_=subject) else: members[unmangled] = ObjectMember(unmangled, value) except AttributeError: continue try: for cls in getmro(subject): try: modname = safe_getattr(cls, '__module__') qualname = safe_getattr(cls, '__qualname__') analyzer = ModuleAnalyzer.for_module(modname) analyzer.analyze() except AttributeError: qualname = None analyzer = None except PycodeError: analyzer = None # annotation only member (ex. attr: int) for name in getannotations(cls): name = unmangle(cls, name) if name and name not in members: if analyzer and (qualname, name) in analyzer.attr_docs: docstring = '\n'.join(analyzer.attr_docs[qualname, name]) else: docstring = None members[name] = ObjectMember(name, INSTANCEATTR, class_=cls, docstring=docstring) # append instance attributes (cf. self.attr1) if analyzer knows if analyzer: for (ns, name), docstring in analyzer.attr_docs.items(): if ns == qualname and name not in members: members[name] = ObjectMember(name, INSTANCEATTR, class_=cls, docstring='\n'.join(docstring)) except AttributeError: pass return members ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autodoc/mock.py�������������������������������������������������������������0000644�0000766�0000024�00000013024�00000000000�017405� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.autodoc.mock ~~~~~~~~~~~~~~~~~~~~~~~ mock for autodoc :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import contextlib import os import sys from importlib.abc import Loader, MetaPathFinder from importlib.machinery import ModuleSpec from types import ModuleType from typing import Any, Generator, Iterator, List, Optional, Sequence, Tuple, Union from sphinx.util import logging from sphinx.util.inspect import safe_getattr logger = logging.getLogger(__name__) class _MockObject: """Used by autodoc_mock_imports.""" __display_name__ = '_MockObject' __name__ = '' __sphinx_mock__ = True __sphinx_decorator_args__: Tuple[Any, ...] = () def __new__(cls, *args: Any, **kwargs: Any) -> Any: if len(args) == 3 and isinstance(args[1], tuple): superclass = args[1][-1].__class__ if superclass is cls: # subclassing MockObject return _make_subclass(args[0], superclass.__display_name__, superclass=superclass, attributes=args[2]) return super().__new__(cls) def __init__(self, *args: Any, **kwargs: Any) -> None: self.__qualname__ = self.__name__ def __len__(self) -> int: return 0 def __contains__(self, key: str) -> bool: return False def __iter__(self) -> Iterator: return iter([]) def __mro_entries__(self, bases: Tuple) -> Tuple: return (self.__class__,) def __getitem__(self, key: Any) -> "_MockObject": return _make_subclass(str(key), self.__display_name__, self.__class__)() def __getattr__(self, key: str) -> "_MockObject": return _make_subclass(key, self.__display_name__, self.__class__)() def __call__(self, *args: Any, **kwargs: Any) -> Any: call = self.__class__() call.__sphinx_decorator_args__ = args return call def __repr__(self) -> str: return self.__display_name__ def _make_subclass(name: str, module: str, superclass: Any = _MockObject, attributes: Any = None, decorator_args: Tuple = ()) -> Any: attrs = {'__module__': module, '__display_name__': module + '.' + name, '__name__': name, '__sphinx_decorator_args__': decorator_args} attrs.update(attributes or {}) return type(name, (superclass,), attrs) class _MockModule(ModuleType): """Used by autodoc_mock_imports.""" __file__ = os.devnull __sphinx_mock__ = True def __init__(self, name: str) -> None: super().__init__(name) self.__all__: List[str] = [] self.__path__: List[str] = [] def __getattr__(self, name: str) -> _MockObject: return _make_subclass(name, self.__name__)() def __repr__(self) -> str: return self.__name__ class MockLoader(Loader): """A loader for mocking.""" def __init__(self, finder: "MockFinder") -> None: super().__init__() self.finder = finder def create_module(self, spec: ModuleSpec) -> ModuleType: logger.debug('[autodoc] adding a mock module as %s!', spec.name) self.finder.mocked_modules.append(spec.name) return _MockModule(spec.name) def exec_module(self, module: ModuleType) -> None: pass # nothing to do class MockFinder(MetaPathFinder): """A finder for mocking.""" def __init__(self, modnames: List[str]) -> None: super().__init__() self.modnames = modnames self.loader = MockLoader(self) self.mocked_modules: List[str] = [] def find_spec(self, fullname: str, path: Optional[Sequence[Union[bytes, str]]], target: ModuleType = None) -> Optional[ModuleSpec]: for modname in self.modnames: # check if fullname is (or is a descendant of) one of our targets if modname == fullname or fullname.startswith(modname + '.'): return ModuleSpec(fullname, self.loader) return None def invalidate_caches(self) -> None: """Invalidate mocked modules on sys.modules.""" for modname in self.mocked_modules: sys.modules.pop(modname, None) @contextlib.contextmanager def mock(modnames: List[str]) -> Generator[None, None, None]: """Insert mock modules during context:: with mock(['target.module.name']): # mock modules are enabled here ... """ try: finder = MockFinder(modnames) sys.meta_path.insert(0, finder) yield finally: sys.meta_path.remove(finder) finder.invalidate_caches() def ismock(subject: Any) -> bool: """Check if the object is mocked.""" # check the object has '__sphinx_mock__' attribute try: if safe_getattr(subject, '__sphinx_mock__', None) is None: return False except AttributeError: return False # check the object is mocked module if isinstance(subject, _MockModule): return True try: # check the object is mocked object __mro__ = safe_getattr(type(subject), '__mro__', []) if len(__mro__) > 2 and __mro__[1] is _MockObject: return True except AttributeError: pass return False def undecorate(subject: _MockObject) -> Any: """Unwrap mock if *subject* is decorated by mocked object. If not decorated, returns given *subject* itself. """ if ismock(subject) and subject.__sphinx_decorator_args__: return subject.__sphinx_decorator_args__[0] else: return subject ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1638029278.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autodoc/preserve_defaults.py������������������������������������������������0000644�0000766�0000024�00000010274�00000000000�022202� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.autodoc.preserve_defaults ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Preserve the default argument values of function signatures in source code and keep them not evaluated for readability. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import ast import inspect import sys from typing import Any, Dict, List, Optional from sphinx.application import Sphinx from sphinx.locale import __ from sphinx.pycode.ast import parse as ast_parse from sphinx.pycode.ast import unparse as ast_unparse from sphinx.util import logging logger = logging.getLogger(__name__) class DefaultValue: def __init__(self, name: str) -> None: self.name = name def __repr__(self) -> str: return self.name def get_function_def(obj: Any) -> ast.FunctionDef: """Get FunctionDef object from living object. This tries to parse original code for living object and returns AST node for given *obj*. """ try: source = inspect.getsource(obj) if source.startswith((' ', r'\t')): # subject is placed inside class or block. To read its docstring, # this adds if-block before the declaration. module = ast_parse('if True:\n' + source) return module.body[0].body[0] # type: ignore else: module = ast_parse(source) return module.body[0] # type: ignore except (OSError, TypeError): # failed to load source code return None def get_default_value(lines: List[str], position: ast.AST) -> Optional[str]: try: if sys.version_info < (3, 8): # only for py38+ return None elif position.lineno == position.end_lineno: line = lines[position.lineno - 1] return line[position.col_offset:position.end_col_offset] else: # multiline value is not supported now return None except (AttributeError, IndexError): return None def update_defvalue(app: Sphinx, obj: Any, bound_method: bool) -> None: """Update defvalue info of *obj* using type_comments.""" if not app.config.autodoc_preserve_defaults: return try: lines = inspect.getsource(obj).splitlines() if lines[0].startswith((' ', r'\t')): lines.insert(0, '') # insert a dummy line to follow what get_function_def() does. except (OSError, TypeError): lines = [] try: function = get_function_def(obj) if function.args.defaults or function.args.kw_defaults: sig = inspect.signature(obj) defaults = list(function.args.defaults) kw_defaults = list(function.args.kw_defaults) parameters = list(sig.parameters.values()) for i, param in enumerate(parameters): if param.default is not param.empty: if param.kind in (param.POSITIONAL_ONLY, param.POSITIONAL_OR_KEYWORD): default = defaults.pop(0) value = get_default_value(lines, default) if value is None: value = ast_unparse(default) # type: ignore parameters[i] = param.replace(default=DefaultValue(value)) else: default = kw_defaults.pop(0) value = get_default_value(lines, default) if value is None: value = ast_unparse(default) # type: ignore parameters[i] = param.replace(default=DefaultValue(value)) sig = sig.replace(parameters=parameters) obj.__signature__ = sig except (AttributeError, TypeError): # failed to update signature (ex. built-in or extension types) pass except NotImplementedError as exc: # failed to ast.unparse() logger.warning(__("Failed to parse a default argument value for %r: %s"), obj, exc) def setup(app: Sphinx) -> Dict[str, Any]: app.add_config_value('autodoc_preserve_defaults', False, True) app.connect('autodoc-before-process-signature', update_defvalue) return { 'version': '1.0', 'parallel_read_safe': True } ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autodoc/type_comment.py�����������������������������������������������������0000644�0000766�0000024�00000012762�00000000000�021167� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.autodoc.type_comment ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Update annotations info of living objects using type_comments. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from inspect import Parameter, Signature, getsource from typing import Any, Dict, List, cast import sphinx from sphinx.application import Sphinx from sphinx.locale import __ from sphinx.pycode.ast import ast from sphinx.pycode.ast import parse as ast_parse from sphinx.pycode.ast import unparse as ast_unparse from sphinx.util import inspect, logging logger = logging.getLogger(__name__) def not_suppressed(argtypes: List[ast.AST] = []) -> bool: """Check given *argtypes* is suppressed type_comment or not.""" if len(argtypes) == 0: # no argtypees return False elif len(argtypes) == 1 and ast_unparse(argtypes[0]) == "...": # suppressed # Note: To support multiple versions of python, this uses ``ast_unparse()`` for # comparison with Ellipsis. Since 3.8, ast.Constant has been used to represent # Ellipsis node instead of ast.Ellipsis. return False else: # not suppressed return True def signature_from_ast(node: ast.FunctionDef, bound_method: bool, type_comment: ast.FunctionDef) -> Signature: """Return a Signature object for the given *node*. :param bound_method: Specify *node* is a bound method or not """ params = [] if hasattr(node.args, "posonlyargs"): # for py38+ for arg in node.args.posonlyargs: # type: ignore param = Parameter(arg.arg, Parameter.POSITIONAL_ONLY, annotation=arg.type_comment) params.append(param) for arg in node.args.args: param = Parameter(arg.arg, Parameter.POSITIONAL_OR_KEYWORD, annotation=arg.type_comment or Parameter.empty) params.append(param) if node.args.vararg: param = Parameter(node.args.vararg.arg, Parameter.VAR_POSITIONAL, annotation=node.args.vararg.type_comment or Parameter.empty) params.append(param) for arg in node.args.kwonlyargs: param = Parameter(arg.arg, Parameter.KEYWORD_ONLY, annotation=arg.type_comment or Parameter.empty) params.append(param) if node.args.kwarg: param = Parameter(node.args.kwarg.arg, Parameter.VAR_KEYWORD, annotation=node.args.kwarg.type_comment or Parameter.empty) params.append(param) # Remove first parameter when *obj* is bound_method if bound_method and params: params.pop(0) # merge type_comment into signature if not_suppressed(type_comment.argtypes): # type: ignore for i, param in enumerate(params): params[i] = param.replace(annotation=type_comment.argtypes[i]) # type: ignore if node.returns: return Signature(params, return_annotation=node.returns) elif type_comment.returns: return Signature(params, return_annotation=ast_unparse(type_comment.returns)) else: return Signature(params) def get_type_comment(obj: Any, bound_method: bool = False) -> Signature: """Get type_comment'ed FunctionDef object from living object. This tries to parse original code for living object and returns Signature for given *obj*. It requires py38+ or typed_ast module. """ try: source = getsource(obj) if source.startswith((' ', r'\t')): # subject is placed inside class or block. To read its docstring, # this adds if-block before the declaration. module = ast_parse('if True:\n' + source) subject = cast(ast.FunctionDef, module.body[0].body[0]) # type: ignore else: module = ast_parse(source) subject = cast(ast.FunctionDef, module.body[0]) # type: ignore if getattr(subject, "type_comment", None): function = ast_parse(subject.type_comment, mode='func_type') return signature_from_ast(subject, bound_method, function) # type: ignore else: return None except (OSError, TypeError): # failed to load source code return None except SyntaxError: # failed to parse type_comments return None def update_annotations_using_type_comments(app: Sphinx, obj: Any, bound_method: bool) -> None: """Update annotations info of *obj* using type_comments.""" try: type_sig = get_type_comment(obj, bound_method) if type_sig: sig = inspect.signature(obj, bound_method) for param in sig.parameters.values(): if param.name not in obj.__annotations__: annotation = type_sig.parameters[param.name].annotation if annotation is not Parameter.empty: obj.__annotations__[param.name] = ast_unparse(annotation) if 'return' not in obj.__annotations__: obj.__annotations__['return'] = type_sig.return_annotation except KeyError as exc: logger.warning(__("Failed to update signature for %r: parameter not found: %s"), obj, exc) except NotImplementedError as exc: # failed to ast.unparse() logger.warning(__("Failed to parse type_comment for %r: %s"), obj, exc) def setup(app: Sphinx) -> Dict[str, Any]: app.connect('autodoc-before-process-signature', update_annotations_using_type_comments) return {'version': sphinx.__display_version__, 'parallel_read_safe': True} ��������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autodoc/typehints.py��������������������������������������������������������0000644�0000766�0000024�00000015025�00000000000�020506� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.autodoc.typehints ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Generating content for autodoc using typehints :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import re from collections import OrderedDict from typing import Any, Dict, Iterable, Set, cast from docutils import nodes from docutils.nodes import Element from sphinx import addnodes from sphinx.application import Sphinx from sphinx.util import inspect, typing def record_typehints(app: Sphinx, objtype: str, name: str, obj: Any, options: Dict, args: str, retann: str) -> None: """Record type hints to env object.""" try: if callable(obj): annotations = app.env.temp_data.setdefault('annotations', {}) annotation = annotations.setdefault(name, OrderedDict()) sig = inspect.signature(obj, type_aliases=app.config.autodoc_type_aliases) for param in sig.parameters.values(): if param.annotation is not param.empty: annotation[param.name] = typing.stringify(param.annotation) if sig.return_annotation is not sig.empty: annotation['return'] = typing.stringify(sig.return_annotation) except (TypeError, ValueError): pass def merge_typehints(app: Sphinx, domain: str, objtype: str, contentnode: Element) -> None: if domain != 'py': return if app.config.autodoc_typehints not in ('both', 'description'): return try: signature = cast(addnodes.desc_signature, contentnode.parent[0]) if signature['module']: fullname = '.'.join([signature['module'], signature['fullname']]) else: fullname = signature['fullname'] except KeyError: # signature node does not have valid context info for the target object return annotations = app.env.temp_data.get('annotations', {}) if annotations.get(fullname, {}): field_lists = [n for n in contentnode if isinstance(n, nodes.field_list)] if field_lists == []: field_list = insert_field_list(contentnode) field_lists.append(field_list) for field_list in field_lists: if app.config.autodoc_typehints_description_target == "all": modify_field_list(field_list, annotations[fullname]) else: augment_descriptions_with_types(field_list, annotations[fullname]) def insert_field_list(node: Element) -> nodes.field_list: field_list = nodes.field_list() desc = [n for n in node if isinstance(n, addnodes.desc)] if desc: # insert just before sub object descriptions (ex. methods, nested classes, etc.) index = node.index(desc[0]) node.insert(index - 1, [field_list]) else: node += field_list return field_list def modify_field_list(node: nodes.field_list, annotations: Dict[str, str]) -> None: arguments: Dict[str, Dict[str, bool]] = {} fields = cast(Iterable[nodes.field], node) for field in fields: field_name = field[0].astext() parts = re.split(' +', field_name) if parts[0] == 'param': if len(parts) == 2: # :param xxx: arg = arguments.setdefault(parts[1], {}) arg['param'] = True elif len(parts) > 2: # :param xxx yyy: name = ' '.join(parts[2:]) arg = arguments.setdefault(name, {}) arg['param'] = True arg['type'] = True elif parts[0] == 'type': name = ' '.join(parts[1:]) arg = arguments.setdefault(name, {}) arg['type'] = True elif parts[0] == 'rtype': arguments['return'] = {'type': True} for name, annotation in annotations.items(): if name == 'return': continue arg = arguments.get(name, {}) if not arg.get('type'): field = nodes.field() field += nodes.field_name('', 'type ' + name) field += nodes.field_body('', nodes.paragraph('', annotation)) node += field if not arg.get('param'): field = nodes.field() field += nodes.field_name('', 'param ' + name) field += nodes.field_body('', nodes.paragraph('', '')) node += field if 'return' in annotations and 'return' not in arguments: field = nodes.field() field += nodes.field_name('', 'rtype') field += nodes.field_body('', nodes.paragraph('', annotation)) node += field def augment_descriptions_with_types( node: nodes.field_list, annotations: Dict[str, str], ) -> None: fields = cast(Iterable[nodes.field], node) has_description = set() # type: Set[str] has_type = set() # type: Set[str] for field in fields: field_name = field[0].astext() parts = re.split(' +', field_name) if parts[0] == 'param': if len(parts) == 2: # :param xxx: has_description.add(parts[1]) elif len(parts) > 2: # :param xxx yyy: name = ' '.join(parts[2:]) has_description.add(name) has_type.add(name) elif parts[0] == 'type': name = ' '.join(parts[1:]) has_type.add(name) elif parts[0] in ('return', 'returns'): has_description.add('return') elif parts[0] == 'rtype': has_type.add('return') # Add 'type' for parameters with a description but no declared type. for name in annotations: if name in ('return', 'returns'): continue if name in has_description and name not in has_type: field = nodes.field() field += nodes.field_name('', 'type ' + name) field += nodes.field_body('', nodes.paragraph('', annotations[name])) node += field # Add 'rtype' if 'return' is present and 'rtype' isn't. if 'return' in annotations: if 'return' in has_description and 'return' not in has_type: field = nodes.field() field += nodes.field_name('', 'rtype') field += nodes.field_body('', nodes.paragraph('', annotations['return'])) node += field def setup(app: Sphinx) -> Dict[str, Any]: app.connect('autodoc-process-signature', record_typehints) app.connect('object-description-transform', merge_typehints) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autosectionlabel.py���������������������������������������������������������0000644�0000766�0000024�00000004300�00000000000�020350� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.autosectionlabel ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Allow reference sections by :ref: role using its title. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Any, Dict, cast from docutils import nodes from docutils.nodes import Node from sphinx.application import Sphinx from sphinx.domains.std import StandardDomain from sphinx.locale import __ from sphinx.util import logging from sphinx.util.nodes import clean_astext logger = logging.getLogger(__name__) def get_node_depth(node: Node) -> int: i = 0 cur_node = node while cur_node.parent != node.document: cur_node = cur_node.parent i += 1 return i def register_sections_as_label(app: Sphinx, document: Node) -> None: domain = cast(StandardDomain, app.env.get_domain('std')) for node in document.traverse(nodes.section): if (app.config.autosectionlabel_maxdepth and get_node_depth(node) >= app.config.autosectionlabel_maxdepth): continue labelid = node['ids'][0] docname = app.env.docname title = cast(nodes.title, node[0]) ref_name = getattr(title, 'rawsource', title.astext()) if app.config.autosectionlabel_prefix_document: name = nodes.fully_normalize_name(docname + ':' + ref_name) else: name = nodes.fully_normalize_name(ref_name) sectname = clean_astext(title) if name in domain.labels: logger.warning(__('duplicate label %s, other instance in %s'), name, app.env.doc2path(domain.labels[name][0]), location=node, type='autosectionlabel', subtype=docname) domain.anonlabels[name] = docname, labelid domain.labels[name] = docname, labelid, sectname def setup(app: Sphinx) -> Dict[str, Any]: app.add_config_value('autosectionlabel_prefix_document', False, 'env') app.add_config_value('autosectionlabel_maxdepth', None, 'env') app.connect('doctree-read', register_sections_as_label) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4639423 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autosummary/����������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017032� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autosummary/__init__.py�����������������������������������������������������0000644�0000766�0000024�00000074031�00000000000�021150� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.autosummary ~~~~~~~~~~~~~~~~~~~~~~ Sphinx extension that adds an autosummary:: directive, which can be used to generate function/method/attribute/etc. summary lists, similar to those output eg. by Epydoc and other API doc generation tools. An :autolink: role is also provided. autosummary directive --------------------- The autosummary directive has the form:: .. autosummary:: :nosignatures: :toctree: generated/ module.function_1 module.function_2 ... and it generates an output table (containing signatures, optionally) ======================== ============================================= module.function_1(args) Summary line from the docstring of function_1 module.function_2(args) Summary line from the docstring ... ======================== ============================================= If the :toctree: option is specified, files matching the function names are inserted to the toctree with the given prefix: generated/module.function_1 generated/module.function_2 ... Note: The file names contain the module:: or currentmodule:: prefixes. .. seealso:: autosummary_generate.py autolink role ------------- The autolink role functions as ``:obj:`` when the name referred can be resolved to a Python object, and otherwise it becomes simple emphasis. This can be used as the default role to make links 'smart'. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import inspect import os import posixpath import re import sys import warnings from inspect import Parameter from os import path from types import ModuleType from typing import Any, Dict, List, Optional, Tuple, Type, cast from docutils import nodes from docutils.nodes import Element, Node, system_message from docutils.parsers.rst import directives from docutils.parsers.rst.states import RSTStateMachine, Struct, state_classes from docutils.statemachine import StringList import sphinx from sphinx import addnodes from sphinx.application import Sphinx from sphinx.config import Config from sphinx.deprecation import (RemovedInSphinx50Warning, RemovedInSphinx60Warning, deprecated_alias) from sphinx.environment import BuildEnvironment from sphinx.environment.adapters.toctree import TocTree from sphinx.ext.autodoc import INSTANCEATTR, Documenter from sphinx.ext.autodoc.directive import DocumenterBridge, Options from sphinx.ext.autodoc.importer import import_module from sphinx.ext.autodoc.mock import mock from sphinx.locale import __ from sphinx.project import Project from sphinx.pycode import ModuleAnalyzer, PycodeError from sphinx.registry import SphinxComponentRegistry from sphinx.util import logging, rst from sphinx.util.docutils import (NullReporter, SphinxDirective, SphinxRole, new_document, switch_source_input) from sphinx.util.inspect import signature_from_str from sphinx.util.matching import Matcher from sphinx.util.typing import OptionSpec from sphinx.writers.html import HTMLTranslator logger = logging.getLogger(__name__) periods_re = re.compile(r'\.(?:\s+)') literal_re = re.compile(r'::\s*$') WELL_KNOWN_ABBREVIATIONS = ('et al.', ' i.e.',) # -- autosummary_toc node ------------------------------------------------------ class autosummary_toc(nodes.comment): pass def process_autosummary_toc(app: Sphinx, doctree: nodes.document) -> None: """Insert items described in autosummary:: to the TOC tree, but do not generate the toctree:: list. """ warnings.warn('process_autosummary_toc() is deprecated', RemovedInSphinx50Warning, stacklevel=2) env = app.builder.env crawled = {} def crawl_toc(node: Element, depth: int = 1) -> None: crawled[node] = True for j, subnode in enumerate(node): try: if (isinstance(subnode, autosummary_toc) and isinstance(subnode[0], addnodes.toctree)): TocTree(env).note(env.docname, subnode[0]) continue except IndexError: continue if not isinstance(subnode, nodes.section): continue if subnode not in crawled: crawl_toc(subnode, depth + 1) crawl_toc(doctree) def autosummary_toc_visit_html(self: nodes.NodeVisitor, node: autosummary_toc) -> None: """Hide autosummary toctree list in HTML output.""" raise nodes.SkipNode def autosummary_noop(self: nodes.NodeVisitor, node: Node) -> None: pass # -- autosummary_table node ---------------------------------------------------- class autosummary_table(nodes.comment): pass def autosummary_table_visit_html(self: HTMLTranslator, node: autosummary_table) -> None: """Make the first column of the table non-breaking.""" try: table = cast(nodes.table, node[0]) tgroup = cast(nodes.tgroup, table[0]) tbody = cast(nodes.tbody, tgroup[-1]) rows = cast(List[nodes.row], tbody) for row in rows: col1_entry = cast(nodes.entry, row[0]) par = cast(nodes.paragraph, col1_entry[0]) for j, subnode in enumerate(list(par)): if isinstance(subnode, nodes.Text): new_text = subnode.astext().replace(" ", "\u00a0") par[j] = nodes.Text(new_text) except IndexError: pass # -- autodoc integration ------------------------------------------------------- deprecated_alias('sphinx.ext.autosummary', { '_app': None, }, RemovedInSphinx60Warning, { }) class FakeApplication: def __init__(self): self.doctreedir = None self.events = None self.extensions = {} self.srcdir = None self.config = Config() self.project = Project(None, None) self.registry = SphinxComponentRegistry() class FakeDirective(DocumenterBridge): def __init__(self) -> None: settings = Struct(tab_width=8) document = Struct(settings=settings) app = FakeApplication() app.config.add('autodoc_class_signature', 'mixed', True, None) env = BuildEnvironment(app) # type: ignore state = Struct(document=document) super().__init__(env, None, Options(), 0, state) def get_documenter(app: Sphinx, obj: Any, parent: Any) -> Type[Documenter]: """Get an autodoc.Documenter class suitable for documenting the given object. *obj* is the Python object to be documented, and *parent* is an another Python object (e.g. a module or a class) to which *obj* belongs to. """ from sphinx.ext.autodoc import DataDocumenter, ModuleDocumenter if inspect.ismodule(obj): # ModuleDocumenter.can_document_member always returns False return ModuleDocumenter # Construct a fake documenter for *parent* if parent is not None: parent_doc_cls = get_documenter(app, parent, None) else: parent_doc_cls = ModuleDocumenter if hasattr(parent, '__name__'): parent_doc = parent_doc_cls(FakeDirective(), parent.__name__) else: parent_doc = parent_doc_cls(FakeDirective(), "") # Get the correct documenter class for *obj* classes = [cls for cls in app.registry.documenters.values() if cls.can_document_member(obj, '', False, parent_doc)] if classes: classes.sort(key=lambda cls: cls.priority) return classes[-1] else: return DataDocumenter # -- .. autosummary:: ---------------------------------------------------------- class Autosummary(SphinxDirective): """ Pretty table containing short signatures and summaries of functions etc. autosummary can also optionally generate a hidden toctree:: node. """ required_arguments = 0 optional_arguments = 0 final_argument_whitespace = False has_content = True option_spec: OptionSpec = { 'caption': directives.unchanged_required, 'toctree': directives.unchanged, 'nosignatures': directives.flag, 'recursive': directives.flag, 'template': directives.unchanged, } def run(self) -> List[Node]: self.bridge = DocumenterBridge(self.env, self.state.document.reporter, Options(), self.lineno, self.state) names = [x.strip().split()[0] for x in self.content if x.strip() and re.search(r'^[~a-zA-Z_]', x.strip()[0])] items = self.get_items(names) nodes = self.get_table(items) if 'toctree' in self.options: dirname = posixpath.dirname(self.env.docname) tree_prefix = self.options['toctree'].strip() docnames = [] excluded = Matcher(self.config.exclude_patterns) filename_map = self.config.autosummary_filename_map for name, sig, summary, real_name in items: real_name = filename_map.get(real_name, real_name) docname = posixpath.join(tree_prefix, real_name) docname = posixpath.normpath(posixpath.join(dirname, docname)) if docname not in self.env.found_docs: if excluded(self.env.doc2path(docname, None)): msg = __('autosummary references excluded document %r. Ignored.') else: msg = __('autosummary: stub file not found %r. ' 'Check your autosummary_generate setting.') logger.warning(msg, real_name, location=self.get_location()) continue docnames.append(docname) if docnames: tocnode = addnodes.toctree() tocnode['includefiles'] = docnames tocnode['entries'] = [(None, docn) for docn in docnames] tocnode['maxdepth'] = -1 tocnode['glob'] = None tocnode['caption'] = self.options.get('caption') nodes.append(autosummary_toc('', '', tocnode)) if 'toctree' not in self.options and 'caption' in self.options: logger.warning(__('A captioned autosummary requires :toctree: option. ignored.'), location=nodes[-1]) return nodes def import_by_name(self, name: str, prefixes: List[str]) -> Tuple[str, Any, Any, str]: with mock(self.config.autosummary_mock_imports): try: return import_by_name(name, prefixes) except ImportError as exc: # check existence of instance attribute try: return import_ivar_by_name(name, prefixes) except ImportError: pass raise exc # re-raise ImportError if instance attribute not found def create_documenter(self, app: Sphinx, obj: Any, parent: Any, full_name: str) -> "Documenter": """Get an autodoc.Documenter class suitable for documenting the given object. Wraps get_documenter and is meant as a hook for extensions. """ doccls = get_documenter(app, obj, parent) return doccls(self.bridge, full_name) def get_items(self, names: List[str]) -> List[Tuple[str, str, str, str]]: """Try to import the given names, and return a list of ``[(name, signature, summary_string, real_name), ...]``. """ prefixes = get_import_prefixes_from_env(self.env) items: List[Tuple[str, str, str, str]] = [] max_item_chars = 50 for name in names: display_name = name if name.startswith('~'): name = name[1:] display_name = name.split('.')[-1] try: real_name, obj, parent, modname = self.import_by_name(name, prefixes=prefixes) except ImportError: logger.warning(__('autosummary: failed to import %s'), name, location=self.get_location()) continue self.bridge.result = StringList() # initialize for each documenter full_name = real_name if not isinstance(obj, ModuleType): # give explicitly separated module name, so that members # of inner classes can be documented full_name = modname + '::' + full_name[len(modname) + 1:] # NB. using full_name here is important, since Documenters # handle module prefixes slightly differently documenter = self.create_documenter(self.env.app, obj, parent, full_name) if not documenter.parse_name(): logger.warning(__('failed to parse name %s'), real_name, location=self.get_location()) items.append((display_name, '', '', real_name)) continue if not documenter.import_object(): logger.warning(__('failed to import object %s'), real_name, location=self.get_location()) items.append((display_name, '', '', real_name)) continue if documenter.options.members and not documenter.check_module(): continue # try to also get a source code analyzer for attribute docs try: documenter.analyzer = ModuleAnalyzer.for_module( documenter.get_real_modname()) # parse right now, to get PycodeErrors on parsing (results will # be cached anyway) documenter.analyzer.find_attr_docs() except PycodeError as err: logger.debug('[autodoc] module analyzer failed: %s', err) # no source file -- e.g. for builtin and C modules documenter.analyzer = None # -- Grab the signature try: sig = documenter.format_signature(show_annotation=False) except TypeError: # the documenter does not support ``show_annotation`` option sig = documenter.format_signature() if not sig: sig = '' else: max_chars = max(10, max_item_chars - len(display_name)) sig = mangle_signature(sig, max_chars=max_chars) # -- Grab the summary documenter.add_content(None) summary = extract_summary(self.bridge.result.data[:], self.state.document) items.append((display_name, sig, summary, real_name)) return items def get_table(self, items: List[Tuple[str, str, str, str]]) -> List[Node]: """Generate a proper list of table nodes for autosummary:: directive. *items* is a list produced by :meth:`get_items`. """ table_spec = addnodes.tabular_col_spec() table_spec['spec'] = r'\X{1}{2}\X{1}{2}' table = autosummary_table('') real_table = nodes.table('', classes=['longtable']) table.append(real_table) group = nodes.tgroup('', cols=2) real_table.append(group) group.append(nodes.colspec('', colwidth=10)) group.append(nodes.colspec('', colwidth=90)) body = nodes.tbody('') group.append(body) def append_row(*column_texts: str) -> None: row = nodes.row('') source, line = self.state_machine.get_source_and_line() for text in column_texts: node = nodes.paragraph('') vl = StringList() vl.append(text, '%s:%d:<autosummary>' % (source, line)) with switch_source_input(self.state, vl): self.state.nested_parse(vl, 0, node) try: if isinstance(node[0], nodes.paragraph): node = node[0] except IndexError: pass row.append(nodes.entry('', node)) body.append(row) for name, sig, summary, real_name in items: qualifier = 'obj' if 'nosignatures' not in self.options: col1 = ':py:%s:`%s <%s>`\\ %s' % (qualifier, name, real_name, rst.escape(sig)) else: col1 = ':py:%s:`%s <%s>`' % (qualifier, name, real_name) col2 = summary append_row(col1, col2) return [table_spec, table] def strip_arg_typehint(s: str) -> str: """Strip a type hint from argument definition.""" return s.split(':')[0].strip() def _cleanup_signature(s: str) -> str: """Clean up signature using inspect.signautre() for mangle_signature()""" try: sig = signature_from_str(s) parameters = list(sig.parameters.values()) for i, param in enumerate(parameters): if param.annotation is not Parameter.empty: # Remove typehints param = param.replace(annotation=Parameter.empty) if param.default is not Parameter.empty: # Replace default value by "None" param = param.replace(default=None) parameters[i] = param sig = sig.replace(parameters=parameters, return_annotation=Parameter.empty) return str(sig) except Exception: # Return the original signature string if failed to clean (ex. parsing error) return s def mangle_signature(sig: str, max_chars: int = 30) -> str: """Reformat a function signature to a more compact form.""" s = _cleanup_signature(sig) # Strip return type annotation s = re.sub(r"\)\s*->\s.*$", ")", s) # Remove parenthesis s = re.sub(r"^\((.*)\)$", r"\1", s).strip() # Strip literals (which can contain things that confuse the code below) s = re.sub(r"\\\\", "", s) # escaped backslash (maybe inside string) s = re.sub(r"\\'", "", s) # escaped single quote s = re.sub(r'\\"', "", s) # escaped double quote s = re.sub(r"'[^']*'", "", s) # string literal (w/ single quote) s = re.sub(r'"[^"]*"', "", s) # string literal (w/ double quote) # Strip complex objects (maybe default value of arguments) while re.search(r'\([^)]*\)', s): # contents of parenthesis (ex. NamedTuple(attr=...)) s = re.sub(r'\([^)]*\)', '', s) while re.search(r'<[^>]*>', s): # contents of angle brackets (ex. <object>) s = re.sub(r'<[^>]*>', '', s) while re.search(r'{[^}]*}', s): # contents of curly brackets (ex. dict) s = re.sub(r'{[^}]*}', '', s) # Parse the signature to arguments + options args: List[str] = [] opts: List[str] = [] opt_re = re.compile(r"^(.*, |)([a-zA-Z0-9_*]+)\s*=\s*") while s: m = opt_re.search(s) if not m: # The rest are arguments args = s.split(', ') break opts.insert(0, m.group(2)) s = m.group(1)[:-2] # Strip typehints for i, arg in enumerate(args): args[i] = strip_arg_typehint(arg) for i, opt in enumerate(opts): opts[i] = strip_arg_typehint(opt) # Produce a more compact signature sig = limited_join(", ", args, max_chars=max_chars - 2) if opts: if not sig: sig = "[%s]" % limited_join(", ", opts, max_chars=max_chars - 4) elif len(sig) < max_chars - 4 - 2 - 3: sig += "[, %s]" % limited_join(", ", opts, max_chars=max_chars - len(sig) - 4 - 2) return "(%s)" % sig def extract_summary(doc: List[str], document: Any) -> str: """Extract summary from docstring.""" def parse(doc: List[str], settings: Any) -> nodes.document: state_machine = RSTStateMachine(state_classes, 'Body') node = new_document('', settings) node.reporter = NullReporter() state_machine.run(doc, node) return node # Skip a blank lines at the top while doc and not doc[0].strip(): doc.pop(0) # If there's a blank line, then we can assume the first sentence / # paragraph has ended, so anything after shouldn't be part of the # summary for i, piece in enumerate(doc): if not piece.strip(): doc = doc[:i] break if doc == []: return '' # parse the docstring node = parse(doc, document.settings) if isinstance(node[0], nodes.section): # document starts with a section heading, so use that. summary = node[0].astext().strip() elif not isinstance(node[0], nodes.paragraph): # document starts with non-paragraph: pick up the first line summary = doc[0].strip() else: # Try to find the "first sentence", which may span multiple lines sentences = periods_re.split(" ".join(doc)) if len(sentences) == 1: summary = sentences[0].strip() else: summary = '' for i in range(len(sentences)): summary = ". ".join(sentences[:i + 1]).rstrip(".") + "." node[:] = [] node = parse(doc, document.settings) if summary.endswith(WELL_KNOWN_ABBREVIATIONS): pass elif not list(node.traverse(nodes.system_message)): # considered as that splitting by period does not break inline markups break # strip literal notation mark ``::`` from tail of summary summary = literal_re.sub('.', summary) return summary def limited_join(sep: str, items: List[str], max_chars: int = 30, overflow_marker: str = "...") -> str: """Join a number of strings into one, limiting the length to *max_chars*. If the string overflows this limit, replace the last fitting item by *overflow_marker*. Returns: joined_string """ full_str = sep.join(items) if len(full_str) < max_chars: return full_str n_chars = 0 n_items = 0 for j, item in enumerate(items): n_chars += len(item) + len(sep) if n_chars < max_chars - len(overflow_marker): n_items += 1 else: break return sep.join(list(items[:n_items]) + [overflow_marker]) # -- Importing items ----------------------------------------------------------- def get_import_prefixes_from_env(env: BuildEnvironment) -> List[str]: """ Obtain current Python import prefixes (for `import_by_name`) from ``document.env`` """ prefixes: List[Optional[str]] = [None] currmodule = env.ref_context.get('py:module') if currmodule: prefixes.insert(0, currmodule) currclass = env.ref_context.get('py:class') if currclass: if currmodule: prefixes.insert(0, currmodule + "." + currclass) else: prefixes.insert(0, currclass) return prefixes def import_by_name(name: str, prefixes: List[str] = [None]) -> Tuple[str, Any, Any, str]: """Import a Python object that has the given *name*, under one of the *prefixes*. The first name that succeeds is used. """ tried = [] for prefix in prefixes: try: if prefix: prefixed_name = '.'.join([prefix, name]) else: prefixed_name = name obj, parent, modname = _import_by_name(prefixed_name) return prefixed_name, obj, parent, modname except ImportError: tried.append(prefixed_name) raise ImportError('no module named %s' % ' or '.join(tried)) def _import_by_name(name: str) -> Tuple[Any, Any, str]: """Import a Python object given its full name.""" try: name_parts = name.split('.') # try first interpret `name` as MODNAME.OBJ modname = '.'.join(name_parts[:-1]) if modname: try: mod = import_module(modname) return getattr(mod, name_parts[-1]), mod, modname except (ImportError, IndexError, AttributeError): pass # ... then as MODNAME, MODNAME.OBJ1, MODNAME.OBJ1.OBJ2, ... last_j = 0 modname = None for j in reversed(range(1, len(name_parts) + 1)): last_j = j modname = '.'.join(name_parts[:j]) try: import_module(modname) except ImportError: continue if modname in sys.modules: break if last_j < len(name_parts): parent = None obj = sys.modules[modname] for obj_name in name_parts[last_j:]: parent = obj obj = getattr(obj, obj_name) return obj, parent, modname else: return sys.modules[modname], None, modname except (ValueError, ImportError, AttributeError, KeyError) as e: raise ImportError(*e.args) from e def import_ivar_by_name(name: str, prefixes: List[str] = [None]) -> Tuple[str, Any, Any, str]: """Import an instance variable that has the given *name*, under one of the *prefixes*. The first name that succeeds is used. """ try: name, attr = name.rsplit(".", 1) real_name, obj, parent, modname = import_by_name(name, prefixes) qualname = real_name.replace(modname + ".", "") analyzer = ModuleAnalyzer.for_module(getattr(obj, '__module__', modname)) analyzer.analyze() # check for presence in `annotations` to include dataclass attributes if (qualname, attr) in analyzer.attr_docs or (qualname, attr) in analyzer.annotations: return real_name + "." + attr, INSTANCEATTR, obj, modname except (ImportError, ValueError, PycodeError): pass raise ImportError # -- :autolink: (smart default role) ------------------------------------------- class AutoLink(SphinxRole): """Smart linking role. Expands to ':obj:`text`' if `text` is an object that can be imported; otherwise expands to '*text*'. """ def run(self) -> Tuple[List[Node], List[system_message]]: pyobj_role = self.env.get_domain('py').role('obj') objects, errors = pyobj_role('obj', self.rawtext, self.text, self.lineno, self.inliner, self.options, self.content) if errors: return objects, errors assert len(objects) == 1 pending_xref = cast(addnodes.pending_xref, objects[0]) try: # try to import object by name prefixes = get_import_prefixes_from_env(self.env) import_by_name(pending_xref['reftarget'], prefixes) except ImportError: literal = cast(nodes.literal, pending_xref[0]) objects[0] = nodes.emphasis(self.rawtext, literal.astext(), classes=literal['classes']) return objects, errors def get_rst_suffix(app: Sphinx) -> str: def get_supported_format(suffix: str) -> Tuple[str, ...]: parser_class = app.registry.get_source_parsers().get(suffix) if parser_class is None: return ('restructuredtext',) return parser_class.supported suffix: str = None for suffix in app.config.source_suffix: if 'restructuredtext' in get_supported_format(suffix): return suffix return None def process_generate_options(app: Sphinx) -> None: genfiles = app.config.autosummary_generate if genfiles is True: env = app.builder.env genfiles = [env.doc2path(x, base=None) for x in env.found_docs if os.path.isfile(env.doc2path(x))] elif genfiles is False: pass else: ext = list(app.config.source_suffix) genfiles = [genfile + (ext[0] if not genfile.endswith(tuple(ext)) else '') for genfile in genfiles] for entry in genfiles[:]: if not path.isfile(path.join(app.srcdir, entry)): logger.warning(__('autosummary_generate: file not found: %s'), entry) genfiles.remove(entry) if not genfiles: return suffix = get_rst_suffix(app) if suffix is None: logger.warning(__('autosummary generats .rst files internally. ' 'But your source_suffix does not contain .rst. Skipped.')) return from sphinx.ext.autosummary.generate import generate_autosummary_docs imported_members = app.config.autosummary_imported_members with mock(app.config.autosummary_mock_imports): generate_autosummary_docs(genfiles, suffix=suffix, base_path=app.srcdir, app=app, imported_members=imported_members, overwrite=app.config.autosummary_generate_overwrite, encoding=app.config.source_encoding) def setup(app: Sphinx) -> Dict[str, Any]: # I need autodoc app.setup_extension('sphinx.ext.autodoc') app.add_node(autosummary_toc, html=(autosummary_toc_visit_html, autosummary_noop), latex=(autosummary_noop, autosummary_noop), text=(autosummary_noop, autosummary_noop), man=(autosummary_noop, autosummary_noop), texinfo=(autosummary_noop, autosummary_noop)) app.add_node(autosummary_table, html=(autosummary_table_visit_html, autosummary_noop), latex=(autosummary_noop, autosummary_noop), text=(autosummary_noop, autosummary_noop), man=(autosummary_noop, autosummary_noop), texinfo=(autosummary_noop, autosummary_noop)) app.add_directive('autosummary', Autosummary) app.add_role('autolink', AutoLink()) app.connect('builder-inited', process_generate_options) app.add_config_value('autosummary_context', {}, True) app.add_config_value('autosummary_filename_map', {}, 'html') app.add_config_value('autosummary_generate', True, True, [bool, list]) app.add_config_value('autosummary_generate_overwrite', True, False) app.add_config_value('autosummary_mock_imports', lambda config: config.autodoc_mock_imports, 'env') app.add_config_value('autosummary_imported_members', [], False, [bool]) return {'version': sphinx.__display_version__, 'parallel_read_safe': True} �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autosummary/generate.py�����������������������������������������������������0000644�0000766�0000024�00000060317�00000000000�021205� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.autosummary.generate ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Usable as a library or script to generate automatic RST source files for items referred to in autosummary:: directives. Each generated RST file contains a single auto*:: directive which extracts the docstring of the referred item. Example Makefile rule:: generate: sphinx-autogen -o source/generated source/*.rst :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import argparse import inspect import locale import os import pkgutil import pydoc import re import sys import warnings from gettext import NullTranslations from os import path from typing import Any, Dict, List, NamedTuple, Set, Tuple, Type, Union from jinja2 import TemplateNotFound from jinja2.sandbox import SandboxedEnvironment import sphinx.locale from sphinx import __display_version__, package_dir from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.config import Config from sphinx.deprecation import RemovedInSphinx50Warning from sphinx.ext.autodoc import Documenter from sphinx.ext.autodoc.importer import import_module from sphinx.ext.autosummary import get_documenter, import_by_name, import_ivar_by_name from sphinx.locale import __ from sphinx.pycode import ModuleAnalyzer, PycodeError from sphinx.registry import SphinxComponentRegistry from sphinx.util import logging, rst, split_full_qualified_name from sphinx.util.inspect import safe_getattr from sphinx.util.osutil import ensuredir from sphinx.util.template import SphinxTemplateLoader logger = logging.getLogger(__name__) class DummyApplication: """Dummy Application class for sphinx-autogen command.""" def __init__(self, translator: NullTranslations) -> None: self.config = Config() self.registry = SphinxComponentRegistry() self.messagelog: List[str] = [] self.srcdir = "/" self.translator = translator self.verbosity = 0 self._warncount = 0 self.warningiserror = False self.config.add('autosummary_context', {}, True, None) self.config.add('autosummary_filename_map', {}, True, None) self.config.init_values() def emit_firstresult(self, *args: Any) -> None: pass class AutosummaryEntry(NamedTuple): name: str path: str template: str recursive: bool def setup_documenters(app: Any) -> None: from sphinx.ext.autodoc import (AttributeDocumenter, ClassDocumenter, DataDocumenter, DecoratorDocumenter, ExceptionDocumenter, FunctionDocumenter, MethodDocumenter, ModuleDocumenter, NewTypeAttributeDocumenter, NewTypeDataDocumenter, PropertyDocumenter) documenters: List[Type[Documenter]] = [ ModuleDocumenter, ClassDocumenter, ExceptionDocumenter, DataDocumenter, FunctionDocumenter, MethodDocumenter, NewTypeAttributeDocumenter, NewTypeDataDocumenter, AttributeDocumenter, DecoratorDocumenter, PropertyDocumenter, ] for documenter in documenters: app.registry.add_documenter(documenter.objtype, documenter) def _simple_info(msg: str) -> None: warnings.warn('_simple_info() is deprecated.', RemovedInSphinx50Warning, stacklevel=2) print(msg) def _simple_warn(msg: str) -> None: warnings.warn('_simple_warn() is deprecated.', RemovedInSphinx50Warning, stacklevel=2) print('WARNING: ' + msg, file=sys.stderr) def _underline(title: str, line: str = '=') -> str: if '\n' in title: raise ValueError('Can only underline single lines') return title + '\n' + line * len(title) class AutosummaryRenderer: """A helper class for rendering.""" def __init__(self, app: Union[Builder, Sphinx], template_dir: str = None) -> None: if isinstance(app, Builder): warnings.warn('The first argument for AutosummaryRenderer has been ' 'changed to Sphinx object', RemovedInSphinx50Warning, stacklevel=2) if template_dir: warnings.warn('template_dir argument for AutosummaryRenderer is deprecated.', RemovedInSphinx50Warning, stacklevel=2) system_templates_path = [os.path.join(package_dir, 'ext', 'autosummary', 'templates')] loader = SphinxTemplateLoader(app.srcdir, app.config.templates_path, system_templates_path) self.env = SandboxedEnvironment(loader=loader) self.env.filters['escape'] = rst.escape self.env.filters['e'] = rst.escape self.env.filters['underline'] = _underline if isinstance(app, (Sphinx, DummyApplication)): if app.translator: self.env.add_extension("jinja2.ext.i18n") self.env.install_gettext_translations(app.translator) elif isinstance(app, Builder): if app.app.translator: self.env.add_extension("jinja2.ext.i18n") self.env.install_gettext_translations(app.app.translator) def exists(self, template_name: str) -> bool: """Check if template file exists.""" warnings.warn('AutosummaryRenderer.exists() is deprecated.', RemovedInSphinx50Warning, stacklevel=2) try: self.env.get_template(template_name) return True except TemplateNotFound: return False def render(self, template_name: str, context: Dict) -> str: """Render a template file.""" try: template = self.env.get_template(template_name) except TemplateNotFound: try: # objtype is given as template_name template = self.env.get_template('autosummary/%s.rst' % template_name) except TemplateNotFound: # fallback to base.rst template = self.env.get_template('autosummary/base.rst') return template.render(context) # -- Generating output --------------------------------------------------------- class ModuleScanner: def __init__(self, app: Any, obj: Any) -> None: self.app = app self.object = obj def get_object_type(self, name: str, value: Any) -> str: return get_documenter(self.app, value, self.object).objtype def is_skipped(self, name: str, value: Any, objtype: str) -> bool: try: return self.app.emit_firstresult('autodoc-skip-member', objtype, name, value, False, {}) except Exception as exc: logger.warning(__('autosummary: failed to determine %r to be documented, ' 'the following exception was raised:\n%s'), name, exc, type='autosummary') return False def scan(self, imported_members: bool) -> List[str]: members = [] for name in dir(self.object): try: value = safe_getattr(self.object, name) except AttributeError: value = None objtype = self.get_object_type(name, value) if self.is_skipped(name, value, objtype): continue try: if inspect.ismodule(value): imported = True elif safe_getattr(value, '__module__') != self.object.__name__: imported = True else: imported = False except AttributeError: imported = False if imported_members: # list all members up members.append(name) elif imported is False: # list not-imported members up members.append(name) return members def generate_autosummary_content(name: str, obj: Any, parent: Any, template: AutosummaryRenderer, template_name: str, imported_members: bool, app: Any, recursive: bool, context: Dict, modname: str = None, qualname: str = None) -> str: doc = get_documenter(app, obj, parent) def skip_member(obj: Any, name: str, objtype: str) -> bool: try: return app.emit_firstresult('autodoc-skip-member', objtype, name, obj, False, {}) except Exception as exc: logger.warning(__('autosummary: failed to determine %r to be documented, ' 'the following exception was raised:\n%s'), name, exc, type='autosummary') return False def get_class_members(obj: Any) -> Dict[str, Any]: members = sphinx.ext.autodoc.get_class_members(obj, [qualname], safe_getattr) return {name: member.object for name, member in members.items()} def get_module_members(obj: Any) -> Dict[str, Any]: members = {} for name in dir(obj): try: members[name] = safe_getattr(obj, name) except AttributeError: continue return members def get_all_members(obj: Any) -> Dict[str, Any]: if doc.objtype == "module": return get_module_members(obj) elif doc.objtype == "class": return get_class_members(obj) return {} def get_members(obj: Any, types: Set[str], include_public: List[str] = [], imported: bool = True) -> Tuple[List[str], List[str]]: items: List[str] = [] public: List[str] = [] all_members = get_all_members(obj) for name, value in all_members.items(): documenter = get_documenter(app, value, obj) if documenter.objtype in types: # skip imported members if expected if imported or getattr(value, '__module__', None) == obj.__name__: skipped = skip_member(value, name, documenter.objtype) if skipped is True: pass elif skipped is False: # show the member forcedly items.append(name) public.append(name) else: items.append(name) if name in include_public or not name.startswith('_'): # considers member as public public.append(name) return public, items def get_module_attrs(members: Any) -> Tuple[List[str], List[str]]: """Find module attributes with docstrings.""" attrs, public = [], [] try: analyzer = ModuleAnalyzer.for_module(name) attr_docs = analyzer.find_attr_docs() for namespace, attr_name in attr_docs: if namespace == '' and attr_name in members: attrs.append(attr_name) if not attr_name.startswith('_'): public.append(attr_name) except PycodeError: pass # give up if ModuleAnalyzer fails to parse code return public, attrs def get_modules(obj: Any) -> Tuple[List[str], List[str]]: items: List[str] = [] for _, modname, ispkg in pkgutil.iter_modules(obj.__path__): fullname = name + '.' + modname try: module = import_module(fullname) if module and hasattr(module, '__sphinx_mock__'): continue except ImportError: pass items.append(fullname) public = [x for x in items if not x.split('.')[-1].startswith('_')] return public, items ns: Dict[str, Any] = {} ns.update(context) if doc.objtype == 'module': scanner = ModuleScanner(app, obj) ns['members'] = scanner.scan(imported_members) ns['functions'], ns['all_functions'] = \ get_members(obj, {'function'}, imported=imported_members) ns['classes'], ns['all_classes'] = \ get_members(obj, {'class'}, imported=imported_members) ns['exceptions'], ns['all_exceptions'] = \ get_members(obj, {'exception'}, imported=imported_members) ns['attributes'], ns['all_attributes'] = \ get_module_attrs(ns['members']) ispackage = hasattr(obj, '__path__') if ispackage and recursive: ns['modules'], ns['all_modules'] = get_modules(obj) elif doc.objtype == 'class': ns['members'] = dir(obj) ns['inherited_members'] = \ set(dir(obj)) - set(obj.__dict__.keys()) ns['methods'], ns['all_methods'] = \ get_members(obj, {'method'}, ['__init__']) ns['attributes'], ns['all_attributes'] = \ get_members(obj, {'attribute', 'property'}) if modname is None or qualname is None: modname, qualname = split_full_qualified_name(name) if doc.objtype in ('method', 'attribute', 'property'): ns['class'] = qualname.rsplit(".", 1)[0] if doc.objtype in ('class',): shortname = qualname else: shortname = qualname.rsplit(".", 1)[-1] ns['fullname'] = name ns['module'] = modname ns['objname'] = qualname ns['name'] = shortname ns['objtype'] = doc.objtype ns['underline'] = len(name) * '=' if template_name: return template.render(template_name, ns) else: return template.render(doc.objtype, ns) def generate_autosummary_docs(sources: List[str], output_dir: str = None, suffix: str = '.rst', base_path: str = None, builder: Builder = None, template_dir: str = None, imported_members: bool = False, app: Any = None, overwrite: bool = True, encoding: str = 'utf-8') -> None: if builder: warnings.warn('builder argument for generate_autosummary_docs() is deprecated.', RemovedInSphinx50Warning, stacklevel=2) if template_dir: warnings.warn('template_dir argument for generate_autosummary_docs() is deprecated.', RemovedInSphinx50Warning, stacklevel=2) showed_sources = list(sorted(sources)) if len(showed_sources) > 20: showed_sources = showed_sources[:10] + ['...'] + showed_sources[-10:] logger.info(__('[autosummary] generating autosummary for: %s') % ', '.join(showed_sources)) if output_dir: logger.info(__('[autosummary] writing to %s') % output_dir) if base_path is not None: sources = [os.path.join(base_path, filename) for filename in sources] template = AutosummaryRenderer(app) # read items = find_autosummary_in_files(sources) # keep track of new files new_files = [] if app: filename_map = app.config.autosummary_filename_map else: filename_map = {} # write for entry in sorted(set(items), key=str): if entry.path is None: # The corresponding autosummary:: directive did not have # a :toctree: option continue path = output_dir or os.path.abspath(entry.path) ensuredir(path) try: name, obj, parent, modname = import_by_name(entry.name) qualname = name.replace(modname + ".", "") except ImportError as e: try: # try to importl as an instance attribute name, obj, parent, modname = import_ivar_by_name(entry.name) qualname = name.replace(modname + ".", "") except ImportError: logger.warning(__('[autosummary] failed to import %r: %s') % (entry.name, e)) continue context: Dict[str, Any] = {} if app: context.update(app.config.autosummary_context) content = generate_autosummary_content(name, obj, parent, template, entry.template, imported_members, app, entry.recursive, context, modname, qualname) filename = os.path.join(path, filename_map.get(name, name) + suffix) if os.path.isfile(filename): with open(filename, encoding=encoding) as f: old_content = f.read() if content == old_content: continue elif overwrite: # content has changed with open(filename, 'w', encoding=encoding) as f: f.write(content) new_files.append(filename) else: with open(filename, 'w', encoding=encoding) as f: f.write(content) new_files.append(filename) # descend recursively to new files if new_files: generate_autosummary_docs(new_files, output_dir=output_dir, suffix=suffix, base_path=base_path, builder=builder, template_dir=template_dir, imported_members=imported_members, app=app, overwrite=overwrite) # -- Finding documented entries in files --------------------------------------- def find_autosummary_in_files(filenames: List[str]) -> List[AutosummaryEntry]: """Find out what items are documented in source/*.rst. See `find_autosummary_in_lines`. """ documented: List[AutosummaryEntry] = [] for filename in filenames: with open(filename, encoding='utf-8', errors='ignore') as f: lines = f.read().splitlines() documented.extend(find_autosummary_in_lines(lines, filename=filename)) return documented def find_autosummary_in_docstring(name: str, module: str = None, filename: str = None ) -> List[AutosummaryEntry]: """Find out what items are documented in the given object's docstring. See `find_autosummary_in_lines`. """ if module: warnings.warn('module argument for find_autosummary_in_docstring() is deprecated.', RemovedInSphinx50Warning, stacklevel=2) try: real_name, obj, parent, modname = import_by_name(name) lines = pydoc.getdoc(obj).splitlines() return find_autosummary_in_lines(lines, module=name, filename=filename) except AttributeError: pass except ImportError as e: print("Failed to import '%s': %s" % (name, e)) except SystemExit: print("Failed to import '%s'; the module executes module level " "statement and it might call sys.exit()." % name) return [] def find_autosummary_in_lines(lines: List[str], module: str = None, filename: str = None ) -> List[AutosummaryEntry]: """Find out what items appear in autosummary:: directives in the given lines. Returns a list of (name, toctree, template) where *name* is a name of an object and *toctree* the :toctree: path of the corresponding autosummary directive (relative to the root of the file name), and *template* the value of the :template: option. *toctree* and *template* ``None`` if the directive does not have the corresponding options set. """ autosummary_re = re.compile(r'^(\s*)\.\.\s+autosummary::\s*') automodule_re = re.compile( r'^\s*\.\.\s+automodule::\s*([A-Za-z0-9_.]+)\s*$') module_re = re.compile( r'^\s*\.\.\s+(current)?module::\s*([a-zA-Z0-9_.]+)\s*$') autosummary_item_re = re.compile(r'^\s+(~?[_a-zA-Z][a-zA-Z0-9_.]*)\s*.*?') recursive_arg_re = re.compile(r'^\s+:recursive:\s*$') toctree_arg_re = re.compile(r'^\s+:toctree:\s*(.*?)\s*$') template_arg_re = re.compile(r'^\s+:template:\s*(.*?)\s*$') documented: List[AutosummaryEntry] = [] recursive = False toctree: str = None template = None current_module = module in_autosummary = False base_indent = "" for line in lines: if in_autosummary: m = recursive_arg_re.match(line) if m: recursive = True continue m = toctree_arg_re.match(line) if m: toctree = m.group(1) if filename: toctree = os.path.join(os.path.dirname(filename), toctree) continue m = template_arg_re.match(line) if m: template = m.group(1).strip() continue if line.strip().startswith(':'): continue # skip options m = autosummary_item_re.match(line) if m: name = m.group(1).strip() if name.startswith('~'): name = name[1:] if current_module and \ not name.startswith(current_module + '.'): name = "%s.%s" % (current_module, name) documented.append(AutosummaryEntry(name, toctree, template, recursive)) continue if not line.strip() or line.startswith(base_indent + " "): continue in_autosummary = False m = autosummary_re.match(line) if m: in_autosummary = True base_indent = m.group(1) recursive = False toctree = None template = None continue m = automodule_re.search(line) if m: current_module = m.group(1).strip() # recurse into the automodule docstring documented.extend(find_autosummary_in_docstring( current_module, filename=filename)) continue m = module_re.match(line) if m: current_module = m.group(2) continue return documented def get_parser() -> argparse.ArgumentParser: parser = argparse.ArgumentParser( usage='%(prog)s [OPTIONS] <SOURCE_FILE>...', epilog=__('For more information, visit <https://www.sphinx-doc.org/>.'), description=__(""" Generate ReStructuredText using autosummary directives. sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates the reStructuredText files from the autosummary directives contained in the given input files. The format of the autosummary directive is documented in the ``sphinx.ext.autosummary`` Python module and can be read using:: pydoc sphinx.ext.autosummary """)) parser.add_argument('--version', action='version', dest='show_version', version='%%(prog)s %s' % __display_version__) parser.add_argument('source_file', nargs='+', help=__('source files to generate rST files for')) parser.add_argument('-o', '--output-dir', action='store', dest='output_dir', help=__('directory to place all output in')) parser.add_argument('-s', '--suffix', action='store', dest='suffix', default='rst', help=__('default suffix for files (default: ' '%(default)s)')) parser.add_argument('-t', '--templates', action='store', dest='templates', default=None, help=__('custom template directory (default: ' '%(default)s)')) parser.add_argument('-i', '--imported-members', action='store_true', dest='imported_members', default=False, help=__('document imported members (default: ' '%(default)s)')) return parser def main(argv: List[str] = sys.argv[1:]) -> None: sphinx.locale.setlocale(locale.LC_ALL, '') sphinx.locale.init_console(os.path.join(package_dir, 'locale'), 'sphinx') translator, _ = sphinx.locale.init([], None) app = DummyApplication(translator) logging.setup(app, sys.stdout, sys.stderr) # type: ignore setup_documenters(app) args = get_parser().parse_args(argv) if args.templates: app.config.templates_path.append(path.abspath(args.templates)) generate_autosummary_docs(args.source_file, args.output_dir, '.' + args.suffix, imported_members=args.imported_members, app=app) if __name__ == '__main__': main() �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3223343 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autosummary/templates/������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�021030� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.464625 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autosummary/templates/autosummary/������������������������������������������0000755�0000766�0000024�00000000000�00000000000�023416� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1609484009.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autosummary/templates/autosummary/base.rst����������������������������������0000644�0000766�0000024�00000000152�00000000000�025060� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������{{ fullname | escape | underline}} .. currentmodule:: {{ module }} .. auto{{ objtype }}:: {{ objname }} ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autosummary/templates/autosummary/class.rst���������������������������������0000644�0000766�0000024�00000001051�00000000000�025252� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������{{ fullname | escape | underline}} .. currentmodule:: {{ module }} .. autoclass:: {{ objname }} {% block methods %} .. automethod:: __init__ {% if methods %} .. rubric:: {{ _('Methods') }} .. autosummary:: {% for item in methods %} ~{{ name }}.{{ item }} {%- endfor %} {% endif %} {% endblock %} {% block attributes %} {% if attributes %} .. rubric:: {{ _('Attributes') }} .. autosummary:: {% for item in attributes %} ~{{ name }}.{{ item }} {%- endfor %} {% endif %} {% endblock %} ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/autosummary/templates/autosummary/module.rst��������������������������������0000644�0000766�0000024�00000002057�00000000000�025441� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������{{ fullname | escape | underline}} .. automodule:: {{ fullname }} {% block attributes %} {% if attributes %} .. rubric:: {{ _('Module Attributes') }} .. autosummary:: {% for item in attributes %} {{ item }} {%- endfor %} {% endif %} {% endblock %} {% block functions %} {% if functions %} .. rubric:: {{ _('Functions') }} .. autosummary:: {% for item in functions %} {{ item }} {%- endfor %} {% endif %} {% endblock %} {% block classes %} {% if classes %} .. rubric:: {{ _('Classes') }} .. autosummary:: {% for item in classes %} {{ item }} {%- endfor %} {% endif %} {% endblock %} {% block exceptions %} {% if exceptions %} .. rubric:: {{ _('Exceptions') }} .. autosummary:: {% for item in exceptions %} {{ item }} {%- endfor %} {% endif %} {% endblock %} {% block modules %} {% if modules %} .. rubric:: Modules .. autosummary:: :toctree: :recursive: {% for item in modules %} {{ item }} {%- endfor %} {% endif %} {% endblock %} ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/coverage.py�����������������������������������������������������������������0000644�0000766�0000024�00000033547�00000000000�016625� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.coverage ~~~~~~~~~~~~~~~~~~~ Check Python modules and C API for coverage. Mostly written by Josip Dzolonga for the Google Highly Open Participation contest. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import glob import inspect import pickle import re from importlib import import_module from os import path from typing import IO, Any, Dict, List, Pattern, Set, Tuple import sphinx from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.locale import __ from sphinx.util import logging from sphinx.util.console import red # type: ignore from sphinx.util.inspect import safe_getattr logger = logging.getLogger(__name__) # utility def write_header(f: IO, text: str, char: str = '-') -> None: f.write(text + '\n') f.write(char * len(text) + '\n') def compile_regex_list(name: str, exps: str) -> List[Pattern]: lst = [] for exp in exps: try: lst.append(re.compile(exp)) except Exception: logger.warning(__('invalid regex %r in %s'), exp, name) return lst class CoverageBuilder(Builder): """ Evaluates coverage of code in the documentation. """ name = 'coverage' epilog = __('Testing of coverage in the sources finished, look at the ' 'results in %(outdir)s' + path.sep + 'python.txt.') def init(self) -> None: self.c_sourcefiles: List[str] = [] for pattern in self.config.coverage_c_path: pattern = path.join(self.srcdir, pattern) self.c_sourcefiles.extend(glob.glob(pattern)) self.c_regexes: List[Tuple[str, Pattern]] = [] for (name, exp) in self.config.coverage_c_regexes.items(): try: self.c_regexes.append((name, re.compile(exp))) except Exception: logger.warning(__('invalid regex %r in coverage_c_regexes'), exp) self.c_ignorexps: Dict[str, List[Pattern]] = {} for (name, exps) in self.config.coverage_ignore_c_items.items(): self.c_ignorexps[name] = compile_regex_list('coverage_ignore_c_items', exps) self.mod_ignorexps = compile_regex_list('coverage_ignore_modules', self.config.coverage_ignore_modules) self.cls_ignorexps = compile_regex_list('coverage_ignore_classes', self.config.coverage_ignore_classes) self.fun_ignorexps = compile_regex_list('coverage_ignore_functions', self.config.coverage_ignore_functions) self.py_ignorexps = compile_regex_list('coverage_ignore_pyobjects', self.config.coverage_ignore_pyobjects) def get_outdated_docs(self) -> str: return 'coverage overview' def write(self, *ignored: Any) -> None: self.py_undoc: Dict[str, Dict[str, Any]] = {} self.build_py_coverage() self.write_py_coverage() self.c_undoc: Dict[str, Set[Tuple[str, str]]] = {} self.build_c_coverage() self.write_c_coverage() def build_c_coverage(self) -> None: # Fetch all the info from the header files c_objects = self.env.domaindata['c']['objects'] for filename in self.c_sourcefiles: undoc: Set[Tuple[str, str]] = set() with open(filename) as f: for line in f: for key, regex in self.c_regexes: match = regex.match(line) if match: name = match.groups()[0] if name not in c_objects: for exp in self.c_ignorexps.get(key, []): if exp.match(name): break else: undoc.add((key, name)) continue if undoc: self.c_undoc[filename] = undoc def write_c_coverage(self) -> None: output_file = path.join(self.outdir, 'c.txt') with open(output_file, 'w') as op: if self.config.coverage_write_headline: write_header(op, 'Undocumented C API elements', '=') op.write('\n') for filename, undoc in self.c_undoc.items(): write_header(op, filename) for typ, name in sorted(undoc): op.write(' * %-50s [%9s]\n' % (name, typ)) if self.config.coverage_show_missing_items: if self.app.quiet or self.app.warningiserror: logger.warning(__('undocumented c api: %s [%s] in file %s'), name, typ, filename) else: logger.info(red('undocumented ') + 'c ' + 'api ' + '%-30s' % (name + " [%9s]" % typ) + red(' - in file ') + filename) op.write('\n') def ignore_pyobj(self, full_name: str) -> bool: for exp in self.py_ignorexps: if exp.search(full_name): return True return False def build_py_coverage(self) -> None: objects = self.env.domaindata['py']['objects'] modules = self.env.domaindata['py']['modules'] skip_undoc = self.config.coverage_skip_undoc_in_source for mod_name in modules: ignore = False for exp in self.mod_ignorexps: if exp.match(mod_name): ignore = True break if ignore or self.ignore_pyobj(mod_name): continue try: mod = import_module(mod_name) except ImportError as err: logger.warning(__('module %s could not be imported: %s'), mod_name, err) self.py_undoc[mod_name] = {'error': err} continue funcs = [] classes: Dict[str, List[str]] = {} for name, obj in inspect.getmembers(mod): # diverse module attributes are ignored: if name[0] == '_': # begins in an underscore continue if not hasattr(obj, '__module__'): # cannot be attributed to a module continue if obj.__module__ != mod_name: # is not defined in this module continue full_name = '%s.%s' % (mod_name, name) if self.ignore_pyobj(full_name): continue if inspect.isfunction(obj): if full_name not in objects: for exp in self.fun_ignorexps: if exp.match(name): break else: if skip_undoc and not obj.__doc__: continue funcs.append(name) elif inspect.isclass(obj): for exp in self.cls_ignorexps: if exp.match(name): break else: if full_name not in objects: if skip_undoc and not obj.__doc__: continue # not documented at all classes[name] = [] continue attrs: List[str] = [] for attr_name in dir(obj): if attr_name not in obj.__dict__: continue try: attr = safe_getattr(obj, attr_name) except AttributeError: continue if not (inspect.ismethod(attr) or inspect.isfunction(attr)): continue if attr_name[0] == '_': # starts with an underscore, ignore it continue if skip_undoc and not attr.__doc__: # skip methods without docstring if wished continue full_attr_name = '%s.%s' % (full_name, attr_name) if self.ignore_pyobj(full_attr_name): continue if full_attr_name not in objects: attrs.append(attr_name) if attrs: # some attributes are undocumented classes[name] = attrs self.py_undoc[mod_name] = {'funcs': funcs, 'classes': classes} def write_py_coverage(self) -> None: output_file = path.join(self.outdir, 'python.txt') failed = [] with open(output_file, 'w') as op: if self.config.coverage_write_headline: write_header(op, 'Undocumented Python objects', '=') keys = sorted(self.py_undoc.keys()) for name in keys: undoc = self.py_undoc[name] if 'error' in undoc: failed.append((name, undoc['error'])) else: if not undoc['classes'] and not undoc['funcs']: continue write_header(op, name) if undoc['funcs']: op.write('Functions:\n') op.writelines(' * %s\n' % x for x in undoc['funcs']) if self.config.coverage_show_missing_items: if self.app.quiet or self.app.warningiserror: for func in undoc['funcs']: logger.warning( __('undocumented python function: %s :: %s'), name, func) else: for func in undoc['funcs']: logger.info(red('undocumented ') + 'py ' + 'function ' + '%-30s' % func + red(' - in module ') + name) op.write('\n') if undoc['classes']: op.write('Classes:\n') for class_name, methods in sorted( undoc['classes'].items()): if not methods: op.write(' * %s\n' % class_name) if self.config.coverage_show_missing_items: if self.app.quiet or self.app.warningiserror: logger.warning( __('undocumented python class: %s :: %s'), name, class_name) else: logger.info(red('undocumented ') + 'py ' + 'class ' + '%-30s' % class_name + red(' - in module ') + name) else: op.write(' * %s -- missing methods:\n\n' % class_name) op.writelines(' - %s\n' % x for x in methods) if self.config.coverage_show_missing_items: if self.app.quiet or self.app.warningiserror: for meth in methods: logger.warning( __('undocumented python method:' + ' %s :: %s :: %s'), name, class_name, meth) else: for meth in methods: logger.info(red('undocumented ') + 'py ' + 'method ' + '%-30s' % (class_name + '.' + meth) + red(' - in module ') + name) op.write('\n') if failed: write_header(op, 'Modules that failed to import') op.writelines(' * %s -- %s\n' % x for x in failed) def finish(self) -> None: # dump the coverage data to a pickle file too picklepath = path.join(self.outdir, 'undoc.pickle') with open(picklepath, 'wb') as dumpfile: pickle.dump((self.py_undoc, self.c_undoc), dumpfile) def setup(app: Sphinx) -> Dict[str, Any]: app.add_builder(CoverageBuilder) app.add_config_value('coverage_ignore_modules', [], False) app.add_config_value('coverage_ignore_functions', [], False) app.add_config_value('coverage_ignore_classes', [], False) app.add_config_value('coverage_ignore_pyobjects', [], False) app.add_config_value('coverage_c_path', [], False) app.add_config_value('coverage_c_regexes', {}, False) app.add_config_value('coverage_ignore_c_items', {}, False) app.add_config_value('coverage_write_headline', True, False) app.add_config_value('coverage_skip_undoc_in_source', False, False) app.add_config_value('coverage_show_missing_items', False, False) return {'version': sphinx.__display_version__, 'parallel_read_safe': True} ���������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/doctest.py������������������������������������������������������������������0000644�0000766�0000024�00000054444�00000000000�016476� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.doctest ~~~~~~~~~~~~~~~~~~ Mimic doctest by automatically executing code snippets and checking their results. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import doctest import re import sys import time from io import StringIO from os import path from typing import (TYPE_CHECKING, Any, Callable, Dict, Iterable, List, Sequence, Set, Tuple, Type) from docutils import nodes from docutils.nodes import Element, Node, TextElement from docutils.parsers.rst import directives from packaging.specifiers import InvalidSpecifier, SpecifierSet from packaging.version import Version import sphinx from sphinx.builders import Builder from sphinx.locale import __ from sphinx.util import logging from sphinx.util.console import bold # type: ignore from sphinx.util.docutils import SphinxDirective from sphinx.util.osutil import relpath from sphinx.util.typing import OptionSpec if TYPE_CHECKING: from sphinx.application import Sphinx logger = logging.getLogger(__name__) blankline_re = re.compile(r'^\s*<BLANKLINE>', re.MULTILINE) doctestopt_re = re.compile(r'#\s*doctest:.+$', re.MULTILINE) def is_allowed_version(spec: str, version: str) -> bool: """Check `spec` satisfies `version` or not. This obeys PEP-440 specifiers: https://www.python.org/dev/peps/pep-0440/#version-specifiers Some examples: >>> is_allowed_version('3.3', '<=3.5') True >>> is_allowed_version('3.3', '<=3.2') False >>> is_allowed_version('3.3', '>3.2, <4.0') True """ return Version(version) in SpecifierSet(spec) # set up the necessary directives class TestDirective(SphinxDirective): """ Base class for doctest-related directives. """ has_content = True required_arguments = 0 optional_arguments = 1 final_argument_whitespace = True def run(self) -> List[Node]: # use ordinary docutils nodes for test code: they get special attributes # so that our builder recognizes them, and the other builders are happy. code = '\n'.join(self.content) test = None if self.name == 'doctest': if '<BLANKLINE>' in code: # convert <BLANKLINE>s to ordinary blank lines for presentation test = code code = blankline_re.sub('', code) if doctestopt_re.search(code) and 'no-trim-doctest-flags' not in self.options: if not test: test = code code = doctestopt_re.sub('', code) nodetype: Type[TextElement] = nodes.literal_block if self.name in ('testsetup', 'testcleanup') or 'hide' in self.options: nodetype = nodes.comment if self.arguments: groups = [x.strip() for x in self.arguments[0].split(',')] else: groups = ['default'] node = nodetype(code, code, testnodetype=self.name, groups=groups) self.set_source_info(node) if test is not None: # only save if it differs from code node['test'] = test if self.name == 'doctest': if self.config.highlight_language in ('py', 'python'): node['language'] = 'pycon' else: node['language'] = 'pycon3' # default elif self.name == 'testcode': if self.config.highlight_language in ('py', 'python'): node['language'] = 'python' else: node['language'] = 'python3' # default elif self.name == 'testoutput': # don't try to highlight output node['language'] = 'none' node['options'] = {} if self.name in ('doctest', 'testoutput') and 'options' in self.options: # parse doctest-like output comparison flags option_strings = self.options['options'].replace(',', ' ').split() for option in option_strings: prefix, option_name = option[0], option[1:] if prefix not in '+-': self.state.document.reporter.warning( __("missing '+' or '-' in '%s' option.") % option, line=self.lineno) continue if option_name not in doctest.OPTIONFLAGS_BY_NAME: self.state.document.reporter.warning( __("'%s' is not a valid option.") % option_name, line=self.lineno) continue flag = doctest.OPTIONFLAGS_BY_NAME[option[1:]] node['options'][flag] = (option[0] == '+') if self.name == 'doctest' and 'pyversion' in self.options: try: spec = self.options['pyversion'] python_version = '.'.join([str(v) for v in sys.version_info[:3]]) if not is_allowed_version(spec, python_version): flag = doctest.OPTIONFLAGS_BY_NAME['SKIP'] node['options'][flag] = True # Skip the test except InvalidSpecifier: self.state.document.reporter.warning( __("'%s' is not a valid pyversion option") % spec, line=self.lineno) if 'skipif' in self.options: node['skipif'] = self.options['skipif'] if 'trim-doctest-flags' in self.options: node['trim_flags'] = True elif 'no-trim-doctest-flags' in self.options: node['trim_flags'] = False return [node] class TestsetupDirective(TestDirective): option_spec: OptionSpec = { 'skipif': directives.unchanged_required } class TestcleanupDirective(TestDirective): option_spec: OptionSpec = { 'skipif': directives.unchanged_required } class DoctestDirective(TestDirective): option_spec: OptionSpec = { 'hide': directives.flag, 'no-trim-doctest-flags': directives.flag, 'options': directives.unchanged, 'pyversion': directives.unchanged_required, 'skipif': directives.unchanged_required, 'trim-doctest-flags': directives.flag, } class TestcodeDirective(TestDirective): option_spec: OptionSpec = { 'hide': directives.flag, 'no-trim-doctest-flags': directives.flag, 'pyversion': directives.unchanged_required, 'skipif': directives.unchanged_required, 'trim-doctest-flags': directives.flag, } class TestoutputDirective(TestDirective): option_spec: OptionSpec = { 'hide': directives.flag, 'no-trim-doctest-flags': directives.flag, 'options': directives.unchanged, 'pyversion': directives.unchanged_required, 'skipif': directives.unchanged_required, 'trim-doctest-flags': directives.flag, } parser = doctest.DocTestParser() # helper classes class TestGroup: def __init__(self, name: str) -> None: self.name = name self.setup: List[TestCode] = [] self.tests: List[List[TestCode]] = [] self.cleanup: List[TestCode] = [] def add_code(self, code: "TestCode", prepend: bool = False) -> None: if code.type == 'testsetup': if prepend: self.setup.insert(0, code) else: self.setup.append(code) elif code.type == 'testcleanup': self.cleanup.append(code) elif code.type == 'doctest': self.tests.append([code]) elif code.type == 'testcode': self.tests.append([code, None]) elif code.type == 'testoutput': if self.tests and len(self.tests[-1]) == 2: self.tests[-1][1] = code else: raise RuntimeError(__('invalid TestCode type')) def __repr__(self) -> str: return 'TestGroup(name=%r, setup=%r, cleanup=%r, tests=%r)' % ( self.name, self.setup, self.cleanup, self.tests) class TestCode: def __init__(self, code: str, type: str, filename: str, lineno: int, options: Dict = None) -> None: self.code = code self.type = type self.filename = filename self.lineno = lineno self.options = options or {} def __repr__(self) -> str: return 'TestCode(%r, %r, filename=%r, lineno=%r, options=%r)' % ( self.code, self.type, self.filename, self.lineno, self.options) class SphinxDocTestRunner(doctest.DocTestRunner): def summarize(self, out: Callable, verbose: bool = None # type: ignore ) -> Tuple[int, int]: string_io = StringIO() old_stdout = sys.stdout sys.stdout = string_io try: res = super().summarize(verbose) finally: sys.stdout = old_stdout out(string_io.getvalue()) return res def _DocTestRunner__patched_linecache_getlines(self, filename: str, module_globals: Any = None) -> Any: # this is overridden from DocTestRunner adding the try-except below m = self._DocTestRunner__LINECACHE_FILENAME_RE.match(filename) # type: ignore if m and m.group('name') == self.test.name: try: example = self.test.examples[int(m.group('examplenum'))] # because we compile multiple doctest blocks with the same name # (viz. the group name) this might, for outer stack frames in a # traceback, get the wrong test which might not have enough examples except IndexError: pass else: return example.source.splitlines(True) return self.save_linecache_getlines(filename, module_globals) # type: ignore # the new builder -- use sphinx-build.py -b doctest to run class DocTestBuilder(Builder): """ Runs test snippets in the documentation. """ name = 'doctest' epilog = __('Testing of doctests in the sources finished, look at the ' 'results in %(outdir)s/output.txt.') def init(self) -> None: # default options self.opt = self.config.doctest_default_flags # HACK HACK HACK # doctest compiles its snippets with type 'single'. That is nice # for doctest examples but unusable for multi-statement code such # as setup code -- to be able to use doctest error reporting with # that code nevertheless, we monkey-patch the "compile" it uses. doctest.compile = self.compile # type: ignore sys.path[0:0] = self.config.doctest_path self.type = 'single' self.total_failures = 0 self.total_tries = 0 self.setup_failures = 0 self.setup_tries = 0 self.cleanup_failures = 0 self.cleanup_tries = 0 date = time.strftime('%Y-%m-%d %H:%M:%S') self.outfile = open(path.join(self.outdir, 'output.txt'), 'w', encoding='utf-8') self.outfile.write(('Results of doctest builder run on %s\n' '==================================%s\n') % (date, '=' * len(date))) def _out(self, text: str) -> None: logger.info(text, nonl=True) self.outfile.write(text) def _warn_out(self, text: str) -> None: if self.app.quiet or self.app.warningiserror: logger.warning(text) else: logger.info(text, nonl=True) self.outfile.write(text) def get_target_uri(self, docname: str, typ: str = None) -> str: return '' def get_outdated_docs(self) -> Set[str]: return self.env.found_docs def finish(self) -> None: # write executive summary def s(v: int) -> str: return 's' if v != 1 else '' repl = (self.total_tries, s(self.total_tries), self.total_failures, s(self.total_failures), self.setup_failures, s(self.setup_failures), self.cleanup_failures, s(self.cleanup_failures)) self._out(''' Doctest summary =============== %5d test%s %5d failure%s in tests %5d failure%s in setup code %5d failure%s in cleanup code ''' % repl) self.outfile.close() if self.total_failures or self.setup_failures or self.cleanup_failures: self.app.statuscode = 1 def write(self, build_docnames: Iterable[str], updated_docnames: Sequence[str], method: str = 'update') -> None: if build_docnames is None: build_docnames = sorted(self.env.all_docs) logger.info(bold('running tests...')) for docname in build_docnames: # no need to resolve the doctree doctree = self.env.get_doctree(docname) self.test_doc(docname, doctree) def get_filename_for_node(self, node: Node, docname: str) -> str: """Try to get the file which actually contains the doctest, not the filename of the document it's included in.""" try: filename = relpath(node.source, self.env.srcdir)\ .rsplit(':docstring of ', maxsplit=1)[0] except Exception: filename = self.env.doc2path(docname, base=None) return filename @staticmethod def get_line_number(node: Node) -> int: """Get the real line number or admit we don't know.""" # TODO: Work out how to store or calculate real (file-relative) # line numbers for doctest blocks in docstrings. if ':docstring of ' in path.basename(node.source or ''): # The line number is given relative to the stripped docstring, # not the file. This is correct where it is set, in # `docutils.nodes.Node.setup_child`, but Sphinx should report # relative to the file, not the docstring. return None if node.line is not None: # TODO: find the root cause of this off by one error. return node.line - 1 return None def skipped(self, node: Element) -> bool: if 'skipif' not in node: return False else: condition = node['skipif'] context: Dict[str, Any] = {} if self.config.doctest_global_setup: exec(self.config.doctest_global_setup, context) should_skip = eval(condition, context) if self.config.doctest_global_cleanup: exec(self.config.doctest_global_cleanup, context) return should_skip def test_doc(self, docname: str, doctree: Node) -> None: groups: Dict[str, TestGroup] = {} add_to_all_groups = [] self.setup_runner = SphinxDocTestRunner(verbose=False, optionflags=self.opt) self.test_runner = SphinxDocTestRunner(verbose=False, optionflags=self.opt) self.cleanup_runner = SphinxDocTestRunner(verbose=False, optionflags=self.opt) self.test_runner._fakeout = self.setup_runner._fakeout # type: ignore self.cleanup_runner._fakeout = self.setup_runner._fakeout # type: ignore if self.config.doctest_test_doctest_blocks: def condition(node: Node) -> bool: return (isinstance(node, (nodes.literal_block, nodes.comment)) and 'testnodetype' in node) or \ isinstance(node, nodes.doctest_block) else: def condition(node: Node) -> bool: return isinstance(node, (nodes.literal_block, nodes.comment)) \ and 'testnodetype' in node for node in doctree.traverse(condition): # type: Element if self.skipped(node): continue source = node['test'] if 'test' in node else node.astext() filename = self.get_filename_for_node(node, docname) line_number = self.get_line_number(node) if not source: logger.warning(__('no code/output in %s block at %s:%s'), node.get('testnodetype', 'doctest'), filename, line_number) code = TestCode(source, type=node.get('testnodetype', 'doctest'), filename=filename, lineno=line_number, options=node.get('options')) node_groups = node.get('groups', ['default']) if '*' in node_groups: add_to_all_groups.append(code) continue for groupname in node_groups: if groupname not in groups: groups[groupname] = TestGroup(groupname) groups[groupname].add_code(code) for code in add_to_all_groups: for group in groups.values(): group.add_code(code) if self.config.doctest_global_setup: code = TestCode(self.config.doctest_global_setup, 'testsetup', filename=None, lineno=0) for group in groups.values(): group.add_code(code, prepend=True) if self.config.doctest_global_cleanup: code = TestCode(self.config.doctest_global_cleanup, 'testcleanup', filename=None, lineno=0) for group in groups.values(): group.add_code(code) if not groups: return self._out('\nDocument: %s\n----------%s\n' % (docname, '-' * len(docname))) for group in groups.values(): self.test_group(group) # Separately count results from setup code res_f, res_t = self.setup_runner.summarize(self._out, verbose=False) self.setup_failures += res_f self.setup_tries += res_t if self.test_runner.tries: res_f, res_t = self.test_runner.summarize(self._out, verbose=True) self.total_failures += res_f self.total_tries += res_t if self.cleanup_runner.tries: res_f, res_t = self.cleanup_runner.summarize(self._out, verbose=True) self.cleanup_failures += res_f self.cleanup_tries += res_t def compile(self, code: str, name: str, type: str, flags: Any, dont_inherit: bool) -> Any: return compile(code, name, self.type, flags, dont_inherit) def test_group(self, group: TestGroup) -> None: ns: Dict = {} def run_setup_cleanup(runner: Any, testcodes: List[TestCode], what: Any) -> bool: examples = [] for testcode in testcodes: example = doctest.Example(testcode.code, '', lineno=testcode.lineno) examples.append(example) if not examples: return True # simulate a doctest with the code sim_doctest = doctest.DocTest(examples, {}, '%s (%s code)' % (group.name, what), testcodes[0].filename, 0, None) sim_doctest.globs = ns old_f = runner.failures self.type = 'exec' # the snippet may contain multiple statements runner.run(sim_doctest, out=self._warn_out, clear_globs=False) if runner.failures > old_f: return False return True # run the setup code if not run_setup_cleanup(self.setup_runner, group.setup, 'setup'): # if setup failed, don't run the group return # run the tests for code in group.tests: if len(code) == 1: # ordinary doctests (code/output interleaved) try: test = parser.get_doctest(code[0].code, {}, group.name, code[0].filename, code[0].lineno) except Exception: logger.warning(__('ignoring invalid doctest code: %r'), code[0].code, location=(code[0].filename, code[0].lineno)) continue if not test.examples: continue for example in test.examples: # apply directive's comparison options new_opt = code[0].options.copy() new_opt.update(example.options) example.options = new_opt self.type = 'single' # as for ordinary doctests else: # testcode and output separate output = code[1].code if code[1] else '' options = code[1].options if code[1] else {} # disable <BLANKLINE> processing as it is not needed options[doctest.DONT_ACCEPT_BLANKLINE] = True # find out if we're testing an exception m = parser._EXCEPTION_RE.match(output) # type: ignore if m: exc_msg = m.group('msg') else: exc_msg = None example = doctest.Example(code[0].code, output, exc_msg=exc_msg, lineno=code[0].lineno, options=options) test = doctest.DocTest([example], {}, group.name, code[0].filename, code[0].lineno, None) self.type = 'exec' # multiple statements again # DocTest.__init__ copies the globs namespace, which we don't want test.globs = ns # also don't clear the globs namespace after running the doctest self.test_runner.run(test, out=self._warn_out, clear_globs=False) # run the cleanup run_setup_cleanup(self.cleanup_runner, group.cleanup, 'cleanup') def setup(app: "Sphinx") -> Dict[str, Any]: app.add_directive('testsetup', TestsetupDirective) app.add_directive('testcleanup', TestcleanupDirective) app.add_directive('doctest', DoctestDirective) app.add_directive('testcode', TestcodeDirective) app.add_directive('testoutput', TestoutputDirective) app.add_builder(DocTestBuilder) # this config value adds to sys.path app.add_config_value('doctest_path', [], False) app.add_config_value('doctest_test_doctest_blocks', 'default', False) app.add_config_value('doctest_global_setup', '', False) app.add_config_value('doctest_global_cleanup', '', False) app.add_config_value( 'doctest_default_flags', doctest.DONT_ACCEPT_TRUE_FOR_1 | doctest.ELLIPSIS | doctest.IGNORE_EXCEPTION_DETAIL, False) return {'version': sphinx.__display_version__, 'parallel_read_safe': True} ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/duration.py�����������������������������������������������������������������0000644�0000766�0000024�00000005671�00000000000�016654� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.duration ~~~~~~~~~~~~~~~~~~~ Measure durations of Sphinx processing. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from datetime import datetime, timedelta from itertools import islice from operator import itemgetter from typing import Any, Dict, List, cast from docutils import nodes from sphinx.application import Sphinx from sphinx.domains import Domain from sphinx.locale import __ from sphinx.util import logging logger = logging.getLogger(__name__) class DurationDomain(Domain): """A domain for durations of Sphinx processing.""" name = 'duration' @property def reading_durations(self) -> Dict[str, timedelta]: return self.data.setdefault('reading_durations', {}) def note_reading_duration(self, duration: timedelta) -> None: self.reading_durations[self.env.docname] = duration def clear(self) -> None: self.reading_durations.clear() def clear_doc(self, docname: str) -> None: self.reading_durations.pop(docname, None) def merge_domaindata(self, docnames: List[str], otherdata: Dict[str, timedelta]) -> None: for docname, duration in otherdata.items(): if docname in docnames: self.reading_durations[docname] = duration def on_builder_inited(app: Sphinx) -> None: """Initialize DurationDomain on bootstrap. This clears results of last build. """ domain = cast(DurationDomain, app.env.get_domain('duration')) domain.clear() def on_source_read(app: Sphinx, docname: str, content: List[str]) -> None: """Start to measure reading duration.""" app.env.temp_data['started_at'] = datetime.now() def on_doctree_read(app: Sphinx, doctree: nodes.document) -> None: """Record a reading duration.""" started_at = app.env.temp_data.get('started_at') duration = datetime.now() - started_at domain = cast(DurationDomain, app.env.get_domain('duration')) domain.note_reading_duration(duration) def on_build_finished(app: Sphinx, error: Exception) -> None: """Display duration ranking on current build.""" domain = cast(DurationDomain, app.env.get_domain('duration')) durations = sorted(domain.reading_durations.items(), key=itemgetter(1), reverse=True) if not durations: return logger.info('') logger.info(__('====================== slowest reading durations =======================')) for docname, d in islice(durations, 5): logger.info('%d.%03d %s', d.seconds, d.microseconds / 1000, docname) def setup(app: Sphinx) -> Dict[str, Any]: app.add_domain(DurationDomain) app.connect('builder-inited', on_builder_inited) app.connect('source-read', on_source_read) app.connect('doctree-read', on_doctree_read) app.connect('build-finished', on_build_finished) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } �����������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/extlinks.py�����������������������������������������������������������������0000644�0000766�0000024�00000006740�00000000000�016666� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.extlinks ~~~~~~~~~~~~~~~~~~~ Extension to save typing and prevent hard-coding of base URLs in the reST files. This adds a new config value called ``extlinks`` that is created like this:: extlinks = {'exmpl': ('https://example.invalid/%s.html', caption), ...} Now you can use e.g. :exmpl:`foo` in your documents. This will create a link to ``https://example.invalid/foo.html``. The link caption depends on the *caption* value given: - If it is ``None``, the caption will be the full URL. - If it is a string, it must contain ``%s`` exactly once. In this case the caption will be *caption* with the role content substituted for ``%s``. You can also give an explicit caption, e.g. :exmpl:`Foo <foo>`. Both, the url string and the caption string must escape ``%`` as ``%%``. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import warnings from typing import Any, Dict, List, Tuple from docutils import nodes, utils from docutils.nodes import Node, system_message from docutils.parsers.rst.states import Inliner import sphinx from sphinx.application import Sphinx from sphinx.deprecation import RemovedInSphinx60Warning from sphinx.util.nodes import split_explicit_title from sphinx.util.typing import RoleFunction def make_link_role(name: str, base_url: str, caption: str) -> RoleFunction: # Check whether we have base_url and caption strings have an '%s' for # expansion. If not, fall back the the old behaviour and use the string as # a prefix. # Remark: It is an implementation detail that we use Pythons %-formatting. # So far we only expose ``%s`` and require quoting of ``%`` using ``%%``. try: base_url % 'dummy' except (TypeError, ValueError): warnings.warn('extlinks: Sphinx-6.0 will require base URL to ' 'contain exactly one \'%s\' and all other \'%\' need ' 'to be escaped as \'%%\'.', RemovedInSphinx60Warning) base_url = base_url.replace('%', '%%') + '%s' if caption is not None: try: caption % 'dummy' except (TypeError, ValueError): warnings.warn('extlinks: Sphinx-6.0 will require a caption string to ' 'contain exactly one \'%s\' and all other \'%\' need ' 'to be escaped as \'%%\'.', RemovedInSphinx60Warning) caption = caption.replace('%', '%%') + '%s' def role(typ: str, rawtext: str, text: str, lineno: int, inliner: Inliner, options: Dict = {}, content: List[str] = [] ) -> Tuple[List[Node], List[system_message]]: text = utils.unescape(text) has_explicit_title, title, part = split_explicit_title(text) full_url = base_url % part if not has_explicit_title: if caption is None: title = full_url else: title = caption % part pnode = nodes.reference(title, title, internal=False, refuri=full_url) return [pnode], [] return role def setup_link_roles(app: Sphinx) -> None: for name, (base_url, caption) in app.config.extlinks.items(): app.add_role(name, make_link_role(name, base_url, caption)) def setup(app: Sphinx) -> Dict[str, Any]: app.add_config_value('extlinks', {}, 'env') app.connect('builder-inited', setup_link_roles) return {'version': sphinx.__display_version__, 'parallel_read_safe': True} ��������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/githubpages.py��������������������������������������������������������������0000644�0000766�0000024�00000002327�00000000000�017324� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.githubpages ~~~~~~~~~~~~~~~~~~~~~~ To publish HTML docs at GitHub Pages, create .nojekyll file. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import os import urllib from typing import Any, Dict import sphinx from sphinx.application import Sphinx from sphinx.environment import BuildEnvironment def create_nojekyll_and_cname(app: Sphinx, env: BuildEnvironment) -> None: if app.builder.format == 'html': open(os.path.join(app.builder.outdir, '.nojekyll'), 'wt').close() html_baseurl = app.config.html_baseurl if html_baseurl: domain = urllib.parse.urlparse(html_baseurl).hostname if domain and not domain.endswith(".github.io"): with open(os.path.join(app.builder.outdir, 'CNAME'), 'wt') as f: # NOTE: don't write a trailing newline. The `CNAME` file that's # auto-generated by the Github UI doesn't have one. f.write(domain) def setup(app: Sphinx) -> Dict[str, Any]: app.connect('env-updated', create_nojekyll_and_cname) return {'version': sphinx.__display_version__, 'parallel_read_safe': True} ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/graphviz.py�����������������������������������������������������������������0000644�0000766�0000024�00000037151�00000000000�016657� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.graphviz ~~~~~~~~~~~~~~~~~~~ Allow graphviz-formatted graphs to be included in Sphinx-generated documents inline. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import posixpath import re import subprocess from os import path from subprocess import PIPE, CalledProcessError from typing import Any, Dict, List, Tuple from docutils import nodes from docutils.nodes import Node from docutils.parsers.rst import Directive, directives import sphinx from sphinx.application import Sphinx from sphinx.errors import SphinxError from sphinx.locale import _, __ from sphinx.util import logging, sha1 from sphinx.util.docutils import SphinxDirective, SphinxTranslator from sphinx.util.fileutil import copy_asset from sphinx.util.i18n import search_image_for_language from sphinx.util.nodes import set_source_info from sphinx.util.osutil import ensuredir from sphinx.util.typing import OptionSpec from sphinx.writers.html import HTMLTranslator from sphinx.writers.latex import LaTeXTranslator from sphinx.writers.manpage import ManualPageTranslator from sphinx.writers.texinfo import TexinfoTranslator from sphinx.writers.text import TextTranslator logger = logging.getLogger(__name__) class GraphvizError(SphinxError): category = 'Graphviz error' class ClickableMapDefinition: """A manipulator for clickable map file of graphviz.""" maptag_re = re.compile('<map id="(.*?)"') href_re = re.compile('href=".*?"') def __init__(self, filename: str, content: str, dot: str = '') -> None: self.id: str = None self.filename = filename self.content = content.splitlines() self.clickable: List[str] = [] self.parse(dot=dot) def parse(self, dot: str = None) -> None: matched = self.maptag_re.match(self.content[0]) if not matched: raise GraphvizError('Invalid clickable map file found: %s' % self.filename) self.id = matched.group(1) if self.id == '%3': # graphviz generates wrong ID if graph name not specified # https://gitlab.com/graphviz/graphviz/issues/1327 hashed = sha1(dot.encode()).hexdigest() self.id = 'grapviz%s' % hashed[-10:] self.content[0] = self.content[0].replace('%3', self.id) for line in self.content: if self.href_re.search(line): self.clickable.append(line) def generate_clickable_map(self) -> str: """Generate clickable map tags if clickable item exists. If not exists, this only returns empty string. """ if self.clickable: return '\n'.join([self.content[0]] + self.clickable + [self.content[-1]]) else: return '' class graphviz(nodes.General, nodes.Inline, nodes.Element): pass def figure_wrapper(directive: Directive, node: graphviz, caption: str) -> nodes.figure: figure_node = nodes.figure('', node) if 'align' in node: figure_node['align'] = node.attributes.pop('align') inodes, messages = directive.state.inline_text(caption, directive.lineno) caption_node = nodes.caption(caption, '', *inodes) caption_node.extend(messages) set_source_info(directive, caption_node) figure_node += caption_node return figure_node def align_spec(argument: Any) -> str: return directives.choice(argument, ('left', 'center', 'right')) class Graphviz(SphinxDirective): """ Directive to insert arbitrary dot markup. """ has_content = True required_arguments = 0 optional_arguments = 1 final_argument_whitespace = False option_spec: OptionSpec = { 'alt': directives.unchanged, 'align': align_spec, 'caption': directives.unchanged, 'layout': directives.unchanged, 'graphviz_dot': directives.unchanged, # an old alias of `layout` option 'name': directives.unchanged, 'class': directives.class_option, } def run(self) -> List[Node]: if self.arguments: document = self.state.document if self.content: return [document.reporter.warning( __('Graphviz directive cannot have both content and ' 'a filename argument'), line=self.lineno)] argument = search_image_for_language(self.arguments[0], self.env) rel_filename, filename = self.env.relfn2path(argument) self.env.note_dependency(rel_filename) try: with open(filename, encoding='utf-8') as fp: dotcode = fp.read() except OSError: return [document.reporter.warning( __('External Graphviz file %r not found or reading ' 'it failed') % filename, line=self.lineno)] else: dotcode = '\n'.join(self.content) rel_filename = None if not dotcode.strip(): return [self.state_machine.reporter.warning( __('Ignoring "graphviz" directive without content.'), line=self.lineno)] node = graphviz() node['code'] = dotcode node['options'] = {'docname': self.env.docname} if 'graphviz_dot' in self.options: node['options']['graphviz_dot'] = self.options['graphviz_dot'] if 'layout' in self.options: node['options']['graphviz_dot'] = self.options['layout'] if 'alt' in self.options: node['alt'] = self.options['alt'] if 'align' in self.options: node['align'] = self.options['align'] if 'class' in self.options: node['classes'] = self.options['class'] if rel_filename: node['filename'] = rel_filename if 'caption' not in self.options: self.add_name(node) return [node] else: figure = figure_wrapper(self, node, self.options['caption']) self.add_name(figure) return [figure] class GraphvizSimple(SphinxDirective): """ Directive to insert arbitrary dot markup. """ has_content = True required_arguments = 1 optional_arguments = 0 final_argument_whitespace = False option_spec: OptionSpec = { 'alt': directives.unchanged, 'align': align_spec, 'caption': directives.unchanged, 'layout': directives.unchanged, 'graphviz_dot': directives.unchanged, # an old alias of `layout` option 'name': directives.unchanged, 'class': directives.class_option, } def run(self) -> List[Node]: node = graphviz() node['code'] = '%s %s {\n%s\n}\n' % \ (self.name, self.arguments[0], '\n'.join(self.content)) node['options'] = {'docname': self.env.docname} if 'graphviz_dot' in self.options: node['options']['graphviz_dot'] = self.options['graphviz_dot'] if 'layout' in self.options: node['options']['graphviz_dot'] = self.options['layout'] if 'alt' in self.options: node['alt'] = self.options['alt'] if 'align' in self.options: node['align'] = self.options['align'] if 'class' in self.options: node['classes'] = self.options['class'] if 'caption' not in self.options: self.add_name(node) return [node] else: figure = figure_wrapper(self, node, self.options['caption']) self.add_name(figure) return [figure] def render_dot(self: SphinxTranslator, code: str, options: Dict, format: str, prefix: str = 'graphviz', filename: str = None) -> Tuple[str, str]: """Render graphviz code into a PNG or PDF output file.""" graphviz_dot = options.get('graphviz_dot', self.builder.config.graphviz_dot) hashkey = (code + str(options) + str(graphviz_dot) + str(self.builder.config.graphviz_dot_args)).encode() fname = '%s-%s.%s' % (prefix, sha1(hashkey).hexdigest(), format) relfn = posixpath.join(self.builder.imgpath, fname) outfn = path.join(self.builder.outdir, self.builder.imagedir, fname) if path.isfile(outfn): return relfn, outfn if (hasattr(self.builder, '_graphviz_warned_dot') and self.builder._graphviz_warned_dot.get(graphviz_dot)): # type: ignore # NOQA return None, None ensuredir(path.dirname(outfn)) dot_args = [graphviz_dot] dot_args.extend(self.builder.config.graphviz_dot_args) dot_args.extend(['-T' + format, '-o' + outfn]) docname = options.get('docname', 'index') if filename: cwd = path.dirname(path.join(self.builder.srcdir, filename)) else: cwd = path.dirname(path.join(self.builder.srcdir, docname)) if format == 'png': dot_args.extend(['-Tcmapx', '-o%s.map' % outfn]) try: ret = subprocess.run(dot_args, input=code.encode(), stdout=PIPE, stderr=PIPE, cwd=cwd, check=True) if not path.isfile(outfn): raise GraphvizError(__('dot did not produce an output file:\n[stderr]\n%r\n' '[stdout]\n%r') % (ret.stderr, ret.stdout)) return relfn, outfn except OSError: logger.warning(__('dot command %r cannot be run (needed for graphviz ' 'output), check the graphviz_dot setting'), graphviz_dot) if not hasattr(self.builder, '_graphviz_warned_dot'): self.builder._graphviz_warned_dot = {} # type: ignore self.builder._graphviz_warned_dot[graphviz_dot] = True # type: ignore return None, None except CalledProcessError as exc: raise GraphvizError(__('dot exited with error:\n[stderr]\n%r\n' '[stdout]\n%r') % (exc.stderr, exc.stdout)) from exc def render_dot_html(self: HTMLTranslator, node: graphviz, code: str, options: Dict, prefix: str = 'graphviz', imgcls: str = None, alt: str = None, filename: str = None) -> Tuple[str, str]: format = self.builder.config.graphviz_output_format try: if format not in ('png', 'svg'): raise GraphvizError(__("graphviz_output_format must be one of 'png', " "'svg', but is %r") % format) fname, outfn = render_dot(self, code, options, format, prefix, filename) except GraphvizError as exc: logger.warning(__('dot code %r: %s'), code, exc) raise nodes.SkipNode from exc classes = [imgcls, 'graphviz'] + node.get('classes', []) imgcls = ' '.join(filter(None, classes)) if fname is None: self.body.append(self.encode(code)) else: if alt is None: alt = node.get('alt', self.encode(code).strip()) if 'align' in node: self.body.append('<div align="%s" class="align-%s">' % (node['align'], node['align'])) if format == 'svg': self.body.append('<div class="graphviz">') self.body.append('<object data="%s" type="image/svg+xml" class="%s">\n' % (fname, imgcls)) self.body.append('<p class="warning">%s</p>' % alt) self.body.append('</object></div>\n') else: with open(outfn + '.map', encoding='utf-8') as mapfile: imgmap = ClickableMapDefinition(outfn + '.map', mapfile.read(), dot=code) if imgmap.clickable: # has a map self.body.append('<div class="graphviz">') self.body.append('<img src="%s" alt="%s" usemap="#%s" class="%s" />' % (fname, alt, imgmap.id, imgcls)) self.body.append('</div>\n') self.body.append(imgmap.generate_clickable_map()) else: # nothing in image map self.body.append('<div class="graphviz">') self.body.append('<img src="%s" alt="%s" class="%s" />' % (fname, alt, imgcls)) self.body.append('</div>\n') if 'align' in node: self.body.append('</div>\n') raise nodes.SkipNode def html_visit_graphviz(self: HTMLTranslator, node: graphviz) -> None: render_dot_html(self, node, node['code'], node['options'], filename=node.get('filename')) def render_dot_latex(self: LaTeXTranslator, node: graphviz, code: str, options: Dict, prefix: str = 'graphviz', filename: str = None ) -> None: try: fname, outfn = render_dot(self, code, options, 'pdf', prefix, filename) except GraphvizError as exc: logger.warning(__('dot code %r: %s'), code, exc) raise nodes.SkipNode from exc is_inline = self.is_inline(node) if not is_inline: pre = '' post = '' if 'align' in node: if node['align'] == 'left': pre = '{' post = r'\hspace*{\fill}}' elif node['align'] == 'right': pre = r'{\hspace*{\fill}' post = '}' elif node['align'] == 'center': pre = r'{\hfill' post = r'\hspace*{\fill}}' self.body.append('\n%s' % pre) self.body.append(r'\sphinxincludegraphics[]{%s}' % fname) if not is_inline: self.body.append('%s\n' % post) raise nodes.SkipNode def latex_visit_graphviz(self: LaTeXTranslator, node: graphviz) -> None: render_dot_latex(self, node, node['code'], node['options'], filename=node.get('filename')) def render_dot_texinfo(self: TexinfoTranslator, node: graphviz, code: str, options: Dict, prefix: str = 'graphviz') -> None: try: fname, outfn = render_dot(self, code, options, 'png', prefix) except GraphvizError as exc: logger.warning(__('dot code %r: %s'), code, exc) raise nodes.SkipNode from exc if fname is not None: self.body.append('@image{%s,,,[graphviz],png}\n' % fname[:-4]) raise nodes.SkipNode def texinfo_visit_graphviz(self: TexinfoTranslator, node: graphviz) -> None: render_dot_texinfo(self, node, node['code'], node['options']) def text_visit_graphviz(self: TextTranslator, node: graphviz) -> None: if 'alt' in node.attributes: self.add_text(_('[graph: %s]') % node['alt']) else: self.add_text(_('[graph]')) raise nodes.SkipNode def man_visit_graphviz(self: ManualPageTranslator, node: graphviz) -> None: if 'alt' in node.attributes: self.body.append(_('[graph: %s]') % node['alt']) else: self.body.append(_('[graph]')) raise nodes.SkipNode def on_build_finished(app: Sphinx, exc: Exception) -> None: if exc is None and app.builder.format == 'html': src = path.join(sphinx.package_dir, 'templates', 'graphviz', 'graphviz.css') dst = path.join(app.outdir, '_static') copy_asset(src, dst) def setup(app: Sphinx) -> Dict[str, Any]: app.add_node(graphviz, html=(html_visit_graphviz, None), latex=(latex_visit_graphviz, None), texinfo=(texinfo_visit_graphviz, None), text=(text_visit_graphviz, None), man=(man_visit_graphviz, None)) app.add_directive('graphviz', Graphviz) app.add_directive('graph', GraphvizSimple) app.add_directive('digraph', GraphvizSimple) app.add_config_value('graphviz_dot', 'dot', 'html') app.add_config_value('graphviz_dot_args', [], 'html') app.add_config_value('graphviz_output_format', 'png', 'html') app.add_css_file('graphviz.css') app.connect('build-finished', on_build_finished) return {'version': sphinx.__display_version__, 'parallel_read_safe': True} �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/ifconfig.py�����������������������������������������������������������������0000644�0000766�0000024�00000005077�00000000000�016613� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.ifconfig ~~~~~~~~~~~~~~~~~~~ Provides the ``ifconfig`` directive that allows to write documentation that is included depending on configuration variables. Usage:: .. ifconfig:: releaselevel in ('alpha', 'beta', 'rc') This stuff is only included in the built docs for unstable versions. The argument for ``ifconfig`` is a plain Python expression, evaluated in the namespace of the project configuration (that is, all variables from ``conf.py`` are available.) :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Any, Dict, List from docutils import nodes from docutils.nodes import Node import sphinx from sphinx.application import Sphinx from sphinx.util.docutils import SphinxDirective from sphinx.util.nodes import nested_parse_with_titles from sphinx.util.typing import OptionSpec class ifconfig(nodes.Element): pass class IfConfig(SphinxDirective): has_content = True required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = {} def run(self) -> List[Node]: node = ifconfig() node.document = self.state.document self.set_source_info(node) node['expr'] = self.arguments[0] nested_parse_with_titles(self.state, self.content, node) return [node] def process_ifconfig_nodes(app: Sphinx, doctree: nodes.document, docname: str) -> None: ns = {confval.name: confval.value for confval in app.config} ns.update(app.config.__dict__.copy()) ns['builder'] = app.builder.name for node in doctree.traverse(ifconfig): try: res = eval(node['expr'], ns) except Exception as err: # handle exceptions in a clean fashion from traceback import format_exception_only msg = ''.join(format_exception_only(err.__class__, err)) newnode = doctree.reporter.error('Exception occurred in ' 'ifconfig expression: \n%s' % msg, base_node=node) node.replace_self(newnode) else: if not res: node.replace_self([]) else: node.replace_self(node.children) def setup(app: Sphinx) -> Dict[str, Any]: app.add_node(ifconfig) app.add_directive('ifconfig', IfConfig) app.connect('doctree-resolved', process_ifconfig_nodes) return {'version': sphinx.__display_version__, 'parallel_read_safe': True} �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/imgconverter.py�������������������������������������������������������������0000644�0000766�0000024�00000006704�00000000000�017531� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.imgconverter ~~~~~~~~~~~~~~~~~~~~~~~ Image converter extension for Sphinx :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import subprocess import sys from subprocess import PIPE, CalledProcessError from typing import Any, Dict from sphinx.application import Sphinx from sphinx.errors import ExtensionError from sphinx.locale import __ from sphinx.transforms.post_transforms.images import ImageConverter from sphinx.util import logging logger = logging.getLogger(__name__) class ImagemagickConverter(ImageConverter): conversion_rules = [ ('image/svg+xml', 'image/png'), ('image/gif', 'image/png'), ('application/pdf', 'image/png'), ('application/illustrator', 'image/png'), ] def is_available(self) -> bool: """Confirms the converter is available or not.""" try: args = [self.config.image_converter, '-version'] logger.debug('Invoking %r ...', args) subprocess.run(args, stdout=PIPE, stderr=PIPE, check=True) return True except OSError as exc: logger.warning(__('convert command %r cannot be run, ' 'check the image_converter setting: %s'), self.config.image_converter, exc) return False except CalledProcessError as exc: logger.warning(__('convert exited with error:\n' '[stderr]\n%r\n[stdout]\n%r'), exc.stderr, exc.stdout) return False def convert(self, _from: str, _to: str) -> bool: """Converts the image to expected one.""" try: # append an index 0 to source filename to pick up the first frame # (or first page) of image (ex. Animation GIF, PDF) _from += '[0]' args = ([self.config.image_converter] + self.config.image_converter_args + [_from, _to]) logger.debug('Invoking %r ...', args) subprocess.run(args, stdout=PIPE, stderr=PIPE, check=True) return True except OSError: logger.warning(__('convert command %r cannot be run, ' 'check the image_converter setting'), self.config.image_converter) return False except CalledProcessError as exc: raise ExtensionError(__('convert exited with error:\n' '[stderr]\n%r\n[stdout]\n%r') % (exc.stderr, exc.stdout)) from exc def setup(app: Sphinx) -> Dict[str, Any]: app.add_post_transform(ImagemagickConverter) if sys.platform == 'win32': # On Windows, we use Imagemagik v7 by default to avoid the trouble for # convert.exe bundled with Windows. app.add_config_value('image_converter', 'magick', 'env') app.add_config_value('image_converter_args', ['convert'], 'env') else: # On other platform, we use Imagemagick v6 by default. Especially, # Debian/Ubuntu are still based of v6. So we can't use "magick" command # for these platforms. app.add_config_value('image_converter', 'convert', 'env') app.add_config_value('image_converter_args', [], 'env') return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1638029276.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/imgmath.py������������������������������������������������������������������0000644�0000766�0000024�00000032015�00000000000�016445� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.imgmath ~~~~~~~~~~~~~~~~~~ Render math in HTML via dvipng or dvisvgm. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import posixpath import re import shutil import subprocess import tempfile from os import path from subprocess import PIPE, CalledProcessError from typing import Any, Dict, List, Tuple from docutils import nodes from docutils.nodes import Element import sphinx from sphinx import package_dir from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.config import Config from sphinx.errors import SphinxError from sphinx.locale import _, __ from sphinx.util import logging, sha1 from sphinx.util.math import get_node_equation_number, wrap_displaymath from sphinx.util.osutil import ensuredir from sphinx.util.png import read_png_depth, write_png_depth from sphinx.util.template import LaTeXRenderer from sphinx.writers.html import HTMLTranslator logger = logging.getLogger(__name__) templates_path = path.join(package_dir, 'templates', 'imgmath') class MathExtError(SphinxError): category = 'Math extension error' def __init__(self, msg: str, stderr: str = None, stdout: str = None) -> None: if stderr: msg += '\n[stderr]\n' + stderr if stdout: msg += '\n[stdout]\n' + stdout super().__init__(msg) class InvokeError(SphinxError): """errors on invoking converters.""" SUPPORT_FORMAT = ('png', 'svg') depth_re = re.compile(r'\[\d+ depth=(-?\d+)\]') depthsvg_re = re.compile(r'.*, depth=(.*)pt') depthsvgcomment_re = re.compile(r'<!-- DEPTH=(-?\d+) -->') def read_svg_depth(filename: str) -> int: """Read the depth from comment at last line of SVG file """ with open(filename) as f: for line in f: pass # Only last line is checked matched = depthsvgcomment_re.match(line) if matched: return int(matched.group(1)) return None def write_svg_depth(filename: str, depth: int) -> None: """Write the depth to SVG file as a comment at end of file """ with open(filename, 'a') as f: f.write('\n<!-- DEPTH=%s -->' % depth) def generate_latex_macro(image_format: str, math: str, config: Config, confdir: str = '') -> str: """Generate LaTeX macro.""" variables = { 'fontsize': config.imgmath_font_size, 'baselineskip': int(round(config.imgmath_font_size * 1.2)), 'preamble': config.imgmath_latex_preamble, 'tightpage': '' if image_format == 'png' else ',tightpage', 'math': math } if config.imgmath_use_preview: template_name = 'preview.tex_t' else: template_name = 'template.tex_t' for template_dir in config.templates_path: template = path.join(confdir, template_dir, template_name) if path.exists(template): return LaTeXRenderer().render(template, variables) return LaTeXRenderer(templates_path).render(template_name, variables) def ensure_tempdir(builder: Builder) -> str: """Create temporary directory. use only one tempdir per build -- the use of a directory is cleaner than using temporary files, since we can clean up everything at once just removing the whole directory (see cleanup_tempdir) """ if not hasattr(builder, '_imgmath_tempdir'): builder._imgmath_tempdir = tempfile.mkdtemp() # type: ignore return builder._imgmath_tempdir # type: ignore def compile_math(latex: str, builder: Builder) -> str: """Compile LaTeX macros for math to DVI.""" tempdir = ensure_tempdir(builder) filename = path.join(tempdir, 'math.tex') with open(filename, 'w', encoding='utf-8') as f: f.write(latex) # build latex command; old versions of latex don't have the # --output-directory option, so we have to manually chdir to the # temp dir to run it. command = [builder.config.imgmath_latex, '--interaction=nonstopmode'] # add custom args from the config file command.extend(builder.config.imgmath_latex_args) command.append('math.tex') try: subprocess.run(command, stdout=PIPE, stderr=PIPE, cwd=tempdir, check=True, encoding='ascii') return path.join(tempdir, 'math.dvi') except OSError as exc: logger.warning(__('LaTeX command %r cannot be run (needed for math ' 'display), check the imgmath_latex setting'), builder.config.imgmath_latex) raise InvokeError from exc except CalledProcessError as exc: raise MathExtError('latex exited with error', exc.stderr, exc.stdout) from exc def convert_dvi_to_image(command: List[str], name: str) -> Tuple[str, str]: """Convert DVI file to specific image format.""" try: ret = subprocess.run(command, stdout=PIPE, stderr=PIPE, check=True, encoding='ascii') return ret.stdout, ret.stderr except OSError as exc: logger.warning(__('%s command %r cannot be run (needed for math ' 'display), check the imgmath_%s setting'), name, command[0], name) raise InvokeError from exc except CalledProcessError as exc: raise MathExtError('%s exited with error' % name, exc.stderr, exc.stdout) from exc def convert_dvi_to_png(dvipath: str, builder: Builder) -> Tuple[str, int]: """Convert DVI file to PNG image.""" tempdir = ensure_tempdir(builder) filename = path.join(tempdir, 'math.png') name = 'dvipng' command = [builder.config.imgmath_dvipng, '-o', filename, '-T', 'tight', '-z9'] command.extend(builder.config.imgmath_dvipng_args) if builder.config.imgmath_use_preview: command.append('--depth') command.append(dvipath) stdout, stderr = convert_dvi_to_image(command, name) depth = None if builder.config.imgmath_use_preview: for line in stdout.splitlines(): matched = depth_re.match(line) if matched: depth = int(matched.group(1)) write_png_depth(filename, depth) break return filename, depth def convert_dvi_to_svg(dvipath: str, builder: Builder) -> Tuple[str, int]: """Convert DVI file to SVG image.""" tempdir = ensure_tempdir(builder) filename = path.join(tempdir, 'math.svg') name = 'dvisvgm' command = [builder.config.imgmath_dvisvgm, '-o', filename] command.extend(builder.config.imgmath_dvisvgm_args) command.append(dvipath) stdout, stderr = convert_dvi_to_image(command, name) depth = None if builder.config.imgmath_use_preview: for line in stderr.splitlines(): # not stdout ! matched = depthsvg_re.match(line) if matched: depth = round(float(matched.group(1)) * 100 / 72.27) # assume 100ppi write_svg_depth(filename, depth) break return filename, depth def render_math(self: HTMLTranslator, math: str) -> Tuple[str, int]: """Render the LaTeX math expression *math* using latex and dvipng or dvisvgm. Return the filename relative to the built document and the "depth", that is, the distance of image bottom and baseline in pixels, if the option to use preview_latex is switched on. Error handling may seem strange, but follows a pattern: if LaTeX or dvipng (dvisvgm) aren't available, only a warning is generated (since that enables people on machines without these programs to at least build the rest of the docs successfully). If the programs are there, however, they may not fail since that indicates a problem in the math source. """ image_format = self.builder.config.imgmath_image_format.lower() if image_format not in SUPPORT_FORMAT: raise MathExtError('imgmath_image_format must be either "png" or "svg"') latex = generate_latex_macro(image_format, math, self.builder.config, self.builder.confdir) filename = "%s.%s" % (sha1(latex.encode()).hexdigest(), image_format) relfn = posixpath.join(self.builder.imgpath, 'math', filename) outfn = path.join(self.builder.outdir, self.builder.imagedir, 'math', filename) if path.isfile(outfn): if image_format == 'png': depth = read_png_depth(outfn) elif image_format == 'svg': depth = read_svg_depth(outfn) return relfn, depth # if latex or dvipng (dvisvgm) has failed once, don't bother to try again if hasattr(self.builder, '_imgmath_warned_latex') or \ hasattr(self.builder, '_imgmath_warned_image_translator'): return None, None # .tex -> .dvi try: dvipath = compile_math(latex, self.builder) except InvokeError: self.builder._imgmath_warned_latex = True # type: ignore return None, None # .dvi -> .png/.svg try: if image_format == 'png': imgpath, depth = convert_dvi_to_png(dvipath, self.builder) elif image_format == 'svg': imgpath, depth = convert_dvi_to_svg(dvipath, self.builder) except InvokeError: self.builder._imgmath_warned_image_translator = True # type: ignore return None, None # Move generated image on tempdir to build dir ensuredir(path.dirname(outfn)) shutil.move(imgpath, outfn) return relfn, depth def cleanup_tempdir(app: Sphinx, exc: Exception) -> None: if exc: return if not hasattr(app.builder, '_imgmath_tempdir'): return try: shutil.rmtree(app.builder._mathpng_tempdir) # type: ignore except Exception: pass def get_tooltip(self: HTMLTranslator, node: Element) -> str: if self.builder.config.imgmath_add_tooltips: return ' alt="%s"' % self.encode(node.astext()).strip() return '' def html_visit_math(self: HTMLTranslator, node: nodes.math) -> None: try: fname, depth = render_math(self, '$' + node.astext() + '$') except MathExtError as exc: msg = str(exc) sm = nodes.system_message(msg, type='WARNING', level=2, backrefs=[], source=node.astext()) sm.walkabout(self) logger.warning(__('display latex %r: %s'), node.astext(), msg) raise nodes.SkipNode from exc if fname is None: # something failed -- use text-only as a bad substitute self.body.append('<span class="math">%s</span>' % self.encode(node.astext()).strip()) else: c = ('<img class="math" src="%s"' % fname) + get_tooltip(self, node) if depth is not None: c += ' style="vertical-align: %dpx"' % (-depth) self.body.append(c + '/>') raise nodes.SkipNode def html_visit_displaymath(self: HTMLTranslator, node: nodes.math_block) -> None: if node['nowrap']: latex = node.astext() else: latex = wrap_displaymath(node.astext(), None, False) try: fname, depth = render_math(self, latex) except MathExtError as exc: msg = str(exc) sm = nodes.system_message(msg, type='WARNING', level=2, backrefs=[], source=node.astext()) sm.walkabout(self) logger.warning(__('inline latex %r: %s'), node.astext(), msg) raise nodes.SkipNode from exc self.body.append(self.starttag(node, 'div', CLASS='math')) self.body.append('<p>') if node['number']: number = get_node_equation_number(self, node) self.body.append('<span class="eqno">(%s)' % number) self.add_permalink_ref(node, _('Permalink to this equation')) self.body.append('</span>') if fname is None: # something failed -- use text-only as a bad substitute self.body.append('<span class="math">%s</span></p>\n</div>' % self.encode(node.astext()).strip()) else: self.body.append(('<img src="%s"' % fname) + get_tooltip(self, node) + '/></p>\n</div>') raise nodes.SkipNode def setup(app: Sphinx) -> Dict[str, Any]: app.add_html_math_renderer('imgmath', (html_visit_math, None), (html_visit_displaymath, None)) app.add_config_value('imgmath_image_format', 'png', 'html') app.add_config_value('imgmath_dvipng', 'dvipng', 'html') app.add_config_value('imgmath_dvisvgm', 'dvisvgm', 'html') app.add_config_value('imgmath_latex', 'latex', 'html') app.add_config_value('imgmath_use_preview', False, 'html') app.add_config_value('imgmath_dvipng_args', ['-gamma', '1.5', '-D', '110', '-bg', 'Transparent'], 'html') app.add_config_value('imgmath_dvisvgm_args', ['--no-fonts'], 'html') app.add_config_value('imgmath_latex_args', [], 'html') app.add_config_value('imgmath_latex_preamble', '', 'html') app.add_config_value('imgmath_add_tooltips', True, 'html') app.add_config_value('imgmath_font_size', 12, 'html') app.connect('build-finished', cleanup_tempdir) return {'version': sphinx.__display_version__, 'parallel_read_safe': True} �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/inheritance_diagram.py������������������������������������������������������0000644�0000766�0000024�00000041441�00000000000�020777� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������r""" sphinx.ext.inheritance_diagram ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Defines a docutils directive for inserting inheritance diagrams. Provide the directive with one or more classes or modules (separated by whitespace). For modules, all of the classes in that module will be used. Example:: Given the following classes: class A: pass class B(A): pass class C(A): pass class D(B, C): pass class E(B): pass .. inheritance-diagram: D E Produces a graph like the following: A / \ B C / \ / E D The graph is inserted as a PNG+image map into HTML and a PDF in LaTeX. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import builtins import inspect import re from importlib import import_module from typing import Any, Dict, Iterable, List, Tuple, cast from docutils import nodes from docutils.nodes import Node from docutils.parsers.rst import directives import sphinx from sphinx import addnodes from sphinx.application import Sphinx from sphinx.environment import BuildEnvironment from sphinx.ext.graphviz import (figure_wrapper, graphviz, render_dot_html, render_dot_latex, render_dot_texinfo) from sphinx.util import md5 from sphinx.util.docutils import SphinxDirective from sphinx.util.typing import OptionSpec from sphinx.writers.html import HTMLTranslator from sphinx.writers.latex import LaTeXTranslator from sphinx.writers.texinfo import TexinfoTranslator module_sig_re = re.compile(r'''^(?:([\w.]*)\.)? # module names (\w+) \s* $ # class/final module name ''', re.VERBOSE) py_builtins = [obj for obj in vars(builtins).values() if inspect.isclass(obj)] def try_import(objname: str) -> Any: """Import a object or module using *name* and *currentmodule*. *name* should be a relative name from *currentmodule* or a fully-qualified name. Returns imported object or module. If failed, returns None value. """ try: return import_module(objname) except TypeError: # Relative import return None except ImportError: matched = module_sig_re.match(objname) if not matched: return None modname, attrname = matched.groups() if modname is None: return None try: module = import_module(modname) return getattr(module, attrname, None) except ImportError: return None def import_classes(name: str, currmodule: str) -> Any: """Import a class using its fully-qualified *name*.""" target = None # import class or module using currmodule if currmodule: target = try_import(currmodule + '.' + name) # import class or module without currmodule if target is None: target = try_import(name) if target is None: raise InheritanceException( 'Could not import class or module %r specified for ' 'inheritance diagram' % name) if inspect.isclass(target): # If imported object is a class, just return it return [target] elif inspect.ismodule(target): # If imported object is a module, return classes defined on it classes = [] for cls in target.__dict__.values(): if inspect.isclass(cls) and cls.__module__ == target.__name__: classes.append(cls) return classes raise InheritanceException('%r specified for inheritance diagram is ' 'not a class or module' % name) class InheritanceException(Exception): pass class InheritanceGraph: """ Given a list of classes, determines the set of classes that they inherit from all the way to the root "object", and then is able to generate a graphviz dot graph from them. """ def __init__(self, class_names: List[str], currmodule: str, show_builtins: bool = False, private_bases: bool = False, parts: int = 0, aliases: Dict[str, str] = None, top_classes: List[Any] = []) -> None: """*class_names* is a list of child classes to show bases from. If *show_builtins* is True, then Python builtins will be shown in the graph. """ self.class_names = class_names classes = self._import_classes(class_names, currmodule) self.class_info = self._class_info(classes, show_builtins, private_bases, parts, aliases, top_classes) if not self.class_info: raise InheritanceException('No classes found for ' 'inheritance diagram') def _import_classes(self, class_names: List[str], currmodule: str) -> List[Any]: """Import a list of classes.""" classes: List[Any] = [] for name in class_names: classes.extend(import_classes(name, currmodule)) return classes def _class_info(self, classes: List[Any], show_builtins: bool, private_bases: bool, parts: int, aliases: Dict[str, str], top_classes: List[Any] ) -> List[Tuple[str, str, List[str], str]]: """Return name and bases for all classes that are ancestors of *classes*. *parts* gives the number of dotted name parts to include in the displayed node names, from right to left. If given as a negative, the number of parts to drop from the left. A value of 0 displays the full dotted name. E.g. ``sphinx.ext.inheritance_diagram.InheritanceGraph`` with ``parts=2`` or ``parts=-2`` gets displayed as ``inheritance_diagram.InheritanceGraph``, and as ``ext.inheritance_diagram.InheritanceGraph`` with ``parts=3`` or ``parts=-1``. *top_classes* gives the name(s) of the top most ancestor class to traverse to. Multiple names can be specified separated by comma. """ all_classes = {} def recurse(cls: Any) -> None: if not show_builtins and cls in py_builtins: return if not private_bases and cls.__name__.startswith('_'): return nodename = self.class_name(cls, parts, aliases) fullname = self.class_name(cls, 0, aliases) # Use first line of docstring as tooltip, if available tooltip = None try: if cls.__doc__: doc = cls.__doc__.strip().split("\n")[0] if doc: tooltip = '"%s"' % doc.replace('"', '\\"') except Exception: # might raise AttributeError for strange classes pass baselist: List[str] = [] all_classes[cls] = (nodename, fullname, baselist, tooltip) if fullname in top_classes: return for base in cls.__bases__: if not show_builtins and base in py_builtins: continue if not private_bases and base.__name__.startswith('_'): continue baselist.append(self.class_name(base, parts, aliases)) if base not in all_classes: recurse(base) for cls in classes: recurse(cls) return list(all_classes.values()) def class_name(self, cls: Any, parts: int = 0, aliases: Dict[str, str] = None) -> str: """Given a class object, return a fully-qualified name. This works for things I've tested in matplotlib so far, but may not be completely general. """ module = cls.__module__ if module in ('__builtin__', 'builtins'): fullname = cls.__name__ else: fullname = '%s.%s' % (module, cls.__qualname__) if parts == 0: result = fullname else: name_parts = fullname.split('.') result = '.'.join(name_parts[-parts:]) if aliases is not None and result in aliases: return aliases[result] return result def get_all_class_names(self) -> List[str]: """Get all of the class names involved in the graph.""" return [fullname for (_, fullname, _, _) in self.class_info] # These are the default attrs for graphviz default_graph_attrs = { 'rankdir': 'LR', 'size': '"8.0, 12.0"', 'bgcolor': 'transparent', } default_node_attrs = { 'shape': 'box', 'fontsize': 10, 'height': 0.25, 'fontname': '"Vera Sans, DejaVu Sans, Liberation Sans, ' 'Arial, Helvetica, sans"', 'style': '"setlinewidth(0.5),filled"', 'fillcolor': 'white', } default_edge_attrs = { 'arrowsize': 0.5, 'style': '"setlinewidth(0.5)"', } def _format_node_attrs(self, attrs: Dict) -> str: return ','.join(['%s=%s' % x for x in sorted(attrs.items())]) def _format_graph_attrs(self, attrs: Dict) -> str: return ''.join(['%s=%s;\n' % x for x in sorted(attrs.items())]) def generate_dot(self, name: str, urls: Dict = {}, env: BuildEnvironment = None, graph_attrs: Dict = {}, node_attrs: Dict = {}, edge_attrs: Dict = {} ) -> str: """Generate a graphviz dot graph from the classes that were passed in to __init__. *name* is the name of the graph. *urls* is a dictionary mapping class names to HTTP URLs. *graph_attrs*, *node_attrs*, *edge_attrs* are dictionaries containing key/value pairs to pass on as graphviz properties. """ g_attrs = self.default_graph_attrs.copy() n_attrs = self.default_node_attrs.copy() e_attrs = self.default_edge_attrs.copy() g_attrs.update(graph_attrs) n_attrs.update(node_attrs) e_attrs.update(edge_attrs) if env: g_attrs.update(env.config.inheritance_graph_attrs) n_attrs.update(env.config.inheritance_node_attrs) e_attrs.update(env.config.inheritance_edge_attrs) res: List[str] = [] res.append('digraph %s {\n' % name) res.append(self._format_graph_attrs(g_attrs)) for name, fullname, bases, tooltip in sorted(self.class_info): # Write the node this_node_attrs = n_attrs.copy() if fullname in urls: this_node_attrs['URL'] = '"%s"' % urls[fullname] this_node_attrs['target'] = '"_top"' if tooltip: this_node_attrs['tooltip'] = tooltip res.append(' "%s" [%s];\n' % (name, self._format_node_attrs(this_node_attrs))) # Write the edges for base_name in bases: res.append(' "%s" -> "%s" [%s];\n' % (base_name, name, self._format_node_attrs(e_attrs))) res.append('}\n') return ''.join(res) class inheritance_diagram(graphviz): """ A docutils node to use as a placeholder for the inheritance diagram. """ pass class InheritanceDiagram(SphinxDirective): """ Run when the inheritance_diagram directive is first encountered. """ has_content = False required_arguments = 1 optional_arguments = 0 final_argument_whitespace = True option_spec: OptionSpec = { 'parts': int, 'private-bases': directives.flag, 'caption': directives.unchanged, 'top-classes': directives.unchanged_required, } def run(self) -> List[Node]: node = inheritance_diagram() node.document = self.state.document class_names = self.arguments[0].split() class_role = self.env.get_domain('py').role('class') # Store the original content for use as a hash node['parts'] = self.options.get('parts', 0) node['content'] = ', '.join(class_names) node['top-classes'] = [] for cls in self.options.get('top-classes', '').split(','): cls = cls.strip() if cls: node['top-classes'].append(cls) # Create a graph starting with the list of classes try: graph = InheritanceGraph( class_names, self.env.ref_context.get('py:module'), parts=node['parts'], private_bases='private-bases' in self.options, aliases=self.config.inheritance_alias, top_classes=node['top-classes']) except InheritanceException as err: return [node.document.reporter.warning(err, line=self.lineno)] # Create xref nodes for each target of the graph's image map and # add them to the doc tree so that Sphinx can resolve the # references to real URLs later. These nodes will eventually be # removed from the doctree after we're done with them. for name in graph.get_all_class_names(): refnodes, x = class_role( # type: ignore 'class', ':class:`%s`' % name, name, 0, self.state) # type: ignore node.extend(refnodes) # Store the graph object so we can use it to generate the # dot file later node['graph'] = graph if 'caption' not in self.options: self.add_name(node) return [node] else: figure = figure_wrapper(self, node, self.options['caption']) self.add_name(figure) return [figure] def get_graph_hash(node: inheritance_diagram) -> str: encoded = (node['content'] + str(node['parts'])).encode() return md5(encoded).hexdigest()[-10:] def html_visit_inheritance_diagram(self: HTMLTranslator, node: inheritance_diagram) -> None: """ Output the graph for HTML. This will insert a PNG with clickable image map. """ graph = node['graph'] graph_hash = get_graph_hash(node) name = 'inheritance%s' % graph_hash # Create a mapping from fully-qualified class names to URLs. graphviz_output_format = self.builder.env.config.graphviz_output_format.upper() current_filename = self.builder.current_docname + self.builder.out_suffix urls = {} pending_xrefs = cast(Iterable[addnodes.pending_xref], node) for child in pending_xrefs: if child.get('refuri') is not None: if graphviz_output_format == 'SVG': urls[child['reftitle']] = "../" + child.get('refuri') else: urls[child['reftitle']] = child.get('refuri') elif child.get('refid') is not None: if graphviz_output_format == 'SVG': urls[child['reftitle']] = '../' + current_filename + '#' + child.get('refid') else: urls[child['reftitle']] = '#' + child.get('refid') dotcode = graph.generate_dot(name, urls, env=self.builder.env) render_dot_html(self, node, dotcode, {}, 'inheritance', 'inheritance', alt='Inheritance diagram of ' + node['content']) raise nodes.SkipNode def latex_visit_inheritance_diagram(self: LaTeXTranslator, node: inheritance_diagram) -> None: """ Output the graph for LaTeX. This will insert a PDF. """ graph = node['graph'] graph_hash = get_graph_hash(node) name = 'inheritance%s' % graph_hash dotcode = graph.generate_dot(name, env=self.builder.env, graph_attrs={'size': '"6.0,6.0"'}) render_dot_latex(self, node, dotcode, {}, 'inheritance') raise nodes.SkipNode def texinfo_visit_inheritance_diagram(self: TexinfoTranslator, node: inheritance_diagram ) -> None: """ Output the graph for Texinfo. This will insert a PNG. """ graph = node['graph'] graph_hash = get_graph_hash(node) name = 'inheritance%s' % graph_hash dotcode = graph.generate_dot(name, env=self.builder.env, graph_attrs={'size': '"6.0,6.0"'}) render_dot_texinfo(self, node, dotcode, {}, 'inheritance') raise nodes.SkipNode def skip(self: nodes.NodeVisitor, node: inheritance_diagram) -> None: raise nodes.SkipNode def setup(app: Sphinx) -> Dict[str, Any]: app.setup_extension('sphinx.ext.graphviz') app.add_node( inheritance_diagram, latex=(latex_visit_inheritance_diagram, None), html=(html_visit_inheritance_diagram, None), text=(skip, None), man=(skip, None), texinfo=(texinfo_visit_inheritance_diagram, None)) app.add_directive('inheritance-diagram', InheritanceDiagram) app.add_config_value('inheritance_graph_attrs', {}, False) app.add_config_value('inheritance_node_attrs', {}, False) app.add_config_value('inheritance_edge_attrs', {}, False) app.add_config_value('inheritance_alias', {}, False) return {'version': sphinx.__display_version__, 'parallel_read_safe': True} �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/intersphinx.py��������������������������������������������������������������0000644�0000766�0000024�00000052014�00000000000�017373� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.intersphinx ~~~~~~~~~~~~~~~~~~~~~~ Insert links to objects documented in remote Sphinx documentation. This works as follows: * Each Sphinx HTML build creates a file named "objects.inv" that contains a mapping from object names to URIs relative to the HTML set's root. * Projects using the Intersphinx extension can specify links to such mapping files in the `intersphinx_mapping` config value. The mapping will then be used to resolve otherwise missing references to objects into links to the other documentation. * By default, the mapping file is assumed to be at the same location as the rest of the documentation; however, the location of the mapping file can also be specified individually, e.g. if the docs should be buildable without Internet access. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import concurrent.futures import functools import posixpath import sys import time from os import path from typing import IO, Any, Dict, List, Optional, Tuple from urllib.parse import urlsplit, urlunsplit from docutils import nodes from docutils.nodes import Element, TextElement from docutils.utils import relative_path import sphinx from sphinx.addnodes import pending_xref from sphinx.application import Sphinx from sphinx.builders.html import INVENTORY_FILENAME from sphinx.config import Config from sphinx.domains import Domain from sphinx.environment import BuildEnvironment from sphinx.locale import _, __ from sphinx.util import logging, requests from sphinx.util.inventory import InventoryFile from sphinx.util.typing import Inventory, InventoryItem logger = logging.getLogger(__name__) class InventoryAdapter: """Inventory adapter for environment""" def __init__(self, env: BuildEnvironment) -> None: self.env = env if not hasattr(env, 'intersphinx_cache'): self.env.intersphinx_cache = {} # type: ignore self.env.intersphinx_inventory = {} # type: ignore self.env.intersphinx_named_inventory = {} # type: ignore @property def cache(self) -> Dict[str, Tuple[str, int, Inventory]]: return self.env.intersphinx_cache # type: ignore @property def main_inventory(self) -> Inventory: return self.env.intersphinx_inventory # type: ignore @property def named_inventory(self) -> Dict[str, Inventory]: return self.env.intersphinx_named_inventory # type: ignore def clear(self) -> None: self.env.intersphinx_inventory.clear() # type: ignore self.env.intersphinx_named_inventory.clear() # type: ignore def _strip_basic_auth(url: str) -> str: """Returns *url* with basic auth credentials removed. Also returns the basic auth username and password if they're present in *url*. E.g.: https://user:pass@example.com => https://example.com *url* need not include basic auth credentials. :param url: url which may or may not contain basic auth credentials :type url: ``str`` :return: *url* with any basic auth creds removed :rtype: ``str`` """ frags = list(urlsplit(url)) # swap out "user[:pass]@hostname" for "hostname" if '@' in frags[1]: frags[1] = frags[1].split('@')[1] return urlunsplit(frags) def _read_from_url(url: str, config: Config = None) -> IO: """Reads data from *url* with an HTTP *GET*. This function supports fetching from resources which use basic HTTP auth as laid out by RFC1738 § 3.1. See § 5 for grammar definitions for URLs. .. seealso: https://www.ietf.org/rfc/rfc1738.txt :param url: URL of an HTTP resource :type url: ``str`` :return: data read from resource described by *url* :rtype: ``file``-like object """ r = requests.get(url, stream=True, config=config, timeout=config.intersphinx_timeout) r.raise_for_status() r.raw.url = r.url # decode content-body based on the header. # ref: https://github.com/kennethreitz/requests/issues/2155 r.raw.read = functools.partial(r.raw.read, decode_content=True) return r.raw def _get_safe_url(url: str) -> str: """Gets version of *url* with basic auth passwords obscured. This function returns results suitable for printing and logging. E.g.: https://user:12345@example.com => https://user@example.com :param url: a url :type url: ``str`` :return: *url* with password removed :rtype: ``str`` """ parts = urlsplit(url) if parts.username is None: return url else: frags = list(parts) if parts.port: frags[1] = '{}@{}:{}'.format(parts.username, parts.hostname, parts.port) else: frags[1] = '{}@{}'.format(parts.username, parts.hostname) return urlunsplit(frags) def fetch_inventory(app: Sphinx, uri: str, inv: Any) -> Any: """Fetch, parse and return an intersphinx inventory file.""" # both *uri* (base URI of the links to generate) and *inv* (actual # location of the inventory file) can be local or remote URIs localuri = '://' not in uri if not localuri: # case: inv URI points to remote resource; strip any existing auth uri = _strip_basic_auth(uri) try: if '://' in inv: f = _read_from_url(inv, config=app.config) else: f = open(path.join(app.srcdir, inv), 'rb') except Exception as err: err.args = ('intersphinx inventory %r not fetchable due to %s: %s', inv, err.__class__, str(err)) raise try: if hasattr(f, 'url'): newinv = f.url # type: ignore if inv != newinv: logger.info(__('intersphinx inventory has moved: %s -> %s'), inv, newinv) if uri in (inv, path.dirname(inv), path.dirname(inv) + '/'): uri = path.dirname(newinv) with f: try: join = path.join if localuri else posixpath.join invdata = InventoryFile.load(f, uri, join) except ValueError as exc: raise ValueError('unknown or unsupported inventory version: %r' % exc) from exc except Exception as err: err.args = ('intersphinx inventory %r not readable due to %s: %s', inv, err.__class__.__name__, str(err)) raise else: return invdata def fetch_inventory_group( name: str, uri: str, invs: Any, cache: Any, app: Any, now: float ) -> bool: cache_time = now - app.config.intersphinx_cache_limit * 86400 failures = [] try: for inv in invs: if not inv: inv = posixpath.join(uri, INVENTORY_FILENAME) # decide whether the inventory must be read: always read local # files; remote ones only if the cache time is expired if '://' not in inv or uri not in cache or cache[uri][1] < cache_time: safe_inv_url = _get_safe_url(inv) logger.info(__('loading intersphinx inventory from %s...'), safe_inv_url) try: invdata = fetch_inventory(app, uri, inv) except Exception as err: failures.append(err.args) continue if invdata: cache[uri] = (name, now, invdata) return True return False finally: if failures == []: pass elif len(failures) < len(invs): logger.info(__("encountered some issues with some of the inventories," " but they had working alternatives:")) for fail in failures: logger.info(*fail) else: issues = '\n'.join([f[0] % f[1:] for f in failures]) logger.warning(__("failed to reach any of the inventories " "with the following issues:") + "\n" + issues) def load_mappings(app: Sphinx) -> None: """Load all intersphinx mappings into the environment.""" now = int(time.time()) inventories = InventoryAdapter(app.builder.env) with concurrent.futures.ThreadPoolExecutor() as pool: futures = [] for name, (uri, invs) in app.config.intersphinx_mapping.values(): futures.append(pool.submit( fetch_inventory_group, name, uri, invs, inventories.cache, app, now )) updated = [f.result() for f in concurrent.futures.as_completed(futures)] if any(updated): inventories.clear() # Duplicate values in different inventories will shadow each # other; which one will override which can vary between builds # since they are specified using an unordered dict. To make # it more consistent, we sort the named inventories and then # add the unnamed inventories last. This means that the # unnamed inventories will shadow the named ones but the named # ones can still be accessed when the name is specified. cached_vals = list(inventories.cache.values()) named_vals = sorted(v for v in cached_vals if v[0]) unnamed_vals = [v for v in cached_vals if not v[0]] for name, _x, invdata in named_vals + unnamed_vals: if name: inventories.named_inventory[name] = invdata for type, objects in invdata.items(): inventories.main_inventory.setdefault(type, {}).update(objects) def _create_element_from_result(domain: Domain, inv_name: Optional[str], data: InventoryItem, node: pending_xref, contnode: TextElement) -> Element: proj, version, uri, dispname = data if '://' not in uri and node.get('refdoc'): # get correct path in case of subdirectories uri = path.join(relative_path(node['refdoc'], '.'), uri) if version: reftitle = _('(in %s v%s)') % (proj, version) else: reftitle = _('(in %s)') % (proj,) newnode = nodes.reference('', '', internal=False, refuri=uri, reftitle=reftitle) if node.get('refexplicit'): # use whatever title was given newnode.append(contnode) elif dispname == '-' or \ (domain.name == 'std' and node['reftype'] == 'keyword'): # use whatever title was given, but strip prefix title = contnode.astext() if inv_name is not None and title.startswith(inv_name + ':'): newnode.append(contnode.__class__(title[len(inv_name) + 1:], title[len(inv_name) + 1:])) else: newnode.append(contnode) else: # else use the given display name (used for :ref:) newnode.append(contnode.__class__(dispname, dispname)) return newnode def _resolve_reference_in_domain_by_target( inv_name: Optional[str], inventory: Inventory, domain: Domain, objtypes: List[str], target: str, node: pending_xref, contnode: TextElement) -> Optional[Element]: for objtype in objtypes: if objtype not in inventory: # Continue if there's nothing of this kind in the inventory continue if target in inventory[objtype]: # Case sensitive match, use it data = inventory[objtype][target] elif objtype == 'std:term': # Check for potential case insensitive matches for terms only target_lower = target.lower() insensitive_matches = list(filter(lambda k: k.lower() == target_lower, inventory[objtype].keys())) if insensitive_matches: data = inventory[objtype][insensitive_matches[0]] else: # No case insensitive match either, continue to the next candidate continue else: # Could reach here if we're not a term but have a case insensitive match. # This is a fix for terms specifically, but potentially should apply to # other types. continue return _create_element_from_result(domain, inv_name, data, node, contnode) return None def _resolve_reference_in_domain(env: BuildEnvironment, inv_name: Optional[str], inventory: Inventory, honor_disabled_refs: bool, domain: Domain, objtypes: List[str], node: pending_xref, contnode: TextElement ) -> Optional[Element]: # we adjust the object types for backwards compatibility if domain.name == 'std' and 'cmdoption' in objtypes: # until Sphinx-1.6, cmdoptions are stored as std:option objtypes.append('option') if domain.name == 'py' and 'attribute' in objtypes: # Since Sphinx-2.1, properties are stored as py:method objtypes.append('method') # the inventory contains domain:type as objtype objtypes = ["{}:{}".format(domain.name, t) for t in objtypes] # now that the objtypes list is complete we can remove the disabled ones if honor_disabled_refs: disabled = env.config.intersphinx_disabled_reftypes objtypes = [o for o in objtypes if o not in disabled] # without qualification res = _resolve_reference_in_domain_by_target(inv_name, inventory, domain, objtypes, node['reftarget'], node, contnode) if res is not None: return res # try with qualification of the current scope instead full_qualified_name = domain.get_full_qualified_name(node) if full_qualified_name is None: return None return _resolve_reference_in_domain_by_target(inv_name, inventory, domain, objtypes, full_qualified_name, node, contnode) def _resolve_reference(env: BuildEnvironment, inv_name: Optional[str], inventory: Inventory, honor_disabled_refs: bool, node: pending_xref, contnode: TextElement) -> Optional[Element]: # disabling should only be done if no inventory is given honor_disabled_refs = honor_disabled_refs and inv_name is None if honor_disabled_refs and '*' in env.config.intersphinx_disabled_reftypes: return None typ = node['reftype'] if typ == 'any': for domain_name, domain in env.domains.items(): if honor_disabled_refs \ and (domain_name + ":*") in env.config.intersphinx_disabled_reftypes: continue objtypes = list(domain.object_types) res = _resolve_reference_in_domain(env, inv_name, inventory, honor_disabled_refs, domain, objtypes, node, contnode) if res is not None: return res return None else: domain_name = node.get('refdomain') if not domain_name: # only objects in domains are in the inventory return None if honor_disabled_refs \ and (domain_name + ":*") in env.config.intersphinx_disabled_reftypes: return None domain = env.get_domain(domain_name) objtypes = domain.objtypes_for_role(typ) if not objtypes: return None return _resolve_reference_in_domain(env, inv_name, inventory, honor_disabled_refs, domain, objtypes, node, contnode) def inventory_exists(env: BuildEnvironment, inv_name: str) -> bool: return inv_name in InventoryAdapter(env).named_inventory def resolve_reference_in_inventory(env: BuildEnvironment, inv_name: str, node: pending_xref, contnode: TextElement ) -> Optional[Element]: """Attempt to resolve a missing reference via intersphinx references. Resolution is tried in the given inventory with the target as is. Requires ``inventory_exists(env, inv_name)``. """ assert inventory_exists(env, inv_name) return _resolve_reference(env, inv_name, InventoryAdapter(env).named_inventory[inv_name], False, node, contnode) def resolve_reference_any_inventory(env: BuildEnvironment, honor_disabled_refs: bool, node: pending_xref, contnode: TextElement ) -> Optional[Element]: """Attempt to resolve a missing reference via intersphinx references. Resolution is tried with the target as is in any inventory. """ return _resolve_reference(env, None, InventoryAdapter(env).main_inventory, honor_disabled_refs, node, contnode) def resolve_reference_detect_inventory(env: BuildEnvironment, node: pending_xref, contnode: TextElement ) -> Optional[Element]: """Attempt to resolve a missing reference via intersphinx references. Resolution is tried first with the target as is in any inventory. If this does not succeed, then the target is split by the first ``:``, to form ``inv_name:newtarget``. If ``inv_name`` is a named inventory, then resolution is tried in that inventory with the new target. """ # ordinary direct lookup, use data as is res = resolve_reference_any_inventory(env, True, node, contnode) if res is not None: return res # try splitting the target into 'inv_name:target' target = node['reftarget'] if ':' not in target: return None inv_name, newtarget = target.split(':', 1) if not inventory_exists(env, inv_name): return None node['reftarget'] = newtarget res_inv = resolve_reference_in_inventory(env, inv_name, node, contnode) node['reftarget'] = target return res_inv def missing_reference(app: Sphinx, env: BuildEnvironment, node: pending_xref, contnode: TextElement) -> Optional[Element]: """Attempt to resolve a missing reference via intersphinx references.""" return resolve_reference_detect_inventory(env, node, contnode) def normalize_intersphinx_mapping(app: Sphinx, config: Config) -> None: for key, value in config.intersphinx_mapping.copy().items(): try: if isinstance(value, (list, tuple)): # new format name, (uri, inv) = key, value if not isinstance(name, str): logger.warning(__('intersphinx identifier %r is not string. Ignored'), name) config.intersphinx_mapping.pop(key) continue else: # old format, no name name, uri, inv = None, key, value if not isinstance(inv, tuple): config.intersphinx_mapping[key] = (name, (uri, (inv,))) else: config.intersphinx_mapping[key] = (name, (uri, inv)) except Exception as exc: logger.warning(__('Failed to read intersphinx_mapping[%s], ignored: %r'), key, exc) config.intersphinx_mapping.pop(key) def setup(app: Sphinx) -> Dict[str, Any]: app.add_config_value('intersphinx_mapping', {}, True) app.add_config_value('intersphinx_cache_limit', 5, False) app.add_config_value('intersphinx_timeout', None, False) app.add_config_value('intersphinx_disabled_reftypes', [], True) app.connect('config-inited', normalize_intersphinx_mapping, priority=800) app.connect('builder-inited', load_mappings) app.connect('missing-reference', missing_reference) return { 'version': sphinx.__display_version__, 'env_version': 1, 'parallel_read_safe': True } def inspect_main(argv: List[str]) -> None: """Debug functionality to print out an inventory""" if len(argv) < 1: print("Print out an inventory file.\n" "Error: must specify local path or URL to an inventory file.", file=sys.stderr) sys.exit(1) class MockConfig: intersphinx_timeout: int = None tls_verify = False user_agent = None class MockApp: srcdir = '' config = MockConfig() def warn(self, msg: str) -> None: print(msg, file=sys.stderr) try: filename = argv[0] invdata = fetch_inventory(MockApp(), '', filename) # type: ignore for key in sorted(invdata or {}): print(key) for entry, einfo in sorted(invdata[key].items()): print('\t%-40s %s%s' % (entry, '%-40s: ' % einfo[3] if einfo[3] != '-' else '', einfo[2])) except ValueError as exc: print(exc.args[0] % exc.args[1:]) except Exception as exc: print('Unknown error: %r' % exc) if __name__ == '__main__': import logging as _logging _logging.basicConfig() inspect_main(argv=sys.argv[1:]) ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/linkcode.py�����������������������������������������������������������������0000644�0000766�0000024�00000004454�00000000000�016615� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.linkcode ~~~~~~~~~~~~~~~~~~~ Add external links to module code in Python object descriptions. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Any, Dict, Set from docutils import nodes from docutils.nodes import Node import sphinx from sphinx import addnodes from sphinx.application import Sphinx from sphinx.errors import SphinxError from sphinx.locale import _ class LinkcodeError(SphinxError): category = "linkcode error" def doctree_read(app: Sphinx, doctree: Node) -> None: env = app.builder.env resolve_target = getattr(env.config, 'linkcode_resolve', None) if not callable(env.config.linkcode_resolve): raise LinkcodeError( "Function `linkcode_resolve` is not given in conf.py") domain_keys = { 'py': ['module', 'fullname'], 'c': ['names'], 'cpp': ['names'], 'js': ['object', 'fullname'], } for objnode in list(doctree.traverse(addnodes.desc)): domain = objnode.get('domain') uris: Set[str] = set() for signode in objnode: if not isinstance(signode, addnodes.desc_signature): continue # Convert signode to a specified format info = {} for key in domain_keys.get(domain, []): value = signode.get(key) if not value: value = '' info[key] = value if not info: continue # Call user code to resolve the link uri = resolve_target(domain, info) if not uri: # no source continue if uri in uris or not uri: # only one link per name, please continue uris.add(uri) inline = nodes.inline('', _('[source]'), classes=['viewcode-link']) onlynode = addnodes.only(expr='html') onlynode += nodes.reference('', '', inline, internal=False, refuri=uri) signode += onlynode def setup(app: Sphinx) -> Dict[str, Any]: app.connect('doctree-read', doctree_read) app.add_config_value('linkcode_resolve', None, '') return {'version': sphinx.__display_version__, 'parallel_read_safe': True} ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/mathjax.py������������������������������������������������������������������0000644�0000766�0000024�00000012223�00000000000�016452� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.mathjax ~~~~~~~~~~~~~~~~~~ Allow `MathJax <https://www.mathjax.org/>`_ to be used to display math in Sphinx's HTML writer -- requires the MathJax JavaScript library on your webserver/computer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import json from typing import Any, Dict, cast from docutils import nodes import sphinx from sphinx.application import Sphinx from sphinx.domains.math import MathDomain from sphinx.errors import ExtensionError from sphinx.locale import _ from sphinx.util.math import get_node_equation_number from sphinx.writers.html import HTMLTranslator # more information for mathjax secure url is here: # https://docs.mathjax.org/en/latest/start.html#secure-access-to-the-cdn MATHJAX_URL = 'https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js' logger = sphinx.util.logging.getLogger(__name__) def html_visit_math(self: HTMLTranslator, node: nodes.math) -> None: self.body.append(self.starttag(node, 'span', '', CLASS='math notranslate nohighlight')) self.body.append(self.builder.config.mathjax_inline[0] + self.encode(node.astext()) + self.builder.config.mathjax_inline[1] + '</span>') raise nodes.SkipNode def html_visit_displaymath(self: HTMLTranslator, node: nodes.math_block) -> None: self.body.append(self.starttag(node, 'div', CLASS='math notranslate nohighlight')) if node['nowrap']: self.body.append(self.encode(node.astext())) self.body.append('</div>') raise nodes.SkipNode # necessary to e.g. set the id property correctly if node['number']: number = get_node_equation_number(self, node) self.body.append('<span class="eqno">(%s)' % number) self.add_permalink_ref(node, _('Permalink to this equation')) self.body.append('</span>') self.body.append(self.builder.config.mathjax_display[0]) parts = [prt for prt in node.astext().split('\n\n') if prt.strip()] if len(parts) > 1: # Add alignment if there are more than 1 equation self.body.append(r' \begin{align}\begin{aligned}') for i, part in enumerate(parts): part = self.encode(part) if r'\\' in part: self.body.append(r'\begin{split}' + part + r'\end{split}') else: self.body.append(part) if i < len(parts) - 1: # append new line if not the last equation self.body.append(r'\\') if len(parts) > 1: # Add alignment if there are more than 1 equation self.body.append(r'\end{aligned}\end{align} ') self.body.append(self.builder.config.mathjax_display[1]) self.body.append('</div>\n') raise nodes.SkipNode def install_mathjax(app: Sphinx, pagename: str, templatename: str, context: Dict, event_arg: Any) -> None: if app.builder.format != 'html' or app.builder.math_renderer_name != 'mathjax': # type: ignore # NOQA return if not app.config.mathjax_path: raise ExtensionError('mathjax_path config value must be set for the ' 'mathjax extension to work') domain = cast(MathDomain, app.env.get_domain('math')) if app.registry.html_assets_policy == 'always' or domain.has_equations(pagename): # Enable mathjax only if equations exists options = {} if app.config.mathjax_options: options.update(app.config.mathjax_options) if 'async' not in options and 'defer' not in options: if app.config.mathjax3_config: # Load MathJax v3 via "defer" method options['defer'] = 'defer' else: # Load other MathJax via "async" method options['async'] = 'async' app.add_js_file(app.config.mathjax_path, **options) if app.config.mathjax2_config: if app.config.mathjax_path == MATHJAX_URL: logger.warning( 'mathjax_config/mathjax2_config does not work ' 'for the current MathJax version, use mathjax3_config instead') body = 'MathJax.Hub.Config(%s)' % json.dumps(app.config.mathjax2_config) app.add_js_file(None, type='text/x-mathjax-config', body=body) if app.config.mathjax3_config: body = 'window.MathJax = %s' % json.dumps(app.config.mathjax3_config) app.add_js_file(None, body=body) def setup(app: Sphinx) -> Dict[str, Any]: app.add_html_math_renderer('mathjax', (html_visit_math, None), (html_visit_displaymath, None)) app.add_config_value('mathjax_path', MATHJAX_URL, 'html') app.add_config_value('mathjax_options', {}, 'html') app.add_config_value('mathjax_inline', [r'\(', r'\)'], 'html') app.add_config_value('mathjax_display', [r'\[', r'\]'], 'html') app.add_config_value('mathjax_config', None, 'html') app.add_config_value('mathjax2_config', lambda c: c.mathjax_config, 'html') app.add_config_value('mathjax3_config', None, 'html') app.connect('html-page-context', install_mathjax) return {'version': sphinx.__display_version__, 'parallel_read_safe': True} �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4653625 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/napoleon/�������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016257� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/napoleon/__init__.py��������������������������������������������������������0000644�0000766�0000024�00000043543�00000000000�020401� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.napoleon ~~~~~~~~~~~~~~~~~~~ Support for NumPy and Google style docstrings. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Any, Dict, List from sphinx import __display_version__ as __version__ from sphinx.application import Sphinx from sphinx.ext.napoleon.docstring import GoogleDocstring, NumpyDocstring from sphinx.util import inspect class Config: """Sphinx napoleon extension settings in `conf.py`. Listed below are all the settings used by napoleon and their default values. These settings can be changed in the Sphinx `conf.py` file. Make sure that "sphinx.ext.napoleon" is enabled in `conf.py`:: # conf.py # Add any Sphinx extension module names here, as strings extensions = ['sphinx.ext.napoleon'] # Napoleon settings napoleon_google_docstring = True napoleon_numpy_docstring = True napoleon_include_init_with_doc = False napoleon_include_private_with_doc = False napoleon_include_special_with_doc = False napoleon_use_admonition_for_examples = False napoleon_use_admonition_for_notes = False napoleon_use_admonition_for_references = False napoleon_use_ivar = False napoleon_use_param = True napoleon_use_rtype = True napoleon_use_keyword = True napoleon_preprocess_types = False napoleon_type_aliases = None napoleon_custom_sections = None napoleon_attr_annotations = True .. _Google style: https://google.github.io/styleguide/pyguide.html .. _NumPy style: https://github.com/numpy/numpy/blob/master/doc/HOWTO_DOCUMENT.rst.txt Attributes ---------- napoleon_google_docstring : :obj:`bool` (Defaults to True) True to parse `Google style`_ docstrings. False to disable support for Google style docstrings. napoleon_numpy_docstring : :obj:`bool` (Defaults to True) True to parse `NumPy style`_ docstrings. False to disable support for NumPy style docstrings. napoleon_include_init_with_doc : :obj:`bool` (Defaults to False) True to list ``__init___`` docstrings separately from the class docstring. False to fall back to Sphinx's default behavior, which considers the ``__init___`` docstring as part of the class documentation. **If True**:: def __init__(self): \"\"\" This will be included in the docs because it has a docstring \"\"\" def __init__(self): # This will NOT be included in the docs napoleon_include_private_with_doc : :obj:`bool` (Defaults to False) True to include private members (like ``_membername``) with docstrings in the documentation. False to fall back to Sphinx's default behavior. **If True**:: def _included(self): \"\"\" This will be included in the docs because it has a docstring \"\"\" pass def _skipped(self): # This will NOT be included in the docs pass napoleon_include_special_with_doc : :obj:`bool` (Defaults to False) True to include special members (like ``__membername__``) with docstrings in the documentation. False to fall back to Sphinx's default behavior. **If True**:: def __str__(self): \"\"\" This will be included in the docs because it has a docstring \"\"\" return unicode(self).encode('utf-8') def __unicode__(self): # This will NOT be included in the docs return unicode(self.__class__.__name__) napoleon_use_admonition_for_examples : :obj:`bool` (Defaults to False) True to use the ``.. admonition::`` directive for the **Example** and **Examples** sections. False to use the ``.. rubric::`` directive instead. One may look better than the other depending on what HTML theme is used. This `NumPy style`_ snippet will be converted as follows:: Example ------- This is just a quick example **If True**:: .. admonition:: Example This is just a quick example **If False**:: .. rubric:: Example This is just a quick example napoleon_use_admonition_for_notes : :obj:`bool` (Defaults to False) True to use the ``.. admonition::`` directive for **Notes** sections. False to use the ``.. rubric::`` directive instead. Note ---- The singular **Note** section will always be converted to a ``.. note::`` directive. See Also -------- :attr:`napoleon_use_admonition_for_examples` napoleon_use_admonition_for_references : :obj:`bool` (Defaults to False) True to use the ``.. admonition::`` directive for **References** sections. False to use the ``.. rubric::`` directive instead. See Also -------- :attr:`napoleon_use_admonition_for_examples` napoleon_use_ivar : :obj:`bool` (Defaults to False) True to use the ``:ivar:`` role for instance variables. False to use the ``.. attribute::`` directive instead. This `NumPy style`_ snippet will be converted as follows:: Attributes ---------- attr1 : int Description of `attr1` **If True**:: :ivar attr1: Description of `attr1` :vartype attr1: int **If False**:: .. attribute:: attr1 Description of `attr1` :type: int napoleon_use_param : :obj:`bool` (Defaults to True) True to use a ``:param:`` role for each function parameter. False to use a single ``:parameters:`` role for all the parameters. This `NumPy style`_ snippet will be converted as follows:: Parameters ---------- arg1 : str Description of `arg1` arg2 : int, optional Description of `arg2`, defaults to 0 **If True**:: :param arg1: Description of `arg1` :type arg1: str :param arg2: Description of `arg2`, defaults to 0 :type arg2: int, optional **If False**:: :parameters: * **arg1** (*str*) -- Description of `arg1` * **arg2** (*int, optional*) -- Description of `arg2`, defaults to 0 napoleon_use_keyword : :obj:`bool` (Defaults to True) True to use a ``:keyword:`` role for each function keyword argument. False to use a single ``:keyword arguments:`` role for all the keywords. This behaves similarly to :attr:`napoleon_use_param`. Note unlike docutils, ``:keyword:`` and ``:param:`` will not be treated the same way - there will be a separate "Keyword Arguments" section, rendered in the same fashion as "Parameters" section (type links created if possible) See Also -------- :attr:`napoleon_use_param` napoleon_use_rtype : :obj:`bool` (Defaults to True) True to use the ``:rtype:`` role for the return type. False to output the return type inline with the description. This `NumPy style`_ snippet will be converted as follows:: Returns ------- bool True if successful, False otherwise **If True**:: :returns: True if successful, False otherwise :rtype: bool **If False**:: :returns: *bool* -- True if successful, False otherwise napoleon_preprocess_types : :obj:`bool` (Defaults to False) Enable the type preprocessor. napoleon_type_aliases : :obj:`dict` (Defaults to None) Add a mapping of strings to string, translating types in numpy style docstrings. Only works if ``napoleon_preprocess_types = True``. napoleon_custom_sections : :obj:`list` (Defaults to None) Add a list of custom sections to include, expanding the list of parsed sections. The entries can either be strings or tuples, depending on the intention: * To create a custom "generic" section, just pass a string. * To create an alias for an existing section, pass a tuple containing the alias name and the original, in that order. * To create a custom section that displays like the parameters or returns section, pass a tuple containing the custom section name and a string value, "params_style" or "returns_style". If an entry is just a string, it is interpreted as a header for a generic section. If the entry is a tuple/list/indexed container, the first entry is the name of the section, the second is the section key to emulate. If the second entry value is "params_style" or "returns_style", the custom section will be displayed like the parameters section or returns section. napoleon_attr_annotations : :obj:`bool` (Defaults to True) Use the type annotations of class attributes that are documented in the docstring but do not have a type in the docstring. """ _config_values = { 'napoleon_google_docstring': (True, 'env'), 'napoleon_numpy_docstring': (True, 'env'), 'napoleon_include_init_with_doc': (False, 'env'), 'napoleon_include_private_with_doc': (False, 'env'), 'napoleon_include_special_with_doc': (False, 'env'), 'napoleon_use_admonition_for_examples': (False, 'env'), 'napoleon_use_admonition_for_notes': (False, 'env'), 'napoleon_use_admonition_for_references': (False, 'env'), 'napoleon_use_ivar': (False, 'env'), 'napoleon_use_param': (True, 'env'), 'napoleon_use_rtype': (True, 'env'), 'napoleon_use_keyword': (True, 'env'), 'napoleon_preprocess_types': (False, 'env'), 'napoleon_type_aliases': (None, 'env'), 'napoleon_custom_sections': (None, 'env'), 'napoleon_attr_annotations': (True, 'env'), } def __init__(self, **settings: Any) -> None: for name, (default, rebuild) in self._config_values.items(): setattr(self, name, default) for name, value in settings.items(): setattr(self, name, value) def setup(app: Sphinx) -> Dict[str, Any]: """Sphinx extension setup function. When the extension is loaded, Sphinx imports this module and executes the ``setup()`` function, which in turn notifies Sphinx of everything the extension offers. Parameters ---------- app : sphinx.application.Sphinx Application object representing the Sphinx process See Also -------- `The Sphinx documentation on Extensions <https://www.sphinx-doc.org/extensions.html>`_ `The Extension Tutorial <https://www.sphinx-doc.org/extdev/tutorial.html>`_ `The Extension API <https://www.sphinx-doc.org/extdev/appapi.html>`_ """ if not isinstance(app, Sphinx): # probably called by tests return {'version': __version__, 'parallel_read_safe': True} _patch_python_domain() app.setup_extension('sphinx.ext.autodoc') app.connect('autodoc-process-docstring', _process_docstring) app.connect('autodoc-skip-member', _skip_member) for name, (default, rebuild) in Config._config_values.items(): app.add_config_value(name, default, rebuild) return {'version': __version__, 'parallel_read_safe': True} def _patch_python_domain() -> None: try: from sphinx.domains.python import PyTypedField except ImportError: pass else: import sphinx.domains.python from sphinx.locale import _ for doc_field in sphinx.domains.python.PyObject.doc_field_types: if doc_field.name == 'parameter': doc_field.names = ('param', 'parameter', 'arg', 'argument') break sphinx.domains.python.PyObject.doc_field_types.append( PyTypedField('keyword', label=_('Keyword Arguments'), names=('keyword', 'kwarg', 'kwparam'), typerolename='obj', typenames=('paramtype', 'kwtype'), can_collapse=True)) def _process_docstring(app: Sphinx, what: str, name: str, obj: Any, options: Any, lines: List[str]) -> None: """Process the docstring for a given python object. Called when autodoc has read and processed a docstring. `lines` is a list of docstring lines that `_process_docstring` modifies in place to change what Sphinx outputs. The following settings in conf.py control what styles of docstrings will be parsed: * ``napoleon_google_docstring`` -- parse Google style docstrings * ``napoleon_numpy_docstring`` -- parse NumPy style docstrings Parameters ---------- app : sphinx.application.Sphinx Application object representing the Sphinx process. what : str A string specifying the type of the object to which the docstring belongs. Valid values: "module", "class", "exception", "function", "method", "attribute". name : str The fully qualified name of the object. obj : module, class, exception, function, method, or attribute The object to which the docstring belongs. options : sphinx.ext.autodoc.Options The options given to the directive: an object with attributes inherited_members, undoc_members, show_inheritance and noindex that are True if the flag option of same name was given to the auto directive. lines : list of str The lines of the docstring, see above. .. note:: `lines` is modified *in place* """ result_lines = lines docstring: GoogleDocstring = None if app.config.napoleon_numpy_docstring: docstring = NumpyDocstring(result_lines, app.config, app, what, name, obj, options) result_lines = docstring.lines() if app.config.napoleon_google_docstring: docstring = GoogleDocstring(result_lines, app.config, app, what, name, obj, options) result_lines = docstring.lines() lines[:] = result_lines[:] def _skip_member(app: Sphinx, what: str, name: str, obj: Any, skip: bool, options: Any) -> bool: """Determine if private and special class members are included in docs. The following settings in conf.py determine if private and special class members or init methods are included in the generated documentation: * ``napoleon_include_init_with_doc`` -- include init methods if they have docstrings * ``napoleon_include_private_with_doc`` -- include private members if they have docstrings * ``napoleon_include_special_with_doc`` -- include special members if they have docstrings Parameters ---------- app : sphinx.application.Sphinx Application object representing the Sphinx process what : str A string specifying the type of the object to which the member belongs. Valid values: "module", "class", "exception", "function", "method", "attribute". name : str The name of the member. obj : module, class, exception, function, method, or attribute. For example, if the member is the __init__ method of class A, then `obj` will be `A.__init__`. skip : bool A boolean indicating if autodoc will skip this member if `_skip_member` does not override the decision options : sphinx.ext.autodoc.Options The options given to the directive: an object with attributes inherited_members, undoc_members, show_inheritance and noindex that are True if the flag option of same name was given to the auto directive. Returns ------- bool True if the member should be skipped during creation of the docs, False if it should be included in the docs. """ has_doc = getattr(obj, '__doc__', False) is_member = (what == 'class' or what == 'exception' or what == 'module') if name != '__weakref__' and has_doc and is_member: cls_is_owner = False if what == 'class' or what == 'exception': qualname = getattr(obj, '__qualname__', '') cls_path, _, _ = qualname.rpartition('.') if cls_path: try: if '.' in cls_path: import functools import importlib mod = importlib.import_module(obj.__module__) mod_path = cls_path.split('.') cls = functools.reduce(getattr, mod_path, mod) else: cls = inspect.unwrap(obj).__globals__[cls_path] except Exception: cls_is_owner = False else: cls_is_owner = (cls and hasattr(cls, name) and # type: ignore name in cls.__dict__) else: cls_is_owner = False if what == 'module' or cls_is_owner: is_init = (name == '__init__') is_special = (not is_init and name.startswith('__') and name.endswith('__')) is_private = (not is_init and not is_special and name.startswith('_')) inc_init = app.config.napoleon_include_init_with_doc inc_special = app.config.napoleon_include_special_with_doc inc_private = app.config.napoleon_include_private_with_doc if ((is_special and inc_special) or (is_private and inc_private) or (is_init and inc_init)): return False return None �������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/napoleon/docstring.py�������������������������������������������������������0000644�0000766�0000024�00000137135�00000000000�020637� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.napoleon.docstring ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Classes for docstring parsing and formatting. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import collections import inspect import re from functools import partial from typing import Any, Callable, Dict, List, Tuple, Type, Union from sphinx.application import Sphinx from sphinx.config import Config as SphinxConfig from sphinx.ext.napoleon.iterators import modify_iter from sphinx.locale import _, __ from sphinx.util import logging from sphinx.util.inspect import stringify_annotation from sphinx.util.typing import get_type_hints logger = logging.getLogger(__name__) _directive_regex = re.compile(r'\.\. \S+::') _google_section_regex = re.compile(r'^(\s|\w)+:\s*$') _google_typed_arg_regex = re.compile(r'(.+?)\(\s*(.*[^\s]+)\s*\)') _numpy_section_regex = re.compile(r'^[=\-`:\'"~^_*+#<>]{2,}\s*$') _single_colon_regex = re.compile(r'(?<!:):(?!:)') _xref_or_code_regex = re.compile( r'((?::(?:[a-zA-Z0-9]+[\-_+:.])*[a-zA-Z0-9]+:`.+?`)|' r'(?:``.+?``))') _xref_regex = re.compile( r'(?:(?::(?:[a-zA-Z0-9]+[\-_+:.])*[a-zA-Z0-9]+:)?`.+?`)' ) _bullet_list_regex = re.compile(r'^(\*|\+|\-)(\s+\S|\s*$)') _enumerated_list_regex = re.compile( r'^(?P<paren>\()?' r'(\d+|#|[ivxlcdm]+|[IVXLCDM]+|[a-zA-Z])' r'(?(paren)\)|\.)(\s+\S|\s*$)') _token_regex = re.compile( r"(,\sor\s|\sor\s|\sof\s|:\s|\sto\s|,\sand\s|\sand\s|,\s" r"|[{]|[}]" r'|"(?:\\"|[^"])*"' r"|'(?:\\'|[^'])*')" ) _default_regex = re.compile( r"^default[^_0-9A-Za-z].*$", ) _SINGLETONS = ("None", "True", "False", "Ellipsis") def _convert_type_spec(_type: str, translations: Dict[str, str] = {}) -> str: """Convert type specification to reference in reST.""" if _type in translations: return translations[_type] else: if _type == 'None': return ':obj:`None`' else: return ':class:`%s`' % _type return _type class GoogleDocstring: """Convert Google style docstrings to reStructuredText. Parameters ---------- docstring : :obj:`str` or :obj:`list` of :obj:`str` The docstring to parse, given either as a string or split into individual lines. config: :obj:`sphinx.ext.napoleon.Config` or :obj:`sphinx.config.Config` The configuration settings to use. If not given, defaults to the config object on `app`; or if `app` is not given defaults to the a new :class:`sphinx.ext.napoleon.Config` object. Other Parameters ---------------- app : :class:`sphinx.application.Sphinx`, optional Application object representing the Sphinx process. what : :obj:`str`, optional A string specifying the type of the object to which the docstring belongs. Valid values: "module", "class", "exception", "function", "method", "attribute". name : :obj:`str`, optional The fully qualified name of the object. obj : module, class, exception, function, method, or attribute The object to which the docstring belongs. options : :class:`sphinx.ext.autodoc.Options`, optional The options given to the directive: an object with attributes inherited_members, undoc_members, show_inheritance and noindex that are True if the flag option of same name was given to the auto directive. Example ------- >>> from sphinx.ext.napoleon import Config >>> config = Config(napoleon_use_param=True, napoleon_use_rtype=True) >>> docstring = '''One line summary. ... ... Extended description. ... ... Args: ... arg1(int): Description of `arg1` ... arg2(str): Description of `arg2` ... Returns: ... str: Description of return value. ... ''' >>> print(GoogleDocstring(docstring, config)) One line summary. <BLANKLINE> Extended description. <BLANKLINE> :param arg1: Description of `arg1` :type arg1: int :param arg2: Description of `arg2` :type arg2: str <BLANKLINE> :returns: Description of return value. :rtype: str <BLANKLINE> """ _name_rgx = re.compile(r"^\s*((?::(?P<role>\S+):)?`(?P<name>~?[a-zA-Z0-9_.-]+)`|" r" (?P<name2>~?[a-zA-Z0-9_.-]+))\s*", re.X) def __init__(self, docstring: Union[str, List[str]], config: SphinxConfig = None, app: Sphinx = None, what: str = '', name: str = '', obj: Any = None, options: Any = None) -> None: self._config = config self._app = app if not self._config: from sphinx.ext.napoleon import Config self._config = self._app.config if self._app else Config() # type: ignore if not what: if inspect.isclass(obj): what = 'class' elif inspect.ismodule(obj): what = 'module' elif callable(obj): what = 'function' else: what = 'object' self._what = what self._name = name self._obj = obj self._opt = options if isinstance(docstring, str): lines = docstring.splitlines() else: lines = docstring self._line_iter = modify_iter(lines, modifier=lambda s: s.rstrip()) self._parsed_lines: List[str] = [] self._is_in_section = False self._section_indent = 0 if not hasattr(self, '_directive_sections'): self._directive_sections: List[str] = [] if not hasattr(self, '_sections'): self._sections: Dict[str, Callable] = { 'args': self._parse_parameters_section, 'arguments': self._parse_parameters_section, 'attention': partial(self._parse_admonition, 'attention'), 'attributes': self._parse_attributes_section, 'caution': partial(self._parse_admonition, 'caution'), 'danger': partial(self._parse_admonition, 'danger'), 'error': partial(self._parse_admonition, 'error'), 'example': self._parse_examples_section, 'examples': self._parse_examples_section, 'hint': partial(self._parse_admonition, 'hint'), 'important': partial(self._parse_admonition, 'important'), 'keyword args': self._parse_keyword_arguments_section, 'keyword arguments': self._parse_keyword_arguments_section, 'methods': self._parse_methods_section, 'note': partial(self._parse_admonition, 'note'), 'notes': self._parse_notes_section, 'other parameters': self._parse_other_parameters_section, 'parameters': self._parse_parameters_section, 'receive': self._parse_receives_section, 'receives': self._parse_receives_section, 'return': self._parse_returns_section, 'returns': self._parse_returns_section, 'raise': self._parse_raises_section, 'raises': self._parse_raises_section, 'references': self._parse_references_section, 'see also': self._parse_see_also_section, 'tip': partial(self._parse_admonition, 'tip'), 'todo': partial(self._parse_admonition, 'todo'), 'warning': partial(self._parse_admonition, 'warning'), 'warnings': partial(self._parse_admonition, 'warning'), 'warn': self._parse_warns_section, 'warns': self._parse_warns_section, 'yield': self._parse_yields_section, 'yields': self._parse_yields_section, } self._load_custom_sections() self._parse() def __str__(self) -> str: """Return the parsed docstring in reStructuredText format. Returns ------- unicode Unicode version of the docstring. """ return '\n'.join(self.lines()) def lines(self) -> List[str]: """Return the parsed lines of the docstring in reStructuredText format. Returns ------- list(str) The lines of the docstring in a list. """ return self._parsed_lines def _consume_indented_block(self, indent: int = 1) -> List[str]: lines = [] line = self._line_iter.peek() while(not self._is_section_break() and (not line or self._is_indented(line, indent))): lines.append(next(self._line_iter)) line = self._line_iter.peek() return lines def _consume_contiguous(self) -> List[str]: lines = [] while (self._line_iter.has_next() and self._line_iter.peek() and not self._is_section_header()): lines.append(next(self._line_iter)) return lines def _consume_empty(self) -> List[str]: lines = [] line = self._line_iter.peek() while self._line_iter.has_next() and not line: lines.append(next(self._line_iter)) line = self._line_iter.peek() return lines def _consume_field(self, parse_type: bool = True, prefer_type: bool = False ) -> Tuple[str, str, List[str]]: line = next(self._line_iter) before, colon, after = self._partition_field_on_colon(line) _name, _type, _desc = before, '', after if parse_type: match = _google_typed_arg_regex.match(before) if match: _name = match.group(1).strip() _type = match.group(2) _name = self._escape_args_and_kwargs(_name) if prefer_type and not _type: _type, _name = _name, _type if _type and self._config.napoleon_preprocess_types: _type = _convert_type_spec(_type, self._config.napoleon_type_aliases or {}) indent = self._get_indent(line) + 1 _descs = [_desc] + self._dedent(self._consume_indented_block(indent)) _descs = self.__class__(_descs, self._config).lines() return _name, _type, _descs def _consume_fields(self, parse_type: bool = True, prefer_type: bool = False, multiple: bool = False) -> List[Tuple[str, str, List[str]]]: self._consume_empty() fields = [] while not self._is_section_break(): _name, _type, _desc = self._consume_field(parse_type, prefer_type) if multiple and _name: for name in _name.split(","): fields.append((name.strip(), _type, _desc)) elif _name or _type or _desc: fields.append((_name, _type, _desc,)) return fields def _consume_inline_attribute(self) -> Tuple[str, List[str]]: line = next(self._line_iter) _type, colon, _desc = self._partition_field_on_colon(line) if not colon or not _desc: _type, _desc = _desc, _type _desc += colon _descs = [_desc] + self._dedent(self._consume_to_end()) _descs = self.__class__(_descs, self._config).lines() return _type, _descs def _consume_returns_section(self, preprocess_types: bool = False ) -> List[Tuple[str, str, List[str]]]: lines = self._dedent(self._consume_to_next_section()) if lines: before, colon, after = self._partition_field_on_colon(lines[0]) _name, _type, _desc = '', '', lines if colon: if after: _desc = [after] + lines[1:] else: _desc = lines[1:] _type = before if (_type and preprocess_types and self._config.napoleon_preprocess_types): _type = _convert_type_spec(_type, self._config.napoleon_type_aliases or {}) _desc = self.__class__(_desc, self._config).lines() return [(_name, _type, _desc,)] else: return [] def _consume_usage_section(self) -> List[str]: lines = self._dedent(self._consume_to_next_section()) return lines def _consume_section_header(self) -> str: section = next(self._line_iter) stripped_section = section.strip(':') if stripped_section.lower() in self._sections: section = stripped_section return section def _consume_to_end(self) -> List[str]: lines = [] while self._line_iter.has_next(): lines.append(next(self._line_iter)) return lines def _consume_to_next_section(self) -> List[str]: self._consume_empty() lines = [] while not self._is_section_break(): lines.append(next(self._line_iter)) return lines + self._consume_empty() def _dedent(self, lines: List[str], full: bool = False) -> List[str]: if full: return [line.lstrip() for line in lines] else: min_indent = self._get_min_indent(lines) return [line[min_indent:] for line in lines] def _escape_args_and_kwargs(self, name: str) -> str: if name.endswith('_') and getattr(self._config, 'strip_signature_backslash', False): name = name[:-1] + r'\_' if name[:2] == '**': return r'\*\*' + name[2:] elif name[:1] == '*': return r'\*' + name[1:] else: return name def _fix_field_desc(self, desc: List[str]) -> List[str]: if self._is_list(desc): desc = [''] + desc elif desc[0].endswith('::'): desc_block = desc[1:] indent = self._get_indent(desc[0]) block_indent = self._get_initial_indent(desc_block) if block_indent > indent: desc = [''] + desc else: desc = ['', desc[0]] + self._indent(desc_block, 4) return desc def _format_admonition(self, admonition: str, lines: List[str]) -> List[str]: lines = self._strip_empty(lines) if len(lines) == 1: return ['.. %s:: %s' % (admonition, lines[0].strip()), ''] elif lines: lines = self._indent(self._dedent(lines), 3) return ['.. %s::' % admonition, ''] + lines + [''] else: return ['.. %s::' % admonition, ''] def _format_block(self, prefix: str, lines: List[str], padding: str = None) -> List[str]: if lines: if padding is None: padding = ' ' * len(prefix) result_lines = [] for i, line in enumerate(lines): if i == 0: result_lines.append((prefix + line).rstrip()) elif line: result_lines.append(padding + line) else: result_lines.append('') return result_lines else: return [prefix] def _format_docutils_params(self, fields: List[Tuple[str, str, List[str]]], field_role: str = 'param', type_role: str = 'type' ) -> List[str]: lines = [] for _name, _type, _desc in fields: _desc = self._strip_empty(_desc) if any(_desc): _desc = self._fix_field_desc(_desc) field = ':%s %s: ' % (field_role, _name) lines.extend(self._format_block(field, _desc)) else: lines.append(':%s %s:' % (field_role, _name)) if _type: lines.append(':%s %s: %s' % (type_role, _name, _type)) return lines + [''] def _format_field(self, _name: str, _type: str, _desc: List[str]) -> List[str]: _desc = self._strip_empty(_desc) has_desc = any(_desc) separator = ' -- ' if has_desc else '' if _name: if _type: if '`' in _type: field = '**%s** (%s)%s' % (_name, _type, separator) else: field = '**%s** (*%s*)%s' % (_name, _type, separator) else: field = '**%s**%s' % (_name, separator) elif _type: if '`' in _type: field = '%s%s' % (_type, separator) else: field = '*%s*%s' % (_type, separator) else: field = '' if has_desc: _desc = self._fix_field_desc(_desc) if _desc[0]: return [field + _desc[0]] + _desc[1:] else: return [field] + _desc else: return [field] def _format_fields(self, field_type: str, fields: List[Tuple[str, str, List[str]]] ) -> List[str]: field_type = ':%s:' % field_type.strip() padding = ' ' * len(field_type) multi = len(fields) > 1 lines: List[str] = [] for _name, _type, _desc in fields: field = self._format_field(_name, _type, _desc) if multi: if lines: lines.extend(self._format_block(padding + ' * ', field)) else: lines.extend(self._format_block(field_type + ' * ', field)) else: lines.extend(self._format_block(field_type + ' ', field)) if lines and lines[-1]: lines.append('') return lines def _get_current_indent(self, peek_ahead: int = 0) -> int: line = self._line_iter.peek(peek_ahead + 1)[peek_ahead] while line != self._line_iter.sentinel: if line: return self._get_indent(line) peek_ahead += 1 line = self._line_iter.peek(peek_ahead + 1)[peek_ahead] return 0 def _get_indent(self, line: str) -> int: for i, s in enumerate(line): if not s.isspace(): return i return len(line) def _get_initial_indent(self, lines: List[str]) -> int: for line in lines: if line: return self._get_indent(line) return 0 def _get_min_indent(self, lines: List[str]) -> int: min_indent = None for line in lines: if line: indent = self._get_indent(line) if min_indent is None: min_indent = indent elif indent < min_indent: min_indent = indent return min_indent or 0 def _indent(self, lines: List[str], n: int = 4) -> List[str]: return [(' ' * n) + line for line in lines] def _is_indented(self, line: str, indent: int = 1) -> bool: for i, s in enumerate(line): if i >= indent: return True elif not s.isspace(): return False return False def _is_list(self, lines: List[str]) -> bool: if not lines: return False if _bullet_list_regex.match(lines[0]): return True if _enumerated_list_regex.match(lines[0]): return True if len(lines) < 2 or lines[0].endswith('::'): return False indent = self._get_indent(lines[0]) next_indent = indent for line in lines[1:]: if line: next_indent = self._get_indent(line) break return next_indent > indent def _is_section_header(self) -> bool: section = self._line_iter.peek().lower() match = _google_section_regex.match(section) if match and section.strip(':') in self._sections: header_indent = self._get_indent(section) section_indent = self._get_current_indent(peek_ahead=1) return section_indent > header_indent elif self._directive_sections: if _directive_regex.match(section): for directive_section in self._directive_sections: if section.startswith(directive_section): return True return False def _is_section_break(self) -> bool: line = self._line_iter.peek() return (not self._line_iter.has_next() or self._is_section_header() or (self._is_in_section and line and not self._is_indented(line, self._section_indent))) def _load_custom_sections(self) -> None: if self._config.napoleon_custom_sections is not None: for entry in self._config.napoleon_custom_sections: if isinstance(entry, str): # if entry is just a label, add to sections list, # using generic section logic. self._sections[entry.lower()] = self._parse_custom_generic_section else: # otherwise, assume entry is container; if entry[1] == "params_style": self._sections[entry[0].lower()] = \ self._parse_custom_params_style_section elif entry[1] == "returns_style": self._sections[entry[0].lower()] = \ self._parse_custom_returns_style_section else: # [0] is new section, [1] is the section to alias. # in the case of key mismatch, just handle as generic section. self._sections[entry[0].lower()] = \ self._sections.get(entry[1].lower(), self._parse_custom_generic_section) def _parse(self) -> None: self._parsed_lines = self._consume_empty() if self._name and self._what in ('attribute', 'data', 'property'): # Implicit stop using StopIteration no longer allowed in # Python 3.7; see PEP 479 res: List[str] = [] try: res = self._parse_attribute_docstring() except StopIteration: pass self._parsed_lines.extend(res) return while self._line_iter.has_next(): if self._is_section_header(): try: section = self._consume_section_header() self._is_in_section = True self._section_indent = self._get_current_indent() if _directive_regex.match(section): lines = [section] + self._consume_to_next_section() else: lines = self._sections[section.lower()](section) finally: self._is_in_section = False self._section_indent = 0 else: if not self._parsed_lines: lines = self._consume_contiguous() + self._consume_empty() else: lines = self._consume_to_next_section() self._parsed_lines.extend(lines) def _parse_admonition(self, admonition: str, section: str) -> List[str]: # type (str, str) -> List[str] lines = self._consume_to_next_section() return self._format_admonition(admonition, lines) def _parse_attribute_docstring(self) -> List[str]: _type, _desc = self._consume_inline_attribute() lines = self._format_field('', '', _desc) if _type: lines.extend(['', ':type: %s' % _type]) return lines def _parse_attributes_section(self, section: str) -> List[str]: lines = [] for _name, _type, _desc in self._consume_fields(): if not _type: _type = self._lookup_annotation(_name) if self._config.napoleon_use_ivar: _name = self._qualify_name(_name, self._obj) field = ':ivar %s: ' % _name lines.extend(self._format_block(field, _desc)) if _type: lines.append(':vartype %s: %s' % (_name, _type)) else: lines.append('.. attribute:: ' + _name) if self._opt and 'noindex' in self._opt: lines.append(' :noindex:') lines.append('') fields = self._format_field('', '', _desc) lines.extend(self._indent(fields, 3)) if _type: lines.append('') lines.extend(self._indent([':type: %s' % _type], 3)) lines.append('') if self._config.napoleon_use_ivar: lines.append('') return lines def _parse_examples_section(self, section: str) -> List[str]: labels = { 'example': _('Example'), 'examples': _('Examples'), } use_admonition = self._config.napoleon_use_admonition_for_examples label = labels.get(section.lower(), section) return self._parse_generic_section(label, use_admonition) def _parse_custom_generic_section(self, section: str) -> List[str]: # for now, no admonition for simple custom sections return self._parse_generic_section(section, False) def _parse_custom_params_style_section(self, section: str) -> List[str]: return self._format_fields(section, self._consume_fields()) def _parse_custom_returns_style_section(self, section: str) -> List[str]: fields = self._consume_returns_section(preprocess_types=True) return self._format_fields(section, fields) def _parse_usage_section(self, section: str) -> List[str]: header = ['.. rubric:: Usage:', ''] block = ['.. code-block:: python', ''] lines = self._consume_usage_section() lines = self._indent(lines, 3) return header + block + lines + [''] def _parse_generic_section(self, section: str, use_admonition: bool) -> List[str]: lines = self._strip_empty(self._consume_to_next_section()) lines = self._dedent(lines) if use_admonition: header = '.. admonition:: %s' % section lines = self._indent(lines, 3) else: header = '.. rubric:: %s' % section if lines: return [header, ''] + lines + [''] else: return [header, ''] def _parse_keyword_arguments_section(self, section: str) -> List[str]: fields = self._consume_fields() if self._config.napoleon_use_keyword: return self._format_docutils_params( fields, field_role="keyword", type_role="kwtype") else: return self._format_fields(_('Keyword Arguments'), fields) def _parse_methods_section(self, section: str) -> List[str]: lines: List[str] = [] for _name, _type, _desc in self._consume_fields(parse_type=False): lines.append('.. method:: %s' % _name) if self._opt and 'noindex' in self._opt: lines.append(' :noindex:') if _desc: lines.extend([''] + self._indent(_desc, 3)) lines.append('') return lines def _parse_notes_section(self, section: str) -> List[str]: use_admonition = self._config.napoleon_use_admonition_for_notes return self._parse_generic_section(_('Notes'), use_admonition) def _parse_other_parameters_section(self, section: str) -> List[str]: if self._config.napoleon_use_param: # Allow to declare multiple parameters at once (ex: x, y: int) fields = self._consume_fields(multiple=True) return self._format_docutils_params(fields) else: fields = self._consume_fields() return self._format_fields(_('Other Parameters'), fields) def _parse_parameters_section(self, section: str) -> List[str]: if self._config.napoleon_use_param: # Allow to declare multiple parameters at once (ex: x, y: int) fields = self._consume_fields(multiple=True) return self._format_docutils_params(fields) else: fields = self._consume_fields() return self._format_fields(_('Parameters'), fields) def _parse_raises_section(self, section: str) -> List[str]: fields = self._consume_fields(parse_type=False, prefer_type=True) lines: List[str] = [] for _name, _type, _desc in fields: m = self._name_rgx.match(_type) if m and m.group('name'): _type = m.group('name') elif _xref_regex.match(_type): pos = _type.find('`') _type = _type[pos + 1:-1] _type = ' ' + _type if _type else '' _desc = self._strip_empty(_desc) _descs = ' ' + '\n '.join(_desc) if any(_desc) else '' lines.append(':raises%s:%s' % (_type, _descs)) if lines: lines.append('') return lines def _parse_receives_section(self, section: str) -> List[str]: if self._config.napoleon_use_param: # Allow to declare multiple parameters at once (ex: x, y: int) fields = self._consume_fields(multiple=True) return self._format_docutils_params(fields) else: fields = self._consume_fields() return self._format_fields(_('Receives'), fields) def _parse_references_section(self, section: str) -> List[str]: use_admonition = self._config.napoleon_use_admonition_for_references return self._parse_generic_section(_('References'), use_admonition) def _parse_returns_section(self, section: str) -> List[str]: fields = self._consume_returns_section() multi = len(fields) > 1 if multi: use_rtype = False else: use_rtype = self._config.napoleon_use_rtype lines: List[str] = [] for _name, _type, _desc in fields: if use_rtype: field = self._format_field(_name, '', _desc) else: field = self._format_field(_name, _type, _desc) if multi: if lines: lines.extend(self._format_block(' * ', field)) else: lines.extend(self._format_block(':returns: * ', field)) else: lines.extend(self._format_block(':returns: ', field)) if _type and use_rtype: lines.extend([':rtype: %s' % _type, '']) if lines and lines[-1]: lines.append('') return lines def _parse_see_also_section(self, section: str) -> List[str]: return self._parse_admonition('seealso', section) def _parse_warns_section(self, section: str) -> List[str]: return self._format_fields(_('Warns'), self._consume_fields()) def _parse_yields_section(self, section: str) -> List[str]: fields = self._consume_returns_section(preprocess_types=True) return self._format_fields(_('Yields'), fields) def _partition_field_on_colon(self, line: str) -> Tuple[str, str, str]: before_colon = [] after_colon = [] colon = '' found_colon = False for i, source in enumerate(_xref_or_code_regex.split(line)): if found_colon: after_colon.append(source) else: m = _single_colon_regex.search(source) if (i % 2) == 0 and m: found_colon = True colon = source[m.start(): m.end()] before_colon.append(source[:m.start()]) after_colon.append(source[m.end():]) else: before_colon.append(source) return ("".join(before_colon).strip(), colon, "".join(after_colon).strip()) def _qualify_name(self, attr_name: str, klass: Type) -> str: if klass and '.' not in attr_name: if attr_name.startswith('~'): attr_name = attr_name[1:] try: q = klass.__qualname__ except AttributeError: q = klass.__name__ return '~%s.%s' % (q, attr_name) return attr_name def _strip_empty(self, lines: List[str]) -> List[str]: if lines: start = -1 for i, line in enumerate(lines): if line: start = i break if start == -1: lines = [] end = -1 for i in reversed(range(len(lines))): line = lines[i] if line: end = i break if start > 0 or end + 1 < len(lines): lines = lines[start:end + 1] return lines def _lookup_annotation(self, _name: str) -> str: if self._config.napoleon_attr_annotations: if self._what in ("module", "class", "exception") and self._obj: # cache the class annotations if not hasattr(self, "_annotations"): localns = getattr(self._config, "autodoc_type_aliases", {}) localns.update(getattr( self._config, "napoleon_type_aliases", {} ) or {}) self._annotations = get_type_hints(self._obj, None, localns) if _name in self._annotations: return stringify_annotation(self._annotations[_name]) # No annotation found return "" def _recombine_set_tokens(tokens: List[str]) -> List[str]: token_queue = collections.deque(tokens) keywords = ("optional", "default") def takewhile_set(tokens): open_braces = 0 previous_token = None while True: try: token = tokens.popleft() except IndexError: break if token == ", ": previous_token = token continue if not token.strip(): continue if token in keywords: tokens.appendleft(token) if previous_token is not None: tokens.appendleft(previous_token) break if previous_token is not None: yield previous_token previous_token = None if token == "{": open_braces += 1 elif token == "}": open_braces -= 1 yield token if open_braces == 0: break def combine_set(tokens): while True: try: token = tokens.popleft() except IndexError: break if token == "{": tokens.appendleft("{") yield "".join(takewhile_set(tokens)) else: yield token return list(combine_set(token_queue)) def _tokenize_type_spec(spec: str) -> List[str]: def postprocess(item): if _default_regex.match(item): default = item[:7] # can't be separated by anything other than a single space # for now other = item[8:] return [default, " ", other] else: return [item] tokens = list( item for raw_token in _token_regex.split(spec) for item in postprocess(raw_token) if item ) return tokens def _token_type(token: str, location: str = None) -> str: def is_numeric(token): try: # use complex to make sure every numeric value is detected as literal complex(token) except ValueError: return False else: return True if token.startswith(" ") or token.endswith(" "): type_ = "delimiter" elif ( is_numeric(token) or (token.startswith("{") and token.endswith("}")) or (token.startswith('"') and token.endswith('"')) or (token.startswith("'") and token.endswith("'")) ): type_ = "literal" elif token.startswith("{"): logger.warning( __("invalid value set (missing closing brace): %s"), token, location=location, ) type_ = "literal" elif token.endswith("}"): logger.warning( __("invalid value set (missing opening brace): %s"), token, location=location, ) type_ = "literal" elif token.startswith("'") or token.startswith('"'): logger.warning( __("malformed string literal (missing closing quote): %s"), token, location=location, ) type_ = "literal" elif token.endswith("'") or token.endswith('"'): logger.warning( __("malformed string literal (missing opening quote): %s"), token, location=location, ) type_ = "literal" elif token in ("optional", "default"): # default is not a official keyword (yet) but supported by the # reference implementation (numpydoc) and widely used type_ = "control" elif _xref_regex.match(token): type_ = "reference" else: type_ = "obj" return type_ def _convert_numpy_type_spec(_type: str, location: str = None, translations: dict = {}) -> str: def convert_obj(obj, translations, default_translation): translation = translations.get(obj, obj) # use :class: (the default) only if obj is not a standard singleton if translation in _SINGLETONS and default_translation == ":class:`%s`": default_translation = ":obj:`%s`" elif translation == "..." and default_translation == ":class:`%s`": # allow referencing the builtin ... default_translation = ":obj:`%s <Ellipsis>`" if _xref_regex.match(translation) is None: translation = default_translation % translation return translation tokens = _tokenize_type_spec(_type) combined_tokens = _recombine_set_tokens(tokens) types = [ (token, _token_type(token, location)) for token in combined_tokens ] converters = { "literal": lambda x: "``%s``" % x, "obj": lambda x: convert_obj(x, translations, ":class:`%s`"), "control": lambda x: "*%s*" % x, "delimiter": lambda x: x, "reference": lambda x: x, } converted = "".join(converters.get(type_)(token) for token, type_ in types) return converted class NumpyDocstring(GoogleDocstring): """Convert NumPy style docstrings to reStructuredText. Parameters ---------- docstring : :obj:`str` or :obj:`list` of :obj:`str` The docstring to parse, given either as a string or split into individual lines. config: :obj:`sphinx.ext.napoleon.Config` or :obj:`sphinx.config.Config` The configuration settings to use. If not given, defaults to the config object on `app`; or if `app` is not given defaults to the a new :class:`sphinx.ext.napoleon.Config` object. Other Parameters ---------------- app : :class:`sphinx.application.Sphinx`, optional Application object representing the Sphinx process. what : :obj:`str`, optional A string specifying the type of the object to which the docstring belongs. Valid values: "module", "class", "exception", "function", "method", "attribute". name : :obj:`str`, optional The fully qualified name of the object. obj : module, class, exception, function, method, or attribute The object to which the docstring belongs. options : :class:`sphinx.ext.autodoc.Options`, optional The options given to the directive: an object with attributes inherited_members, undoc_members, show_inheritance and noindex that are True if the flag option of same name was given to the auto directive. Example ------- >>> from sphinx.ext.napoleon import Config >>> config = Config(napoleon_use_param=True, napoleon_use_rtype=True) >>> docstring = '''One line summary. ... ... Extended description. ... ... Parameters ... ---------- ... arg1 : int ... Description of `arg1` ... arg2 : str ... Description of `arg2` ... Returns ... ------- ... str ... Description of return value. ... ''' >>> print(NumpyDocstring(docstring, config)) One line summary. <BLANKLINE> Extended description. <BLANKLINE> :param arg1: Description of `arg1` :type arg1: int :param arg2: Description of `arg2` :type arg2: str <BLANKLINE> :returns: Description of return value. :rtype: str <BLANKLINE> Methods ------- __str__() Return the parsed docstring in reStructuredText format. Returns ------- str UTF-8 encoded version of the docstring. __unicode__() Return the parsed docstring in reStructuredText format. Returns ------- unicode Unicode version of the docstring. lines() Return the parsed lines of the docstring in reStructuredText format. Returns ------- list(str) The lines of the docstring in a list. """ def __init__(self, docstring: Union[str, List[str]], config: SphinxConfig = None, app: Sphinx = None, what: str = '', name: str = '', obj: Any = None, options: Any = None) -> None: self._directive_sections = ['.. index::'] super().__init__(docstring, config, app, what, name, obj, options) def _get_location(self) -> str: try: filepath = inspect.getfile(self._obj) if self._obj is not None else None except TypeError: filepath = None name = self._name if filepath is None and name is None: return None elif filepath is None: filepath = "" return ":".join([filepath, "docstring of %s" % name]) def _escape_args_and_kwargs(self, name: str) -> str: func = super()._escape_args_and_kwargs if ", " in name: return ", ".join(func(param) for param in name.split(", ")) else: return func(name) def _consume_field(self, parse_type: bool = True, prefer_type: bool = False ) -> Tuple[str, str, List[str]]: line = next(self._line_iter) if parse_type: _name, _, _type = self._partition_field_on_colon(line) else: _name, _type = line, '' _name, _type = _name.strip(), _type.strip() _name = self._escape_args_and_kwargs(_name) if parse_type and not _type: _type = self._lookup_annotation(_name) if prefer_type and not _type: _type, _name = _name, _type if self._config.napoleon_preprocess_types: _type = _convert_numpy_type_spec( _type, location=self._get_location(), translations=self._config.napoleon_type_aliases or {}, ) indent = self._get_indent(line) + 1 _desc = self._dedent(self._consume_indented_block(indent)) _desc = self.__class__(_desc, self._config).lines() return _name, _type, _desc def _consume_returns_section(self, preprocess_types: bool = False ) -> List[Tuple[str, str, List[str]]]: return self._consume_fields(prefer_type=True) def _consume_section_header(self) -> str: section = next(self._line_iter) if not _directive_regex.match(section): # Consume the header underline next(self._line_iter) return section def _is_section_break(self) -> bool: line1, line2 = self._line_iter.peek(2) return (not self._line_iter.has_next() or self._is_section_header() or ['', ''] == [line1, line2] or (self._is_in_section and line1 and not self._is_indented(line1, self._section_indent))) def _is_section_header(self) -> bool: section, underline = self._line_iter.peek(2) section = section.lower() if section in self._sections and isinstance(underline, str): return bool(_numpy_section_regex.match(underline)) elif self._directive_sections: if _directive_regex.match(section): for directive_section in self._directive_sections: if section.startswith(directive_section): return True return False def _parse_see_also_section(self, section: str) -> List[str]: lines = self._consume_to_next_section() try: return self._parse_numpydoc_see_also_section(lines) except ValueError: return self._format_admonition('seealso', lines) def _parse_numpydoc_see_also_section(self, content: List[str]) -> List[str]: """ Derived from the NumpyDoc implementation of _parse_see_also. See Also -------- func_name : Descriptive text continued text another_func_name : Descriptive text func_name1, func_name2, :meth:`func_name`, func_name3 """ items = [] def parse_item_name(text: str) -> Tuple[str, str]: """Match ':role:`name`' or 'name'""" m = self._name_rgx.match(text) if m: g = m.groups() if g[1] is None: return g[3], None else: return g[2], g[1] raise ValueError("%s is not a item name" % text) def push_item(name: str, rest: List[str]) -> None: if not name: return name, role = parse_item_name(name) items.append((name, list(rest), role)) del rest[:] def translate(func, description, role): translations = self._config.napoleon_type_aliases if role is not None or not translations: return func, description, role translated = translations.get(func, func) match = self._name_rgx.match(translated) if not match: return translated, description, role groups = match.groupdict() role = groups["role"] new_func = groups["name"] or groups["name2"] return new_func, description, role current_func = None rest: List[str] = [] for line in content: if not line.strip(): continue m = self._name_rgx.match(line) if m and line[m.end():].strip().startswith(':'): push_item(current_func, rest) current_func, line = line[:m.end()], line[m.end():] rest = [line.split(':', 1)[1].strip()] if not rest[0]: rest = [] elif not line.startswith(' '): push_item(current_func, rest) current_func = None if ',' in line: for func in line.split(','): if func.strip(): push_item(func, []) elif line.strip(): current_func = line elif current_func is not None: rest.append(line.strip()) push_item(current_func, rest) if not items: return [] # apply type aliases items = [ translate(func, description, role) for func, description, role in items ] lines: List[str] = [] last_had_desc = True for name, desc, role in items: if role: link = ':%s:`%s`' % (role, name) else: link = ':obj:`%s`' % name if desc or last_had_desc: lines += [''] lines += [link] else: lines[-1] += ", %s" % link if desc: lines += self._indent([' '.join(desc)]) last_had_desc = True else: last_had_desc = False lines += [''] return self._format_admonition('seealso', lines) �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/napoleon/iterators.py�������������������������������������������������������0000644�0000766�0000024�00000016644�00000000000�020660� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.napoleon.iterators ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ A collection of helpful iterators. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import collections from typing import Any, Iterable, Optional class peek_iter: """An iterator object that supports peeking ahead. Parameters ---------- o : iterable or callable `o` is interpreted very differently depending on the presence of `sentinel`. If `sentinel` is not given, then `o` must be a collection object which supports either the iteration protocol or the sequence protocol. If `sentinel` is given, then `o` must be a callable object. sentinel : any value, optional If given, the iterator will call `o` with no arguments for each call to its `next` method; if the value returned is equal to `sentinel`, :exc:`StopIteration` will be raised, otherwise the value will be returned. See Also -------- `peek_iter` can operate as a drop in replacement for the built-in `iter <https://docs.python.org/3/library/functions.html#iter>`_ function. Attributes ---------- sentinel The value used to indicate the iterator is exhausted. If `sentinel` was not given when the `peek_iter` was instantiated, then it will be set to a new object instance: ``object()``. """ def __init__(self, *args: Any) -> None: """__init__(o, sentinel=None)""" self._iterable: Iterable = iter(*args) self._cache: collections.deque = collections.deque() if len(args) == 2: self.sentinel = args[1] else: self.sentinel = object() def __iter__(self) -> "peek_iter": return self def __next__(self, n: int = None) -> Any: return self.next(n) def _fillcache(self, n: Optional[int]) -> None: """Cache `n` items. If `n` is 0 or None, then 1 item is cached.""" if not n: n = 1 try: while len(self._cache) < n: self._cache.append(next(self._iterable)) # type: ignore except StopIteration: while len(self._cache) < n: self._cache.append(self.sentinel) def has_next(self) -> bool: """Determine if iterator is exhausted. Returns ------- bool True if iterator has more items, False otherwise. Note ---- Will never raise :exc:`StopIteration`. """ return self.peek() != self.sentinel def next(self, n: int = None) -> Any: """Get the next item or `n` items of the iterator. Parameters ---------- n : int or None The number of items to retrieve. Defaults to None. Returns ------- item or list of items The next item or `n` items of the iterator. If `n` is None, the item itself is returned. If `n` is an int, the items will be returned in a list. If `n` is 0, an empty list is returned. Raises ------ StopIteration Raised if the iterator is exhausted, even if `n` is 0. """ self._fillcache(n) if not n: if self._cache[0] == self.sentinel: raise StopIteration if n is None: result = self._cache.popleft() else: result = [] else: if self._cache[n - 1] == self.sentinel: raise StopIteration result = [self._cache.popleft() for i in range(n)] return result def peek(self, n: Optional[int] = None) -> Any: """Preview the next item or `n` items of the iterator. The iterator is not advanced when peek is called. Returns ------- item or list of items The next item or `n` items of the iterator. If `n` is None, the item itself is returned. If `n` is an int, the items will be returned in a list. If `n` is 0, an empty list is returned. If the iterator is exhausted, `peek_iter.sentinel` is returned, or placed as the last item in the returned list. Note ---- Will never raise :exc:`StopIteration`. """ self._fillcache(n) if n is None: result = self._cache[0] else: result = [self._cache[i] for i in range(n)] return result class modify_iter(peek_iter): """An iterator object that supports modifying items as they are returned. Parameters ---------- o : iterable or callable `o` is interpreted very differently depending on the presence of `sentinel`. If `sentinel` is not given, then `o` must be a collection object which supports either the iteration protocol or the sequence protocol. If `sentinel` is given, then `o` must be a callable object. sentinel : any value, optional If given, the iterator will call `o` with no arguments for each call to its `next` method; if the value returned is equal to `sentinel`, :exc:`StopIteration` will be raised, otherwise the value will be returned. modifier : callable, optional The function that will be used to modify each item returned by the iterator. `modifier` should take a single argument and return a single value. Defaults to ``lambda x: x``. If `sentinel` is not given, `modifier` must be passed as a keyword argument. Attributes ---------- modifier : callable `modifier` is called with each item in `o` as it is iterated. The return value of `modifier` is returned in lieu of the item. Values returned by `peek` as well as `next` are affected by `modifier`. However, `modify_iter.sentinel` is never passed through `modifier`; it will always be returned from `peek` unmodified. Example ------- >>> a = [" A list ", ... " of strings ", ... " with ", ... " extra ", ... " whitespace. "] >>> modifier = lambda s: s.strip().replace('with', 'without') >>> for s in modify_iter(a, modifier=modifier): ... print('"%s"' % s) "A list" "of strings" "without" "extra" "whitespace." """ def __init__(self, *args: Any, **kwargs: Any) -> None: """__init__(o, sentinel=None, modifier=lambda x: x)""" if 'modifier' in kwargs: self.modifier = kwargs['modifier'] elif len(args) > 2: self.modifier = args[2] args = args[:2] else: self.modifier = lambda x: x if not callable(self.modifier): raise TypeError('modify_iter(o, modifier): ' 'modifier must be callable') super().__init__(*args) def _fillcache(self, n: Optional[int]) -> None: """Cache `n` modified items. If `n` is 0 or None, 1 item is cached. Each item returned by the iterator is passed through the `modify_iter.modified` function before being cached. """ if not n: n = 1 try: while len(self._cache) < n: self._cache.append(self.modifier(next(self._iterable))) # type: ignore except StopIteration: while len(self._cache) < n: self._cache.append(self.sentinel) ��������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/todo.py���������������������������������������������������������������������0000644�0000766�0000024�00000020021�00000000000�015756� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.todo ~~~~~~~~~~~~~~~ Allow todos to be inserted into your documentation. Inclusion of todos can be switched of by a configuration variable. The todolist directive collects all todos of your project and lists them along with a backlink to the original location. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Any, Dict, List, Tuple, cast from docutils import nodes from docutils.nodes import Element, Node from docutils.parsers.rst import directives from docutils.parsers.rst.directives.admonitions import BaseAdmonition import sphinx from sphinx import addnodes from sphinx.application import Sphinx from sphinx.domains import Domain from sphinx.environment import BuildEnvironment from sphinx.errors import NoUri from sphinx.locale import _, __ from sphinx.util import logging, texescape from sphinx.util.docutils import SphinxDirective, new_document from sphinx.util.typing import OptionSpec from sphinx.writers.html import HTMLTranslator from sphinx.writers.latex import LaTeXTranslator logger = logging.getLogger(__name__) class todo_node(nodes.Admonition, nodes.Element): pass class todolist(nodes.General, nodes.Element): pass class Todo(BaseAdmonition, SphinxDirective): """ A todo entry, displayed (if configured) in the form of an admonition. """ node_class = todo_node has_content = True required_arguments = 0 optional_arguments = 0 final_argument_whitespace = False option_spec: OptionSpec = { 'class': directives.class_option, 'name': directives.unchanged, } def run(self) -> List[Node]: if not self.options.get('class'): self.options['class'] = ['admonition-todo'] (todo,) = super().run() # type: Tuple[Node] if isinstance(todo, nodes.system_message): return [todo] elif isinstance(todo, todo_node): todo.insert(0, nodes.title(text=_('Todo'))) todo['docname'] = self.env.docname self.add_name(todo) self.set_source_info(todo) self.state.document.note_explicit_target(todo) return [todo] else: raise RuntimeError # never reached here class TodoDomain(Domain): name = 'todo' label = 'todo' @property def todos(self) -> Dict[str, List[todo_node]]: return self.data.setdefault('todos', {}) def clear_doc(self, docname: str) -> None: self.todos.pop(docname, None) def merge_domaindata(self, docnames: List[str], otherdata: Dict) -> None: for docname in docnames: self.todos[docname] = otherdata['todos'][docname] def process_doc(self, env: BuildEnvironment, docname: str, document: nodes.document) -> None: todos = self.todos.setdefault(docname, []) for todo in document.traverse(todo_node): env.app.emit('todo-defined', todo) todos.append(todo) if env.config.todo_emit_warnings: logger.warning(__("TODO entry found: %s"), todo[1].astext(), location=todo) class TodoList(SphinxDirective): """ A list of all todo entries. """ has_content = False required_arguments = 0 optional_arguments = 0 final_argument_whitespace = False option_spec: OptionSpec = {} def run(self) -> List[Node]: # Simply insert an empty todolist node which will be replaced later # when process_todo_nodes is called return [todolist('')] class TodoListProcessor: def __init__(self, app: Sphinx, doctree: nodes.document, docname: str) -> None: self.builder = app.builder self.config = app.config self.env = app.env self.domain = cast(TodoDomain, app.env.get_domain('todo')) self.document = new_document('') self.process(doctree, docname) def process(self, doctree: nodes.document, docname: str) -> None: todos: List[todo_node] = sum(self.domain.todos.values(), []) for node in list(doctree.traverse(todolist)): if not self.config.todo_include_todos: node.parent.remove(node) continue if node.get('ids'): content: List[Element] = [nodes.target()] else: content = [] for todo in todos: # Create a copy of the todo node new_todo = todo.deepcopy() new_todo['ids'].clear() self.resolve_reference(new_todo, docname) content.append(new_todo) todo_ref = self.create_todo_reference(todo, docname) content.append(todo_ref) node.replace_self(content) def create_todo_reference(self, todo: todo_node, docname: str) -> nodes.paragraph: if self.config.todo_link_only: description = _('<<original entry>>') else: description = (_('(The <<original entry>> is located in %s, line %d.)') % (todo.source, todo.line)) prefix = description[:description.find('<<')] suffix = description[description.find('>>') + 2:] para = nodes.paragraph(classes=['todo-source']) para += nodes.Text(prefix, prefix) # Create a reference linktext = nodes.emphasis(_('original entry'), _('original entry')) reference = nodes.reference('', '', linktext, internal=True) try: reference['refuri'] = self.builder.get_relative_uri(docname, todo['docname']) reference['refuri'] += '#' + todo['ids'][0] except NoUri: # ignore if no URI can be determined, e.g. for LaTeX output pass para += reference para += nodes.Text(suffix, suffix) return para def resolve_reference(self, todo: todo_node, docname: str) -> None: """Resolve references in the todo content.""" for node in todo.traverse(addnodes.pending_xref): if 'refdoc' in node: node['refdoc'] = docname # Note: To resolve references, it is needed to wrap it with document node self.document += todo self.env.resolve_references(self.document, docname, self.builder) self.document.remove(todo) def visit_todo_node(self: HTMLTranslator, node: todo_node) -> None: if self.config.todo_include_todos: self.visit_admonition(node) else: raise nodes.SkipNode def depart_todo_node(self: HTMLTranslator, node: todo_node) -> None: self.depart_admonition(node) def latex_visit_todo_node(self: LaTeXTranslator, node: todo_node) -> None: if self.config.todo_include_todos: self.body.append('\n\\begin{sphinxadmonition}{note}{') self.body.append(self.hypertarget_to(node)) title_node = cast(nodes.title, node[0]) title = texescape.escape(title_node.astext(), self.config.latex_engine) self.body.append('%s:}' % title) node.pop(0) else: raise nodes.SkipNode def latex_depart_todo_node(self: LaTeXTranslator, node: todo_node) -> None: self.body.append('\\end{sphinxadmonition}\n') def setup(app: Sphinx) -> Dict[str, Any]: app.add_event('todo-defined') app.add_config_value('todo_include_todos', False, 'html') app.add_config_value('todo_link_only', False, 'html') app.add_config_value('todo_emit_warnings', False, 'html') app.add_node(todolist) app.add_node(todo_node, html=(visit_todo_node, depart_todo_node), latex=(latex_visit_todo_node, latex_depart_todo_node), text=(visit_todo_node, depart_todo_node), man=(visit_todo_node, depart_todo_node), texinfo=(visit_todo_node, depart_todo_node)) app.add_directive('todo', Todo) app.add_directive('todolist', TodoList) app.add_domain(TodoDomain) app.connect('doctree-resolved', TodoListProcessor) return { 'version': sphinx.__display_version__, 'env_version': 2, 'parallel_read_safe': True } ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/ext/viewcode.py�����������������������������������������������������������������0000644�0000766�0000024�00000032746�00000000000�016637� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.ext.viewcode ~~~~~~~~~~~~~~~~~~~ Add links to module code in Python object descriptions. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import posixpath import traceback import warnings from os import path from typing import Any, Dict, Generator, Iterable, Optional, Set, Tuple, cast from docutils import nodes from docutils.nodes import Element, Node import sphinx from sphinx import addnodes from sphinx.application import Sphinx from sphinx.builders import Builder from sphinx.builders.html import StandaloneHTMLBuilder from sphinx.deprecation import RemovedInSphinx50Warning from sphinx.environment import BuildEnvironment from sphinx.locale import _, __ from sphinx.pycode import ModuleAnalyzer from sphinx.transforms.post_transforms import SphinxPostTransform from sphinx.util import get_full_modname, logging, status_iterator from sphinx.util.nodes import make_refnode logger = logging.getLogger(__name__) OUTPUT_DIRNAME = '_modules' class viewcode_anchor(Element): """Node for viewcode anchors. This node will be processed in the resolving phase. For viewcode supported builders, they will be all converted to the anchors. For not supported builders, they will be removed. """ def _get_full_modname(app: Sphinx, modname: str, attribute: str) -> Optional[str]: try: return get_full_modname(modname, attribute) except AttributeError: # sphinx.ext.viewcode can't follow class instance attribute # then AttributeError logging output only verbose mode. logger.verbose('Didn\'t find %s in %s', attribute, modname) return None except Exception as e: # sphinx.ext.viewcode follow python domain directives. # because of that, if there are no real modules exists that specified # by py:function or other directives, viewcode emits a lot of warnings. # It should be displayed only verbose mode. logger.verbose(traceback.format_exc().rstrip()) logger.verbose('viewcode can\'t import %s, failed with error "%s"', modname, e) return None def is_supported_builder(builder: Builder) -> bool: if builder.format != 'html': return False elif builder.name == 'singlehtml': return False elif builder.name.startswith('epub') and not builder.config.viewcode_enable_epub: return False else: return True def doctree_read(app: Sphinx, doctree: Node) -> None: env = app.builder.env if not hasattr(env, '_viewcode_modules'): env._viewcode_modules = {} # type: ignore def has_tag(modname: str, fullname: str, docname: str, refname: str) -> bool: entry = env._viewcode_modules.get(modname, None) # type: ignore if entry is False: return False code_tags = app.emit_firstresult('viewcode-find-source', modname) if code_tags is None: try: analyzer = ModuleAnalyzer.for_module(modname) analyzer.find_tags() except Exception: env._viewcode_modules[modname] = False # type: ignore return False code = analyzer.code tags = analyzer.tags else: code, tags = code_tags if entry is None or entry[0] != code: entry = code, tags, {}, refname env._viewcode_modules[modname] = entry # type: ignore _, tags, used, _ = entry if fullname in tags: used[fullname] = docname return True return False for objnode in list(doctree.traverse(addnodes.desc)): if objnode.get('domain') != 'py': continue names: Set[str] = set() for signode in objnode: if not isinstance(signode, addnodes.desc_signature): continue modname = signode.get('module') fullname = signode.get('fullname') refname = modname if env.config.viewcode_follow_imported_members: new_modname = app.emit_firstresult( 'viewcode-follow-imported', modname, fullname, ) if not new_modname: new_modname = _get_full_modname(app, modname, fullname) modname = new_modname if not modname: continue fullname = signode.get('fullname') if not has_tag(modname, fullname, env.docname, refname): continue if fullname in names: # only one link per name, please continue names.add(fullname) pagename = posixpath.join(OUTPUT_DIRNAME, modname.replace('.', '/')) signode += viewcode_anchor(reftarget=pagename, refid=fullname, refdoc=env.docname) def env_merge_info(app: Sphinx, env: BuildEnvironment, docnames: Iterable[str], other: BuildEnvironment) -> None: if not hasattr(other, '_viewcode_modules'): return # create a _viewcode_modules dict on the main environment if not hasattr(env, '_viewcode_modules'): env._viewcode_modules = {} # type: ignore # now merge in the information from the subprocess for modname, entry in other._viewcode_modules.items(): # type: ignore if modname not in env._viewcode_modules: # type: ignore env._viewcode_modules[modname] = entry # type: ignore else: if env._viewcode_modules[modname]: # type: ignore used = env._viewcode_modules[modname][2] # type: ignore for fullname, docname in entry[2].items(): if fullname not in used: used[fullname] = docname def env_purge_doc(app: Sphinx, env: BuildEnvironment, docname: str) -> None: modules = getattr(env, '_viewcode_modules', {}) for modname, entry in list(modules.items()): if entry is False: continue code, tags, used, refname = entry for fullname in list(used): if used[fullname] == docname: used.pop(fullname) if len(used) == 0: modules.pop(modname) class ViewcodeAnchorTransform(SphinxPostTransform): """Convert or remove viewcode_anchor nodes depends on builder.""" default_priority = 100 def run(self, **kwargs: Any) -> None: if is_supported_builder(self.app.builder): self.convert_viewcode_anchors() else: self.remove_viewcode_anchors() def convert_viewcode_anchors(self) -> None: for node in self.document.traverse(viewcode_anchor): anchor = nodes.inline('', _('[source]'), classes=['viewcode-link']) refnode = make_refnode(self.app.builder, node['refdoc'], node['reftarget'], node['refid'], anchor) node.replace_self(refnode) def remove_viewcode_anchors(self) -> None: for node in list(self.document.traverse(viewcode_anchor)): node.parent.remove(node) def missing_reference(app: Sphinx, env: BuildEnvironment, node: Element, contnode: Node ) -> Optional[Node]: # resolve our "viewcode" reference nodes -- they need special treatment if node['reftype'] == 'viewcode': warnings.warn('viewcode extension is no longer use pending_xref node. ' 'Please update your extension.', RemovedInSphinx50Warning) return make_refnode(app.builder, node['refdoc'], node['reftarget'], node['refid'], contnode) return None def get_module_filename(app: Sphinx, modname: str) -> Optional[str]: """Get module filename for *modname*.""" source_info = app.emit_firstresult('viewcode-find-source', modname) if source_info: return None else: try: filename, source = ModuleAnalyzer.get_module_source(modname) return filename except Exception: return None def should_generate_module_page(app: Sphinx, modname: str) -> bool: """Check generation of module page is needed.""" module_filename = get_module_filename(app, modname) if module_filename is None: # Always (re-)generate module page when module filename is not found. return True builder = cast(StandaloneHTMLBuilder, app.builder) basename = modname.replace('.', '/') + builder.out_suffix page_filename = path.join(app.outdir, '_modules/', basename) try: if path.getmtime(module_filename) <= path.getmtime(page_filename): # generation is not needed if the HTML page is newer than module file. return False except IOError: pass return True def collect_pages(app: Sphinx) -> Generator[Tuple[str, Dict[str, Any], str], None, None]: env = app.builder.env if not hasattr(env, '_viewcode_modules'): return if not is_supported_builder(app.builder): return highlighter = app.builder.highlighter # type: ignore urito = app.builder.get_relative_uri modnames = set(env._viewcode_modules) # type: ignore for modname, entry in status_iterator( sorted(env._viewcode_modules.items()), # type: ignore __('highlighting module code... '), "blue", len(env._viewcode_modules), # type: ignore app.verbosity, lambda x: x[0]): if not entry: continue if not should_generate_module_page(app, modname): continue code, tags, used, refname = entry # construct a page name for the highlighted source pagename = posixpath.join(OUTPUT_DIRNAME, modname.replace('.', '/')) # highlight the source using the builder's highlighter if env.config.highlight_language in ('python3', 'default', 'none'): lexer = env.config.highlight_language else: lexer = 'python' highlighted = highlighter.highlight_block(code, lexer, linenos=False) # split the code into lines lines = highlighted.splitlines() # split off wrap markup from the first line of the actual code before, after = lines[0].split('<pre>') lines[0:1] = [before + '<pre>', after] # nothing to do for the last line; it always starts with </pre> anyway # now that we have code lines (starting at index 1), insert anchors for # the collected tags (HACK: this only works if the tag boundaries are # properly nested!) maxindex = len(lines) - 1 for name, docname in used.items(): type, start, end = tags[name] backlink = urito(pagename, docname) + '#' + refname + '.' + name lines[start] = ( '<div class="viewcode-block" id="%s"><a class="viewcode-back" ' 'href="%s">%s</a>' % (name, backlink, _('[docs]')) + lines[start]) lines[min(end, maxindex)] += '</div>' # try to find parents (for submodules) parents = [] parent = modname while '.' in parent: parent = parent.rsplit('.', 1)[0] if parent in modnames: parents.append({ 'link': urito(pagename, posixpath.join(OUTPUT_DIRNAME, parent.replace('.', '/'))), 'title': parent}) parents.append({'link': urito(pagename, posixpath.join(OUTPUT_DIRNAME, 'index')), 'title': _('Module code')}) parents.reverse() # putting it all together context = { 'parents': parents, 'title': modname, 'body': (_('<h1>Source code for %s</h1>') % modname + '\n'.join(lines)), } yield (pagename, context, 'page.html') if not modnames: return html = ['\n'] # the stack logic is needed for using nested lists for submodules stack = [''] for modname in sorted(modnames): if modname.startswith(stack[-1]): stack.append(modname + '.') html.append('<ul>') else: stack.pop() while not modname.startswith(stack[-1]): stack.pop() html.append('</ul>') stack.append(modname + '.') html.append('<li><a href="%s">%s</a></li>\n' % ( urito(posixpath.join(OUTPUT_DIRNAME, 'index'), posixpath.join(OUTPUT_DIRNAME, modname.replace('.', '/'))), modname)) html.append('</ul>' * (len(stack) - 1)) context = { 'title': _('Overview: module code'), 'body': (_('<h1>All modules for which code is available</h1>') + ''.join(html)), } yield (posixpath.join(OUTPUT_DIRNAME, 'index'), context, 'page.html') def setup(app: Sphinx) -> Dict[str, Any]: app.add_config_value('viewcode_import', None, False) app.add_config_value('viewcode_enable_epub', False, False) app.add_config_value('viewcode_follow_imported_members', True, False) app.connect('doctree-read', doctree_read) app.connect('env-merge-info', env_merge_info) app.connect('env-purge-doc', env_purge_doc) app.connect('html-collect-pages', collect_pages) app.connect('missing-reference', missing_reference) # app.add_config_value('viewcode_include_modules', [], 'env') # app.add_config_value('viewcode_exclude_modules', [], 'env') app.add_event('viewcode-find-source') app.add_event('viewcode-follow-imported') app.add_post_transform(ViewcodeAnchorTransform) return { 'version': sphinx.__display_version__, 'env_version': 1, 'parallel_read_safe': True } ��������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/extension.py��������������������������������������������������������������������0000644�0000766�0000024�00000005377�00000000000�016246� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.extension ~~~~~~~~~~~~~~~~ Utilities for Sphinx extensions. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import TYPE_CHECKING, Any, Dict from packaging.version import InvalidVersion, Version from sphinx.config import Config from sphinx.errors import VersionRequirementError from sphinx.locale import __ from sphinx.util import logging if TYPE_CHECKING: from sphinx.application import Sphinx logger = logging.getLogger(__name__) class Extension: def __init__(self, name: str, module: Any, **kwargs: Any) -> None: self.name = name self.module = module self.metadata = kwargs self.version = kwargs.pop('version', 'unknown version') # The extension supports parallel read or not. The default value # is ``None``. It means the extension does not tell the status. # It will be warned on parallel reading. self.parallel_read_safe = kwargs.pop('parallel_read_safe', None) # The extension supports parallel write or not. The default value # is ``True``. Sphinx writes parallelly documents even if # the extension does not tell its status. self.parallel_write_safe = kwargs.pop('parallel_write_safe', True) def verify_needs_extensions(app: "Sphinx", config: Config) -> None: """Verify the required Sphinx extensions are loaded.""" if config.needs_extensions is None: return for extname, reqversion in config.needs_extensions.items(): extension = app.extensions.get(extname) if extension is None: logger.warning(__('The %s extension is required by needs_extensions settings, ' 'but it is not loaded.'), extname) continue fulfilled = True if extension.version == 'unknown version': fulfilled = False else: try: if Version(reqversion) > Version(extension.version): fulfilled = False except InvalidVersion: if reqversion > extension.version: fulfilled = False if not fulfilled: raise VersionRequirementError(__('This project needs the extension %s at least in ' 'version %s and therefore cannot be built with ' 'the loaded version (%s).') % (extname, reqversion, extension.version)) def setup(app: "Sphinx") -> Dict[str, Any]: app.connect('config-inited', verify_needs_extensions, priority=800) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/highlighting.py�����������������������������������������������������������������0000644�0000766�0000024�00000014640�00000000000�016670� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.highlighting ~~~~~~~~~~~~~~~~~~~ Highlight code blocks using Pygments. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from functools import partial from importlib import import_module from typing import Any, Dict from packaging import version from pygments import __version__ as pygmentsversion from pygments import highlight from pygments.filters import ErrorToken from pygments.formatter import Formatter from pygments.formatters import HtmlFormatter, LatexFormatter from pygments.lexer import Lexer from pygments.lexers import (CLexer, Python3Lexer, PythonConsoleLexer, PythonLexer, RstLexer, TextLexer, get_lexer_by_name, guess_lexer) from pygments.style import Style from pygments.styles import get_style_by_name from pygments.util import ClassNotFound from sphinx.locale import __ from sphinx.pygments_styles import NoneStyle, SphinxStyle from sphinx.util import logging, texescape logger = logging.getLogger(__name__) lexers: Dict[str, Lexer] = {} lexer_classes: Dict[str, Lexer] = { 'none': partial(TextLexer, stripnl=False), 'python': partial(PythonLexer, stripnl=False), 'python3': partial(Python3Lexer, stripnl=False), 'pycon': partial(PythonConsoleLexer, stripnl=False), 'pycon3': partial(PythonConsoleLexer, python3=True, stripnl=False), 'rest': partial(RstLexer, stripnl=False), 'c': partial(CLexer, stripnl=False), } escape_hl_chars = {ord('\\'): '\\PYGZbs{}', ord('{'): '\\PYGZob{}', ord('}'): '\\PYGZcb{}'} # used if Pygments is available # use textcomp quote to get a true single quote _LATEX_ADD_STYLES = r''' \renewcommand\PYGZsq{\textquotesingle} ''' # fix extra space between lines when Pygments highlighting uses \fcolorbox # add a {..} to limit \fboxsep scope, and force \fcolorbox use correct value # cf pygments #1708 which makes this unneeded for Pygments > 2.7.4 _LATEX_ADD_STYLES_FIXPYG = r''' \makeatletter % fix for Pygments <= 2.7.4 \let\spx@original@fcolorbox\fcolorbox \def\spx@fixpyg@fcolorbox{\fboxsep-\fboxrule\spx@original@fcolorbox} \def\PYG#1#2{\PYG@reset\PYG@toks#1+\relax+% {\let\fcolorbox\spx@fixpyg@fcolorbox\PYG@do{#2}}} \makeatother ''' if version.parse(pygmentsversion).release <= (2, 7, 4): _LATEX_ADD_STYLES += _LATEX_ADD_STYLES_FIXPYG class PygmentsBridge: # Set these attributes if you want to have different Pygments formatters # than the default ones. html_formatter = HtmlFormatter latex_formatter = LatexFormatter def __init__(self, dest: str = 'html', stylename: str = 'sphinx', latex_engine: str = None) -> None: self.dest = dest self.latex_engine = latex_engine style = self.get_style(stylename) self.formatter_args: Dict[str, Any] = {'style': style} if dest == 'html': self.formatter = self.html_formatter else: self.formatter = self.latex_formatter self.formatter_args['commandprefix'] = 'PYG' def get_style(self, stylename: str) -> Style: if stylename is None or stylename == 'sphinx': return SphinxStyle elif stylename == 'none': return NoneStyle elif '.' in stylename: module, stylename = stylename.rsplit('.', 1) return getattr(import_module(module), stylename) else: return get_style_by_name(stylename) def get_formatter(self, **kwargs: Any) -> Formatter: kwargs.update(self.formatter_args) return self.formatter(**kwargs) def get_lexer(self, source: str, lang: str, opts: Dict = None, force: bool = False, location: Any = None) -> Lexer: if not opts: opts = {} # find out which lexer to use if lang in ('py', 'python'): if source.startswith('>>>'): # interactive session lang = 'pycon' else: lang = 'python' elif lang in ('py3', 'python3', 'default'): if source.startswith('>>>'): lang = 'pycon3' else: lang = 'python3' if lang in lexers: # just return custom lexers here (without installing raiseonerror filter) return lexers[lang] elif lang in lexer_classes: lexer = lexer_classes[lang](**opts) else: try: if lang == 'guess': lexer = guess_lexer(source, **opts) else: lexer = get_lexer_by_name(lang, **opts) except ClassNotFound: logger.warning(__('Pygments lexer name %r is not known'), lang, location=location) lexer = lexer_classes['none'](**opts) if not force: lexer.add_filter('raiseonerror') return lexer def highlight_block(self, source: str, lang: str, opts: Dict = None, force: bool = False, location: Any = None, **kwargs: Any) -> str: if not isinstance(source, str): source = source.decode() lexer = self.get_lexer(source, lang, opts, force, location) # highlight via Pygments formatter = self.get_formatter(**kwargs) try: hlsource = highlight(source, lexer, formatter) except ErrorToken: # this is most probably not the selected language, # so let it pass unhighlighted if lang == 'default': pass # automatic highlighting failed. else: logger.warning(__('Could not lex literal_block as "%s". ' 'Highlighting skipped.'), lang, type='misc', subtype='highlighting_failure', location=location) lexer = self.get_lexer(source, 'none', opts, force, location) hlsource = highlight(source, lexer, formatter) if self.dest == 'html': return hlsource else: # MEMO: this is done to escape Unicode chars with non-Unicode engines return texescape.hlescape(hlsource, self.latex_engine) def get_stylesheet(self) -> str: formatter = self.get_formatter() if self.dest == 'html': return formatter.get_style_defs('.highlight') else: return formatter.get_style_defs() + _LATEX_ADD_STYLES ������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/io.py���������������������������������������������������������������������������0000644�0000766�0000024�00000014624�00000000000�014634� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.io ~~~~~~~~~ Input/Output files :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import codecs from typing import TYPE_CHECKING, Any, List, Type from docutils import nodes from docutils.core import Publisher from docutils.frontend import Values from docutils.io import FileInput, Input, NullOutput from docutils.parsers import Parser from docutils.parsers.rst import Parser as RSTParser from docutils.readers import standalone from docutils.transforms import Transform from docutils.transforms.references import DanglingReferences from docutils.writers import UnfilteredWriter from sphinx import addnodes from sphinx.environment import BuildEnvironment from sphinx.transforms import (AutoIndexUpgrader, DoctreeReadEvent, FigureAligner, SphinxTransformer) from sphinx.transforms.i18n import (Locale, PreserveTranslatableMessages, RemoveTranslatableInline) from sphinx.transforms.references import SphinxDomains from sphinx.util import UnicodeDecodeErrorHandler, get_filetype, logging from sphinx.util.docutils import LoggingReporter from sphinx.versioning import UIDTransform if TYPE_CHECKING: from sphinx.application import Sphinx logger = logging.getLogger(__name__) class SphinxBaseReader(standalone.Reader): """ A base class of readers for Sphinx. This replaces reporter by Sphinx's on generating document. """ transforms: List[Type[Transform]] = [] def __init__(self, *args: Any, **kwargs: Any) -> None: from sphinx.application import Sphinx if len(args) > 0 and isinstance(args[0], Sphinx): self._app = args[0] self._env = self._app.env args = args[1:] super().__init__(*args, **kwargs) def setup(self, app: "Sphinx") -> None: self._app = app # hold application object only for compatibility self._env = app.env def get_transforms(self) -> List[Type[Transform]]: transforms = super().get_transforms() + self.transforms # remove transforms which is not needed for Sphinx unused = [DanglingReferences] for transform in unused: if transform in transforms: transforms.remove(transform) return transforms def new_document(self) -> nodes.document: """ Creates a new document object which has a special reporter object good for logging. """ document = super().new_document() document.__class__ = addnodes.document # replace the class with patched version # substitute transformer document.transformer = SphinxTransformer(document) document.transformer.set_environment(self.settings.env) # substitute reporter reporter = document.reporter document.reporter = LoggingReporter.from_reporter(reporter) return document class SphinxStandaloneReader(SphinxBaseReader): """ A basic document reader for Sphinx. """ def setup(self, app: "Sphinx") -> None: self.transforms = self.transforms + app.registry.get_transforms() super().setup(app) def read(self, source: Input, parser: Parser, settings: Values) -> nodes.document: self.source = source if not self.parser: self.parser = parser self.settings = settings self.input = self.read_source(settings.env) self.parse() return self.document def read_source(self, env: BuildEnvironment) -> str: """Read content from source and do post-process.""" content = self.source.read() # emit "source-read" event arg = [content] env.events.emit('source-read', env.docname, arg) return arg[0] class SphinxI18nReader(SphinxBaseReader): """ A document reader for i18n. This returns the source line number of original text as current source line number to let users know where the error happened. Because the translated texts are partial and they don't have correct line numbers. """ def setup(self, app: "Sphinx") -> None: super().setup(app) self.transforms = self.transforms + app.registry.get_transforms() unused = [PreserveTranslatableMessages, Locale, RemoveTranslatableInline, AutoIndexUpgrader, FigureAligner, SphinxDomains, DoctreeReadEvent, UIDTransform] for transform in unused: if transform in self.transforms: self.transforms.remove(transform) class SphinxDummyWriter(UnfilteredWriter): """Dummy writer module used for generating doctree.""" supported = ('html',) # needed to keep "meta" nodes def translate(self) -> None: pass def SphinxDummySourceClass(source: Any, *args: Any, **kwargs: Any) -> Any: """Bypass source object as is to cheat Publisher.""" return source class SphinxFileInput(FileInput): """A basic FileInput for Sphinx.""" def __init__(self, *args: Any, **kwargs: Any) -> None: kwargs['error_handler'] = 'sphinx' super().__init__(*args, **kwargs) def read_doc(app: "Sphinx", env: BuildEnvironment, filename: str) -> nodes.document: """Parse a document and convert to doctree.""" # set up error_handler for the target document error_handler = UnicodeDecodeErrorHandler(env.docname) codecs.register_error('sphinx', error_handler) # type: ignore reader = SphinxStandaloneReader() reader.setup(app) filetype = get_filetype(app.config.source_suffix, filename) parser = app.registry.create_source_parser(app, filetype) if parser.__class__.__name__ == 'CommonMarkParser' and parser.settings_spec == (): # a workaround for recommonmark # If recommonmark.AutoStrictify is enabled, the parser invokes reST parser # internally. But recommonmark-0.4.0 does not provide settings_spec for reST # parser. As a workaround, this copies settings_spec for RSTParser to the # CommonMarkParser. parser.settings_spec = RSTParser.settings_spec pub = Publisher(reader=reader, parser=parser, writer=SphinxDummyWriter(), source_class=SphinxFileInput, destination=NullOutput()) pub.process_programmatic_settings(None, env.settings, None) pub.set_source(source_path=filename) pub.publish() return pub.document ������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/jinja2glue.py�������������������������������������������������������������������0000644�0000766�0000024�00000016020�00000000000�016247� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.jinja2glue ~~~~~~~~~~~~~~~~~ Glue code for the jinja2 templating engine. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from os import path from pprint import pformat from typing import TYPE_CHECKING, Any, Callable, Dict, Iterator, List, Tuple, Union from jinja2 import BaseLoader, FileSystemLoader, TemplateNotFound from jinja2.environment import Environment from jinja2.sandbox import SandboxedEnvironment from jinja2.utils import open_if_exists from sphinx.application import TemplateBridge from sphinx.theming import Theme from sphinx.util import logging from sphinx.util.osutil import mtimes_of_files try: from jinja2.utils import pass_context except ImportError: from jinja2 import contextfunction as pass_context if TYPE_CHECKING: from sphinx.builders import Builder def _tobool(val: str) -> bool: if isinstance(val, str): return val.lower() in ('true', '1', 'yes', 'on') return bool(val) def _toint(val: str) -> int: try: return int(val) except ValueError: return 0 def _todim(val: Union[int, str]) -> str: """ Make val a css dimension. In particular the following transformations are performed: - None -> 'initial' (default CSS value) - 0 -> '0' - ints and string representations of ints are interpreted as pixels. Everything else is returned unchanged. """ if val is None: return 'initial' elif str(val).isdigit(): return '0' if int(val) == 0 else '%spx' % val return val # type: ignore def _slice_index(values: List, slices: int) -> Iterator[List]: seq = list(values) length = 0 for value in values: length += 1 + len(value[1][1]) # count includes subitems items_per_slice = length // slices offset = 0 for slice_number in range(slices): count = 0 start = offset if slices == slice_number + 1: # last column offset = len(seq) else: for value in values[offset:]: count += 1 + len(value[1][1]) offset += 1 if count >= items_per_slice: break yield seq[start:offset] def accesskey(context: Any, key: str) -> str: """Helper to output each access key only once.""" if '_accesskeys' not in context: context.vars['_accesskeys'] = {} if key and key not in context.vars['_accesskeys']: context.vars['_accesskeys'][key] = 1 return 'accesskey="%s"' % key return '' class idgen: def __init__(self) -> None: self.id = 0 def current(self) -> int: return self.id def __next__(self) -> int: self.id += 1 return self.id next = __next__ # Python 2/Jinja compatibility @pass_context def warning(context: Dict, message: str, *args: Any, **kwargs: Any) -> str: if 'pagename' in context: filename = context.get('pagename') + context.get('file_suffix', '') message = 'in rendering %s: %s' % (filename, message) logger = logging.getLogger('sphinx.themes') logger.warning(message, *args, **kwargs) return '' # return empty string not to output any values class SphinxFileSystemLoader(FileSystemLoader): """ FileSystemLoader subclass that is not so strict about '..' entries in template names. """ def get_source(self, environment: Environment, template: str) -> Tuple[str, str, Callable]: for searchpath in self.searchpath: filename = path.join(searchpath, template) f = open_if_exists(filename) if f is None: continue with f: contents = f.read().decode(self.encoding) mtime = path.getmtime(filename) def uptodate() -> bool: try: return path.getmtime(filename) == mtime except OSError: return False return contents, filename, uptodate raise TemplateNotFound(template) class BuiltinTemplateLoader(TemplateBridge, BaseLoader): """ Interfaces the rendering environment of jinja2 for use in Sphinx. """ # TemplateBridge interface def init(self, builder: "Builder", theme: Theme = None, dirs: List[str] = None) -> None: # create a chain of paths to search if theme: # the theme's own dir and its bases' dirs pathchain = theme.get_theme_dirs() # the loader dirs: pathchain + the parent directories for all themes loaderchain = pathchain + [path.join(p, '..') for p in pathchain] elif dirs: pathchain = list(dirs) loaderchain = list(dirs) else: pathchain = [] loaderchain = [] # prepend explicit template paths self.templatepathlen = len(builder.config.templates_path) if builder.config.templates_path: cfg_templates_path = [path.join(builder.confdir, tp) for tp in builder.config.templates_path] pathchain[0:0] = cfg_templates_path loaderchain[0:0] = cfg_templates_path # store it for use in newest_template_mtime self.pathchain = pathchain # make the paths into loaders self.loaders = [SphinxFileSystemLoader(x) for x in loaderchain] use_i18n = builder.app.translator is not None extensions = ['jinja2.ext.i18n'] if use_i18n else [] self.environment = SandboxedEnvironment(loader=self, extensions=extensions) self.environment.filters['tobool'] = _tobool self.environment.filters['toint'] = _toint self.environment.filters['todim'] = _todim self.environment.filters['slice_index'] = _slice_index self.environment.globals['debug'] = pass_context(pformat) self.environment.globals['warning'] = warning self.environment.globals['accesskey'] = pass_context(accesskey) self.environment.globals['idgen'] = idgen if use_i18n: self.environment.install_gettext_translations(builder.app.translator) def render(self, template: str, context: Dict) -> str: # type: ignore return self.environment.get_template(template).render(context) def render_string(self, source: str, context: Dict) -> str: return self.environment.from_string(source).render(context) def newest_template_mtime(self) -> float: return max(mtimes_of_files(self.pathchain, '.html')) # Loader interface def get_source(self, environment: Environment, template: str) -> Tuple[str, str, Callable]: loaders = self.loaders # exclamation mark starts search from theme if template.startswith('!'): loaders = loaders[self.templatepathlen:] template = template[1:] for loader in loaders: try: return loader.get_source(environment, template) except TemplateNotFound: pass raise TemplateNotFound(template) ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4658055 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/�������������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015103� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/__init__.py��������������������������������������������������������������0000644�0000766�0000024�00000021314�00000000000�017215� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.locale ~~~~~~~~~~~~~ Locale utilities. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import gettext import locale from collections import UserString, defaultdict from gettext import NullTranslations from typing import Any, Callable, Dict, Iterable, List, Optional, Tuple, Union class _TranslationProxy(UserString): """ Class for proxy strings from gettext translations. This is a helper for the lazy_* functions from this module. The proxy implementation attempts to be as complete as possible, so that the lazy objects should mostly work as expected, for example for sorting. This inherits from UserString because some docutils versions use UserString for their Text nodes, which then checks its argument for being either a basestring or UserString, otherwise calls str() -- not unicode() -- on it. """ __slots__ = ('_func', '_args') def __new__(cls, func: Callable, *args: str) -> object: # type: ignore if not args: # not called with "function" and "arguments", but a plain string return str(func) return object.__new__(cls) def __getnewargs__(self) -> Tuple[str]: return (self._func,) + self._args # type: ignore def __init__(self, func: Callable, *args: str) -> None: self._func = func self._args = args @property def data(self) -> str: # type: ignore return self._func(*self._args) # replace function from UserString; it instantiates a self.__class__ # for the encoding result def encode(self, encoding: str = None, errors: str = None) -> bytes: # type: ignore if encoding: if errors: return self.data.encode(encoding, errors) else: return self.data.encode(encoding) else: return self.data.encode() def __dir__(self) -> List[str]: return dir(str) def __str__(self) -> str: return str(self.data) def __add__(self, other: str) -> str: # type: ignore return self.data + other def __radd__(self, other: str) -> str: return other + self.data def __mod__(self, other: str) -> str: # type: ignore return self.data % other def __rmod__(self, other: str) -> str: return other % self.data def __mul__(self, other: Any) -> str: # type: ignore return self.data * other def __rmul__(self, other: Any) -> str: return other * self.data def __getattr__(self, name: str) -> Any: if name == '__members__': return self.__dir__() return getattr(self.data, name) def __getstate__(self) -> Tuple[Callable, Tuple[str, ...]]: return self._func, self._args def __setstate__(self, tup: Tuple[Callable, Tuple[str]]) -> None: self._func, self._args = tup def __copy__(self) -> "_TranslationProxy": return self def __repr__(self) -> str: try: return 'i' + repr(str(self.data)) except Exception: return '<%s broken>' % self.__class__.__name__ translators: Dict[Tuple[str, str], NullTranslations] = defaultdict(NullTranslations) def init(locale_dirs: List[Optional[str]], language: Optional[str], catalog: str = 'sphinx', namespace: str = 'general') -> Tuple[NullTranslations, bool]: """Look for message catalogs in `locale_dirs` and *ensure* that there is at least a NullTranslations catalog set in `translators`. If called multiple times or if several ``.mo`` files are found, their contents are merged together (thus making ``init`` reentrant). """ global translators translator = translators.get((namespace, catalog)) # ignore previously failed attempts to find message catalogs if translator.__class__ is NullTranslations: translator = None # the None entry is the system's default locale path has_translation = True if language and '_' in language: # for language having country code (like "de_AT") languages: Optional[List[str]] = [language, language.split('_')[0]] elif language: languages = [language] else: languages = None # loading for dir_ in locale_dirs: try: trans = gettext.translation(catalog, localedir=dir_, languages=languages) if translator is None: translator = trans else: translator.add_fallback(trans) except Exception: # Language couldn't be found in the specified path pass # guarantee translators[(namespace, catalog)] exists if translator is None: translator = NullTranslations() has_translation = False translators[(namespace, catalog)] = translator return translator, has_translation def setlocale(category: int, value: Union[str, Iterable[str]] = None) -> None: """Update locale settings. This does not throw any exception even if update fails. This is workaround for Python's bug. For more details: * https://github.com/sphinx-doc/sphinx/issues/5724 * https://bugs.python.org/issue18378#msg215215 .. note:: Only for internal use. Please don't call this method from extensions. This will be removed in future. """ try: locale.setlocale(category, value) except locale.Error: pass def init_console(locale_dir: str, catalog: str) -> Tuple[NullTranslations, bool]: """Initialize locale for console. .. versionadded:: 1.8 """ try: # encoding is ignored language, _ = locale.getlocale(locale.LC_MESSAGES) # type: Tuple[Optional[str], Any] except AttributeError: # LC_MESSAGES is not always defined. Fallback to the default language # in case it is not. language = None return init([locale_dir], language, catalog, 'console') def get_translator(catalog: str = 'sphinx', namespace: str = 'general') -> NullTranslations: return translators[(namespace, catalog)] def is_translator_registered(catalog: str = 'sphinx', namespace: str = 'general') -> bool: return (namespace, catalog) in translators def _lazy_translate(catalog: str, namespace: str, message: str) -> str: """Used instead of _ when creating TranslationProxy, because _ is not bound yet at that time. """ translator = get_translator(catalog, namespace) return translator.gettext(message) def get_translation(catalog: str, namespace: str = 'general') -> Callable: """Get a translation function based on the *catalog* and *namespace*. The extension can use this API to translate the messages on the extension:: import os from sphinx.locale import get_translation MESSAGE_CATALOG_NAME = 'myextension' # name of *.pot, *.po and *.mo files _ = get_translation(MESSAGE_CATALOG_NAME) text = _('Hello Sphinx!') def setup(app): package_dir = os.path.abspath(os.path.dirname(__file__)) locale_dir = os.path.join(package_dir, 'locales') app.add_message_catalog(MESSAGE_CATALOG_NAME, locale_dir) With this code, sphinx searches a message catalog from ``${package_dir}/locales/${language}/LC_MESSAGES/myextension.mo``. The :confval:`language` is used for the searching. .. versionadded:: 1.8 """ def gettext(message: str, *args: Any) -> str: if not is_translator_registered(catalog, namespace): # not initialized yet return _TranslationProxy(_lazy_translate, catalog, namespace, message) # type: ignore # NOQA else: translator = get_translator(catalog, namespace) if len(args) <= 1: return translator.gettext(message) else: # support pluralization return translator.ngettext(message, args[0], args[1]) return gettext # A shortcut for sphinx-core #: Translation function for messages on documentation (menu, labels, themes and so on). #: This function follows :confval:`language` setting. _ = get_translation('sphinx') #: Translation function for console messages #: This function follows locale setting (`LC_ALL`, `LC_MESSAGES` and so on). __ = get_translation('sphinx', 'console') # labels admonitionlabels = { 'attention': _('Attention'), 'caution': _('Caution'), 'danger': _('Danger'), 'error': _('Error'), 'hint': _('Hint'), 'important': _('Important'), 'note': _('Note'), 'seealso': _('See also'), 'tip': _('Tip'), 'warning': _('Warning'), } # Moved to sphinx.directives.other (will be overridden later) versionlabels: Dict[str, str] = {} # Moved to sphinx.domains.python (will be overridden later) pairindextypes: Dict[str, str] = {} ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.322727 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ar/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015505� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4665587 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ar/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017272� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ar/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000007341�00000000000�021146� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "ar", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\"> \u062d\u0642\u0648\u0642 \u0627\u0644\u0646\u0634\u0631 </a> %(copyright)s", "© Copyright %(copyright)s.": "© \u062d\u0642\u0648\u0642 \u0627\u0644\u0646\u0634\u0631 %(copyright)s", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "\u0627\u0644\u0645\u062d\u062a\u0648\u0649", "Copyright": "\u0627\u0644\u062d\u0642\u0648\u0642", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "\u0627\u0644\u0641\u0647\u0631\u0633 \u0627\u0644\u0639\u0627\u0645", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "\u062a\u062c\u0647\u064a\u0632 \u0627\u0644\u0628\u062d\u062b", "Navigation": "", "Next topic": "\u0627\u0644\u0645\u0648\u0636\u0648\u0639 \u0627\u0644\u062a\u0627\u0644\u064a", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "\u0627\u0644\u0645\u0648\u0636\u0648\u0639 \u0627\u0644\u0633\u0627\u0628\u0642", "Quick search": "\u0627\u0644\u0628\u062d\u062b \u0627\u0644\u0633\u0631\u064a\u0639", "Search": "\u0628\u062d\u062b", "Search Page": "\u0635\u0641\u062d\u0629 \u0627\u0644\u0628\u062d\u062b", "Search Results": "\u0646\u062a\u0627\u0626\u062c \u0627\u0644\u0628\u062d\u062b", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "\u0627\u0644\u0628\u062d\u062b \u0636\u0645\u0646 %(docstitle)s", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "\u0625\u0638\u0647\u0627\u0631 \u0627\u0644\u0645\u0635\u062f\u0631", "Table of Contents": "\u0642\u0627\u0626\u0645\u0629 \u0627\u0644\u0645\u062d\u062a\u0648\u064a\u0627\u062a", "This Page": "\u0647\u0630\u0647 \u0627\u0644\u0635\u0641\u062d\u0629", "Welcome! This is": "\u0623\u0647\u0644\u0627 \u0648\u0633\u0647\u0644\u0627 \u0647\u0630\u0627", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "\u0627\u0644\u0641\u0635\u0644 \u0627\u0644\u062a\u0627\u0644\u064a", "previous chapter": "\u0627\u0644\u0642\u0633\u0645 \u0627\u0644\u0633\u0627\u0628\u0642", "quick access to all modules": "", "search": "\u0628\u062d\u062b", "search this documentation": "", "the documentation for": "\u0627\u0644\u062a\u0648\u062b\u064a\u0642 \u0644" }, "plural_expr": "n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5" });�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ar/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000017401�00000000000�021143� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������s��������������������L�����M��6���d������� ���������������!���������� ���������� ��������(��"���?�����b�����i�����o�����w�� ���������� ���������� �����(�������������������������2��� �����B �����b �����z ����� �� ��� ����� ����� �� ��� �� ��� ����� ����� ����� �� ��� ����� �����) �� ���E �����P �����a �� ���j ��>���v ����� ����� ����� ����� ��!��� �� ���% �� ���F ��W���P ����� ����� �� ��� ����� ����� ����� ����� ����� �� ��� ����� �� ���* �����4 �����D ��$���T �����y ����� ����� ����� ��4��� ����� ����� �����4 �����H �����[ �����l �����| ����� ����� ����� �� ��� ����� ����� ��������������������;�����W�� ���\��#���i���������������������������%����� ����� ������������������#�� ���*�����4��%���J�����p�����u��������������������������A�����)���5�� ���_�����j�� �����@����� ��������������� �����&�����=���7�����u�����|������� ���������� ��������������������o����� ���c�����p�� �����+�����=�����#�����+��������D�����`�����v����������������� ����������������������������+�����A�� ���a�����k������������`����� ��� �� ���,�����8��/���V��/�����/��������������� ��������������� �������������������� ���+�����L�����h�� ����� ����������R�����8�����8���:�� ���s�������F�����/�����A��������V�����u�����������������:��������������� �����,���'��#���T�����x�� �����"�����(����� ����������F��������U�����^�����g�� ����������R������������� �����#�����=�����\�����c�����j�����|������������ �����"�����#������%s is not a directory.�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�Attention�Author name(s)�Author: �Cannot find source directory (%s)�Caution�Code author: �Contents�Copyright�Create Makefile? (y/n)�Create Windows command file? (y/n)�Danger�Error�Example�Examples�General Index�Hint�Important�Library changes�Next topic�No builder selected, using default: html�Note�Notes�Numbers�Permalink to this equation�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter either 'y' or 'n'.�Please enter some text.�Previous topic�Project language�Project name�Project release�Project version�Quick search�References�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search within %(docstitle)s�Section %s�Section author: �See also�Show Source�Source directory and destination directory cannot be identical�Source file suffix�Table %s�Table of Contents�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The XML files are in %(outdir)s.�This Page�This project needs at least Sphinx v%s and therefore cannot be built with this version.�Tip�Unknown event name: %s�Variables�Warning�Welcome! This is�[docs]�[source]�all source files�author names�build %s, %s warning.�build %s.�building [%s]: �building [mo]: �cannot copy downloadable file %r: %s�cannot copy extra file %r�cannot copy static file %r�checking consistency�class�config directory doesn't contain a conf.py file (%s)�continues on next page�copying downloadable files... �copying extra files�copying images... �create batchfile�create makefile�define a template variable�document not readable. Ignored.�done�failed�failed: %s�favicon file %r does not exist�finished with problems�generating indices�index�loading translations [%s]... �logo file %r does not exist�next�next chapter�not available for built-in messages�object�page�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�project name�reading templates... �role�search�succeeded�the documentation for�theme %r doesn't have "theme" setting�type�updating environment: �variable�writing additional files�writing additional pages�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: ar Language-Team: Arabic (http://www.transifex.com/sphinx-doc/sphinx-1/language/ar/) Plural-Forms: nplurals=6; plural=n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �%s ليس مجلد.�© <a href="%(path)s"> حقوق النشر </a> %(copyright)s�© حقوق النشر %(copyright)s�تنبيه�اسم المؤلف(ون)�المؤلف�لا يمكن العثور على المجلد المصدر (%s)�احتياط�كاتب الكود:�المحتوى�الحقوق�إنشاء Makefile ؟ (نعم / لا)�إنشاء ملف أوامر للويندوز؟ (نعم/لا)�خطر�خطأ�مثال�أمثلة�الفهرس العام�تلميح�مهم�تجهيز البحث�الموضوع التالي�لم يتم اختيار نوع البناء، تم استخدام نوع البناء الافتراضي: html�ملاحظة�ملاحظات�أرقام�رابط دائم لهذه المعادلة�أدخل امتداد الملف, مثلا '.rst' أو '.txt'�أدخل إما 'نعم' أو'لا'�الرجاء ادخال بعض النصوص�الموضوع السابق�لغة المشروع�اسم المشروع�إصدار المشروع�نسخة المشروع�البحث السريع�مراجع�تشغيل Sphinx v%s�بحث�البحث %(docstitle)s�صفحة البحث�نتائج البحث�البحث ضمن %(docstitle)s�قسم %s�مؤلف القسم:�شاهد أيضا�إظهار المصدر�لا يمكن ان يكون المجلد المصدر والمجلد الهدف متطابقين�امتداد ملف المصدر�جدول %s�قائمة المحتويات�صفحة الHTML موجودة في %(outdir)s�صفحة الHTML موجودة في %(outdir)s�ملفات الXML موجودة في %(outdir)s�هذه الصفحة�يحتاج هذا المشروع على الاقل الى الاصدار %s من Sphinx وبالتالي لا يمكن بناءه باستخدام الاصدار الحالي�نصيحة�حدث غير معروف: %s�متغيرات�تحذير�أهلا وسهلا هذا�[المستندات]�[المصدر]�جميع ملفات المصدر�أسماء المؤلفين�بناء %s، %sتحذير.�بناء %s.�بناء [%s]�بناء [mo]:�غير قادر على نسخ الملفات القابلة للتحميل %r : %s�غير قادر على نسخ المف الإضافي %r�غير قادر على نسخ الملف الثابت %r�التحقق من التوافق�كائن�مجلد الاعدادات لا يحتوي على ملف conf.py (%s)�استمرار في الصفحة التالية�نسخ الملفات القابلة للتحميل للنسخ...�نسخ ملفات إضافية�نسخ الصور...�إنشاء Batchfile ؟�إنشاء Makefile�عرف متغير للقالب�المستند غير قابل للقراءة. تجاهل.�تم�فشل�فشل: %s�ملف الايقونة %r غير موجود�انتهى مع وجود مشاكل�إنشاء الفهرس�الفهرس�تحميل الترجمات [ %s ]�ملف الشعار %r غير موجود�التالي�الفصل التالي�غير متوفرة للرسائل الافتراضية المدمجة�كائن�صفحة�تجهيز المستندات�السابق�القسم السابق�primary_domain %r لتم يتم العثور عليه، لهذا تم تجاهلة�معالجة %s�اسم المشروع�قراءة القوالب�متغير بيئة العمل�بحث�نجح�التوثيق ل�التصميم %r �نوع�تحديث البيئة:�متغير�كتابة ملفات إضافية�كتابة صفحات إضافية ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ar/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000250162�00000000000�021151� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Abdullah ahmed <Alhadab@hotmail.co.uk>, 2020 # Mohammed Shannaq <sam@ms.per.jo>, 2018 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Arabic (http://www.transifex.com/sphinx-doc/sphinx-1/language/ar/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: ar\n" "Plural-Forms: nplurals=6; plural=n==0 ? 0 : n==1 ? 1 : n==2 ? 2 : n%100>=3 && n%100<=10 ? 3 : n%100>=11 && n%100<=99 ? 4 : 5;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "لا يمكن العثور على المجلد المصدر (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "لا يمكن ان يكون المجلد المصدر والمجلد الهدف متطابقين" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "تشغيل Sphinx v%s" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "يحتاج هذا المشروع على الاقل الى الاصدار %s من Sphinx وبالتالي لا يمكن بناءه باستخدام الاصدار الحالي" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "تحميل الترجمات [ %s ]" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "تم" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "غير متوفرة للرسائل الافتراضية المدمجة" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "فشل: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "لم يتم اختيار نوع البناء، تم استخدام نوع البناء الافتراضي: html" #: sphinx/application.py:348 msgid "succeeded" msgstr "نجح" #: sphinx/application.py:349 msgid "finished with problems" msgstr "انتهى مع وجود مشاكل" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "بناء %s، %sتحذير." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "بناء %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "مجلد الاعدادات لا يحتوي على ملف conf.py (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "قسم %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "جدول %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r لتم يتم العثور عليه، لهذا تم تجاهلة" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "حدث غير معروف: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "المستند غير قابل للقراءة. تجاهل." #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "التصميم %r " #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "بناء [mo]:" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "جميع ملفات المصدر" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "بناء [%s]" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "التحقق من التوافق" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "تحديث البيئة:" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "تجهيز المستندات" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "نسخ الصور..." #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "قراءة القوالب" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "صفحة الHTML موجودة في %(outdir)s" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "كتابة ملفات إضافية" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "معالجة %s" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "ملفات الXML موجودة في %(outdir)s" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "صفحة الHTML موجودة في %(outdir)s" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "الفهرس العام" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "الفهرس" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "التالي" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "السابق" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "إنشاء الفهرس" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "كتابة صفحات إضافية " #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "نسخ الملفات القابلة للتحميل للنسخ..." #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "غير قادر على نسخ الملفات القابلة للتحميل %r : %s" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "غير قادر على نسخ الملف الثابت %r" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "نسخ ملفات إضافية" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "غير قادر على نسخ المف الإضافي %r" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "ملف الشعار %r غير موجود" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "ملف الايقونة %r غير موجود" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "الرجاء ادخال بعض النصوص" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "أدخل إما 'نعم' أو'لا'" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "أدخل امتداد الملف, مثلا '.rst' أو '.txt'" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "اسم المشروع" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "اسم المؤلف(ون)" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "نسخة المشروع" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "إصدار المشروع" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "لغة المشروع" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "امتداد ملف المصدر" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "إنشاء Makefile ؟ (نعم / لا)" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "إنشاء ملف أوامر للويندوز؟ (نعم/لا)" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "اسم المشروع" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "أسماء المؤلفين" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "إنشاء Makefile" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "إنشاء Batchfile ؟" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "عرف متغير للقالب" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "مؤلف القسم:" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "كاتب الكود:" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "المؤلف" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "متغير" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "نوع" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "كائن" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "كائن" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "متغيرات" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "متغير بيئة العمل" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "صفحة البحث" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s ليس مجلد." #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "رابط دائم لهذه المعادلة" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[المصدر]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[المستندات]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "مثال" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "أمثلة" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "ملاحظات" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "مراجع" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "تنبيه" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "احتياط" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "خطر" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "خطأ" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "تلميح" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "مهم" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "ملاحظة" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "شاهد أيضا" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "نصيحة" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "تحذير" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "استمرار في الصفحة التالية" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "أرقام" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "صفحة" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "قائمة المحتويات" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "بحث" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "إظهار المصدر" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "أهلا وسهلا هذا" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "التوثيق ل" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "البحث ضمن %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "الحقوق" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\"> حقوق النشر </a> %(copyright)s" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© حقوق النشر %(copyright)s" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "البحث %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "الموضوع السابق" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "القسم السابق" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "الموضوع التالي" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "الفصل التالي" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "بحث" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "نتائج البحث" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "البحث السريع" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "هذه الصفحة" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "تجهيز البحث" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "المحتوى" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "فشل" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3229077 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/bg/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015473� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4672976 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/bg/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017260� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/bg/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000004603�00000000000�021132� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "bg", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n != 1)" });�����������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/bg/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000000765�00000000000�021136� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$���������������,�����-����Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: bg Language-Team: Bulgarian (http://www.transifex.com/sphinx-doc/sphinx-1/language/bg/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 ������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/bg/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000241430�00000000000�021135� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Bulgarian (http://www.transifex.com/sphinx-doc/sphinx-1/language/bg/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: bg\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3230875 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/bn/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015502� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.468032 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/bn/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017267� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/bn/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000014346�00000000000�021146� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "bn", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "\u098f\u0987 \u09a1\u0995\u09c1\u09ae\u09c7\u09a8\u09cd\u099f \u09b8\u09ae\u09cd\u09aa\u09b0\u09cd\u0995\u09c7", "Automatically generated list of changes in version %(version)s": "\u09b8\u09cd\u09ac\u09df\u0982\u0995\u09cd\u09b0\u09bf\u09df\u09ad\u09be\u09ac\u09c7 \u09a4\u09c8\u09b0\u09c0 %(version)s-\u098f \u09aa\u09b0\u09bf\u09ac\u09b0\u09cd\u09a4\u09a8 \u09b8\u09ae\u09c2\u09b9\u09c7\u09b0 \u09a4\u09be\u09b2\u09bf\u0995\u09be\u0964", "C API changes": "C API \u09aa\u09b0\u09bf\u09ac\u09b0\u09cd\u09a4\u09a8", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "\u09aa\u09c2\u09b0\u09cd\u09a3\u09be\u0999\u09cd\u0997 \u09b8\u09c2\u099a\u09c0\u09aa\u09a4\u09cd\u09b0", "Contents": "", "Copyright": "\u0995\u09aa\u09bf\u09b0\u09be\u0987\u099f", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "\u098f\u0995 \u09aa\u09be\u09a4\u09be\u09df \u09b8\u09ae\u09cd\u09aa\u09c2\u09b0\u09cd\u09a3 \u0987\u09a8\u09a1\u09c7\u0995\u09cd\u09b8", "General Index": "\u09b8\u09be\u09a7\u09be\u09b0\u09a3 \u0987\u09a8\u09a1\u09c7\u0995\u09cd\u09b8", "Global Module Index": "\u0997\u09cd\u09b2\u09c7\u09be\u09ac\u09be\u09b2 \u09ae\u09a1\u09bf\u0989\u09b2 \u0987\u09a8\u09a1\u09c7\u0995\u09cd\u09b8", "Go": "\u09af\u09be\u09a8", "Hide Search Matches": "\u0985\u09a8\u09c1\u09b8\u09a8\u09cd\u09a7\u09be\u09a8\u09c7\u09b0 \u09ae\u09cd\u09af\u09be\u099a\u0997\u09c1\u09b2\u09c7\u09be \u09b2\u09c1\u0995\u09be\u09a8", "Index": "\u0987\u09a8\u09a1\u09c7\u0995\u09cd\u09b8", "Index – %(key)s": "\u0987\u09a8\u09a1\u09c7\u0995\u09cd\u09b8 – %(key)s", "Index pages by letter": "\u09ac\u09b0\u09cd\u09a3\u09be\u09a8\u09c1\u09b8\u09be\u09b0\u09c7 \u0987\u09a8\u09a1\u09c7\u0995\u09cd\u09b8 \u09aa\u09be\u09a4\u09be", "Indices and tables:": "\u0987\u09a8\u09a1\u09c7\u0995\u09cd\u09b8 \u0993 \u099f\u09c7\u09ac\u09bf\u09b2 \u09b8\u09ae\u09c2\u09b9:", "Last updated on %(last_updated)s.": "%(last_updated)s \u09b8\u09b0\u09cd\u09ac\u09b6\u09c7\u09b7 \u09aa\u09b0\u09bf\u09ac\u09b0\u09cd\u09a4\u09a8 \u0995\u09b0\u09be \u09b9\u09df\u09c7\u099b\u09c7\u0964", "Library changes": "\u09b2\u09be\u0987\u09ac\u09cd\u09b0\u09c7\u09b0\u09bf\u09b0 \u09aa\u09b0\u09bf\u09ac\u09b0\u09cd\u09a4\u09a8", "Navigation": "\u09a8\u09c7\u09ad\u09bf\u0997\u09c7\u09b6\u09a8", "Next topic": "\u09aa\u09b0\u09ac\u09b0\u09cd\u09a4\u09c0 \u099f\u09aa\u09bf\u0995", "Other changes": "\u0985\u09a8\u09cd\u09af\u09be\u09a8\u09cd\u09af \u09aa\u09b0\u09bf\u09ac\u09b0\u09cd\u09a4\u09a8", "Overview": "\u09ad\u09c1\u09ae\u09bf\u0995\u09be", "Permalink to this definition": "\u098f\u0987 \u09b8\u0982\u099c\u09cd\u099e\u09be\u09b0 \u09aa\u09be\u09b0\u09cd\u09ae\u09be\u09b2\u09bf\u0999\u09cd\u0995", "Permalink to this headline": "\u098f\u0987 \u09b6\u09bf\u09b0\u09c7\u09be\u09a8\u09be\u09ae\u09c7\u09b0 \u09aa\u09be\u09b0\u09cd\u09ae\u09be\u09b2\u09bf\u0999\u09cd\u0995", "Please activate JavaScript to enable the search\n functionality.": "\u0985\u09a8\u09c1\u09b8\u09a8\u09cd\u09a7\u09be\u09a8 \u0995\u09b0\u09be\u09b0 \u099c\u09a8\u09cd\u09af \u0985\u09a8\u09c1\u0997\u09cd\u09b0\u09b9\u09aa\u09c2\u09b0\u09cd\u09ac\u0995 \u099c\u09be\u09ad\u09be\u09b8\u09cd\u0995\u09cd\u09b0\u09bf\u09aa\u09cd\u099f \n \u09b8\u0995\u09cd\u09b0\u09bf\u09df \u0995\u09b0\u09c1\u09a8\u0964", "Preparing search...": "", "Previous topic": "\u09aa\u09c2\u09b0\u09cd\u09ac\u09ac\u09b0\u09cd\u09a4\u09c0 \u099f\u09aa\u09bf\u0995", "Quick search": "\u09a6\u09cd\u09b0\u09c1\u09a4 \u0985\u09a8\u09c1\u09b8\u09a8\u09cd\u09a7\u09be\u09a8", "Search": "\u0985\u09a8\u09c1\u09b8\u09a8\u09cd\u09a7\u09be\u09a8", "Search Page": "\u0985\u09a8\u09c1\u09b8\u09a8\u09cd\u09a7\u09be\u09a8 \u09aa\u09be\u09a4\u09be", "Search Results": "\u0985\u09a8\u09c1\u09b8\u09a8\u09cd\u09a7\u09be\u09a8\u09c7\u09b0 \u09ab\u09b2\u09be\u09ab\u09b2", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "%(docstitle)s \u098f\u09b0 \u09ae\u09a7\u09cd\u09af\u09c7 \u0996\u09c1\u0981\u099c\u09c1\u09a8", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "\u09b8\u09c7\u09be\u09b0\u09cd\u09b8 \u09a6\u09c7\u0996\u09c1\u09a8", "Table of Contents": "", "This Page": "\u098f\u0987 \u09aa\u09be\u09a4\u09be", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "\u09b8\u0995\u09b2 \u09ab\u09be\u0982\u09b6\u09a8, \u0995\u09cd\u09b2\u09be\u09b8, \u099f\u09be\u09b0\u09cd\u09ae", "can be huge": "\u0996\u09c1\u09ac \u09ac\u09dc \u09b9\u09a4\u09c7 \u09aa\u09be\u09b0\u09c7", "last updated": "", "lists all sections and subsections": "\u09b8\u0995\u09b2 \u0985\u09a8\u09c1\u099a\u09cd\u099b\u09c7\u09a6 \u09b8\u09ae\u09c2\u09b9\u09c7\u09b0 \u09a4\u09be\u09b2\u09bf\u0995\u09be", "next chapter": "\u09aa\u09b0\u09ac\u09b0\u09cd\u09a4\u09c0 \u0985\u09a7\u09cd\u09af\u09be\u09df", "previous chapter": "\u09aa\u09c2\u09b0\u09cd\u09ac\u09ac\u09b0\u09cd\u09a4\u09c0 \u0985\u09a7\u09cd\u09af\u09be\u09df", "quick access to all modules": "\u09b8\u0995\u09b2 \u09ae\u09a1\u09bf\u0989\u09b2\u09c7 \u09a6\u09cd\u09b0\u09c1\u09a4 \u09aa\u09cd\u09b0\u09ac\u09c7\u09b6", "search": "\u0996\u09c1\u0981\u099c\u09c1\u09a8", "search this documentation": "\u098f\u0987 \u09b8\u09b9\u09be\u09df\u09bf\u0995\u09be\u09a4\u09c7 \u0985\u09a8\u09c1\u09b8\u09a8\u09cd\u09a7\u09be \u0995\u09b0\u09c1\u09a8", "the documentation for": "" }, "plural_expr": "(n != 1)" });������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/bn/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000017633�00000000000�021147� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������l������|��������������������� �����������������������*�����;�� ���M�����Y�����p������������ ��������������� ����������>��������;�� ���D�����R�����Z�����p�� ���������� ��������������� ���������� ������������� ����� �����# �� ���( �����2 �����8 �����N �����d ��!���x ����� �� ��� ����� �� ��� �� ��� ����� �� ��� ����� �� ��� ����� �� ��� �����# �����@ ��B���[ ����� ��$��� �� ��� ����� ����� �� ��� ����� ����� ����� �� ��� �����* �����9 �����U �����f �� ���o �� ���{ ����� ����� ����� ����� ����� �� ��� ����� �� ��� ����� �� ��� ����� ����� ����� �����. �� ���G �����Q �� ���Z �� ���h �����v �����| ��"��� ����� ����� ����� ����� �� ��� ����� ����� ����� ����� ����� ����� �����$ �����+ �� ���E �� ���O ����] �����#�� ���&��)���0��+���Z��:��������������������&��� �����3��2���J��-���}������������8�����%����� ���A�����O��"���������������4���7��4���l������������!�����D��������7�����M��E���c��(�����>����� �����P����� ���l��$���y�������%�����D�����7�����\���W��7�����%�������������0�����P��%���i��"����� �����1����������!�����>���&��G���e�������+���Z��@�����+���������������"��������9�����R��$���n��(�����1�����7�����&���&�����M��"���g���������������������� �����;�����!���2��&���T��'���{������������E����� �����C���#��G���g�����������������%�������������-��H���F�� ��������������������(������������������4��1���S��+�����?����������H�����$���M��(���r��� (in �%b %d, %Y�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (in module %s)�%s (module)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�About these documents�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Caution�Changed in version %s�Complete Table of Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Module Index�Module author: �Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Parameters�Permalink to this definition�Permalink to this headline�Please activate JavaScript to enable the search functionality.�Previous topic�Python Enhancement Proposals; PEP %s�Quick search�Raises�Release�Return type�Returns�Search�Search %(docstitle)s�Search Page�Search Results�Search within %(docstitle)s�Section author: �See also�Show Source�This Page�Tip�Todo�Warning�[image]�all functions, classes, terms�attribute�built-in function�can be huge�class�class method�continued from previous page�data�environment variable�environment variable; %s�exception�function�glossary term�grammar token�index�keyword�lists all sections and subsections�method�module�modules�next�next chapter�object�operator�previous�previous chapter�program option�quick access to all modules�search�search this documentation�statement�static method�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: bn Language-Team: Bengali (http://www.transifex.com/sphinx-doc/sphinx-1/language/bn/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �(-�%b %d, %Y�%s (%s এ্যট্রিবিউট)�%s (বিল্ট-ইন ক্লাস)�%s (বিল্ট-ইন ভ্যারিয়েবল)�%s (%s ক্লাসে)�%s (%s মডিউলে)�%s (মডিউল)�%s() (%s ক্লাস মেথড)�%s() (%s মেথড)�%s() (%s স্ট্যাটিক মেথড)�%s() (বিল্ট-ইন ফাংশন)�%s() (ক্লাসে)�%s() (%s মডিউলে)�এই ডকুমেন্ট সম্পর্কে�দৃষ্টি আকর্ষণ�লেখক:�স্বয়ংক্রিয়ভাবে তৈরী %(version)s-এ পরিবর্তন সমূহের তালিকা।�বিল্টইন সমূহ�C API পরিবর্তন�সতর্কীকরণ�%s ভার্সনে পরিবর্তিত�পূর্ণাঙ্গ সূচীপত্র�কপিরাইট�বিপজ্জনক�ডেপ্রিকেটেড�%s ভার্সন থেকে ডেপ্রিকেটেড�ভুল (এরর)�পাদটীকা�এক পাতায় সম্পূর্ণ ইনডেক্স�সাধারণ ইনডেক্স�গ্লোবাল মডিউল ইনডেক্স�যান�অনুসন্ধানের ম্যাচগুলো লুকান�আভাস�গুরুত্বপূর্ণ�ইনডেক্স�ইনডেক্স – %(key)s�বর্ণানুসারে ইনডেক্স পাতা�ইনডেক্স ও টেবিল সমূহ:�%(last_updated)s সর্বশেষ পরিবর্তন করা হয়েছে।�লাইব্রেরির পরিবর্তন�মডিউল ইনডেক্স�মডিউল লেখক:�মডিউল লেভেল�নেভিগেশন�%s ভার্সনে নতুন�পরবর্তী টপিক�নোট�অন্যান্য পরিবর্তন�ভুমিকা�প্যারামিটার�এই সংজ্ঞার পার্মালিঙ্ক�এই শিরোনামের পার্মালিঙ্ক�অনুসন্ধান করার জন্য অনুগ্রহপূর্বক জাভাস্ক্রিপ্ট সক্রিয় করুন।�পূর্ববর্তী টপিক�পাইথন উন্নয়ন পরামর্শ; PEP %s�দ্রুত অনুসন্ধান�রেইজেস�রিলিজ�রিটার্ন টাইপ�রিটার্নস�অনুসন্ধান�%(docstitle)s-এ খুঁজুন�অনুসন্ধান পাতা�অনুসন্ধানের ফলাফল�%(docstitle)s এর মধ্যে খুঁজুন�অনুচ্ছেদ লেখক:�আরও দেখুন�সোর্স দেখুন�এই পাতা�পরামর্শ�অসমাপ্ত কাজ�সতর্কতা�[ছবি]�সকল ফাংশন, ক্লাস, টার্ম�এ্যট্রিবিউট�বিল্ট-ইন ফাংশন�খুব বড় হতে পারে�ক্লাস�ক্লাস মেথড�পূর্ববর্তী পাতা হতে চলমান�ডাটা�এনভায়রনমেন্ট ভ্যারিয়েবল�এনভায়রনমেন্ট ভ্যারিয়েবল; %s�এক্সেপশন�ফাংশন�শব্দকোষ�ব্যকরণ টোকেন�ইনডেক্স�কিওয়ার্ড�সকল অনুচ্ছেদ সমূহের তালিকা�মেথড�মডিউল�মডিউল সমূহ�পরবর্তী�পরবর্তী অধ্যায়�অবজেক্ট�অপারেটর�পূর্ববর্তী�পূর্ববর্তী অধ্যায়�প্রোগ্রাম অপশন�সকল মডিউলে দ্রুত প্রবেশ�খুঁজুন�এই সহায়িকাতে অনুসন্ধা করুন�স্ট্যাটমেন্ট�স্ট্যাটিক মেথড������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/bn/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000251511�00000000000�021145� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # FIRST AUTHOR <EMAIL@ADDRESS>, 2009 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Bengali (http://www.transifex.com/sphinx-doc/sphinx-1/language/bn/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: bn\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "পাইথন উন্নয়ন পরামর্শ; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "বিল্টইন সমূহ" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "মডিউল লেভেল" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "(-" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "সাধারণ ইনডেক্স" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "ইনডেক্স" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "পরবর্তী" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "পূর্ববর্তী" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "ইনডেক্স" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "রিলিজ" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "অনুচ্ছেদ লেখক:" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "মডিউল লেখক:" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "লেখক:" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "প্যারামিটার" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "রিটার্নস" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "রিটার্ন টাইপ" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "ফাংশন" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "%s ভার্সনে নতুন" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "%s ভার্সনে পরিবর্তিত" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "%s ভার্সন থেকে ডেপ্রিকেটেড" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "ক্লাস" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (বিল্ট-ইন ফাংশন)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s মেথড)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (ক্লাসে)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s এ্যট্রিবিউট)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (মডিউল)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "মেথড" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "ডাটা" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "এ্যট্রিবিউট" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "মডিউল" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "কিওয়ার্ড" #: sphinx/domains/python.py:60 msgid "operator" msgstr "অপারেটর" #: sphinx/domains/python.py:61 msgid "object" msgstr "অবজেক্ট" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "এক্সেপশন" #: sphinx/domains/python.py:63 msgid "statement" msgstr "স্ট্যাটমেন্ট" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "বিল্ট-ইন ফাংশন" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "রেইজেস" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (%s মডিউলে)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (%s মডিউলে)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (বিল্ট-ইন ভ্যারিয়েবল)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (বিল্ট-ইন ক্লাস)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (%s ক্লাসে)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s ক্লাস মেথড)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s স্ট্যাটিক মেথড)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "মডিউল সমূহ" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "ডেপ্রিকেটেড" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "ক্লাস মেথড" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "স্ট্যাটিক মেথড" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "এনভায়রনমেন্ট ভ্যারিয়েবল; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "শব্দকোষ" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "ব্যকরণ টোকেন" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "এনভায়রনমেন্ট ভ্যারিয়েবল" #: sphinx/domains/std.py:568 msgid "program option" msgstr "প্রোগ্রাম অপশন" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "মডিউল ইনডেক্স" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "অনুসন্ধান পাতা" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "অসমাপ্ত কাজ" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "দৃষ্টি আকর্ষণ" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "সতর্কীকরণ" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "বিপজ্জনক" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "ভুল (এরর)" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "আভাস" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "গুরুত্বপূর্ণ" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "নোট" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "আরও দেখুন" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "পরামর্শ" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "সতর্কতা" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "পূর্ববর্তী পাতা হতে চলমান" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "অনুসন্ধান" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "যান" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "সোর্স দেখুন" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "ভুমিকা" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "ইনডেক্স ও টেবিল সমূহ:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "পূর্ণাঙ্গ সূচীপত্র" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "সকল অনুচ্ছেদ সমূহের তালিকা" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "এই সহায়িকাতে অনুসন্ধা করুন" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "গ্লোবাল মডিউল ইনডেক্স" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "সকল মডিউলে দ্রুত প্রবেশ" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "সকল ফাংশন, ক্লাস, টার্ম" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "ইনডেক্স – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "এক পাতায় সম্পূর্ণ ইনডেক্স" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "বর্ণানুসারে ইনডেক্স পাতা" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "খুব বড় হতে পারে" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "নেভিগেশন" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "%(docstitle)s এর মধ্যে খুঁজুন" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "এই ডকুমেন্ট সম্পর্কে" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "কপিরাইট" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "%(last_updated)s সর্বশেষ পরিবর্তন করা হয়েছে।" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "%(docstitle)s-এ খুঁজুন" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "পূর্ববর্তী টপিক" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "পূর্ববর্তী অধ্যায়" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "পরবর্তী টপিক" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "পরবর্তী অধ্যায়" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "অনুসন্ধান করার জন্য অনুগ্রহপূর্বক জাভাস্ক্রিপ্ট \n সক্রিয় করুন।" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "খুঁজুন" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "অনুসন্ধানের ফলাফল" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "দ্রুত অনুসন্ধান" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "এই পাতা" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "স্বয়ংক্রিয়ভাবে তৈরী %(version)s-এ পরিবর্তন সমূহের তালিকা।" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "লাইব্রেরির পরিবর্তন" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API পরিবর্তন" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "অন্যান্য পরিবর্তন" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "এই শিরোনামের পার্মালিঙ্ক" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "এই সংজ্ঞার পার্মালিঙ্ক" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "অনুসন্ধানের ম্যাচগুলো লুকান" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "পাদটীকা" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[ছবি]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3232658 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ca/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015466� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.468776 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ca/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017253� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ca/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000006516�00000000000�021132� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "ca", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "Quant a aquests documents", "Automatically generated list of changes in version %(version)s": "Llista de canvis de la versi\u00f3 %(version)s generada autom\u00e0ticament", "C API changes": "Canvis a la API de C", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "Taula de Contingut Completa", "Contents": "", "Copyright": "Copyright", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "\u00cdndex complet en una p\u00e0gina", "General Index": "\u00cdndex General", "Global Module Index": "\u00cdndex Global de M\u00f2duls", "Go": "Ves a", "Hide Search Matches": "Oculta Resultats de Cerca", "Index": "\u00cdndex", "Index – %(key)s": "\u00cdndes – %(key)s", "Index pages by letter": "P\u00e0gines d'\u00edndex per lletra", "Indices and tables:": "\u00cdndexs i taules:", "Last updated on %(last_updated)s.": "\u00daltima actualitzaci\u00f3 el %(last_updated)s.", "Library changes": "Canvis a la llibreria", "Navigation": "Navegaci\u00f3", "Next topic": "Tema seg\u00fcent", "Other changes": "Altres canvis", "Overview": "Resum", "Permalink to this definition": "Link permanent a aquesta definici\u00f3", "Permalink to this headline": "Link permanent a aquest t\u00edtol", "Please activate JavaScript to enable the search\n functionality.": "Activa JavaScript per utilitzar la funcionalitat\nde cerca.", "Preparing search...": "", "Previous topic": "Tema anterior", "Quick search": "Cerca r\u00e0pida", "Search": "Cerca", "Search Page": "P\u00e0gina de Cerca", "Search Results": "Resultats de la Cerca", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "Cerca dins de %(docstitle)s", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Mostra Codi Font", "Table of Contents": "", "This Page": "Aquesta P\u00e0gina", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "totes les funcions, classes, termes", "can be huge": "pot ser gegant", "last updated": "", "lists all sections and subsections": "llista totes les seccions i subseccions", "next chapter": "cap\u00edtol seg\u00fcent", "previous chapter": "cap\u00edtol anterior", "quick access to all modules": "acc\u00e9s r\u00e0pid a tots els m\u00f2duls", "search": "cerca", "search this documentation": "cerca aquesta documentaci\u00f3", "the documentation for": "" }, "plural_expr": "(n != 1)" });����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ca/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000013035�00000000000�021123� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������l������|���������������� ���������� ������������������!�����5�����L�����]�� ���o�����{������������ ��������������� ����������>��������F�� ���O�����]�����e�����{�� ���������� �������������������� ������������� ����� �����$ �� ���) �����3 �����9 �����O �����e ��!���y ����� �� ��� ����� �� ��� �� ��� ����� �� ��� ����� �� ��� ����� �� ��� �����$ �����A ��B���\ ����� ��$��� �� ��� ����� ����� �� ��� ����� ����� ����� �� ��� �����+ �����: �����V �����g �� ���p �� ���| ����� ����� ����� ����� ����� �� ��� ����� �� ��� ����� ����� ����� ����� �� ���6 �����@ �����I �����O ��"���W �����z ����� ����� ����� ����� �� ��� ����� ����� ����� ����� ����� ����� ����� ����� �� ��� �� ���" �� ���, �����: �����? ����H �� ���������� ��������(�����<�����L�����`�����v������� �������������������� ������������� �����#�����,��C���4�����x���������������������� ����������������������� ����������1�����@�����Y�����_�� ���y�� �������������������������+�������� ����������1�����D�� ���U�����`�� ���y������� ���������� �����#����������:����� ���*��$���8�� ���]�����k�����s�����{������������������������������������� �������������&�����6�����;�����C�����I��#���R�����v�����~��������������������������� ��������������� �����'��� �����3�����9�����@�����G�����O�����X�����j�����r�����{������� ������������������������� ��������������������� (deprecated)� (in �%b %d, %Y�%s %s documentation�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (in module %s)�%s (module)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�About these documents�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Caution�Changed in version %s�Complete Table of Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Module Index�Module author: �Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Parameters�Permalink to this definition�Permalink to this headline�Please activate JavaScript to enable the search functionality.�Previous topic�Python Enhancement Proposals; PEP %s�Quick search�Raises�Release�Return type�Returns�Search�Search %(docstitle)s�Search Page�Search Results�Search within %(docstitle)s�Section author: �See also�Show Source�This Page�Tip�Todo�Warning�[image]�all functions, classes, terms�attribute�built-in function�can be huge�class�continued from previous page�environment variable�environment variable; %s�exception�function�index�keyword�lists all sections and subsections�macro�member�module�modules�next�next chapter�object�operator�previous�previous chapter�quick access to all modules�search�search this documentation�see %s�see also %s�statement�static method�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: ca Language-Team: Catalan (http://www.transifex.com/sphinx-doc/sphinx-1/language/ca/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (obsolet)� (a �%d %b, %Y�%s %s documentació�%s (atribut %s)�%s (classe interna)�%s (variable interna)�%s (class a %s)�%s (al mòdul %s)�%s (mòdul)�%s() (mètode %s)�%s() (mètode estàtic %s)�%s() (funció interna)�%s() (class)�%s() (al mòdul %s)�Quant a aquests documents�Atenció�Autor: �Llista de canvis de la versió %(version)s generada automàticament�Mòduls Interns�Canvis a la API de C�Compte�Canviat a la versió %s�Taula de Contingut Completa�Copyright�Perill�Obsolet�Obsolet desde la versió %s�Error�Índex complet en una pàgina�Índex General�Índex Global de Mòduls�Ves a�Oculta Resultats de Cerca�Suggerència�Important�Índex�Índes – %(key)s�Pàgines d'índex per lletra�Índexs i taules:�Última actualització el %(last_updated)s.�Canvis a la llibreria�Índex de Mòduls�Autor del mòdul: �Nivell de mòdul�Navegació�Novetat de la versió %s�Tema següent�Nota�Altres canvis�Resum�Paràmetres�Link permanent a aquesta definició�Link permanent a aquest títol�Activa JavaScript per utilitzar la funcionalitat de cerca.�Tema anterior�Python Enhancement Proposals; PEP %s�Cerca ràpida�Llença�Versió�Tipus de retorn�Retorna�Cerca�Cercar a %(docstitle)s�Pàgina de Cerca�Resultats de la Cerca�Cerca dins de %(docstitle)s�Autor de la secció:�Vegeu també�Mostra Codi Font�Aquesta Pàgina�Truc�Pendent�Avís�[imatge]�totes les funcions, classes, termes�atribut�funció interna�pot ser gegant�class�ve de la pàgina anterior�variable d'entorn�variable d'entorn; %s�excepció�funció�índex�paraula clau�llista totes les seccions i subseccions�macro�membre�mòdul�mòduls�següent�capítol següent�objecte�operador�anterior�capítol anterior�accés ràpid a tots els mòduls�cerca�cerca aquesta documentació�vegeu %s�vegeu també %s�sentència�mètode estàtic�tipus�variable����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ca/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000244740�00000000000�021137� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # FIRST AUTHOR <EMAIL@ADDRESS>, 2009 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Catalan (http://www.transifex.com/sphinx-doc/sphinx-1/language/ca/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: ca\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Mòduls Interns" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Nivell de mòdul" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (a " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d %b, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Índex General" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "índex" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "següent" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "anterior" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s documentació" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Índex" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Versió" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Autor de la secció:" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Autor del mòdul: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autor: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Paràmetres" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Retorna" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Tipus de retorn" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "membre" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "variable" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funció" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "macro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "tipus" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Novetat de la versió %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Canviat a la versió %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Obsolet desde la versió %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "class" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (funció interna)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (mètode %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (class)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (atribut %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (mòdul)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atribut" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "mòdul" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "paraula clau" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operador" #: sphinx/domains/python.py:61 msgid "object" msgstr "objecte" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "excepció" #: sphinx/domains/python.py:63 msgid "statement" msgstr "sentència" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "funció interna" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Llença" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (al mòdul %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (al mòdul %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (variable interna)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (classe interna)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (class a %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (mètode estàtic %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "mòduls" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Obsolet" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "mètode estàtic" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (obsolet)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "variable d'entorn; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "variable d'entorn" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Índex de Mòduls" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Pàgina de Cerca" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "vegeu %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "vegeu també %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Pendent" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Atenció" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Compte" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Perill" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Error" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Suggerència" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Important" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Nota" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Vegeu també" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Truc" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Avís" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "ve de la pàgina anterior" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Cerca" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Ves a" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Mostra Codi Font" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Resum" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Índexs i taules:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Taula de Contingut Completa" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "llista totes les seccions i subseccions" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "cerca aquesta documentació" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Índex Global de Mòduls" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "accés ràpid a tots els mòduls" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "totes les funcions, classes, termes" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Índes – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Índex complet en una pàgina" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Pàgines d'índex per lletra" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "pot ser gegant" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navegació" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Cerca dins de %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Quant a aquests documents" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Copyright" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Última actualització el %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Cercar a %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Tema anterior" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "capítol anterior" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Tema següent" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "capítol següent" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Activa JavaScript per utilitzar la funcionalitat\nde cerca." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "cerca" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Resultats de la Cerca" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Cerca ràpida" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Aquesta Pàgina" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Llista de canvis de la versió %(version)s generada automàticament" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Canvis a la llibreria" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Canvis a la API de C" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Altres canvis" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Link permanent a aquest títol" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Link permanent a aquesta definició" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Oculta Resultats de Cerca" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[imatge]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ��������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3234468 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cak/���������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015641� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4695072 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cak/LC_MESSAGES/���������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017426� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cak/LC_MESSAGES/sphinx.js������������������������������������������������0000644�0000766�0000024�00000004730�00000000000�021301� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "None", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": ", pa", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "Konojel cholwuj", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "Cholwuj", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "Ruxaq wuj re'", "Welcome! This is": "\u00dctz apet\u00efk! Wawe' k'o", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "ri wuj richin" }, "plural_expr": "(n != 1)" });����������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cak/LC_MESSAGES/sphinx.mo������������������������������������������������0000644�0000766�0000024�00000004551�00000000000�021301� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������-���������������������������3��������'�����/�����5�����H�����W�����g�����m�����u�����~�� �������������������� ���������� ������������������������� ���������� �����,���(�����U�� ���f�����r�����z������������ ����������������������������������� ����������������������������������3����� �����������������������2�����E�� ���L�� ���W�����b�����r������� �������������������� ��������������� ����������� ���������� ���-��-���:�����h������� �������������������� ���������� ����� ����� ���������� ��� ����� �� ��� �� ���, �����9 �����J ��� (in �(The <<original entry>> is located in %s, line %d.)�(in %s)�, in �<<original entry>>�Author name(s)�Encoding error:�Error�Example�Examples�Fig. %s�General Index�Index�Numbers�Other Parameters�Parameters�Project language�Project name�Project version�Recursion error:�See also�Table %s�This Page�Todo�Variables�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�[image: %s]�[image]�class�document�done�failed: %s�index�next�object�previous�reading error: %s, %s�see %s�see also %s�the documentation for�variable�writing�writing error: %s, %s�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: cak Language-Team: Kaqchikel (http://www.transifex.com/sphinx-doc/sphinx-1/language/cak/) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �(chupam�(Ri <<original entry>> k'o chupam %s, pa juch' %d.)�(chupam %s)�, pa�<<original entry>>�Kib'i' ajtz'ib'anel(a')�Rusachoj nuk'unem:�Sachoj�Tz'etb'äl�Tz'etb'äl�Ruwachib'äl %s�Konojel cholwuj�Cholwuj�Ajilanïk�Jalajöj chïk�Jalajöj�Ruch'ab'äl samaj�Rub'i' samäj�Rujalwäch samäj�Rusachoj kamulunem:�Tatz'u chuqa'�Kik'ajtz'ïk %s�Ruxaq wuj re'�Chi tiqib'ana'�Retal jalöj�Ütz apetïk pa rokisanem runuk'ik Sphinx %s.�Ütz apetïk! Wawe' k'o�[wachib'äl: %s]�[wachib'äl]�Ruwäch�wuj�xk'isïk�sachoj: %s�cholwuj�jun chïk�wachinäq�chi rij kan�rusachoj rusik'inïk: %s, %s�tatz'u %s�tatz'u chuqa' %s�ri wuj richin�retal jalöj�tajin nutz'ib'aj�rusachoj rutz'ib'axïk: %s, %s��������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cak/LC_MESSAGES/sphinx.po������������������������������������������������0000644�0000766�0000024�00000242722�00000000000�021310� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Julien Malard <julien.malard@mail.mcgill.ca>, 2019 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Kaqchikel (http://www.transifex.com/sphinx-doc/sphinx-1/language/cak/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: cak\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "xk'isïk" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "sachoj: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Ruwachib'äl %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Kik'ajtz'ïk %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "tajin nutz'ib'aj" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "(chupam" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Konojel cholwuj" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "cholwuj" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "jun chïk" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "chi rij kan" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Cholwuj" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "Rusachoj nuk'unem:" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "Rusachoj kamulunem:" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "Ütz apetïk pa rokisanem runuk'ik Sphinx %s." #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "Rub'i' samäj" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "Kib'i' ajtz'ib'anel(a')" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "Rujalwäch samäj" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "Ruch'ab'äl samaj" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Jalajöj" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "retal jalöj" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "Ruwäch" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "wachinäq" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Retal jalöj" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "wuj" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "tatz'u %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "tatz'u chuqa' %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(chupam %s)" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Chi tiqib'ana'" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<original entry>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(Ri <<original entry>> k'o chupam %s, pa juch' %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "Tz'etb'äl" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Tz'etb'äl" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "Jalajöj chïk" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Sachoj" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Tatz'u chuqa'" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "Ajilanïk" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Ütz apetïk! Wawe' k'o" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "ri wuj richin" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Ruxaq wuj re'" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", pa" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "rusachoj rusik'inïk: %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "rusachoj rutz'ib'axïk: %s, %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[wachib'äl: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[wachib'äl]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ����������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.323633 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cs/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015510� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4702494 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cs/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017275� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cs/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000010305�00000000000�021143� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "cs", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": ", v ", "About these documents": "O t\u011bchto dokumentech", "Automatically generated list of changes in version %(version)s": "Automaticky generovan\u00fd seznam zm\u011bn ve verzi %(version)s", "C API changes": "Zm\u011bny API", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "Sbalit bo\u010dn\u00ed li\u0161tu", "Complete Table of Contents": "Celkov\u00fd obsah", "Contents": "Obsah", "Copyright": "Ve\u0161ker\u00e1 pr\u00e1va vyhrazena", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Rozbalit bo\u010dn\u00ed li\u0161tu", "Full index on one page": "Cel\u00fd rejst\u0159\u00edk na jedn\u00e9 str\u00e1nce", "General Index": "Obecn\u00fd rejst\u0159\u00edk", "Global Module Index": "Celkov\u00fd rejst\u0159\u00edk modul\u016f", "Go": "OK", "Hide Search Matches": "Skr\u00fdt v\u00fdsledky vyhled\u00e1v\u00e1n\u00ed", "Index": "Rejst\u0159\u00edk", "Index – %(key)s": "Rejst\u0159\u00edk – %(key)s", "Index pages by letter": "Rejst\u0159\u00edk podle p\u00edsmene", "Indices and tables:": "Rejst\u0159\u00edky a tabulky:", "Last updated on %(last_updated)s.": "Aktualizov\u00e1no dne %(last_updated)s.", "Library changes": "Zm\u011bny v knihovn\u00e1ch", "Navigation": "Navigace", "Next topic": "Dal\u0161\u00ed t\u00e9ma", "Other changes": "Ostatn\u00ed zm\u011bny", "Overview": "P\u0159ehled", "Permalink to this definition": "Trval\u00fd odkaz na tuto definici", "Permalink to this headline": "Trval\u00fd odkaz na tento nadpis", "Please activate JavaScript to enable the search\n functionality.": "Pro podporu vyhled\u00e1v\u00e1n\u00ed aktivujte JavaScript.", "Preparing search...": "Vyhled\u00e1v\u00e1n\u00ed se p\u0159ipravuje...", "Previous topic": "P\u0159echoz\u00ed t\u00e9ma", "Quick search": "Rychl\u00e9 vyhled\u00e1v\u00e1n\u00ed", "Search": "Vyhled\u00e1v\u00e1n\u00ed", "Search Page": "Vyhled\u00e1vac\u00ed str\u00e1nka", "Search Results": "V\u00fdsledky vyhled\u00e1v\u00e1n\u00ed", "Search finished, found %s page(s) matching the search query.": "Vyhled\u00e1v\u00e1n\u00ed dokon\u010deno, str\u00e1nky odpov\u00eddaj\u00edc\u00ed hledan\u00e9mu v\u00fdrazu: %s.", "Search within %(docstitle)s": "Prohledat %(docstitle)s", "Searching": "Prob\u00edh\u00e1 vyhled\u00e1n\u00ed", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Uk\u00e1zat zdroj", "Table of Contents": "", "This Page": "Tato str\u00e1nka", "Welcome! This is": "V\u00edtejte! Toto je", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Vyhled\u00e1v\u00e1n\u00ed nenalezlo \u017e\u00e1dn\u00fd odpov\u00eddaj\u00edc\u00ed dokument. Ujist\u011bte se, \u017ee jste v\u0161echna slova zapsal/a spr\u00e1vn\u011b a \u017ee jste vybral/a dostatek kategori\u00ed.", "all functions, classes, terms": "v\u0161echny funkce, t\u0159\u00eddy, term\u00edny", "can be huge": "m\u016f\u017ee b\u00fdt obrovsk\u00fd", "last updated": "naposledy aktualizov\u00e1no", "lists all sections and subsections": "seznam v\u0161ech sekc\u00ed a podsekc\u00ed", "next chapter": "dal\u0161\u00ed kapitola", "previous chapter": "p\u0159edchoz\u00ed kapitola", "quick access to all modules": "rychl\u00fd p\u0159\u00edstup ke v\u0161em modul\u016fm", "search": "hledat", "search this documentation": "prohledat tuto dokumentaci", "the documentation for": "dokumentace pro" }, "plural_expr": "(n == 1 && n % 1 == 0) ? 0 : (n >= 2 && n <= 4 && n % 1 == 0) ? 1: (n % 1 != 0 ) ? 2 : 3" });���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cs/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000020434�00000000000�021146� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ �� ��� ����� �� ��� ����� ����� �����% �����7 �����K �����b �����s �� ��� ����� �� ��� �� ��� ����� ����� ����� ����� �� ���$ �����1 �� ���E �����Q ��0���W ����� ����� �� ��� �� ��� ����� ��>��� ����� �� ��� �����- �����5 �� ���K �����Y �����j ����� �� ��� ����� �� ��� ����� ����� ����� ����� �� ��� ����� �� ��� ����� �����& �����) �����= �� ���B �����L �����R �����h �����~ ��!��� ����� �� ��� �� ��� ����� �� ��� �� ��� �� ���������� ���"�����-�� ���2�����@�����I�� ���_�����j����������������������B��������,�����@��$���O�����t�� ��������������� �������������������� ����������<��������,�� ���H�����R�����c�� ���l�����x������� �������������������� �����������������������Q�� ���X�����d�� ���l�����x������������ ���������� ���������� ��������������� �������������#�� ���<�����F�� ���O�� ���]�����k�����q�� ���y��"����������������������������������� ��������������������������������������&�����B�����R�����W�����^�����x�� ����� ����� ������������������������ ���������������������������������#�����<�����X�����j��)���y������� ����� ����������������������������*�����9�� ���L�����W��,���\������������ ����� ����������9���������� ���'�� ���2�����?�� ���U�����b�����x������������ ����� ������������������������������#��������5�����H�����d�����g������� ����� ��������������������$���������� ���)�����3�����F�� ���U�����a�����q�����z�� ����� �������������������� �����������������������3�����O��0���i�� ����������$������������� �����#�����+�����4�����L�����S�����b�����z�������K��������������� ���$�� ���2�� ���<�����J�� ���R�� ���]�����k�����s�����w�� ���|�� ��������������� ���B�� ���P�����[�����b�� ���q�����|��"������������������������������#���������� ��������$�����;�����V�����_�����f�����z�� ��������������� ���������������������������������� ����� ����� �� ��� �����* �� ���< �����H �����] ��#���l ����� ����� ����� ����� ����� �� ��� ����� ����� ����� ����� !�� ���!��� (deprecated)� (in �%b %d, %Y�%s %s�%s %s documentation�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�(in %s v%s)�, in �<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Caution�Changed in version %s�Code author: �Collapse sidebar�Complete Table of Contents�Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Expand sidebar�Fig. %s�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Listing %s�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this headline�Permalink to this image�Permalink to this table�Please activate JavaScript to enable the search functionality.�Preparing search...�Previous topic�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Release�Return type�Returns�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section author: �See also�Show Source�Symbols�Table %s�This Page�Throws�Tip�Todo�Variables�Warning�Welcome! This is�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�all functions, classes, terms�attribute�built-in function�can be huge�class�class method�continued from previous page�data�directive�environment variable�environment variable; %s�exception�function�glossary term�grammar token�index�keyword�last updated�lists all sections and subsections�macro�member�method�module�modules�next�next chapter�object�operator�original entry�previous�previous chapter�program option�quick access to all modules�reference label�role�search�search this documentation�see %s�see also %s�statement�static method�the documentation for�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: cs Language-Team: Czech (http://www.transifex.com/sphinx-doc/sphinx-1/language/cs/) Plural-Forms: nplurals=4; plural=(n == 1 && n % 1 == 0) ? 0 : (n >= 2 && n <= 4 && n % 1 == 0) ? 1: (n % 1 != 0 ) ? 2 : 3 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (zastaralé)� (v �%d.%m.%Y�%s %s�Dokumentace pro %s %s�%s (atribut %s)�%s (vestavěná třída)�%s (vestavěná proměnná)�%s (třída v %s)�%s (direktiva)�%s (globální proměnná nebo konstanta)�%s (v modulu %s)�%s (modul)�%s (role)�%s() (třídní metoda %s)�%s() (metoda %s)�%s() (statická metoda %s)�%s() (vestavěná funkce)�%s() (třída)�%s() (v modulu %s)�(v %s v%s)�, v �<h1>Všechny moduly s dostupným kódem</h1>�<h1>Zdrojový kód pro %s</h1>�O těchto dokumentech�Argumenty�Výstraha�Autor: �Automaticky generovaný seznam změn ve verzi %(version)s�Vestavěné funkce�Změny API�Upozornění�Změněno ve verzi %s�Autor kódu:�Sbalit boční lištu�Celkový obsah�Obsah�Veškerá práva vyhrazena�Nebezpečí�Zastaralé�Zastaralé od verze %s�Chyba�Rozbalit boční lištu�Obr. %s�Poznámky pod čarou�Celý rejstřík na jedné stránce�Obecný rejstřík�Celkový rejstřík modulů�OK�Skrýt výsledky vyhledávání�Rada�Důležité�Rejstřík�Rejstřík – %(key)s�Rejstřík podle písmene�Rejstříky a tabulky:�Aktualizováno dne %(last_updated)s.�Změny v knihovnách�Výpis %s�Rejstřík modulů�Autor modulu: �Kód modulu�Úroveň modulu�Navigace�Nové ve verzi %s�Další téma�Poznámka�Ostatní změny�Přehled�Přehled: kód modulu�Parametry�Permalink k tomuto kódu�Trvalý odkaz na tuto definici�Trvalý odkaz na tento nadpis�Permalink k tomuto obrázku�Permalink k této tabulce�Pro podporu vyhledávání aktivujte JavaScript.�Vyhledávání se připravuje...�Přechozí téma�Python Enhancement Proposals; PEP %s�Rejstřík modulů Pythonu�Rychlé vyhledávání�Vyvolá�Vydání�Typ návratové hodnoty�Vrací�Vyhledávání�Prohledat %(docstitle)s�Vyhledávací stránka�Výsledky vyhledávání�Vyhledávání dokončeno, stránky odpovídající hledanému výrazu: %s.�Prohledat %(docstitle)s�Probíhá vyhledání�Autor sekce: �Viz také�Ukázat zdroj�Symboly�Tabulka %s�Tato stránka�Vyvolá�Tip�Todo�Proměnné�Varování�Vítejte! Toto je�Vyhledávání nenalezlo žádný odpovídající dokument. Ujistěte se, že jste všechna slova zapsal/a správně a že jste vybral/a dostatek kategorií.�[dokumentace]�[graf: %s]�[graf]�[obrázek: %s]�[obrázek]�[zdroj]�všechny funkce, třídy, termíny�atribut�vestavěná funkce�může být obrovský�třída�třídní metoda�pokračujte na předchozí stránce�data�direktiva�proměnná prostředí�proměnná prostředí; %s�výjimka�funkce�termín v glosáři�token gramatiky�rejstřík�klíčové slovo�naposledy aktualizováno�seznam všech sekcí a podsekcí�makro�člen�metoda�modul�moduly�další�další kapitola�objekt�operátor�původní záznam�předchozí�předchozí kapitola�volba programu�rychlý přístup ke všem modulům�referenční návěstí�role�hledat�prohledat tuto dokumentaci�viz %s�viz také %s�příkaz�statická metoda�dokumentace pro�typ�proměnná�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cs/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000247142�00000000000�021160� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # FIRST AUTHOR <EMAIL@ADDRESS>, 2008 # Vilibald W. <vilibald.wanca@gmail.com>, 2014-2015 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Czech (http://www.transifex.com/sphinx-doc/sphinx-1/language/cs/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: cs\n" "Plural-Forms: nplurals=4; plural=(n == 1 && n % 1 == 0) ? 0 : (n >= 2 && n <= 4 && n % 1 == 0) ? 1: (n % 1 != 0 ) ? 2 : 3;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Obr. %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tabulka %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Výpis %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Vestavěné funkce" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Úroveň modulu" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (v " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d.%m.%Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Obecný rejstřík" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "rejstřík" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "další" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "předchozí" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "Dokumentace pro %s %s" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Rejstřík" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Vydání" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Autor sekce: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Autor modulu: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Autor kódu:" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autor: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametry" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Vrací" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Typ návratové hodnoty" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "člen" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "proměnná" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funkce" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "makro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "typ" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Nové ve verzi %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Změněno ve verzi %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Zastaralé od verze %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Vyvolá" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "třída" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (vestavěná funkce)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (metoda %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (třída)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (globální proměnná nebo konstanta)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (atribut %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumenty" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modul)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "metoda" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "data" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atribut" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modul" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "klíčové slovo" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operátor" #: sphinx/domains/python.py:61 msgid "object" msgstr "objekt" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "výjimka" #: sphinx/domains/python.py:63 msgid "statement" msgstr "příkaz" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "vestavěná funkce" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Proměnné" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Vyvolá" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (v modulu %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (v modulu %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (vestavěná proměnná)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (vestavěná třída)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (třída v %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (třídní metoda %s)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (statická metoda %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Rejstřík modulů Pythonu" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "moduly" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Zastaralé" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "třídní metoda" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "statická metoda" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (zastaralé)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (direktiva)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (role)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "direktiva" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "role" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "proměnná prostředí; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "termín v glosáři" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "token gramatiky" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "referenční návěstí" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "proměnná prostředí" #: sphinx/domains/std.py:568 msgid "program option" msgstr "volba programu" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Rejstřík modulů" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Vyhledávací stránka" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "viz %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "viz také %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Symboly" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[graf: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[graf]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(v %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[zdroj]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Todo" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "původní záznam" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[dokumentace]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Kód modulu" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Zdrojový kód pro %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Přehled: kód modulu" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Všechny moduly s dostupným kódem</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Výstraha" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Upozornění" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Nebezpečí" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Chyba" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Rada" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Důležité" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Poznámka" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Viz také" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Tip" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Varování" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "pokračujte na předchozí stránce" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Vyhledávání" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "OK" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Ukázat zdroj" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Přehled" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Vítejte! Toto je" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "dokumentace pro" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "naposledy aktualizováno" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Rejstříky a tabulky:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Celkový obsah" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "seznam všech sekcí a podsekcí" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "prohledat tuto dokumentaci" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Celkový rejstřík modulů" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "rychlý přístup ke všem modulům" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "všechny funkce, třídy, termíny" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Rejstřík – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Celý rejstřík na jedné stránce" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Rejstřík podle písmene" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "může být obrovský" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigace" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Prohledat %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "O těchto dokumentech" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Veškerá práva vyhrazena" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Aktualizováno dne %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Prohledat %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Přechozí téma" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "předchozí kapitola" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Další téma" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "další kapitola" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Pro podporu vyhledávání aktivujte JavaScript." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "hledat" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Výsledky vyhledávání" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Vyhledávání nenalezlo žádný odpovídající dokument. Ujistěte se, že jste všechna slova zapsal/a správně a že jste vybral/a dostatek kategorií." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Rychlé vyhledávání" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Tato stránka" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automaticky generovaný seznam změn ve verzi %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Změny v knihovnách" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Změny API" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Ostatní změny" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Trvalý odkaz na tento nadpis" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Trvalý odkaz na tuto definici" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Skrýt výsledky vyhledávání" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Probíhá vyhledání" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Vyhledávání se připravuje..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Vyhledávání dokončeno, stránky odpovídající hledanému výrazu: %s." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", v " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Rozbalit boční lištu" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Sbalit boční lištu" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Obsah" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Permalink k této tabulce" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Permalink k tomuto kódu" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Permalink k tomuto obrázku" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Poznámky pod čarou" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[obrázek: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[obrázek]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.323812 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cy/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015516� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4710023 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cy/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017303� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cy/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000007143�00000000000�021157� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "cy", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": ", yn ", "About these documents": "Yngl\u0177n \u00e2'r dogfennau hyn", "Automatically generated list of changes in version %(version)s": "Rhestr o newidiadau yn fersiwn %(version)s wedi'i cynhyrchu'n awtomatig", "C API changes": "Newidiadau i'r C-API", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "Cyfangu'r bar ochr", "Complete Table of Contents": "Tabl Cynnwys Llawn", "Contents": "Cynnwys", "Copyright": "Hawlfraint", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Ehangu'r bar ochr", "Full index on one page": "Indecs llawn ar un tudalen", "General Index": "Indecs cyffredinol", "Global Module Index": "Indecs Modiwl Byd-Eang", "Go": "Ewch", "Hide Search Matches": "Cuddio Canlyniadau Chwilio", "Index": "Indecs", "Index – %(key)s": "Indecs – %(key)s", "Index pages by letter": "Indecs tudalennau gan lythyren", "Indices and tables:": "Indecsau a tablau:", "Last updated on %(last_updated)s.": "Diweddarwyd yn ddiwethaf ar %(last_updated)s.", "Library changes": "Newidiadau i'r llyfrgell", "Navigation": "Llywio", "Next topic": "Pwnc nesaf", "Other changes": "Newidiadau arall", "Overview": "Trosolwg", "Permalink to this definition": "Permalink i'r diffiniad hwn", "Permalink to this headline": "Permalink i'r pennawd hwn", "Please activate JavaScript to enable the search\n functionality.": "Trwoch JavaScript ymlaen i alluogi'r chwilio.", "Preparing search...": "Paratoi chwilio...", "Previous topic": "Pwnc blaenorol", "Quick search": "Chwilio cyflym", "Search": "Chwilio", "Search Page": "Tudalen Chwilio", "Search Results": "Canlyniadau chwilio", "Search finished, found %s page(s) matching the search query.": "Chwiliad wedi gorffen, wedi ffeindio %s tudalen(nau) yn cyfateb a'r ymholiad chwilio.", "Search within %(docstitle)s": "Chwilio o fewn %(docstitle)s", "Searching": "Yn chwilio", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Dangos Ffynhonell", "Table of Contents": "", "This Page": "Y Dudalen Hon", "Welcome! This is": "Croeso! Dyma", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Nid yw eich chwiliad yn cyfateb unrhyw ddogfennau. Gwnewch yn si\u0175r fod pob gair wedi'i sillafu'n gywir, ac eich bod wedi dewis digon o gategor\u00efau.", "all functions, classes, terms": "holl ffwythiannau, dosbarthau a thermau", "can be huge": "gall fod yn enfawr", "last updated": "diweddarwyd yn ddiwethaf", "lists all sections and subsections": "rhestru holl adrannau ac isadrannau", "next chapter": "pennod nesaf", "previous chapter": "pennod blaenorol", "quick access to all modules": "mynediad cloi i bob modiwl", "search": "chwilio", "search this documentation": "chwiliwch y ddogfennaeth", "the documentation for": "y dogfennaeth am" }, "plural_expr": "(n==1) ? 0 : (n==2) ? 1 : (n != 8 && n != 11) ? 2 : 3" });�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cy/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000014434�00000000000�021157� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������q��������������������,�����-�����3�� ���G�� ���h�����t��0���z������������ ����������>����� ���/�����=�����E�� ���[�����i�����z������� ������������������������������ ���������� ��� ����� �����+ �����. �����B �� ���G �����Q �����W �����m ����� ��!��� ����� �� ��� �� ��� ����� �� ��� �� ��� �� ��� ����� �� ���' �����2 �� ���7 �����E �����N �� ���d �����o ����� ����� ����� ����� ����� ��B��� �����K �����_ ��$���n �� ��� ����� ����� ����� �� ��� ����� ��<��� ����� �� ���8 �����B �����S �� ���\ �����h �����p �� ���y ����� ����� ����� ����� ����� �����0 �� ���7 �����C �� ���K �����W �����_ �����h ����� �� ��� ����� ����� ����� ����� �� ��� ��"��� ����������������� ��������(�����/�����8�����G�����P�����a�����}������������ ����� ������������������������!����� �������� ��,�����$���<�����a�����|�������G�������������������� �������������$�����7�� ���?�����J�����Q�����k�����q������� ������������������������������������������� ����������+�����J��-���]������� ��������������� ����� ��������������� ������������������'�����0�� ���G�����R�����h����������������������-�������������+��$���:�����_�����n�����w�����������������U���������� ���,�����7�� ���G�����T�����f�����o�� ���w����������������� �������������;�� ���B�����N�� ���V�� ���d�� ���n��'���|������������#����� ���������� �������� ��#���%�����I�����O�����V�� ���\�� ���i�� ���s������� ������������������������� ���������� �������� ��� (in �%s %s documentation�%s (global variable or constant)�(in %s v%s)�, in �<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Attention�Author: �Automatically generated list of changes in version %(version)s�C API changes�Caution�Changed in version %s�Code author: �Collapse sidebar�Complete Table of Contents�Contents�Copyright�Danger�Deprecated since version %s�Error�Expand sidebar�Fig. %s�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Listing %s�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Please activate JavaScript to enable the search functionality.�Preparing search...�Previous topic�Python Enhancement Proposals; PEP %s�Quick search�Release�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section author: �See also�Show Source�Symbols�Table %s�This Page�Tip�Todo�Warning�Welcome! This is�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�all functions, classes, terms�built-in function�can be huge�continued from previous page�function�index�keyword�last updated�lists all sections and subsections�member�module�next�next chapter�object�operator�original entry�previous�previous chapter�quick access to all modules�search�search this documentation�see %s�see also %s�statement�the documentation for�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: cy Language-Team: Welsh (http://www.transifex.com/sphinx-doc/sphinx-1/language/cy/) Plural-Forms: nplurals=4; plural=(n==1) ? 0 : (n==2) ? 1 : (n != 8 && n != 11) ? 2 : 3 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (yn �Dogfennaeth %s %s �%s (newidyn byd-eang neu cysonyn)�(yn %s v%s)�, yn �<h1>Holl fodiwlau lle mae'r cod ar gael</h1>�<h1>Cod ffynhonnell ar gyfer %s</h1>�Ynglŷn â'r dogfennau hyn�Sylw�Awdur:�Rhestr o newidiadau yn fersiwn %(version)s wedi'i cynhyrchu'n awtomatig�Newidiadau i'r C-API�Gofal�Wedi newid yn fersiwn %s�Awdur y cod:�Cyfangu'r bar ochr�Tabl Cynnwys Llawn�Cynnwys�Hawlfraint�Perygl�Dibrisiwyd ers fersiwn %s�Gwall�Ehangu'r bar ochr�Ffig. %s�Troednodiadau�Indecs llawn ar un tudalen�Indecs cyffredinol�Indecs Modiwl Byd-Eang�Ewch�Cuddio Canlyniadau Chwilio�Awgrym�Pwysig�Indecs�Indecs – %(key)s�Indecs tudalennau gan lythyren�Indecsau a tablau:�Diweddarwyd yn ddiwethaf ar %(last_updated)s.�Newidiadau i'r llyfrgell�Listing %s�Indecs Modiwlau�Awdur y fodiwl:�Cod y modiwl�Lefel modiwl�Llywio�Newydd yn fersiwn %s�Pwnc nesaf�Nodyn�Newidiadau arall�Trosolwg�Trosolwg: cod y modiwl�Paramedrau�Permalink i'r cod hwn�Permalink i'r diffiniad hwn�Permalink i'r pennawd hwn�Permalink i'r ddelwedd hon�Permalink i'r tabl hwn�Permalink i'r toctree hwn�Trwoch JavaScript ymlaen i alluogi'r chwilio.�Paratoi chwilio...�Pwnc blaenorol�Python Enhancement Proposals; PEP %s�Chwilio cyflym�Rhyddhad�Chwilio�Chwilio %(docstitle)s�Tudalen Chwilio�Canlyniadau chwilio�Chwiliad wedi gorffen, wedi ffeindio %s tudalen(nau) yn cyfateb a'r ymholiad chwilio.�Chwilio o fewn %(docstitle)s�Yn chwilio�Awdur yr adran:�Gweler hefyd�Dangos Ffynhonell�Symbolau�Tabl %s�Y Dudalen Hon�Awgrym�Todo�Rhybudd�Croeso! Dyma�Nid yw eich chwiliad yn cyfateb unrhyw ddogfennau. Gwnewch yn siŵr fod pob gair wedi'i sillafu'n gywir, ac eich bod wedi dewis digon o gategorïau.�[docs]�[graff: %s]�[graff]�[delwedd: %s]�[delwedd]�[ffynhonnell]�holl ffwythiannau, dosbarthau a thermau�ffwythiant built-in�gall fod yn enfawr�wedi'i barhau o'r tudalen blaenorol�ffwythiant�indecs�allweddair�diweddarwyd yn ddiwethaf�rhestru holl adrannau ac isadrannau�aelod�modiwl�nesaf�pennod nesaf�gwrthrych�gweithredydd�eitem wreiddiol�blaenorol�pennod blaenorol�mynediad cloi i bob modiwl�chwilio�chwiliwch y ddogfennaeth�gweler %s�gweler hefyd %s�datganiad�y dogfennaeth am�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/cy/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000245607�00000000000�021172� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # FIRST AUTHOR <EMAIL@ADDRESS>, 2016 # Geraint Palmer <palmer.geraint@googlemail.com>, 2016 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Welsh (http://www.transifex.com/sphinx-doc/sphinx-1/language/cy/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: cy\n" "Plural-Forms: nplurals=4; plural=(n==1) ? 0 : (n==2) ? 1 : (n != 8 && n != 11) ? 2 : 3;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Ffig. %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tabl %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Listing %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Lefel modiwl" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (yn " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Indecs cyffredinol" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "indecs" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "nesaf" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "blaenorol" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "Dogfennaeth %s %s " #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Indecs" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Rhyddhad" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Awdur yr adran:" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Awdur y fodiwl:" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Awdur y cod:" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Awdur:" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Paramedrau" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "aelod" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "ffwythiant" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Newydd yn fersiwn %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Wedi newid yn fersiwn %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Dibrisiwyd ers fersiwn %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (newidyn byd-eang neu cysonyn)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modiwl" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "allweddair" #: sphinx/domains/python.py:60 msgid "operator" msgstr "gweithredydd" #: sphinx/domains/python.py:61 msgid "object" msgstr "gwrthrych" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "datganiad" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "ffwythiant built-in" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Indecs Modiwlau" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Tudalen Chwilio" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "gweler %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "gweler hefyd %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Symbolau" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[graff: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[graff]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(yn %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[ffynhonnell]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Todo" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "eitem wreiddiol" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[docs]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Cod y modiwl" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Cod ffynhonnell ar gyfer %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Trosolwg: cod y modiwl" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Holl fodiwlau lle mae'r cod ar gael</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Sylw" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Gofal" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Perygl" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Gwall" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Awgrym" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Pwysig" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Nodyn" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Gweler hefyd" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Awgrym" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Rhybudd" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "wedi'i barhau o'r tudalen blaenorol" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Chwilio" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Ewch" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Dangos Ffynhonell" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Trosolwg" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Croeso! Dyma" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "y dogfennaeth am" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "diweddarwyd yn ddiwethaf" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Indecsau a tablau:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Tabl Cynnwys Llawn" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "rhestru holl adrannau ac isadrannau" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "chwiliwch y ddogfennaeth" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Indecs Modiwl Byd-Eang" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "mynediad cloi i bob modiwl" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "holl ffwythiannau, dosbarthau a thermau" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Indecs – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Indecs llawn ar un tudalen" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Indecs tudalennau gan lythyren" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "gall fod yn enfawr" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Llywio" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Chwilio o fewn %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Ynglŷn â'r dogfennau hyn" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Hawlfraint" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Diweddarwyd yn ddiwethaf ar %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Chwilio %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Pwnc blaenorol" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "pennod blaenorol" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Pwnc nesaf" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "pennod nesaf" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Trwoch JavaScript ymlaen i alluogi'r chwilio." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "chwilio" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Canlyniadau chwilio" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Nid yw eich chwiliad yn cyfateb unrhyw ddogfennau. Gwnewch yn siŵr fod pob gair wedi'i sillafu'n gywir, ac eich bod wedi dewis digon o gategorïau." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Chwilio cyflym" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Y Dudalen Hon" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Rhestr o newidiadau yn fersiwn %(version)s wedi'i cynhyrchu'n awtomatig" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Newidiadau i'r llyfrgell" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Newidiadau i'r C-API" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Newidiadau arall" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Permalink i'r pennawd hwn" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Permalink i'r diffiniad hwn" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Cuddio Canlyniadau Chwilio" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Yn chwilio" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Paratoi chwilio..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Chwiliad wedi gorffen, wedi ffeindio %s tudalen(nau) yn cyfateb a'r ymholiad chwilio." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", yn " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Ehangu'r bar ochr" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Cyfangu'r bar ochr" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Cynnwys" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Permalink i'r tabl hwn" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Permalink i'r cod hwn" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Permalink i'r ddelwedd hon" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Permalink i'r toctree hwn" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Troednodiadau" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[delwedd: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[delwedd]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3239918 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/da/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015467� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.471781 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/da/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017254� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/da/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000007545�00000000000�021136� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "da", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Ophavsret</a> %(copyright)s.", "© Copyright %(copyright)s.": "© Ophavsret %(copyright)s.", ", in ": ", i", "About these documents": "Om disse dokumenter", "Automatically generated list of changes in version %(version)s": "Automatisk oprettet liste af \u00e6ndringer i version %(version)s", "C API changes": "\u00c6ndringer i C-API", "Changes in Version %(version)s — %(docstitle)s": "\u00c6ndringer i version %(version)s — %(docstitle)s", "Collapse sidebar": "Sammenfold sidebj\u00e6lke", "Complete Table of Contents": "Fuldst\u00e6ndig indholdsfortegnelse", "Contents": "Indhold", "Copyright": "Ophavsret", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Udfold sidebj\u00e6lke", "Full index on one page": "Fuldt indeks p\u00e5 \u00e9n side", "General Index": "Generelt indeks", "Global Module Index": "Globalt modulindeks", "Go": "S\u00f8g", "Hide Search Matches": "Skjul s\u00f8geresultater", "Index": "Indeks", "Index – %(key)s": "Indeks – %(key)s", "Index pages by letter": "Indeks\u00e9r sider efter bogstav", "Indices and tables:": "Indeks og tabeller:", "Last updated on %(last_updated)s.": "Sidst opdateret %(last_updated)s.", "Library changes": "Biblioteks\u00e6ndringer", "Navigation": "Navigation", "Next topic": "N\u00e6ste emne", "Other changes": "Andre \u00e6ndringer", "Overview": "Oversigt", "Permalink to this definition": "Permalink til denne definition", "Permalink to this headline": "Permalink til denne overskrift", "Please activate JavaScript to enable the search\n functionality.": "Aktiv\u00e9r venligst JavaScript for at aktivere\n s\u00f8gefunktionalitet.", "Preparing search...": "Forbereder s\u00f8gning...", "Previous topic": "Forrige emne", "Quick search": "Hurtig s\u00f8gning", "Search": "S\u00f8g", "Search Page": "S\u00f8geside", "Search Results": "S\u00f8geresultater", "Search finished, found %s page(s) matching the search query.": "S\u00f8gning f\u00e6rdig, fandt %s sider der matcher s\u00f8geforesp\u00f8rgslen.", "Search within %(docstitle)s": "S\u00f8g i %(docstitle)s", "Searching": "S\u00f8ger", "Searching for multiple words only shows matches that contain\n all words.": "Bem\u00e6rk: Hvis du s\u00f8ger efter flere ord, vises kun resultater der indeholder alle ordene.", "Show Source": "Vis kilde", "Table of Contents": "", "This Page": "Denne side", "Welcome! This is": "Velkommen! Dette er", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Din s\u00f8gning matchede ikke nogen dokumenter. Sikr dig at alle ord er stavet korrekt og at du har valgt nok kategorier.", "all functions, classes, terms": "alle funktioner, klasser, begreber", "can be huge": "kan v\u00e6re enormt", "last updated": "sidst opdateret", "lists all sections and subsections": "viser alle afsnit og underafsnit", "next chapter": "n\u00e6ste kapitel", "previous chapter": "forrige kapitel", "quick access to all modules": "hurtig adgang til alle moduler", "search": "s\u00f8g", "search this documentation": "s\u00f8g i denne dokumentation", "the documentation for": "dokumentationen for" }, "plural_expr": "(n != 1)" });�����������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/da/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000032071�00000000000�021125� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� ��������+��"���1�� ���T�����^�����d�����x���������������������� ���������� ����� �������������5�����L�����]�����u�� ����������6����������3����� ���:�����F�����L��0���_������������ ����� ����������>���������� ���'��!���5�����W�����_��4���u�� ������������������������� ��� ����������5�� ���<�����G�����c�����s�����y������������!����� ���������� ������������������������� ��������$�����*�����@�����V�����j��!���|������� ����� ���������� ����� ����� ���������� ��� ����������0�����5�� ���F�����T�����]�� ���s�����~���������������������������������B���2��2���u����������������������$��������(�� ���<�����I�� ���P�����[�� ���c�����o�����w������������ ����������<���������� �����K���$�����p������� �����>��������������������.�����p���)�������!�����'����� �����W��������f�����m�����q�����v�� �����������������������;�� ���B�����N�� ���V�����b�����j�����s�� ���������� ���������� ������������������ �� ����������;���$��4���`����������������� ������������������������������ ��������*�����?�� ���X�����b�� ���u����������������� ����� ������������������������� ���$��"���1�����T�����r�����x����������������� ���������� �����#��������������������������������������'�����0��%���A�����g�����v������������������������������������� ����������*���"�� ���M�� ���W�� ���e��%���o�������������������������� ���!�����!��"���!�� ���!�����!�����!�����!�����"�����"�����6"�� ���G"��#���U"�����y"�� ���"�� ���"�����"�����"�����"�����"�����"�� ���#�����$#��6���8#�����o#��8���#�� ���#�����#�����#��3���#�����!$�����;$�� ���O$�����Y$�� ���i$��=���u$�� ���$�����$�����$�� ���$�����$��6���%�����G%�����W%�� ���n%��/���%�����%�� ���%��!���%�����%�� ���%�����&�� ���&�����+&�� ���0&�����:&�����M&��#���V&�����z&�����&�����&�����&�����&�����&�����&�����&�����&�����&�����'�����$'�����8'��!���M'�����o'�� ���'�� ���'�����'�� ���'�� ���'�� ���'�����'�� ���'��%���'�����(�����(�����)(�����:(�����C(�� ���W(�����a(�����(�����(�����(��!���(�����(��!���)��E���>)��=���)��)���)�����)����� *�� ���!*��$���.*�����S*�����f*�����v*�� ���}*�����*�� ���*�� ���*�����*�����*�����*�� ���*�����*��A���*�����,+�����A+��Y���H+�����+�����+�� ���+��8���+�����,����� ,�����,��0���&,��m���W,�����,�����,��"���,�� ���"-��T���--�����-�����-�����-�����-�����-�����-�����-��v���-�����I.�� ���O.�����Z.�� ���a.�� ���o.�����y.��"���.�����.�����.�����.�����.�����.�����.�����/�����6/�� ���=/�����J/��I���R/��7���/�����/�����/����� 0�����0�����0�����+0��#���40�����X0�����`0�� ���g0�����r0�����0�� ���0�����0�� ���0�����0�����0�����0�����0����� 1�����1�����&1�����F1�� ���f1�����p1�� ���1��!���1�����1�����1�����1�����1�����1�����1�����1�����1��)��� 2�����62�����=2�����F2�����X2�����u2�����z2�����2�����2��.���2�����2�����2�����3�����3�����-3�����=3�����C3�����H3�����c3�� ���i3�����u3��,���3�� ���3�����3�����3�����3�����3�����4�����4�����4��� (deprecated)� (in �%(filename)s — %(docstitle)s�%b %d, %Y�%s %s�%s %s documentation�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�, in �<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Cannot find source directory (%s)�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not import extension %s�Danger�Deprecated�Deprecated since version %s�Encoding error:�Error�Examples�Expand sidebar�Fig. %s�File %s already exists, skipping.�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Keyword Arguments�Last updated on %(last_updated)s.�Library changes�Listing %s�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�No such config value: %s�Note�Other Parameters�Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Please activate JavaScript to enable the search functionality.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter either 'y' or 'n'.�Please enter some text.�Preparing search...�Previous topic�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�References�Release�Return type�Returns�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Searching for multiple words only shows matches that contain all words.�Section author: �See also�Show Source�Source directory and destination directory cannot be identical�Symbols�Table %s�Template Parameters�The %r role is already registered to domain %s�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�This Page�This project needs at least Sphinx v%s and therefore cannot be built with this version.�Throws�Tip�Todo�Unknown event name: %s�Variables�Warning�Welcome! This is�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�all functions, classes, terms�attribute�build %s, %s warning.�build %s.�built-in function�can be huge�cannot copy static file %r�cannot find files %r�class�class method�concept�conf value "epub_contributor" should not be empty for EPUB3�config directory doesn't contain a conf.py file (%s)�continued from previous page�continues on next page�data�directive�do not create makefile�document�domain %s already registered�done�enum�enumerator�environment variable�environment variable; %s�exception�extensions changed�failed: %s�favicon file %r does not exist�finished with problems�function�glossary term�grammar token�index�invalid css_file: %r, ignored�invalid js_file: %r, ignored�keyword�last updated�lists all sections and subsections�loading translations [%s]... �macro�member�method�module�modules�new config�next�next chapter�not available for built-in messages�object�operator�original entry�overwrite existing files�page�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�program option�quick access to all modules�reading sources... �reading templates... �reference label�role�search�search this documentation�see %s�see also %s�source directory has changed�source_parser for %r is already registered�statement�static method�succeeded�template directory for template files�the documentation for�type�variable�writing message catalogs... �Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: da Language-Team: Danish (http://www.transifex.com/sphinx-doc/sphinx-1/language/da/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (forældet)� (i �%(filename)s — %(docstitle)s�%d. %b, %Y�%s %s�%s %s dokumentation�%s (attribut i %s)�%s (indbygget klasse)�%s (indbygget variabel)�%s (klasse i %s)�%s (direktiv)�%s (global variabel eller konstant)�%s (i modulet %s)�%s (modul)�%s (rolle)�%s er ikke en mappe�%s() (klassemetode i %s)�%s() (metode i %s)�%s() (statisk metode i %s)�%s() (indbygget funktion)�%s() (klasse)�%s() (i modulet %s)�© <a href="%(path)s">Ophavsret</a> %(copyright)s.�© Ophavsret %(copyright)s.�(Det <<oprindelige punkt>> befinder sig i %s, linje %d.)�(i %s v%s)�, i�<<oprindeligt punkt>>�<h1>Alle moduler, der er kode tilgængelig for</h1>�<h1>Kildekode for %s</h1>�Om disse dokumenter�Parametre�Vær opmærksom�Forfatter: �Automatisk oprettet liste af ændringer i version %(version)s�Indbyggede�Ændringer i C-API�Kan ikke finde kildemappen (%s)�Forsigtig�Ændret i version %s�Ændringer i version %(version)s — %(docstitle)s�Kodeforfatter: �Sammenfold sidebjælke�Fuldstændig indholdsfortegnelse�Konfigurationsværdien %r er allerede til stede�Indhold�Ophavsret�Kunne ikke importere udvidelse %s�Fare�Forældet�Forældet siden version %s�Kodningsfejl:�Fejl�Eksempler�Udfold sidebjælke�figur %s�Filen %s findes allerede, udelader.�Fodnoter�Fuldt indeks på én side�Generelt indeks�Globalt modulindeks�Søg�Skjul søgeresultater�Fif�Vigtigt�Indeks�Indeks – %(key)s�Indeksér sider efter bogstav�Indeks og tabeller:�Nøgleordsargumenter�Sidst opdateret %(last_updated)s.�Biblioteksændringer�Kildekode %s�Modulindeks�Modulforfatter: �Modulkode�Modulniveau�Navigation�Ny i version %s�Næste emne�Ingen sådan konfigurationsværdi: %s�Bemærk�Andre parametre�Andre ændringer�Oversigt�Oversigt: modulkode�Parametre�Permahenvisning til denne kode�Permalink til denne definition�Permalink til denne ligning�Permalink til denne overskrift�Permahenvisning til dette billede�Permahenvisning til denne tabel�Permahenvisning til dette toctree�Aktivér venligst JavaScript for at aktivere søgefunktionalitet.�Indtast venligt et filsuffiks, f.eks. ».rst« eller ».txt«�Indtast venligst enten »y« eller »n«.�Indtast venligst noget tekst.�Forbereder søgning...�Forrige emne�Python Enhancement Proposals; PEP %s�Python-modulindeks�Hurtig søgning�Rejser�Referencer�Udgave�Returtype�Returnerer�Kører Sphinx v%s�Søg�Søg i %(docstitle)s�Søgeside�Søgeresultater�Søgning færdig, fandt %s sider der matcher søgeforespørgslen.�Søg i %(docstitle)s�Søger�Bemærk: Hvis du søger efter flere ord, vises kun resultater der indeholder alle ordene.�Afsnitsforfatter: �Se også�Vis kilde�Kildemappe og destinationsmappe kan ikke være identiske�Symboler�tabel %s�Template-parametre�Rollen %r er allerede registreret til domæne %s�Udvidelsen %s brugt af dette projekt kræver mindst Sphinx v%s; den kan derfor ikke bygges med denne version.�HTML-siden er i %(outdir)s.�HTML-siderne er i %(outdir)s.�Beskedkatalogerne er i %(outdir)s.�Denne side�Dette projekt kræver mindst Sphinx v%s og kan derfor ikke bygges med denne version.�Kaster�Tip�Todo�Ukendt hændelsesnavn: %s�Variable�Advarsel�Velkommen! Dette er�Din søgning matchede ikke nogen dokumenter. Sikr dig at alle ord er stavet korrekt og at du har valgt nok kategorier.�[dok]�[graf: %s]�[graf]�[billede: %s]�[billede]�[kilde]�alle funktioner, klasser, begreber�attribut�kompilering %s, %s advarsel.�kompilering %s.�indbygget funktion�kan være enormt�kan ikke kopiere statisk fil %r�kan ikke finde filer %r�klasse�klassemetode�koncept�konfigurationsværdien »epub_contributor« bør ikke være tom for EPUB3�konfigurationsmappe indeholder ikke en conf.py-fil (%s)�fortsat fra forrige side�fortsætter på næste side�data�direktiv�opret ikke makefile�dokument�domænet %s er allerede registreret�færdig�optæl�optælling�miljøvariabel�miljøvariabel; %s�undtagelse�udvidelser ændret�fejlede: %s�favicon-filen %r findes ikke�færdig med problemer�funktion�begreb i ordliste�grammatisk element�indeks�ugyldig css_file: %r, ignoreret�udgyldig js_file: %r, ignoreret�nøgleord�sidst opdateret�viser alle afsnit og underafsnit�indlæser oversættelser [%s] ...�makro�medlem�metode�modul�moduler�ny konfiguration�næste�næste kapitel�ikke tilgængelig for indbyggede beskeder�objekt�operator�oprindeligt punkt�overskriv eksisterende filer�side�forbereder dokumenter�forrige�forrige kapitel�primary_domain %r blev ikke fundet, ignorerer.�programtilvalg�hurtig adgang til alle moduler�læser kilder ...�læser skabeloner ...�referenceetiket�rolle�søg�søg i denne dokumentation�se %s�se også %s�kildemappe er ændret�source_parser for %r er allerede registreret�erklæring�statisk metode�lykkedes�skabelonmappe for skabelonfiler�dokumentationen for�type�variabel�skriver beskedkataloger ...������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/da/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000252616�00000000000�021141� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # askhl <asklarsen@gmail.com>, 2010-2011 # Jakob Lykke Andersen <jakob@caput.dk>, 2014,2016 # Joe Hansen <joedalton2@yahoo.dk>, 2016,2019 # Komiya Takeshi <i.tkomiya@gmail.com>, 2021 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Danish (http://www.transifex.com/sphinx-doc/sphinx-1/language/da/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: da\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Kan ikke finde kildemappen (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Kildemappe og destinationsmappe kan ikke være identiske" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Kører Sphinx v%s" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Dette projekt kræver mindst Sphinx v%s og kan derfor ikke bygges med denne version." #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "indlæser oversættelser [%s] ..." #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "færdig" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "ikke tilgængelig for indbyggede beskeder" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "fejlede: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "lykkedes" #: sphinx/application.py:349 msgid "finished with problems" msgstr "færdig med problemer" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "kompilering %s, %s advarsel." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "kompilering %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "konfigurationsmappe indeholder ikke en conf.py-fil (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "Ingen sådan konfigurationsværdi: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "Konfigurationsværdien %r er allerede til stede" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "figur %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "tabel %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Kildekode %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r blev ikke fundet, ignorerer." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Ukendt hændelsesnavn: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "domænet %s er allerede registreret" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "Rollen %r er allerede registreret til domæne %s" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "source_parser for %r er allerede registreret" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "Kunne ikke importere udvidelse %s" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "Udvidelsen %s brugt af dette projekt kræver mindst Sphinx v%s; den kan derfor ikke bygges med denne version." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "læser kilder ..." #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "forbereder dokumenter" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Indbyggede" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Modulniveau" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "konfigurationsværdien »epub_contributor« bør ikke være tom for EPUB3" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "ugyldig css_file: %r, ignoreret" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "Beskedkatalogerne er i %(outdir)s." #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "læser skabeloner ..." #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "skriver beskedkataloger ..." #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "HTML-siden er i %(outdir)s." #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (i " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "HTML-siderne er i %(outdir)s." #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d. %b, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Generelt indeks" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "indeks" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "næste" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "forrige" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "kan ikke kopiere statisk fil %r" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "udgyldig js_file: %r, ignoreret" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "favicon-filen %r findes ikke" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s dokumentation" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Indeks" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Udgave" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "Kodningsfejl:" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "kan ikke finde filer %r" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "Indtast venligst noget tekst." #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "Indtast venligst enten »y« eller »n«." #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "Indtast venligt et filsuffiks, f.eks. ».rst« eller ».txt«" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "Filen %s findes allerede, udelader." #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "opret ikke makefile" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "skabelonmappe for skabelonfiler" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Afsnitsforfatter: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Modulforfatter: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Kodeforfatter: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Forfatter: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametre" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Returnerer" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Returtype" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "medlem" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "variabel" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funktion" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "makro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "optæl" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "optælling" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "type" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Ny i version %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Ændret i version %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Forældet siden version %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Template-parametre" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Kaster" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "klasse" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "koncept" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (indbygget funktion)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (metode i %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (klasse)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (global variabel eller konstant)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (attribut i %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Parametre" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modul)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "metode" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "data" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "attribut" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modul" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "nøgleord" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operator" #: sphinx/domains/python.py:61 msgid "object" msgstr "objekt" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "undtagelse" #: sphinx/domains/python.py:63 msgid "statement" msgstr "erklæring" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "indbygget funktion" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Variable" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Rejser" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (i modulet %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (i modulet %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (indbygget variabel)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (indbygget klasse)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (klasse i %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (klassemetode i %s)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (statisk metode i %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Python-modulindeks" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "moduler" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Forældet" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "klassemetode" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "statisk metode" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (forældet)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (direktiv)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (rolle)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "direktiv" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "rolle" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "miljøvariabel; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "begreb i ordliste" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "grammatisk element" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "referenceetiket" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "miljøvariabel" #: sphinx/domains/std.py:568 msgid "program option" msgstr "programtilvalg" #: sphinx/domains/std.py:569 msgid "document" msgstr "dokument" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Modulindeks" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Søgeside" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "ny konfiguration" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "udvidelser ændret" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "kildemappe er ændret" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "se %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "se også %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Symboler" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "overskriv eksisterende filer" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s er ikke en mappe" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[graf: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[graf]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Permalink til denne ligning" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(i %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[kilde]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Todo" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<oprindeligt punkt>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(Det <<oprindelige punkt>> befinder sig i %s, linje %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "oprindeligt punkt" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[dok]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Modulkode" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Kildekode for %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Oversigt: modulkode" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Alle moduler, der er kode tilgængelig for</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "Nøgleordsargumenter" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Eksempler" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "Andre parametre" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "Referencer" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Vær opmærksom" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Forsigtig" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Fare" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Fejl" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Fif" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Vigtigt" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Bemærk" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Se også" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Tip" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Advarsel" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "fortsat fra forrige side" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "fortsætter på næste side" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "side" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Søg" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Søg" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Vis kilde" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Oversigt" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Velkommen! Dette er" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "dokumentationen for" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "sidst opdateret" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Indeks og tabeller:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Fuldstændig indholdsfortegnelse" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "viser alle afsnit og underafsnit" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "søg i denne dokumentation" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Globalt modulindeks" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "hurtig adgang til alle moduler" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "alle funktioner, klasser, begreber" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Indeks – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Fuldt indeks på én side" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Indeksér sider efter bogstav" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "kan være enormt" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigation" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Søg i %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Om disse dokumenter" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Ophavsret" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Ophavsret</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Ophavsret %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Sidst opdateret %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Søg i %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Forrige emne" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "forrige kapitel" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Næste emne" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "næste kapitel" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Aktivér venligst JavaScript for at aktivere\n søgefunktionalitet." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "Bemærk: Hvis du søger efter flere ord, vises kun resultater der indeholder alle ordene." #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "søg" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Søgeresultater" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Din søgning matchede ikke nogen dokumenter. Sikr dig at alle ord er stavet korrekt og at du har valgt nok kategorier." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Hurtig søgning" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Denne side" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Ændringer i version %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automatisk oprettet liste af ændringer i version %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Biblioteksændringer" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Ændringer i C-API" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Andre ændringer" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Permalink til denne overskrift" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Permalink til denne definition" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Skjul søgeresultater" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Søger" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Forbereder søgning..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Søgning færdig, fandt %s sider der matcher søgeforespørgslen." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", i" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Udfold sidebjælke" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Sammenfold sidebjælke" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Indhold" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Permahenvisning til denne tabel" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Permahenvisning til denne kode" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Permahenvisning til dette billede" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Permahenvisning til dette toctree" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Fodnoter" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[billede: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[billede]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3241723 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/de/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015473� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.472527 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/de/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017260� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/de/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000007320�00000000000�021131� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "de", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": ", in ", "About these documents": "\u00dcber dieses Dokument", "Automatically generated list of changes in version %(version)s": "Automatisch generierte Liste der \u00c4nderungen in Version %(version)s", "C API changes": "C API-\u00c4nderungen", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "Seitenleiste einklappen", "Complete Table of Contents": "Vollst\u00e4ndiges Inhaltsverzeichnis", "Contents": "Inhalt", "Copyright": "Copyright", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Seitenleiste ausklappen", "Full index on one page": "Gesamtes Stichwortverzeichnis auf einer Seite", "General Index": "Stichwortverzeichnis", "Global Module Index": "Globaler Modulindex", "Go": "Los", "Hide Search Matches": "Suchergebnisse ausblenden", "Index": "Stichwortverzeichnis", "Index – %(key)s": "Stichwortverzeichnis – %(key)s", "Index pages by letter": "Stichwortverzeichnis nach Anfangsbuchstabe", "Indices and tables:": "Verzeichnisse und Tabellen:", "Last updated on %(last_updated)s.": "Zuletzt aktualisiert am %(last_updated)s.", "Library changes": "Bibliotheks-\u00c4nderungen", "Navigation": "Navigation", "Next topic": "N\u00e4chstes Thema", "Other changes": "Andere \u00c4nderungen", "Overview": "\u00dcbersicht", "Permalink to this definition": "Link zu dieser Definition", "Permalink to this headline": "Link zu dieser \u00dcberschrift", "Please activate JavaScript to enable the search\n functionality.": "Bitte aktivieren Sie JavaScript, wenn Sie die Suchfunktion nutzen wollen.", "Preparing search...": "Suche wird vorbereitet...", "Previous topic": "Vorheriges Thema", "Quick search": "Schnellsuche", "Search": "Suche", "Search Page": "Suche", "Search Results": "Suchergebnisse", "Search finished, found %s page(s) matching the search query.": "Die Suche ist fertig, es wurde(n) %s Seite(n) mit Treffern gefunden.", "Search within %(docstitle)s": "Suche in %(docstitle)s", "Searching": "Suchen", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Quellcode anzeigen", "Table of Contents": "Inhaltsverzeichnis", "This Page": "Diese Seite", "Welcome! This is": "Willkommen! Dies ist", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Ihre Suche ergab keine Treffer. Bitte stellen Sie sicher, dass alle W\u00f6rter richtig geschrieben sind und gen\u00fcgend Kategorien ausgew\u00e4hlt sind.", "all functions, classes, terms": "alle Funktionen, Klassen, Begriffe", "can be huge": "kann gro\u00df sein", "last updated": "zuletzt aktualisiert", "lists all sections and subsections": "Liste aller Kapitel und Unterkapitel", "next chapter": "n\u00e4chstes Kapitel", "previous chapter": "vorheriges Kapitel", "quick access to all modules": "schneller Zugriff auf alle Module", "search": "suchen", "search this documentation": "durchsuche diese Dokumentation", "the documentation for": "die Dokumentation f\u00fcr" }, "plural_expr": "(n != 1)" });����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/de/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000026245�00000000000�021137� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ �� ��� ����� �� ��� ����� ����� �����% �����7 �����K �����b �����s �� ��� ����� �� ��� �� ��� ����� ����� ����� ����� �� ���$ �����1 ��3���E �� ���y ����� ����� ��0��� ����� ����� �� ����� ��� �������>��������]�� ���f��!���t������������ ������������������������� ��������!�� ���(�����3�����O�����U�����n�����}�� ���������� ������������������������� ������������������ ����� ��!���4�����V�� ���f�� ���q�����~�� ����� ����� ���������� �����(�������������������� ���+�����9�����B�� ���X�����c�����z����������������������B��������?�����S��#���b��$���������� ��������������� ����������������������� �� ��������*��<���9�����v�� ����� ��������������� �����>�������� ���������������/�� ���C��W���M���������������������� �����������������������z�� ���������� �������������������� ���������� ���������� �����4��� �����@�����]�����t�� ���y������������ ��������������� ����� ��������������� ����� ��� �������/��������M�� ���U��"���b������������������������������������� �����#������������������ ���������� �����)��%���:�����`�����o��������������������������� ����� ����� ����� ������������������&�����<�����A����J�� �������������!�����*�����0�����D�����Y�����m������������$���������� ����� ������������������$�����D�� ���]�����k��7���~�� ���������������7�������������6�� ���L�����V�����^��C���f������������'�����������������������$��!���<��%���^������� ���������������������������������������� �����-��� �����7 �����L �����` �����d �����~ ����� ����� ��$��� ��*��� ����� ��)���!�����9!�� ���Q!�� ���^!�����i!�����|!�� ���!�� ���!�����!�����!��5���!��*���!�� ���%"�����/"�����I"�� ���\"�����g"�� ���"�����"�����"�����"�����"�����"��-���#��I���5#�����#�����#��$���#��$���#�����#�� ���$�� ���$�����$�� ���&$�� ���3$�����=$�����V$�����\$�����s$�����y$��D���$�����$�����$�� ���$�����$�� ���%�����%��A���-%�� ���o%�����}%�����%�����%�� ���%��T���%����� &�����&�����&�����&�� ���9&�����C&�����K&�����`&�����&�����&�� ���'�� ���'�����'�� ���#'��"���/'�����R'�����['�����l'�����|'�����'��;���'�� ���'��#���'�����(�� ���(�����"(�� ���+(�� ���7(�����B(�����T(�� ���j(�����t(�����(�����(�����(�����(�����(��9���(�����)�����)��$���))�����N)�����j)�����p)�����w)�����)�����)�����)�����)��/���)�����)�����)�����)�����)�����*����� *��2���*�����P*��!���_*�����*�����*�����*�����*�����*�� ���*�� ���*�����*�� ���*�����*�����+�����,�����,�����,��� (deprecated)� (in �%b %d, %Y�%s %s�%s %s documentation�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�, in �<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Cannot find source directory (%s)�Caution�Changed in version %s�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Event %r already present�Expand sidebar�Fig. %s�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Listing %s�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Note�Original exception: �Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Please activate JavaScript to enable the search functionality.�Preparing search...�Previous topic�Pygments lexer name %r is not known�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Release�Return type�Returns�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section %s�Section author: �See also�Show Source�Source directory and destination directory cannot be identical�Symbols�Table %s�Table of Contents�Template Parameters�This Page�This project needs at least Sphinx v%s and therefore cannot be built with this version.�Throws�Tip�Todo�Unknown event name: %s�Variables�Warning�Welcome! This is�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�all functions, classes, terms�attribute�built-in function�can be huge�class�class method�config directory doesn't contain a conf.py file (%s)�continued from previous page�continues on next page�data�directive�done�enum�enumerator�environment variable�environment variable; %s�exception�failed: %s�finished with problems�function�glossary term�grammar token�index�invalid number %r for config value %r, ignoring�keyword�last updated�lists all sections and subsections�loading translations [%s]... �macro�member�method�module�modules�next�next chapter�not available for built-in messages�object�operator�original entry�page�previous�previous chapter�primary_domain %r not found, ignored.�program option�quick access to all modules�reference label�role�search�search this documentation�see %s�see also %s�statement�static method�succeeded�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the documentation for�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: de Language-Team: German (http://www.transifex.com/sphinx-doc/sphinx-1/language/de/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (veraltet)� (in �%d.%m.%Y�%s-%s�%s %s Dokumentation�%s (Attribut von %s)�%s (Builtin-Klasse)�%s (Standard-Variable)�%s (Klasse in %s)�%s (Direktive)�%s (globale Variable oder Konstante)�%s (in Modul %s)�%s (Modul)�%s (Rolle)�%s() (Klassenmethode von %s)�%s() (Methode von %s)�%s() (statische Methode von %s)�%s() (Standard-Funktion)�%s() (Klasse)�%s() (im Modul %s)�(Der <<ursprüngliche Eintrag>> steht in %s, Zeile %d.)�(in %s v%s)�, in �<<ursprüngliche Eintrag>>�<h1>Alle Module, für die Quellcode verfügbar ist</h1>�<h1>Quellcode für %s</h1>�Über dieses Dokument�Parameter�Achtung�Autor: �Automatisch generierte Liste der Änderungen in Version %(version)s�Builtins�C API-Änderungen�Kann Quellverzeichnis nicht finden (%s)�Vorsicht�Geändert in Version %s�Autor des Quellcode: �Seitenleiste einklappen�Vollständiges Inhaltsverzeichnis�Konfigurationswert %r bereits gesetzt�Inhalt�Copyright�Gefahr�Veraltet�Veraltet ab Version %s�Fehler�Event %r bereits verfügbar�Seitenleiste ausklappen�Abb. %s�Fußnoten�Gesamtes Stichwortverzeichnis auf einer Seite�Stichwortverzeichnis�Globaler Modulindex�Los�Suchergebnisse ausblenden�Hinweis�Wichtig�Stichwortverzeichnis�Stichwortverzeichnis – %(key)s�Stichwortverzeichnis nach Anfangsbuchstabe�Verzeichnisse und Tabellen:�Zuletzt aktualisiert am %(last_updated)s.�Bibliotheks-Änderungen�Quellcode %s�Modulindex�Autor des Moduls: �Modul-Quellcode�Modulebene�Navigation�Neu in Version %s�Nächstes Thema�Kein builder ausgewählt, verwende 'html' per default�Keine solche Konfigurationseinstellung: %s�Bemerkung�Ursprüngliche Ausnahme: �Andere Änderungen�Übersicht�Überblick: Modul-Quellcode�Parameter�Link zu diesem Quellcode�Link zu dieser Definition�Link zu dieser Überschrift�Link zu diesem Bild�Link zu dieser Tabelle�Permanenter Link zu diesem Inhaltsverzeichnis�Bitte aktivieren Sie JavaScript, wenn Sie die Suchfunktion nutzen wollen.�Suche wird vorbereitet...�Vorheriges Thema�Pygments Lexer Name %r ist unbekannt�Python Enhancement Proposals; PEP %s�Python-Modulindex�Schnellsuche�Verursacht�Release�Rückgabetyp�Rückgabe�Sphinx v%s in Verwendung�Suche�Suche in %(docstitle)s�Suche�Suchergebnisse�Die Suche ist fertig, es wurde(n) %s Seite(n) mit Treffern gefunden.�Suche in %(docstitle)s�Suchen�Abschnitt %s�Autor des Abschnitts: �Siehe auch�Quellcode anzeigen�Quellverzeichnis und Zielverzeichnis können nicht identisch sein�Sonderzeichen�Tab. %s�Inhaltsverzeichnis�Template Parameter�Diese Seite�Dieses Projekt benötigt Version %s oder später und kann daher nicht gebaut werden.�Wirft�Tipp�Zu tun�Unbekannter Event name: %s�Variablen�Warnung�Willkommen! Dies ist�Ihre Suche ergab keine Treffer. Bitte stellen Sie sicher, dass alle Wörter richtig geschrieben sind und genügend Kategorien ausgewählt sind.�[Doku]�[Diagramm: %s]�[Diagramm]�[Bild: %s]�[Bild]�[Quellcode]�alle Funktionen, Klassen, Begriffe�Attribut�Builtin-Funktion�kann groß sein�Klasse�Klassenmethode�Konfigurationsverzeichnis enthält keine conf.py Datei (%s)�Fortsetzung der vorherigen Seite�Fortsetzung auf der nächsten Seite�Wert�Direktive�erledigt�Aufzählung�Enumerator�Umgebungsvariable�Umgebungsvariable; %s�Exception�Fehlgeschlagen: %s�mit Problemen beendet�Funktion�Glossareintrag�Grammatik-Token�Index�Ungültige Nummer %r for Konfiguration %r, wird ignoriert�Schlüsselwort�zuletzt aktualisiert�Liste aller Kapitel und Unterkapitel�Lade Übersetzungen [%s]…�Makro�Member�Methode�Modul�Module�weiter�nächstes Kapitel�nicht verfügbar für vordefinierte Nachrichten�Objekt�Operator�ursprüngliche Eintrag�Seite�zurück�vorheriges Kapitel�primary_domain %r nicht gefunden, daher ignoriert.�Programmoption�schneller Zugriff auf alle Module�Referenz-Label�Rolle�suchen�durchsuche diese Dokumentation�siehe %s�siehe auch %s�Anweisung�statische Methode�abgeschlossen�Die Erweiterung %s gibt nicht an ob paralleles Datenlesen fehlerfrei möglich ist, es wird daher nicht davon ausgegangen - bitte kontaktiere den Erweiterungsautor zur Überprüfung und Angabe�Die Erweiterung %s gibt nicht an ob paralleles Datenschreiben fehlerfrei möglich ist, es wird daher nicht davon ausgegangen - bitte kontaktiere den Erweiterungsautor zur Überprüfung und Angabe�die Dokumentation für�Typ�Variable������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/de/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000251647�00000000000�021150� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Georg Brandl <g.brandl@gmx.net>, 2013-2015 # Jean-François B. <jfbu@free.fr>, 2018 # Lukas Prokop <admin@lukas-prokop.at>, 2016-2018 # Michael Hierweck <michael@hierweck.de>, 2017 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: German (http://www.transifex.com/sphinx-doc/sphinx-1/language/de/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: de\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Kann Quellverzeichnis nicht finden (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Quellverzeichnis und Zielverzeichnis können nicht identisch sein" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx v%s in Verwendung" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Dieses Projekt benötigt Version %s oder später und kann daher nicht gebaut werden." #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "Lade Übersetzungen [%s]…" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "erledigt" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "nicht verfügbar für vordefinierte Nachrichten" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "Fehlgeschlagen: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "Kein builder ausgewählt, verwende 'html' per default" #: sphinx/application.py:348 msgid "succeeded" msgstr "abgeschlossen" #: sphinx/application.py:349 msgid "finished with problems" msgstr "mit Problemen beendet" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "Die Erweiterung %s gibt nicht an ob paralleles Datenlesen fehlerfrei möglich ist, es wird daher nicht davon ausgegangen - bitte kontaktiere den Erweiterungsautor zur Überprüfung und Angabe" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "Die Erweiterung %s gibt nicht an ob paralleles Datenschreiben fehlerfrei möglich ist, es wird daher nicht davon ausgegangen - bitte kontaktiere den Erweiterungsautor zur Überprüfung und Angabe" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "Konfigurationsverzeichnis enthält keine conf.py Datei (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "Ungültige Nummer %r for Konfiguration %r, wird ignoriert" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "Keine solche Konfigurationseinstellung: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "Konfigurationswert %r bereits gesetzt" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Abschnitt %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Abb. %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tab. %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Quellcode %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r nicht gefunden, daher ignoriert." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "Event %r bereits verfügbar" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Unbekannter Event name: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "Pygments Lexer Name %r ist unbekannt" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "Ursprüngliche Ausnahme:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Builtins" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Modulebene" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (in " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d.%m.%Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Stichwortverzeichnis" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "Index" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "weiter" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "zurück" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s Dokumentation" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Stichwortverzeichnis" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Release" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Autor des Abschnitts: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Autor des Moduls: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Autor des Quellcode: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autor: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s-%s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parameter" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Rückgabe" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Rückgabetyp" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "Member" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "Variable" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "Funktion" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "Makro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "Aufzählung" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "Enumerator" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "Typ" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Neu in Version %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Geändert in Version %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Veraltet ab Version %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Template Parameter" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Wirft" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "Klasse" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (Standard-Funktion)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (Methode von %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (Klasse)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (globale Variable oder Konstante)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (Attribut von %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Parameter" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (Modul)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "Methode" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "Wert" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "Attribut" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "Modul" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "Schlüsselwort" #: sphinx/domains/python.py:60 msgid "operator" msgstr "Operator" #: sphinx/domains/python.py:61 msgid "object" msgstr "Objekt" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "Exception" #: sphinx/domains/python.py:63 msgid "statement" msgstr "Anweisung" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "Builtin-Funktion" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Variablen" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Verursacht" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (im Modul %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (in Modul %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (Standard-Variable)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (Builtin-Klasse)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (Klasse in %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (Klassenmethode von %s)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (statische Methode von %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Python-Modulindex" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "Module" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Veraltet" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "Klassenmethode" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "statische Methode" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (veraltet)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (Direktive)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (Rolle)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "Direktive" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "Rolle" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "Umgebungsvariable; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "Glossareintrag" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "Grammatik-Token" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "Referenz-Label" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "Umgebungsvariable" #: sphinx/domains/std.py:568 msgid "program option" msgstr "Programmoption" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Modulindex" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Suche" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "siehe %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "siehe auch %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Sonderzeichen" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[Diagramm: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[Diagramm]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(in %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[Quellcode]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Zu tun" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<ursprüngliche Eintrag>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(Der <<ursprüngliche Eintrag>> steht in %s, Zeile %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "ursprüngliche Eintrag" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[Doku]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Modul-Quellcode" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Quellcode für %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Überblick: Modul-Quellcode" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Alle Module, für die Quellcode verfügbar ist</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Achtung" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Vorsicht" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Gefahr" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Fehler" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Hinweis" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Wichtig" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Bemerkung" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Siehe auch" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Tipp" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Warnung" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "Fortsetzung der vorherigen Seite" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "Fortsetzung auf der nächsten Seite" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "Seite" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "Inhaltsverzeichnis" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Suche" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Los" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Quellcode anzeigen" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Übersicht" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Willkommen! Dies ist" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "die Dokumentation für" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "zuletzt aktualisiert" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Verzeichnisse und Tabellen:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Vollständiges Inhaltsverzeichnis" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "Liste aller Kapitel und Unterkapitel" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "durchsuche diese Dokumentation" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Globaler Modulindex" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "schneller Zugriff auf alle Module" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "alle Funktionen, Klassen, Begriffe" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Stichwortverzeichnis – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Gesamtes Stichwortverzeichnis auf einer Seite" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Stichwortverzeichnis nach Anfangsbuchstabe" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "kann groß sein" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigation" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Suche in %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Über dieses Dokument" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Copyright" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Zuletzt aktualisiert am %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Suche in %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Vorheriges Thema" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "vorheriges Kapitel" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Nächstes Thema" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "nächstes Kapitel" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Bitte aktivieren Sie JavaScript, wenn Sie die Suchfunktion nutzen wollen." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "suchen" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Suchergebnisse" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Ihre Suche ergab keine Treffer. Bitte stellen Sie sicher, dass alle Wörter richtig geschrieben sind und genügend Kategorien ausgewählt sind." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Schnellsuche" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Diese Seite" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automatisch generierte Liste der Änderungen in Version %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Bibliotheks-Änderungen" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API-Änderungen" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Andere Änderungen" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Link zu dieser Überschrift" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Link zu dieser Definition" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Suchergebnisse ausblenden" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Suchen" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Suche wird vorbereitet..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Die Suche ist fertig, es wurde(n) %s Seite(n) mit Treffern gefunden." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", in " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Seitenleiste ausklappen" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Seitenleiste einklappen" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Inhalt" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Link zu dieser Tabelle" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Link zu diesem Quellcode" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Link zu diesem Bild" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Permanenter Link zu diesem Inhaltsverzeichnis" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Fußnoten" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[Bild: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[Bild]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �����������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3243535 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/el/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015503� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4733794 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/el/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017270� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/el/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000023070�00000000000�021141� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "el", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Copyright</a>%(copyright)s", "© Copyright %(copyright)s.": "© Copyright %(copyright)s.", ", in ": ", \u03c3\u03c4\u03bf ", "About these documents": "\u03a3\u03c7\u03b5\u03c4\u03b9\u03ba\u03ac \u03bc\u03b5 \u03b1\u03c5\u03c4\u03ac \u03c4\u03b1 \u03ba\u03b5\u03af\u03bc\u03b5\u03bd\u03b1", "Automatically generated list of changes in version %(version)s": "\u0391\u03c5\u03c4\u03cc\u03bc\u03b1\u03c4\u03b1 \u03c0\u03b1\u03c1\u03b1\u03b3\u03cc\u03bc\u03b5\u03bd\u03b7 \u03bb\u03af\u03c3\u03c4\u03b1 \u03b1\u03bb\u03bb\u03b1\u03b3\u03ce\u03bd \u03c3\u03c4\u03b7\u03bd \u03ad\u03ba\u03b4\u03bf\u03c3\u03b7 %(version)s", "C API changes": "\u0391\u03bb\u03bb\u03b1\u03b3\u03ad\u03c2 \u03c3\u03c4\u03bf API \u03c4\u03b7\u03c2 C", "Changes in Version %(version)s — %(docstitle)s": "\u0391\u03bb\u03bb\u03b1\u03b3\u03ad\u03c2 \u03c3\u03c4\u03b7\u03bd \u0388\u03ba\u03b4\u03bf\u03c3\u03b7 %(version)s —'\n%(docstitle)s", "Collapse sidebar": "\u039a\u03bb\u03b5\u03af\u03c3\u03b9\u03bc\u03bf \u03c0\u03bb\u03b1\u03ca\u03bd\u03ae\u03c2 \u03bc\u03c0\u03ac\u03c1\u03b1\u03c2", "Complete Table of Contents": "\u03a0\u03bb\u03ae\u03c1\u03b7\u03c2 \u03a0\u03af\u03bd\u03b1\u03ba\u03b1\u03c2 \u03a0\u03b5\u03c1\u03b9\u03b5\u03c7\u03bf\u03bc\u03ad\u03bd\u03c9\u03bd", "Contents": "\u03a0\u03b5\u03c1\u03b9\u03b5\u03c7\u03cc\u03bc\u03b5\u03bd\u03b1", "Copyright": "Copyright", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "\u0386\u03bd\u03bf\u03b9\u03b3\u03bc\u03b1 \u03c0\u03bb\u03b1\u03ca\u03bd\u03ae\u03c2 \u03bc\u03c0\u03ac\u03c1\u03b1\u03c2", "Full index on one page": "\u03a0\u03bb\u03ae\u03c1\u03b5\u03c2 \u03b5\u03c5\u03c1\u03b5\u03c4\u03ae\u03c1\u03b9\u03bf \u03c3\u03b5 \u03bc\u03af\u03b1 \u03c3\u03b5\u03bb\u03af\u03b4\u03b1", "General Index": "\u039a\u03b5\u03bd\u03c4\u03c1\u03b9\u03ba\u03cc \u0395\u03c5\u03c1\u03b5\u03c4\u03ae\u03c1\u03b9\u03bf\u03bf", "Global Module Index": "\u039a\u03b1\u03b8\u03bf\u03bb\u03b9\u03ba\u03cc \u0395\u03c5\u03c1\u03b5\u03c4\u03ae\u03c1\u03b9\u03bf \u039c\u03bf\u03bd\u03ac\u03b4\u03c9\u03bd", "Go": "\u03a0\u03ac\u03bc\u03b5", "Hide Search Matches": "\u0391\u03c0\u03cc\u03ba\u03c1\u03c5\u03c8\u03b7 \u0395\u03c5\u03c1\u03b5\u03b8\u03ad\u03bd\u03c4\u03c9\u03bd \u0391\u03bd\u03b1\u03b6\u03b7\u03c4\u03ae\u03c3\u03b5\u03c9\u03bd", "Index": "\u0395\u03c5\u03c1\u03b5\u03c4\u03ae\u03c1\u03b9\u03bf", "Index – %(key)s": "\u0395\u03c5\u03c1\u03b5\u03c4\u03ae\u03c1\u03b9\u03bf – %(key)s", "Index pages by letter": "\u03a3\u03b5\u03bb\u03af\u03b4\u03b5\u03c2 \u03b5\u03c5\u03c1\u03b5\u03c4\u03b7\u03c1\u03af\u03bf\u03c5 \u03b1\u03bd\u03ac \u03b3\u03c1\u03ac\u03bc\u03bc\u03b1", "Indices and tables:": "\u0395\u03c5\u03c1\u03b5\u03c4\u03ae\u03c1\u03b9\u03b1 \u03ba\u03b1\u03b9 \u03c0\u03af\u03bd\u03b1\u03ba\u03b5\u03c2:", "Last updated on %(last_updated)s.": "\u03a4\u03b5\u03bb\u03b5\u03c5\u03c4\u03b1\u03af\u03b1 \u03b5\u03bd\u03b7\u03bc\u03ad\u03c1\u03c9\u03c3\u03b7 \u03c3\u03c4\u03b9\u03c2 %(last_updated)s.", "Library changes": "\u0391\u03bb\u03bb\u03b1\u03b3\u03ad\u03c2 \u03b2\u03b9\u03b2\u03bb\u03b9\u03bf\u03b8\u03ae\u03ba\u03b7\u03c2", "Navigation": "\u03a0\u03bb\u03bf\u03ae\u03b3\u03b7\u03c3\u03b7", "Next topic": "\u0395\u03c0\u03cc\u03bc\u03b5\u03bd\u03bf \u03b8\u03ad\u03bc\u03b1", "Other changes": "\u0386\u03bb\u03bb\u03b5\u03c2 \u03b1\u03bb\u03bb\u03b1\u03b3\u03ad\u03c2", "Overview": "\u0395\u03c0\u03b9\u03c3\u03ba\u03cc\u03c0\u03b7\u03c3\u03b7", "Permalink to this definition": "\u039c\u03cc\u03bd\u03b9\u03bc\u03bf\u03c2 \u03c3\u03cd\u03bd\u03b4\u03b5\u03c3\u03bc\u03bf\u03c2 \u03c3\u03b5 \u03b1\u03c5\u03c4\u03cc\u03bd \u03c4\u03bf\u03bd \u03bf\u03c1\u03b9\u03c3\u03bc\u03cc", "Permalink to this headline": "\u039c\u03cc\u03bd\u03b9\u03bc\u03bf\u03c2 \u03c3\u03cd\u03bd\u03b4\u03b5\u03c3\u03bc\u03bf\u03c2 \u03c3\u03b5 \u03b1\u03c5\u03c4\u03ae\u03bd \u03c4\u03b7\u03bd \u03ba\u03b5\u03c6\u03b1\u03bb\u03af\u03b4\u03b1", "Please activate JavaScript to enable the search\n functionality.": "\u03a0\u03b1\u03c1\u03b1\u03ba\u03b1\u03bb\u03ce, \u03b5\u03bd\u03b5\u03c1\u03b3\u03bf\u03c0\u03bf\u03b9\u03ae\u03c3\u03c4\u03b5 \u03c4\u03b7 JavaScript \u03b3\u03b9\u03b1 \u03bd\u03b1 \u03b5\u03af\u03bd\u03b1\u03b9 \u03b4\u03c5\u03bd\u03b1\u03c4\u03ae \u03b7 \u03bb\u03b5\u03b9\u03c4\u03bf\u03c5\u03c1\u03b3\u03af\u03b1\n \u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7\u03c2.", "Preparing search...": "\u03a0\u03c1\u03bf\u03b5\u03c4\u03bf\u03b9\u03bc\u03b1\u03c3\u03af\u03b1 \u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7\u03c2...", "Previous topic": "\u03a0\u03c1\u03bf\u03b7\u03b3\u03bf\u03cd\u03bc\u03b5\u03bd\u03bf \u03b8\u03ad\u03bc\u03b1", "Quick search": "\u03a3\u03cd\u03bd\u03c4\u03bf\u03bc\u03b7 \u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7", "Search": "\u0391\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7", "Search Page": "\u03a3\u03b5\u03bb\u03af\u03b4\u03b1 \u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7\u03c2", "Search Results": "\u0391\u03c0\u03bf\u03c4\u03b5\u03bb\u03ad\u03c3\u03bc\u03b1\u03c4\u03b1 \u0391\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7\u03c2", "Search finished, found %s page(s) matching the search query.": "\u0397 \u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7 \u03bf\u03bb\u03bf\u03ba\u03bb\u03b7\u03c1\u03ce\u03b8\u03b7\u03ba\u03b5, \u03b2\u03c1\u03ad\u03b8\u03b7\u03ba\u03b5/\u03b1\u03bd %s \u03c3\u03b5\u03bb\u03af\u03b4\u03b1/\u03b5\u03c2 \u03bc\u03b5 \u03b2\u03ac\u03c3\u03b7 \u03c4\u03bf\u03c5\u03c2 \u03cc\u03c1\u03bf\u03c5\u03c2 \u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7\u03c2.", "Search within %(docstitle)s": "\u0391\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7 \u03c3\u03c4\u03bf %(docstitle)s", "Searching": "\u0395\u03ba\u03c4\u03b5\u03bb\u03b5\u03af\u03c4\u03b1\u03b9 \u03b7 \u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "\u03a0\u03c1\u03bf\u03b2\u03bf\u03bb\u03ae \u03ba\u03ce\u03b4\u03b9\u03ba\u03b1", "Table of Contents": "\u03a0\u03af\u03bd\u03b1\u03ba\u03b1\u03c2 \u03c0\u03b5\u03c1\u03b9\u03b5\u03c7\u03bf\u03bc\u03ad\u03bd\u03c9\u03bd", "This Page": "\u0391\u03c5\u03c4\u03ae \u03b7 \u03c3\u03b5\u03bb\u03af\u03b4\u03b1", "Welcome! This is": "\u039a\u03b1\u03bb\u03c9\u03c3\u03ae\u03c1\u03b8\u03b1\u03c4\u03b5! \u0391\u03c5\u03c4\u03ae \u03b5\u03af\u03bd\u03b1\u03b9", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "\u0397 \u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03ae \u03c3\u03b1\u03c2 \u03b4\u03b5\u03bd \u03c4\u03b1\u03c5\u03c4\u03bf\u03c0\u03bf\u03b9\u03ae\u03b8\u03b7\u03ba\u03b5 \u03bc\u03b5 \u03ba\u03b1\u03bd\u03ad\u03bd\u03b1 \u03ba\u03b5\u03af\u03bc\u03b5\u03bd\u03bf. \u03a0\u03b1\u03c1\u03b1\u03ba\u03b1\u03bb\u03ce, \u03b5\u03c0\u03b9\u03b2\u03b5\u03b2\u03b1\u03b9\u03ce\u03c3\u03c4\u03b5 \u03cc\u03c4\u03b9 \u03cc\u03bb\u03b5\u03c2 \u03bf\u03b9 \u03bb\u03ad\u03be\u03b5\u03b9\u03c2 \u03ad\u03c7\u03bf\u03c5\u03bd \u03c4\u03b7 \u03c3\u03c9\u03c3\u03c4\u03ae \u03bf\u03c1\u03b8\u03bf\u03b3\u03c1\u03b1\u03c6\u03af\u03b1 \u03ba\u03b1\u03b9 \u03cc\u03c4\u03b9 \u03ad\u03c7\u03b5\u03c4\u03b5 \u03b5\u03c0\u03b9\u03bb\u03ad\u03be\u03b5\u03b9\u03c2 \u03b1\u03c1\u03ba\u03b5\u03c4\u03ad\u03c2 \u03ba\u03b1\u03c4\u03b7\u03b3\u03bf\u03c1\u03af\u03b5\u03c2.", "all functions, classes, terms": "\u03cc\u03bb\u03b5\u03c2 \u03bf\u03b9 \u03c3\u03c5\u03bd\u03b1\u03c1\u03c4\u03ae\u03c3\u03b5\u03b9\u03c2, \u03ba\u03bb\u03ac\u03c3\u03b5\u03b9\u03c2, \u03cc\u03c1\u03bf\u03b9", "can be huge": "\u03bc\u03c0\u03bf\u03c1\u03b5\u03af \u03bd\u03b1 \u03b5\u03af\u03bd\u03b1\u03b9 \u03c4\u03b5\u03c1\u03ac\u03c3\u03c4\u03b9\u03bf", "last updated": "\u03c4\u03b5\u03bb\u03b5\u03c5\u03c4\u03b1\u03af\u03b1 \u03b5\u03bd\u03b7\u03bc\u03ad\u03c1\u03c9\u03c3\u03b7", "lists all sections and subsections": "\u03b1\u03c0\u03b1\u03c1\u03b9\u03b8\u03bc\u03b5\u03af \u03cc\u03bb\u03b1 \u03c4\u03b1 \u03ba\u03b5\u03c6\u03ac\u03bb\u03b1\u03b9\u03b1 \u03ba\u03b1\u03b9 \u03c5\u03c0\u03bf\u03ba\u03b5\u03c6\u03ac\u03bb\u03b1\u03b9\u03b1", "next chapter": "\u03b5\u03c0\u03cc\u03bc\u03b5\u03bd\u03bf \u03ba\u03b5\u03c6\u03ac\u03bb\u03b1\u03b9\u03bf", "previous chapter": "\u03c0\u03c1\u03bf\u03b7\u03b3\u03bf\u03cd\u03bc\u03b5\u03bd\u03bf \u03ba\u03b5\u03c6\u03ac\u03bb\u03b1\u03b9\u03bf", "quick access to all modules": "\u03b3\u03c1\u03ae\u03b3\u03bf\u03c1\u03b7 \u03c0\u03c1\u03cc\u03c3\u03b2\u03b1\u03c3\u03b7 \u03c3\u03b5 \u03cc\u03bb\u03b5\u03c2 \u03c4\u03b9\u03c2 \u03bc\u03bf\u03bd\u03ac\u03b4\u03b5\u03c2", "search": "\u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7", "search this documentation": "\u03b1\u03bd\u03b1\u03b6\u03ae\u03c4\u03b7\u03c3\u03b7 \u03b1\u03c5\u03c4\u03ae\u03c2 \u03c4\u03b7\u03c2 \u03c4\u03b5\u03ba\u03bc\u03b7\u03c1\u03af\u03c9\u03c3\u03b7\u03c2", "the documentation for": "\u03b7 \u03c4\u03b5\u03ba\u03bc\u03b7\u03c1\u03af\u03c9\u03c3\u03b7 \u03c4\u03bf\u03c5" }, "plural_expr": "(n != 1)" });������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/el/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000241400�00000000000�021137� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������m�������������������&����&�����t(��E��b)��r���*��l���+�� ���+�����+��*���+��=���+��7���,��H���=,��?���,��"���,�� ���,�����,��%���,�����"-�����(-�����<-�� ���N-�����Z-�����n-�����-�����-�� ���-�����-�� ���-�� ���-�� ���-��S���.��A���c.�����.�����.�����.�����.�����.�� ���/�����"/��6���6/�����m/�����/��$���/�����/��3���0�� ���0�����0�����0��1���0��1���1��G���:1�����1��0���1�����1��b���1�����E2��6���[2�����2�� ���2�� ���2�� ���2�����2�����2��>���2�� ���43��(���>3��(���g3�����3��?���3�����3�� ���3��!���4��8���(4��%���a4�����4�����4��4���4�� ���4�� ���4����� 5�����5�����55�����U5�� ���^5��%���h5��%���5�����5��:���5��7��� 6�����E6��"���\6�����6�����6�� ���6�����6�����6��`���6�����<7�����L7��D���R7��H���7��K���7�����,8�����E8�����M8��5���V8�����8�����8�����8��8���8��"���8��"���9��#���@9�����d9��!���l9��:���9�����9�� ���9�� ��� :�����:�� ���+:�����9:�����M:��C���P:�����:�����:��.���:�� ���:��.���:�����;�����;�����1;��D���G;�����;�����;��[���;�����<�����.<�����L<��Y���^<��!���<�����<��2���<�� ���=��C���(=�����l=��n���=��E���=�� ���A>�����N>�� ���^>�� ���j>��-���w>��(���>�� ���>�����>�� ���>��(���>�����?�����8?�����I?��Z���N?�����?�����?��,���?�����?�����?�� ��� @�����@�����!@�� ���7@�����B@�����Y@�����v@�����@�����@�����@�����@��&���@��B���A��i���`A��2���A��I���A��4���GB�����|B�����B�����B�����B�����B������C�����C�����%C�� ���6C�����CC�����SC�����fC��#���vC��$���C�����C�� ���C�����C�����C�� ���C�����D�� ��� D�����D�����D�����?D�����RD�����YD�� ���nD�����zD��<���D�����D�� ���D�� ���D�����D�����E��+���E�� ���=E��>���IE�����E��#���E�����E�����E�����E�����E�����E����� F��Y���F��Z���wF��*���F��3���F��/���1G��(���aG��.���G��P���G��p��� H�����{H��!���H��"���H��$���H�� ���I��e���&I��Z���I��N���I��T���6J��K���J��%���J�����J��[���K��#���yK��'���K��#���K��'���K��!���L��=���3L��7���qL�� ���L��d���L��W���M��v���pM�����M�����M�����M�� ���M�����N�����/N��"���KN�� ���nN�����xN�����N��,���N�����N�����N�����N�����N��,���lO�����O�����O�� ���O�����O�� ���O�����O�����O��N���O�����<P��?���P��-���Q��2���6Q�����iQ�����Q�����Q��9���Q�����Q�� ����R�� ��� R��,���R��2���DR��b���wR��G���R�����"S�����7S�� ���MS��%���WS��`���}S�����S�����S�����T�����+T�����;T�� ���MT��&���YT��$���T�����T�����T�����T�����T����� U��A���-U��Z���oU��-���U�����U�����V�����4V��!���IV��8���kV�����V�� ���V�����V��7���V��6���V��;���.W��I���jW��;���W��:���W��H���+X��9���tX��G���X��2���X��2���)Y�����\Y��4���kY�����Y�����Y�����Y��2���Y�����Z�����8Z�����UZ�����sZ�����Z�����Z�����Z��(���Z��=���Z�����=[�����N[��0���^[�����[�����[��/���[�����[��*���[��&���$\�� ���K\��9���U\�����\�� ���\�����\��-���\�����]�����)]��1���@]��*���r]�����]�����]��0���]��&���]�����^�����&^��(���F^�����o^�����^�����^��%���^��e���^�����E_��4���_�����`�����!`��Y���1`��;���`��.���`�����`��+���a��(���Aa��4���ja�����a�����a�����a��X���a��J���Gb�����b��%���b�� ���b�����b�����b��+���b�����"c�����<c�� ���\c��8���fc��M���c��u���c�����cd�����ud�����d�����d�����d��A���d�� ���e�����e��6���.e��I���ee��A���e�����e��0��� f�����=f��G���Tf��N���f�����f�����f��.���g�� ���3g�� ���Ag��=���Og�����g��'���g��(���g��,���g��!���(h�����Jh�����ih�����h��=���h��+���h��0��� i��V���;i��V���i��M���i��R���7j��$���j�����j�����j��N���j��0���k��)���Ik�����sk�����k�����k��/���k�����k�����l�����-l��&���Dl��!���kl��&���l�����l��E���l�� ���m��*���m��7���:m��"���rm��(���m�����m�����m�����m��"���n�����7n�����=n�����Un��;���jn�����n�����n��"���n��!���n�����n��#����o�����$o��D���,o��5���qo�� ���o�����o�� ���o��1���o��E���o��B���<p��G���p��%���p�����p��#���q��#���+q��,���Oq�����|q��-���q��(���q��D���q�� ���4r��#���?r��(���cr��#���r�����r�����r�����r��(���r�����r�����s��8���s�� ���Os��P���ps��"���s�����s�����s��O���t�����ht�����}t�����t�����t��%���t�� ���t�����t��,���t�� ���u��(���(u��E���Qu��*���u��1���u��7���u�����,v�� ���Hv�����Sv�����fv�����|v�����v�����v�����v��&���v�����v�����w��4��� w�����Bw��%���Ww�����}w��c���w�����w�����x�� ��� x��'���x��:���=x�� ���xx��@���x�����x�����x�����x��&���y��*���9y��&���dy��W���y��>���y��7���"z�� ���Zz�� ���dz�� ���rz��,���|z��*���z��0���z�����{��%���#{�����I{�����{�����y|��\���|�����|��'���}��%���0}��+���V}��^���}��2���}��5���~�����J~�����i~�����~��5���~�����~�����~��+���~��-��� �����:��!���V��!���x�������!���������������#�����*��������A�����J�����]�����t��9�����;���̀��)��� �����3�����;�����N�����g�����}��������������Ł��������H��q������������~�����i�������@�����~���ʌ��x���I��{�����|���>��"��������ގ�������X��������R��#���X�����|�� �����(�����0���я������������:���,�����g������������G���������������-���3��,���a�������.�����2���ݒ����������"��4���@�����u��<�����P���ғ����#��F���ە�����"�� ���>�� ���J��Z���T��Y�������� �����Ǘ��s���ڗ��5���N�������0���;��g���l��&���ԙ��E��������A�����V��#���e�������a�����������a�����`���s��W���ԛ�����,��1���֜��"�����X���+��x�����j��������h��%���w��F�����7�����!�����,���>��4���k��J���������� �����]��� ��]���j��M���Ƞ��w����������$�����A���<��'���~������������-���̢��?�������:��(���Y�� �����}�������� �������*���'�����R�����g�������(�����*���-��#���X��s���|��h�����<���Y��m����� �����E�����a���U��:�����O�����)���B��8���l��%�����2���˪������������<����������S��������X��r���k�����ެ��"�����7��������L��)���խ��#��������#��&�����8�����(���V�������@���M��%���������� ���B�����P��.���б������������!���%��#���G�����k��4�����V�����d��������z���������������ô��P���E��������������������w�������w�������������5�����U�����o��:����������I���Է��E�����E���d��I�����I�����I���>��b�����T��������@�����Ӻ��o�������������ܼ��c���o��I���ӽ��E�����K���c��0����������*���������+�����C�����Y��%���y�������1�����$�����/�����!���>�����`�� ���q������������'����������@�����'���6�����^�� ���q��!�����-����������'���s��*����������%����������]��������r�������*�����Z���F������������%����������'�����%���,�����R�������@�����T�����X�����>���o��T��������������2�����>�����=�����?���R��;������������������,����������V��^�����:���F�������@���W��O�����D�����;���-��F���i�������v���3��������������������p�����a��!���r�������B�����0�����1�����-���Q�����������������^�����+���-��3���Y�������.����9�����<��� �����F�����]�����r������������ ����������m��S�������l���[��q�����>���:��%���y��#�����z�����6���>�����u��#�����Q�����c��������`�������2�����:����������p���9�������m���e��K�������������>��+���]��-�����s�����n���+��^�����Y�����W���S��@�����l��������Y����%�����5��F�����O��������O��A���m��i����� �����"���$�� ���G�����T��t�����y���N�������y���Q��x��������D��w��������C��j�����p���4��.�����}�����.���R��H�����5�����T������<���U��?�����@�����:�����=���N��$�����/�����^�����y���@������������d��������\��C���m��c�����-�����V���C��\����� �����X�����O���]��b�����!�����j���2��,�����+����������F�����#����������U�����W���O�������R�����b�����&���{��?�����D�����Z���'�������E��:���������������+�����E��`�����H���c��W�����I�����I���N��a�����8�����5���3��B���i����������d�����B���� ���Y�-���d�1����X����7����N���U�����i�����������#����)���������?����5���Q�~��������2����x���N��������w�;��� �w���V �.��� ���� ���� ���� ����0 �S���P ���� �#��� �p��� �?���J �:��� �;��� �u��� �F���w �N��� �K��� �J���Y�����d���>�y���������������C�����W���Z�������������r����E����&���8�4���_�3����o����"���8�'���[�!����3����A����b�������~�����%����^���<�Y����M����A���C�>����-����/����F���"����i�4����&�������� ���]����h�5���w�Z���� ����W�������m����|�l���#�%������������y�������_�|����y����H����1���O�[����I����\���' �G��� �Y��� �q���&!����!�"���!"�O���D"�Y���"�A���"����0#����G#����X#�X���t#�>���#� ��� $�X���$�6���r$����$�K���A%�P���%�7���%����&�[���&�)���'����I'�'���`'�D���'����'�'���'�k���(����{(�b���(����(�[���y)�~���)����T*�C���*����4+����N+�'���h+����+�$���+����+�&���+�F���,�"���b,� ���,�X���,�?���,�Z���)-����-����-�;���w.� ���.����.�M���.����*/�a���/����"0����0�<���0�*���0�U���1�L���u1�@���1����2�c���2�`���/3� ���3����3����3�d���3�d���24�e���4�2���4�F���05�R��w5�J��6����8����48�8���8�9���9�7���B9�X���z9����9�f���:�a���:�8���L;�G���;� ���;�u���;�9���N<� ���<�C���<�p���<�D���H=�S���=�8���=�,���>�O���G>�0���>����>�I���>����"?����?����?�,���?�?���@����A@����@�h���A����A�#���A�6���B�'���TB�7���|B����B�,���B�� Generate ReStructuredText using autosummary directives. sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates the reStructuredText files from the autosummary directives contained in the given input files. The format of the autosummary directive is documented in the ``sphinx.ext.autosummary`` Python module and can be read using:: pydoc sphinx.ext.autosummary � Generate required files for a Sphinx project. sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build. � Look recursively in <MODULE_PATH> for Python modules and packages and create one reST file with automodule directives per package in the <OUTPUT_PATH>. The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be excluded from generation. Note: By default this script will not overwrite already created files.� Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� Run 'make' in that directory to run these through makeinfo (use 'make info' here to do that automatically).� (deprecated)� (in �"::" in automodule name doesn't make sense�"latex_documents" config value references unknown document %s�"man_pages" config value references unknown document %s�"quiet" is specified, but any of "project" or "author" is not specified.�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%s %s�%s %s documentation�%s (%s attribute)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command %r cannot be run (needed for math display), check the imgmath_%s setting�%s is already assigned section numbers (nested numbered toctree?)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �-A option argument must be in the form name=value�-D option argument must be in the form name=value�4 column based index found. It might be a bug of extensions you use: %r�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�About these documents�An error happened in rendering the page %s. Reason: %r�Anchor '%s' not found�Any IDs not assigned for %s node�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not fetch remote image: %s [%d]�Could not fetch remote image: %s [%s]�Could not import extension %s�Could not lex literal_block as "%s". Highlighting skipped.�Could not obtain image size. :scale: option is ignored.�Create Makefile? (y/n)�Create Windows command file? (y/n)�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Encoding error:�Error�Error: an existing conf.py has been found in the selected root path.�Error: specified path is not a directory, or sphinx files already exist.�Error: the master file %s has already been found in the selected root path.�Event %r already present�Example�Examples�Exception occurred while building, starting debugger:�Exception occurred:�Expand sidebar�Extension options�External Graphviz file %r not found or reading it failed�Failed to read build info file: %r�Failed to scan documents in %s: %r�Failed to write build info file: %r�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnote [#] is not referenced.�Footnote [%s] is not referenced.�Footnotes�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Hide Search Matches�Hint�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indicate which of the following Sphinx extensions should be enabled:�Indices and tables:�Invalid caption: %s�Invalid date format. Quote the string by single quote if you want to output it directly: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�Keyword Arguments�LaTeX command %r cannot be run (needed for math display), check the imgmath_latex setting�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Look for any errors in the above output or in %(outdir)s/output.txt�Makefile and Batchfile creation�Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Many math_renderers are registered. But no math_renderer is selected.�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Non-alphabetical�Note�Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.�Notes�Numbers�Object named %r not found in include file %r�Original exception: �Other Parameters�Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Pillow not found - copying image files�Please activate JavaScript to enable the search functionality.�Please also report this if it was a user error, so that a better error message can be provided next time.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter a new file name, or rename the existing file and press Enter�Please enter a new root path (or just Enter to exit)�Please enter a valid path name.�Please enter either 'y' or 'n'.�Please enter one of %s.�Please enter some text.�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project templating�Project version�Pygments lexer name %r is not known�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Recursion error:�References�Release�Return type�Returns�Root path for the documentation�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section %s�Section author: �See also�Separate source and build directories (y/n)�Show Source�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Structure options�Symbols�TODO entry found: %s�Table %s�Table of Contents�Template Parameters�Testing of coverage in the sources finished, look at the results in %(outdir)spython.txt.�Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt.�The %r crossref_type is already registered�The %r directive is already registered to domain %s�The %r index is already registered to domain %s�The %r object_type is already registered�The %r role is already registered to domain %s�The %s extension is required by needs_extensions settings, but it is not loaded.�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.�The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.�The config value `{name}' has type `{current.__name__}'; expected {permitted}.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The dummy builder generates no files.�The ePub file is in %(outdir)s.�The full traceback has been saved in %s, if you want to report the issue to the developers.�The manual pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�The overview file is in %(outdir)s.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Translator for %r already exists�Unknown event name: %s�Unknown image format: %s...�Unknown math_renderer %r is given.�Variables�Warning�Warns�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�Would create file %s.�Yields�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[autosummary] generating autosummary for: %s�[autosummary] writing to %s�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.�a list of specific files to rebuild. Ignored if -a is specified�a suitable image for %s builder not found: %s�a suitable image for %s builder not found: %s (%s)�all functions, classes, terms�all of %d po files�all source files�append module_path to sys.path, used when --full is given�assembling single document�attribute�author names�automatically insert docstrings from modules�automatically test code snippets in doctest blocks�autosummary generats .rst files internally. But your source_suffix does not contain .rst. Skipped.�both tabularcolumns and :widths: option are given. :widths: is ignored.�broken link: %s (%s)�build %s, %s warning.�build %s.�build environment version not current�build in parallel with N processes where possible (special value "auto" will set N to cpu-count)�build info file is broken: %r�builder to use (default: html)�building [%s]: �building [mo]: �built-in function�can be huge�cannot combine -a option and filenames�cannot copy downloadable file %r: %s�cannot copy extra file %r�cannot copy image file %r: %s�cannot copy static file %r�cannot find files %r�cannot open warning file %r: %s�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�cannot read image file %r: copying it instead�cannot write image file %r: %s�caption not inside a figure.�checking consistency�checks for documentation coverage�circular toctree references detected, ignoring: %s <- %s�class�class method�concept�conditional inclusion of content based on config values�conf value "epub_author" should not be empty for EPUB3�conf value "epub_contributor" should not be empty for EPUB3�conf value "epub_copyright" (or "copyright")should not be empty for EPUB3�conf value "epub_description" should not be empty for EPUB3�conf value "epub_identifier" should not be empty for EPUB3�conf value "epub_language" (or "language") should not be empty for EPUB3�conf value "epub_publisher" should not be empty for EPUB3�conf value "epub_title" (or "html_title") should not be empty for EPUB3�conf value "epub_uid" should be XML NAME for EPUB3�conf value "version" should not be empty for EPUB3�config changed�config directory doesn't contain a conf.py file (%s)�console output options�continued from previous page�continues on next page�convert exited with error: [stderr] %r [stdout] %r�copying TeX support files�copying TeX support files...�copying Texinfo support files�copying additional files�copying downloadable files... �copying images... �copying source files...�could not read %r for changelog creation�create .nojekyll file to publish the document on GitHub pages�create batchfile�create makefile�custom template directory (default: %(default)s)�data�default role %s not found�default suffix for files (default: %(default)s)�define a template variable�define tag: include "only" blocks with TAG�dimension unit %s is invalid. Ignored.�directive�directive %r is already registered, it will be overridden�directory to place all output�directory to place all output in�display latex %r: %s�do emit colored output (default: auto-detect)�do not create batchfile�do not create makefile�do not emit colored output (default: auto-detect)�do not use make-mode for Makefile/make.bat�docnames to write: %s�document�document imported members (default: %(default)s)�document isn't included in any toctree�document language�document not readable. Ignored.�document title is not a single Text node�doing serial %s�domain %s already registered�domain %s not yet registered�don't create a table of contents file�don't create headings for the module/package packages (e.g. when the docstrings already contain them)�don't know which module to import for autodocumenting %r (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)�don't use a saved environment, always read all files�done�dot code %r: %s�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�dot did not produce an output file: [stderr] %r [stdout] %r�dot exited with error: [stderr] %r [stdout] %r�download file not readable: %s�duplicate citation %s, other instance in %s�duplicate label %s, other instance in %s�duplicate label of equation %s, other instance in %s�duplicated ToC entry found: %s�enable %s extension�enable arbitrary extensions�encountered some issues with some of the inventories, but they had working alternatives:�encountered title node not in section, topic, table, admonition or sidebar�enum�enumerable_node %r already registered�enumerator�environment variable�environment variable; %s�error while formatting arguments for %s: %s�error writing file %s: %s�error writing file Makefile: %s�exception�exception while evaluating only directive expression: %s�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extension options�extensions changed�failed�failed to import object %s�failed to parse name %s�failed to reach any of the inventories with the following issues:�failed: %s�favicon file %r does not exist�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�filename of table of contents (default: modules)�finished with problems�fnmatch-style file and/or directory patterns to exclude from generation�follow symbolic links. Powerful when combined with collective.recipe.omelette.�function�general options�generate a full project with sphinx-quickstart�glossary term�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�highlighting module code... �html_extra_path entry %r does not exist�html_static_path entry %r does not exist�if specified, separate source and build dirs�ignoring invalid doctest code: %r�image file %s not readable: %s�image file not readable: %s�include "_private" modules�include links to the source code of documented Python objects�include math, rendered as PNG or SVG images�include math, rendered in the browser by MathJax�inconsistent citation references in translated message. original: {0}, translated: {1}�inconsistent footnote references in translated message. original: {0}, translated: {1}�inconsistent references in translated message. original: {0}, translated: {1}�inconsistent term references in translated message. original: {0}, translated: {1}�increase verbosity (can be repeated)�index�inline latex %r: %s�interpret module paths according to PEP-0420 implicit namespaces specification�intersphinx identifier %r is not string. Ignored�intersphinx inventory has moved: %s -> %s�invalid TestCode type�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�invalid regex %r in %s�invalid regex %r in coverage_c_regexes�invalid signature for auto%s (%r)�job number should be a positive number�keyword�kwargs for add_node() must be a (visit, depart) function tuple: %r=%r�last updated�line number spec is out of range(1-%d): %r�link between Sphinx documentation of different projects�lists all sections and subsections�loading intersphinx inventory from %s...�loading pickled environment�loading translations [%s]... �logo file %r does not exist�looking for now-outdated files... �macro�making output directory�master document name�maximum depth of submodules to show in the TOC (default: 4)�member�method�missing '+' or '-' in '%s' option.�missing attribute %s in object %s�module�module %s could not be imported: %s�modules�more than one target found for 'any' cross-reference %r: could be %s�more than one target found for cross-reference %r: %s�new config�next�next chapter�nit-picky mode, warn about all missing references�no "latex_documents" config value found; no documents will be written�no "man_pages" config value found; no manual pages will be written�no "texinfo_documents" config value found; no documents will be written�no Babel option known for language %r�no changes in version %s.�no code/output in %s block at %s:%s�no output at all, not even warnings�no output on stdout, just warnings on stderr�no targets are out of date.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�none found�not available for built-in messages�numfig is disabled. :numref: is ignored.�numfig_format is not defined for %s�object�operator�original entry�override a setting in configuration file�overwrite existing files�page�page %s matches two patterns in html_sidebars: %r and %r�pass a value into HTML templates�path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)�path to documentation source files�path to module to document�path to output directory�path where configuration file (conf.py) is located (default: same as SOURCEDIR)�pickling environment�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�program option�project author(s), used when --full is given�project name�project name (default: root module name)�project release, used when --full is given, defaults to --doc-version�project version, used when --full is given�put documentation for each module on its own page�put module documentation before submodule documentation�quick access to all modules�quiet mode�reST markup error:�reading error: %s, %s�reading sources... �reading templates... �reference label�release of project�replacement for dot in _templates etc.�resolving references...�role�role %r is already registered, it will be overridden�run Pdb on exception�run the script without creating files�search�search index couldn't be loaded, but not all documents will be built: the index will be incomplete.�search this documentation�see %s�see also %s�self referenced toctree found. Ignored.�setting %s.%s occurs in none of the searched theme configs�show full traceback on exception�signature arguments or return annotation given for automodule %s�skipped�source directory has changed�source file suffix�source files to generate rST files for�source_parser for %r is already registered�source_suffix %r is already registered�sphinx-quickstart only generate into a empty directory. Please specify a new root path.�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�statement�static method�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�targets for %d template files�template directory for template files�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�toctree contains ref to nonexisting file %r�toctree contains reference to document %r that doesn't have a title: no link will be generated�toctree contains reference to excluded document %r�toctree contains reference to nonexisting document %r�too large :maxdepth:, ignored.�turn warnings into errors�type�undecodable source characters, replacing with "?": %r�unimplemented node type: %r�union�unknown %r toplevel_sectioning for class %r�unknown config value %r in override, ignoring�unknown index entry type %r�unknown index entry type %s found�unknown mimetype for %s, ignoring�unknown node type: %r�unsupported theme option %r given�updating environment: �use epub�use make-mode for Makefile/make.bat�use no config file at all, only -D options�variable�version of project�waiting for workers...�while setting up extension %s:�write "todo" entries that can be shown or hidden on build�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing�writing %s file...�writing additional files�writing error: %s, %s�writing message catalogs... �writing output... �writing summary file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: el Language-Team: Greek (http://www.transifex.com/sphinx-doc/sphinx-1/language/el/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � Δημιουργία ReStrucuredText χρησιμοποιώντας τις οδηγίες autosummary. Το sphinx-autogen αποτελεί ένα πρόσθιο εργαλείο για το sphinx.ext.autosummary.generate. Δημιουργεί τα αρχεία reStructuredText από τις οδηγίες autosummary οι οποίες περιλαμβάνονται στα παραδοθέντα αρχεία εισόδου. Η μορφή της οδηγίας autosummary τεκμηρειώνεται στο δομοστοιχείο ``sphinx.ext.autosummary`` της Python και μπορεί να αναγνωστεί χρησιμοποιώντας το :: pydoc sphinx.ext.autosummary � Δημιουργία απαιτούμενων αρχείων για ένα έργο Sphinx. Το sphinx-quickstart είναι ένα διαδραστικό εργαλείο το οποίο κάνει κάποιες ερωτήσεις για το δικό σας έργο και μετά δημιουργεί έναν πλήρη κατάλογο τεκμηρίωσης και δείγμα Makefile για να χρησιμοποιηθεί με το sphinx-build. � Αναζητήστε αναδρομικα σε <MODULE_PATH>για δομοστοιχεία Python και πακέτα και δημιουργήστε ένα αρχείο reST με οδηγίες automodule για κάθε πακέτο στο <OUTPUT_PATH>. Τα <EXCLUDE_PATTERN>μπορεί να αποτελούν αρχεία ή/και σχέδια καταλόγων τα οποία θα εκτελεστούν κατά τη δημιουργία. Σημείωση: από προεπιλογή αυτό το σενάριο δεν θα αντικαταστήσει τα ήδη δημιουργημένα αρχεία.� Εκτελέστε 'make' σε αυτό τον κατάλογο για να εκτελέσετε αυτά μέσω του (pdf)latex (χρησιμοποιήστε το 'make latexpdf' εδώ για να το κάνετε αυτόματα).� Εκτελέστε 'make' σε αυτό τον κατάλογο για να εκτελέσετε αυτά μέσω του makeinfo (χρησιμοποιήστε το 'make info' εδώ για να το κάνετε αυτόματα).� (αποσύρθηκε)� (σε �"::" στο όνομα automodule δεν βγάζει νόημα�η τιμή παραμετροποίησης "latex_documents" κάνει αναφορά το άγνωστο κείμενο %s�η τιμή παραμετροποίησης "man_pages" κάνει αναφορά το άγνωστο κείμενο %s�καθορίστηκε το "quiet", αλλά δεν καθορίστηκε είτε το "project" είτε το "author".�η τιμή παραμετροποίησης "texninfo_documents" αναφέρεται σε άγνωστο κείμενο %s�%(filename)s — %(docstitle)s�%d %B %Y�βρέθηκε %d�τα αρχεία πηγής %d που δόθηκαν στη γραμμή εντολής�%s %s�Τεκμηρίωση του %s - %s�%s (ιδιότητα της %s)�%s (C++ %s)�%s (ενσωματωμένη κλάση)�%s (ενσωματωμένη μεταβλητή)�%s (κλάση σε %s)�%s (οδηγία)�%s (καθολική μεταβλητή ή σταθερά)�%s (στη μονάδα %s)�%s (μονάδα)�%s (ρόλος)�%s προστέθηκε, %s άλλαξε, %s απομακρύνθηκε�%s η εντολή %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για μαθηματική απεικόνιση), ελέγξτε τη ρύθμιση imgmath_%s�στο %s έχουν ήδη ανατεθεί αριθμοί τομέα (εμφωλιασμένο αριθμημένο toctree;)�το %s δεν είναι κατάλογος.�%s() (μέθοδος κλάσης της %s)�%s() (μέθοδος της %s)�%s() (στατική μέθοδος της %s)�%s() (ενσωματωμένη συνάρτηση)�%s() (κλάση)�%s() (στη μονάδα %s)�© <a href="%(path)s">Copyright</a>%(copyright)s�© Copyright %(copyright)s.�Η '%s δεν είναι μία έγκυρη επιλογή.�'%s' δεν αποτελεί μία έγκυρη επιλογή για pyversion�η 'παραμετροποίηση' σύμφωνα με τον τρέχοντα ορισμό στο conf.py δεν αποτελεί καλέσιμο. Παρακαλείσθε να τροποποιήσετε τον ορισμό ώστε να το κάνετε μία καλέσιμη συνάρτηση. Αυτό απαιτείται προκειμένου το conf.py να συμπεριφέρεται ως μία επέκταση Sphinx.�(Το <<original entry>> βρίσκεται στο %s, γραμή %d.)�(στη %s έκδοση %s)�(στο %s)�, στο �Το όρισμα -Α πρέπει να είναι της μορφής όνομα=τιμή�Το όρισμα -D πρέπει να είναι της μορφής όνομα=τιμέ�βρέθηκε ευρετήριο βασιζόμενο σε 4 στήλες. Μπορεί να αποτελεί σφάλμα της επέκτασης που χρησιμοποιείτε: %r�<<original entry>>�<h1>Όλες οι μονάδες για τις οποίες υπάρχει διαθέσιμος κώδικας</h1>�<h1>Πηγαίος κώδικας για το %s</h1>�Μία αναφορά σφάλματος μπορεί να υποβληθεί στον ινχηλάτη στο https://github.com/sphinx-doc/sphinx/issues>. Ευχαριστούμε!�Σχετικά με αυτά τα κείμενα�Ένα σφάλμα συνέβη κατά τη σύνθεση της σελίδας %s. Αιτία %r �Δεν βρέθηκε το anchor '%s'�Κανένα ID δεν έχει ανατεθεί στο κόμβο %s�Παράμετροι�Προσοχή�Όνομα(τα) συγγραφέα�Συντάκτης: �Αυτόματα παραγόμενη λίστα αλλαγών στην έκδοση %(version)s�Βάσεις: %s�Ο μεταγλωττιστής %r υφίσταται ήδη (στο δομοστοιχείο %s)�Η κλάση μεταγλώττισης %s δεν έχει χαρακτηριστικό "name" �Το όνομα μεταγλωττιστή %sδεν είναι καταχορημένο�Το όνομα μεταγλωττιστή %s δεν είναι καταχωρημένο ή διαθέσιμο δια μέσου του σημείου εισαγωγής�Ενσωματωμένες λειτουργίες�Αλλαγές στο API της C�Δεν είναι δυνατή η εύρεση του καταλόγου πηγής (%s)�Δεν είναι δυνατή η χρήση "leneno-match" με ένα κομματιασμένο σετ απο "lines"�Δεν είναι δυνατή η ταυτόχρονη χρήση των επιλογών "%s" και "%s"�Προσοχή�Άλλαξε στην έκδοση %s�Αλλαγές στην Έκδοση %(version)s —' %(docstitle)s�Η παραπομπή [%s] δεν αναφέρεται.�Συντάκτης κώδικα: �Κλείσιμο πλαϊνής μπάρας�Πλήρης Πίνακας Περιεχομένων�Η τιμή παραμετροποίησης %r υφίσταται ήδη.�Περιεχόμενα�Copyright�Δεν ήταν δυνατή η λήψη απομακρυσμένης εικόνας: %s [%d]�Δεν ήταν δυνατή η λήψη απομακρυσμένης εικόνας: %s [%s]�Δεν ήταν δυνατή η εισαγωγή της επέκτασης %s�Δεν είναι δυνατό το lex του literal_block ως %s. Η επισήμανση παραβλέφθηκε.�Δεν ήταν δυνατή η λήψη του μεγέθους της εικόνας. Η επιλογή :scale: θα αγνοηθεί.�Δημιουργία Makefile; (y/n)�Δημιουργία αρχείου εντολών Windows; (y/n)�Δημιουργία αρχείου %s.�Κίνδυνος�Αποσύρθηκε�Αποσύρθηκε στην έκδοση %s�Ο τομέας %r δεν είναι καταχωρημένος�Η κωδικοποίηση %r που χρησιμοποιήθηκε για την ανάγνωση του συμπεριληφθέντος αρχείου %r φαίνεται να είναι λανθασμένη, προσπαθήστε να δώσετε μία επιλογή :encoding:�Σφάλμα κωδικοποίησης:�Σφάλμα�Σφάλμα: ένα υπάρχον conf.py έχει βρεθεί στοn επιλεγμένο ριζικό κατάλογο.�Σφάλμα: το καθορισθέν μονοπάτι δεν είναι κατάλογος, ή τα αρχεία sphinx υπάρχουν ήδη.�Σφάλμα: το κύριο αρχείο %s έχει ήδη βρεθεί στο επιλεγμένο ριζικό κατάλογο.�Το συμβάν %r υπάρχει ήδη�Παράδειγμα�Παραδείγματα�Παρουσιάστηκε εξαίρεση κατά τη μεταγλώττιση, εκκίνηση αποσφαλματιστή: �Εμφανίστηκε εξαίρεση:�Άνοιγμα πλαϊνής μπάρας�Επιλογές επέκτασης�Το εξωτερικό αρχείο Graphviz %r δεν βρέθηκε ή απέτυχε η ανάγνωσή του�Αδυναμία ανάγνωσης αρχείου πληροφοριών μεταγλώττισης: %r�Αδυναμία σάρωσης εγγράφων σε %s: %r�Αδυναμία εγγραφής του αρχείου πληροφοριών μεταγλώττισης: %r�Εικ. %s�Το αρχείο %s υπάρχει ήδη, παραλείπεται.�Ολοκλήρωση: μία αρχική δομή καταλόγου δημιουργήθηκε.�Η υποσημείωση [#] δεν αναφέρεται.�Δεν υπάρχει αναφορά για την υποσημείωση [%s].�Σημειώσεις υποσέλιδου�Πλήρες ευρετήριο σε μία σελίδα�Κεντρικό Ευρετήριοο�Καθολικό Ευρετήριο Μονάδων�Πάμε�Η οδηγία Graphviz δεν είναι δυνατό να περιλαμβάνει και περιεχόμενο και ένα όρισμα ονόματος αρχείου�Απόκρυψη Ευρεθέντων Αναζητήσεων�Συμβουλή�Η οδηγία χωρίς περιεχόμενο "graphviz" θα αγνοηθεί.�Σημαντικό�Το συμπεριληφθέν αρχείο %r δεν βρέθηκε ή απέτυχε η ανάγνωσή του�Ευρετήριο�Ευρετήριο – %(key)s�Σελίδες ευρετηρίου ανά γράμμα�Υποδείξτε ποιά απο τις ακόλουθες επεκτάσεις Sphinx πρέπει να ενεργοποιηθούν:�Ευρετήρια και πίνακες:�Ανέγκυρη λεζάντα: %s�Ανέγκυρος τύπος ημερομηνίας. Τοποθετείστε στη στοιχειοσειρά μονά εισαγωγικά εάν θέλετε να το εξάγετε απευθείας: %s�Ανέγκυρο math_eqref_format: %r�Ανέγκυρη μεταβλητή προτύπου: %s�Ορίσματα λέξης-κλειδί�Η εντολή LaTex %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για απεικόνιση μαθηματικών), ελέγξτε τη ρύθμιση imgmath_latex�Τελευταία ενημέρωση στις %(last_updated)s.�Αλλαγές βιβλιοθήκης�Προσδιορισμός γραμμής %r: δεν ελήφθησαν γραμμές από το συμπεριληφθέν αρχείο %r�Λίστα %s�Αναζητήστε οποιαδήποτε λάθη στο παραπάνω αποτέλεσμα ή σε %(outdir)s/output.txt�Δημιουργία Makefile και Batchfile�Λανθασμένη περιγραφή επιλογής %r, θα πρέπει να μοιάζει με "opt", "-opt args", "--opt args", "/opt args" ή "+opt args"�Πολλά math_renderers έχουν καταγραφεί. Αλλά δεν έχει επιλεγεί κανένα math_renderer.�Ευρετήριο μονάδων�Συντάκτης μονάδας: �Κώδικας μονάδας�Επίπεδο μονάδας λειτουργίας�Όνομα του κυρίους σας εγγράφου (χωρίς επέκταση)�Πρόθεμα ονόματος για πρότυπα και στατικούς καταλόγους�Πλοήγηση�Νέο στην έκδοση %s�Επόμενο θέμα�Δεν επιλέχθηκε μεταγλωττιστής, θα χρησιμοποιηθεί ο προεπιλεγμένος: html�Δεν υπάρχει τέτοια τιμή παραμετροποίησης: %s�μη-αλφαβιτικά�Σημείωση�Σημείωση: τα imgmath και mathjax δεν είναι δυνατό να ενεργοποιηθούν ταυτόχρονα. Το imgmath έχει αποεπιλεγθεί. �Σημειώσεις�Αριιθμοί�Το αντικείμενο με όνομα %r δεν βρέθηκε στο συμπεριληφθέν αρχείο %r�Αρχική εξαίρεση: �Άλλες παράμετροι�Άλλες αλλαγές�Επισκόπηση�Επισκόπηση: κώδικας της μονάδας�Παράμετροι�Απευθείας σύνδεσμος σε αυτόν τον κώδικα�Μόνιμος σύνδεσμος σε αυτόν τον ορισμό�Μόνιμος σύνδεσμος σε αυτή την εξίσωση�Μόνιμος σύνδεσμος σε αυτήν την κεφαλίδα�Απευθείας σύνδεσμος σε αυτήν την εικόνα�Απευθείας σύνδεσμος σε αυτόν τον πίνακα�Απευθείας σύνδεσμος σε αυτόν τον πίνακα περιεχομένων�Το pillow δεν βρέθηκε - αντιγραφή αρχείων εικόνας�Παρακαλώ, ενεργοποιήστε τη JavaScript για να είναι δυνατή η λειτουργία αναζήτησης.�Παρακαλείστε να το αναφέρετε αν ήταν ένα σφάλμα χρήσης, ώστε ένα καλύτερο μήνυμα σφάλματος να δοθεί την επόμενη φορά.�Παρακαλείστε να εισάγετε μία επέκταση αρχείου, π.χ. '.rst' ή '.txt'.�Παρακαλείσθε να εισάγετε ένα νέο όνομα αρχείου, ή να μεταονομάσετε το υπάρχον αρχείο και να πιέσετε το Enter�Παρακαλείστε να εισάγετε ένα νέο ριζικό μονοπάτι (ή απλά πιέστε το Enter για έξοδο)�Παρακαλείστε να εισάγετε ένα έγκυρο όνομα μονοπατιού.�Παρακαλείστε να εισάγετε είτε 'y' είτε 'n'.�Παρακαλείστε να εισάγετε ένα από τα %s.�Παρακαλείστε να εισάγετε κάποιο κείμενο.�Προετοιμασία αναζήτησης...�Προηγούμενο θέμα�Βασικές επιλογές έργου�Γλώσσα έργου�Όνομα έργου�Κυκλοφορία έργου�Προτυποποίηση έργου�Έκδοση έργου�Το όνομα %r δεν είναι γνωστό�Python Enhancement Proposals; PEP %s�Ευρετήριο Μονάδων της Python�Σύντομη αναζήτηση�Προκαλεί�Σφάλμα αναδρομής:�Αναφορές�Δημοσίευση�Επιστρεφόμενος τύπος�Επιστρέφει�Ριζικό μονοπάτι για την τεκμηρίωση�Εκτέλεση Sphinx έκδοση %s�Αναζήτηση�Αναζήτηση %(docstitle)s�Σελίδα αναζήτησης�Αποτελέσματα Αναζήτησης�Η αναζήτηση ολοκληρώθηκε, βρέθηκε/αν %s σελίδα/ες με βάση τους όρους αναζήτησης.�Αναζήτηση στο %(docstitle)s�Εκτελείται η αναζήτηση�Τομέας %s�Συντάκτης τμήματος: �Δείτε επίσης�Ξεχωριστοί κατάλογοι για πηγή και μεταγλώττιση (y/n)�Προβολή κώδικα�Ο κατάλογος πηγής και ο κατάλογος προορισμού δεν είναι δυνατό να είναι ίδιοι�Επέκταση αρχείου πηγής�Ο αναλυτής πηγής για το %s δεν είναι καταχωρημένος�Επιλογές δομής�Σύμβολα�βρέθηκε εγγραφή TODO:%s�Πίνακας %s�Πίνακας περιεχομένων�Παράμετροι Προτύπου�Η δοκιμή της κάλυψης στις πηγές ολοκληρώθηκε, δείτε τα αποτελέσματα στο %(outdir)s python.txt.�Ολοκληρώθηκε η δοκιμή των doctests στις πηγές, δείτε τα αποτελέσματα σε %(outdir)s/output.txt.�Το crossref_type %r είναι ήδη καταχωρημένο�Η οδηγία %r είναι ήδη καταχωρημένη στον τομέα %s�Ο δείκτης %r είναι ήδη καταχωρημένος στον τομέα %s�Το object_type %r είναι ήδη καταχωρημένο�Ο ρόλος %r είναι ήδη καταχωρημένος στον τομέα %s�Η επέκταση %s απαιτείται από τις ρυθμίσεις needs_extensions, αλλά δεν είναι φορτωμένη.�Η επέκταση %s η οποία χρησιμοποιείται από αυτό το έργο απαιτεί Sphinx έκδοσης τουλάχιστον %s: επομένως δεν είναι δυνατή η μεταγλώττιση με αυτή την έκδοση.�Η σελίδα HTML είναι στο %(outdir)s.�Οι σελίδες HTML βρίσκονται σε %(outdir)s.�Τα αρχεία LaTeX βρίσκονται σε %(outdir)s.�Τα αρχεία Texinfo βρίσκονται σε %(outdir)s.�Τα αρχεία XML βρίσκονται σε %(outdir)s.�Η τιμή παραμτετροποίησης 'source_suffix' αναμένει στοιχειοσειρά, στοιχειοσειρά καταλόγου, ή λεξικό. Αλλά παραδόθηκε %r.�Η τιμή παραμετροποίησης '{name}' έχει τύπο '{current__name__}', αρχικοποίηση σε '{default__name__}'.�Η τιμή παραμετροποίησης '{name]' έχει τύπο '[current__name__}'; αναμενόμενη {permitted}.�Η τιμή παραμετροποίησης '{name}' πρέπει να λαμβάνει μία από τις {candidates} αλλά εκχωρήθηκε η '{current}'.�Το αρχείο παραμετροποίησης (ή ένα από τα στοιχεία που εισάγει) κάλεσε την sys.exit()�Ο προσωρινός μεταγλωττιστής δεν δημιουργεί αρχεία.�Το αρχείο ePub βρίσκεται σε %(outdir)s.�Το πλήρες ιστορικό έχει αποθηκευτεί σε %s, σε περίπτωση που επιθυμείτε να αναφέρετε το ζήτημα στους προγραμματιστές.�Οι σελίδες manual βρίσκονται σε %(outdir)s.�Οι κατάλογοι των μηνυμάτων είναι στο %(outdir)s.�Το αρχείο επισκόπησης είναι σε %(outdir)s.�Τα αρχεία XML βρίσκονται σε %(outdir)s.�Τα αρχεία κειένου βρίσκονται σε %(outdir)s.�Υπάρχει ένα προγραμματιστικό λάθος στο αρχείο παραμετροποίησής σας: %s�Υπάρχει ένα συντακτικό λάθος στο αρχείο παραμετροποίησής σας: %s �Αυτή η σελίδα�Το περιβάλλον δεν είναι συμβατό με τον επιλεγμένο μεταγλωττιστή, παρακαλείστε να επιλέξετε ένα διαφορετικό κατάλογο toctree.�Αυτό το έργο απαιτεί Sphinx έκδοσης τουλάχιστον %s και επομένως δεν είναι δυνατή η μεταγλωτισση με αυτή την έκδοση.�Το έργο χρειάζεται την επέκταση %s τουλάχιστον στην έκδοση %s και επομένως δεν είναι δυνατή η μεταγλώττιση με τη φορτωμένη έκδοση (%s).�Προκαλεί�Πρακτική συμβουλή�Εκκρεμότητα�Ο μεταφραστής για το %r υφίσταται ήδη�Άγνωστο όνομα συμβάντος: %s�Άγνωστος τύπος αρχείου: %s...�Δόθηκε άγνωστο math_renderer %r.�Μεταβλητές�Προειδοποίηση�Προειδοποιήσεις�Καλώς ήρθατε στο εργαλείο γρήγορης εκκίνησης Sphinx %s.�Καλωσήρθατε! Αυτή είναι�Θα δημιουργούσε το αρχείο %s.�Αποδόσεις�Η αναζήτησή σας δεν ταυτοποιήθηκε με κανένα κείμενο. Παρακαλώ, επιβεβαιώστε ότι όλες οι λέξεις έχουν τη σωστή ορθογραφία και ότι έχετε επιλέξεις αρκετές κατηγορίες.�[autosummary] δημιουργία autosummary για: %s�[αυτόματη περίληψη] εγγραφή στο %s�[τεκμηρίωση]�[γράφημα: %s]�[γράφημα]�[εικόνα: %s]�[εικόνα]�[πηγή]�__all__ πρέπει να είναι λίστα στοιχειοσειράς, όχι %r (στο δομοστοιχείο %s) -- θα αγνοηθεί το __all__�ένα σφάλμα Unicode παρουσιάστηκε κατά τη δημιουργία της σελίδας %s. Παρακαλείστε να επιβεβαιώσετε ότι όλες οι τιμές παραμετροποίησης οι οποίες περιλαμβάνουν μη-ASCII περιεχόμενο είναι στοιχειοσειρές Unicode.�μία λίστα με συγκεκριμένα αρχεία να επαναμεταγλωττιστούν. Θα αγνοηθεί αν δοθεί το -a�δεν βρέθηκε μία κατάλληλη εικόνα για τον μεταγλωττιστή %s: %s�δεν βρέθηκε μία κατάλληλη εικόνα για τον μεταγλωττιστή %s: %s (%s)�όλες οι συναρτήσεις, κλάσεις, όροι�όλα τα αρχεία po του %d�όλα τα αρχεία πηγής�η προσθήκη του module_path στο sys.path, χρησιμοποιείται όταν δίδεται το --full�συναρμολόγηση απλού κειμένου�ιδιότητα�ονόματα συγγραφέων�αυτόματη εισαγωγή docstrings από τα δομοστοιχεία�αυτόματα κομμάτια δοκιμαστικού κώδικα σε τμήματα doctest�Το autosummary δημιουργεί αρχεία .rst εσωτερικά. Αλλά το δικό σας source_suffix δεν περιλαμβάνει .rst. Θα παραλειφθεί.�τόσο η επιλογή για tabularcolumns όσο και για :widths: δίνονται. Η επιλογή :widths: θα αγνοηθεί.�λανθασμένος σύνδεσμος: %s (%s)�μεταγλώττιση %s, %s προειδοποίηση�μεταγλώττιση %s.�η έκδοση του περιβάλλοντος μεταλώττισης δεν είναι η τρέχουσα�παράλληλος μεταγλωττισμός με Ν διεργασίες όπου είναι δυνατό (ιδιαίτερη τιμή "auto" θα ορίσει Ν στο cpu-count)�το αρχείο πληροφοριών μεταγλώττισης είναι κατεστραμμένο: %r�μεταγλωττιστής για χρήση (προεπιλογή: html)�μεταγλώττιση [%s]:�μεταγλώττιση [mo]:�ενσωματωμένη συνάρτηση�μπορεί να είναι τεράστιο�δεν γίνεται συνδιασμός της επιλογής -a και των ονομάτων αρχείων�δεν είναι δυνατή η αντιγραφή του μεταφορτωμένου αρχείου %r: %s�δεν είναι δυνατή η αντιγραφή του επιπλέον αρχείου %r�δεν είναι δυνατή η αντιγραφή αρχείου εικόνας %r: %s�δεν είναι δυνατή η αντιγραφή στατικού αρχείου %r�δεν είναι δυνατή η εύρεση αρχείων %r�δεν είναι δυνατό το άνοιγμα του αρχείου προειδοποίησης %r: %s�δεν είναι δυνατή η υπερσκέλιση της ρύθμισης παραμετροποίησης %r με τύπο ο οποίος δεν υποστηρίζεται, θα αγνοηθεί�δεν είναι δυνατή η υπερσκέλιση της ρύθμισης παραμετροποίησης καταλόγου %r, θα αγνοηθεί (χρησιμοποιήστε το %r για να καθορίσετε τα επιμέρους στοιχεία)�δεν είναι δυνατή η ανάγωνση αρχείου εικόνας %r: αντί αυτού θα αντιγραφεί�δεν είναι δυνατή η εγγραφή αρχείου %r: %s�η λεζάντα δεν βρίσκεται εντός μίας εικόνας.�έλεγχος συνοχής�αναζήτηση για κάλυψη βιβλιογραφίας�αναγνωρίστηκαν κυκλικές αναφορές toctree, θα αγνοηθούν: %s <- %s�κλάση�μέθοδος της κλάσης�έννοια�υποθετική εισαγωγή περιεχομένου βασισμένη στις τιμές παραμετροποίησης�η τιμή παραμετροποίησης "epub_author" δεν πρέπει να είναι κενή για EPUB3�η τιμή παραμετροποίησης "epub_contributor" δεν πρέπει να είναι κενή για EPUB3�η τιμή παραμετροποίησης "epub_copyright" (ή "copyright") δεν πρέπει να είναι κενή για EPUB3�η τιμή παραμετροποίησης "epub_description" δεν πρέπει να είναι κενή για EPUB3�η τιμή παραμετροποίησης "epub_identifier" δεν πρέπει να είναι κενή για EPUB3�η τιμή παραμετροποίησης "epub_language" (ή "language") δεν πρέπει να είναι κενή για EPUB3�η τιμή παραμετροποίησης "epub_publisher" δεν πρέπει να είναι κενή για EPUB3�η τιμή παραμετροποίησης "epub_title" (ή "html_title") δεν πρέπει να είναι κενή για EPUB3�η τιμή παραμετροποίησης "epub_uid" πρέπει να είναι XML NAME για EPUB3�η τιμή παραμετροποίησης "version" δεν πρέπει να είναι κενή για EPUB3�η παραμετροποίηση άλλαξε�ο κατάλογος παραμετροποίησης δεν περιλαμβάνει κανένα αρχείο conf.py (%s)�επιλογές εξόδου κονσόλας�συνεχίζεται από την προηγούμενη σελίδα�συνέχεια στην επόμενη σελίδα�η μετατροπή ολοκλήρωσε με σφάλμα:[stderr] %r [stdout] %r�αντιγραφή αρχείων υποστήριξης TeX�αντιγραφή αρχείων υποστήριξης TeX...�αντιγραφή αρχείων υποστήριξης Texinfo�αντιγραφή επιπρόσθετων αρχείων�αντιγραφή αρχείων μεταφόρτωσης...�αντιγραφή εικόνων...�αντιγραφή αρχείων πηγής...�δεν ήταν δυνατή η ανάγνωση %r για τη δημιουργία changelog�δημιουργία αρχείου .nojekyll για έκδοση του εγγράφου στις σελίδες GitHub �δημιουργία batchfile�δημιουργία makefile�προσαρμοσμένος κατάλογος προτύπου (προεπιλογή: %(default)s)�δεδομένα�ο προεπιλεγμένος ρόλος %s δεν βρέθηκε�προεπιλεγμένη επέκταση για αρχεία (προεπιλογή: %(default)s)�ορίστε μία τιμή προτύπου�ορίστε ετικέτα: συμπεριλάβατε "only" τμήματα με TAG�η μονάδα διάστασης %s δεν είναι έγκυρη. Θα αγνοηθεί.�οδηγία�η οδηγία %r έει ήδη καταχωρηθεί, θα υπερσκελιστεί�κατάλογο για τοποθέτηση όλων των προϊόντων�ο κατάλογος που θα τοποθετεί όλο το αποτέλεσμα εξόδου�απεικόνιση latex %r: %s�να γίνεται εκπομπή χρωματιστής εξόδου (προεπιλογή: auto-detect)�να μη δημιουργηθεί batchfile�να μη δημιουργηθεί makefile�να μην παρουσιάζεται έγχρωμο αποτέλεσμα (προεπιλογή: αυτόματη αναγνώριση)�μην χρησιμοποιείτε make-mode για Makefile/make.bat�docname προς εγγραφή: %s�έγγραφο�μέλη εισαγμένα στο έγγραφο (προεπιλογή: %(default)s)�το έγγραφο δεν συμπεριλαμβάνεται σε κανένα toctree�γλώσσα εγγράφου�το έγγραφο δεν είναι αναγνωσιμό. Θα αγνοηθεί.�ο τίτλος του εγγράφου δεν είναι μονός κόμβος κειμένου�εκτέλεση σειριακής %s�ο τομέας %s είναι ήδη καταχωρημένος�ο τομέας %s δεν έχει καταχωρηθεί ακόμη�να μη δημιουργηθεί αρχείο με πίνακα περιεχομένων�μη δημιουργείτε κεφαλίδες για πακέτα δομοστοιχείων/πακέτων (π.χ. όταν τα docstrings τα περιλαμβάνουν ήδη)�δεν γνωρίζω ποιο δομοστοιχείο να εισάγω για αυτόματη τεκμηρίωση %r (προσπαθήστε να τοποθετήσετε μία οδηγία "module" ή "currentmodule" στο έγγραφο, ή να δώσετε ένα σαφές όνομα δομοστοιχείου)�μην χρησιμοποιείτε ένα αποθηκευμένο περιβάλλον, πάντα να διαβάζετε όλα τα αρχεία�ολοκλήρωση�κωδικός dot %r: %s�η εντολή dot %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για αποτέλεσμα graphviz), ελέγξτε τη ρύθμιση graphviz_dot�το dot δεν παρήγαγε κανένα αρχείο εξόδου: [stderr] %r [stdout] %r�το dot ολοκλήρωσε με σφάλμα: [stderr] %r [stdout] %r�το μεταφορτωμένο αρχείο δεν είναι αναγνώσιμο: %s�διπλότυπη ετικέτα %s, άλλη εμφάνιση στο %s�διπλότυπη ετικέτα %s, άλλη εμφάνιση στο %s�διπλότυπη ετικέτα της εξίσωσης %s, άλλη εμφάνιση στο %s�βρέθηκε διπλότυπη εγγραφή ToC: %s�ενεργοποίηση της επέκτασης %s�ενεργοποίηση αυθαίρετων επεκτάσεων�παρουσιάστηκαν κάποια ζητήματα με μερικά απο τα αποθέματα, αλλά υπήρξαν λειτουργικές εναλλακτικές:�ο ανακαλυφθέν τίτλος κόμβος δεν βρίσκεται σε τομέα, θέμα, πίνακα, προειδοποίηση ή πλαϊνή μπάρα�enum�το enumerable_node %r είναι ήδη καταχωρημένο�enumerator�μεταβλητή περιβάλλοντος�μεταβλητή περιβάλλοντος; %s�σφάλμα κατά τη μορφοποίηση των ορισμάτων για %s:%s�σφάλμα καταγραφής αρχείου %s: %s�σφάλμα κατά την εγγραφή του αρχείου Makefile: %s�εξαίρεση�εξαίρεση κατά την αξιολόγηση μόνο της έκφρασης οδηγίας: %s�η επέκταση %r δεν έχει συνάρτηση setup(); αποτελεί δομοστοιχείο επέκτασης του Sphinx;�η επέκταση %r επιστρέφει ένα μη υποστηριζόμενο αντικείμενο από τη συνάρτησή της setup(): θα έπρεπε να επιστρέφει None ή έναν κατάλογο μεταδεδομένων�επιλογές επέκτασης�αλλαγμένες επεκτάσεις�αποτυχία�αδυναμία εισαγωγής αντικειμένου %s�αδυναμία ανάλυσης ονόματος %s�αδυναμία προσέγγισης οποιασδήποτε αποθήκης με τα ακόλουθα ζητήματα:�αποτυχία: %s�το αρχείο favicon %r δεν υπάρχει�το αρχείο %r που δόθηκε στη γραμμή εντολής δεν υπάρχει, θα αγνοηθεί�το αρχείο %r που δόθηκε στη γραμμή εντολής δεν βρίσκεται κάτω από τον κατάλογο πηγής, θα αγνοηθεί�το αρχείο %r στο μονοπάτι θέματος δεν αποτελεί ένα έγκυρο zipfile ή δεν περιλαμβάνει ένα θέμα�επέκταση αρχείου (προεπιλογή: rst)�όνομα αρχείου του πίνακα περιεχομένων (προεπιλογή: δομοστοιχεία)�ολοκλήρωση με προβλήματα�αρχεία fnmatch-style και/ή υποδείγματα καταλόγου που θα εξαιρεθούν από τη δημιουργία�ακολουθία συμβολικών συνδέσμων. Ισχυρό όταν συνδυάζεται με το collective.recipe.omelette.�συνάρτηση�γενικές επιλογές�δημιουργία ενός πλήρους έργου με το sphinx-quickstart�γλωσσάρι�γραμματική ένδειξη�Το graphviz_output_format πρέπει να είναι ένα από τα 'png', 'svg', αλλά είναι %r�επισήμανση κώδικα δομοστοιχείου...�Η εγγραφή html_extra_path %r δεν υπάρχει�η εγγραφή html_static_path %r δεν υπάρχει�αν ορίζεται, θα ξεχωρίσουν οι κατάλογοι πηγής και μεταγλώττισης�Ο ανέγκυρος κώδικας doctest θα αγνοηθεί: %r�το αρχείο εικόνας %s δεν είναι αναγνώσιμο: %s�το αρχείο εικόνας δεν είναι αναγνώσιμο: %s�να συμπεριληφθούν τα δομοστοιχεία "_private"�να συμπεριληφθούν σύνδεσμοι στον πηγαίο κώδικα των τεκμηριωμένων αντικειμένων Python�να συμπεριληφθεί το math, απεικονισμένο ως εικόνες PNG η SVG�να συμπεριληφθεί το math, απεικονισμένο στο φυλλομετρηρή απο το MathJax�ασυνεπείς αναφορές παραπομπής στο μεταφρασμένο μήνυμα. αρχικό: {0}, μεταφρασμένο: {1}�ασυνεπείς αναφορές υποσημείωσης στα μεταφρασμένα μηνύματα. original: {0}, translated: {1}�ασυνεπείς αναφορές στα μεταφρασμένα μηνύματα. αρχικό: {0}, μεταφρασμένο: {1}�ασυνεπείς αναφορές όρων στα μεταφρασμένα μηνύματα. αρχικό: {0}, μεταφρασμένο: {1}�αυξήστε τον βερμπαλισμό (μπορεί να επαναληφθεί)�ευρετήριο�σε σειρά latex %r: %s�ερμηνεία μονοπατιών δομοστοιχείων σύμφωνα με την προδιαγραφή POP-0420 αυτονόητων namespaces�το αναγνωριστικό intersphinx %r δεν είναι στοιχειοσειρά. Θα αγνοηθεί�το απόθεμα intersphinx έχει μεταφερθεί: %s->%s�ανέγκυρος τύπος TestCode�ανέγκυρο css_file: %r, θα αγνοηθεί�ανέγκυρο js_file: %r, θα αγνοηθεί�ανέγκυρος αριθμός %r για τιμή παραμετροποίησης %r, θα αγνοηθεί�ανέγκυρο numfig_format: %s�ανέγκυρο numfig_format: %s (%r)�ανέγκυρο regex %r σε %s�ανέγκυρο regex %r στο coverage_c_regexes�ανέγκυρη υπογραφή για αυτόματο %s (%r)�ο αριθμός εργασίας θα πρέπει να είναι θετικός αριθμός�λέξη κλειδί�το kwargs για το add_node() πρέπει να είναι μία (visit, depart) συνάρτηση πλειάδας: %r=%r�τελευταία ενημέρωση�η προδιαγραφή αριθμού σειράς είναι εκτός e;yroyw (1-%d): %r�σύνδεσμος μεταξύ τεκμηρίωσης Sphinx διαφόρων έργων�απαριθμεί όλα τα κεφάλαια και υποκεφάλαια�φότωση του αποθέματος intersphinx από %s...�φόρτωση πακτωμένου περιβάλλοντος�φόρτωση μεταφράσεων [%s]...�το αρχείο logo %r δεν υπάρχει�αναζήτηση για νεοξεπερασμένα αρχεία...�μακροεντολή�δημιουργία καταλόγου εξόδου�κύριο όνομα εγγράφου�μέγιστο βάθος από υποδομοστοιχεία για απεικόνιση στο TOC (προεπιλογή: 4)�μέλος�μέθοδος�λείπει '+' ή '-' στην επιλογή '%s'.�απουσιάζει το χαρακτηριστικό %s στο αντικείμενο %s�μονάδα�το δομοστοιχείο %s δεν ήταν δυνατό να εισαχθεί: %s�μονάδες�περισσότεροι από ένας στόχοι βρέθηκαν για 'οποιαδήποτε' παραπομπή %r: θα μπορούσε να είναι %s�περισσότεροι από έναν στόχοι βρέθηκα για την παραπομπή %r: %s�νέα παραμετροποίηση�επόμενο�επόμενο κεφάλαιο�Ο τρόπος nit-picky, προειδοποιεί για όλες τις αναφορές που απουσιάζουν�δεν βρέθηκε τιμή παραμετροποίησης "latex_documents": δεν θα πραγματοποιηθεί εγγραφή για κανένα κείμενο�δεν βρέθηκε τιμή παραμετροποίησης "man_pages"; δεν θα καταγραφούν manual pages�δεν βρέθηκε τιμή "texinfo_documents": δεν θα γίνει εγγραφή κανενός κειμένου�καμία γνωστή επιλογή Babel για τη γλώσσα %r�καμία αλλαγή στην έκδοση %s.�δεν υπάρχει κώδικας/αποτέλεσμα στο τμήμα %s στο %s:%s�κανένα αποτέλεσμα ούτε προειδοποιήσεις�καμία έξοδος στο stdout, μόνο προειδοποιήσεις στο stderr�κανένας στόχος δεν είναι ξεπερασμένος.�δεν βρέθηκε θέμα με όνομα %r (απουσιάζει το theme.conf;)�δεν βρέθηκε θέμα με το όνομα %r, το οποίο κληρονομήθηκε από το %r�η κλάση κόμβου %r έχει ήδη καταχωρηθεί, οι επισκέπτες της θα υπερσκελιστούν�δεν βρέθηκε κανένα�δεν είναι διαθέσιμο για εσωτερικά μηνύματα�το numfig έχει απενεργοποιηθεί. Το :numref: θα ανγοηθεί.�δεν έχει καθοριστεί numfig_format για το %s�αντικείμενο�τελεστής�αρχική εγγραφή�παράκαμψη ρύθμισης στο αρχείο παραμετροποίησης�αντικατάσταση υπάρχοντων αρχείων�σελίδα�η σελιδα %s ταιριάζει δύο σχέδια στo html_sidebars: %r and %r�μεταφορά τιμής στα πρότυπα HTML�μονοπάτι για το αποθηκευμένο περιβάλλον και τα αρχεία doctree (προεπιλογή: OUTPUTDIR/.doctrees)�μονοπάτι για τα αρχεία πηγής τεκμηρίωσης�μονοπάτι για το δομοστοιχείο για το έγγραφο�μονοπάτι στον κατάλογο εξόδου�το μονοπάτι όπου βρίσκεται το αρχείο παραμετροποίησης (conf.py) (προεπιλογή: το ίδιο όπως το SOURCEDIR)�Περιβάλλον μετατροπής αντικειμένων Python σε ροή bytes�προετοιμασία κειμένων�προηγούμενο�προηγούμενο κεφάλαιο�το primary_domain %r δεν βρέθηκε, θα αγνοηθεί.�επεξεργασία %s�επιλογή προγράμματος�συγγραφέας(εις) έργου, χρησιμοποιείται όταν δίδεται το --full�όνομα έργου�όνομα έργου (προεπιλογή: όνομα ριζικού δομοστοιχείου)�έκδοση έργου, χρησιμοποιείται όταν δίδεται το --full, προεπιλογή σε --doc-version�έκδοση έργου, χρησιμοποιείται όταν δίνεται το --full�τοποθετήστε βιβλιογραφία για κάθε δομοστοιχείο στη δικής της σελίδα�τοποθέτηση βιβλιογραφίας δομοστοιχείου πριν από την βιβλιογραφία υπόδομοστοιχείου�γρήγορη πρόσβαση σε όλες τις μονάδες�ήσυχος τρόπος�σφάλμα reST markup:�σφάλμα ανάγνωσης: %s, %s�ανάγνωση πηγών...�ανάγνωση προτύπων...�ετικέτα αναφοράς�δημοσίευση του έργου�αντικατάσταση για τελεία σε _templates κλπ.�επίλυση αναφορών...�ρόλος�ο ρόλος %r έχει ήδη καταχωρηθεί, θα υπερσκελιστεί�εκτέλεση Pdb σε περίπτωση εξαίρεσης�εκτελέστε το σενάριο χωρίς τη δημιουργία αρχείων�αναζήτηση�ο κατάλογος εύρεσης δεν ήταν δυνατό να φορτωθεί, αλλά δε θα μεταγλωττιστούν όλα τα έγγραφα: ο κατάλογος δε θα είναι πλήρης.�αναζήτηση αυτής της τεκμηρίωσης�δείτε %s�δείτε επίσης %s�Βρέθηκε αυτοαναφερόμενο toctree. Θα αγνοηθεί.�η ρύθμιση %s.%s δεν εμφανίζεται από τις παραμετροποιήσεις θέματος που αναζητήθηκαν�απεικόνιση πλήρους ιστορικού σε περίπτωση εξαίρεσης�ορίσματα υπογραφής ή επιστροφή σημείωσης η οποία δόθηκε για το automodule %s�παράβλεψη�ο πηγαίος κατάλογος έχει αλλάξει�επέκταση αρχείου πηγής�αρχεία πηγής για να δημιουργηθούν τα αρχεία reST�το source_parser για το %r είναι ήδη καταχωρημένο�το source_suffix %r είναι ήδη καταχωρημένο�Το sphinx-quickstart δημιουργεί μόνο εντός ενός κενού καταλόγου. Παρακαλείσθε να καθορίσετε ένα νέο ριζικό μονοπάτι.�το sphinx-quickstart δεν θα αντικαταστήσει υπάρχοντα έργα Sphinx.�το sphinx-quickstart δεν θα αντικαταστήσει υπάρχοντα αρχεία.�δήλωση�στατική μέθοδος�επιτυχία�στόχοι για τα αρχεία po του %d τα οποία είναι ξεπερασμένα�στόχοι για τα αρχεία po του %d οι οποίοι έχουν καθοριστεί�στόχοι για τα αρχεία πηγής %d τα οποία είναι ξεπερασμένα�στόχοι για %d πρότυπα αρχεία�πρότυπος κατάλογος για πρότυπα αρχεία�η επέκταση %s δεν καθορίζει αν είναι ασφαλής η παράλληλη ανάγνωση, υποθέτοντας ότι δεν είναι - παρακαλείσθε να ζητήσετε από το δημιουργό της επέκτασης να το ελέγχει και να το κάνει σαφές�η επέκταση %s δεν καθορίζει αν είναι ασφαλής η παράλληλη ανάγνωση, υποθέτοντας ότι δεν είναι - παρακαλείσθε να ζητήσετε το δημιουργό της επέκτασης να το ελέγξει και να το κάνει σαφές�η τεκμηρίωση του�η επέκταση %r συγχωνεύθηκε ήδη με το Sphinx από την έκδοση %s; η επέκταση αυτή θα αγνοηθεί.�ο σύνδεσμος δεν έχει λεζάντα: %s�το θέμα %r δεν έχει ρύθμιση "inherit"�το θέμα %r δεν έχει ρύθμιση "theme"�το toctree περιλαμβάνει αναφορά σε άγνωστο αρχείο %r�το toctree περιλαμβάνει αναφορά στο έγγραφο %r η οποία δεν έχει τίτλο: δεν θα δημιουργηθεί σύνδεσμος�Το toctree περιλαμβάνει αναφορά στο αποκλεισμένο κείμενο %r�το toctree περιλαμβάνει αναφορά στο μη υπαρκτό έγγραφο %r�πολύ μεγάλο :maxdepth:, θα αγνοηθεί.�μετατροπή προειδοποιήσεων σε σφάλματα�τύπος�μη κωδικοποιήσιμοι χαρακτήρες πηγής, θα αντικατασταθούν με "?": %r�μη υλοποιημένος τύπος κόμβου: %r�ένωση�άγνωστο toplevel_sectioning %r για την κλάσση %r�άγνωστη τιμή παραμετροποίσης %r στην υπερσκέλιση, θα αγνοηθεί�άγνωστος τύπος εγγραφής ευρετηρίου %r�βρέθηκε άγνωστος τύπος εγγραφής ευρετηρίου %s�άγνωστο mimetype για %s, θα ανγοηθεί�άγνωστος τύπος κόμβου: %r�δόθηκε μη υποστηριζόμενη επιλογή θέματος %r�αναβάθμιση περιβάλλοντος:�χρηση epub�χρησιμοποιήστε το make-mode για το Makefile/make.bat�να μη χρησιμοποιηθεί κανένα αρχείο παραμετροποίησης, μόνο επιλογές -D�μεταβλητή�έκδοση του έργου�σε αναμονή για εργάτες...�κατά τον καθορισμό της επέκτασης %s�γράψτε εγγραφές "todo" οι οποίες μπορούν αν εμφανίζονται ή να αποκρύπτονται κατά τη μεταγλώττιση�εγγραφή όλων των αρχείων (προεπιλογή: εγγραφή μόνο νέων και αλλαγμένων αρχείων)�προειδοποιήσεις εγγραφής (και σφάλματα) στο δοθέν αρχείο�εγγραφή�εγγραφή %s αρχείου...�εγγραφή επιπρόσθετων αρχείων�καταγραφή λάθους: %s, %s�εγγραφή καταλόγων μηνύματος...�εγγραφή εξόδου...�εγγραφή αρχείου σύνοψης�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/el/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000400473�00000000000�021151� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Stelios Vitalis <liberostelios@gmail.com>, 2015 # Komiya Takeshi <i.tkomiya@gmail.com>, 2021 # tzoumakers tzoumakers <tzoumakersx@gmail.com>, 2019 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Greek (http://www.transifex.com/sphinx-doc/sphinx-1/language/el/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: el\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Δεν είναι δυνατή η εύρεση του καταλόγου πηγής (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Ο κατάλογος πηγής και ο κατάλογος προορισμού δεν είναι δυνατό να είναι ίδιοι" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Εκτέλεση Sphinx έκδοση %s" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Αυτό το έργο απαιτεί Sphinx έκδοσης τουλάχιστον %s και επομένως δεν είναι δυνατή η μεταγλωτισση με αυτή την έκδοση." #: sphinx/application.py:243 msgid "making output directory" msgstr "δημιουργία καταλόγου εξόδου" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "κατά τον καθορισμό της επέκτασης %s" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "η 'παραμετροποίηση' σύμφωνα με τον τρέχοντα ορισμό στο conf.py δεν αποτελεί καλέσιμο. Παρακαλείσθε να τροποποιήσετε τον ορισμό ώστε να το κάνετε μία καλέσιμη συνάρτηση. Αυτό απαιτείται προκειμένου το conf.py να συμπεριφέρεται ως μία επέκταση Sphinx." #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "φόρτωση μεταφράσεων [%s]..." #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "ολοκλήρωση" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "δεν είναι διαθέσιμο για εσωτερικά μηνύματα" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "φόρτωση πακτωμένου περιβάλλοντος" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "αποτυχία: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "Δεν επιλέχθηκε μεταγλωττιστής, θα χρησιμοποιηθεί ο προεπιλεγμένος: html" #: sphinx/application.py:348 msgid "succeeded" msgstr "επιτυχία" #: sphinx/application.py:349 msgid "finished with problems" msgstr "ολοκλήρωση με προβλήματα" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "μεταγλώττιση %s, %s προειδοποίηση" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "μεταγλώττιση %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "η κλάση κόμβου %r έχει ήδη καταχωρηθεί, οι επισκέπτες της θα υπερσκελιστούν" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "η οδηγία %r έει ήδη καταχωρηθεί, θα υπερσκελιστεί" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "ο ρόλος %r έχει ήδη καταχωρηθεί, θα υπερσκελιστεί" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "η επέκταση %s δεν καθορίζει αν είναι ασφαλής η παράλληλη ανάγνωση, υποθέτοντας ότι δεν είναι - παρακαλείσθε να ζητήσετε από το δημιουργό της επέκτασης να το ελέγχει και να το κάνει σαφές" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "η επέκταση %s δεν καθορίζει αν είναι ασφαλής η παράλληλη ανάγνωση, υποθέτοντας ότι δεν είναι - παρακαλείσθε να ζητήσετε το δημιουργό της επέκτασης να το ελέγξει και να το κάνει σαφές" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "εκτέλεση σειριακής %s" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "ο κατάλογος παραμετροποίησης δεν περιλαμβάνει κανένα αρχείο conf.py (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "δεν είναι δυνατή η υπερσκέλιση της ρύθμισης παραμετροποίησης καταλόγου %r, θα αγνοηθεί (χρησιμοποιήστε το %r για να καθορίσετε τα επιμέρους στοιχεία)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "ανέγκυρος αριθμός %r για τιμή παραμετροποίησης %r, θα αγνοηθεί" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "δεν είναι δυνατή η υπερσκέλιση της ρύθμισης παραμετροποίησης %r με τύπο ο οποίος δεν υποστηρίζεται, θα αγνοηθεί" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "άγνωστη τιμή παραμετροποίσης %r στην υπερσκέλιση, θα αγνοηθεί" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "Δεν υπάρχει τέτοια τιμή παραμετροποίησης: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "Η τιμή παραμετροποίησης %r υφίσταται ήδη." #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Υπάρχει ένα συντακτικό λάθος στο αρχείο παραμετροποίησής σας: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Το αρχείο παραμετροποίησης (ή ένα από τα στοιχεία που εισάγει) κάλεσε την sys.exit()" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "Υπάρχει ένα προγραμματιστικό λάθος στο αρχείο παραμετροποίησής σας:\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "Η τιμή παραμτετροποίησης 'source_suffix' αναμένει στοιχειοσειρά, στοιχειοσειρά καταλόγου, ή λεξικό. Αλλά παραδόθηκε %r." #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Τομέας %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Εικ. %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Πίνακας %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Λίστα %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "Η τιμή παραμετροποίησης '{name}' πρέπει να λαμβάνει μία από τις {candidates} αλλά εκχωρήθηκε η '{current}'." #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "Η τιμή παραμετροποίησης '{name]' έχει τύπο '[current__name__}'; αναμενόμενη {permitted}." #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "Η τιμή παραμετροποίησης '{name}' έχει τύπο '{current__name__}', αρχικοποίηση σε '{default__name__}'." #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "το primary_domain %r δεν βρέθηκε, θα αγνοηθεί." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "Το συμβάν %r υπάρχει ήδη" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Άγνωστο όνομα συμβάντος: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "Η επέκταση %s απαιτείται από τις ρυθμίσεις needs_extensions, αλλά δεν είναι φορτωμένη." #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "Το έργο χρειάζεται την επέκταση %s τουλάχιστον στην έκδοση %s και επομένως δεν είναι δυνατή η μεταγλώττιση με τη φορτωμένη έκδοση (%s)." #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "Το όνομα %r δεν είναι γνωστό" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "Δεν είναι δυνατό το lex του literal_block ως %s. Η επισήμανση παραβλέφθηκε." #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "το έγγραφο δεν είναι αναγνωσιμό. Θα αγνοηθεί." #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "Η κλάση μεταγλώττισης %s δεν έχει χαρακτηριστικό \"name\" " #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Ο μεταγλωττιστής %r υφίσταται ήδη (στο δομοστοιχείο %s)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Το όνομα μεταγλωττιστή %s δεν είναι καταχωρημένο ή διαθέσιμο δια μέσου του σημείου εισαγωγής" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "Το όνομα μεταγλωττιστή %sδεν είναι καταχορημένο" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "ο τομέας %s είναι ήδη καταχωρημένος" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "ο τομέας %s δεν έχει καταχωρηθεί ακόμη" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "Η οδηγία %r είναι ήδη καταχωρημένη στον τομέα %s" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "Ο ρόλος %r είναι ήδη καταχωρημένος στον τομέα %s" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "Ο δείκτης %r είναι ήδη καταχωρημένος στον τομέα %s" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "Το object_type %r είναι ήδη καταχωρημένο" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "Το crossref_type %r είναι ήδη καταχωρημένο" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "το source_suffix %r είναι ήδη καταχωρημένο" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "το source_parser για το %r είναι ήδη καταχωρημένο" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "Ο αναλυτής πηγής για το %s δεν είναι καταχωρημένος" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "Ο μεταφραστής για το %r υφίσταται ήδη" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "το kwargs για το add_node() πρέπει να είναι μία (visit, depart) συνάρτηση πλειάδας: %r=%r" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "το enumerable_node %r είναι ήδη καταχωρημένο" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "η επέκταση %r συγχωνεύθηκε ήδη με το Sphinx από την έκδοση %s; η επέκταση αυτή θα αγνοηθεί." #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "Αρχική εξαίρεση:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "Δεν ήταν δυνατή η εισαγωγή της επέκτασης %s" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "η επέκταση %r δεν έχει συνάρτηση setup(); αποτελεί δομοστοιχείο επέκτασης του Sphinx;" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "Η επέκταση %s η οποία χρησιμοποιείται από αυτό το έργο απαιτεί Sphinx έκδοσης τουλάχιστον %s: επομένως δεν είναι δυνατή η μεταγλώττιση με αυτή την έκδοση." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "η επέκταση %r επιστρέφει ένα μη υποστηριζόμενο αντικείμενο από τη συνάρτησή της setup(): θα έπρεπε να επιστρέφει None ή έναν κατάλογο μεταδεδομένων" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "το θέμα %r δεν έχει ρύθμιση \"theme\"" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "το θέμα %r δεν έχει ρύθμιση \"inherit\"" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "δεν βρέθηκε θέμα με το όνομα %r, το οποίο κληρονομήθηκε από το %r" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "η ρύθμιση %s.%s δεν εμφανίζεται από τις παραμετροποιήσεις θέματος που αναζητήθηκαν" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "δόθηκε μη υποστηριζόμενη επιλογή θέματος %r" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "το αρχείο %r στο μονοπάτι θέματος δεν αποτελεί ένα έγκυρο zipfile ή δεν περιλαμβάνει ένα θέμα" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "δεν βρέθηκε θέμα με όνομα %r (απουσιάζει το theme.conf;)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "δεν βρέθηκε μία κατάλληλη εικόνα για τον μεταγλωττιστή %s: %s (%s)" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "δεν βρέθηκε μία κατάλληλη εικόνα για τον μεταγλωττιστή %s: %s" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "μεταγλώττιση [mo]:" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "εγγραφή εξόδου..." #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "όλα τα αρχεία po του %d" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "στόχοι για τα αρχεία po του %d οι οποίοι έχουν καθοριστεί" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "στόχοι για τα αρχεία po του %d τα οποία είναι ξεπερασμένα" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "όλα τα αρχεία πηγής" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "το αρχείο %r που δόθηκε στη γραμμή εντολής δεν βρίσκεται κάτω από τον κατάλογο πηγής, θα αγνοηθεί" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "το αρχείο %r που δόθηκε στη γραμμή εντολής δεν υπάρχει, θα αγνοηθεί" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "τα αρχεία πηγής %d που δόθηκαν στη γραμμή εντολής" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "στόχοι για τα αρχεία πηγής %d τα οποία είναι ξεπερασμένα" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "μεταγλώττιση [%s]:" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "αναζήτηση για νεοξεπερασμένα αρχεία..." #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "βρέθηκε %d" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "δεν βρέθηκε κανένα" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "Περιβάλλον μετατροπής αντικειμένων Python σε ροή bytes" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "έλεγχος συνοχής" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "κανένας στόχος δεν είναι ξεπερασμένος." #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "αναβάθμιση περιβάλλοντος:" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "%s προστέθηκε, %s άλλαξε, %s απομακρύνθηκε" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "ανάγνωση πηγών..." #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "σε αναμονή για εργάτες..." #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "docname προς εγγραφή: %s" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "προετοιμασία κειμένων" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "βρέθηκε διπλότυπη εγγραφή ToC: %s" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "αντιγραφή εικόνων..." #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "δεν είναι δυνατή η ανάγωνση αρχείου εικόνας %r: αντί αυτού θα αντιγραφεί" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "δεν είναι δυνατή η αντιγραφή αρχείου εικόνας %r: %s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "δεν είναι δυνατή η εγγραφή αρχείου %r: %s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "Το pillow δεν βρέθηκε - αντιγραφή αρχείων εικόνας" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "άγνωστο mimetype για %s, θα ανγοηθεί" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "εγγραφή %s αρχείου..." #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "Το αρχείο επισκόπησης είναι σε %(outdir)s." #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "καμία αλλαγή στην έκδοση %s." #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "εγγραφή αρχείου σύνοψης" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Ενσωματωμένες λειτουργίες" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Επίπεδο μονάδας λειτουργίας" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "αντιγραφή αρχείων πηγής..." #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "δεν ήταν δυνατή η ανάγνωση %r για τη δημιουργία changelog" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "Ο προσωρινός μεταγλωττιστής δεν δημιουργεί αρχεία." #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "Το αρχείο ePub βρίσκεται σε %(outdir)s." #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "η τιμή παραμετροποίησης \"epub_language\" (ή \"language\") δεν πρέπει να είναι κενή για EPUB3" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "η τιμή παραμετροποίησης \"epub_uid\" πρέπει να είναι XML NAME για EPUB3" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "η τιμή παραμετροποίησης \"epub_title\" (ή \"html_title\") δεν πρέπει να είναι κενή για EPUB3" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "η τιμή παραμετροποίησης \"epub_author\" δεν πρέπει να είναι κενή για EPUB3" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "η τιμή παραμετροποίησης \"epub_contributor\" δεν πρέπει να είναι κενή για EPUB3" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "η τιμή παραμετροποίησης \"epub_description\" δεν πρέπει να είναι κενή για EPUB3" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "η τιμή παραμετροποίησης \"epub_publisher\" δεν πρέπει να είναι κενή για EPUB3" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "η τιμή παραμετροποίησης \"epub_copyright\" (ή \"copyright\") δεν πρέπει να είναι κενή για EPUB3" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "η τιμή παραμετροποίησης \"epub_identifier\" δεν πρέπει να είναι κενή για EPUB3" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "η τιμή παραμετροποίησης \"version\" δεν πρέπει να είναι κενή για EPUB3" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "ανέγκυρο css_file: %r, θα αγνοηθεί" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "Οι κατάλογοι των μηνυμάτων είναι στο %(outdir)s." #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "στόχοι για %d πρότυπα αρχεία" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "ανάγνωση προτύπων..." #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "εγγραφή καταλόγων μηνύματος..." #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "Αναζητήστε οποιαδήποτε λάθη στο παραπάνω αποτέλεσμα ή σε %(outdir)s/output.txt" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "λανθασμένος σύνδεσμος: %s (%s)" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "Δεν βρέθηκε το anchor '%s'" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "Οι σελίδες manual βρίσκονται σε %(outdir)s." #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "δεν βρέθηκε τιμή παραμετροποίησης \"man_pages\"; δεν θα καταγραφούν manual pages" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "εγγραφή" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "η τιμή παραμετροποίησης \"man_pages\" κάνει αναφορά το άγνωστο κείμενο %s" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "Η σελίδα HTML είναι στο %(outdir)s." #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "συναρμολόγηση απλού κειμένου" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "εγγραφή επιπρόσθετων αρχείων" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "Τα αρχεία Texinfo βρίσκονται σε %(outdir)s." #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "\nΕκτελέστε 'make' σε αυτό τον κατάλογο για να εκτελέσετε αυτά μέσω του makeinfo\n(χρησιμοποιήστε το 'make info' εδώ για να το κάνετε αυτόματα)." #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "δεν βρέθηκε τιμή \"texinfo_documents\": δεν θα γίνει εγγραφή κανενός κειμένου" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "η τιμή παραμετροποίησης \"texninfo_documents\" αναφέρεται σε άγνωστο κείμενο %s" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "επεξεργασία %s" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "επίλυση αναφορών..." #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (σε " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "αντιγραφή αρχείων υποστήριξης Texinfo" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "σφάλμα κατά την εγγραφή του αρχείου Makefile: %s" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "Τα αρχεία κειένου βρίσκονται σε %(outdir)s." #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "σφάλμα καταγραφής αρχείου %s: %s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "Τα αρχεία XML βρίσκονται σε %(outdir)s." #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "Τα αρχεία XML βρίσκονται σε %(outdir)s." #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "το αρχείο πληροφοριών μεταγλώττισης είναι κατεστραμμένο: %r" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "Οι σελίδες HTML βρίσκονται σε %(outdir)s." #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "Αδυναμία ανάγνωσης αρχείου πληροφοριών μεταγλώττισης: %r" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d %B %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Κεντρικό Ευρετήριοο" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "ευρετήριο" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "επόμενο" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "προηγούμενο" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "αντιγραφή αρχείων μεταφόρτωσης..." #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "δεν είναι δυνατή η αντιγραφή του μεταφορτωμένου αρχείου %r: %s" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "δεν είναι δυνατή η αντιγραφή στατικού αρχείου %r" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "δεν είναι δυνατή η αντιγραφή του επιπλέον αρχείου %r" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "Αδυναμία εγγραφής του αρχείου πληροφοριών μεταγλώττισης: %r" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "ο κατάλογος εύρεσης δεν ήταν δυνατό να φορτωθεί, αλλά δε θα μεταγλωττιστούν όλα τα έγγραφα: ο κατάλογος δε θα είναι πλήρης." #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "η σελιδα %s ταιριάζει δύο σχέδια στo html_sidebars: %r and %r" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "ένα σφάλμα Unicode παρουσιάστηκε κατά τη δημιουργία της σελίδας %s. Παρακαλείστε να επιβεβαιώσετε ότι όλες οι τιμές παραμετροποίησης οι οποίες περιλαμβάνουν μη-ASCII περιεχόμενο είναι στοιχειοσειρές Unicode." #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "Ένα σφάλμα συνέβη κατά τη σύνθεση της σελίδας %s.\n\nΑιτία %r " #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "ανέγκυρο js_file: %r, θα αγνοηθεί" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "Πολλά math_renderers έχουν καταγραφεί. Αλλά δεν έχει επιλεγεί κανένα math_renderer." #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "Δόθηκε άγνωστο math_renderer %r." #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "Η εγγραφή html_extra_path %r δεν υπάρχει" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "η εγγραφή html_static_path %r δεν υπάρχει" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "το αρχείο logo %r δεν υπάρχει" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "το αρχείο favicon %r δεν υπάρχει" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "Τεκμηρίωση του %s - %s" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "Τα αρχεία LaTeX βρίσκονται σε %(outdir)s." #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\nΕκτελέστε 'make' σε αυτό τον κατάλογο για να εκτελέσετε αυτά μέσω του (pdf)latex\n(χρησιμοποιήστε το 'make latexpdf' εδώ για να το κάνετε αυτόματα)." #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "δεν βρέθηκε τιμή παραμετροποίησης \"latex_documents\": δεν θα πραγματοποιηθεί εγγραφή για κανένα κείμενο" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "η τιμή παραμετροποίησης \"latex_documents\" κάνει αναφορά το άγνωστο κείμενο %s" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Ευρετήριο" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Δημοσίευση" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "καμία γνωστή επιλογή Babel για τη γλώσσα %r" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "αντιγραφή αρχείων υποστήριξης TeX" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "αντιγραφή αρχείων υποστήριξης TeX..." #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "αντιγραφή επιπρόσθετων αρχείων" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "Παρουσιάστηκε εξαίρεση κατά τη μεταγλώττιση, εκκίνηση αποσφαλματιστή: " #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "σφάλμα reST markup:" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "Σφάλμα κωδικοποίησης:" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "Το πλήρες ιστορικό έχει αποθηκευτεί σε %s, σε περίπτωση που επιθυμείτε να αναφέρετε το ζήτημα στους προγραμματιστές." #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "Σφάλμα αναδρομής:" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "Εμφανίστηκε εξαίρεση:" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "Παρακαλείστε να το αναφέρετε αν ήταν ένα σφάλμα χρήσης, ώστε ένα καλύτερο μήνυμα σφάλματος να δοθεί την επόμενη φορά." #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "Μία αναφορά σφάλματος μπορεί να υποβληθεί στον ινχηλάτη στο https://github.com/sphinx-doc/sphinx/issues>. Ευχαριστούμε!" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "ο αριθμός εργασίας θα πρέπει να είναι θετικός αριθμός" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "μονοπάτι για τα αρχεία πηγής τεκμηρίωσης" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "μονοπάτι στον κατάλογο εξόδου" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "μία λίστα με συγκεκριμένα αρχεία να επαναμεταγλωττιστούν. Θα αγνοηθεί αν δοθεί το -a" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "γενικές επιλογές" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "μεταγλωττιστής για χρήση (προεπιλογή: html)" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "εγγραφή όλων των αρχείων (προεπιλογή: εγγραφή μόνο νέων και αλλαγμένων αρχείων)" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "μην χρησιμοποιείτε ένα αποθηκευμένο περιβάλλον, πάντα να διαβάζετε όλα τα αρχεία" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "μονοπάτι για το αποθηκευμένο περιβάλλον και τα αρχεία doctree (προεπιλογή: OUTPUTDIR/.doctrees)" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "παράλληλος μεταγλωττισμός με Ν διεργασίες όπου είναι δυνατό (ιδιαίτερη τιμή \"auto\" θα ορίσει Ν στο cpu-count)" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "το μονοπάτι όπου βρίσκεται το αρχείο παραμετροποίησης (conf.py) (προεπιλογή: το ίδιο όπως το SOURCEDIR)" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "να μη χρησιμοποιηθεί κανένα αρχείο παραμετροποίησης, μόνο επιλογές -D" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "παράκαμψη ρύθμισης στο αρχείο παραμετροποίησης" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "μεταφορά τιμής στα πρότυπα HTML" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "ορίστε ετικέτα: συμπεριλάβατε \"only\" τμήματα με TAG" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "Ο τρόπος nit-picky, προειδοποιεί για όλες τις αναφορές που απουσιάζουν" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "επιλογές εξόδου κονσόλας" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "αυξήστε τον βερμπαλισμό (μπορεί να επαναληφθεί)" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "καμία έξοδος στο stdout, μόνο προειδοποιήσεις στο stderr" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "κανένα αποτέλεσμα ούτε προειδοποιήσεις" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "να γίνεται εκπομπή χρωματιστής εξόδου (προεπιλογή: auto-detect)" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "να μην παρουσιάζεται έγχρωμο αποτέλεσμα (προεπιλογή: αυτόματη αναγνώριση)" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "προειδοποιήσεις εγγραφής (και σφάλματα) στο δοθέν αρχείο" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "μετατροπή προειδοποιήσεων σε σφάλματα" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "απεικόνιση πλήρους ιστορικού σε περίπτωση εξαίρεσης" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "εκτέλεση Pdb σε περίπτωση εξαίρεσης" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "δεν είναι δυνατή η εύρεση αρχείων %r" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "δεν γίνεται συνδιασμός της επιλογής -a και των ονομάτων αρχείων" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "δεν είναι δυνατό το άνοιγμα του αρχείου προειδοποίησης %r: %s" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "Το όρισμα -D πρέπει να είναι της μορφής όνομα=τιμέ" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "Το όρισμα -Α πρέπει να είναι της μορφής όνομα=τιμή" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "αυτόματη εισαγωγή docstrings από τα δομοστοιχεία" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "αυτόματα κομμάτια δοκιμαστικού κώδικα σε τμήματα doctest" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "σύνδεσμος μεταξύ τεκμηρίωσης Sphinx διαφόρων έργων" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "γράψτε εγγραφές \"todo\" οι οποίες μπορούν αν εμφανίζονται ή να αποκρύπτονται κατά τη μεταγλώττιση" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "αναζήτηση για κάλυψη βιβλιογραφίας" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "να συμπεριληφθεί το math, απεικονισμένο ως εικόνες PNG η SVG" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "να συμπεριληφθεί το math, απεικονισμένο στο φυλλομετρηρή απο το MathJax" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "υποθετική εισαγωγή περιεχομένου βασισμένη στις τιμές παραμετροποίησης" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "να συμπεριληφθούν σύνδεσμοι στον πηγαίο κώδικα των τεκμηριωμένων αντικειμένων Python" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "δημιουργία αρχείου .nojekyll για έκδοση του εγγράφου στις σελίδες GitHub " #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "Παρακαλείστε να εισάγετε ένα έγκυρο όνομα μονοπατιού." #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "Παρακαλείστε να εισάγετε κάποιο κείμενο." #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "Παρακαλείστε να εισάγετε ένα από τα %s." #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "Παρακαλείστε να εισάγετε είτε 'y' είτε 'n'." #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "Παρακαλείστε να εισάγετε μία επέκταση αρχείου, π.χ. '.rst' ή '.txt'." #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "Καλώς ήρθατε στο εργαλείο γρήγορης εκκίνησης Sphinx %s." #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "Ριζικό μονοπάτι για την τεκμηρίωση" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "Σφάλμα: ένα υπάρχον conf.py έχει βρεθεί στοn επιλεγμένο ριζικό κατάλογο." #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "το sphinx-quickstart δεν θα αντικαταστήσει υπάρχοντα έργα Sphinx." #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "Παρακαλείστε να εισάγετε ένα νέο ριζικό μονοπάτι (ή απλά πιέστε το Enter για έξοδο)" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "Ξεχωριστοί κατάλογοι για πηγή και μεταγλώττιση (y/n)" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "Πρόθεμα ονόματος για πρότυπα και στατικούς καταλόγους" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "Όνομα έργου" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "Όνομα(τα) συγγραφέα" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "Έκδοση έργου" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "Κυκλοφορία έργου" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "Γλώσσα έργου" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "Επέκταση αρχείου πηγής" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "Όνομα του κυρίους σας εγγράφου (χωρίς επέκταση)" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "Σφάλμα: το κύριο αρχείο %s έχει ήδη βρεθεί στο επιλεγμένο ριζικό κατάλογο." #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "το sphinx-quickstart δεν θα αντικαταστήσει υπάρχοντα αρχεία." #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "Παρακαλείσθε να εισάγετε ένα νέο όνομα αρχείου, ή να μεταονομάσετε το υπάρχον αρχείο και να πιέσετε το Enter" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "Υποδείξτε ποιά απο τις ακόλουθες επεκτάσεις Sphinx πρέπει να ενεργοποιηθούν:" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "Σημείωση: τα imgmath και mathjax δεν είναι δυνατό να ενεργοποιηθούν ταυτόχρονα. Το imgmath έχει αποεπιλεγθεί. " #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "Δημιουργία Makefile; (y/n)" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "Δημιουργία αρχείου εντολών Windows; (y/n)" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "Δημιουργία αρχείου %s." #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "Το αρχείο %s υπάρχει ήδη, παραλείπεται." #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "Ολοκλήρωση: μία αρχική δομή καταλόγου δημιουργήθηκε." #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "\nΔημιουργία απαιτούμενων αρχείων για ένα έργο Sphinx.\n\nΤο sphinx-quickstart είναι ένα διαδραστικό εργαλείο το οποίο κάνει κάποιες ερωτήσεις για το δικό σας \nέργο και μετά δημιουργεί έναν πλήρη κατάλογο τεκμηρίωσης και δείγμα \nMakefile για να χρησιμοποιηθεί με το sphinx-build.\n" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "ήσυχος τρόπος" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "Επιλογές δομής" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "αν ορίζεται, θα ξεχωρίσουν οι κατάλογοι πηγής και μεταγλώττισης" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "αντικατάσταση για τελεία σε _templates κλπ." #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "Βασικές επιλογές έργου" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "όνομα έργου" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "ονόματα συγγραφέων" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "έκδοση του έργου" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "δημοσίευση του έργου" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "γλώσσα εγγράφου" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "επέκταση αρχείου πηγής" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "κύριο όνομα εγγράφου" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "χρηση epub" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "Επιλογές επέκτασης" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "ενεργοποίηση της επέκτασης %s" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "ενεργοποίηση αυθαίρετων επεκτάσεων" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "Δημιουργία Makefile και Batchfile" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "δημιουργία makefile" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "να μη δημιουργηθεί makefile" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "δημιουργία batchfile" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "να μη δημιουργηθεί batchfile" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "χρησιμοποιήστε το make-mode για το Makefile/make.bat" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "μην χρησιμοποιείτε make-mode για Makefile/make.bat" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "Προτυποποίηση έργου" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "πρότυπος κατάλογος για πρότυπα αρχεία" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "ορίστε μία τιμή προτύπου" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "καθορίστηκε το \"quiet\", αλλά δεν καθορίστηκε είτε το \"project\" είτε το \"author\"." #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "Σφάλμα: το καθορισθέν μονοπάτι δεν είναι κατάλογος, ή τα αρχεία sphinx υπάρχουν ήδη." #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "Το sphinx-quickstart δημιουργεί μόνο εντός ενός κενού καταλόγου. Παρακαλείσθε να καθορίσετε ένα νέο ριζικό μονοπάτι." #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "Ανέγκυρη μεταβλητή προτύπου: %s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "Ανέγκυρη λεζάντα: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "η προδιαγραφή αριθμού σειράς είναι εκτός e;yroyw (1-%d): %r" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "Δεν είναι δυνατή η ταυτόχρονη χρήση των επιλογών \"%s\" και \"%s\"" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "Το συμπεριληφθέν αρχείο %r δεν βρέθηκε ή απέτυχε η ανάγνωσή του" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "Η κωδικοποίηση %r που χρησιμοποιήθηκε για την ανάγνωση του συμπεριληφθέντος αρχείου %r φαίνεται να είναι λανθασμένη, προσπαθήστε να δώσετε μία επιλογή :encoding:" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "Το αντικείμενο με όνομα %r δεν βρέθηκε στο συμπεριληφθέν αρχείο %r" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "Δεν είναι δυνατή η χρήση \"leneno-match\" με ένα κομματιασμένο σετ απο \"lines\"" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "Προσδιορισμός γραμμής %r: δεν ελήφθησαν γραμμές από το συμπεριληφθέν αρχείο %r" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Συντάκτης τμήματος: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Συντάκτης μονάδας: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Συντάκτης κώδικα: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Συντάκτης: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Παράμετροι" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Επιστρέφει" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Επιστρεφόμενος τύπος" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "μέλος" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "μεταβλητή" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "συνάρτηση" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "μακροεντολή" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "ένωση" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "enum" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "enumerator" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "τύπος" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Νέο στην έκδοση %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Άλλαξε στην έκδοση %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Αποσύρθηκε στην έκδοση %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "διπλότυπη ετικέτα %s, άλλη εμφάνιση στο %s" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "Η παραπομπή [%s] δεν αναφέρεται." #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Παράμετροι Προτύπου" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Προκαλεί" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "κλάση" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "έννοια" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (ενσωματωμένη συνάρτηση)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (μέθοδος της %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (κλάση)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (καθολική μεταβλητή ή σταθερά)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (ιδιότητα της %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Παράμετροι" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (μονάδα)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "μέθοδος" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "δεδομένα" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "ιδιότητα" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "μονάδα" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "διπλότυπη ετικέτα της εξίσωσης %s, άλλη εμφάνιση στο %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "Ανέγκυρο math_eqref_format: %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "λέξη κλειδί" #: sphinx/domains/python.py:60 msgid "operator" msgstr "τελεστής" #: sphinx/domains/python.py:61 msgid "object" msgstr "αντικείμενο" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "εξαίρεση" #: sphinx/domains/python.py:63 msgid "statement" msgstr "δήλωση" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "ενσωματωμένη συνάρτηση" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Μεταβλητές" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Προκαλεί" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (στη μονάδα %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (στη μονάδα %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (ενσωματωμένη μεταβλητή)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (ενσωματωμένη κλάση)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (κλάση σε %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (μέθοδος κλάσης της %s)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (στατική μέθοδος της %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Ευρετήριο Μονάδων της Python" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "μονάδες" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Αποσύρθηκε" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "μέθοδος της κλάσης" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "στατική μέθοδος" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "περισσότεροι από έναν στόχοι βρέθηκα για την παραπομπή %r: %s" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (αποσύρθηκε)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (οδηγία)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (ρόλος)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "οδηγία" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "ρόλος" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "μεταβλητή περιβάλλοντος; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "Λανθασμένη περιγραφή επιλογής %r, θα πρέπει να μοιάζει με \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" ή \"+opt args\"" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "γλωσσάρι" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "γραμματική ένδειξη" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "ετικέτα αναφοράς" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "μεταβλητή περιβάλλοντος" #: sphinx/domains/std.py:568 msgid "program option" msgstr "επιλογή προγράμματος" #: sphinx/domains/std.py:569 msgid "document" msgstr "έγγραφο" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Ευρετήριο μονάδων" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Σελίδα αναζήτησης" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "διπλότυπη ετικέτα %s, άλλη εμφάνιση στο %s" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "το numfig έχει απενεργοποιηθεί. Το :numref: θα ανγοηθεί." #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "ο σύνδεσμος δεν έχει λεζάντα: %s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "ανέγκυρο numfig_format: %s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "ανέγκυρο numfig_format: %s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "νέα παραμετροποίηση" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "η παραμετροποίηση άλλαξε" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "αλλαγμένες επεκτάσεις" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "η έκδοση του περιβάλλοντος μεταλώττισης δεν είναι η τρέχουσα" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "ο πηγαίος κατάλογος έχει αλλάξει" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "Το περιβάλλον δεν είναι συμβατό με τον επιλεγμένο μεταγλωττιστή, παρακαλείστε να επιλέξετε ένα διαφορετικό κατάλογο toctree." #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "Αδυναμία σάρωσης εγγράφων σε %s: %r" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "Ο τομέας %r δεν είναι καταχωρημένος" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "Βρέθηκε αυτοαναφερόμενο toctree. Θα αγνοηθεί." #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "το έγγραφο δεν συμπεριλαμβάνεται σε κανένα toctree" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "δείτε %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "δείτε επίσης %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "άγνωστος τύπος εγγραφής ευρετηρίου %r" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Σύμβολα" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "αναγνωρίστηκαν κυκλικές αναφορές toctree, θα αγνοηθούν: %s <- %s" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "το toctree περιλαμβάνει αναφορά στο έγγραφο %r η οποία δεν έχει τίτλο: δεν θα δημιουργηθεί σύνδεσμος" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "Το toctree περιλαμβάνει αναφορά στο αποκλεισμένο κείμενο %r" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "το toctree περιλαμβάνει αναφορά στο μη υπαρκτό έγγραφο %r" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "το αρχείο εικόνας δεν είναι αναγνώσιμο: %s" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "το αρχείο εικόνας %s δεν είναι αναγνώσιμο: %s" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "το μεταφορτωμένο αρχείο δεν είναι αναγνώσιμο: %s" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "στο %s έχουν ήδη ανατεθεί αριθμοί τομέα (εμφωλιασμένο αριθμημένο toctree;)" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "Θα δημιουργούσε το αρχείο %s." #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "\nΑναζητήστε αναδρομικα σε <MODULE_PATH>για δομοστοιχεία Python και πακέτα και δημιουργήστε \nένα αρχείο reST με οδηγίες automodule για κάθε πακέτο στο <OUTPUT_PATH>.\n\nΤα <EXCLUDE_PATTERN>μπορεί να αποτελούν αρχεία ή/και σχέδια καταλόγων τα οποία θα \nεκτελεστούν κατά τη δημιουργία.\n\nΣημείωση: από προεπιλογή αυτό το σενάριο δεν θα αντικαταστήσει τα ήδη δημιουργημένα αρχεία." #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "μονοπάτι για το δομοστοιχείο για το έγγραφο" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "αρχεία fnmatch-style και/ή υποδείγματα καταλόγου που θα εξαιρεθούν από τη δημιουργία" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "κατάλογο για τοποθέτηση όλων των προϊόντων" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "μέγιστο βάθος από υποδομοστοιχεία για απεικόνιση στο TOC (προεπιλογή: 4)" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "αντικατάσταση υπάρχοντων αρχείων" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "ακολουθία συμβολικών συνδέσμων. Ισχυρό όταν συνδυάζεται με το collective.recipe.omelette." #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "εκτελέστε το σενάριο χωρίς τη δημιουργία αρχείων" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "τοποθετήστε βιβλιογραφία για κάθε δομοστοιχείο στη δικής της σελίδα" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "να συμπεριληφθούν τα δομοστοιχεία \"_private\"" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "όνομα αρχείου του πίνακα περιεχομένων (προεπιλογή: δομοστοιχεία)" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "να μη δημιουργηθεί αρχείο με πίνακα περιεχομένων" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "μη δημιουργείτε κεφαλίδες για πακέτα δομοστοιχείων/πακέτων (π.χ. όταν τα docstrings τα περιλαμβάνουν ήδη)" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "τοποθέτηση βιβλιογραφίας δομοστοιχείου πριν από την βιβλιογραφία υπόδομοστοιχείου" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "ερμηνεία μονοπατιών δομοστοιχείων σύμφωνα με την προδιαγραφή POP-0420 αυτονόητων namespaces" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "επέκταση αρχείου (προεπιλογή: rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "δημιουργία ενός πλήρους έργου με το sphinx-quickstart" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "η προσθήκη του module_path στο sys.path, χρησιμοποιείται όταν δίδεται το --full" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "όνομα έργου (προεπιλογή: όνομα ριζικού δομοστοιχείου)" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "συγγραφέας(εις) έργου, χρησιμοποιείται όταν δίδεται το --full" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "έκδοση έργου, χρησιμοποιείται όταν δίνεται το --full" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "έκδοση έργου, χρησιμοποιείται όταν δίδεται το --full, προεπιλογή σε --doc-version" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "επιλογές επέκτασης" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "το %s δεν είναι κατάλογος." #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "ανέγκυρο regex %r σε %s" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "Η δοκιμή της κάλυψης στις πηγές ολοκληρώθηκε, δείτε τα αποτελέσματα στο %(outdir)s python.txt." #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "ανέγκυρο regex %r στο coverage_c_regexes" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "το δομοστοιχείο %s δεν ήταν δυνατό να εισαχθεί: %s" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "λείπει '+' ή '-' στην επιλογή '%s'." #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "Η '%s δεν είναι μία έγκυρη επιλογή." #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "'%s' δεν αποτελεί μία έγκυρη επιλογή για pyversion" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "ανέγκυρος τύπος TestCode" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "Ολοκληρώθηκε η δοκιμή των doctests στις πηγές, δείτε τα αποτελέσματα σε %(outdir)s/output.txt." #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "δεν υπάρχει κώδικας/αποτέλεσμα στο τμήμα %s στο %s:%s" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "Ο ανέγκυρος κώδικας doctest θα αγνοηθεί: %r" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "Η οδηγία Graphviz δεν είναι δυνατό να περιλαμβάνει και περιεχόμενο και ένα όρισμα ονόματος αρχείου" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "Το εξωτερικό αρχείο Graphviz %r δεν βρέθηκε ή απέτυχε η ανάγνωσή του" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "Η οδηγία χωρίς περιεχόμενο \"graphviz\" θα αγνοηθεί." #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "το dot δεν παρήγαγε κανένα αρχείο εξόδου:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "η εντολή dot %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για αποτέλεσμα graphviz), ελέγξτε τη ρύθμιση graphviz_dot" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "το dot ολοκλήρωσε με σφάλμα:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "Το graphviz_output_format πρέπει να είναι ένα από τα 'png', 'svg', αλλά είναι %r" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "κωδικός dot %r: %s" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[γράφημα: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[γράφημα]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "η μετατροπή ολοκλήρωσε με σφάλμα:[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "Η εντολή LaTex %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για απεικόνιση μαθηματικών), ελέγξτε τη ρύθμιση imgmath_latex" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "%s η εντολή %r δεν είναι δυνατό να εκτελεστεί (απαιτείται για μαθηματική απεικόνιση), ελέγξτε τη ρύθμιση imgmath_%s" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "απεικόνιση latex %r: %s" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "σε σειρά latex %r: %s" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Μόνιμος σύνδεσμος σε αυτή την εξίσωση" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "το απόθεμα intersphinx έχει μεταφερθεί: %s->%s" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "φότωση του αποθέματος intersphinx από %s..." #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "παρουσιάστηκαν κάποια ζητήματα με μερικά απο τα αποθέματα, αλλά υπήρξαν λειτουργικές εναλλακτικές:" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "αδυναμία προσέγγισης οποιασδήποτε αποθήκης με τα ακόλουθα ζητήματα:" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(στη %s έκδοση %s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(στο %s)" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "το αναγνωριστικό intersphinx %r δεν είναι στοιχειοσειρά. Θα αγνοηθεί" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[πηγή]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Εκκρεμότητα" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "βρέθηκε εγγραφή TODO:%s" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<original entry>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(Το <<original entry>> βρίσκεται στο %s, γραμή %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "αρχική εγγραφή" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "επισήμανση κώδικα δομοστοιχείου..." #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[τεκμηρίωση]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Κώδικας μονάδας" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Πηγαίος κώδικας για το %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Επισκόπηση: κώδικας της μονάδας" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Όλες οι μονάδες για τις οποίες υπάρχει διαθέσιμος κώδικας</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "ανέγκυρη υπογραφή για αυτόματο %s (%r)" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "σφάλμα κατά τη μορφοποίηση των ορισμάτων για %s:%s" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "απουσιάζει το χαρακτηριστικό %s στο αντικείμενο %s" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "δεν γνωρίζω ποιο δομοστοιχείο να εισάγω για αυτόματη τεκμηρίωση %r (προσπαθήστε να τοποθετήσετε μία οδηγία \"module\" ή \"currentmodule\" στο έγγραφο, ή να δώσετε ένα σαφές όνομα δομοστοιχείου)" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "\"::\" στο όνομα automodule δεν βγάζει νόημα" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "ορίσματα υπογραφής ή επιστροφή σημείωσης η οποία δόθηκε για το automodule %s" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "__all__ πρέπει να είναι λίστα στοιχειοσειράς, όχι %r (στο δομοστοιχείο %s) -- θα αγνοηθεί το __all__" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "Βάσεις: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "αδυναμία ανάλυσης ονόματος %s" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "αδυναμία εισαγωγής αντικειμένου %s" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "Το autosummary δημιουργεί αρχεία .rst εσωτερικά. Αλλά το δικό σας source_suffix δεν περιλαμβάνει .rst. Θα παραλειφθεί." #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[autosummary] δημιουργία autosummary για: %s" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "[αυτόματη περίληψη] εγγραφή στο %s" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "\nΔημιουργία ReStrucuredText χρησιμοποιώντας τις οδηγίες autosummary.\n\nΤο sphinx-autogen αποτελεί ένα πρόσθιο εργαλείο για το sphinx.ext.autosummary.generate. Δημιουργεί \nτα αρχεία reStructuredText από τις οδηγίες autosummary οι οποίες περιλαμβάνονται στα \nπαραδοθέντα αρχεία εισόδου.\n\nΗ μορφή της οδηγίας autosummary τεκμηρειώνεται στο \nδομοστοιχείο ``sphinx.ext.autosummary`` της Python και μπορεί να αναγνωστεί χρησιμοποιώντας το :: \n\npydoc sphinx.ext.autosummary\n" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "αρχεία πηγής για να δημιουργηθούν τα αρχεία reST" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "ο κατάλογος που θα τοποθετεί όλο το αποτέλεσμα εξόδου" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "προεπιλεγμένη επέκταση για αρχεία (προεπιλογή: %(default)s)" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "προσαρμοσμένος κατάλογος προτύπου (προεπιλογή: %(default)s)" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "μέλη εισαγμένα στο έγγραφο (προεπιλογή: %(default)s)" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "Ορίσματα λέξης-κλειδί" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "Παράδειγμα" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Παραδείγματα" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "Σημειώσεις" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "Άλλες παράμετροι" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "Αναφορές" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "Προειδοποιήσεις" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "Αποδόσεις" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Προσοχή" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Προσοχή" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Κίνδυνος" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Σφάλμα" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Συμβουλή" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Σημαντικό" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Σημείωση" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Δείτε επίσης" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Πρακτική συμβουλή" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Προειδοποίηση" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "συνεχίζεται από την προηγούμενη σελίδα" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "συνέχεια στην επόμενη σελίδα" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "μη-αλφαβιτικά" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "Αριιθμοί" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "σελίδα" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "Πίνακας περιεχομένων" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Αναζήτηση" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Πάμε" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Προβολή κώδικα" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Επισκόπηση" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Καλωσήρθατε! Αυτή είναι" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "η τεκμηρίωση του" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "τελευταία ενημέρωση" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Ευρετήρια και πίνακες:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Πλήρης Πίνακας Περιεχομένων" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "απαριθμεί όλα τα κεφάλαια και υποκεφάλαια" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "αναζήτηση αυτής της τεκμηρίωσης" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Καθολικό Ευρετήριο Μονάδων" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "γρήγορη πρόσβαση σε όλες τις μονάδες" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "όλες οι συναρτήσεις, κλάσεις, όροι" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Ευρετήριο – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Πλήρες ευρετήριο σε μία σελίδα" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Σελίδες ευρετηρίου ανά γράμμα" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "μπορεί να είναι τεράστιο" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Πλοήγηση" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Αναζήτηση στο %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Σχετικά με αυτά τα κείμενα" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Copyright" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Copyright</a>%(copyright)s" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Copyright %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Τελευταία ενημέρωση στις %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Αναζήτηση %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Προηγούμενο θέμα" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "προηγούμενο κεφάλαιο" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Επόμενο θέμα" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "επόμενο κεφάλαιο" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Παρακαλώ, ενεργοποιήστε τη JavaScript για να είναι δυνατή η λειτουργία\n αναζήτησης." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "αναζήτηση" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Αποτελέσματα Αναζήτησης" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Η αναζήτησή σας δεν ταυτοποιήθηκε με κανένα κείμενο. Παρακαλώ, επιβεβαιώστε ότι όλες οι λέξεις έχουν τη σωστή ορθογραφία και ότι έχετε επιλέξεις αρκετές κατηγορίες." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Σύντομη αναζήτηση" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Αυτή η σελίδα" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Αλλαγές στην Έκδοση %(version)s —'\n%(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Αυτόματα παραγόμενη λίστα αλλαγών στην έκδοση %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Αλλαγές βιβλιοθήκης" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Αλλαγές στο API της C" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Άλλες αλλαγές" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Μόνιμος σύνδεσμος σε αυτήν την κεφαλίδα" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Μόνιμος σύνδεσμος σε αυτόν τον ορισμό" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Απόκρυψη Ευρεθέντων Αναζητήσεων" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Εκτελείται η αναζήτηση" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Προετοιμασία αναζήτησης..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Η αναζήτηση ολοκληρώθηκε, βρέθηκε/αν %s σελίδα/ες με βάση τους όρους αναζήτησης." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", στο " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Άνοιγμα πλαϊνής μπάρας" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Κλείσιμο πλαϊνής μπάρας" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Περιεχόμενα" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "βρέθηκε ευρετήριο βασιζόμενο σε 4 στήλες. Μπορεί να αποτελεί σφάλμα της επέκτασης που χρησιμοποιείτε: %r" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "Δεν υπάρχει αναφορά για την υποσημείωση [%s]." #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "Η υποσημείωση [#] δεν αναφέρεται." #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "ασυνεπείς αναφορές υποσημείωσης στα μεταφρασμένα μηνύματα. original: {0}, translated: {1}" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "ασυνεπείς αναφορές στα μεταφρασμένα μηνύματα. αρχικό: {0}, μεταφρασμένο: {1}" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "ασυνεπείς αναφορές παραπομπής στο μεταφρασμένο μήνυμα. αρχικό: {0}, μεταφρασμένο: {1}" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "ασυνεπείς αναφορές όρων στα μεταφρασμένα μηνύματα. αρχικό: {0}, μεταφρασμένο: {1}" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "περισσότεροι από ένας στόχοι βρέθηκαν για 'οποιαδήποτε' παραπομπή %r: θα μπορούσε να είναι %s" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "Δεν ήταν δυνατή η λήψη απομακρυσμένης εικόνας: %s [%d]" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "Δεν ήταν δυνατή η λήψη απομακρυσμένης εικόνας: %s [%s]" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "Άγνωστος τύπος αρχείου: %s..." #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "μη κωδικοποιήσιμοι χαρακτήρες πηγής, θα αντικατασταθούν με \"?\": %r" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "παράβλεψη" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "αποτυχία" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "σφάλμα ανάγνωσης: %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "καταγραφή λάθους: %s, %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "Ανέγκυρος τύπος ημερομηνίας. Τοποθετείστε στη στοιχειοσειρά μονά εισαγωγικά εάν θέλετε να το εξάγετε απευθείας: %s" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "το toctree περιλαμβάνει αναφορά σε άγνωστο αρχείο %r" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "εξαίρεση κατά την αξιολόγηση μόνο της έκφρασης οδηγίας: %s" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "ο προεπιλεγμένος ρόλος %s δεν βρέθηκε" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "δεν έχει καθοριστεί numfig_format για το %s" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "Κανένα ID δεν έχει ανατεθεί στο κόμβο %s" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Απευθείας σύνδεσμος σε αυτόν τον πίνακα" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Απευθείας σύνδεσμος σε αυτόν τον κώδικα" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Απευθείας σύνδεσμος σε αυτήν την εικόνα" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Απευθείας σύνδεσμος σε αυτόν τον πίνακα περιεχομένων" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "Δεν ήταν δυνατή η λήψη του μεγέθους της εικόνας. Η επιλογή :scale: θα αγνοηθεί." #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "άγνωστο toplevel_sectioning %r για την κλάσση %r" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "πολύ μεγάλο :maxdepth:, θα αγνοηθεί." #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "ο τίτλος του εγγράφου δεν είναι μονός κόμβος κειμένου" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "ο ανακαλυφθέν τίτλος κόμβος δεν βρίσκεται σε τομέα, θέμα, πίνακα, προειδοποίηση ή πλαϊνή μπάρα" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Σημειώσεις υποσέλιδου" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "τόσο η επιλογή για tabularcolumns όσο και για :widths: δίνονται. Η επιλογή :widths: θα αγνοηθεί." #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "η μονάδα διάστασης %s δεν είναι έγκυρη. Θα αγνοηθεί." #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "βρέθηκε άγνωστος τύπος εγγραφής ευρετηρίου %s" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[εικόνα: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[εικόνα]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "η λεζάντα δεν βρίσκεται εντός μίας εικόνας." #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "μη υλοποιημένος τύπος κόμβου: %r" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "άγνωστος τύπος κόμβου: %r" �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3245416 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_FR/�������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016074� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000032�00000000000�010210� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������26 mtime=1639903107.47418 ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_FR/LC_MESSAGES/�������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017661� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_FR/LC_MESSAGES/sphinx.js����������������������������������������������0000644�0000766�0000024�00000004605�00000000000�021535� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "None", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n != 1)" });���������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_FR/LC_MESSAGES/sphinx.mo����������������������������������������������0000644�0000766�0000024�00000000730�00000000000�021527� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$���������������,�����-����Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: en_FR Language-Team: English (France) (http://www.transifex.com/sphinx-doc/sphinx-1/language/en_FR/) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �����������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_FR/LC_MESSAGES/sphinx.po����������������������������������������������0000644�0000766�0000024�00000241445�00000000000�021544� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: English (France) (http://www.transifex.com/sphinx-doc/sphinx-1/language/en_FR/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: en_FR\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3247232 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_GB/�������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016055� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4749095 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_GB/LC_MESSAGES/�������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017642� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_GB/LC_MESSAGES/sphinx.js����������������������������������������������0000644�0000766�0000024�00000004606�00000000000�021517� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "en_GB", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n != 1)" });��������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_GB/LC_MESSAGES/sphinx.mo����������������������������������������������0000644�0000766�0000024�00000001012�00000000000�021502� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$���������������,�����-����Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-10-31 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: en_GB Language-Team: English (United Kingdom) (http://www.transifex.com/sphinx-doc/sphinx-1/language/en_GB/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_GB/LC_MESSAGES/sphinx.po����������������������������������������������0000644�0000766�0000024�00000241454�00000000000�021525� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-10-31 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: English (United Kingdom) (http://www.transifex.com/sphinx-doc/sphinx-1/language/en_GB/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: en_GB\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:430 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1166 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1173 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1167 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:421 msgid "Variables" msgstr "" #: sphinx/domains/python.py:425 msgid "Raises" msgstr "" #: sphinx/domains/python.py:648 sphinx/domains/python.py:792 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:708 sphinx/domains/python.py:884 #: sphinx/domains/python.py:935 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:710 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:735 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:736 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:797 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:799 sphinx/domains/python.py:939 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1093 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1094 msgid "modules" msgstr "" #: sphinx/domains/python.py:1143 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1169 msgid "class method" msgstr "" #: sphinx/domains/python.py:1170 msgid "static method" msgstr "" #: sphinx/domains/python.py:1172 msgid "property" msgstr "" #: sphinx/domains/python.py:1230 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1350 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1404 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:173 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:204 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:218 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:224 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:334 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:336 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:369 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:382 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:78 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3249023 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_HK/�������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016067� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4756534 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_HK/LC_MESSAGES/�������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017654� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_HK/LC_MESSAGES/sphinx.js����������������������������������������������0000644�0000766�0000024�00000004606�00000000000�021531� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "en_HK", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n != 1)" });��������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_HK/LC_MESSAGES/sphinx.mo����������������������������������������������0000644�0000766�0000024�00000001005�00000000000�021516� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$���������������,�����-����Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: en_HK Language-Team: English (Hong Kong) (http://www.transifex.com/sphinx-doc/sphinx-1/language/en_HK/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/en_HK/LC_MESSAGES/sphinx.po����������������������������������������������0000644�0000766�0000024�00000241450�00000000000�021533� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: English (Hong Kong) (http://www.transifex.com/sphinx-doc/sphinx-1/language/en_HK/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: en_HK\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3250897 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/eo/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015506� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4763823 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/eo/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017273� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/eo/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000005040�00000000000�021141� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "eo", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "A\u016dtora rajto", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "Indico universala", "Global Module Index": "Universala modjulindico", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "Indico – %(key)s", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "Sekva temo", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "Anta\u016da temo", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "sekvo \u0109apitro", "previous chapter": "anta\u016da \u0109apitro", "quick access to all modules": "", "search": "ser\u0109u", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n != 1)" });������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/eo/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000003500�00000000000�021137� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������#������4��������������L�� ���M�����W�����]�� ���q�����~��!����� ���������� ��������������� ����� ����������$��������;�����C�����K�� ���Q�����[�����a�� ���f�����p�����y����������������� ������������������������� �������������� ��������������� ����������%����� �������� ����������#�����;�� ���R�� ���]�� ���h��$���u��������������������������������������������������������������������������� ����������$�����,�����;���%b %d, %Y�%s %s�%s %s documentation�%s() (class)�Author: �Cannot find source directory (%s)�Copyright�Error�General Index�Global Module Index�Index – %(key)s�Next topic�Parameters�Previous topic�Python Enhancement Proposals; PEP %s�Symbols�Warning�Warns�attribute�class�data�exception�function�index�macro�member�next�next chapter�previous�previous chapter�search�see %s�see also %s�type�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: eo Language-Team: Esperanto (http://www.transifex.com/sphinx-doc/sphinx-1/language/eo/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �%b %d, %Y�%s %s�%s %s dokumentaro�%s() (klaso)�Aŭtoro:�Ne povas trovi fontan dosierujon (%s)�Aŭtora rajto�Eraro�Indico universala�Universala modjulindico�Indico – %(key)s�Sekva temo�Parametroj�Antaŭa temo�Python Enhancement Proposals; PEP %s�Simboloj�Averto�Avertoj�atributo�klaso�datenoj�escepto�funkcio�indico�nomaĵo�membro�sekva�sekvo ĉapitro�antaŭa�antaŭa ĉapitro�serĉu�vidu %s�vidu ankaŭ %s�tipo�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/eo/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000242367�00000000000�021162� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Dinu Gherman <gherman@darwin.in-berlin.de>, 2014 # Tatsuro YOKOTA <hidaruma@outlook.jp>, 2021 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Esperanto (http://www.transifex.com/sphinx-doc/sphinx-1/language/eo/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: eo\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Ne povas trovi fontan dosierujon (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Indico universala" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "indico" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "sekva" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "antaŭa" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s dokumentaro" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Aŭtoro:" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametroj" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "membro" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funkcio" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "nomaĵo" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "tipo" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "klaso" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (klaso)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "datenoj" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atributo" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "escepto" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "vidu %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "vidu ankaŭ %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Simboloj" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "Avertoj" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Eraro" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Averto" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Universala modjulindico" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Indico – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Aŭtora rajto" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Antaŭa temo" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "antaŭa ĉapitro" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Sekva temo" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "sekvo ĉapitro" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "serĉu" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3252752 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/es/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015512� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4772282 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/es/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017277� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/es/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000010370�00000000000�021147� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "es", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Derechos de autor</a> %(copyright)s.", "© Copyright %(copyright)s.": "© Derechos de autor %(copyright)s.", ", in ": ", en ", "About these documents": "Sobre este documento", "Automatically generated list of changes in version %(version)s": "Lista de cambios generada autom\u00e1ticamente en la versi\u00f3n %(version)s", "C API changes": "Cambios en la API C", "Changes in Version %(version)s — %(docstitle)s": "Cambios en la versi\u00f3n %(version)s — %(docstitle)s", "Collapse sidebar": "Contraer barra lateral", "Complete Table of Contents": "\u00cdndice de contenidos completo", "Contents": "Contenidos", "Copyright": "Copyright", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Expandir barra lateral", "Full index on one page": "\u00cdndice completo en una p\u00e1gina", "General Index": "\u00cdndice General", "Global Module Index": "\u00cdndice Global de M\u00f3dulos", "Go": "Ir a", "Hide Search Matches": "Ocultar coincidencias de la b\u00fasqueda", "Index": "\u00cdndice", "Index – %(key)s": "\u00cdndice – %(key)s", "Index pages by letter": "\u00cdndice alfab\u00e9tico de p\u00e1ginas", "Indices and tables:": "\u00cdndices y tablas:", "Last updated on %(last_updated)s.": "Actualizado por \u00faltima vez en %(last_updated)s.", "Library changes": "Cambios en la biblioteca", "Navigation": "Navegaci\u00f3n", "Next topic": "Pr\u00f3ximo tema", "Other changes": "Otros cambios", "Overview": "Resumen", "Permalink to this definition": "Enlazar permanentemente con esta definici\u00f3n", "Permalink to this headline": "Enlazar permanentemente con este t\u00edtulo", "Please activate JavaScript to enable the search\n functionality.": "Por favor, active JavaScript para habilitar la funcionalidad\n de b\u00fasqueda.", "Preparing search...": "Preparando b\u00fasqueda...", "Previous topic": "Tema anterior", "Quick search": "B\u00fasqueda r\u00e1pida", "Search": "B\u00fasqueda", "Search Page": "P\u00e1gina de B\u00fasqueda", "Search Results": "Resultados de la b\u00fasqueda", "Search finished, found %s page(s) matching the search query.": "B\u00fasqueda finalizada, encontr\u00f3 %s p\u00e1gina(s) acorde con la consulta de b\u00fasqueda.", "Search within %(docstitle)s": "Buscar en %(docstitle)s", "Searching": "Buscando", "Searching for multiple words only shows matches that contain\n all words.": "La b\u00fasqueda de varias palabras solo muestra coincidencias que contienen\n todas las palabras.", "Show Source": "Mostrar el c\u00f3digo", "Table of Contents": "Tabla de contenido", "This Page": "Esta p\u00e1gina", "Welcome! This is": "\u00a1Bienvenido! Este es", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Su b\u00fasqueda no coincide con ning\u00fan documentos. Por favor, aseg\u00farese de que todas las palabras est\u00e9n correctamente escritas y que usted all\u00e1 seleccionado las suficientes categor\u00edas.", "all functions, classes, terms": "todas las funciones, clases, t\u00e9rminos", "can be huge": "puede ser muy grande", "last updated": "actualizado por \u00faltima vez el", "lists all sections and subsections": "muestra todas las secciones y subsecciones", "next chapter": "pr\u00f3ximo cap\u00edtulo", "previous chapter": "cap\u00edtulo anterior", "quick access to all modules": "acceso r\u00e1pido a todos los m\u00f3dulos", "search": "buscar", "search this documentation": "buscar en esta documentaci\u00f3n", "the documentation for": "la documentaci\u00f3n para" }, "plural_expr": "(n != 1)" });������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/es/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000211675�00000000000�021161� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������,��������������<*����=*�����+��E��,��r���-��l���k.�� ���.�����.��*���.��=���/��7���U/��H���/��?���/��"���0�� ���90�����C0��%���L0�����r0�����0�����0�����0�����0�� ���0�����0�����0�����1�����#1�� ���21�����S1�� ���e1�� ���q1�� ���{1��S���1�����1��A���2�����I2�����`2�����w2�����2�����2�� ���2�����2��6���2�����3�����13��$���M3�����r3��3���,4�� ���`4�����l4�����t4��1���z4��1���4��G���4�����&5�����>5��0���Q5�����5��H���5�����5��b���6�����6��6���6�����/7�� ���E7�� ���f7�� ���p7�����z7�����7��>���7�� ���7��(���7��(���8�����-8��?���L8�����8�� ���8��!���8��8���8��%���8�����$9�����,9��4���B9�� ���w9�� ���9�����9�����9�����9�����9�� ���9��%���:��%���+:�����Q:��:���o:��7���:�����:��"���:�����;�����.;�� ���5;�����@;�����\;��`���x;�����;��&���;�����<��D���<��H���[<��K���<�����<����� =�����=��5���=�����P=�����d=�����s=��8���=��'���=��"���=��3��� >��"���=>��#���`>�����>��!���>��:���>�����>�� ��� ?�� ���*?�����4?�� ���K?�����Y?�����m?��C���p?�����?�����?��3��?��.���A�� ���0A��.���:A�����iA�����oA�����A��D���A�����A�����A�� ���B�����B��[����C�����\C�����zC�����C��Y���C��!���D�����&D��2���6D�� ���iD��C���tD�����D��n���D��E���GE�� ���E�����E�� ���E�� ���E��-���E��(���E�� ���F�����%F�� ���7F��(���BF�����kF�����F�����F��Z���F�����F�����F��,���G����0G�����GH�����\H�� ���mH�����{H�����H�� ���H�����H�����H�����H�����H�����I�����'I�����?I��&���YI��B���I��i���I��2���-J��I���`J��4���J�����J�����J�����K�����7K��y���OK�����K�����K�����K�����L�� ���L����� L�����0L�����CL��#���SL��$���wL�����L�� ���L�����L�����L�� ���L�����L�� ���L�����L�����L�����M�����/M�����6M�� ���KM�����WM��<���fM�����M�� ���M��K���M�� ���N����� N�����1N�����:N��+���QN�� ���}N��>���N�����N��#���N�����N�����O�����O�����.O�����7O�����IO��Y���]O��Z���O��*���P��3���=P��/���qP��(���P��.���P��P���P��p���JQ�����Q��!���Q��"���Q��$��� R�� ���ER��e���fR��Z���R��N���'S��T���vS��K���S��%���T�����=T��[���]T��#���T��'���T��#���U��I���)U��'���sU��!���U��=���U��7���U�� ���3V��d���=V��W���V��v���V�����qW�����xW�����|W�� ���W��3���W�����W�����W��"��� X��<���,X��Y���iX�� ���X�����X�����X��,���X�����Y�����Y�����/Y�����6Y��Y����Z�����ZZ��%���Z��,��� [�����8[�����T[�� ���[[�����g[�� ���o[�����{[�����[��N���[�����[��?���g\��-���\��2���\�����]�����&]�����9]��9���J]�����]�� ���]�� ���]��X���]��,���^��2���<^��b���o^��5���^��\���_��M���e_��(���_��G���_�����$`��7���9`�����q`��8���`�����`�� ���`��%���`��`���a�����ha�����a�����a�����a�����a�� ���a��&���a��$��� b�����/b�����Ib�����gb�����b�����b��A���b��Z���b��-���Tc�����c�����c�����c��!���c��8���c�����.d�� ���4d�����Ad�����Ud��7���]d��6���d��;���d��I���e��;���Re��:���e��H���e��9���f��G���Lf��2���f��2���f�����f��4��� g�����>g�����Ug�����rg��C���g��2���g������h�����h�����7h�����Uh�����nh�����h�����h�����h��(���h��=���h�����3i�����Di��0���Ti�����i�����i��/���i�����i��*���i��&���j�� ���Aj��9���Kj�����j�����j�� ���j�����j��-���j�����k�����0k��1���Gk��*���yk�����k�����k��0���k��&���k�����l�����-l��(���Ml�����vl�����l�����l��%���l��e���l�����Lm��4���m�����#n�����(n��Y���8n��;���n��.���n�����n�����o�����5o��.���Po��4���o��+���o��4���o��(���p��4���>p��W���sp�����p�����p�����p��X���q��J���sq�����q��%���q�� ���q�����q����� r��+���"r�����Nr�����hr�� ���r��8���r��M���r��u���s�����s�����s�����s�����s�����s��A���s�� ���0t�����;t��6���Zt��I���t��A���t�����u��0���8u�����iu��G���u��N���u�����v����� v��.���0v�����_v��4���rv�� ���v��,���v��3���v�� ���w��=���$w�����bw��'���w��0���w��(���w��1���x��,���3x��!���`x�����x�����x�����x��=���x��+���y��0���By��V���sy��V���y��M���!z��R���oz��$���z�����z�����z��N���{��0���P{��)���{�����{�����{�����{��/���{�����,|�����F|�����e|��&���||��!���|��&���|�����|��E���|�� ���:}��*���G}��7���r}��"���}��(���}�����}�����~�����0~��"���L~�����o~�����u~�����~��;���~�����~�����~��"���~��!��������1��#���8�����\��D���d��5����� ���������� �����1�����E���.��B���t��G�����%��������%��#���?��#���c��,����������-���Ё��(�����D���'�� ���l��#���w��(�����#���Ă�����������������(��������0�����I��8���N�� �����P�����"�������������7��O���P���������������Ʉ�����҄��%����� ��� �������,���&�� ���S��(���`��E����� ���υ��*���܅��1�����7���9�����q�� �����������������������Ն������������&��������5�����M��4���R�������%��������‡��c���ɇ�����-�����G�� ���N��'���Z��:����� �����@���ވ����������'�����D��&���W��*���~��&�����W���Љ��>���(��7���g�� ����� ����� �����,�����*�����0��������J��%���h����������&��1�����1��������"��\���8�������'�����%���ٍ��+�����^���+��2�����5������������������,��5���1�����g�������+�����-����������!�����!���!�����C��!���Y�����{�������#�����*��������������������P��������n��)�����9�����;�����)���-�����W�����_�����r��������������������ג�������������Ȕ��!����S�������������� ���4�����@��1���F��Z���x��T���Ӛ��M���(��\���v��"���ӛ������� �����1�����"���E��$���h����������������� ��������͜����������������� ��������?�� ���U�����b��$���k��{�������� ��I���,�����v���������������������� �������� ��>���!��'���`�������(��������џ��9���Ǡ�����������������A���#��A���e��\���������������<���2�����o��P����������t����������;���#�����_��(���x�� ����� ����� ����������E���Ȥ�� �����+�����5���D��&���z��T������������� ��&���!��H���H��,����� ��������Ȧ��8�����%��������B�����V�����m��&����� ����� �����.���ȧ��.�����"���&��>���I��I��������Ҩ��/�������������,�����4�����=�����[��s���z�������-��������4��B���:��N���}��O���̪����������2�����:��6���C�����z������������F���ī��*��� ��=���6��3���t��*�����@���Ӭ�� �����#�����=���B��)�����*��������խ���������� ����������7��X���<��%����������?��î��0����� ���4��>���?�����~������������H����������������������.��c���G�� �����#���̲���������� ��0����������F���ڳ�����!��R���*��"���}�������S���"�����v�����������������)���µ��<����� ���)�����5�� ���M��J���[��&��������Ͷ�����ܶ��_��������A�����G��:���P��*������������̸�� ���޸������������ �����'�����,���C��"���p��(�������������ܹ��*�����7���&��N���^�������F���8��\�����D���ܻ��-���!��*���O�����z�� �������������N�� ���f�����t��������������������ս�������0�����$���3�����X�����s������������ ������������������Ͼ��!���ؾ������� �������������2�����G��R���b����������Ϳ��`���ֿ�� ���7�����C�� ���Z�����g��,����������?����������+��������I�� ���`�����j�����������������\�����[�����'���q��2�����0�����%�����,���#��a���P�������!���D��'���f��(�����*�����&�������� ��x�����Z�����a���p��S�����+���&��$���R��^���w��-�����0�����*���5��T���`��-�����+�����=�����=���M�� �����Z�����b��������V�� ���������� ����������B����� ���^��$�����%�����a�����s���,�� ����� ����������8������������� �����'�����.��[��������b��&�����*���D�����o�� ���������� ����� ���������������T��������)��Q�����9���*��>���d��&���������������M��������K�����j�����s��]���{��4�����@�����g���O��9�����a�����e���S��/�����U��������?��H���T�������J�����!����� ���(��4���6��s���k��9�����&��������@�����Q�����b�����w��7�����-�����#�����+�����'���B��&���j��2�����c��������(��<�����-�����#���"�����F��6���_��A�������������������������G�����H���`��M�����\�����M���T��L�����Y�����K���I��Y�����B�����D���2�����w��@��������������� �����^���1��1����� �����#�����$��������,��!���J�����l������������@�����E��������;�����K��E���Z������� �����A����� �����2���)��3���\�� �����8����������&�����)��� �����5��?���M������������A�����*���������� ���:��;���D��.���������������6�������������7�����U��)���s����������*��<���������������x���(��<�����-�����(��� �����5��$���R��.���w��5�����,�����5��� ��+���?��;���k��b�����6��� �����A��!���Z��a���|��[��������:��%���?�� ���e�����r�������)����� �����&����� �����;�����c���Y��y��������7�����N�����f�����n�������L����� �����-�����<���1��S���n��R�����$�����E���:�������S�����`��������L�����U��2���h�������>����������?�����G���A�������W�����$�����$�����5���A��%���w��6�����E�����+�����#���F�����j�������C�����D�����9���2��Z���l��c�����Q���+��]���}��(������������� ��u���#��=�����0���������� ���#�����D��H���d������� �����)�����9����� ���N��/���o�� �����Y����������G���&��@���n��*�����+�������������#�����B��(���_�����������������[��������#�����+��#���3��$���W�����|��)����������]�����B��������X�� ���m�����w��A�����Z�����a���'��\�����2����������+���8��$���d��T�����)�����?�����6���H��K����� �����(�����/�����'���2�����Z�����a�����j��7���{��!����������A�����"����[���B�/������������n�������w�������������/���� ��������C�������S�>���g�c������� �B����;���`�M����#���������������7����M����`����v�����(������������2�������!�%���<����b�s���i�������������/����T���B�&����C����������� ����(�.���A�)���p�$����f����D���& �:���k � ��� ���� ���� �?��� �8��� �D���D �,��� �4��� ���� ���� �3���9 �5���m ���� �Z��� �!��� �-���7 �*���e �5��� �d��� �4���+�9���`�&����!��������;���� ���$����E�3���L�?����)����4����'�������G�(���d����� ����'����?���������������4�^���O�$����2����N����V���U�/���� �������� ���� ���#����D�%���^�����!����� Generate ReStructuredText using autosummary directives. sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates the reStructuredText files from the autosummary directives contained in the given input files. The format of the autosummary directive is documented in the ``sphinx.ext.autosummary`` Python module and can be read using:: pydoc sphinx.ext.autosummary � Generate required files for a Sphinx project. sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build. � Look recursively in <MODULE_PATH> for Python modules and packages and create one reST file with automodule directives per package in the <OUTPUT_PATH>. The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be excluded from generation. Note: By default this script will not overwrite already created files.� Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� Run 'make' in that directory to run these through makeinfo (use 'make info' here to do that automatically).� (deprecated)� (in �"::" in automodule name doesn't make sense�"latex_documents" config value references unknown document %s�"man_pages" config value references unknown document %s�"quiet" is specified, but any of "project" or "author" is not specified.�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%r doesn't have "%s" setting�%r doesn't have "theme" setting�%s %s�%s %s documentation�%s (%s attribute)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command %r cannot be run (needed for math display), check the imgmath_%s setting�%s command line option�%s is already assigned section numbers (nested numbered toctree?)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �-A option argument must be in the form name=value�-D option argument must be in the form name=value�4 column based index found. It might be a bug of extensions you use: %r�:%s: (directive option)�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�====================== slowest reading durations =======================�A Makefile and a Windows command file can be generated for you so that you only have to run e.g. `make html' instead of invoking sphinx-build directly.�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�About these documents�An error happened in rendering the page %s. Reason: %r�Anchor '%s' not found�Any IDs not assigned for %s node�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not fetch remote image: %s [%d]�Could not fetch remote image: %s [%s]�Could not import extension %s�Could not lex literal_block as "%s". Highlighting skipped.�Could not obtain image size. :scale: option is ignored.�Create Makefile? (y/n)�Create Windows command file? (y/n)�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Encoding error:�Enter the root path for documentation.�Error�Error: an existing conf.py has been found in the selected root path.�Error: specified path is not a directory, or sphinx files already exist.�Error: the master file %s has already been found in the selected root path.�Event %r already present�Example�Examples�Exception occurred while building, starting debugger:�Exception occurred:�Expand sidebar�Extension options�External Graphviz file %r not found or reading it failed�Failed to parse type_comment for %r: %s�Failed to read build info file: %r�Failed to read intersphinx_mapping[%s], ignored: %r�Failed to scan documents in %s: %r�Failed to write build info file: %r�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnote [#] is not referenced.�Footnote [%s] is not referenced.�Footnotes�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Hide Search Matches�Hint�If the documents are to be written in a language other than English, you can select a language here by its language code. Sphinx will then translate text that it generates into that language. For a list of supported codes, see https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indicate which of the following Sphinx extensions should be enabled:�Indices and tables:�Inside the root directory, two more directories will be created; "_templates" for custom HTML templates and "_static" for custom stylesheets and other static files. You can enter another prefix (such as ".") to replace the underscore.�Interrupted!�Invalid caption: %s�Invalid date format. Quote the string by single quote if you want to output it directly: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�Keyword Arguments�LaTeX command %r cannot be run (needed for math display), check the imgmath_latex setting�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Look for any errors in the above output or in %(outdir)s/output.txt�Makefile and Batchfile creation�Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Many math_renderers are registered. But no math_renderer is selected.�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Non-alphabetical�Note�Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.�Notes�Numbers�Object named %r not found in include file %r�One document is special in that it is considered the top node of the "contents tree", that is, it is the root of the hierarchical structure of the documents. Normally, this is "index", but if your "index" document is a custom template, you can also set this to another filename.�Original exception: �Other Parameters�Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Pillow not found - copying image files�Please activate JavaScript to enable the search functionality.�Please also report this if it was a user error, so that a better error message can be provided next time.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter a new file name, or rename the existing file and press Enter�Please enter a new root path (or just Enter to exit)�Please enter a valid path name.�Please enter either 'y' or 'n'.�Please enter one of %s.�Please enter some text.�Please enter values for the following settings (just press Enter to accept a default value, if one is given in brackets).�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project templating�Project version�Pygments lexer name %r is not known�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Recursion error:�References�Release�Return type�Returns�Root path for the documentation�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Searching for multiple words only shows matches that contain all words.�Section %s�Section author: �See also�Selected root path: %s�Separate source and build directories (y/n)�Show Source�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Structure options�Symbols�TODO entry found: %s�Table %s�Table of Contents�Template Parameters�Testing of coverage in the sources finished, look at the results in %(outdir)spython.txt.�Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt.�The %r crossref_type is already registered�The %r directive is already registered to domain %s�The %r index is already registered to domain %s�The %r object_type is already registered�The %r role is already registered to domain %s�The %s extension is required by needs_extensions settings, but it is not loaded.�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.�The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.�The config value `{name}' has type `{current.__name__}'; expected {permitted}.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The dummy builder generates no files.�The ePub file is in %(outdir)s.�The full traceback has been saved in %s, if you want to report the issue to the developers.�The manual pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�The overview file is in %(outdir)s.�The project name will occur in several places in the built documentation.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Translator for %r already exists�Unknown configure key: latex_elements[%r], ignored.�Unknown event name: %s�Unknown image format: %s...�Unknown math_renderer %r is given.�Use the Makefile to build the docs, like so: make builder�Use the sphinx-build command to build the docs, like so: sphinx-build -b builder %s %s�Variables�Warning�Warns�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�Would create file %s.�Yields�You have two options for placing the build directory for Sphinx output. Either, you use a directory "_build" within the root path, or you separate "source" and "build" directories within the root path.�You should now populate your master file %s and create other documentation source files. �Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[autosummary] failed to import %r: %s�[autosummary] generating autosummary for: %s�[autosummary] writing to %s�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.�a list of specific files to rebuild. Ignored if -a is specified�a suitable image for %s builder not found: %s�a suitable image for %s builder not found: %s (%s)�all functions, classes, terms�all of %d po files�all source files�append module_path to sys.path, used when --full is given�assembling single document�attribute�author names�autodoc: failed to determine %r to be documented, the following exception was raised: %s�automatically insert docstrings from modules�automatically test code snippets in doctest blocks�autosummary generats .rst files internally. But your source_suffix does not contain .rst. Skipped.�autosummary references excluded document %r. Ignored.�autosummary: failed to determine %r to be documented, the following exception was raised: %s�autosummary: stub file not found %r. Check your autosummary_generate setting.�autosummary_generate: file not found: %s�both tabularcolumns and :widths: option are given. :widths: is ignored.�broken link: %s (%s)�build %s, %s warning (with warnings treated as errors).�build %s, %s warning.�build %s, %s warnings (with warnings treated as errors).�build %s, %s warnings.�build %s.�build environment version not current�build in parallel with N processes where possible (special value "auto" will set N to cpu-count)�build info file is broken: %r�builder to use (default: html)�building [%s]: �building [mo]: �built-in function�can be huge�cannot combine -a option and filenames�cannot copy downloadable file %r: %s�cannot copy extra file %r�cannot copy image file %r: %s�cannot copy static file %r�cannot find files %r�cannot open warning file %r: %s�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�cannot read image file %r: copying it instead�cannot write image file %r: %s�caption not inside a figure.�checking consistency�checks for documentation coverage�circular toctree references detected, ignoring: %s <- %s�class�class method�command line option�concept�conditional inclusion of content based on config values�conf value "epub_author" should not be empty for EPUB3�conf value "epub_contributor" should not be empty for EPUB3�conf value "epub_copyright" (or "copyright")should not be empty for EPUB3�conf value "epub_description" should not be empty for EPUB3�conf value "epub_identifier" should not be empty for EPUB3�conf value "epub_language" (or "language") should not be empty for EPUB3�conf value "epub_publisher" should not be empty for EPUB3�conf value "epub_title" (or "html_title") should not be empty for EPUB3�conf value "epub_uid" should be XML NAME for EPUB3�conf value "version" should not be empty for EPUB3�config changed�config directory doesn't contain a conf.py file (%s)�console output options�continued from previous page�continues on next page�convert command %r cannot be run, check the image_converter setting�convert exited with error: [stderr] %r [stdout] %r�copying TeX support files�copying TeX support files...�copying Texinfo support files�copying additional files�copying downloadable files... �copying extra files�copying images... �copying source files...�could not read %r for changelog creation�create .nojekyll file to publish the document on GitHub pages�create batchfile�create makefile�custom template directory (default: %(default)s)�data�default role %s not found�default suffix for files (default: %(default)s)�define a template variable�define tag: include "only" blocks with TAG�dimension unit %s is invalid. Ignored.�directive�directive %r is already registered, it will be overridden�directive-option�directory to place all output�directory to place all output in�display latex %r: %s�do emit colored output (default: auto-detect)�do not create batchfile�do not create makefile�do not emit colored output (default: auto-detect)�do not use make-mode for Makefile/make.bat�docnames to write: %s�document�document imported members (default: %(default)s)�document isn't included in any toctree�document language�document not readable. Ignored.�document title is not a single Text node�doing serial %s�domain %s already registered�domain %s not yet registered�don't create a table of contents file�don't create headings for the module/package packages (e.g. when the docstrings already contain them)�don't know which module to import for autodocumenting %r (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)�don't use a saved environment, always read all files�done�dot code %r: %s�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�dot did not produce an output file: [stderr] %r [stdout] %r�dot exited with error: [stderr] %r [stdout] %r�download file not readable: %s�dumping object inventory�dumping search index in %s�duplicate %s description of %s, other %s in %s�duplicate %s description of %s, other instance in %s�duplicate citation %s, other instance in %s�duplicate description of %s %s, other instance in %s�duplicate label %s, other instance in %s�duplicate label of equation %s, other instance in %s�duplicate object description of %s, other instance in %s, use :noindex: for one of them�duplicated ToC entry found: %s�enable %s extension�enable arbitrary extensions�encountered some issues with some of the inventories, but they had working alternatives:�encountered title node not in section, topic, table, admonition or sidebar�enum�enumerable_node %r already registered�enumerator�environment variable�environment variable; %s�error while formatting arguments for %s: %s�error writing file %s: %s�error writing file Makefile: %s�exception�exception while evaluating only directive expression: %s�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extension options�extensions changed�failed�failed to import object %s�failed to parse name %s�failed to reach any of the inventories with the following issues:�failed: %s�favicon file %r does not exist�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�filename of table of contents (default: modules)�finished with problems�fnmatch-style file and/or directory patterns to exclude from generation�follow symbolic links. Powerful when combined with collective.recipe.omelette.�function�general options�generate a full project with sphinx-quickstart�generating indices�glossary seems to be misformatted, check indentation�glossary term�glossary term must be preceded by empty line�glossary terms must not be separated by empty lines�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�highlighting module code... �html_extra_path entry %r does not exist�html_extra_path entry %r is placed inside outdir�html_static_path entry %r does not exist�html_static_path entry %r is placed inside outdir�if specified, separate source and build dirs�ignoring invalid doctest code: %r�image file %s not readable: %s�image file not readable: %s�include "_private" modules�include links to the source code of documented Python objects�include math, rendered as PNG or SVG images�include math, rendered in the browser by MathJax�inconsistent citation references in translated message. original: {0}, translated: {1}�inconsistent footnote references in translated message. original: {0}, translated: {1}�inconsistent references in translated message. original: {0}, translated: {1}�inconsistent term references in translated message. original: {0}, translated: {1}�increase verbosity (can be repeated)�index�inline latex %r: %s�interpret module paths according to PEP-0420 implicit namespaces specification�intersphinx identifier %r is not string. Ignored�intersphinx inventory has moved: %s -> %s�invalid TestCode type�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�invalid regex %r in %s�invalid regex %r in coverage_c_regexes�invalid signature for auto%s (%r)�job number should be a positive number�keyword�kwargs for add_node() must be a (visit, depart) function tuple: %r=%r�last updated�line number spec is out of range(1-%d): %r�link between Sphinx documentation of different projects�lists all sections and subsections�loading intersphinx inventory from %s...�loading pickled environment�loading translations [%s]... �logo file %r does not exist�looking for now-outdated files... �macro�making output directory�master document name�maximum depth of submodules to show in the TOC (default: 4)�member�method�missing '+' or '-' in '%s' option.�missing attribute %s in object %s�module�module %s could not be imported: %s�modules�more than one target found for 'any' cross-reference %r: could be %s�more than one target found for cross-reference %r: %s�new config�next�next chapter�nit-picky mode, warn about all missing references�no "latex_documents" config value found; no documents will be written�no "man_pages" config value found; no manual pages will be written�no "texinfo_documents" config value found; no documents will be written�no Babel option known for language %r�no changes in version %s.�no code/output in %s block at %s:%s�no output at all, not even warnings�no output on stdout, just warnings on stderr�no targets are out of date.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�none found�not available for built-in messages�numfig is disabled. :numref: is ignored.�numfig_format is not defined for %s�object�operator�original entry�override a setting in configuration file�overwrite existing files�page�page %s matches two patterns in html_sidebars: %r and %r�pass a value into HTML templates�path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)�path to documentation source files�path to module to document�path to output directory�path where configuration file (conf.py) is located (default: same as SOURCEDIR)�pickling environment�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�program option�project author(s), used when --full is given�project name�project name (default: root module name)�project release, used when --full is given, defaults to --doc-version�project root�project version, used when --full is given�put documentation for each module on its own page�put module documentation before submodule documentation�quick access to all modules�quiet mode�reST markup error:�reading error: %s, %s�reading sources... �reading templates... �reference label�release of project�replacement for dot in _templates etc.�resolving references...�role�role %r is already registered, it will be overridden�run Pdb on exception�run the script without creating files�search�search index couldn't be loaded, but not all documents will be built: the index will be incomplete.�search this documentation�see %s�see also %s�self referenced toctree found. Ignored.�setting %s.%s occurs in none of the searched theme configs�show full traceback on exception�signature arguments or return annotation given for automodule %s�skipped�source directory has changed�source file suffix�source files to generate rST files for�source_parser for %r is already registered�source_suffix %r is already registered�sphinx-quickstart only generate into a empty directory. Please specify a new root path.�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�statement�static method�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�targets for %d template files�template directory for template files�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension is not safe for parallel reading�the %s extension is not safe for parallel writing�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�toctree contains ref to nonexisting file %r�toctree contains reference to document %r that doesn't have a title: no link will be generated�toctree contains reference to excluded document %r�toctree contains reference to nonexisting document %r�too large :maxdepth:, ignored.�turn warnings into errors�type�undecodable source characters, replacing with "?": %r�unimplemented node type: %r�union�unknown %r toplevel_sectioning for class %r�unknown config value %r in override, ignoring�unknown index entry type %r�unknown index entry type %s found�unknown mimetype for %s, ignoring�unknown node type: %r�unsupported theme option %r given�updating environment: �use epub�use make-mode for Makefile/make.bat�use no config file at all, only -D options�variable�version of project�waiting for workers...�where "builder" is one of the supported builders, e.g. html, latex or linkcheck.�while setting up extension %s:�with -W, keep going when getting warnings�write "todo" entries that can be shown or hidden on build�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing�writing %s file...�writing additional files�writing additional pages�writing error: %s, %s�writing message catalogs... �writing output... �writing summary file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-10-31 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: es Language-Team: Spanish (http://www.transifex.com/sphinx-doc/sphinx-1/language/es/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � Genere ReStructuredText usando directivas de resumen automático "autosummary". sphinx-autogen es una interfaz para sphinx.ext.autosummary.generate. Genera los archivos reStructuredText de las directivas autosummary contenidas en el los archivos de entrada dados. El formato de la directiva autosummary está documentado en el módulo Python ``sphinx.ext.autosummary`` y se puede leer usando el siguiente comando:: pydoc sphinx.ext.autosummary � Genere los archivos necesarios para un proyecto Sphinx. sphinx-quickstart es una herramienta interactiva que hace algunas preguntas sobre su proyecto y luego genera un directorio completo de documentación y un ejemplo del archivo Makefilepara ser utilizado con el comando sphinx-build. � Mire recursivamente en <MODULE_PATH> para módulos y paquetes de Python y cree un archivo reST con directivas automodule por paquete en el <OUTPUT_PATH>. Los <EXCLUDE_PATTERN>s pueden ser patrones de archivo y/o directorio que serán excluidos de la generación. Nota: Por defecto, este script no sobrescribirá los archivos ya creados.� Ejecuta el comando 'make' en este directorio para compilarlos usando (pdf)latex (usa el comando 'make latexpdf' aquí para hacer esto automáticamente).� Ejecute el comando 'make' en ese directorio para ejecutarlos a través de makeinfo (usa el comando 'make info' aquí para hacer esto automáticamente).� (obsoleto)� (en �"::" en el nombre del automodule no tiene sentido�El valor de configuración "latex_documents" hace referencia a un documento desconocido %s�El valor de configuración "man_pages" hace referencia a un documento desconocido %s�se especifica "quiet", pero no se especifica ninguno de "project" o "author".�El valor de configuración "texinfo_documents" hace referencia a un documento desconocido %s�%(filename)s — %(docstitle)s�%d de %B de %Y�encontrado %d�%d archivos fuente dados en la línea de comandos�%r no tiene configuración de "%s"�%r no tiene configuración de "tema"�%s %s�documentación de %s - %s�%s (atributo de %s)�%s (C++ %s)�%s (clase incorporada)�%s (variable incorporada)�%s (clase en %s)�%s (directiva)�%s (variable global o constante)�%s (en el módulo %s)�%s (módulo)�%s (rol)�%sañadido, %s cambiado, %s removido�El comando%s %r no se puede ejecutar (necesario para la visualización matemática), verifique la configuración imgmath_%s�%sopción de línea de comando �%s ya tiene asignados números de sección (¿número de árbol anidado?)�%s no es un directorio.�%s() (método de clase de %s)�%s() (método de %s)�%s() (método estático de %s)�%s() (función incorporada)�%s() (clase)�%s() (en el módulo %s)�© <a href="%(path)s">Derechos de autor</a> %(copyright)s.�© Derechos de autor %(copyright)s.�'%s' no es una opción válida.�'%s' no es una opción pyversion válida�'setup' como se define actualmente en el archivo conf.py no es un Python invocable. Por favor, modifique su definición para que sea una función invocable. Esto es necesario para que el archivo conf.py se comporte como una extensión de Sphinx.�(La <<entrada original>> se encuentra en %s, línea %d.)�(en %s versión %s)�(en %s)�, en �El argumento de la opción -A debe estar en la forma nombre=valor�El argumento de la opción -D debe estar en la forma nombre=valor�Índice basado en 4 columnas encontrado. Puede ser un error de extensiones que usted usa: %r�:%s: (opción directiva)�<<entrada original>>�<h1>Todos los módulos para los cuales disponen código</h1>�<h1>Código fuente para %s</h1>�====================== duraciones de lectura más lentas =======================�Se puede generar un archivo Makefile y un archivo de comandos de Windows para que usted solo tiene que ejecutar, por ejemplo, `make html' en lugar de invocar sphinx-build directamente.�Se puede presentar un informe de error en el rastreador en <https://github.com/sphinx-doc/sphinx/issues>. ¡Gracias!�Sobre este documento�Ha ocurrido un error al renderizar la pagina %s. Motivo: %r�Ancla '%s' no encontrado�Cualquier ID no asignado para el nodo %s�Argumentos�Atención�Autor(es)�Autor: �Lista de cambios generada automáticamente en la versión %(version)s�Bases: %s�Constructor %r ya existe (en el módulo %s)�Constructor clase %s no tiene ningún atributo "name"�Nombre de constructor %s no registrado�Nombre de constructor %s no registrados o disponibles a través del punto de entrada�Funciones incorporadas�Cambios en la API C�No se encuentra directorio fuente (%s)�No puede utilizar a "lineno-match" con un conjunto desunido de "líneas"�No puede utilizar ambas opciones "%s" y "%s"�Prudencia�Distinto en la versión %s�Cambios en la versión %(version)s — %(docstitle)s�Citación [%s] no está referenciada.�Código del autor: �Contraer barra lateral�Índice de contenidos completo�Valor de configuración %r ya presente�Contenidos�Copyright�No se pudo recuperar la imagen remota: %s [%d]�No se pudo recuperar la imagen remota: %s [%s]�No puede importar la extensión %s�No pudo el léxico literal_block como "%s". Destacado omitido.�No se pudo obtener el tamaño de la imagen. La opción :scale: se ignora.�Crear Makefile? (y/n)�¿Crear archivo de comandos para Windows? (y/n)�Creando archivo %s.�Peligro�Obsoleto�Obsoleto desde la versión %s�Dominio %r no está registrado�Codificación %r usado para la lectura archivo incluido %r parece estar mala, trate de darle una opción :encoding:�Error de codificación:�Ingrese la ruta raíz para la documentación.�Error�Error: un archivo conf.py ya existe en la ruta raíz seleccionada.�Error: la ruta especificada no es un directorio, o ya existen archivos sphinx.�Error: el archivo maestro %s ya se ha encontrado en la ruta raíz seleccionada.�Evento %r ya presente�Ejemplo�Ejemplos�Ha ocurrido un error al compilar, iniciando depurador:�Ha ocurrido una excepción:�Expandir barra lateral�Opciones de extensión�Archivo externo Graphviz %r no encontrado o la lectura del mismo fallo�Error al analizar type_comment para %r: %s�Error al leer la información de compilación del fichero: %r�Error al leer intersphinx_mapping[%s], ignorado: %r�Error al escanear los documentos en %s: %r�Error al escribir el archivo de información de compilación: %r�Figura %s�El archivo %s ya existe, omitiendo.�Terminado: se ha creado una estructura de directorio inicial.�Pie de página [#] no está referenciado.�Pie de página [%s] no está referenciado.�Notas a pie de página�Índice completo en una página�Índice General�Índice Global de Módulos�Ir a�Directiva Graphviz no puede tener tanto el contenido y un argumento de nombre de archivo�Ocultar coincidencias de la búsqueda�Consejo�Si los documentos deben escribirse en un idioma que no sea inglés, puede seleccionar un idioma aquí por su código de idioma. Sphinx entonces traducir el texto que genera a ese idioma. Para obtener una lista de códigos compatibles, vea https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Ignorando la directiva "graphviz" sin contenido.�Importante�Archivo incluido %r no encontrado o la lectura del mismo fallo�Índice�Índice – %(key)s�Índice alfabético de páginas�Indique cuál de las siguientes extensiones de Sphinx deben habilitarse:�Índices y tablas:�Dentro del directorio raíz, se crearán dos directorios más; "_templates" para plantillas HTML personalizadas y "_static" para hojas de estilo personalizadas y otras archivos estáticos. Puede ingresar otro prefijo (como ".") Para reemplazar el guión bajo.�¡Interrumpido!�Subtítulo inválido: %s�Formato de fecha inválido. Cite la cadena con comillas simples si desea generarla directamente: %s�No válido math_eqref_format: %r�Variable de plantilla inválida: %s�Argumentos de palabras clave�comando LaTeX %r no se puede ejecutar (necesario para la visualización matemática), compruebe la configuración de imgmath_latex�Actualizado por última vez en %(last_updated)s.�Cambios en la biblioteca�Línea especifico %r: sin líneas tiradas desde el archivo incluido %r�Lista %s�Busque cualquier error en la salida anterior o en el archivo %(outdir)s/output.txt�creación del Makefile y Batchfile�Descripción de la opción con formato incorrecto %r, debe verse como "opt", "-opt args", "--opt args", "/opt args" o "+opt args"�Muchos math_renderers están registrados. Pero no se ha seleccionado math_renderer.�Índice de Módulos�Autor del módulo: �Código de módulo�Nivel de módulo�Nombre del documento maestro (sin sufijo)�Prefijo de nombre para directorios de plantillas y estático�Navegación�Nuevo en la versión %s�Próximo tema�Ningún constructor seleccionado, utilizando el valor predeterminado: html�No hay tal valor de configuración: %s�No alfabético�Nota�Nota: imgmath y mathjax no se pueden habilitar al mismo tiempo. imgmath ha sido deseleccionado.�Notas�Números�Objeto nombrado %r no encontrado en el archivo incluido %r�Un documento es especial porque se considera el nodo superior del "contents tree", es decir, es la raíz de la estructura jerárquica de los documentos. Normalmente, esto es "index", pero si su documento "index" es una plantilla personalizada, también puede establecerlo en otro nombre de archivo.�Excepción original: �Otros parámetros�Otros cambios�Resumen�Resumen: código de modulo�Parámetros�Enlace permanente a este código fuente�Enlazar permanentemente con esta definición�Enlace permanente a esta ecuación�Enlazar permanentemente con este título�Enlace permanente a esta imagen�Enlace permanente a esta tabla�Enlace permanente a la tabla de contenidos�no se encuentra Pillow - copiando archivos de imágenes�Por favor, active JavaScript para habilitar la funcionalidad de búsqueda.�Por favor, informe también esto si fue un error del usuario, de modo que la próxima vez se pueda proporcionar un mejor mensaje de error.�Por favor, ingrese un archivo de sufijo, por ejemplo, '.rst' o '.txt'.�Ingrese un nuevo nombre de archivo o cambie el nombre del archivo existente y presione Enter�Por favor, ingrese una nueva ruta raíz (o ingrese Enter para salir)�Por favor, ingrese un nombre de ruta válido.�Por favor, ingrese cualquiera de 'y' o 'n'�Por favor, ingrese uno de %s.�Por favor, ingrese algún texto.�Ingrese los valores para las siguientes configuraciones (solo presione Entrar para aceptar un valor predeterminado, si se da uno entre paréntesis).�Preparando búsqueda...�Tema anterior�Opciones básicas del proyecto�Lenguaje del proyecto�Nombre de proyecto�Liberación del proyecto�Plantillas de proyecto�Versión del proyecto�El nombre del lexer de pigmentos %r se desconoce�Python Enhancement Proposals; PEP %s�Índice de Módulos Python�Búsqueda rápida�Muestra�Error de recursión:�Referencias�Versión�Tipo del valor devuelto�Devuelve�Ruta raíz para la documentación�Ejecutando Sphinx v%s�Búsqueda�Buscar en %(docstitle)s�Página de Búsqueda�Resultados de la búsqueda�Búsqueda finalizada, encontró %s página(s) acorde con la consulta de búsqueda.�Buscar en %(docstitle)s�Buscando�La búsqueda de varias palabras solo muestra coincidencias que contienen todas las palabras.�Sección %s�Autor de la sección: �Ver también�Ruta raíz seleccionada: %s�Separar directorios fuente y compilado (y/n)�Mostrar el código�Directorio fuente y directorio destino no pueden ser idénticos�Sufijo del archivo fuente�Analizador de fuentes para %s no registrado�Opciones de estructura�Símbolos�Marca TODO encontrada: %s�Tabla %s�Tabla de contenido�Parametros de Plantilla�Pruebas de cobertura en las fuentes terminadas, mira los resultados en %(outdir)spython.txt.�Prueba de doctests en las fuentes terminadas, mira los resultados en %(outdir)s/output.txt.�El %r crossref_type ya está registrado�La directiva %r ya fue registrada en el dominio %s�El índice %r ya fue registrado en el dominio %s�El %r object_type ya está registrado�El rol %r ya fue registrado en el dominio %s�La extensión %s es requerida por la configuración de needs_extensions, pero esta no es cargada.�La extensión %s utilizada por este proyecto necesita al menos la versión de Sphinx v%s; por lo tanto no puede ser construido con esta versión.�Página HTML está en %(outdir)s.�Las páginas HTML están en %(outdir)s.�Los archivos LaTeX están en %(outdir)s.�Los archivos Texinfo están en %(outdir)s.�Los archivos XML están en %(outdir)s.�El valor de configuración `source_suffix' espera una cadena de caracteres, una lista de cadena de caracteres o un diccionario. Pero `%r' es dado.�El valor de configuración `{name}' tiene el tipo `{current.__name__}', el valor predeterminado es `{default.__name__}'.�El valor de configuración `{name}' tiene tipo `{current.__name__}'; esperado {permitted}.�El valor de configuración `{name}` tiene que ser uno de {candidates}, pero fue dado `{current}`.�El archivo de configuración (o uno de los módulos que importa) invocó sys.exit()�El constructor ficticio no genera archivos.�El archivo ePub está en %(outdir)s.�El rastreo completo se ha guardado en %s, si desea informar el problema a los desarrolladores.�Las páginas del manual están en %(outdir)s.�Los catálogos de mensajes están en %(outdir)s.�El archivo de resumen está en %(outdir)s.�El nombre del proyecto aparecerá en varios lugares en la documentación construida.�Los archivos pseudo-XML están en %(outdir)s.�Los archivos de texto están en %(outdir)s.�Hay un error programable en su archivo de configuración: %s�Hay un error de sintaxis en su archivo de configuración: %s �Esta página�Este entorno es incompatible con el generador seleccionado, elija otro directorio doctree.�Este proyecto necesita al menos Sphinx v%s y por lo tanto no se puede construir con esta versión.�Este proyecto necesita la extensión %s por lo menos en la versión %s y por lo tanto no puede ser construido con la versión cargada (%s).�Lanzamientos�Truco�Por hacer�Traductor para %r ya existe�Clave de configuración desconocida: latex_elements[%r], ignorada.�Nombre de evento desconocido: %s�Formato de imagen desconocido: %s...�Desconocido math_renderer %r es dado.�Use el archivo Makefile para compilar los documentos, así ejecute el comando:    make builder�Use el comando sphinx-build para compilar los documentos, así ejecute el comando: sphinx-build -b builder %s %s�Variables�Advertencia�Avisos�Bienvenido a la utilidad de inicio rápido de Sphinx %s.�¡Bienvenido! Este es�Debería crear archivo %s.�Campos�Tiene dos opciones para colocar el directorio de compilación para la salida de Sphinx. O usas un directorio "_build" dentro de la ruta raíz, o separas directorios "fuente" y "compilación" dentro de la ruta raíz.�Ahora debe completar su archivo maestro %s y crear otros archivos fuente de documentación.�Su búsqueda no coincide con ningún documentos. Por favor, asegúrese de que todas las palabras estén correctamente escritas y que usted allá seleccionado las suficientes categorías.�[autosummary] fallo al importar %r: %s�[autosummary] generar autosummary para: %s�[autosummary] escribiendo a %s�[documentos]�[gráfica: %s]�[gráfica]�[imagen: %s]�[imagen]�[fuente]�__all__ debe ser una lista de cadenas, no %r (en el módulo %s) -- ignorando __all__�Se produjo un error Unicode al representar la página %s. Asegúrese de que todos los valores de configuración que contengan contenido que no sea ASCII sean cadenas Unicode.�una lista de archivos específicos para reconstruir. Ignorado si se especifica -a�una imagen adecuada para %s constructor no encontrado: %s�una imagen adecuada para %s constructor no encontrado: %s (%s)�todas las funciones, clases, términos�Todos los %d archivos po�todos los archivos fuente�agregue module_path al sys.path, que se usa cuando se da el parámetro --full�ensamblando documento sencillo�atributo�autores�autodoc: no se pudo determinar %r que se documentará, se produjo la siguiente excepción: %s�insertar automáticamente docstrings de los módulos�probar automáticamente fragmentos de código en bloques doctest�autosummary genera archivos .rst internamente. Pero su source_suffix no contiene archivo .rst. Saltado.�referencias autosummary excluidas documento %r. Ignorado.�autosummary: no se pudo determinar %r que se documentará, se produjo la siguiente excepción: %s�autosummary: no se encontró el archivo stub %r. Verifique su configuración de autosummary_generate.�autosummary_generate: archivo no encontrado: %s�ambas columnas tabulares y la opción :widths: se dan. La opción :widths: se ignora.�enlace roto: %s (%s)�compilación %s, %sadvertencia (con advertencias tratadas como errores).�construir %s, %s advertencia.�compilación %s, %s advertencias (con advertencias tratadas como errores).�compilación %s, %s advertencias.�construir %s.�la versión del entorno de compilación no es actual�construir en paralelo con N procesos donde sea posible (el valor especial "auto" establecerá N en recuento de CPU)�el archivo de información de compilación está roto: %r�constructor a usar (por defecto: html)�compilando [%s]:�compilando [mo]:�función incorporada�puede ser muy grande�no se puede combinar la opción -a y nombres de archivo�no se puede copiar archivo descargable %r: %s�no se puede copiar archivo extra %r�no se puede copiar archivo de imagen %r: %s�no se puede copiar archivo estático %r�no se pueden encontrar los archivos %r�no se puede abrir el archivo de advertencia %r: %s�no se puede reemplazar los ajustes de configuración %r con tipo no compatible, haciendo caso omiso�no se puede reemplazar el ajuste de la configuración del diccionario %r, haciendo caso omiso (utilice %r para definir elementos individuales)�no puede leer el archivo de imagen %r: en su lugar, lo copia�no se puede escribir archivo de imagen %r: %s�subtítulo no dentro de una figura.�verificando consistencia�verificación para el cubrimiento de la documentación�referencias circulares de toctree detectadas, ignorando: %s <- %s�clase�método de la clase�opción de línea de comando�concepto�inclusión condicional de contenido basado en valores de configuración�el valor de configuración "epub_author" no debe estar vacío para EPUB3�el valor de configuración "epub_contributor" no debe estar vacío para EPUB3�el valor de configuración "epub_copyright" (or "copyright") no debe estar vacío para EPUB3�el valor de configuración "epub_description" no debe estar vacío para EPUB3�el valor de configuración "epub_identifier" no debe estar vacío para EPUB3�el valor de configuración "epub_language" (o "language") no debe estar vacío para EPUB3�el valor de configuración "epub_publisher" no debe estar vacío para EPUB3�el valor de configuración "epub_title" (or "html_title") no debe estar vacío para EPUB3�el valor de configuración "epub_uid" debe ser XML NAME para EPUB3�el valor de configuración "version" no debe estar vacío para EPUB3�configuración modificada�directorio de configuración no contiene un archivo conf.py (%s)�opciones de salida de consola�proviene de la página anterior�continué en la próxima página�el comando convert %r no puede ejecutar, compruebe el valor de configuración image_converter�convert salió con error: [stderr] %r [stdout] %r�copiando archivos de soporte TeX�copiando archivos de soporte TeX...�copiando archivos de soporte Texinfo�copiando archivos adicionales�copiando archivos descargables...�copiando archivos extras�copiando imágenes...�copiando archivos fuente�no se pudo leer %r for para la creación del registro de cambios�crear archivo .nojekyll para publicar el documento en páginas GitHub�crear batchfile�crear makefile�directorio de plantillas personalizadas (predeterminado: %(default)s)�dato�rol por defecto %s no encontrado�sufijo predeterminado para archivos (predeterminado: %(default)s)�definir una variable de proyceto�define la etiqueta: incluye bloques "only" con TAG�la unidad de dimensión %s no es válida. Ignorado.�directiva�la directiva %r ya está registrada, esa se reemplazará�directive-option�directorio para colocar toda la salida�directorio para colocar toda la salida en�visualizar latex %r: %s�emitir salida de color (predeterminado: detección automática)�no crear batchfile�no crear makefile�no emite salida de color (predeterminado: detección automática)�no use el modo make para Makefile/make.bat�docnames para escribir: %s�documento�documento importados miembros (predeterminado: %(default)s)�documento no está incluido en ningún toctree�lenguaje del documento�documento no legible. Ignorado.�El título del documento no es un nodo de texto único�realizando serialmente %s�dominio %s ya esta registrado�dominio %s no esta registrado�no crear un archivo de tabla de contenido�no cree encabezados para los paquetes de módulos/paquetes (por ejemplo, cuando las cadenas de documentación "docstrings" ya los contienen)�no sabe qué módulo importar para el autodocumento %r (intente colocar una directiva "module" o "currentmodule" en el documento o dar un nombre explícito al módulo)�no usar un entorno guardado, siempre leer todos los archivos�hecho�dot código %r: %s�comando dot %r no se puede ejecutar (necesarios para la salida de graphviz), Compruebe la configuración de graphviz_dot�dot no produjo un archivo de salida: [stderr] %r [stdout] %r�dot salió con error: [stderr] %r [stdout] %r�el archivo de descarga no es legible: %s�volcar inventario de objetos�volcar el índice de búsqueda en %s�duplicada %s descripción de %s, otra %s en %s�duplicada %s descripción de %s, otra instancia en %s�citación duplicada %s, otra instancia en %s�descripción duplicada de %s %s, otra instancia en %s�etiqueta duplicada %s, otra instancia en %s�etiqueta duplicada de la ecuación %s, otra instancia en %s�descripción duplicada del objeto de %s, otra instancia en %s, utilice :noindex: para uno de ellos�entrada de tabla de contenido duplicada encontrada: %s�habilitada extensión %s�habilitar extensiones arbitrarias�encontró algunos problemas con algunos de los inventarios, pero tenían alternativas de trabajo:�no se encontró el nodo de título en la sección, tema, tabla, advertencia o barra lateral�enum�enumerable_node %r ya esta registrado�enumeración�variables de entorno�variables de entorno; %s�error al formatear argumentos para %s: %s�error escribiendo archivo %s: %s�error escribiendo archivo Makefile: %s�excepción�excepción al evaluar solamente la expresión directiva: %s�extensión %r no tiene ninguna función setup(); ¿es realmente un módulo de extensión de Sphinx?�extensión %r devuelve un objeto no soportado de su función setup(); debe devolver un diccionario de metadatos o ninguno�opciones de extensión�extensiones modificadas�fallado�fallo al importar el objeto %s�fallo al analizar el nombre %s�no se pudo llegar a ninguno de los inventarios con los siguientes problemas:�fallo: %s�el archivo %r usado para el favicon no existe�archivo %r dado en la línea de comandos no existe, ignorado�archivo %r dado en la línea de comandos no está en el directorio fuente, ignorado�archivo %r o ruta del tema no es un archivo zip válido o no contiene ningún tema�sufijo de archivo (por defecto: rst)�nombre de archivo de la tabla de contenido (predeterminado: módulos)�finalizo con problemas�archivo de estilo fnmatch y/o patrones de directorio para excluir de la generación�seguir enlaces simbólicos. Potente cuando se combina con el paquete collective.recipe.omelette.�función�opciones generales�generar un proyecto completo con sphinx-quickstart�generando índices�el glosario parece estar mal formateado, verifique la sangría�termino de glosario�el término del glosario debe ir precedido de una línea vacía�los términos del glosario no deben estar separados por líneas vacías�gramática simbólica�el valor del parámetro graphviz_output_format debe ser uno de 'png', 'svg', pero es %r�resaltando el código del módulo...�entrada html_extra_path %r no existe�entrada html_extra_path %r se coloca dentro de outdir�entrada html_static_path %r no existe�entrada html_static_path %r se coloca dentro de outdir�si se especifica, separe los directorios de fuentes y de compilación�ignorando el código doctest no válido: %r�archivo de imagen %s no legible: %s�archivo de imagen no legible:%s�incluir "_private" en módulos�incluir enlaces al código fuente de objetos documentados de Python�incluir expresiones matemáticas, mostradas como imágenes PNG o SVG�incluir matemática, mostrada en el navegador por MathJax�referencias de citas inconsistentes en el mensaje traducido. original: {0}, traducido: {1}�referencias de pie de página inconsistentes en el mensaje traducido. original: {0}, traducido: {1}�referencias inconsistentes en el mensaje traducido. original: {0}, traducido: {1}�referencias de término inconsistentes en el mensaje traducido. original: {0}, traducido: {1}�aumentar la verbosidad (puede repetirse)�índice�en línea latex %r: %s�interpretar las rutas del módulo de acuerdo con la especificación de espacios de nombres implícitos en la PEP-0420�el identificador de intersphinx %r no es una cadena. Ignorado�el inventario intersphinx se ha movido: %s -> %s�tipo de TestCode inválido�css_file inválido: %r, ignorado�js_file inválido: %r, ignorado�número no válido %r de valor de configuración %r, haciendo caso omiso�inválido numfig_format: %s�inválido numfig_format: %s (%r)�expresiones regulares inválidas %r en %s�expresiones regulares inválidas %r en coverage_c_regexes�firma inválida para auto%s (%r)�número de trabajo debe ser un número positivo�palabra clave�kwargs para la función add_node() debe ser una tupla de función (visitar, salir): %r=%r�actualizado por última vez el�la especificación del número de línea está fuera de range(1-%d): %r�enlace entre la documentación de Sphinx de diferentes proyectos�muestra todas las secciones y subsecciones�cargando inventario intersphinx desde %s...�cargando el ambiente pickled�cargando traducciones [%s]... �archivo de logo %r no existe�buscando por archivos no actualizados...�macro�creando directorio de salida�nombre de documento maestro�rofundidad máxima de submódulos para mostrar en la tabla de contenido (predeterminado: 4)�miembro�método�falta '+' o '-' en la opción '%s'.�falta el atributo %s en el objeto %s�módulo�el módulo %s no podía ser importado: %s�módulos�más de un objetivo destino encontrado para 'cualquier' referencia cruzada %r: podría ser %s�se encontró más de un objetivo para la referencia cruzada %r: %s�nueva configuración�siguiente�próximo capítulo�modo quisquilloso, advierte sobre todas las referencias faltantes�no se encontró el valor de configuración "latex_documents"; no se escribirán documentos�no se encontró el valor de configuración "man_pages"; no se escribirán las páginas del manual�no se encontró el valor de configuración "texinfo_documents"; no se escribirán documentos�No se conoce la opción de Babel para el idioma %r�no hay cambios en versión %s.�sin código/salida en el bloque %s en %s:%s�sin salida, ni siquiera advertencias�sin salida en salida estándar, solo advertencias en los mensajes de error estándar�no hay archivos objetivo desactualizados.�sin tema llamado %r encontrado (¿falta el archivo theme.conf?)�no encontrado ningún tema llamado %r, heredado por %r�la clase de nodo %r ya está registrada, sus visitantes serán reemplazados�no encontrado�no disponible para mensajes incorporados�numfig está deshabilitado. :numref: se ignora.�numfig_format no está definido para %s�objeto�operador�entrada original�sobreescribir un ajuste en el fichero de configuración�sobreescribir archivos existentes�página�La página %s coincide con dos patrones en html_sidebars: %r y %r�pasar un valor a la plantilla HTML�ruta para el entorno en caché y los archivos doctree (predeterminado: OUTPUTDIR/.doctrees)�ruta a los archivos fuente de la documentación�ruta al módulo al documento�ruta al directorio de salida�ruta del archivo de configuración (conf.py) donde se encuentra (predeterminado: igual que el valor SOURCEDIR)�preparando ambiente�preparando documentos�anterior�capítulo anterior�primary_domain %r no fue encontrado, se ignora.�procesando %s�opción de programa�autor(es) del proyecto, utilizado cuando se da el parámetro --full�nombre del proyecto�nombre del proyecto (predeterminado: nombre del módulo raíz)�lanzamiento del proyecto, utilizado cuando se da el parámetro --full, por defecto es --doc-version�raíz del proyecto�versión del proyecto, utilizado cuando se da el parámetro --full�poner documentación para cada módulo en su propia página�poner la documentación del módulo antes de la documentación del submódulo�acceso rápido a todos los módulos�modo silencioso�error en marcado de reST�leyendo error: %s, %s�leyendo fuentes...�leyendo plantillas...�etiqueta de referencia�liberación del proyecto�reemplazo para punto en _templates, etc.�resolviendo referencias...�rol�el rol %r ya está registrado, ese se reemplazará�ejecutar Pdb en excepción�ejecutar la rutina sin crear archivos�buscar�no se pudo cargar el índice de búsqueda, pero no se crearán todos los documentos: el índice estará incompleto.�buscar en esta documentación�ver %s�ver también %s�toctree auto referenciado encontrado. Ignorado.�configuración de %s.%s se produce en ninguna de las configuraciones de tema buscado�mostrar rastreo completo en excepción�argumentos de firma o anotación de retorno dada para automodule %s�omitido�directorio fuente ha cambiado�sufijo de archivo fuente�archivos fuente para generar archivos rST para�source_parser para %r ya está registrado�source_suffix %r ya está registrado�sphinx-quickstart solo se genera en un directorio vacío. Por favor, especifique una nueva ruta raíz.�sphinx-quickstart no sobreescribirá proyectos existentes de Sphinx.�sphinx-quickstart no sobreescribirá el archivo existente.�sentencia�método estático�éxitoso�los objetivos para %d los archivos po que estan desactualizados�los objetivos para %d los archivos po que se especifican�los objetivos para %d los archivos fuentes que estan desactualizados�objetivos para los archivos de plantillas %d�directorio de plantillas para archivos de plantillas�la extensión de %s no declara si es seguro para la lectura en paralelo, asumiendo que no es - consulte con el autor de la extensión para comprobar y hacer explícito�la extensión %s no declara si es seguro para la escritura paralela, suponiendo que no lo sea - solicite al autor de la extensión que lo verifique y haga explicito�la extensión %s no es segura para lectura paralela�la extensión %s no es segura para escritura paralela�la documentación para�la extensión %r ya se fusionó con Sphinx desde la versión %s; esta extensión se omite.�el enlace no tiene subtítulo: %s�tema %r no tiene configuraciones de "heredar"�tema %r no tiene configuraciones de "tema"�toctree contiene referencia al archivo inexistente %r�toctree contiene una referencia al documento %r que no tiene título: no se generará ningún enlace�toctree contiene referencia al documento excluido %r�toctree contiene referencias a documentos inexistentes %r�demasiado grande :maxdepth:, ignorado.�convertir advertencias en errores�tipo�caracteres fuente no codificables, reemplazando con "?": %r�tipo de nodo no implementado: %r�unión�desconocida %r toplevel_sectioning para la clase %r�valor de configuración desconocido %r en anulación, ignorando�tipo de entrada de índice desconocido %r�tipo de entrada de índice desconocido %s encontrado�mimetype desconocido para %s, ignorando�tipo de nodo desconocido: %r�opción de tema no soportada %r fue dada�actualizando ambiente�usar epub�use el modo make para Makefile/make.bat�no use ningún archivo de configuración, solomente opciones -D�variable�versión del proyecto�Esperando a los workers...�donde "builder" es uno de los constructores compatibles, por ejemplo, html, latex o linkcheck.�mientras configura la extensión %s:�con -W, sigue adelante cuando recibas advertencias�escribir entradas de "todo" que se pueden mostrar u ocultar en la compilación�escribir todos los archivos (por defecto: solo escribir archivos nuevos y modificados)�escribir avisos (y errores) al fichero indicado�escribiendo�escribiendo archivo %s...�escribiendo archivos adicionales�escribiendo páginas adicionales�escribiendo error: %s, %s�escribiendo catálogos de mensajes...�escribiendo salida... �escribiendo archivo de resumen...��������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/es/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000340673�00000000000�021165� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Edward Villegas-Pulgarin <cosmoscalibur@gmail.com>, 2018 # Edward Villegas-Pulgarin <cosmoscalibur@gmail.com>, 2018-2019 # Edward Villegas-Pulgarin <cosmoscalibur@gmail.com>, 2018 # Guillem Borrell <guillem@torroja.dmt.upm.es>, 2011 # Ivan García <ivan.garcia@studio-point.com>, 2019 # Leonardo J. Caballero G. <leonardocaballero@gmail.com>, 2013-2018,2020 # Komiya Takeshi <i.tkomiya@gmail.com>, 2016,2021 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-10-31 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Spanish (http://www.transifex.com/sphinx-doc/sphinx-1/language/es/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: es\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "No se encuentra directorio fuente (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Directorio fuente y directorio destino no pueden ser idénticos" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Ejecutando Sphinx v%s" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Este proyecto necesita al menos Sphinx v%s y por lo tanto no se puede construir con esta versión." #: sphinx/application.py:243 msgid "making output directory" msgstr "creando directorio de salida" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "mientras configura la extensión %s:" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' como se define actualmente en el archivo conf.py no es un Python invocable. Por favor, modifique su definición para que sea una función invocable. Esto es necesario para que el archivo conf.py se comporte como una extensión de Sphinx." #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "cargando traducciones [%s]... " #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "hecho" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "no disponible para mensajes incorporados" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "cargando el ambiente pickled" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "fallo: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "Ningún constructor seleccionado, utilizando el valor predeterminado: html" #: sphinx/application.py:348 msgid "succeeded" msgstr "éxitoso" #: sphinx/application.py:349 msgid "finished with problems" msgstr "finalizo con problemas" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "compilación %s, %sadvertencia (con advertencias tratadas como errores)." #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "compilación %s, %s advertencias (con advertencias tratadas como errores)." #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "construir %s, %s advertencia." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "compilación %s, %s advertencias." #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "construir %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "la clase de nodo %r ya está registrada, sus visitantes serán reemplazados" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "la directiva %r ya está registrada, esa se reemplazará" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "el rol %r ya está registrado, ese se reemplazará" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "la extensión de %s no declara si es seguro para la lectura en paralelo, asumiendo que no es - consulte con el autor de la extensión para comprobar y hacer explícito" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "la extensión %s no es segura para lectura paralela" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "la extensión %s no declara si es seguro para la escritura paralela, suponiendo que no lo sea - solicite al autor de la extensión que lo verifique y haga explicito" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "la extensión %s no es segura para escritura paralela" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "realizando serialmente %s" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "directorio de configuración no contiene un archivo conf.py (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "no se puede reemplazar el ajuste de la configuración del diccionario %r, haciendo caso omiso (utilice %r para definir elementos individuales)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "número no válido %r de valor de configuración %r, haciendo caso omiso" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "no se puede reemplazar los ajustes de configuración %r con tipo no compatible, haciendo caso omiso" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "valor de configuración desconocido %r en anulación, ignorando" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "No hay tal valor de configuración: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "Valor de configuración %r ya presente" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Hay un error de sintaxis en su archivo de configuración: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "El archivo de configuración (o uno de los módulos que importa) invocó sys.exit()" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "Hay un error programable en su archivo de configuración:\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "El valor de configuración `source_suffix' espera una cadena de caracteres, una lista de cadena de caracteres o un diccionario. Pero `%r' es dado." #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Sección %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Figura %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tabla %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Lista %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "El valor de configuración `{name}` tiene que ser uno de {candidates}, pero fue dado `{current}`." #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "El valor de configuración `{name}' tiene tipo `{current.__name__}'; esperado {permitted}." #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "El valor de configuración `{name}' tiene el tipo `{current.__name__}', el valor predeterminado es `{default.__name__}'." #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r no fue encontrado, se ignora." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "Evento %r ya presente" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Nombre de evento desconocido: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "La extensión %s es requerida por la configuración de needs_extensions, pero esta no es cargada." #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "Este proyecto necesita la extensión %s por lo menos en la versión %s y por lo tanto no puede ser construido con la versión cargada (%s)." #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "El nombre del lexer de pigmentos %r se desconoce" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "No pudo el léxico literal_block como \"%s\". Destacado omitido." #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "documento no legible. Ignorado." #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "Constructor clase %s no tiene ningún atributo \"name\"" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Constructor %r ya existe (en el módulo %s)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Nombre de constructor %s no registrados o disponibles a través del punto de entrada" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "Nombre de constructor %s no registrado" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "dominio %s ya esta registrado" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "dominio %s no esta registrado" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "La directiva %r ya fue registrada en el dominio %s" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "El rol %r ya fue registrado en el dominio %s" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "El índice %r ya fue registrado en el dominio %s" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "El %r object_type ya está registrado" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "El %r crossref_type ya está registrado" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "source_suffix %r ya está registrado" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "source_parser para %r ya está registrado" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "Analizador de fuentes para %s no registrado" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "Traductor para %r ya existe" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "kwargs para la función add_node() debe ser una tupla de función (visitar, salir): %r=%r" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "enumerable_node %r ya esta registrado" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "la extensión %r ya se fusionó con Sphinx desde la versión %s; esta extensión se omite." #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "Excepción original:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "No puede importar la extensión %s" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "extensión %r no tiene ninguna función setup(); ¿es realmente un módulo de extensión de Sphinx?" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "La extensión %s utilizada por este proyecto necesita al menos la versión de Sphinx v%s; por lo tanto no puede ser construido con esta versión." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "extensión %r devuelve un objeto no soportado de su función setup(); debe devolver un diccionario de metadatos o ninguno" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "tema %r no tiene configuraciones de \"tema\"" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "tema %r no tiene configuraciones de \"heredar\"" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "no encontrado ningún tema llamado %r, heredado por %r" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "configuración de %s.%s se produce en ninguna de las configuraciones de tema buscado" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "opción de tema no soportada %r fue dada" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "archivo %r o ruta del tema no es un archivo zip válido o no contiene ningún tema" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "sin tema llamado %r encontrado (¿falta el archivo theme.conf?)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "una imagen adecuada para %s constructor no encontrado: %s (%s)" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "una imagen adecuada para %s constructor no encontrado: %s" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "compilando [mo]:" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "escribiendo salida... " #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "Todos los %d archivos po" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "los objetivos para %d los archivos po que se especifican" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "los objetivos para %d los archivos po que estan desactualizados" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "todos los archivos fuente" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "archivo %r dado en la línea de comandos no está en el directorio fuente, ignorado" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "archivo %r dado en la línea de comandos no existe, ignorado" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "%d archivos fuente dados en la línea de comandos" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "los objetivos para %d los archivos fuentes que estan desactualizados" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "compilando [%s]:" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "buscando por archivos no actualizados..." #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "encontrado %d" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "no encontrado" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "preparando ambiente" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "verificando consistencia" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "no hay archivos objetivo desactualizados." #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "actualizando ambiente" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "%sañadido, %s cambiado, %s removido" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "leyendo fuentes..." #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "Esperando a los workers..." #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "docnames para escribir: %s" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "preparando documentos" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "entrada de tabla de contenido duplicada encontrada: %s" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "copiando imágenes..." #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "no puede leer el archivo de imagen %r: en su lugar, lo copia" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "no se puede copiar archivo de imagen %r: %s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "no se puede escribir archivo de imagen %r: %s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "no se encuentra Pillow - copiando archivos de imágenes" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "mimetype desconocido para %s, ignorando" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "escribiendo archivo %s..." #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "El archivo de resumen está en %(outdir)s." #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "no hay cambios en versión %s." #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "escribiendo archivo de resumen..." #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Funciones incorporadas" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Nivel de módulo" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "copiando archivos fuente" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "no se pudo leer %r for para la creación del registro de cambios" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "El constructor ficticio no genera archivos." #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "El archivo ePub está en %(outdir)s." #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "el valor de configuración \"epub_language\" (o \"language\") no debe estar vacío para EPUB3" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "el valor de configuración \"epub_uid\" debe ser XML NAME para EPUB3" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "el valor de configuración \"epub_title\" (or \"html_title\") no debe estar vacío para EPUB3" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "el valor de configuración \"epub_author\" no debe estar vacío para EPUB3" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "el valor de configuración \"epub_contributor\" no debe estar vacío para EPUB3" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "el valor de configuración \"epub_description\" no debe estar vacío para EPUB3" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "el valor de configuración \"epub_publisher\" no debe estar vacío para EPUB3" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "el valor de configuración \"epub_copyright\" (or \"copyright\") no debe estar vacío para EPUB3" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "el valor de configuración \"epub_identifier\" no debe estar vacío para EPUB3" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "el valor de configuración \"version\" no debe estar vacío para EPUB3" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "css_file inválido: %r, ignorado" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "Los catálogos de mensajes están en %(outdir)s." #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "objetivos para los archivos de plantillas %d" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "leyendo plantillas..." #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "escribiendo catálogos de mensajes..." #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "Busque cualquier error en la salida anterior o en el archivo %(outdir)s/output.txt" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "enlace roto: %s (%s)" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "Ancla '%s' no encontrado" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "Las páginas del manual están en %(outdir)s." #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "no se encontró el valor de configuración \"man_pages\"; no se escribirán las páginas del manual" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "escribiendo" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "El valor de configuración \"man_pages\" hace referencia a un documento desconocido %s" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "Página HTML está en %(outdir)s." #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "ensamblando documento sencillo" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "escribiendo archivos adicionales" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "Los archivos Texinfo están en %(outdir)s." #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "\nEjecute el comando 'make' en ese directorio para ejecutarlos a través de makeinfo\n(usa el comando 'make info' aquí para hacer esto automáticamente)." #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "no se encontró el valor de configuración \"texinfo_documents\"; no se escribirán documentos" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "El valor de configuración \"texinfo_documents\" hace referencia a un documento desconocido %s" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "procesando %s" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "resolviendo referencias..." #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (en " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "copiando archivos de soporte Texinfo" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "error escribiendo archivo Makefile: %s" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "Los archivos de texto están en %(outdir)s." #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "error escribiendo archivo %s: %s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "Los archivos XML están en %(outdir)s." #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "Los archivos pseudo-XML están en %(outdir)s." #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "el archivo de información de compilación está roto: %r" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "Las páginas HTML están en %(outdir)s." #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "Error al leer la información de compilación del fichero: %r" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d de %B de %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Índice General" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "índice" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "siguiente" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "anterior" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "generando índices" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "escribiendo páginas adicionales" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "copiando archivos descargables..." #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "no se puede copiar archivo descargable %r: %s" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "no se puede copiar archivo estático %r" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "copiando archivos extras" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "no se puede copiar archivo extra %r" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "Error al escribir el archivo de información de compilación: %r" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "no se pudo cargar el índice de búsqueda, pero no se crearán todos los documentos: el índice estará incompleto." #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "La página %s coincide con dos patrones en html_sidebars: %r y %r" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "Se produjo un error Unicode al representar la página %s. Asegúrese de que todos los valores de configuración que contengan contenido que no sea ASCII sean cadenas Unicode." #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "Ha ocurrido un error al renderizar la pagina %s. Motivo: %r" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "volcar inventario de objetos" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "volcar el índice de búsqueda en %s" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "js_file inválido: %r, ignorado" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "Muchos math_renderers están registrados. Pero no se ha seleccionado math_renderer." #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "Desconocido math_renderer %r es dado." #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "entrada html_extra_path %r no existe" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "entrada html_extra_path %r se coloca dentro de outdir" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "entrada html_static_path %r no existe" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "entrada html_static_path %r se coloca dentro de outdir" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "archivo de logo %r no existe" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "el archivo %r usado para el favicon no existe" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "documentación de %s - %s" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "Los archivos LaTeX están en %(outdir)s." #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\nEjecuta el comando 'make' en este directorio para compilarlos usando (pdf)latex\n(usa el comando 'make latexpdf' aquí para hacer esto automáticamente)." #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "no se encontró el valor de configuración \"latex_documents\"; no se escribirán documentos" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "El valor de configuración \"latex_documents\" hace referencia a un documento desconocido %s" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Índice" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Versión" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "No se conoce la opción de Babel para el idioma %r" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "copiando archivos de soporte TeX" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "copiando archivos de soporte TeX..." #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "copiando archivos adicionales" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "Clave de configuración desconocida: latex_elements[%r], ignorada." #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "%r no tiene configuración de \"tema\"" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "%r no tiene configuración de \"%s\"" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "Ha ocurrido un error al compilar, iniciando depurador:" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "¡Interrumpido!" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "error en marcado de reST" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "Error de codificación:" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "El rastreo completo se ha guardado en %s, si desea informar el problema a los desarrolladores." #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "Error de recursión:" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "Ha ocurrido una excepción:" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "Por favor, informe también esto si fue un error del usuario, de modo que la próxima vez se pueda proporcionar un mejor mensaje de error." #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "Se puede presentar un informe de error en el rastreador en <https://github.com/sphinx-doc/sphinx/issues>. ¡Gracias!" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "número de trabajo debe ser un número positivo" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "ruta a los archivos fuente de la documentación" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "ruta al directorio de salida" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "una lista de archivos específicos para reconstruir. Ignorado si se especifica -a" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "opciones generales" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "constructor a usar (por defecto: html)" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "escribir todos los archivos (por defecto: solo escribir archivos nuevos y modificados)" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "no usar un entorno guardado, siempre leer todos los archivos" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "ruta para el entorno en caché y los archivos doctree (predeterminado: OUTPUTDIR/.doctrees)" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "construir en paralelo con N procesos donde sea posible (el valor especial \"auto\" establecerá N en recuento de CPU)" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "ruta del archivo de configuración (conf.py) donde se encuentra (predeterminado: igual que el valor SOURCEDIR)" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "no use ningún archivo de configuración, solomente opciones -D" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "sobreescribir un ajuste en el fichero de configuración" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "pasar un valor a la plantilla HTML" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "define la etiqueta: incluye bloques \"only\" con TAG" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "modo quisquilloso, advierte sobre todas las referencias faltantes" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "opciones de salida de consola" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "aumentar la verbosidad (puede repetirse)" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "sin salida en salida estándar, solo advertencias en los mensajes de error estándar" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "sin salida, ni siquiera advertencias" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "emitir salida de color (predeterminado: detección automática)" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "no emite salida de color (predeterminado: detección automática)" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "escribir avisos (y errores) al fichero indicado" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "convertir advertencias en errores" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "con -W, sigue adelante cuando recibas advertencias" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "mostrar rastreo completo en excepción" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "ejecutar Pdb en excepción" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "no se pueden encontrar los archivos %r" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "no se puede combinar la opción -a y nombres de archivo" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "no se puede abrir el archivo de advertencia %r: %s" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "El argumento de la opción -D debe estar en la forma nombre=valor" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "El argumento de la opción -A debe estar en la forma nombre=valor" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "insertar automáticamente docstrings de los módulos" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "probar automáticamente fragmentos de código en bloques doctest" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "enlace entre la documentación de Sphinx de diferentes proyectos" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "escribir entradas de \"todo\" que se pueden mostrar u ocultar en la compilación" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "verificación para el cubrimiento de la documentación" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "incluir expresiones matemáticas, mostradas como imágenes PNG o SVG" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "incluir matemática, mostrada en el navegador por MathJax" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "inclusión condicional de contenido basado en valores de configuración" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "incluir enlaces al código fuente de objetos documentados de Python" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "crear archivo .nojekyll para publicar el documento en páginas GitHub" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "Por favor, ingrese un nombre de ruta válido." #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "Por favor, ingrese algún texto." #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "Por favor, ingrese uno de %s." #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "Por favor, ingrese cualquiera de 'y' o 'n'" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "Por favor, ingrese un archivo de sufijo, por ejemplo, '.rst' o '.txt'." #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "Bienvenido a la utilidad de inicio rápido de Sphinx %s." #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "Ingrese los valores para las siguientes configuraciones (solo presione Entrar para\naceptar un valor predeterminado, si se da uno entre paréntesis)." #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "Ruta raíz seleccionada: %s" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "Ingrese la ruta raíz para la documentación." #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "Ruta raíz para la documentación" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "Error: un archivo conf.py ya existe en la ruta raíz seleccionada." #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "sphinx-quickstart no sobreescribirá proyectos existentes de Sphinx." #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "Por favor, ingrese una nueva ruta raíz (o ingrese Enter para salir)" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "Tiene dos opciones para colocar el directorio de compilación para la salida de Sphinx.\nO usas un directorio \"_build\" dentro de la ruta raíz, o separas\ndirectorios \"fuente\" y \"compilación\" dentro de la ruta raíz." #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "Separar directorios fuente y compilado (y/n)" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "Dentro del directorio raíz, se crearán dos directorios más; \"_templates\"\npara plantillas HTML personalizadas y \"_static\" para hojas de estilo personalizadas y otras archivos\nestáticos. Puede ingresar otro prefijo (como \".\") Para reemplazar el guión bajo." #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "Prefijo de nombre para directorios de plantillas y estático" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "El nombre del proyecto aparecerá en varios lugares en la documentación construida." #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "Nombre de proyecto" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "Autor(es)" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "Versión del proyecto" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "Liberación del proyecto" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "Si los documentos deben escribirse en un idioma que no sea inglés,\npuede seleccionar un idioma aquí por su código de idioma. Sphinx entonces\ntraducir el texto que genera a ese idioma.\n\nPara obtener una lista de códigos compatibles, vea\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "Lenguaje del proyecto" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "Sufijo del archivo fuente" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "Un documento es especial porque se considera el nodo superior del\n\"contents tree\", es decir, es la raíz de la estructura jerárquica\nde los documentos. Normalmente, esto es \"index\", pero si su documento \"index\"\nes una plantilla personalizada, también puede establecerlo en otro nombre de archivo." #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "Nombre del documento maestro (sin sufijo)" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "Error: el archivo maestro %s ya se ha encontrado en la ruta raíz seleccionada." #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "sphinx-quickstart no sobreescribirá el archivo existente." #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "Ingrese un nuevo nombre de archivo o cambie el nombre del archivo existente y presione Enter" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "Indique cuál de las siguientes extensiones de Sphinx deben habilitarse:" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "Nota: imgmath y mathjax no se pueden habilitar al mismo tiempo. imgmath ha sido deseleccionado." #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "Se puede generar un archivo Makefile y un archivo de comandos de Windows para que usted\nsolo tiene que ejecutar, por ejemplo, `make html' en lugar de invocar sphinx-build\ndirectamente." #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "Crear Makefile? (y/n)" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "¿Crear archivo de comandos para Windows? (y/n)" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "Creando archivo %s." #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "El archivo %s ya existe, omitiendo." #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "Terminado: se ha creado una estructura de directorio inicial." #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "Ahora debe completar su archivo maestro %s y crear otros archivos fuente\nde documentación." #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "Use el archivo Makefile para compilar los documentos, así ejecute el comando:\n    make builder" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "Use el comando sphinx-build para compilar los documentos, así ejecute el comando:\n sphinx-build -b builder %s %s" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "donde \"builder\" es uno de los constructores compatibles, por ejemplo, html, latex o linkcheck." #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "\nGenere los archivos necesarios para un proyecto Sphinx.\n\nsphinx-quickstart es una herramienta interactiva que hace algunas preguntas sobre su\nproyecto y luego genera un directorio completo de documentación y un ejemplo del archivo\nMakefilepara ser utilizado con el comando sphinx-build.\n" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "modo silencioso" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "raíz del proyecto" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "Opciones de estructura" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "si se especifica, separe los directorios de fuentes y de compilación" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "reemplazo para punto en _templates, etc." #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "Opciones básicas del proyecto" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "nombre del proyecto" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "autores" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "versión del proyecto" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "liberación del proyecto" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "lenguaje del documento" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "sufijo de archivo fuente" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "nombre de documento maestro" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "usar epub" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "Opciones de extensión" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "habilitada extensión %s" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "habilitar extensiones arbitrarias" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "creación del Makefile y Batchfile" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "crear makefile" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "no crear makefile" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "crear batchfile" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "no crear batchfile" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "use el modo make para Makefile/make.bat" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "no use el modo make para Makefile/make.bat" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "Plantillas de proyecto" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "directorio de plantillas para archivos de plantillas" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "definir una variable de proyceto" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "se especifica \"quiet\", pero no se especifica ninguno de \"project\" o \"author\"." #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "Error: la ruta especificada no es un directorio, o ya existen archivos sphinx." #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "sphinx-quickstart solo se genera en un directorio vacío. Por favor, especifique una nueva ruta raíz." #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "Variable de plantilla inválida: %s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "Subtítulo inválido: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "la especificación del número de línea está fuera de range(1-%d): %r" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "No puede utilizar ambas opciones \"%s\" y \"%s\"" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "Archivo incluido %r no encontrado o la lectura del mismo fallo" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "Codificación %r usado para la lectura archivo incluido %r parece estar mala, trate de darle una opción :encoding:" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "Objeto nombrado %r no encontrado en el archivo incluido %r" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "No puede utilizar a \"lineno-match\" con un conjunto desunido de \"líneas\"" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "Línea especifico %r: sin líneas tiradas desde el archivo incluido %r" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Autor de la sección: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Autor del módulo: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Código del autor: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autor: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parámetros" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428 msgid "Returns" msgstr "Devuelve" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:430 msgid "Return type" msgstr "Tipo del valor devuelto" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "miembro" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "variable" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164 msgid "function" msgstr "función" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "macro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "unión" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "enum" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "enumeración" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "tipo" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Nuevo en la versión %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Distinto en la versión %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Obsoleto desde la versión %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "citación duplicada %s, otra instancia en %s" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "Citación [%s] no está referenciada." #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Parametros de Plantilla" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Lanzamientos" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1166 msgid "class" msgstr "clase" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "concepto" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (función incorporada)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803 #, python-format msgid "%s() (%s method)" msgstr "%s() (método de %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (clase)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (variable global o constante)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888 #, python-format msgid "%s (%s attribute)" msgstr "%s (atributo de %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumentos" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (módulo)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168 msgid "method" msgstr "método" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165 msgid "data" msgstr "dato" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171 msgid "attribute" msgstr "atributo" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1173 msgid "module" msgstr "módulo" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "duplicada %s descripción de %s, otra %s en %s" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "etiqueta duplicada de la ecuación %s, otra instancia en %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "No válido math_eqref_format: %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "palabra clave" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operador" #: sphinx/domains/python.py:61 msgid "object" msgstr "objeto" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1167 msgid "exception" msgstr "excepción" #: sphinx/domains/python.py:63 msgid "statement" msgstr "sentencia" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "función incorporada" #: sphinx/domains/python.py:421 msgid "Variables" msgstr "Variables" #: sphinx/domains/python.py:425 msgid "Raises" msgstr "Muestra" #: sphinx/domains/python.py:648 sphinx/domains/python.py:792 #, python-format msgid "%s() (in module %s)" msgstr "%s() (en el módulo %s)" #: sphinx/domains/python.py:708 sphinx/domains/python.py:884 #: sphinx/domains/python.py:935 #, python-format msgid "%s (in module %s)" msgstr "%s (en el módulo %s)" #: sphinx/domains/python.py:710 #, python-format msgid "%s (built-in variable)" msgstr "%s (variable incorporada)" #: sphinx/domains/python.py:735 #, python-format msgid "%s (built-in class)" msgstr "%s (clase incorporada)" #: sphinx/domains/python.py:736 #, python-format msgid "%s (class in %s)" msgstr "%s (clase en %s)" #: sphinx/domains/python.py:797 #, python-format msgid "%s() (%s class method)" msgstr "%s() (método de clase de %s)" #: sphinx/domains/python.py:799 sphinx/domains/python.py:939 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s static method)" msgstr "%s() (método estático de %s)" #: sphinx/domains/python.py:1093 msgid "Python Module Index" msgstr "Índice de Módulos Python" #: sphinx/domains/python.py:1094 msgid "modules" msgstr "módulos" #: sphinx/domains/python.py:1143 msgid "Deprecated" msgstr "Obsoleto" #: sphinx/domains/python.py:1169 msgid "class method" msgstr "método de la clase" #: sphinx/domains/python.py:1170 msgid "static method" msgstr "método estático" #: sphinx/domains/python.py:1172 msgid "property" msgstr "" #: sphinx/domains/python.py:1230 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "descripción duplicada del objeto de %s, otra instancia en %s, utilice :noindex: para uno de ellos" #: sphinx/domains/python.py:1350 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "se encontró más de un objetivo para la referencia cruzada %r: %s" #: sphinx/domains/python.py:1404 msgid " (deprecated)" msgstr " (obsoleto)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (directiva)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr ":%s: (opción directiva)" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (rol)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "directiva" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "directive-option" #: sphinx/domains/rst.py:210 msgid "role" msgstr "rol" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "descripción duplicada de %s %s, otra instancia en %s" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "variables de entorno; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "Descripción de la opción con formato incorrecto %r, debe verse como \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" o \"+opt args\"" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "%sopción de línea de comando " #: sphinx/domains/std.py:245 msgid "command line option" msgstr "opción de línea de comando" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "el término del glosario debe ir precedido de una línea vacía" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "los términos del glosario no deben estar separados por líneas vacías" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "el glosario parece estar mal formateado, verifique la sangría" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "termino de glosario" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "gramática simbólica" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "etiqueta de referencia" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "variables de entorno" #: sphinx/domains/std.py:568 msgid "program option" msgstr "opción de programa" #: sphinx/domains/std.py:569 msgid "document" msgstr "documento" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Índice de Módulos" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Página de Búsqueda" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "etiqueta duplicada %s, otra instancia en %s" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "duplicada %s descripción de %s, otra instancia en %s" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "numfig está deshabilitado. :numref: se ignora." #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "el enlace no tiene subtítulo: %s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "inválido numfig_format: %s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "inválido numfig_format: %s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "nueva configuración" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "configuración modificada" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "extensiones modificadas" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "la versión del entorno de compilación no es actual" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "directorio fuente ha cambiado" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "Este entorno es incompatible con el generador seleccionado, elija otro directorio doctree." #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "Error al escanear los documentos en %s: %r" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "Dominio %r no está registrado" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "toctree auto referenciado encontrado. Ignorado." #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "documento no está incluido en ningún toctree" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "ver %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "ver también %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "tipo de entrada de índice desconocido %r" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Símbolos" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "referencias circulares de toctree detectadas, ignorando: %s <- %s" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "toctree contiene una referencia al documento %r que no tiene título: no se generará ningún enlace" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "toctree contiene referencia al documento excluido %r" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "toctree contiene referencias a documentos inexistentes %r" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "archivo de imagen no legible:%s" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "archivo de imagen %s no legible: %s" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "el archivo de descarga no es legible: %s" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "%s ya tiene asignados números de sección (¿número de árbol anidado?)" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "Debería crear archivo %s." #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "\nMire recursivamente en <MODULE_PATH> para módulos y paquetes de Python y cree\nun archivo reST con directivas automodule por paquete en el <OUTPUT_PATH>.\n\nLos <EXCLUDE_PATTERN>s pueden ser patrones de archivo y/o directorio que serán\nexcluidos de la generación.\n\nNota: Por defecto, este script no sobrescribirá los archivos ya creados." #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "ruta al módulo al documento" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "archivo de estilo fnmatch y/o patrones de directorio para excluir de la generación" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "directorio para colocar toda la salida" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "rofundidad máxima de submódulos para mostrar en la tabla de contenido (predeterminado: 4)" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "sobreescribir archivos existentes" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "seguir enlaces simbólicos. Potente cuando se combina con el paquete collective.recipe.omelette." #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "ejecutar la rutina sin crear archivos" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "poner documentación para cada módulo en su propia página" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "incluir \"_private\" en módulos" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "nombre de archivo de la tabla de contenido (predeterminado: módulos)" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "no crear un archivo de tabla de contenido" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "no cree encabezados para los paquetes de módulos/paquetes (por ejemplo, cuando las cadenas de documentación \"docstrings\" ya los contienen)" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "poner la documentación del módulo antes de la documentación del submódulo" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "interpretar las rutas del módulo de acuerdo con la especificación de espacios de nombres implícitos en la PEP-0420" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "sufijo de archivo (por defecto: rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "generar un proyecto completo con sphinx-quickstart" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "agregue module_path al sys.path, que se usa cuando se da el parámetro --full" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "nombre del proyecto (predeterminado: nombre del módulo raíz)" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "autor(es) del proyecto, utilizado cuando se da el parámetro --full" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "versión del proyecto, utilizado cuando se da el parámetro --full" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "lanzamiento del proyecto, utilizado cuando se da el parámetro --full, por defecto es --doc-version" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "opciones de extensión" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s no es un directorio." #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "expresiones regulares inválidas %r en %s" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "Pruebas de cobertura en las fuentes terminadas, mira los resultados en %(outdir)spython.txt." #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "expresiones regulares inválidas %r en coverage_c_regexes" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "el módulo %s no podía ser importado: %s" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "falta '+' o '-' en la opción '%s'." #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "'%s' no es una opción válida." #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "'%s' no es una opción pyversion válida" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "tipo de TestCode inválido" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "Prueba de doctests en las fuentes terminadas, mira los resultados en %(outdir)s/output.txt." #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "sin código/salida en el bloque %s en %s:%s" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "ignorando el código doctest no válido: %r" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "====================== duraciones de lectura más lentas =======================" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "Directiva Graphviz no puede tener tanto el contenido y un argumento de nombre de archivo" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "Archivo externo Graphviz %r no encontrado o la lectura del mismo fallo" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "Ignorando la directiva \"graphviz\" sin contenido." #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot no produjo un archivo de salida:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "comando dot %r no se puede ejecutar (necesarios para la salida de graphviz), Compruebe la configuración de graphviz_dot" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot salió con error:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "el valor del parámetro graphviz_output_format debe ser uno de 'png', 'svg', pero es %r" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "dot código %r: %s" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[gráfica: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[gráfica]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "convert salió con error:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "el comando convert %r no puede ejecutar, compruebe el valor de configuración image_converter" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "comando LaTeX %r no se puede ejecutar (necesario para la visualización matemática), compruebe la configuración de imgmath_latex" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "El comando%s %r no se puede ejecutar (necesario para la visualización matemática), verifique la configuración imgmath_%s" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "visualizar latex %r: %s" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "en línea latex %r: %s" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Enlace permanente a esta ecuación" #: sphinx/ext/intersphinx.py:173 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "el inventario intersphinx se ha movido: %s -> %s" #: sphinx/ext/intersphinx.py:204 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "cargando inventario intersphinx desde %s..." #: sphinx/ext/intersphinx.py:218 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "encontró algunos problemas con algunos de los inventarios, pero tenían alternativas de trabajo:" #: sphinx/ext/intersphinx.py:224 msgid "failed to reach any of the inventories with the following issues:" msgstr "no se pudo llegar a ninguno de los inventarios con los siguientes problemas:" #: sphinx/ext/intersphinx.py:334 #, python-format msgid "(in %s v%s)" msgstr "(en %s versión %s)" #: sphinx/ext/intersphinx.py:336 #, python-format msgid "(in %s)" msgstr "(en %s)" #: sphinx/ext/intersphinx.py:369 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "el identificador de intersphinx %r no es una cadena. Ignorado" #: sphinx/ext/intersphinx.py:382 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "Error al leer intersphinx_mapping[%s], ignorado: %r" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[fuente]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Por hacer" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "Marca TODO encontrada: %s" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<entrada original>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(La <<entrada original>> se encuentra en %s, línea %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "entrada original" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "resaltando el código del módulo..." #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[documentos]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Código de módulo" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Código fuente para %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Resumen: código de modulo" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Todos los módulos para los cuales disponen código</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "firma inválida para auto%s (%r)" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "error al formatear argumentos para %s: %s" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "falta el atributo %s en el objeto %s" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "autodoc: no se pudo determinar %r que se documentará, se produjo la siguiente excepción:\n%s" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "no sabe qué módulo importar para el autodocumento %r (intente colocar una directiva \"module\" o \"currentmodule\" en el documento o dar un nombre explícito al módulo)" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "\"::\" en el nombre del automodule no tiene sentido" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "argumentos de firma o anotación de retorno dada para automodule %s" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "__all__ debe ser una lista de cadenas, no %r (en el módulo %s) -- ignorando __all__" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "Bases: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:78 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "Error al analizar type_comment para %r: %s" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "referencias autosummary excluidas documento %r. Ignorado." #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary: no se encontró el archivo stub %r. Verifique su configuración de autosummary_generate." #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "fallo al analizar el nombre %s" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "fallo al importar el objeto %s" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: archivo no encontrado: %s" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "autosummary genera archivos .rst internamente. Pero su source_suffix no contiene archivo .rst. Saltado." #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "autosummary: no se pudo determinar %r que se documentará, se produjo la siguiente excepción:\n%s" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[autosummary] generar autosummary para: %s" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "[autosummary] escribiendo a %s" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "[autosummary] fallo al importar %r: %s" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "\nGenere ReStructuredText usando directivas de resumen automático \"autosummary\".\n\nsphinx-autogen es una interfaz para sphinx.ext.autosummary.generate. Genera\nlos archivos reStructuredText de las directivas autosummary contenidas en el\nlos archivos de entrada dados.\n\nEl formato de la directiva autosummary está documentado en el módulo Python\n``sphinx.ext.autosummary`` y se puede leer usando el siguiente comando::\n\n pydoc sphinx.ext.autosummary\n" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "archivos fuente para generar archivos rST para" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "directorio para colocar toda la salida en" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "sufijo predeterminado para archivos (predeterminado: %(default)s)" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "directorio de plantillas personalizadas (predeterminado: %(default)s)" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "documento importados miembros (predeterminado: %(default)s)" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "Argumentos de palabras clave" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "Ejemplo" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Ejemplos" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "Notas" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "Otros parámetros" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "Referencias" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "Avisos" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "Campos" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Atención" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Prudencia" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Peligro" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Error" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Consejo" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Importante" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Nota" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Ver también" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Truco" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Advertencia" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "proviene de la página anterior" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "continué en la próxima página" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "No alfabético" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "Números" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "página" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "Tabla de contenido" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Búsqueda" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Ir a" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Mostrar el código" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Resumen" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "¡Bienvenido! Este es" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "la documentación para" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "actualizado por última vez el" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Índices y tablas:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Índice de contenidos completo" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "muestra todas las secciones y subsecciones" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "buscar en esta documentación" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Índice Global de Módulos" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "acceso rápido a todos los módulos" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "todas las funciones, clases, términos" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Índice – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Índice completo en una página" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Índice alfabético de páginas" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "puede ser muy grande" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navegación" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Buscar en %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Sobre este documento" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Copyright" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Derechos de autor</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Derechos de autor %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Actualizado por última vez en %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Buscar en %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Tema anterior" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "capítulo anterior" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Próximo tema" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "próximo capítulo" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Por favor, active JavaScript para habilitar la funcionalidad\n de búsqueda." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "La búsqueda de varias palabras solo muestra coincidencias que contienen\n todas las palabras." #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "buscar" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Resultados de la búsqueda" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Su búsqueda no coincide con ningún documentos. Por favor, asegúrese de que todas las palabras estén correctamente escritas y que usted allá seleccionado las suficientes categorías." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Búsqueda rápida" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Esta página" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Cambios en la versión %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Lista de cambios generada automáticamente en la versión %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Cambios en la biblioteca" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Cambios en la API C" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Otros cambios" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Enlazar permanentemente con este título" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Enlazar permanentemente con esta definición" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Ocultar coincidencias de la búsqueda" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Buscando" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Preparando búsqueda..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Búsqueda finalizada, encontró %s página(s) acorde con la consulta de búsqueda." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", en " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Expandir barra lateral" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Contraer barra lateral" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Contenidos" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "Índice basado en 4 columnas encontrado. Puede ser un error de extensiones que usted usa: %r" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "Pie de página [%s] no está referenciado." #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "Pie de página [#] no está referenciado." #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "referencias de pie de página inconsistentes en el mensaje traducido. original: {0}, traducido: {1}" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "referencias inconsistentes en el mensaje traducido. original: {0}, traducido: {1}" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "referencias de citas inconsistentes en el mensaje traducido. original: {0}, traducido: {1}" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "referencias de término inconsistentes en el mensaje traducido. original: {0}, traducido: {1}" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "más de un objetivo destino encontrado para 'cualquier' referencia cruzada %r: podría ser %s" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "No se pudo recuperar la imagen remota: %s [%d]" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "No se pudo recuperar la imagen remota: %s [%s]" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "Formato de imagen desconocido: %s..." #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "caracteres fuente no codificables, reemplazando con \"?\": %r" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "omitido" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "fallado" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "leyendo error: %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "escribiendo error: %s, %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "Formato de fecha inválido. Cite la cadena con comillas simples si desea generarla directamente: %s" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "toctree contiene referencia al archivo inexistente %r" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "excepción al evaluar solamente la expresión directiva: %s" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "rol por defecto %s no encontrado" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "numfig_format no está definido para %s" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "Cualquier ID no asignado para el nodo %s" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Enlace permanente a esta tabla" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Enlace permanente a este código fuente" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Enlace permanente a esta imagen" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Enlace permanente a la tabla de contenidos" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "No se pudo obtener el tamaño de la imagen. La opción :scale: se ignora." #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "desconocida %r toplevel_sectioning para la clase %r" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "demasiado grande :maxdepth:, ignorado." #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "El título del documento no es un nodo de texto único" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "no se encontró el nodo de título en la sección, tema, tabla, advertencia o barra lateral" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Notas a pie de página" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "ambas columnas tabulares y la opción :widths: se dan. La opción :widths: se ignora." #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "la unidad de dimensión %s no es válida. Ignorado." #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "tipo de entrada de índice desconocido %s encontrado" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[imagen: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[imagen]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "subtítulo no dentro de una figura." #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "tipo de nodo no implementado: %r" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "tipo de nodo desconocido: %r" ���������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3254566 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/et/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015513� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4780483 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/et/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017300� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/et/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000007571�00000000000�021161� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "et", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s &8212; %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Autori\u00f5igused</a> %(copyright)s.", "© Copyright %(copyright)s.": "© Autori\u00f5igused %(copyright)s.", ", in ": "", "About these documents": "Info selle dokumentatsiooni kohta", "Automatically generated list of changes in version %(version)s": "Automaatselt genereeritud nimekiri versiooni %(version)s muutustest", "C API changes": "C API muutused", "Changes in Version %(version)s — %(docstitle)s": "Muutused versioonis %(version)s — %(docstitle)s", "Collapse sidebar": "Varja k\u00fclgriba", "Complete Table of Contents": "T\u00e4ielik sisukorratabel", "Contents": "Sisukord", "Copyright": "Autori\u00f5igus", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "N\u00e4ita k\u00fclgriba", "Full index on one page": "T\u00e4isindeks \u00fchel lehel", "General Index": "\u00dcldindeks", "Global Module Index": "Globaalne moodulite indeks", "Go": "Otsi", "Hide Search Matches": "Varja otsingu tulemused", "Index": "Indeks", "Index – %(key)s": "Indeks – %(key)s", "Index pages by letter": "Indeksi lehek\u00fcljed algust\u00e4he kaupa", "Indices and tables:": "Indeksid ja tabelid:", "Last updated on %(last_updated)s.": "Viimati uuendatud %(last_updated)s.", "Library changes": "Teegi muutused", "Navigation": "Navigatsioon", "Next topic": "J\u00e4rgmine teema", "Other changes": "\u00dclej\u00e4\u00e4nud muutused", "Overview": "\u00dclevaade", "Permalink to this definition": "P\u00fcsiviit sellele definitsioonile", "Permalink to this headline": "P\u00fcsiviit sellele pealkirjale", "Please activate JavaScript to enable the search\n functionality.": "Otsingu v\u00f5imaldamiseks tuleb aktiveerida JavaScript.", "Preparing search...": "Otsingu ettevalmistamine...", "Previous topic": "Eelmine teema", "Quick search": "Kiirotsing", "Search": "Otsing", "Search Page": "Otsinguleht", "Search Results": "Otsingu tulemused", "Search finished, found %s page(s) matching the search query.": "Otsingu tulemusena leiti %s leht(e).", "Search within %(docstitle)s": "Otsi %(docstitle)s piires", "Searching": "Otsimine", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "N\u00e4ita l\u00e4htekoodi", "Table of Contents": "Sisukorratabel", "This Page": "K\u00e4esolev leht", "Welcome! This is": "Tervitused! See on", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Sinu otsingule ei vastanud \u00fckski dokument. Palun veendu, et k\u00f5ik sisestatud s\u00f5nad on \u00f5igesti kirjutatud ja sa oled valinud piisavalt kategooriaid.", "all functions, classes, terms": "k\u00f5ik funktsioonid, klassid ja terminid", "can be huge": "v\u00f5ib olla v\u00e4ga suur", "last updated": "viimati uuendatud", "lists all sections and subsections": "toob v\u00e4lja k\u00f5ik sektsioonid ja alamsektsioonid", "next chapter": "j\u00e4rgmine jaotis", "previous chapter": "eelmine jaotis", "quick access to all modules": "kiire ligip\u00e4\u00e4s k\u00f5igile moodulitele", "search": "otsi", "search this documentation": "otsi sellest dokumentatsioonist", "the documentation for": "dokumentatsioon projektile" }, "plural_expr": "(n != 1)" });���������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/et/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000102316�00000000000�021151� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� ���������������������r����� ���^�����l��=���r��7�����?�����"���(�� ���K�����U�����^�����d�����x���������������������� ���������� ����� ����� ��������?�����V�����m����������������� ����������6����������3���>�� ���r��1���~��1����������0��������&��b���B������� ����� ���������������>����� ���& ��(���0 ��(���Y ����� ����� �� ��� ��!��� ��%��� ������!�����!��4���!�� ���S!�����a!�����r!�����!�����!�� ���!�����!�����!��"���!�����"�����*"�� ���1"�����<"�����X"��D���^"��K���"�����"�����"������#�����#��8���!#��"���Z#��#���}#�����#��!���#��:���#�� ���$�����$�� ���'$�����5$�����I$��C���L$�����$�����$��.���$�� ���$�����$�����$�����$�����%�� ���(%�����5%�����I%�����g%�����%��!���%�����%�� ���%��C���%�����&�� ���8&�����E&�� ���U&�� ���a&��-���n&��(���&�� ���&�����&�� ���&��(���&�����'�����/'��Z���4'�����'�����'�� ���'��(���'�����'�����'�� ����(����� (�����"(�����?(�����Z(�����u(�����(�����(��B���(��i���)��I���l)��4���)�����)����� *��y���#*�����*�����*�����*�����*�� ���*�����*�����+�����+��$���'+�����L+�� ���`+�����m+�����~+�� ���+�����+�����+�����+�����+�� ���+�����+��<���+�����!,�� ���=,�� ���G,�����R,�����c,�����l,��+���,�� ���,��>���,�����,��#��� -�����1-�����C-�����K-�����`-�����i-�����{-��Y���-��Z���-��P���D.�����.��!���.��"���.��$���.�� ���/��K���@/��#���/��'���/��#���/��'���/��!���$0��7���F0�� ���~0��d���0��W���0��v���E1�����1�����1�����1��<���1��Y���2�� ���x2�����2��,���2�����2�����2��Y���3�����3��,���w4�����4�����4�� ���4�����4�� ���4�����4�����4�����4��?���5�����5�����5�� ���5�� ���5��,��� 6��2���76�����j6�� ���6��`���6�����6����� 7�����7�����*7�� ���<7��&���H7�����o7�����7�����7�����7�����7�����7�����8��!���+8�����M8�� ���S8�����`8��7���t8��4���8�����8�����8�����9��C���,9��G���p9�����9�����9�����9����� :�����&:�����E:�����Y:�����l:��=���:�����:�����:��0���:�����;��/���;�����I;�� ���d;�� ���n;�����;�����;�����;��0���;��&���;�����<�����1<�����Q<�����n<��4���<�����<��Y���<�����=��4���:=�����o=�����=�� ���=�����=�����=�����=�����=�� ���>��M���>�����j>�����|>�� ���>�����>��A���>�����?�����?�����#?�����6?�����F?�� ���Y?�� ���g?��=���u?��'���?��0���?��,��� @��!���9@�����[@�����z@��=���@��+���@��0����A�����1A�����7A�����MA�����kA��/���A�����A�����A�����A�� ���A��7���B��"���>B�����aB�����}B�����B��"���B�����B�����B�����B����� C�����C�����C�����"C�����*C�� ���/C��E���<C��B���C��G���C����� D�����'D��-���CD�� ���qD�����|D�����D�����D��(���D�����D�� ���D��P���D��"���;E�����^E��O���wE�����E�����E�����E��%���E�����F�� ���*F�����7F�� ���SF�����^F�����tF�����F�����F�����F�����F�����F�����F�����F�����F�����G�� ���G�� ���'G�����HG��&���[G��*���G��>���G��7���G�� ���$H�� ���.H�� ���<H��,���FH��*���sH��0���H�����H��%���H��1���I��1���EI�����wI��'���I��%���I�����I�����I�����J�����J��*���0J�����[J�����dJ��P���wJ��9���J��;���K��)���>K�����hK�����{K�����K�����K�����K�����K�����K���� L�� ��M�����N�� ���jO�� ���vO��F���O��@���O��H��� P��!���UP�� ���wP�� ���P�����P�����P�����P�����P�����P�����P�����Q��!���Q�����4Q�� ���EQ�� ���QQ��&���[Q�����Q�����Q�����Q�����Q�����Q�����Q�� ��� R�����R��;���+R��$���gR��*���R�����R��7���R��7���S�����:S��%���JS�����pS��l���S��!���S�� ���T�� ���!T�����-T�����<T��C���DT�����T��'���T��)���T��&���T�� ���U�����U��)���.U��6���XU�� ���U�����U��5���U�� ���U�����U�����V��'���V�����FV�� ���OV��%���\V�����V��"���V�����V�����V�����V�����V�����V��7���W��/���9W�����iW�����pW�����xW�����W��F���W��&���W��)��� X�� ���5X��+���?X��0���kX�����X�����X�� ���X�����X�����X��L���X�����BY�����ZY��+���`Y�����Y�����Y�����Y��$���Y�����Y�� ���Y�����Y�����Z�����/Z�����GZ��#���bZ�����Z�� ���Z��E���Z�����Z�����[�����[�� ���$[�� ���1[��-���>[��-���l[�� ���[�����[�����[��;���[��(���\�����.\��T���6\�� ���\�� ���\�����\��%���\�� ���\�����\�� ���]��"��� ]��!���0]�����R]�����p]�����]�����]�� ���]��5���]��r���^��N���^��@���^�����_�����=_�����X_�����_�� ��� `�����`�� ���0`�� ���>`�����L`�����``�����y`��$���`�����`�� ���`�����`�� ���`�����`�����a����� a����� a�����'a�� ���:a�����Fa��$���Xa�����}a�����a�� ���a�����a�����a�����a��5���a�����b��4���+b�����`b��7���xb�����b�� ���b�����b�����b�����b�����b��X���c��[���gc��G���c��%��� d��(���1d��*���Zd��,���d��(���d��V���d��+���2e��/���^e��)���e��.���e��*���e��+���f�����>f��[���Mf��l���f�����g�����g�����g�����g��B���g��^���h�����ch�����lh��5���th�����h�����h��^���ui�����i��;���kj��&���j�����j�� ���j�����j�� ���j�����k�� ���k�����k��>���k��'���k����� l�����l�����&l��7���5l��A���ml�����l�� ���l��q���l��#���Im�����mm�����~m�����m�����m��7���m��%���m��.���n��,���Kn�����xn��+���n��.���n�����n��#��� o�����-o�� ���3o�����Ao��7���Po��2���o�����o�����o�����o��T���p��X���gp�����p�� ���p�����p�����q��&���7q�����^q�����vq�����q��B���q�����q�����r��4���r�����Hr��6���Or�����r�� ���r�����r�����r�����r�����r��=���s��%���@s�����fs��'���us�� ���s��"���s��>���s����� t��l���'t��.���t��1���t�����t�� ��� u�����,u�����2u�����Cu�����Xu��$���wu�����u��R���u�����u�����v�� ���'v�����2v��E���Ov�����v�� ���v�����v�� ���v�����v�����v�����w��E���w��%���[w��;���w��C���w��!���x�� ���#x�����Dx��B���bx��B���x��E���x�����.y�����5y�����Ly�����ky��3���y�����y�����y�� ���y������z��<���z��0���Oz��#���z�����z�����z��'���z�����{�����{�����!{�����5{�����;{�����B{�����I{�� ���R{�����\{��H���m{��F���{��J���{�����H|�����d|��5���{|�� ���|�����|�� ���|�� ���|��0���|�� ��� }��%���}��K���9}��#���}�����}��D���}�����~�����"~�����*~��'���9~�����a~�� ���r~��%���~�����~�����~�����~�����~�� ���~���������������1�����6�����U�����Z�����z�� �����2����������/�����-��� ��@���8��5���y������������ ���ǀ��!���Ҁ��!�����$��������;�����T��/���j��2��������́�� �������� ��+���(�����T�����p�����w��5��������Â�����˂��K���݂��K���)��T���u��2���ʃ������� ����� ���6�����W��"���q������������� Generate required files for a Sphinx project. sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build. � Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� (deprecated)� (in �"latex_documents" config value references unknown document %s�"man_pages" config value references unknown document %s�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%s %s�%s %s documentation�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command line option�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�-A option argument must be in the form name=value�-D option argument must be in the form name=value�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�About these documents�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builtins�C API changes�Cannot find source directory (%s)�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not import extension %s�Create Makefile? (y/n)�Create Windows command file? (y/n)�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Error�Error: an existing conf.py has been found in the selected root path.�Error: the master file %s has already been found in the selected root path.�Example�Examples�Expand sidebar�Extension options�External Graphviz file %r not found or reading it failed�Failed to read build info file: %r�Failed to write build info file: %r�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnotes�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Hide Search Matches�Hint�Ignoring "graphviz" directive without content.�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Interrupted!�Invalid caption: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�Keyword Arguments�Last updated on %(last_updated)s.�Library changes�Listing %s�Look for any errors in the above output or in %(outdir)s/output.txt�Makefile and Batchfile creation�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Note�Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.�Notes�Original exception: �Other changes�Output directory (%s) is not a directory�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Please activate JavaScript to enable the search functionality.�Please also report this if it was a user error, so that a better error message can be provided next time.�Please enter a new file name, or rename the existing file and press Enter�Please enter a new root path (or just Enter to exit)�Please enter either 'y' or 'n'.�Please enter some text.�Please enter values for the following settings (just press Enter to accept a default value, if one is given in brackets).�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project templating�Project version�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Recursion error:�Release�Return type�Returns�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section %s�Section author: �See also�Selected root path: %s�Separate source and build directories (y/n)�Show Source�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Structure options�Symbols�TODO entry found: %s�Table %s�Table of Contents�Template Parameters�Testing of coverage in the sources finished, look at the results in %(outdir)spython.txt.�Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt.�The %s extension is required by needs_extensions settings, but it is not loaded.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The configuration file (or one of the modules it imports) called sys.exit()�The manual pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�The overview file is in %(outdir)s.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a syntax error in your configuration file: %s �This Page�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Tip�Todo�Unknown image format: %s...�Use the Makefile to build the docs, like so: make builder�Use the sphinx-build command to build the docs, like so: sphinx-build -b builder %s %s�Variables�Warning�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�You have two options for placing the build directory for Sphinx output. Either, you use a directory "_build" within the root path, or you separate "source" and "build" directories within the root path.�You should now populate your master file %s and create other documentation source files. �Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[autosummary] generating autosummary for: %s�[autosummary] writing to %s�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.�a list of specific files to rebuild. Ignored if -a is specified�all functions, classes, terms�all source files�attribute�author names�automatically insert docstrings from modules�automatically test code snippets in doctest blocks�build %s, %s warning.�build %s.�build in parallel with N processes where possible (special value "auto" will set N to cpu-count)�builder to use (default: html)�building [%s]: �building [mo]: �built-in function�can be huge�cannot combine -a option and filenames�cannot copy extra file %r�cannot copy image file %r: %s�cannot copy static file %r�cannot find files %r�cannot open warning file %r: %s�cannot write image file %r: %s�checking consistency�checks for documentation coverage�class�class method�command line option�conditional inclusion of content based on config values�config directory doesn't contain a conf.py file (%s)�console output options�continued from previous page�continues on next page�convert command %r cannot be run, check the image_converter setting�convert command %r cannot be run, check the image_converter setting: %s�copying TeX support files�copying TeX support files...�copying Texinfo support files�copying additional files�copying downloadable files... �copying extra files�copying images... �copying source files...�create .nojekyll file to publish the document on GitHub pages�create batchfile�create makefile�custom template directory (default: %(default)s)�data�default suffix for files (default: %(default)s)�define a template variable�directive�directory to place all output in�do not create batchfile�do not create makefile�document�document imported members (default: %(default)s)�document isn't included in any toctree�document language�document not readable. Ignored.�domain %s already registered�domain %s not yet registered�don't use a saved environment, always read all files�done�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�dumping search index in %s�duplicate label of equation %s, other instance in %s�enable %s extension�enable arbitrary extensions�enumerator�environment variable�environment variable; %s�error writing file %s: %s�error writing file Makefile: %s�exception�extension %r has no setup() function; is it really a Sphinx extension module?�extension options�failed to import object %s�failed: %s�favicon file %r does not exist�file %r on theme path is not a valid zipfile or contains no theme�finished with problems�function�function parameter�general options�generating indices�glossary term�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�html_extra_path entry %r does not exist�html_extra_path entry %r is placed inside outdir�if specified, separate source and build dirs�ignoring invalid doctest code: %r�image file %s not readable: %s�image file not readable: %s�include links to the source code of documented Python objects�include math, rendered as PNG or SVG images�include math, rendered in the browser by MathJax�index�invalid TestCode type�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�keyword�last updated�link between Sphinx documentation of different projects�lists all sections and subsections�loading pickled environment�loading translations [%s]... �logo file %r does not exist�looking for now-outdated files... �macro�making output directory�master document name�member�method�module�modules�next�next chapter�no "latex_documents" config value found; no documents will be written�no "man_pages" config value found; no manual pages will be written�no "texinfo_documents" config value found; no documents will be written�no changes in version %s.�no targets are out of date.�no theme named %r found (missing theme.conf?)�none found�object�operator�original entry�override a setting in configuration file�page�pass a value into HTML templates�path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)�path to documentation source files�path to output directory�path where configuration file (conf.py) is located (default: same as SOURCEDIR)�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�program option�project name�quick access to all modules�quiet mode�reading error: %s, %s�reading sources... �reading templates... �reference label�release of project�resolving references...�role�run Pdb on exception�search�search this documentation�see %s�see also %s�show full traceback on exception�source file suffix�source files to generate rST files for�source_parser for %r is already registered�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�statement�static method�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�targets for %d template files�template directory for template files�the %s extension is not safe for parallel reading�the %s extension is not safe for parallel writing�the documentation for�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�too large :maxdepth:, ignored.�turn warnings into errors�type�updating environment: �use no config file at all, only -D options�variable�version of project�where "builder" is one of the supported builders, e.g. html, latex or linkcheck.�write "todo" entries that can be shown or hidden on build�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing %s file...�writing additional files�writing additional pages�writing error: %s, %s�writing message catalogs... �writing output... �writing summary file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: et Language-Team: Estonian (http://www.transifex.com/sphinx-doc/sphinx-1/language/et/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � Sphinx-projekti jaoks vajalike failide genereerimine. sphinx-quickstart on interaktiivne tööriist, mis küsib mõned küsimused Sinu projekti kohta ja seepeale genereerib täieliku dokumentatsioonikataloogi ning näidis-Makefile kasutamiseks koos sphinx-buildiga. � Nende jooksutamiseks läbi (pdf)latex programmi käivita selles kataloogis 'make' (selle automaatseks tegemiseks kasuta `make latexpdf').� (iganenud)� (pealkirjas �seadistusparameeter "latex_documents" viitab tundmatule dokumendile %s�seadistusparameeter "man_pages" viitab tundmatule dokumendile %s�seadistusparameeter "texinfo_documents" viitab tundmatule dokumendile %s�%(filename)s &8212; %(docstitle)s�%d. %b %Y�leitud %d�%s %s�%s %s dokumentatsioon�%s (%s atribuut)�%s (sisseehitatud klass)�%s (sisseehitatud muutuja)�%s (klass moodulis %s)�%s (direktiiv)�%s (globaalmuutuja või konstant)�%s (moodulis %s)�%s (moodul)�%s (roll)�lisatud %s, muudetud %s, eemaldatud %s�%s käsureasuvand�%s pole kataloog.�%s() (klassi %s meetod)�%s() (%s meetod)�%s() (%s staatiline meetod)�%s() (sisseehitatud funktsioon)�%s() (klass)�%s() (moodulis %s)�© <a href="%(path)s">Autoriõigused</a> %(copyright)s.�© Autoriõigused %(copyright)s.�(<<algne kirje>> asub failis %s, real %d.)�(projektis %s v%s)�-A suvandi argument peab olema vormingus nimi=väärtus�-D suvandi argument peab olema vormingus nimi=väärtus�<<algne kirje>>�<h1>Kõik lähtekoodiga moodulid</h1>�<h1>%s lähtekood</h1>�Vearaportit on võimalik esitada träkkeris aadressil <https://github.com/sphinx-doc/sphinx/issues>. Aitäh!�Info selle dokumentatsiooni kohta�Argumendid�Tähelepanu�Autorite nimed�Autor: �Automaatselt genereeritud nimekiri versiooni %(version)s muutustest�Põlvnemine: %s�Ehitaja %r on juba olemas (moodulis %s)�Ehitaja klassil %s puudub atribuut "name"�Ehitajat nimega %s pole registreeritud�Sisseehitatud�C API muutused�Lähtekataloogi (%s) pole võimalik leida�Suvandeid "%s" ja "%s" pole võimalik korraga kasutada�Ettevaatust�Muudetud versioonis %s�Muutused versioonis %(version)s — %(docstitle)s�Koodi autor: �Varja külgriba�Täielik sisukorratabel�Seadistuste väärtus %r on juba olemas�Sisukord�Autoriõigus�Laiendust %s pole võimalik importida�Kas luua Makefile? (y/n)�Kas luua Windowsi käsufail? (y/n)�Faili %s loomine.�Oht�Iganenud�Iganenud alates versioonist %s�Viga�Viga: valitud juurkataloogist leiti olemasolev conf.py.�Viga: valitud juurkataloogist leiti peafail %s.�Näide�Näited�Näita külgriba�Laienduste suvandid�Välist Graphviz-faili %r ei leitud või esines tõrge selle lugemisel�Viga ehitamise infofaili lugemisel: %r�Viga ehitamise infofaili kirjutamisel: %r�Joonis %s�Fail %s on juba olemas ja jäetakse vahele.�Lõpetamine: Algne kataloogistruktuur on loodud.�Joonealused märkused�Täisindeks ühel lehel�Üldindeks�Globaalne moodulite indeks�Otsi�Graphviz direktiivil ei tohi samaaegselt olla argumendid content ja filename�Varja otsingu tulemused�Vihje�Ilma sisuta "graphviz" direktiivi eiramine.�Tähtis�Indeks�Indeks – %(key)s�Indeksi leheküljed algustähe kaupa�Indeksid ja tabelid:�Katkestatud!�Vigane selgitustekst: %s�Vigane math_eqref_format: %r�Vigane mallimuutuja: %s�Võtmesõnadega argumendid�Viimati uuendatud %(last_updated)s.�Teegi muutused�Nimekiri %s�Otsi vigu ülalolevast väljundist või failist %(outdir)s/output.txt�Makefile ja Batchfile loomine�Mooduli indeks�Mooduli autor: �Mooduli kood�Mooduli tase�Sinu põhidokumendi nimi (ilma järelliiteta)�Mallide ja staatilise kataloogi nime eesliide�Navigatsioon�Uus versioonis %s�Järgmine teema�Ehitajat pole valitud, kasutatakse vaikimisi ehitajat: html�Puudub määratud seadistusväärtus: %s�Märkus�Märkus: imgmath ja mathjax ei saa korraga lubatud olla. imgmath eemaldati valikust.�Märkused�Algne erind: �Ülejäänud muutused�Väljundkataloog (%s) ei ole kataloog�Ülevaade�Ülevaade: mooduli kood�Parameetrid�Püsiviit sellele programmikoodile�Püsiviit sellele definitsioonile�Püsiviit sellele võrrandile�Püsiviit sellele pealkirjale�Püsiviit sellele pildile�Püsiviit sellele tabelile�Püsiviit sellele sisukorrapuule�Otsingu võimaldamiseks tuleb aktiveerida JavaScript.�Kui see oli kasutaja viga, siis anna palun sellest teada, et tulevikus oleks võimalik parem veateade väljastada.�Palun sisesta uus failinimi või nimeta olemasolev fail ümber ja vajuta Enter�Palun sisesta uus juurkataloog (või vajuta Enter lõpetamiseks)�Palun sisesta kas 'y' või 'n'.�Palun sisesta mingi tekst.�Palun sisesta väärtused järgnevate sätete jaoks (kandiliste sulgude vahel võib olla vaikeväärtus, millega nõustumiseks vajuta lihtsalt Enter).�Otsingu ettevalmistamine...�Eelmine teema�Projekti põhisuvandid�Projekti keel�Projekti nimi�Projekti väljalase�Projekti loomine mallist�Projekti versioon�Pythoni täiustusettepanekud; PEP %s�Pythoni moodulite indeks�Kiirotsing�Rekursiooni viga:�Redaktsioon�Tagastustüüp�Tagastab�Sphinx v%s käitamine�Otsing�Otsi %(docstitle)s�Otsinguleht�Otsingu tulemused�Otsingu tulemusena leiti %s leht(e).�Otsi %(docstitle)s piires�Otsimine�Sektsioon %s�Sektsiooni autor: �Vaata ka�Valitud juurkataloog: %s�Lähtekoodi ja ehitamise kataloogide eraldamine (y/n)�Näita lähtekoodi�Lähtekataloog ja sihtkataloog ei tohi olla identsed�Lähtefaili järelliide�Lähtekoodi analüsaatorit pole %s jaoks registreeritud�Struktuuri suvandid�Sümbolid�Leitud TEHA kirje: %s�Tabel %s�Sisukorratabel�Malli parameetrid�Lähtefailide katvustestimine on lõppenud, vaata tulemusi failist %(outdir)spython.txt.�Lähtefailide doctest-testimine on lõppenud, vaata tulemusi failist %(outdir)s/output.txt.�needs_extensions sätted nõuavad laiendust %s, kuid see pole laaditud.�HTML-leht asub kataloogis %(outdir)s.�HTML-lehed asuvad kataloogis %(outdir)s.�LaTeX-failid asuvad kataloogis %(outdir)s.�Texinfo failid asuvad kataloogis %(outdir)s.�XML-failid asuvad kataloogis %(outdir)s.�Seadistusfail (või mõni selle poolt imporditud moodulitest) kutsus välja sys.exit()�Juhendi lehed asuvad kataloogis %(outdir)s.�Sõnumikataloogid asuvad kataloogis %(outdir)s.�Ülevaatefail asub kataloogis %(outdir)s.�PseudoXML-failid asuvad kataloogis %(outdir)s.�Tekstifailid asuvad kataloogis %(outdir)s.�Sinu seadistusfailis on süntaksi viga: %s �Käesolev leht�See keskkond pole valitud ehitajaga ühilduv, palun vali mõni teine dokumendipuu kataloog.�See projekt vajab vähemalt Sphinxi v%s ja seetõttu pole projekti võimalik käesoleva versiooniga ehitada.�See projekt vajab laiendust %s vähemalt versiooniga %s ja seetõttu pole projekti võimalik laaditud versiooniga (%s) ehitada.�Nõuanne�Teha�Tundmatu pildivorming: %s...�Dokumentide ehitamiseks kasuta Makefile, näiteks: make ehitaja�Dokumentide ehitamiseks kasuta käsku sphinx-build, näiteks: sphinx-build -b builder %s %s�Muutujad�Hoiatus�Tere tulemast kasutama Sphinx %s lendstardi utiliiti.�Tervitused! See on�Sphinx'i väljundi ehitamise kataloogi asetamiseks on kaks valikut. Võid kasutada kataloogi "_build" juurkataloogis või eraldiseisvaid "source" ja "build" katalooge juurkataloogis.�Sa peaks nüüd asustama oma peafaili %s ja looma ülejäänud dokumentatsiooni lähtefailid. �Sinu otsingule ei vastanud ükski dokument. Palun veendu, et kõik sisestatud sõnad on õigesti kirjutatud ja sa oled valinud piisavalt kategooriaid.�[autosummary] automaatkokkuvõtte genereerimine failile: %s�[autosummary] kirjutamine kataloogi %s�[dokumentatsioon]�[joonis: %s]�[joonis]�[pilt: %s]�[pilt]�[lähtekood]�lehe %s renderdamisel tekkis Unicode viga. Palun veendu, et kõik mitte-ASCII sisuga seadistusparameetrid on kirjeldatud Unicode stringidena.�määratud failide uuestiehitamine. Võtme -a korral eiratakse�kõik funktsioonid, klassid ja terminid�kõik lähtefailid�atribuut�autorite nimed�moodulite dokumentatsioonistringide automaatne lisamine�dokumentatsioonistringides olevate koodijuppide automaattestimine�ehitamine %s, %s hoiatus.�ehitamine %s.�rööbiti ehitamine N protsessiga, kui võimalik (eriväärtus "auto" määrab N väärtuseks protsessorite arvu)�kasutatav ehitaja (vaikimisi: html)�ehitamine [%s]: �ehitamine [mo]: �sisseehitatud funktsioon�võib olla väga suur�suvandit -a ja failinimesid pole võimalik kombineerida�lisafaili %r pole võimalik kopeerida�kujutise faili %r pole võimalik kopeerida: %s�staatilist faili %r pole võimalik kopeerida�faile %r pole võimalik leida�hoiatuste faili %r pole võimalik avada: %s�kujutise faili %r pole võimalik kirjutada: %s�kooskõla kontrollimine�dokumentatsiooni katvuse kontrollid�klass�klassi meetod�käsureasuvand�sisu tingimuslik kaasamine seadistusparameetrite alusel�seadistuste kataloog (%s) ei sisalda faili conf.py�konsooliväljundi suvandid�jätk eelmisele leheküljele�jätkub järgmisel leheküljel�teisendamise käsku %r pole võimalik käivitada, kontrolli image_converter sätteid�teisendamise käsku %r pole võimalik käivitada, kontrolli image_converter sätteid: %s�TeX-i tugifailide kopeerimine�TeX-i tugifailide kopeerimine...�Texinfo tugifailide kopeerimine�lisafailide kopeerimine�allalaaditavate failide kopeerimine...�lisafailide kopeerimine�kujutiste kopeerimine... �lähtefailide kopeerimine...�.nojekyll faili loomine dokumentide avaldamiseks GitHub-i lehtedel�batchfile loomine�makefile loomine�kohandatud mallide kataloog (vaikimisi: %(default)s)�andmed�failide vaikimisi järelliide (vaikimisi: %(default)s)�malli muutuja kirjeldamine�direktiiv�väljundfailide kataloog�batchfile loomata jätmine�makefile loomata jätmine�dokument�imporditud liikmete dokumenteerimine (vaikimisi: %(default)s)�dokument pole ühegi sisukorrapuu osa�dokumendi keel�dokument pole loetav ja seda eiratakse.�domeen %s on juba registreeritud�domeen %s pole veel registreeritud�salvestatud keskkonda ei kasutata, alati loetakse kõik failid�valmis�dot käsku %r pole võimalik käivitada (vajalik graphvizi väljundi jaoks), kontrolli graphviz_dot sätteid�otsinguindeksi tõmmise kirjutamine keelele %s�võrrandil %s on topeltsilt, teine instants on %s�laienduse %s lubamine�suvaliste laienduste määramine�loend�keskkonnamuutuja�keskkonnamuutuja; %s�viga faili %s kirjutamisel: %s�viga faili Makefile kirjutamisel: %s�erind�erindil %r puudub funktsioon setup(); kas see on päriselt Sphinxi laiendusmoodul?�laienduse suvandid�tõrge objekti %s importimisel�tõrge: %s�favicon faili %r pole olemas�fail %r teemarajal pole korrektni zip-fail või ei sisalda see teemat�lõppes probleemidega�funktsioon�funktsiooni parameeter�üldsuvandid�indeksite genereerimine�sõnastiku termin�grammatika märk�graphviz_output_format peab olema kas 'png' või 'svg', kuid mitte %r�html_extra_path kirjet %r pole olemas�html_extra_path kirje %r asub väljaspool väljundkataloogi�kasutamise korral eraldatakse lähtefailide ja ehitamise kataloogid�vigase doctest koodi eiramine: %r�kujutise fail %s pole loetav: %s�kujutise fail pole loetav: %s�dokumenteeritud Python-objektide lähtekoodile viitamise kaasamine�matemaatika kaasamine, mis renderdatakse PNG- või SVG-kujutisteks�matemaatika kaasamine, mis renderdatakse veebisirvikus MathJax-i abil�indeks�vigane TestCode tüüp�vigane css_file: %r, eiratakse�vigane js_file: %r, eiratakse�vigane arv %r seadistuse väärtusele %r, eiratakse�vigane numfig_format: %s�vigane numfig_format: %s (%r)�võtmesõna�viimati uuendatud�eri projektide Sphinx-dokumentatsiooni omavaheline viitamine�toob välja kõik sektsioonid ja alamsektsioonid�serialiseeritud keskkonna laadimine�tõlgete laadimine [%s]... �logofaili %r pole olemas�praeguseks aegunud failide otsimine... �makro�väljundkataloogi loomine�põhidokumendi nimi�liige�meetod�moodul�moodulid�järgmine�järgmine jaotis�seadistusparameetrit "latex_documents" ei leitud, dokumente ei kirjutata�seadistusparameetrit "man_pages" ei leitud, juhendi lehti ei kirjutata�seadistusparameetrit "texinfo_documents" ei leitud, dokumente ei kirjutata�versioonis %s pole muutusi.�aegunud sihtfaile pole�teemat nimega %r ei leitud (kas theme.conf on puudu?)�ei leitud�objekt�operaator�algne kirje�seadistusfailis määratud väärtuse asendamine�lehekülg�väärtuse edastamine HTML-mallidesse�puhverdatud keskkonna ja dokumendipuu rada (vaikimisi: OUTPUTDIR/.doctrees)�dokumentatsiooni lähtefailide rada�väljundkataloogi rada�seadistusfaili (conf.py) asukoha rada (vaikimisi sama mis SOURCEDIR)�dokumentide ettevalmistamine�eelmine�eelmine jaotis�primary_domain %r ei leitud, eiratakse.�programmi suvand�projekti nimi�kiire ligipääs kõigile moodulitele�vaikne režiim�viga lugemisel: %s, %s�lähtefailide lugemine...�mallide lugemine... �viite silt�projekti väljalase�viidete lahendamine...�roll�erindi korral Pdb käivitamine�otsi�otsi sellest dokumentatsioonist�vaata %s�vaata ka %s�erindi korral täieliku tagasijälituse näitamine�lähtefaili järelliide�lähtefailid, mille kohta rST-faile genereerida�source_parser on %r jaoks juba registreeritud�sphinx-quickstart ei kirjuta olemasolevaid Sphinx-projekte üle.�sphinx-quickstart ei kirjuta olemasolevat faili üle.�lause�staatiline meetod�oli edukas�%d po-faili sihtfailid on aegunud�%d määratud po-faili sihtfailid�%d lähtefaili sihtfailid on aegunud�%d mallifaili sihtfailid�mallifailide kataloog�laiendus %s pole rööbiti lugemiseks turvaline�laiendus %s pole rööbiti kirjutamiseks turvaline�dokumentatsioon projektile�teemal %r puudub "inherit" säte�teemal %r puudub "theme" säte�:maxdepth: on liiga suur ja seda eiratakse.�hoiatuste muutmine vigadeks�tüüp�keskkonna uuendamine:�seadistusfaili ei kasutata üldse, ainult -D suvandid�muutuja�projekti versioon�kus "ehitaja" on üks toetatud ehitajatest, nt. html, latex või linkcheck.�"teha" sissekannete kirjutamine, mida võib ehitamisega peita või näidata�kõikide failide kirjutamine (vaikimisi kirjutatakse ainult uued ja muutunud failid)�hoiatuste (ja vigade) kirjutamine määratud faili�faili %s kirjutamine...�täiendavate failide kirjutamine�täiendavate lehtede kirjutamine�viga kirjutamisel: %s, %s�sõnumikataloogide kirjutamine... �väljundi kirjutamine... �kokkuvõttefaili kirjutamine...�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/et/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000274526�00000000000�021171� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Aivar Annamaa <aivar.annamaa@gmail.com>, 2011 # Ivar Smolin <okul at linux ee>, 2012 # Ivar Smolin <okul@linux.ee>, 2013-2021 # Luc Saffre <luc.saffre@gmail.com>, 2015 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Estonian (http://www.transifex.com/sphinx-doc/sphinx-1/language/et/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: et\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Lähtekataloogi (%s) pole võimalik leida" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "Väljundkataloog (%s) ei ole kataloog" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Lähtekataloog ja sihtkataloog ei tohi olla identsed" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx v%s käitamine" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "See projekt vajab vähemalt Sphinxi v%s ja seetõttu pole projekti võimalik käesoleva versiooniga ehitada." #: sphinx/application.py:243 msgid "making output directory" msgstr "väljundkataloogi loomine" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "tõlgete laadimine [%s]... " #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "valmis" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "serialiseeritud keskkonna laadimine" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "tõrge: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "Ehitajat pole valitud, kasutatakse vaikimisi ehitajat: html" #: sphinx/application.py:348 msgid "succeeded" msgstr "oli edukas" #: sphinx/application.py:349 msgid "finished with problems" msgstr "lõppes probleemidega" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "ehitamine %s, %s hoiatus." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "ehitamine %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "laiendus %s pole rööbiti lugemiseks turvaline" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "laiendus %s pole rööbiti kirjutamiseks turvaline" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "seadistuste kataloog (%s) ei sisalda faili conf.py" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "vigane arv %r seadistuse väärtusele %r, eiratakse" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "Puudub määratud seadistusväärtus: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "Seadistuste väärtus %r on juba olemas" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Sinu seadistusfailis on süntaksi viga: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Seadistusfail (või mõni selle poolt imporditud moodulitest) kutsus välja sys.exit()" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Sektsioon %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Joonis %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tabel %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Nimekiri %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r ei leitud, eiratakse." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "needs_extensions sätted nõuavad laiendust %s, kuid see pole laaditud." #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "See projekt vajab laiendust %s vähemalt versiooniga %s ja seetõttu pole projekti võimalik laaditud versiooniga (%s) ehitada." #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "dokument pole loetav ja seda eiratakse." #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "Ehitaja klassil %s puudub atribuut \"name\"" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Ehitaja %r on juba olemas (moodulis %s)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "Ehitajat nimega %s pole registreeritud" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "domeen %s on juba registreeritud" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "domeen %s pole veel registreeritud" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "source_parser on %r jaoks juba registreeritud" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "Lähtekoodi analüsaatorit pole %s jaoks registreeritud" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "Algne erind:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "Laiendust %s pole võimalik importida" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "erindil %r puudub funktsioon setup(); kas see on päriselt Sphinxi laiendusmoodul?" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Pythoni täiustusettepanekud; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "teemal %r puudub \"theme\" säte" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "teemal %r puudub \"inherit\" säte" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "fail %r teemarajal pole korrektni zip-fail või ei sisalda see teemat" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "teemat nimega %r ei leitud (kas theme.conf on puudu?)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "ehitamine [mo]: " #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "väljundi kirjutamine... " #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "%d määratud po-faili sihtfailid" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "%d po-faili sihtfailid on aegunud" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "kõik lähtefailid" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "%d lähtefaili sihtfailid on aegunud" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "ehitamine [%s]: " #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "praeguseks aegunud failide otsimine... " #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "leitud %d" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "ei leitud" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "kooskõla kontrollimine" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "aegunud sihtfaile pole" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "keskkonna uuendamine:" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "lisatud %s, muudetud %s, eemaldatud %s" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "lähtefailide lugemine..." #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "dokumentide ettevalmistamine" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "kujutiste kopeerimine... " #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "kujutise faili %r pole võimalik kopeerida: %s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "kujutise faili %r pole võimalik kirjutada: %s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "faili %s kirjutamine..." #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "Ülevaatefail asub kataloogis %(outdir)s." #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "versioonis %s pole muutusi." #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "kokkuvõttefaili kirjutamine..." #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Sisseehitatud" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Mooduli tase" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "lähtefailide kopeerimine..." #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "vigane css_file: %r, eiratakse" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "Sõnumikataloogid asuvad kataloogis %(outdir)s." #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "%d mallifaili sihtfailid" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "mallide lugemine... " #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "sõnumikataloogide kirjutamine... " #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "Otsi vigu ülalolevast väljundist või failist %(outdir)s/output.txt" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "Juhendi lehed asuvad kataloogis %(outdir)s." #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "seadistusparameetrit \"man_pages\" ei leitud, juhendi lehti ei kirjutata" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "seadistusparameeter \"man_pages\" viitab tundmatule dokumendile %s" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "HTML-leht asub kataloogis %(outdir)s." #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "täiendavate failide kirjutamine" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "Texinfo failid asuvad kataloogis %(outdir)s." #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "seadistusparameetrit \"texinfo_documents\" ei leitud, dokumente ei kirjutata" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "seadistusparameeter \"texinfo_documents\" viitab tundmatule dokumendile %s" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "viidete lahendamine..." #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (pealkirjas " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "Texinfo tugifailide kopeerimine" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "viga faili Makefile kirjutamisel: %s" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "Tekstifailid asuvad kataloogis %(outdir)s." #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "viga faili %s kirjutamisel: %s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "XML-failid asuvad kataloogis %(outdir)s." #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "PseudoXML-failid asuvad kataloogis %(outdir)s." #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "HTML-lehed asuvad kataloogis %(outdir)s." #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "Viga ehitamise infofaili lugemisel: %r" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d. %b %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Üldindeks" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "indeks" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "järgmine" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "eelmine" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "indeksite genereerimine" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "täiendavate lehtede kirjutamine" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "allalaaditavate failide kopeerimine..." #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "staatilist faili %r pole võimalik kopeerida" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "lisafailide kopeerimine" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "lisafaili %r pole võimalik kopeerida" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "Viga ehitamise infofaili kirjutamisel: %r" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "lehe %s renderdamisel tekkis Unicode viga. Palun veendu, et kõik mitte-ASCII sisuga seadistusparameetrid on kirjeldatud Unicode stringidena." #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "otsinguindeksi tõmmise kirjutamine keelele %s" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "vigane js_file: %r, eiratakse" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "html_extra_path kirjet %r pole olemas" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "html_extra_path kirje %r asub väljaspool väljundkataloogi" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "logofaili %r pole olemas" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "favicon faili %r pole olemas" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s dokumentatsioon" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "LaTeX-failid asuvad kataloogis %(outdir)s." #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\nNende jooksutamiseks läbi (pdf)latex programmi käivita selles kataloogis\n'make' (selle automaatseks tegemiseks kasuta `make latexpdf')." #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "seadistusparameetrit \"latex_documents\" ei leitud, dokumente ei kirjutata" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "seadistusparameeter \"latex_documents\" viitab tundmatule dokumendile %s" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Indeks" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Redaktsioon" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "TeX-i tugifailide kopeerimine" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "TeX-i tugifailide kopeerimine..." #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "lisafailide kopeerimine" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "Katkestatud!" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "Rekursiooni viga:" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "Kui see oli kasutaja viga, siis anna palun sellest teada, et tulevikus oleks võimalik parem veateade väljastada." #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "Vearaportit on võimalik esitada träkkeris aadressil <https://github.com/sphinx-doc/sphinx/issues>. Aitäh!" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "dokumentatsiooni lähtefailide rada" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "väljundkataloogi rada" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "määratud failide uuestiehitamine. Võtme -a korral eiratakse" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "üldsuvandid" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "kasutatav ehitaja (vaikimisi: html)" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "kõikide failide kirjutamine (vaikimisi kirjutatakse ainult uued ja muutunud failid)" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "salvestatud keskkonda ei kasutata, alati loetakse kõik failid" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "puhverdatud keskkonna ja dokumendipuu rada (vaikimisi: OUTPUTDIR/.doctrees)" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "rööbiti ehitamine N protsessiga, kui võimalik (eriväärtus \"auto\" määrab N väärtuseks protsessorite arvu)" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "seadistusfaili (conf.py) asukoha rada (vaikimisi sama mis SOURCEDIR)" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "seadistusfaili ei kasutata üldse, ainult -D suvandid" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "seadistusfailis määratud väärtuse asendamine" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "väärtuse edastamine HTML-mallidesse" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "konsooliväljundi suvandid" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "hoiatuste (ja vigade) kirjutamine määratud faili" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "hoiatuste muutmine vigadeks" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "erindi korral täieliku tagasijälituse näitamine" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "erindi korral Pdb käivitamine" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "faile %r pole võimalik leida" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "suvandit -a ja failinimesid pole võimalik kombineerida" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "hoiatuste faili %r pole võimalik avada: %s" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "-D suvandi argument peab olema vormingus nimi=väärtus" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "-A suvandi argument peab olema vormingus nimi=väärtus" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "moodulite dokumentatsioonistringide automaatne lisamine" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "dokumentatsioonistringides olevate koodijuppide automaattestimine" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "eri projektide Sphinx-dokumentatsiooni omavaheline viitamine" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "\"teha\" sissekannete kirjutamine, mida võib ehitamisega peita või näidata" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "dokumentatsiooni katvuse kontrollid" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "matemaatika kaasamine, mis renderdatakse PNG- või SVG-kujutisteks" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "matemaatika kaasamine, mis renderdatakse veebisirvikus MathJax-i abil" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "sisu tingimuslik kaasamine seadistusparameetrite alusel" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "dokumenteeritud Python-objektide lähtekoodile viitamise kaasamine" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr ".nojekyll faili loomine dokumentide avaldamiseks GitHub-i lehtedel" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "Palun sisesta mingi tekst." #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "Palun sisesta kas 'y' või 'n'." #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "Tere tulemast kasutama Sphinx %s lendstardi utiliiti." #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "Palun sisesta väärtused järgnevate sätete jaoks (kandiliste sulgude vahel\nvõib olla vaikeväärtus, millega nõustumiseks vajuta lihtsalt Enter)." #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "Valitud juurkataloog: %s" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "Viga: valitud juurkataloogist leiti olemasolev conf.py." #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "sphinx-quickstart ei kirjuta olemasolevaid Sphinx-projekte üle." #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "Palun sisesta uus juurkataloog (või vajuta Enter lõpetamiseks)" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "Sphinx'i väljundi ehitamise kataloogi asetamiseks on kaks valikut.\nVõid kasutada kataloogi \"_build\" juurkataloogis või eraldiseisvaid \n\"source\" ja \"build\" katalooge juurkataloogis." #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "Lähtekoodi ja ehitamise kataloogide eraldamine (y/n)" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "Mallide ja staatilise kataloogi nime eesliide" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "Projekti nimi" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "Autorite nimed" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "Projekti versioon" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "Projekti väljalase" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "Projekti keel" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "Lähtefaili järelliide" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "Sinu põhidokumendi nimi (ilma järelliiteta)" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "Viga: valitud juurkataloogist leiti peafail %s." #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "sphinx-quickstart ei kirjuta olemasolevat faili üle." #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "Palun sisesta uus failinimi või nimeta olemasolev fail ümber ja vajuta Enter" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "Märkus: imgmath ja mathjax ei saa korraga lubatud olla. imgmath eemaldati valikust." #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "Kas luua Makefile? (y/n)" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "Kas luua Windowsi käsufail? (y/n)" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "Faili %s loomine." #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "Fail %s on juba olemas ja jäetakse vahele." #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "Lõpetamine: Algne kataloogistruktuur on loodud." #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "Sa peaks nüüd asustama oma peafaili %s ja looma ülejäänud dokumentatsiooni\nlähtefailid. " #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "Dokumentide ehitamiseks kasuta Makefile, näiteks:\n make ehitaja" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "Dokumentide ehitamiseks kasuta käsku sphinx-build, näiteks:\n sphinx-build -b builder %s %s" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "kus \"ehitaja\" on üks toetatud ehitajatest, nt. html, latex või linkcheck." #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "\nSphinx-projekti jaoks vajalike failide genereerimine.\n\nsphinx-quickstart on interaktiivne tööriist, mis küsib mõned küsimused Sinu\nprojekti kohta ja seepeale genereerib täieliku dokumentatsioonikataloogi ning\nnäidis-Makefile kasutamiseks koos sphinx-buildiga.\n" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "vaikne režiim" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "Struktuuri suvandid" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "kasutamise korral eraldatakse lähtefailide ja ehitamise kataloogid" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "Projekti põhisuvandid" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "projekti nimi" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "autorite nimed" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "projekti versioon" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "projekti väljalase" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "dokumendi keel" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "lähtefaili järelliide" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "põhidokumendi nimi" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "Laienduste suvandid" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "laienduse %s lubamine" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "suvaliste laienduste määramine" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "Makefile ja Batchfile loomine" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "makefile loomine" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "makefile loomata jätmine" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "batchfile loomine" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "batchfile loomata jätmine" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "Projekti loomine mallist" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "mallifailide kataloog" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "malli muutuja kirjeldamine" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "Vigane mallimuutuja: %s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "Vigane selgitustekst: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "Suvandeid \"%s\" ja \"%s\" pole võimalik korraga kasutada" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Sektsiooni autor: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Mooduli autor: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Koodi autor: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autor: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parameetrid" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Tagastab" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Tagastustüüp" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "liige" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "muutuja" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funktsioon" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "makro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "loend" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "tüüp" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "funktsiooni parameeter" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Uus versioonis %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Muudetud versioonis %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Iganenud alates versioonist %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Malli parameetrid" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "klass" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (sisseehitatud funktsioon)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s meetod)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (klass)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (globaalmuutuja või konstant)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s atribuut)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumendid" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (moodul)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "meetod" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "andmed" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atribuut" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "moodul" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "võrrandil %s on topeltsilt, teine instants on %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "Vigane math_eqref_format: %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "võtmesõna" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operaator" #: sphinx/domains/python.py:61 msgid "object" msgstr "objekt" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "erind" #: sphinx/domains/python.py:63 msgid "statement" msgstr "lause" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "sisseehitatud funktsioon" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Muutujad" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (moodulis %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (moodulis %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (sisseehitatud muutuja)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (sisseehitatud klass)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (klass moodulis %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (klassi %s meetod)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s staatiline meetod)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Pythoni moodulite indeks" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "moodulid" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Iganenud" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "klassi meetod" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "staatiline meetod" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (iganenud)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (direktiiv)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (roll)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "direktiiv" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "roll" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "keskkonnamuutuja; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "%s käsureasuvand" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "käsureasuvand" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "sõnastiku termin" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "grammatika märk" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "viite silt" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "keskkonnamuutuja" #: sphinx/domains/std.py:568 msgid "program option" msgstr "programmi suvand" #: sphinx/domains/std.py:569 msgid "document" msgstr "dokument" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Mooduli indeks" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Otsinguleht" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "vigane numfig_format: %s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "vigane numfig_format: %s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "See keskkond pole valitud ehitajaga ühilduv, palun vali mõni teine dokumendipuu kataloog." #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "dokument pole ühegi sisukorrapuu osa" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "vaata %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "vaata ka %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Sümbolid" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "kujutise fail pole loetav: %s" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "kujutise fail %s pole loetav: %s" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "laienduse suvandid" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s pole kataloog." #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "Lähtefailide katvustestimine on lõppenud, vaata tulemusi failist %(outdir)spython.txt." #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "vigane TestCode tüüp" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "Lähtefailide doctest-testimine on lõppenud, vaata tulemusi failist %(outdir)s/output.txt." #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "vigase doctest koodi eiramine: %r" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "Graphviz direktiivil ei tohi samaaegselt olla argumendid content ja filename" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "Välist Graphviz-faili %r ei leitud või esines tõrge selle lugemisel" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "Ilma sisuta \"graphviz\" direktiivi eiramine." #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "dot käsku %r pole võimalik käivitada (vajalik graphvizi väljundi jaoks), kontrolli graphviz_dot sätteid" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "graphviz_output_format peab olema kas 'png' või 'svg', kuid mitte %r" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[joonis: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[joonis]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "teisendamise käsku %r pole võimalik käivitada, kontrolli image_converter sätteid: %s" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "teisendamise käsku %r pole võimalik käivitada, kontrolli image_converter sätteid" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Püsiviit sellele võrrandile" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(projektis %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[lähtekood]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Teha" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "Leitud TEHA kirje: %s" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<algne kirje>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(<<algne kirje>> asub failis %s, real %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "algne kirje" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[dokumentatsioon]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Mooduli kood" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>%s lähtekood</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Ülevaade: mooduli kood" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Kõik lähtekoodiga moodulid</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "Põlvnemine: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "tõrge objekti %s importimisel" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[autosummary] automaatkokkuvõtte genereerimine failile: %s" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "[autosummary] kirjutamine kataloogi %s" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "lähtefailid, mille kohta rST-faile genereerida" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "väljundfailide kataloog" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "failide vaikimisi järelliide (vaikimisi: %(default)s)" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "kohandatud mallide kataloog (vaikimisi: %(default)s)" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "imporditud liikmete dokumenteerimine (vaikimisi: %(default)s)" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "Võtmesõnadega argumendid" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "Näide" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Näited" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "Märkused" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Tähelepanu" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Ettevaatust" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Oht" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Viga" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Vihje" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Tähtis" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Märkus" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Vaata ka" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Nõuanne" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Hoiatus" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "jätk eelmisele leheküljele" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "jätkub järgmisel leheküljel" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "lehekülg" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "Sisukorratabel" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Otsing" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Otsi" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Näita lähtekoodi" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Ülevaade" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Tervitused! See on" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "dokumentatsioon projektile" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "viimati uuendatud" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Indeksid ja tabelid:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Täielik sisukorratabel" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "toob välja kõik sektsioonid ja alamsektsioonid" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "otsi sellest dokumentatsioonist" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Globaalne moodulite indeks" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "kiire ligipääs kõigile moodulitele" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "kõik funktsioonid, klassid ja terminid" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Indeks – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Täisindeks ühel lehel" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Indeksi leheküljed algustähe kaupa" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "võib olla väga suur" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigatsioon" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Otsi %(docstitle)s piires" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Info selle dokumentatsiooni kohta" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Autoriõigus" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Autoriõigused</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Autoriõigused %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Viimati uuendatud %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Otsi %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Eelmine teema" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "eelmine jaotis" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Järgmine teema" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "järgmine jaotis" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Otsingu võimaldamiseks tuleb aktiveerida JavaScript." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "otsi" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Otsingu tulemused" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Sinu otsingule ei vastanud ükski dokument. Palun veendu, et kõik sisestatud sõnad on õigesti kirjutatud ja sa oled valinud piisavalt kategooriaid." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Kiirotsing" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Käesolev leht" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Muutused versioonis %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s &8212; %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automaatselt genereeritud nimekiri versiooni %(version)s muutustest" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Teegi muutused" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API muutused" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Ülejäänud muutused" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Püsiviit sellele pealkirjale" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Püsiviit sellele definitsioonile" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Varja otsingu tulemused" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Otsimine" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Otsingu ettevalmistamine..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Otsingu tulemusena leiti %s leht(e)." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Näita külgriba" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Varja külgriba" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Sisukord" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "Tundmatu pildivorming: %s..." #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "viga lugemisel: %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "viga kirjutamisel: %s, %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Püsiviit sellele tabelile" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Püsiviit sellele programmikoodile" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Püsiviit sellele pildile" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Püsiviit sellele sisukorrapuule" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr ":maxdepth: on liiga suur ja seda eiratakse." #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Joonealused märkused" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[pilt: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[pilt]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3256392 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/eu/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015514� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4788017 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/eu/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017301� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/eu/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000006357�00000000000�021163� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "eu", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "Dokumentu hauen inguruan", "Automatically generated list of changes in version %(version)s": "Automatikoki sortutako %(version)s bertsioaren aldaketen zerrenda", "C API changes": "C API aldaketak", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "Alboko barra tolestu", "Complete Table of Contents": "Eduki taula osoa", "Contents": "Edukiak", "Copyright": "Copyright", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Alboko barra luzatu", "Full index on one page": "Indize guztia orri batean", "General Index": "Indize orokorra", "Global Module Index": "Modulu indize globala", "Go": "Joan", "Hide Search Matches": "Bilaketa bat-etortzeak ezkutatu", "Index": "Indizea", "Index – %(key)s": "Indizea – %(key)s", "Index pages by letter": "Indize orriak hizkika", "Indices and tables:": "Indizeak eta taulak:", "Last updated on %(last_updated)s.": "Azken aldaketa: %(last_updated)s.", "Library changes": "Liburutegi aldaketak", "Navigation": "Nabigazioa", "Next topic": "Hurrengo gaia", "Other changes": "Beste aldaketak", "Overview": "Gainbegirada", "Permalink to this definition": "Definizio honetarako esteka iraunkorra", "Permalink to this headline": "Goiburu honetarako esteka iraunkorra", "Please activate JavaScript to enable the search\n functionality.": "Mesedez, gaitu JavaScript-a bilaketa erabili ahal izateko.", "Preparing search...": "", "Previous topic": "Aurreko gaia", "Quick search": "Bilaketa azkarra", "Search": "Bilatu", "Search Page": "Bilaketa orria", "Search Results": "Bilaketa emaitzak", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "Bilatu %(docstitle)s(e)n", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Iturburua ikusi", "Table of Contents": "", "This Page": "Orri hau", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "funtzio, klase, termino guztiak", "can be huge": "handia izan daiteke", "last updated": "", "lists all sections and subsections": "atal eta azpiatal guztiak zerrendatu", "next chapter": "hurrengo kapitulua", "previous chapter": "aurreko kapitulua", "quick access to all modules": "modulu guztietara atzipen azkarra", "search": "bilatu", "search this documentation": "dokumentazio honetan bilatu", "the documentation for": "" }, "plural_expr": "(n != 1)" });���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/eu/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000015177�00000000000�021162� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������4��������������L�� ���M�����[�� ���a�����k�����q������������ ���������� ����� ������������� ����� �� ���1 �����> ��0���R ����� ����� �� ��� �� ��� ����� ��>��� �� ��� ����� �����' �� ���= �����K �����\ �����w �� ��� ����� �� ��� ����� ����� ����� �� ��� ����� �� ��� ����� ����� ����� �����' �� ���, �����6 �����< �����R �����h ��!���| ����� �� ��� ����� �� ��� �� ��� �� ��� ����� �� ��� ����� �� ��� ����� �����( �� ���> �����I �����f ��B��� ����� ��$��� ����� �� ��� ����� ����� �� ���( �����4 �����< �����C �� ���X �����d �����s ����� ����� �� ��� �� ��� ����� ����� ����� �� ��� ����� ����� ����� ����� ����� �� ����� ���!�����-�� ���3�����@�����]�����b�����w�� ���������� ����� ���������������"���������������������������� ������� ��������%�����,�����5�����D�����M�����^�����m��������������������������� ����� ����� ������������������� ����� ���������������������������� ��#��������B�� ���S�� ���`�����j������������ ����������/�������������"�� ���;�����G�����K��A���S������������������������������������� �������� �� �����!��� �����B�����J�� ���^�����j���������������������� ����� �������������������������!���2�����T�����i�����z������� ����� ���������� ��������������� ���������� �����&���$��$���K��:���p�� �����%��������������� ����� ���������� ���.�����;�����B�����W�����f�����x���������������������� ����� ���������� ��������������������� ��������%�� ���E�����O�����c�����j�����z����������������� ������������������������� �����$��������@�� ���G�����Q�����Y�����a�� ���j�����t������� �������������������������!����������������������������9�����B�� ���U�����`�����q�����v��� (deprecated)� (in �%b %d, %Y�%s %s�%s %s documentation�%s (%s attribute)�%s (class in %s)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (class)�%s() (in module %s)�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�C API changes�Caution�Changed in version %s�Code author: �Collapse sidebar�Complete Table of Contents�Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Expand sidebar�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Overview: module code�Parameters�Permalink to this definition�Permalink to this headline�Please activate JavaScript to enable the search functionality.�Previous topic�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Release�Return type�Returns�Search�Search %(docstitle)s�Search Page�Search Results�Search within %(docstitle)s�Section author: �See also�Show Source�This Page�Throws�Tip�Todo�Variables�Warning�[docs]�[image]�[source]�all functions, classes, terms�attribute�can be huge�class�class method�continued from previous page�data�environment variable�environment variable; %s�exception�function�glossary term�grammar token�index�keyword�lists all sections and subsections�macro�member�method�module�modules�next�next chapter�object�operator�original entry�previous�previous chapter�program option�quick access to all modules�reference label�role�search�search this documentation�see %s�see also %s�statement�static method�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: eu Language-Team: Basque (http://www.transifex.com/sphinx-doc/sphinx-1/language/eu/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (zaharkitua)� (hemen: �%Y %b %d�%s %s�%s %s dokumentazioa�%s (%s atributua)�%s (klasea %s-(e)n)�%s (aldagai globala edo konstantea)�%s (%s moduluan)�%s (modulua)�%s (rola)�%s() (%s klaseko metodoa)�%s() (%s metodoa)�%s() (%s metodo estatikoa)�%s() (klasea)�%s() (%s moduluan)�<h1>Kodea eskuragarri duten modulu guztiak</h1>�<h1>%s(r)en iturburu kodea</h1>�Dokumentu hauen inguruan�Argumentuak�Adi�Egilea:�Automatikoki sortutako %(version)s bertsioaren aldaketen zerrenda�C API aldaketak�Kontuz�%s bertsioan aldatuta�Kodearen egilea: �Alboko barra tolestu�Eduki taula osoa�Edukiak�Copyright�Arriskua�Zaharkitua�%s bertsiotik aurrera zaharkituta�Errorea�Alboko barra luzatu�Oin-oharrak�Indize guztia orri batean�Indize orokorra�Modulu indize globala�Joan�Bilaketa bat-etortzeak ezkutatu�Argibidea�Garrantzitsua�Indizea�Indizea – %(key)s�Indize orriak hizkika�Indizeak eta taulak:�Azken aldaketa: %(last_updated)s.�Liburutegi aldaketak�Moduluen indizea�Moduluaren egilea: �Moduluko kodea�Modulu maila�Nabigazioa�Berria %s bertsioan�Hurrengo gaia�Oharra�Beste aldaketak�Gainbegirada�Gainbegirada: moduluko kodea�Parametroak�Definizio honetarako esteka iraunkorra�Goiburu honetarako esteka iraunkorra�Mesedez, gaitu JavaScript-a bilaketa erabili ahal izateko.�Aurreko gaia�Python Hobekuntza Proposamena; PEP %s�Python moduluen indizea�Bilaketa azkarra�Goratzen du�Argitalpena�Itzulketa mota�Itzultzen du�Bilatu�%(docstitle)s bilatu�Bilaketa orria�Bilaketa emaitzak�Bilatu %(docstitle)s(e)n�Atalaren egilea: �Ikusi baita ere�Iturburua ikusi�Orri hau�Jaurtitzen du�Iradokizuna�Egitekoa�Aldagaiak�Kontuz�[dokumentazioa]�[irudia]�[iturburua]�funtzio, klase, termino guztiak�atributua�handia izan daiteke�klasea�klaseko metodoa�aurreko orritik jarraitzen du�datuak�inguruneko aldagaia�inguruneko aldagaia; %s�salbuespena�funtzioa�glosarioko terminoa�gramatikako token-a�indizea�gako-hitza�atal eta azpiatal guztiak zerrendatu�makroa�partaidea�metodoa�modulua�moduluak�hurrengoa�hurrengo kapitulua�objetua�eragiketa�jatorrizko sarrera�aurrekoa�aurreko kapitulua�programako aukera�modulu guztietara atzipen azkarra�erreferentzia etiketa�rola�bilatu�dokumentazio honetan bilatu�%s ikusi�ikusi %s baita ere�sententzia�metodo estatikoa�mota�aldagaia��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/eu/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000245706�00000000000�021170� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Ales Zabala Alava <shagi@gisa-elkartea.org>, 2011 # Asier Iturralde Sarasola <asier.iturralde@gmail.com>, 2018 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Basque (http://www.transifex.com/sphinx-doc/sphinx-1/language/eu/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: eu\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Hobekuntza Proposamena; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Modulu maila" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (hemen: " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%Y %b %d" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Indize orokorra" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "indizea" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "hurrengoa" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "aurrekoa" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s dokumentazioa" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Indizea" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Argitalpena" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Atalaren egilea: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Moduluaren egilea: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Kodearen egilea: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Egilea:" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametroak" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Itzultzen du" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Itzulketa mota" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "partaidea" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "aldagaia" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funtzioa" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "makroa" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "mota" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Berria %s bertsioan" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "%s bertsioan aldatuta" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "%s bertsiotik aurrera zaharkituta" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Jaurtitzen du" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "klasea" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s metodoa)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (klasea)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (aldagai globala edo konstantea)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s atributua)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumentuak" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modulua)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "metodoa" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "datuak" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atributua" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modulua" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "gako-hitza" #: sphinx/domains/python.py:60 msgid "operator" msgstr "eragiketa" #: sphinx/domains/python.py:61 msgid "object" msgstr "objetua" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "salbuespena" #: sphinx/domains/python.py:63 msgid "statement" msgstr "sententzia" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Aldagaiak" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Goratzen du" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (%s moduluan)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (%s moduluan)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (klasea %s-(e)n)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s klaseko metodoa)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s metodo estatikoa)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Python moduluen indizea" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "moduluak" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Zaharkitua" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "klaseko metodoa" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "metodo estatikoa" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (zaharkitua)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (rola)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "rola" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "inguruneko aldagaia; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "glosarioko terminoa" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "gramatikako token-a" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "erreferentzia etiketa" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "inguruneko aldagaia" #: sphinx/domains/std.py:568 msgid "program option" msgstr "programako aukera" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Moduluen indizea" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Bilaketa orria" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "%s ikusi" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "ikusi %s baita ere" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[iturburua]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Egitekoa" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "jatorrizko sarrera" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[dokumentazioa]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Moduluko kodea" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>%s(r)en iturburu kodea</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Gainbegirada: moduluko kodea" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Kodea eskuragarri duten modulu guztiak</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Adi" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Kontuz" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Arriskua" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Errorea" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Argibidea" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Garrantzitsua" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Oharra" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Ikusi baita ere" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Iradokizuna" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Kontuz" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "aurreko orritik jarraitzen du" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Bilatu" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Joan" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Iturburua ikusi" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Gainbegirada" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Indizeak eta taulak:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Eduki taula osoa" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "atal eta azpiatal guztiak zerrendatu" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "dokumentazio honetan bilatu" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Modulu indize globala" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "modulu guztietara atzipen azkarra" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "funtzio, klase, termino guztiak" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Indizea – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Indize guztia orri batean" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Indize orriak hizkika" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "handia izan daiteke" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Nabigazioa" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Bilatu %(docstitle)s(e)n" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Dokumentu hauen inguruan" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Copyright" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Azken aldaketa: %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "%(docstitle)s bilatu" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Aurreko gaia" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "aurreko kapitulua" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Hurrengo gaia" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "hurrengo kapitulua" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Mesedez, gaitu JavaScript-a bilaketa erabili ahal izateko." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "bilatu" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Bilaketa emaitzak" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Bilaketa azkarra" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Orri hau" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automatikoki sortutako %(version)s bertsioaren aldaketen zerrenda" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Liburutegi aldaketak" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API aldaketak" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Beste aldaketak" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Goiburu honetarako esteka iraunkorra" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Definizio honetarako esteka iraunkorra" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Bilaketa bat-etortzeak ezkutatu" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Alboko barra luzatu" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Alboko barra tolestu" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Edukiak" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Oin-oharrak" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[irudia]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ����������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3258255 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fa/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015471� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4796982 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fa/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017256� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fa/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000020203�00000000000�021122� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "fa", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">\u062d\u0642 \u0646\u0634\u0631</a> %(copyright)s.", "© Copyright %(copyright)s.": "© \u062d\u0642 \u0646\u0634\u0631%(copyright)s.", ", in ": "\u060c \u062f\u0631 ", "About these documents": "\u062f\u0631\u0628\u0627\u0631\u0647 \u0627\u06cc\u0646 \u0645\u0633\u062a\u0646\u062f\u0627\u062a", "Automatically generated list of changes in version %(version)s": "\u0644\u06cc\u0633\u062a \u062a\u0648\u0644\u06cc\u062f \u0634\u062f\u0647 \u062e\u0648\u062f\u06a9\u0627\u0631 \u0627\u0632 \u062a\u063a\u06cc\u06cc\u0631\u0627\u062a \u062f\u0631 \u0646\u0633\u062e\u0647 %(version)s", "C API changes": "C API \u062a\u063a\u06cc\u06cc\u0631\u0627\u062a", "Changes in Version %(version)s — %(docstitle)s": "\u062a\u063a\u06cc\u06cc\u0631\u0627\u062a \u062f\u0631 \u0646\u0633\u062e\u0647 %(version)s — %(docstitle)s", "Collapse sidebar": "\u062a\u0627 \u06a9\u0631\u062f\u0646 \u0646\u0648\u0627\u0631 \u06a9\u0646\u0627\u0631\u0647", "Complete Table of Contents": "\u0641\u0647\u0631\u0633\u062a \u06a9\u0627\u0645\u0644 \u0645\u0637\u0627\u0644\u0628", "Contents": "\u0645\u062d\u062a\u0648\u0627 \u0647\u0627", "Copyright": "\u06a9\u067e\u06cc \u0631\u0627\u06cc\u062a", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "\u0627\u06cc\u062c\u0627\u062f \u0634\u062f\u0647 \u0628\u0627<a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.", "Expand sidebar": "\u06af\u0633\u062a\u0631\u0634 \u0646\u0648\u0627\u0631 \u06a9\u0646\u0627\u0631\u0647", "Full index on one page": "\u0641\u0647\u0631\u0633\u062a \u06a9\u0627\u0645\u0644 \u062f\u0631 \u06cc\u06a9 \u0635\u0641\u062d\u0647", "General Index": "\u0641\u0647\u0631\u0633\u062a \u06a9\u0644\u06cc", "Global Module Index": "\u0641\u0647\u0631\u0633\u062a \u06a9\u0644\u06cc \u0645\u0627\u0698\u0648\u0644 \u0647\u0627", "Go": "\u0628\u0631\u0648", "Hide Search Matches": "\u0639\u062f\u0645 \u0646\u0645\u0627\u06cc\u0634 \u0646\u062a\u0627\u06cc\u062c \u06cc\u0627\u0641\u062a \u0634\u062f\u0647", "Index": "\u0641\u0647\u0631\u0633\u062a", "Index – %(key)s": "\u0641\u0647\u0631\u0633\u062a – %(key)s", "Index pages by letter": "\u0641\u0647\u0631\u0633\u062a \u0635\u0641\u062d\u0627\u062a \u0628\u0631 \u0627\u0633\u0627\u0633 \u062d\u0631\u0648\u0641", "Indices and tables:": "\u0627\u06cc\u0646\u062f\u06a9\u0633 \u0647\u0627 \u0648 \u062c\u062f\u0627\u0648\u0644:", "Last updated on %(last_updated)s.": "\u0622\u062e\u0631\u06cc\u0646 \u0628\u0631\u0648\u0632 \u0631\u0633\u0627\u0646\u06cc \u062f\u0631 %(last_updated)s .", "Library changes": "\u062a\u063a\u06cc\u06cc\u0631\u0627\u062a \u06a9\u062a\u0627\u0628\u062e\u0627\u0646\u0647 \u0627\u06cc\u06cc", "Navigation": "\u0646\u0627\u0648\u0628\u0631\u06cc", "Next topic": "\u0645\u0648\u0636\u0648\u0639 \u0628\u0639\u062f\u06cc", "Other changes": "\u062f\u06af\u0631 \u062a\u063a\u06cc\u06cc\u0631\u0627\u062a", "Overview": "\u0628\u0631\u0631\u0633\u06cc \u0627\u062c\u0645\u0627\u0644\u06cc", "Permalink to this definition": "\u067e\u06cc\u0648\u0646\u062f \u062b\u0627\u0628\u062a \u0628\u0647 \u0627\u06cc\u0646 \u062a\u0639\u0631\u06cc\u0641", "Permalink to this headline": "\u067e\u06cc\u0648\u0646\u062f \u062b\u0627\u0628\u062a \u0628\u0647 \u0627\u06cc\u0646 \u0633\u0631 \u0645\u0642\u0627\u0644\u0647", "Please activate JavaScript to enable the search\n functionality.": "\u0644\u0637\u0641\u0627\u064b \u0628\u0631\u0627\u06cc \u0641\u0639\u0651\u0627\u0644 \u06a9\u0631\u062f\u0646 \u06a9\u0627\u0631\u06a9\u0631\u062f \u062c\u0633\u062a\u062c\u0648\n\u062c\u0627\u0648\u0627 \u0627\u0633\u06a9\u0631\u06cc\u067e\u062a \u0631\u0627 \u0641\u0639\u0651\u0627\u0644 \u06a9\u0646\u06cc\u062f.", "Preparing search...": "\u0622\u0645\u0627\u062f\u0647 \u0633\u0627\u0632\u06cc \u062c\u0633\u062a \u0648 \u062c\u0648...", "Previous topic": "\u0645\u0648\u0636\u0648\u0639 \u0642\u0628\u0644\u06cc", "Quick search": "\u062c\u0633\u062a\u062c\u0648 \u0633\u0631\u06cc\u0639", "Search": "\u062c\u0633\u062a\u062c\u0648", "Search Page": "\u0635\u0641\u062d\u0647 \u062c\u0633\u062a\u062c\u0648", "Search Results": "\u0646\u062a\u0627\u06cc\u062c \u062c\u0633\u062a\u062c\u0648", "Search finished, found %s page(s) matching the search query.": "\u062c\u0633\u062a\u062c\u0648 \u067e\u0627\u06cc\u0627\u0646 \u06cc\u0627\u0641\u062a \u0648 %s\u0635\u0641\u062d\u0647 \u0646\u062a\u0627\u06cc\u062c \u0645\u0637\u0627\u0628\u0642 \u062c\u0633\u062a\u0627\u0631 \u067e\u06cc\u062f\u0627 \u0634\u062f\u0646.", "Search within %(docstitle)s": "\u062c\u0633\u062a\u062c\u0648 \u062f\u0631 %(docstitle)s", "Searching": "\u062f\u0631 \u062d\u0627\u0644 \u062c\u0633\u062a \u0648 \u062c\u0648", "Searching for multiple words only shows matches that contain\n all words.": "\u062f\u0631 \u062d\u0627\u0644 \u062c\u0633\u062a\u062c\u0648 \u0628\u0631\u0627\u06cc \u0686\u0646\u062f\u06cc\u0646 \u0648\u0627\u0698\u0647. \u0641\u0642\u0637 \u0648\u0627\u0698\u06af\u0627\u0646\u06cc \u0631\u0627 \u0646\u0634\u0627\u0646 \u0645\u06cc\u200c\u062f\u0647\u062f \u06a9\u0647 \u0634\u0627\u0645\u0644 \u0627\u06cc\u0646 \u0645\u0648\u0627\u0631\u062f \u0628\u0627\u0634\u062f:\n \u0647\u0645\u0647\u200c\u06cc \u06a9\u0644\u0645\u0647\u200c\u0647\u0627.", "Show Source": "\u0646\u0645\u0627\u06cc\u0634 \u0633\u0648\u0631\u0633", "Table of Contents": "\u0641\u0647\u0631\u0633\u062a \u0639\u0646\u0627\u0648\u06cc\u0646", "This Page": "\u0635\u0641\u062d\u0647 \u0641\u0639\u0644\u06cc", "Welcome! This is": "\u062e\u0648\u0634 \u0622\u0645\u062f\u06cc\u062f! \u0627\u06cc\u0646", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "\u062c\u0633\u062a\u062c\u0648\u06cc \u0634\u0645\u0627 \u0628\u0627 \u0647\u06cc\u0686 \u0633\u0646\u062f\u06cc \u0647\u0645 \u062e\u0648\u0627\u0646\u06cc \u0646\u062f\u0627\u0634\u062a. \u0644\u0637\u0641\u0627\u064b \u0627\u0637\u0645\u06cc\u0646\u0627\u0646 \u062d\u0627\u0635\u0644 \u06a9\u0646\u06cc\u062f \u06a9\u0647 \u0647\u0645\u0647 \u06cc \u0648\u0627\u0698\u0647 \u0647\u0627 \u0627\u0645\u0644\u0627\u06cc \u062f\u0631\u0633\u062a\u06cc \u062f\u0627\u0631\u0646\u062f \u0648 \u062f\u0633\u062a\u0647 \u0628\u0646\u062f\u06cc \u0647\u0627\u06cc \u06a9\u0627\u0641\u06cc \u0631\u0627 \u0627\u0646\u062a\u062e\u0627\u0628 \u06a9\u0631\u062f\u0647 \u0627\u06cc\u062f.", "all functions, classes, terms": "\u062a\u0645\u0627\u0645\u06cc \u062a\u0648\u0627\u0628\u0639 \u060c \u06a9\u0644\u0627\u0633 \u0647\u0627 \u060c \u0627\u0635\u0637\u0644\u0627\u062d\u0627\u062a", "can be huge": "\u0645\u0645\u06a9\u0646 \u0627\u0633\u062a \u0633\u062a\u0631\u06af \u0628\u0627\u0634\u062f", "last updated": "\u0622\u062e\u0631\u06cc\u0646 \u0628\u0631\u0648\u0632\u0631\u0633\u0627\u0646\u06cc", "lists all sections and subsections": "\u0641\u0647\u0631\u0633\u062a \u062a\u0645\u0627\u0645\u06cc \u0628\u062e\u0634 \u0647\u0627 \u0648 \u0632\u06cc\u0631 \u0645\u062c\u0645\u0648\u0639\u0647 \u0647\u0627", "next chapter": "\u0641\u0635\u0644 \u0628\u0639\u062f\u06cc", "previous chapter": "\u0641\u0635\u0644 \u0642\u0628\u0644\u06cc", "quick access to all modules": "\u062f\u0633\u062a\u0631\u0633\u06cc \u0633\u0631\u06cc\u0639 \u0628\u0647 \u062a\u0645\u0627\u0645\u06cc \u0645\u062a\u062f\u0647\u0627", "search": "\u062c\u0633\u062a\u062c\u0648", "search this documentation": "\u062c\u0633\u062a\u062c\u0648 \u062f\u0631 \u0627\u06cc\u0646 \u0627\u0633\u0646\u0627\u062f", "the documentation for": "\u0645\u0633\u062a\u0646\u062f\u0627\u062a \u0628\u0631\u0627\u06cc" }, "plural_expr": "(n > 1)" });���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fa/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000306710�00000000000�021133� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������T��������������.����.����0�����2��E��3��r���4��l���K5�� ���5�����5��*���5�����5��=���6��7���6��H���6��?���E7��"���7�� ���7�����7��%���7�����7�����7��!���8�����@8�����F8�����Z8�����l8�� ���}8�� ���8�����8�����8�����8�����8�� ���8�����8�� ���9�� ���9�� ���'9��S���H9�����9��A���9�����9����� :�����#:�����4:�����L:�� ���e:�����r:��$���:��6���:�����:�����;��$���;�����C;��3���;�� ���1<�����=<�����E<��1���K<��1���}<��G���<�����<�����=��0���"=�����S=��H���o=�����=��b���P>��;���>�����>�����?��6���%?�����\?�� ���r?�� ���?�� ���?�����?�����?��>���?�� ���?��(���@��(���1@�����Z@��?���y@�����@�� ���@��!���@��8���@��%���+A�����QA�����YA��4���oA�� ���A�� ���A�����A�����A�����A�����B�� ���(B��N���2B��%���B��%���B�����B��:���B��7���&C�����^C��"���uC��R���C�����C�����C�� ���D�����D�����+D��N���GD��R���D��`���D�����JE��&���ZE�����E��D���E��H���E��K���F�����aF�����zF�����F��5���F�����F�����F�����F��8���F��=���/G��1���mG��D���G��B���G��0���'H��-���XH��+���H��3���H��'���H��"���I��3���1I��"���eI��:���I��#���I�����I��!���I��:���J�����LJ�� ���lJ�� ���J��:���J�����J�����sK�� ���K�����K�����K��C���K��*���K�����L�����2L��3��7L��.���kM�� ���M��.���M�����M�����M�����M��D���N�����JN�����^N�� ���IO��'���VO�����~O��[���O�����O����� P�����*P��Y���<P��!���P�����P��2���P�� ���P��C���Q�����JQ��n���jQ��E���Q�� ���R�����,R�� ���<R�� ���HR��-���UR��(���R�� ���R�����R�� ���R��(���R�����R�����S�����'S��Z���,S�����S�����S��,���S����S�����T�����T�� ���T��(��� U�����6U�����?U�� ���UU�����`U�����wU�����U�����U�����U�����U�����U�����V��&���+V��B���RV��i���V��2���V��I���2W��4���|W�����W�����W�����W����� X��y���!X�����X�����X�����X�����X�� ���X�����X�����Y�����Y��#���%Y��$���IY�����nY�� ���Y�����Y�����Y�����Y�� ���Y�����Y�� ���Y�����Y�����Y�����Y����� Z�����Z�� ���&Z�����2Z��<���AZ�����~Z�� ���Z��K���Z�� ���Z�����Z����� [�����[��+���,[�� ���X[��k���d[��>���[�����\��#���"\��-��F\�����t]�����]�����]�����]�����]�����]��Y���]��Z���,^��*���^��3���^��/���^��(���_��.���?_��P���n_��p���_�����0`��!���P`��"���r`��$���`�� ���`��e���`��Z���Aa��N���a��T���a��K���@b��%���b�����b�����b��[���Zc��#���c��'���c��#���d��I���&d��'���pd��!���d��=���d��7���d�� ���0e�����:e��d���e��W���:f��v���f����� g�����g�����g�� ���g��3���:g�����ng�����g��"���g��7���g��<���g��Y���9h�� ���h�����h�����h��,���h�����h�����h�����h�����i��Y���i�����*j��%���j��,���j�����k�����$k�� ���+k�����7k�� ���?k�����Kk�����Sk��N���\k�����k��?���7l��-���wl��2���l�� ���l�����l�����l�����m�����*m��9���;m�����um�� ���m�� ���m��X���m��d����n��,���en��2���n��b���n��5���(o��\���^o�� ���o��M���o��(���*p��G���Sp�����p��7���p�����p��8���p�����7q�� ���Nq��%���Xq��`���~q�����q�����q�����r�����,r�����<r�� ���Nr��&���Zr��$���r�����r�����r�����r�����r�����s��A���.s��Z���ps��-���s�����s�����t�����5t��!���Jt��8���lt�����t�� ���t�����t�����t��7���t��6��� u��;���Cu��I���u��;���u��:���v��H���@v��9���v��G���v��2��� w��2���>w�����qw��4���w�����w�����w�����w��C����x��G���Dx��2���x�����x�����x�����x�����y�����-y�����Ly�����`y�����sy�����y��(���y��=���y�����z�����z��0���(z�����Yz�����^z��/���xz�����z��*���z��&���z�� ���{��9���{�����Y{�����j{�� ���{�����{��-���{�����{�����|��1���|��*���M|�����x|�����|��0���|��&���|�����|�����}��(���!}�����J}�����Z}�����w}��%���}��e���}����� ~��4���~�����~�����~��Y��� ��;���f��.������������������ ��.���$��4���S��+�����4�����(�����4�����W���G���������������ҁ��X�����J���G�������%����� ��������Ȃ�����݂��+�����+���"�����N�����h�� �����8�����M���˃��u����������������������������ք��A����� ���0�����;��6���Z��I�����A���ۅ�������0���8�����i��G�����N���Ȇ���������� �����3��.���C�����r��4����� �����,���ȇ��3����� ���)��=���7�����u��r�����'�����0���-��(���^��1�����/�����,�����!��������8�����W�����s��=�����+���̊��0�����V���)��V�����M���׋��R���%��$���x������������N�����0�����)���7�����a�����w�������/��������������������&���2��!���Y��+���{��)�����-���ю��-�����&���-�����T��E���\�� �����*�����7���ڏ��"�����(���5�����^�����z������������"���Ґ������������4�����4���H�����}��&�����;���������������"�����!���&��H���H�������#����������D���Ē��5��� ��D���?�� ���������� �����1�����E���ӓ��B�����G���\��%��������ʔ��#�����#�����,���,�����Y��-���u��(�����D���̕��!����� ���3��#���>��(���b��#��������������������(���Ζ������������8����� ���N��P���o��"���������������O��������g�����|������������%����� ���И�����ޘ��,����� �����(���'��E���P�� �����*��������Ι��1���י��7��� �����A�� ���]�����h�����{��������������������˚��&���ޚ������������4���"�����W��%���l�������c��������������� �����'���*��:���R�� �����@��������������������&���'��*���N��&���y��W�����>�����7���7��K���o�� ����� ���Ş�����Ӟ�� ���ڞ��,�����*�����0���<�����m��%�������������ğ�����\��1�����1���&�����X��\���n�����ˡ��'�����%�����+���5��^���a��2�����5��������)�����H�����b��5���g�������&�����#���أ��&�����*���#�����N�����j��+���p��-�����%���ʤ�������!��� ��!���.�����P��!���f������������#�����*���̥������������������P���*�����{��)�����9���Ħ��;�����)���:�����d�����l��&������������������ا���������� �����'�����@�����Z�����m�����������C��b��������1��������������`�� ��������,��B���4��-��w����������'����������+��"����� ���߼�������F�����(���O��,���x��)��������Ͻ�����ս������������ ��� �� ��������#�����<�����W�����m��5�������������վ�� �����:��������,��"���ƿ�������������������������������� ��� �����.��*���H��8���s�� �����.�����T�����K��Q��@����� ����� ����������i������i���j�������)����������]�����#���0��T���T��>������������x��+�����"���.��E���Q�������[�������������$�����+�����H��U���Y�������R�����S�����-���g��x�������������"��+���7�����c��:����� ���L��+���Y��>�����0����������!��������0��<���O�����������������P���>��P�����:���������������:���L��Q�����Z����� ���4�����U�����\��"���n�� �����e�����i����������#�����=����������r��������]��o�����6���X������������K��������������� ���-�����N��`�����O���=��d�����f�����l���Y��\�����\���#��^�����>�����J�����^���i��,�����[�����H���Q�� �����J�����H�����5���8��6���n�������S����� �� ��&��������?��!���Q�����s�����z��B�����,���A�����n������N����������k����� ���Q�����\��,���w��p����� �������6�� �����L�������������1��X�����,���V������������6���G��&���~��{����� ���!�����/�� ����������~���r�������"��� �����/�����?��3���V������� �������������8��r���M��<������������������������������?����������������������%��!���;�����]��(���u�������$�����*�����,�����/���.��*���^��(�����,�����:�����[�����q���v�������P����������s�����?�����.���F��-���u��&����������%����������)��������%�����9�����K�����c�� �����A�����$�����,��������5�����I�����\�����p�� ����� ���������������%�����'����� �������� �����9�����M��^���c���������������������������&�����=�����O���:�����������P�����%�����A���+����m�� ���e�� �����0����� �������������������������C����G���X�;����K����9���(����b�����%����'����=����O���N�;����������������u��������O����<������#����* �/��� �;��� �F���8 �_��� �?��� �@��� �r���` �W��� ����+ �*��= ����h ���� ����� ���`����k����t�=����g����+���1�+���]�J����k����n���@��������H� ���X����c�F���r�����(��������k�� ����w����;�G���2�S���z�1��������� ���� �������+� ���:� ���G����R��������I����N�������?�)���V�:����'����*������������ ���������������K����i�������U�z���"�����A��� ����b �D���!�o���]!����!�^���!����J"�^���g"����"� ���"�6���"����'#�?���#�D���:$����$�!���$����$�!���$�Y���$�]���C%�S���%�H���%�L���>&�,���&�B���&����&����'�d���9(�I���(�$���(���� )�'���!)����I)����)� ���)�����*� ���*�N���(*����w*����&+����+����,����I-����-����.����m/����0����0�)���1�N���1�7���"2�$���Z2�$���2�w���2�v���3�J���3�A���3�D��� 4�S���e4�?���4�A���4�?���;5�.���{5�3���5�0���5�R���6�_���b6����6�4���6�F��� 7����S7�)���\7�T���7� ���7�Y���7�L���V8����8�h���8�$���!9�J���F9�T���9����9�U���:� ���X:�@���y:�W���:�_���;�-���r;����;�O���;�X���;����P<�D���`<�/���<�!���<�)���<�-���!=�>���O=����=�"��E>�k���h?����?����?����?�^���@�D����A�=���EA�'���A�4���A�R���A�M���3B�M���B�P���B�I��� C�^���jC����C�C���`D�%���D�:���D����E�~���E� ���$F�O���/F����F����F� ���F�<���F�6���G�(���;G�>���dG� ���G�W���G����H����H����I�)���I����I�)���I�-���J�^���HJ����J�G���J�|���K����K����L�-���L�T���L�$���AM�w���fM�~���M����]N����fN����N�Y���N����N����O� ���O�Q���O�`���)P����P�m���P�+���Q����?Q�E���R�e���^R�D���R�d��� S�p���nS�s���S�;���ST�5���T�4���T�B���T�Z���=U�k���U�g���V����lV�{���V�n���nW�}���W�O���[X� ���X� ���X�w���X�`���OY�Y���Y���� Z�M���*Z�L���xZ�l���Z�3���2[�7���f[�8���[����[�/���Z\�e���\�Y���\�T���J]�T���]�=���]����2^����F^����^�V���^�I���B_�=���_�A���_�&��� `�)���3`�/���]`�/���`�I���`� ���a�&���a�\���9a�\���a����a�8��� b�|���Cb����b����b�4���b�+���c�h���/c� ���c�>���c����c�l���c�M���_d�{���d����)e����Ce����Le�g���\e����e����_f����g�G���g�.���g�9���!h�@���[h����h�1���<i�f���ni�\���i����2j�_���j����-k�>���Fk�p���k�6���k����-l� ���4l����?l�U���Ql�1���l����l�y���l�8���\m�v���m�-��� n�!���:n�1���\n����n�'���o����Bo����ao����jo�V���zo����o����o�|��� p����p�J���p����p����q�s���q� ���2r�N���=r�w���r�0���s����5s�C���Gs����s� ���s� ���s����s����t�D���t����^t����xt�d���t����t�8���u� ���<u����Gu�!���v����&v����;v����Uv�l���v�6���Bw����yw�*���x�&���,x�%���Sx�L���yx�M���x�=���y����Ry����y����z���� {� ���{����{� ���{�"���{�Z���|�H���w|�`���|�3���!}�>���U}����}���}���~�B����C���$����h�����-����?���L�/����j�������'�r����N���+�I���z�)���ă�����Z����#���R�`���v�@���ׄ�9����F���R�!���� ����P���ȅ�^����?���x�.����;����I���#�'���m�L����!��������X����b���q� ���Ԉ� ����9�������<�4���ʼn�L�������G����؊�P���k�����"���Ӌ�1����+���(� ���T�+���u�����+����5����)���� ���I�*���j�2����� Generate ReStructuredText using autosummary directives. sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates the reStructuredText files from the autosummary directives contained in the given input files. The format of the autosummary directive is documented in the ``sphinx.ext.autosummary`` Python module and can be read using:: pydoc sphinx.ext.autosummary � Generate documentation from source files. sphinx-build generates documentation from the files in SOURCEDIR and places it in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration settings. The 'sphinx-quickstart' tool may be used to generate template files, including 'conf.py' sphinx-build can create documentation in different formats. A format is selected by specifying the builder name on the command line; it defaults to HTML. Builders can also perform other tasks related to documentation processing. By default, everything that is outdated is built. Output only for selected files can be built by specifying individual filenames. � Generate required files for a Sphinx project. sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build. � Look recursively in <MODULE_PATH> for Python modules and packages and create one reST file with automodule directives per package in the <OUTPUT_PATH>. The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be excluded from generation. Note: By default this script will not overwrite already created files.� Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� Run 'make' in that directory to run these through makeinfo (use 'make info' here to do that automatically).� (deprecated)� (in �"::" in automodule name doesn't make sense�":file:" option for csv-table directive now recognizes an absolute path as a relative path from source directory. Please update your document.�"latex_documents" config value references unknown document %s�"man_pages" config value references unknown document %s�"quiet" is specified, but any of "project" or "author" is not specified.�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%r doesn't have "%s" setting�%r doesn't have "theme" setting�%r reference target not found: %s�%s %s�%s %s documentation�%s (%s attribute)�%s (%s property)�%s (C %s)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command %r cannot be run (needed for math display), check the imgmath_%s setting�%s command line option�%s is already assigned section numbers (nested numbered toctree?)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�%s:%s reference target not found: %s�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �-A option argument must be in the form name=value�-D option argument must be in the form name=value�4 column based index found. It might be a bug of extensions you use: %r�:%s: (directive option)�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�====================== slowest reading durations =======================�A Makefile and a Windows command file can be generated for you so that you only have to run e.g. `make html' instead of invoking sphinx-build directly.�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�A captioned autosummary requires :toctree: option. ignored.�A mocked object is detected: %r�About these documents�An error happened in rendering the page %s. Reason: %r�Anchor '%s' not found�Any IDs not assigned for %s node�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not determine the fallback text for the cross-reference. Might be a bug.�Could not fetch remote image: %s [%d]�Could not fetch remote image: %s [%s]�Could not import extension %s�Could not lex literal_block as "%s". Highlighting skipped.�Could not obtain image size. :scale: option is ignored.�Create Makefile? (y/n)�Create Windows command file? (y/n)�Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> %(sphinx_version)s.�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Duplicate C declaration, also defined at %s:%s. Declaration is '.. c:%s:: %s'.�Duplicate C++ declaration, also defined at %s:%s. Declaration is '.. cpp:%s:: %s'.�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Encoding error:�Enter the root path for documentation.�Error�Error: an existing conf.py has been found in the selected root path.�Error: specified path is not a directory, or sphinx files already exist.�Error: the master file %s has already been found in the selected root path.�Event %r already present�Example�Examples�Exception occurred while building, starting debugger:�Exception occurred:�Expand sidebar�Extension options�External Graphviz file %r not found or reading it failed�Failed to compile regex in linkcheck_allowed_redirects: %r %s�Failed to copy a file in html_static_file: %s: %r�Failed to create a cross reference. A title or caption not found: %s�Failed to create a cross reference. Any number is not assigned: %s�Failed to get a constructor signature for %s: %s�Failed to get a function signature for %s: %s�Failed to get a method signature for %s: %s�Failed to parse a default argument value for %r: %s�Failed to parse type_comment for %r: %s�Failed to read build info file: %r�Failed to read intersphinx_mapping[%s], ignored: %r�Failed to scan documents in %s: %r�Failed to update signature for %r: parameter not found: %s�Failed to write build info file: %r�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnote [#] is not referenced.�Footnote [%s] is not referenced.�Footnotes�For more information, visit <https://www.sphinx-doc.org/>.�For security reasons, parallel mode is disabled on macOS and python3.8 and above. For more details, please read https://github.com/sphinx-doc/sphinx/issues/6803�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Handler %r for event %r threw an exception�Hide Search Matches�Hint�If the documents are to be written in a language other than English, you can select a language here by its language code. Sphinx will then translate text that it generates into that language. For a list of supported codes, see https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indicate which of the following Sphinx extensions should be enabled:�Indices and tables:�Inside the root directory, two more directories will be created; "_templates" for custom HTML templates and "_static" for custom stylesheets and other static files. You can enter another prefix (such as ".") to replace the underscore.�Interrupted!�Invalid __slots__ found on %s. Ignored.�Invalid caption: %s�Invalid date format. Quote the string by single quote if you want to output it directly: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�Keyword Arguments�LaTeX command %r cannot be run (needed for math display), check the imgmath_latex setting�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Look for any errors in the above output or in %(outdir)s/output.txt�Makefile and Batchfile creation�Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Many math_renderers are registered. But no math_renderer is selected.�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Non-alphabetical�Note�Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.�Notes�Numbers�Object named %r not found in include file %r�One document is special in that it is considered the top node of the "contents tree", that is, it is the root of the hierarchical structure of the documents. Normally, this is "index", but if your "index" document is a custom template, you can also set this to another filename.�Original exception: �Other Parameters�Other changes�Output directory (%s) is not a directory�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this term�Permalink to this toctree�Pillow not found - copying image files�Please activate JavaScript to enable the search functionality.�Please also report this if it was a user error, so that a better error message can be provided next time.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter a new file name, or rename the existing file and press Enter�Please enter a new root path (or just Enter to exit)�Please enter a valid path name.�Please enter either 'y' or 'n'.�Please enter one of %s.�Please enter some text.�Please enter values for the following settings (just press Enter to accept a default value, if one is given in brackets).�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project templating�Project version�Pygments lexer name %r is not known�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Receives�Recursion error:�References�Release�Return type�Returns�Root path for the documentation�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Searching for multiple words only shows matches that contain all words.�Section %s�Section author: �See also�Selected root path: %s�Separate source and build directories (y/n)�Show Source�Since v2.0, Sphinx uses "index" as root_doc by default. Please add "root_doc = 'contents'" to your conf.py.�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Sphinx has the notion of a "version" and a "release" for the software. Each version can have multiple releases. For example, for Python the version is something like 2.5 or 3.0, while the release is something like 2.5.1 or 3.0a1. If you don't need this dual structure, just set both to the same value.�Structure options�Symbols�TODO entry found: %s�Table %s�Table of Contents�Template Parameters�Testing of coverage in the sources finished, look at the results in %(outdir)spython.txt.�Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt.�The %r crossref_type is already registered�The %r directive is already registered to domain %s�The %r index is already registered to domain %s�The %r object_type is already registered�The %r role is already registered to domain %s�The %s extension is required by needs_extensions settings, but it is not loaded.�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.�The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.�The config value `{name}' has type `{current.__name__}'; expected {permitted}.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The dummy builder generates no files.�The ePub file is in %(outdir)s.�The file name suffix for source files. Commonly, this is either ".txt" or ".rst". Only files with this suffix are considered documents.�The full traceback has been saved in %s, if you want to report the issue to the developers.�The manual pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�The overview file is in %(outdir)s.�The project name will occur in several places in the built documentation.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This can happen with very large or deeply nested source files. You can carefully increase the default Python recursion limit of 1000 in conf.py with e.g.:�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Translator for %r already exists�Unknown configure key: latex_elements[%r], ignored.�Unknown event name: %s�Unknown image format: %s...�Unknown math_renderer %r is given.�Unknown theme option: latex_theme_options[%r], ignored.�Use the Makefile to build the docs, like so: make builder�Use the sphinx-build command to build the docs, like so: sphinx-build -b builder %s %s�Variables�Warning�Warns�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�Would create file %s.�Yields�You have two options for placing the build directory for Sphinx output. Either, you use a directory "_build" within the root path, or you separate "source" and "build" directories within the root path.�You should now populate your master file %s and create other documentation source files. �Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[autosummary] failed to import %r: %s�[autosummary] generating autosummary for: %s�[autosummary] writing to %s�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.�a list of specific files to rebuild. Ignored if -a is specified�a suitable image for %s builder not found: %s�a suitable image for %s builder not found: %s (%s)�alias of %s�alias of TypeVar(%s)�all functions, classes, terms�all of %d po files�all source files�append module_path to sys.path, used when --full is given�assembling single document�attribute�author names�autodoc: failed to determine %r to be documented, the following exception was raised: %s�autodoc_member_order now accepts "alphabetical" instead of "alphabetic". Please update your setting.�automatically insert docstrings from modules�automatically test code snippets in doctest blocks�autosummary generats .rst files internally. But your source_suffix does not contain .rst. Skipped.�autosummary references excluded document %r. Ignored.�autosummary: failed to determine %r to be documented, the following exception was raised: %s�autosummary: failed to import %s�autosummary: stub file not found %r. Check your autosummary_generate setting.�autosummary_generate: file not found: %s�both tabularcolumns and :widths: option are given. :widths: is ignored.�broken link: %s (%s)�build %s, %s warning (with warnings treated as errors).�build %s, %s warning.�build %s, %s warnings (with warnings treated as errors).�build %s, %s warnings.�build %s.�build environment version not current�build in parallel with N processes where possible (special value "auto" will set N to cpu-count)�build info file is broken: %r�builder to use (default: html)�building [%s]: �building [mo]: �built-in function�can be huge�cannot combine -a option and filenames�cannot copy downloadable file %r: %s�cannot copy extra file %r�cannot copy image file %r: %s�cannot copy static file %r�cannot find files %r�cannot open warning file %r: %s�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�cannot read image file %r: copying it instead�cannot write image file %r: %s�caption not inside a figure.�checking consistency�checks for documentation coverage�circular toctree references detected, ignoring: %s <- %s�class�class method�command line option�concept�conditional inclusion of content based on config values�conf value "epub_author" should not be empty for EPUB3�conf value "epub_contributor" should not be empty for EPUB3�conf value "epub_copyright" (or "copyright")should not be empty for EPUB3�conf value "epub_description" should not be empty for EPUB3�conf value "epub_identifier" should not be empty for EPUB3�conf value "epub_language" (or "language") should not be empty for EPUB3�conf value "epub_publisher" should not be empty for EPUB3�conf value "epub_title" (or "html_title") should not be empty for EPUB3�conf value "epub_uid" should be XML NAME for EPUB3�conf value "version" should not be empty for EPUB3�config changed�config directory doesn't contain a conf.py file (%s)�console output options�continued from previous page�continues on next page�convert command %r cannot be run, check the image_converter setting�convert command %r cannot be run, check the image_converter setting: %s�convert exited with error: [stderr] %r [stdout] %r�copying TeX support files�copying TeX support files...�copying Texinfo support files�copying additional files�copying downloadable files... �copying extra files�copying images... �copying source files...�copying static files�could not read %r for changelog creation�create .nojekyll file to publish the document on GitHub pages�create batchfile�create makefile�custom template directory (default: %(default)s)�data�default role %s not found�default suffix for files (default: %(default)s)�define a template variable�define tag: include "only" blocks with TAG�dimension unit %s is invalid. Ignored.�directive�directive %r is already registered, it will be overridden�directive-option�directory to place all output�directory to place all output in�display latex %r: %s�do emit colored output (default: auto-detect)�do not create batchfile�do not create makefile�do not emit colored output (default: auto-detect)�do not use make-mode for Makefile/make.bat�docnames to write: %s�document�document imported members (default: %(default)s)�document isn't included in any toctree�document language�document not readable. Ignored.�document title is not a single Text node�doing serial %s�domain %s already registered�domain %s not yet registered�don't create a table of contents file�don't create headings for the module/package packages (e.g. when the docstrings already contain them)�don't know which module to import for autodocumenting %r (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)�don't use a saved environment, always read all files�done�dot code %r: %s�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�dot did not produce an output file: [stderr] %r [stdout] %r�dot exited with error: [stderr] %r [stdout] %r�download file not readable: %s�dumping object inventory�dumping search index in %s�duplicate %s description of %s, other %s in %s�duplicate %s description of %s, other instance in %s�duplicate citation %s, other instance in %s�duplicate description of %s %s, other instance in %s�duplicate label %s, other instance in %s�duplicate label of equation %s, other instance in %s�duplicate object description of %s, other instance in %s, use :noindex: for one of them�duplicated ToC entry found: %s�enable %s extension�enable arbitrary extensions�encountered some issues with some of the inventories, but they had working alternatives:�encountered title node not in section, topic, table, admonition or sidebar�enum�enumerable_node %r already registered�enumerator�environment variable�environment variable; %s�error while formatting arguments for %s: %s�error while formatting signature for %s: %s�error writing file %s: %s�error writing file Makefile: %s�exception�exception while evaluating only directive expression: %s�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extension options�extensions changed�failed�failed to import object %s�failed to parse name %s�failed to reach any of the inventories with the following issues:�failed: %s�favicon file %r does not exist�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�filename of table of contents (default: modules)�finished with problems�fnmatch-style file and/or directory patterns to exclude from generation�follow symbolic links. Powerful when combined with collective.recipe.omelette.�function�function parameter�general options�generate a full project with sphinx-quickstart�generating indices�glossary seems to be misformatted, check indentation�glossary term�glossary term must be preceded by empty line�glossary terms must not be separated by empty lines�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�highlighting module code... �html_add_permalinks has been deprecated since v3.5.0. Please use html_permalinks and html_permalinks_icon instead.�html_extra_path entry %r does not exist�html_extra_path entry %r is placed inside outdir�html_static_path entry %r does not exist�html_static_path entry %r is placed inside outdir�if specified, create build dir under source dir�if specified, separate source and build dirs�ignoring invalid doctest code: %r�image file %s not readable: %s�image file not readable: %s�include "_private" modules�include links to the source code of documented Python objects�include math, rendered as PNG or SVG images�include math, rendered in the browser by MathJax�inconsistent citation references in translated message. original: {0}, translated: {1}�inconsistent footnote references in translated message. original: {0}, translated: {1}�inconsistent references in translated message. original: {0}, translated: {1}�inconsistent term references in translated message. original: {0}, translated: {1}�increase verbosity (can be repeated)�index�inline latex %r: %s�interpret module paths according to PEP-0420 implicit namespaces specification�intersphinx identifier %r is not string. Ignored�intersphinx inventory has moved: %s -> %s�invalid TestCode type�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�invalid regex %r in %s�invalid regex %r in coverage_c_regexes�invalid signature for auto%s (%r)�invalid value for class-doc-from option: %s�invalid value for member-order option: %s�invalid value set (missing closing brace): %s�invalid value set (missing opening brace): %s�job number should be a positive number�keyword�kwargs for add_node() must be a (visit, depart) function tuple: %r=%r�last updated�line number spec is out of range(1-%d): %r�link between Sphinx documentation of different projects�lists all sections and subsections�loading intersphinx inventory from %s...�loading pickled environment�loading translations [%s]... �locale_dir %s does not exists�logo file %r does not exist�looking for now-outdated files... �macro�making output directory�malformed string literal (missing closing quote): %s�malformed string literal (missing opening quote): %s�master document name�math renderer %s is already registered�maximum depth of submodules to show in the TOC (default: 4)�member�method�missing '+' or '-' in '%s' option.�missing attribute %s in object %s�missing attribute mentioned in :members: option: module %s, attribute %s�module�module %s could not be imported: %s�modules�more than one target found for 'any' cross-reference %r: could be %s�more than one target found for cross-reference %r: %s�multiple files found for the document "%s": %r Use %r for the build.�new config�next�next chapter�nit-picky mode, warn about all missing references�no "latex_documents" config value found; no documents will be written�no "man_pages" config value found; no manual pages will be written�no "texinfo_documents" config value found; no documents will be written�no Babel option known for language %r�no changes in version %s.�no code/output in %s block at %s:%s�no output at all, not even warnings�no output on stdout, just warnings on stderr�no targets are out of date.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�non-whitespace stripped by dedent�none found�not available for built-in messages�numfig is disabled. :numref: is ignored.�numfig_format is not defined for %s�object�operator�original entry�override a setting in configuration file�overwrite existing files�page�page %s matches two patterns in html_sidebars: %r and %r�pass a value into HTML templates�path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)�path to documentation source files�path to module to document�path to output directory�path where configuration file (conf.py) is located (default: same as SOURCEDIR)�pickling environment�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�program option�project author(s), used when --full is given�project name�project name (default: root module name)�project release, used when --full is given, defaults to --doc-version�project root�project version, used when --full is given�property�put documentation for each module on its own page�put module documentation before submodule documentation�quick access to all modules�quiet mode�reST markup error:�reading error: %s, %s�reading sources... �reading templates... �reference label�release of project�replacement for dot in _templates etc.�resolving references...�role�role %r is already registered, it will be overridden�run Pdb on exception�run the script without creating files�search�search index couldn't be loaded, but not all documents will be built: the index will be incomplete.�search this documentation�see %s�see also %s�self referenced toctree found. Ignored.�setting %s.%s occurs in none of the searched theme configs�show full traceback on exception�signature arguments or return annotation given for automodule %s�skipped�source directory has changed�source file suffix�source files to generate rST files for�source_parser for %r is already registered�source_suffix %r is already registered�sphinx-quickstart only generate into a empty directory. Please specify a new root path.�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0�statement�static method�struct�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�targets for %d template files�template directory for template files�template parameter�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension is not safe for parallel reading�the %s extension is not safe for parallel writing�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�toctree contains ref to nonexisting file %r�toctree contains reference to document %r that doesn't have a title: no link will be generated�toctree contains reference to excluded document %r�toctree contains reference to nonexisting document %r�too large :maxdepth:, ignored.�turn warnings into errors�type�undecodable source characters, replacing with "?": %r�undefined label: %s�undocumented c api: %s [%s] in file %s�undocumented python class: %s :: %s�undocumented python function: %s :: %s�undocumented python method: %s :: %s :: %s�unimplemented node type: %r�union�unknown %r toplevel_sectioning for class %r�unknown config value %r in override, ignoring�unknown directive or role name: %s:%s�unknown index entry type %r�unknown index entry type %s found�unknown mimetype for %s, ignoring�unknown node type: %r�unsupported theme option %r given�updating environment: �use epub�use make-mode for Makefile/make.bat�use no config file at all, only -D options�variable�version of project�waiting for workers...�where "builder" is one of the supported builders, e.g. html, latex or linkcheck.�while setting up extension %s:�with -W, keep going when getting warnings�write "todo" entries that can be shown or hidden on build�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing�writing %s file...�writing META-INF/container.xml file...�writing additional files�writing additional pages�writing content.opf file...�writing error: %s, %s�writing message catalogs... �writing mimetype file...�writing nav.xhtml file...�writing output... �writing summary file...�writing toc.ncx file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: fa Language-Team: Persian (http://www.transifex.com/sphinx-doc/sphinx-1/language/fa/) Plural-Forms: nplurals=2; plural=(n > 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � تولید ReStructuredText با استفاده از دستورالعمل‌های خلاصه‌ی خودکار. خودکارساز اسفینکس رابط کابر پسندی برای sphinx.ext.autosummary.generate (پیمانه‌ی افزونه‌ی خلاصه‌ساز اسفنیکس) است. این افزونه پرونده های متن reStructuredText را از دستورالعمل‌های خلاصه‌ی خودکاری تولید می‌کند که در پرونده‌های درون‌داد مشخّص شده قرار دارد. قالب دستورالعمل خلاصه‌ی خودکار درپیمانه‌ی افزونه‌ی خلاصه‌ی خودکار اسفنیکس (sphinx.ext.autosummary) مستند سازی شده می توان آن را با دستور زیر خواند:: pydoc sphinx.ext.autosummary � ایجاد مستندات از پرونده‌های مبدأ. سازنده‌ی اسفنکس مستندات را از روی پرونده های مبنع در پوشه‌‌ی منبع تولید کرده در پوشه‌ی برون‌داد قرار می‌دهد. این سازنده در پوشه‌ی مبدأ به دنبال پرونده 'conf.py' تنظیمات پیکربندی می‌گردد. این امکان وجود دارد که از ابزار شروع سریع اسفینکس ('sphinx-quickstart') برای تولید پرونده‌های قالب، که شامل پرونده 'conf.py' هم می‌شود استفاده شود. سازنده‌ی اسفینکس می توند مستندات را در قالب‌های گوناگونی از پرونده‌های خروجی ایجاد کند. قالب پرونده خروجی با مشخّص کردن نام سازنده در خط فرمان مشخّص می‌شود که به صورت پیش فرض HTML است. همچنین، سازنده‌ها می‌توانند کارهای دیگر مربوط به فرآیند پردازش مستندسازی را انجام دهند. به صورت پیش فرض، هر چیزی که منسوخ شده باشد تولید می‌شود. برون‌داد برای پرونده‌های منتخب می‌تواند فقط با مشخّص کردن نام تک تک پرونده‌ها ساخته شود. � تولید پرونده‌های مورد نیاز برای یک پروژه‌ی اسفینکس ابزار شروع سریع اسفینکس ابزاری تعاملی است که شماری سؤال درباره‌ی پروژه‌یتان از شما می پرسد و سپس یک شاخه‌ی کامل مستندات و پرونده ساخت Makefile را برای استفاده به همراه ابزار ساخت اسفینکس تولید می‌کند. � به صورت بازگشتی در مسیر <MODULE_PATH> دنبال پیمانه‌هاو بسته‌های پایتون بگرد و با به ازای دستورالمعل‌های خودکار پیمانه‌ی هر بسته در مسیر خروجی <OUTPUT_PATH> یک پرونده‌ی reST بساز. الگوی استثتاء های <EXCLUDE_PATTERN> می‌تواند الگوی پرونده‌ها و یا شاخه‌هایی باشد که از تولید کنار گذاشته شده‌اند. توجّه: به صورت پیش فرض این اسکریپت روی پرونده‌های از پیش ساخته شده دوباره نویسی نمی‌کند.� در آن شاخه فرمان 'make' را اجرا کنید تا این‌ها را با لتکس(pdf) اجرا کند (برای انجام خودکار `make latexpdf' را به کار ببرید).� در آن شاخه فرمان 'make' را اجرا کنید تا این‌ها رh با makeinfo اجرا کند (برای انجام خودکار `make info' را به کار ببرید).� (منسوخ)� (در �"::" در پیمانه‌ی خودکار معنی نمی‌دهد�گزینه‌ی ":file:" برای دستورالمعل جدول داده‌های جداشده با کاما (csv-table) حالا دیگر مسیر ثابت را یک مسیر نسبی از شاخه‌ی منبع در نظر می گیرد. لطفاُ سندتان را به روز رسانی کنید.�مقدار پیکربندی سندهای لتکس (latex_documents) به سند ناشناخته‌ی %s ارجاع می‌دهد�پیکربندی مقدارهای «صفحات راهنما» به سند ناشناخته‌ای ارجاع می‌دهند %s�حالت «ساکت» تعیین شده، ولی یکی از موارد «پروژه» یا «نویسنده» مشخّص نشده.�مقدار پیکربندی اطّلاعات متن سندها (texinfo_documents) به سند ناشناخته‌ی %s ارجاع می‌دهد�%(filename)s — %(docstitle)s�%b %d, %Y�%d تا مورد پیدا شد�پرونده‌های منبع %d داده شده در خط فرمان�%r فاقد تنظیمات "%s" است�%r فاقد تنظیمات زمینه است�مقصد ارجاع %r پیدا نشد %s�%s %s�مستندات %s%s�%s (%s مشخصه)�%s(%sویژگی)�%s (C %s)�%s (C++ %s)�%s (کلاس درونی)�%s (متغیر درونی)�%s (کلاس در %s)�%s (دستورالمعل)�%s (متغیّر عمومی یا مقدار ثابت)�%s (در ماژول %s)�%s (ماژول)�%s (نقش)�%s اضافه شد، %s تغییر کرد، %s حذف شد�%sفرمان %r را نمی توان اجرا کرد(برای نمایش ریاضی لازم است)، تنظیمات imgmath_%s را بررسی کنید�%s گزینه‌ی خط فرمان�شماره‌ی قسمت‌ها پیش‌تر به %s نسبت داده شده ( آیا درختواره‌ی فهرست مطالب شماره‌گذاری تو در تو دارد؟)�%s شاخه نیست.�%s() (%s شگرد کلاس)�%s() (%s متد)�%s() (%s متد استاتیک)�%s() (توابع درونی)�%s (کلاس)�%s() (در ماژول %s)�%s:%s مرجع هدف پیدا نشد: %s�© <a href="%(path)s">حق نشر</a> %(copyright)s.�© حق نشر%(copyright)s.�"%s" یک گزینه‌ی معتبر نیست.�'%s' یک گزینه‌ی معتبر نسخه‌ی پایتون (pyversion) نیست�'setup' آن طور که در conf.py تعریف شده شیئ قابل فراخوانی پایتون نیست. لطفاً تعریفش را تغییر دهید تا تابع قابل فراخوان پایتون شود. این کار لازمه‌ی conf.py است تا به عنوان افزنه‌ی اسفینکس کار کند.�(<original entry> در%s و سطر %d جای گرفته است.)�(در %s v%s)�(در %s )�، در �نشانوند گزینه‌ی A- می‌بایست در قالب نام=مقدار (name=value) باشد�نشانوند گزینه‌ی D- می‌بایست در قالب نام=مقدار (name=value) باشد�نمایه‌ای بر پایه‌ی ۴ ستون پیدا شد. شاید یک اشکال برنامه‌نویسی از افزونه‌هایی که استفاده می‌کنید باشد: %r�%s (گزینه‌ی دستورالمعل)�<<original entry>>�<h1> همه‌ی پیمانه‌هایی که برایشان کد در دسترس است</h1>�<h1>کد منبع برای %s </h1>�====================== کند ترین زمان خواندن =======================�پرونده‌های خط‌فرمان ویندوز و Makefile می‌توانند برای شما تولید شوند، به گونه‌ای که شما فقط نیاز باشد تا مثلاً فرمان `make html' را به جای فراخوان مستقیم ابزار ساخت اسفینکس اجرا کنید.�گزارش اشکال می تواند در ردیاب در مسیر <https://github.com/sphinx-doc/sphinx/issues> ثبت شود. با سپاس!�خلاصه‌ی خودکار عنوان‌ٔار نیازمند گزینه‌ی :toctree: است، نادیده گرفته می‌شود.�شیئ ساختگی شناسایی شد: %r�درباره این مستندات�خطایی در نمایش صفحه‌ی %s رخ داد. علّت: %r�مهار '%s' پیدا نشد�هر کدام از شناسه‌هایی که به بست %s اختصاص داده نشده�نشانوندها�دقت�نام نویسنده (ها)�نویسنده: �لیست تولید شده خودکار از تغییرات در نسخه %(version)s�پایه ها:%s�سازنده %r در حال حاضر وجود دارد (در پیمانه‌ی %s)�کلاس سازنده %s هیچ ویژگی‌ای به عنوان "name" ندارد�نام سازنده %s ثبت نشده است�نام سازنده %s یا ثبت شده نیست و یا فقط از طریق نقطه ورود در دسترس است�درونی سازی�C API تغییرات�شاخه‌ی منبع(%s) پیدا نشد.�امکان استفاده‌ی گزینه‌ی «هم‌خوان شماره‌ی سطر» (lineno-match) با مجموعه‌ی سطرهای گسیخته وجود ندارد�امکان استفاده از هر دوی %sو%s نیست�ملاحظه�تغییر داده شده در نسخه %s�تغییرات در نسخه %(version)s — %(docstitle)s�نقل [%s] قول ارجاع داده نشده.�نویسنده ی کد: �تا کردن نوار کناره�فهرست کامل مطالب�مقدار پیکربندی %r از قبل موجود است�محتوا ها�کپی رایت�امکان تشخیص متن جایگزین برای ارجاع متقابل نبود. شاید یک اشکال برنامه نویسی باشد.�امکان دریافت تصویر از منبع راه دور نبود: %s [%d]�امکان دریافت تصویر از منبع راه دور نبود: %s [%s]�امکان وارد کردن افزونه‌ی %s نبود�امکان خواندن قسمت "%s" به عنوان بخش نثل قول ادبی نبود. برجسته کردن آن نادیده گرفته شد.�امکان دست یابی به اندازه‌ی عکس نبود. گزینه‌ی تغییر اندازه :scale: نادیده گرفته می‌شود.�آیا پرونده‌ی‌ make ایجاد شود؟ (y/n)�آیا پرونده‌ی خط فرمان ویندوز ساخته شود؟ (y/n)ٍ�ایجاد شده با<a href="https://www.sphinx-doc.org/">Sphinx</a> %(sphinx_version)s.�ایجاد پرونده‌ی %s.�خطر�منسوخ شده�منسوخ شده از نسخه %s�دامنه ی %r ثبت نشده�اعلان C تکراری، که در %s:%s هم تعریف شده. اعلان '.. c:%s:: %s' است.�اعلان ++C تکراری، که در %s:%s هم تعریف شده. اعلان '.. cpp:%s:: %s' است.�کدگذاری %r که باری خواندن پرونده‌ی گنجانده شده‌ی %r اسفتاده شده به نظر می رسد اشتباه باشد، استفاده از گزینه‌ی کدگذاری ( :encoding:) را امتحان کنید�خطای کدگذاری نویسه:�مسیر ریشه‌ی مستندات را وارد کنید.�خطا�خطا: در مسیر ریشه‌ی انتخاب شده‌، پرونده‌ی conf.pyی دیگری یپدا شد.�خطا: مسیر مشخّص شده پوشه نیست، یا از قبل پرونده‌های اسفینکس وجود داشته‌اند.�خطا: پرونده‌ی اصلی %s از قبل در مسیر ریشه‌ی برگزیده بوده‌است.�رویداد %r در حال حاضر موجود است�مثال�نمونه‎ها�در حین ساخت ایرادی رخ داد، شروع اشکال زدا:�ایراد رخ داد:�گسترش نوار کناره�گزینه‌های افزونه�پرونده گنجانده شده‌ی خارجی Graphviz %r یا پیدا نشد و یا خواندنش با شکست رو به رو شد�شکست در گردآوری عبارات باقاعده در linkcheck_allowed_redirects: %r %s�شکست در رونوشت یک پرونده‌ی به html_static_file: %s: %r�شکست در ایجاد ارجاع متقابل. عنوان یا زیرنویس پیدا نشد: %s�شکست در ایجاد ارجاع متقابل. هیچ شماره انتساب داده نشده: %s�شکست در دریافت امضای سازنده‌ی شیئ برای %s: مؤلّفه پیدا نشد: %s�شکست در دریافت امضای تابع برای %s: مؤلّفه پیدا نشد: %s�شکست در دریافت امضای شگرد برای %s: مؤلّفه پیدا نشد: %s�شکست در تحلیل مقدار پیش‌گزیده‌‌ی نشانوند برای %r: %s�شکست در تحلیل نوع یادداشت برای %r: %s�شکست در خواندن پرونده‌ی اطّلاعات ساخت: %r�شکست در خواندن intersphinx_mapping[%s]، نادیده گرفته می‌شود: %r�پویش اسناد %s: %r شکست خورد�شکست در به روز رسانی امضا برای %r: مؤلّفه پیدا نشد: %s�شکست در نوشتن پرونده‌ی اطّلاعات ساخت: %r�شکل %s�پرونده‌ی %s در حال حاضر وجود دارد، رد شدن.�پایان یافت: ساختار آغازین شاخه ایجاد شد.�پانویس [#] ارجاع داده نشده است.�پانویس [%s] ارجاع داده نشده است.�پانویس ها�برای اطّلاعات بیشتر به <https://www.sphinx-doc.org/> بروید.�به دلایل امنیّتی، حالت موازی در macOS و پایتون 3.8 و جدیدتر از آن غیرفعّال است. برای جزئیّات بیشتر لطفاً این مقاله را بخوانید: https://github.com/sphinx-doc/sphinx/issues/6803�فهرست کامل در یک صفحه�فهرست کلی�فهرست کلی ماژول ها�برو�دستورالعمل Graphviz نمی تواند هم نشانوند محتوا را داشته باشد و هم نام پرونده�مدیر %r برای رویداد %r یک باعث ایراد شد�عدم نمایش نتایج یافت شده�راهنمایی�اگر مستندات قرار است با زبانی غیر از انگلیسی نوشته شود، می توانید همین‌جا یک زبان را با انتخاب کد زبانیش انتخاب کنید. اسفینکس سپس متن‌هایی را که تولید می‌کند را به آن زبان ترجمه می‌کند. برای فهرست زبان‌های پشتیبانی شده، به این نشانی مراجعه کنید https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�نادیده گرفتن دستورالعمل «graphviz» بدون محتوا.�مهم�پرونده‌ی گنجانده شده %r یا پیدا نشد و یا خواندن آن شکست خورد�فهرست�فهرست – %(key)s�فهرست صفحات بر اساس حروف�مشخّص کنید کدام یک از این افزونه‌های اسفینکس باید فعّال باشد:�ایندکس ها و جداول:�درون شاخه‌ی ریشه، دو شاخه‌ی دیگر ساخته خواهد شد؛ "_templates" برای قالب‌های سفارشی HTML و "_static" برای قالب برگه‌ها و بقیّه‌ی پرونده‌های ثابت. شما می‌توانید پیشوند دیگری (مانند «.») برای جایگزینی نویسه‌ی خط به کار ببرید.�قطع شد!�__slots__ نامعتبر در %sیدا شد و نادیده گرفته شد.�برچسب نامعتبر:%s�قالب تاریخ ناشناخته. اگر می‌خواهید از رشته‌متن مستقیماً خروجی بگیرید، آن را با نقل قول رشته‌متنی محصور کنید: %s�قالب مرجع معادله‌‌ی ریاضی (math_eqref_format) نامعتبر: %r�متغیرهای نامعتبرقالب؛ %s�نشانوندهای کلیدی�فرمان لتکس %r را نمی توان اجرا کرد(برای نمایش ریاضی لازم است)، تنظیمات imgmath_latex را بررسی کنید�آخرین بروز رسانی در %(last_updated)s .�تغییرات کتابخانه ایی�سطر مشخّص شده %r: هیچ سطری از پرونده‌ی گنجانده شده %r بیرون کشیده نشده�فهرست %s�به دنبال هر یک از خطاهای بالا در یا در برون‌داد و یا در %(outdir)s/output.txt بگردید�ایجاد Makefile و Batchfile�توضیح بدشکل برای گزینه‌ی %r، باید شبیه این‌ها باشد "opt", "-opt args", "--opt args", "/opt args" یا "+opt args"�ارا‌ئه کننده‌های ریاضی زیادی ثبت شده‌اند، ولی هیچ کدام انتخاب نشده.�فهرست ماژول ها�نویسنده این ماژول: �کد ماژول�در سطح ماژول�نام سند اصلی شما (بدون پسوند)�برای شاخه‌های قالب‌ها (templates) و ثابت‌ها (static) نویسه‌ی پیشوندی را بنویسید�ناوبری�جدید در نسخه %s�موضوع بعدی�هیچ سازنده‌ای برگزیده نشده، استفاده از قالب خروجی پیش‌فرض: html�چنین مقداری برای پیکربندی نبود: %s�غیر الفبایی�توجه�یادداشت: ابزارهای‌ imgmath و mathjax نمی‌توانند در یک زمان فعّال باشند. انتخاب imgmath لغو شد.�یادداشت‌ها�شماره ها�شیئ با نام %r در پرونده‌ی %r پیدا نشد�یک سند از آن جهت خاص است که به عنوان بست بالایی «درختواره‌ی محتوا» در نظر گرفته می‌شود. یعنی، این سند ریشه‌ی ساختار سلسله مراتبی اسناد است. معمولاً سند این کار «نمایه» است، ولی اگر سند «نمایه‌»‌ی شما قالب سفارشی است؛ می توانید آن را به نام دیگری تغییر دهید.�ایراد اصلی: �مؤلّفه‌های دیگر�دگر تغییرات�نشانی (%s) شاخه نیست�بررسی اجمالی�بررسی اجمالی: کد ماژول�پارامترها�پیوند ثابت به این کد�پیوند ثابت به این تعریف�پیوند ثابت به این معادله�پیوند ثابت به این سر مقاله�پیوند ثابت به این تصویر�پیوند ثابت به این جدول�پیوند ثابت به این اصطلاح�پیوند ثابت به این فهرست عنوان ها�Pillow پیدا نشد- رونوشت برداشتن از پرونده‌های تصویری�لطفاً برای فعّال کردن کارکرد جستجو جاوا اسکریپت را فعّال کنید.�لطفاً اگر این مورد خطای کاربر بوده، آن را گزارش دهید تا برای بارهای بعدی پیام خطای بهتری بتواند ارائه شود.�لطفاً یک پسوند را وارد کنید، مثل: '.rst' یا '.txt'.�لطفاُ یک نام جدید وارد کنید، یا نام پرونده‌ی موجود را تغییر دهید و Enter‌ را فشار دهید�لطفاً یک مسیر ریشه‌ی جدید وارد کنید (یا برای خروج Enter‌ را بزنید)�لطفاً نام مسیر معتبری را وارد کنید.�لطفاً یا y و یا n وارد کنید.�لطفاً یکی از %s وارد کنید.�لطفاً متنی وارد کنید.�لطفاً مقدارهای تنظیمات زیر را وارد کنید (اگر مقدار پیش‌گزیده‌ای درون داده کروشه شده بود، برای برای پذیرش آن فقط کلید Enter‌را فشار دهید).�آماده سازی جست و جو...�موضوع قبلی�گزینه‌های اساسی پروژه�زبان پروژه�نام پروژه�انتشار پروژه�قالب سازی پروژه�نسخه انتشار پروژه�نام رنگ‌مایه خوان %r شناخته شده نیست�Python Enhancement Proposals; PEP %s�نمایه ی ماژول های پایتون�جستجو سریع�برانگیختن�دریافت‌ها�خطای بازگشتی:�منابع�انتشار�نوع برگشتی�بازگشت ها�مسیر ریشه‌ی مستندات�اجرای اسفینکس نگارش %s�جستجو�جستجو %(docstitle)s�صفحه جستجو�نتایج جستجو�جستجو پایان یافت و %sصفحه نتایج مطابق جستار پیدا شدن.�جستجو در %(docstitle)s�در حال جست و جو�در حال جستجو برای چندین واژه. فقط واژگانی را نشان می‌دهد که شامل این موارد باشد: همه‌ی کلمه‌ها.�بخش%s�نویسنده این بخش: �همچنین ملاحظه نمائید�مسیر برگزیده‌ی ریشه‌ی مستندات: %s�شاخه‌های منبع و ساخت از یکدیگر جدا شوند؟(y/n)�نمایش سورس�از زمان نسخه‌ی ۲ تا به حال، اسفیکنس به صورت پیش فرض از "index" به عنوان ریشه‌ی سند(root_doc) استفاده می‌کند. لطفاً "root_doc = 'contents'" را به پرونده conf.py تان اضافه کنید.�شاخه‌های مبدأ و مقصد نمی توانند یکسان باشند�پسوند پرونده‌ی منبع�تجزیه کننده مبدإ برای %s ثبت نشده است�اسفینکس نظریّه‌ای برای یک «نسخه» و یک «نگارش» برای نرم افزار دارد. هر نسخه‌ای می تواند چندید نگارش داشته باشد. مثلاً برای پایتون نسخه‌ چیزی شبیه به ۲/۵ یا ۳/۰ است، در حالی که انتشار چیزیست شبیه به ۲/۵/۱ یا ۳/۰a۱ . اگر شما نیازی به این ساختار دوگانه ندارید، هر دو را یکی تعیین کنید.�گزینه‌های ساختار�نماد ها�مدخل فهرست اقدام پیدا شد: %s�جدول %s�فهرست عناوین�پارامترهای قالب�آزمودن پوشش منابع پایان یافت، به نتایج در %(outdir)spython.txt نگاهی بیاندازید.�آزمایش مستندات منابع به پایان رسید، به نتایج در %(outdir)s/output.txt نگاهی بیاندازید.�ارجاع متقابل (crossref_type) %r قبلاً ثبت شده�دستورالعمل %r قبلاً برای دامنه %s ثبت شده�شاخص %r قبلاً برای دامنه %s ثبت شده�نوع شیئ (object_type) %r قبلاً برای دامنه ثبت شده�نقش %r قبلاً برای دامنه %s ثبت شده�تنظیمات needs_extensions (نیازهای افزونه) افزونه‌ی %s را نیاز دارد، ولی بارگذاری نمی شود.�افزونه‌ی %s که در این پروژه استفاده شده دست کم نیازمند اسفینکس نسخه‌ی %s است؛ بنابراین با این نسخه قابل ساخت نیست.�صفحه HTML در %(outdir)s است.�صفحات HTML در %(outdir)s است.�پرونده‌ی LaTeX در پوشه‌ی %(outdir)s است.�پرونده‌ی اطّلاعات متن در پوشه‌ی %(outdir)s است.�پرونده‌ی XML در پوشه‌ی %(outdir)s است.�مقدار پیکربندی 'source_suffix' انتظار یک رشته، لیست رشته ها، یا فرهنگ لغت را داشت. اما '%r' داده شده است.�مقدار پیکربندی '{name}' دارای نوع '{current.__name__}' است، حالت پیش‌فرض {permitted} است.�مقدار پیکربندی '{name}' دارای نوع '{current.__name__}' است، ولی انتظار می‌رفت {permitted} می‌بود.�مقدار پیکربندی '{name}' باید یکی از {candidates} باشد، اما '{current}' داده شده.�پرونده‌ی پیکربندی (یا یکی از ماژول هایی که وارد می کند) sys.exit() را فراخواند�سازنده‌ی بدلی هیچ پرونده‌ای تولید نمی کند.�پرونده‌ی ePub در پوشه‌ی %(outdir)s است.�پسوند نام پرونده برای پرونده‌های منبع. معمولاً این پسوند یا ".txt" است و یا ".rst". فقط پرونده‌هایی بای این پسوند به عنوان اسناد در نظر گرفته می‌شوند.�اگر می‌‌خواهید مشکل را به توسعه‌دهندگان گزارش دهید، ردیابی کامل خطا در %s ذخیره شده است.�صفحات راهنما در %(outdir)s است.�سیاهه‌های پیام‌ها در %(outdir)s است.�پرونده‌ی بازبینی در پوشه‌ی %(outdir)s است.�نام پروژه در چندین جا در سند ساخته شده به کار می‌رود.�پرونده‌های شبه XML در پوشه‌ی %(outdir)s.�پرونده‌ی متنی در پوشه‌ی %(outdir)s است.�یک خطای قابل برنامه ریزی در پرونده‌ی پیکربندی شما وجود دارد: %s�خطای نحوی در پرونده‌ی پیکربندی شما وجود دارد: %s �صفحه فعلی�این اتّفاق ممکن است برای پرونده‌های بسیار تو در توی منبع بیافتد. شما می‌توانید محدودیّت ۱۰۰۰ تایی مقدار پیش‌فرض اجرای بازگشت پایتون را در conf.py زیاد کنید، مثلاً با:�این محیط با سازنده‌ی انتخاب شده سازگار نیست، لطفاً یک خوشه‌ی اسناد دیگری را انتخاب کنید.�این پروژه دست که به افینکس نگارش%s نیاز دارد و برای همین با این نسخه قابل ساخت نیست.�این پروژه افزونه‌ی %s (دست کم نسخه‌ی %s) را نیاز دارد، بنابراین نمی تواند با نسخه بارگذاری شده (%s) ساخته شود.�ایجاد�نکته�در دست انجام�در حال حاضر برای %r مترجم وجود دارد�کلید پیکربندی ناشناخته: latex_elements[%r]، نادیده گرفته می‌شود.�نوع اتفاق نامشخّص است: %s�قالب تصویر ناشناخته: %s...�نمایش‌دهنده‌ی ریاضی نامشخّص %r داده شده.�کلید زمینه‌ی ناشناخته: latex_theme_options[%r]، نادیده گرفته می‌شود.�از Makefile برای ساختن مستندات استفاده کنید، مانند این: make builder�از فرمان ساخت اسفینکس برای ساختن مستندات استفاده کنید، مانند این: sphinx-build -b builder %s %s�متغیر ها�هشدار�هشدارها�به ابزار شروع سریع اسفینکس %s خوش آمدید.�خوش آمدید! این�پرونده‌ی %s را می سازد.�فرآورده�شما برای تعیین شاخه‌ی ساخت برای برون‌داد اسفینکس دو گزینه دارید. یا از شاخه‌ای با نام "_build" درون شاخه‌ی ریشه استفاده کنید، و یا شاخه‌های را درون یک مسیر ریشه با نام‌های منبع (source) و ساخت (build) جدا کنید.�شما باید حالا دیگر پرونده‌ی اصلی‌تان %s را جمع آوری کنید و بقیّه‌ی پرونده‌های منبع مستندات را ایجاد کنید. �جستجوی شما با هیچ سندی هم خوانی نداشت. لطفاً اطمینان حاصل کنید که همه ی واژه ها املای درستی دارند و دسته بندی های کافی را انتخاب کرده اید.�[خلاصه‌ی خودکار]: فراخوان %r: %s شکست خورد�[خلاصه‌ی خودکار] تولید خلاصه‌ی خودکار برای: %s�[خلاصه‌ی خودکار] نوشتن در %s�[مستندات]�[گراف:%s]�[گراف:]�[تصویر%s]�[تصویر]�[منبع]�__all__ باید لیستی از رشته‌متن ها باشد، نه %r (در پیمانه‌ی %s) -- __all__ نادیده گرفته می‌شود�هنگام ارائه‌ی صفحه‌ی %s خطای یونیکد رخ داد. لطفاً اطمینان حاصل کنید که تمام مقدارهای پیکربندی‌ها دارای محتوای غیر اَسکی، رشته‌متن‌های یونکد هستند.�لیست پرونده‌هایی که قرار است دوباره ساخته شوند. اگر با -a مشخّص شده باشند نادیده گرفته می‌شوند�تصویر مناسبی برای سازنده‌ی %s پیدا نشد: %s�تصویر مناسبی برای سازنده‌ی %s پیدا نشد: %s (%s)�نام جانشین %s�نام جانشین نوع متغیر(%s)�تمامی توابع ، کلاس ها ، اصطلاحات�همه‌ی پرونده‌های %d po�همه‌ی پرونده‌های منبع�پیوست مسیر پیمانه (module_path) به مسیر سیستم (sys.path)، هنگامی به کار می‌رود که گزینه‌ی full-- داده شود�سر جمع کرد تک سند�مشخّصه�نام نویسندگان�مستندسازی خودکار: شکست در تشخیص %r برای مستندسازی، این ایراد به وجود آمد: %s�اعضای مستندسازی خودکار (autodoc_member_order) حالا دیگر ترتیب الفبایی «alphabetical» را به جای حالت منتسب به الفبا «alphabetic» می‌پذیرد. لطفاً تنظیمات خود را به روز رسانی کنید.�درج خودکار رشته‌مستندات را از پیمانه‌ها�آزمایش خودکار تکّه‌کدها در قسمت‌های مختلف پیمانه‌ی doctest�خلاصه‌ی خودکار به طور داخلی پرونده‌های rst را ایجاد می‌کند. ولی پسوند منبع شما شامل rst نیست. نادیده گرفته می‌شود.�ارجاعات خلاصه‌ی خودکار سند %r حذف کنار گذاشته. نادیده گرفته می‌شود.�خلاصه‌ی خودکار: شکست در تشخیص %r برای مستندسازی، این ایراد به وجود آمد: %s�خلاصه‌ی خودکار: فراخوان %s شکست خورد�خلاصه‌ی خودکار: خرده‌پرونده‌ی %r پیدا نشد. تنظیمات تولید خلاصه‌ی خودکار(autosummary_generate) را بررسی کنید.�تولید خلاصه خودکار: پرونده پیدا نشد: %s�هر دو مقدار tabularcolumns و :widths: داده شده، بنابراین :widths: حذف می شود.�پیوند خراب: %s (%s)�ساخت %s، %s هشدار (با هشدار به عنوان خطا رفتار می‌شود).�ساخت %s، %s هشدار.�ساخت %s، %s هشدار (با هشدار به عنوان خطا رفتار می‌شود).�ساخت %s، %s هشدار.�ساخت %s.�نسخه‌ی محیط ساخت به‌روز نیست�درصورت امکان ساخت به صورت موازی با N فرآیند پردازشی (مقدار ویژه‌ی «خودکار» شمار N را به تعداد پردازنده تنظیم می‌کند)�پرونده‌ی اطّلاعات ساخت خراب است: %r�قالب سازنده مورد استفاده (پیش‌فرض:html)�ساخت [%s]: �ساخت پرونده‌ی [mo]: �توابع درونی�ممکن است سترگ باشد�نمی توان گزینه‌ی -a را با نام پرونده‌ها ترکیب کرد�نمی تواند از پرونده‌ی قابل دریافت %r: %s رونوشت بگیرد�نمی تواند از پرونده‌ی اضافه‌ی %r رونوشت بگیرد�نمی تواند پرونده‌ی تصویر %r: %s را کپی کند�نمی تواند از پرونده‌ی ثابت %r رونوشت بگیرد�پرونده‌های %r پیدا نشدند�امکان باز کردن پرونده هشدار نبود %r: %s�امکان لغو تنظیمات پیکربندی %r با نوع پشتیبانی نشده نبود، نادیده گرفته می‌شود�امکان لغو تنظیمات پیکربندیdictionary %r ، نادیده گرفته می‌شود (برای تعیین تک تک عناصر %r را به کار ببرید)�امکان خواندن پرونده‌ی تصویری %r نبود: در عوض کپی می‌شود�نمی تواند پرونده‌ی تصویری %r: %s را بنویسد�عنوان درون شکل نیست.�بررسی ثبات�بررسی برای پوشش اسناد�دور تسلسل در درختواره‌ی ارجاعات فهرست مطالب تشخیص داده شده، نادیده گرفته می‌شوند: %s <- %s�کلاس�class method�گزینه خط فرمان�کانسپت�گنجاندن شرطی محتوا بر اساس مقادیر پیکربندی�مقدار پیکربندی مؤلّف ("epub_author") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد�مقدار پیکربندی حامی ("epub_contributor") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد�مقدار پیکربندی حق انتشار ("epub_copyright") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد�مقدار پیکربندی توضیحات ("epub_description") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد�مقدار پیکربندی شناسه ("epub_identifier") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد�مقدار پیکربندی زبان پرونده epub ("epub_language") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد�مقدار پیکربندی ناشر ("epub_publisher") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد�مقدار پیکربندی عنوان ("html_title") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد�مقدار پیکربندی شناسه‌ی یکتای انتشار الکترونیکی ("epub_uid") باید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) یک XML NAME باشد�مقدار پیکربندی ویراست ("version") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد�پیکربندی تغییر داده شد�شاخه‌ی پیکربندی(%s)، پرونده‌ی conf.py را ندارد�گزنیه‌های برون‌داد میز فرمان�ادامه از صفحه‌ی قبل�ادامه در صفحه‌ی بعد�فرمان تبدیل %r را نمی توان اجرا کرد، تنظیمات image_converter را بررسی کنید�فرمان تبدیل %r را نمی توان اجرا کرد، تنظیمات image_converter بررسی کنید: %s�تبدیل با خطایی از کار افتاد: [stderr] %r [stdout] %r�رونوشت از پرونده‌های پشتیبانی لتکس�رونوشت از پرونده‌های پشتیبانی لتکس...�رونوشت از پرونده‌های با پشتیبانی اطلاعات متن�رونوشت برداری از پرونده‌های اضافی�رونوشت از پرونده‌های قابل دریافت... �رونوشت برداری از پرونده‌های اضافی�در حال رونوشت از تصاویر... �رونوشت از پرونده‌های مبدأ...�رونوشت از پرونده‌های ثابت�نمی‌توان %r را برای ایجاد گزارش تغییرات خواند�ساخت پرونده‌ی nojekyll برای انتشار سند در صفحات گیت-هاب�ایجاد Batchfile�ایجاد پرونده‌ی سازنده (makefile)�شاخه‌ی سفارشی قالب (پیش‌گزیده: %(default)s)�داده�نقش پیش‌فرض %s یافت نشد�پسوند پیش فرض برای پرونده‌ها (پیش‌فرض: %(default)s)�تعریف متغیّر قالب�تعریف برچسب: «فقط» تکّه‌های با برچسب گنجانده شود�ابعاد واحد %sنامعتبر است و نادیده گرفته شد.�دستورالمعل�دستور %r از قبل ثبت شده که مقدار قبلی نادیده گرفته خواهد شد�گزینه‌ی دستورالمعل�پوشه‌ای برای قرار دادن همه‌ی برون دادها�پوشه‌ای برای قرار دادن همه‌ی برون دادها در آن�نمایش لتکس: %r: %s�خروجی رنگ شده منتشر شود (پیش‌فرض: تشخیص خودکار)�batchfile را ایجاد نکن�پرونده‌ی سازنده (makefile) را ایجاد نکن�خروجی رنگ شده منتشر نشود (پیش‌فرض: تشخیص خودکار)�عدم اسفتاده از حالت ایجاد برای پرونده‌های Makefile/make.bat�نام مستندات برای نوشتن: %s�سند�اجزای فراخوان شده‌ی سند (پیش‌گزیده: %(default)s)�سند در هیچ درختواره‌ی فهرست مطالبی گنجانده نشده�زبان سند�سند قابل خواندن نیست. نادیده گرفته شد.�عنوان سند یک بست متنی نیست�انجام چندباره‌ی %s�دامنه ی %sپیش تر ثبت شده�دامنه %s هنوز ثبت نشده است�پرونده‌ی فهرست مطالب را ایجاد نکن�برای بسته‌ها و پیمانه‌ها سربرگ نساز (مثلاً وقتی رشته‌متن‌های مستندات از قبل آن‌ها را داشته باشند)�مشخّص نیست کدام پیمانه را برای مستندسازی خودکار فراخوان کند %r (سعی کنید دستورالعمل «module» یا «currentmodule» را در سند قرار دهید، یا یک نام واضح برای پیمانه ارائه دهید)�از محیط ذخیره شده استفاده نکن، همیشه همه پرونده ها را بخوان�انجام شد�کد دات: %r: %s�فرمان dot %r نمی‌تواند اجرا شود (زیرا نیازمند برون‌داد graphviz است)، تنظیمات graphviz_dot را بررسی کنید�dot هیچ پرونده‌ی برون‌دادی تولید نکرد: [stderr] %r [stdout] %r�dot با خطایی از کار افتاد: [stderr] %r [stdout] %r�پرونده‌ی دریافت شده خوانا نیست: %s�خالی کردن فهرست اشیاء�خالی کردن نمایه‌ی جستجو در %s�توضیح %s تکراری از %s، مورد دیگر%s در %s قرار دارد�تکرار توضیح %s از %s، مورد دیگر در%s قرار دارد�نقل‌قول %s تکراری، مورد دیگر در %s قرار دارد�توضیح تکراری از %s %s، مورد دیگر در %s قرار دارد�بر چسب تکراری %s، مورد دیگر در %s قرار دارد�بر چسب معادله ی %s تکرار است، مورد دیگر در %s قرار دارد�توضیح تکراری شیئ %s، نمونه‌ی دیگر در %s قرار دارد، برای یک مورد از :noindex: استفاده کنید�عنوان تکراری در فهرست مطالب پیدا شد:%s�فعّال‌سازی %s افزونه�فعّال‌سازی افزونه‌های اختیاری�مشکلاتی در برخی از سیاهه‌ها به وجود آمد،ولی این مشکلات راه‌های جایگزین های داشته‌اند:�به بست عنوانی برخورد که در قسمت، موضوع، جدول، اندرز یا نوارکناری نبود�شمارش�بست قابل شمارش (enumerable_node) %r قبلاً ثبت شده است�شمارنده�متغیّر عمومی�متغیرهای عمومی؛ %s�خطا در قالب بندی نشانوند برای %s: %s�خطا در قالب بندی امضا برای %s: %s�خطای نوشتن پرونده: %s, %s�خطای نوشتن پرونده‌ی ساخت (Makefile) : %s�ایراد�ایراد در هنگام ارزیابی تنها عبارت دستور العمل: %s�افزونه‌ی %r هیچ تابع setup()ی ندارد؛ آیا این مورد واقعاً یک پیمانه‌ی افزونه‌ی اسفینکس است؟�افزونه‌ی %r شیئ پشتیبانی نشده‌‌ای از تابع setup()ش برگرداند؛ در حالی که می بایست مقدار تهی/هیچ و یا یک دیکشنری فراداده‌ برمی‌گرداند�گزینه های افزونه�افزونه‌ها تغییر کردند�شکست خورد�شکست در وارد کردن شیئ %s�شکست در تجزیه تحلیل نام %s�شکست در رسیدن به یکی از سیاهه‌ها به خاطر مشکلات زیر:�شکست خورد: %s�پرونده‌ی آیکون مورد علاقه %r وجود ندارد�پرونده‌ی %r که در خط فرمان داده شده، وجود ندارد، نادیده گرفته می‌شود�پرونده‌ی %r که در خط فرمان داده شده، در شاخه‌ی منبع نیست, نادیده گرفته می‌شود�پرونده‌ی %r که مسیر زمینه به آن اشاره دارد یا پرونده زیپ معتبری نیست یا هیچ زمینه‌ای درونش ندارد�پسوند پرونده ( پیش فرض: rst)�نام پرونده فهرست مطالب (پیش‌گزیده: پیمانه‌ها)�انجام شد ولی با مشکل�الگوها‌ی به سبک fnmatch در پرونده و یا شاخه برای کنار گذاشتن از تولید�ردگیری پیوند نمادین. وقتی با collective.recipe.omelette ترکیب می‌شود توانمند است.�تابع�مؤلّفه‌ی تابع�گزینه‌های کلی�تولید یک پروژه‌ی کامل با ابزار شروع سریع اسفینکس�تولید نمایه‌ها�به نظر می رسد واژه‌نامه اشتباه شکل داده شده است، فاصله‌گذاری از ابتدای سطر را بررسی کنید�اصطلاح واژه‌نامه�یک خط خالی باید پیش از اصطلاح واژه‌نامه باشد�اصطلاحات واژه‌نامه نباید با خطوط خالی از هم جدا شوند�نشانه ی گرامری�قالب خروجی graphviz باید یکی از قالب های 'png' یا 'svg' باشد ولی %r است�برجسته کردن کد پیمانه... �از نسخه‌ی ۳.۵.۰ به بعد افزودن پیوند همیشگی (html_add_permalinks) منسوخ شده. لطفاً از به جایش html_permalinks و html_permalinks_icon را به کار ببرید.�مدخل مسیر اضافی (html_extra_path) %r وجود ندارد�مدخل مسیر اضافی (html_extra_path) %r درون شاخه‌ی خارجی قرار دارد�مدخل مسیر ثابت (html_static_path) %r وجود ندارد�مدخل مسیر ثابت (html_static_path) %r درون شاخه‌ی خارجی قرار دارد�در صورت مشخّص بودن، شاخه‌ی build (ساخت) را درون شاخه‌ی منبع بساز�در صورتی مشخّص شدن، شاخه‌های منبع و ساخت از یکدیگر جدا می‌شوند�نادیده گرفتن کد پیمانه‌ی doctest : %r�پرونده‌ی عکس %s خوانا نیست: %s�پرونده‌ی تصویر خوانا نیست: %s�در برداشتن پیمانه‌های «خصوصی»(_private)�گنجاندن ویندهای کد منبع اشیاء مستند شده‌ی پایتون�گنجاندن رابطه‌های ریاضی که در قالب PNG یا SVG به نمایش در آمده�گنجاندن رابطه‌های ریاضی که MathJax در مرورگر نمایش در آورده�ارجاعات نقل قول ادبی ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}�ارجاعات پانویس ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}�ارجاعات ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}�ارجاعات اصطلاحی ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}�افزایش ارائه‌ی جزئیّات (می تواند تکرار شود)�فهرست�لتکس بین سطری: %r: %s�تفسیر مسیرهای پیمانه بر اساس ویژگی‌های ضمنی فضای نام‌ها در PEP -0420�شناساگر بین اسفینکس %r رشته‌متن نیست. نادیده گرفته شد�سیاهه‌ی بین اسفینکس جا به جایی را انجام داد: %s -> %s�نوع TestCode نامعتبر�پرونده‌ی css نامعتبر%r: نادیده گرفته می‌شود�پرونده‌ی js نامعتبر%r: نادیده گرفته می‌شود�شماره نامعتبر %r برای پیکربندی مقدار %r، نادیده گرفته می‌شود�قالب شماره‌ی شکل نامعتبر: %s�قالب شماره‌ی شکل نامعتبر: %s (%r)�عبارت باقاعده‌ی نامعتبر %r در %s�عبارات باقاعده‌ی نامعتبر %r در پوشش عبارت باقاعده‌ی زبان سی (coverage_c_regexes)�امضای ناشناخته‌ برای %s (%r)�مقدار نامعتبر برای گزینه‌ی «از مستندات کلاس» class-doc-from:%s�مقدار نامعتبر برای گزینه‌ی ترتیب اعضا (member-order): %s�مقدار نامعتبر تعیین شده (بدون کمانک انتهایی): %s�مقدار نامعتبر تعیین شده (بدون کمانک ابتدایی): %s�شماره‌ی کار باید یک عدد مثبت باشد�کلمه کلیدی�مؤلّفه‌های کلیدی برای تابع add_node() باید تاپل تابعی (بازدید، خروج) باشند: %r=%r�آخرین بروزرسانی�شماره‌ی سطر مشخّص شده خارج از بازه‌ی (1-%d) است: %r�پیوند بین اسناد Sphinx از پروژه های گوناگون�فهرست تمامی بخش ها و زیر مجموعه ها�بارگذاری سیاهه‌ی بین اسفینکس از %s...�بارگذاری محیط pckle شده�بارگذاری ترجمه ها [%s]... �پوشه‌ی محلّی %s وجود ندارد�پرونده‌ی آرم %r وجود ندارد�در پی پرونده‌هایی که الآن منسوخ هستند... �ماکرو�ایجاد پوشه ی برون داد�رشته‌متن ادبی ناقص (بدون علامت نقل‌قول انتهایی): %s�رشته‌متن ادبی ناقص (بدون علامت نقل‌قول ابتدایی): %s�نام سند اصلی�ترسیم‌گر ریاضی %s قبلاً ثبت شده�نهایت عمق زیر پیمانه‌ها برای نشان دادن در فهرست مطالب (پیش‌گزیده: ۴)�عضو�متد�فاقد «+» یا «-» در گزینه‌ی '%s'.�ویژگی ناموجود %s در شیئ %s�ویژگی نایاب در گزینه‌ی :members: قید شده: پیمانه‌ی:%s، ویژگی %s�ماژول�امکان وارد کردن پیمانه‎ی %s نبود: %s�ماژول ها�برای «هر» ارجاع متقابل بیشتر از یک هفد پیدا شد: %r شاید %s باشد�برای ارجاع متقابل %r بیش از یک هدف پیدا شد: %s�برای سند "%s": %r پرونده های متعدد یافت شده از %r برای ساخت استفاده کنید.�پیکربندی جدید�بعدی�فصل بعدی�حالت ریزبینانه، هشدار درباره‌ی همه‌ی ارجاع‌های ناپیدا�هیچ مقدار پیکربندی اسناد لتکسی (latex_documents) پیدا نشد؛ بنابراین هیچ سندی نوشته نخواهد شد�هیچ مقداری برای تنظیمات «صفحات راهنما» ا نشد؛ بنابراین هیچ صفحه‌ی راهنمایی نوشته نخواهد شد�هیچ تنظیماتی برای «صفحات راهنما» پیدا نشد؛ بنابراین هیچ صفحه‌ی راهنمایی نوشته نخواهد شد�بدون گزینه‌ی Babel شناخته شده برای زبان %r�بدون تغییرات در نسخه‌ی %s.�بدون کد/خروجی در تکّه‌ی %s در %s:%s�بدون هیچ برون‌داد، حتّی بدون هشدار�بدون برون‌داد در درگاه خروجی استاندارد(stdout)، فقط هشدارها در درگاه استاندارد خطاها (stderr)�هیچ مقدار تاریخ منسوخ نیست.�هیچ زمینه‌ای با نام %r پیدا نشد(آیا پرونده theme.conf گم شده؟)�هیچ زمینه‌ای به نام %r پیدا نشد، که با %r جایگزین شود�بست کلاس %r در حال حاضر ثبت نام شده است، بازدیدکنندگان این پیوند نادیده گرفته خواهد شد�غیرفاصله‌ در فرآیند حذف فاصله‌ از ابتدای سطر حذف شد�چیزی پیدا نشد�برای پیام‌های داخلی در دسترس نیست�شماره‌ی شکل غیر فعّال است. گزینه‌ی :numref: نادیده گرفته می‌شود.�قالب عدد شکل برای %s تعریف نشده�شیء�عملگر�مدخل اصلی�نادیده گرفتن تنظیماتی در پرونده‌ی پیکره‌بندی�بازنویسی پرونده‌های موجود�صفحه�صفحه‌ی %s با دو الگو در نوار کناری صفحه (html_sidebars) هم‌خوانی دارد: %r و%r�مقداری را به قالب‌های HTML بدهید�مسیر برای محیط ذخیره‌ شده و پرونده‌های doctree (پیش فرض: OUTPUTDIR /.doctrees)�مسیر پرونده‌های مستندات�مسیر پیمانه به سند�مسیری برای شاخه‌ی برون داد�مسیر جایی که پرونده‌ی پیکربندی (conf.py) قرار دارد ( پیش‌گزیده: مثل پوشه‌ی منبع)�بارگذاری محیط pickle شده�آماده سازی اسناد�قبلی�فصل قبلی�دامنه‌ی اصلی %r یافت نشد، نادیده گرفته می‌شوند.�در حال پردازش %s�اختیارات برنامه�نویسنده(های) پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود�نام پروژه�نام پروژه (پیش‌گزیده: نام پیمانه‌ی ریشه)�نگارش پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود، پیش‌گزیده همان شماره‌ی نسخه (--doc-version) است�ریشه‌ی پروژه�نسخه‌ی پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود�ویژگی�قرار دادن مستندات هر پیمانه در صفحه‌ی خودش�قرار دادن مستندات پیمانه پیش از مستندات پیمانه‌ی زیرمجموعه‌‌اش�دسترسی سریع به تمامی متدها�حالت سکوت�خطای نشانه‌گذاری متن بازساختمند (reST)�خطای خواندن: %s, %s�خواندن منبع‌ها... �خواندن قالب‌ها... �برچسب ارجاع�انتشار پروژه�جایگزینی نقطه در _templates (قالب‌ها) و ... .�حل ارجاع‌ها...�نقش�نقش %r از قبل ثبت شده که مقدار قبلی نادیده گرفته خواهد شد�ایراد در اجرای Pdb�اجرای اسکریپت بدون ساخت پرونده�جستجو�نمایه‌ی جستجو نمی‌تواند بارگزاری شود، ولی برای همه‌ی مستندات ساخته‌ نمی‌شود: نمایه‌ ناقص خواهد بود.�جستجو در این اسناد�%s را ببینید�%s را هم ببینید�درختواره‌ی فهرست مطالب با ارجاع به خود پیدا شده. نادیده گرفته می‌شود.�تنظیمات %s. %s در هیچ یک از پیکربندی‌های جستجو شده رخ نمی‌دهد�نمایش گزارش کامل ردیابی ایراد�نشانوند‌های امضا یا یادداشت مقدار برگشتی داده شده برای پیمانه‌ی خودکار %s�رد شدن و نادیده انگاشتن�شاخه ی منبع تغییر کرد�پسوند پرونده‌ی منبع�پرونده‌های منبع برای تولید پرونده‌های rST�تحلیل‌گر منبع (source_parser) %r قبلاً ثبت شده است�پسوند (source_suffix) %r قبلاً ثبت شده است�ابزار شروع سریع اسفینکس فقط یک پوشه‌ی خالی درست می کند. لطفاً یک مسیر ریشه‌ی جدید مشخّص کنید.�ابراز شروع سریع اسفینکس روی پروژه‌های از قبل موجود اسفینکس بازنویسی نمی‌کند.�ابراز شروع سریع اسفینکس روی پرونده‌های از قبل موجود بازنویسی نمی‌کند.�زمینه‌ی خواندن مستندات اسفینکس (< 0.3.0) پیدا شد. از نسخه‌ی ۶/۰ اسفینکس این زمینه‌ دیگر در دسترس نخواهد بود�گذاره�متد استاتیک�ساختار�موفّقیّت‌آمیز بود�مقصد‌های %d پرونده‌های poی هستند که منسوخ شده‌اند�اهداف برای %d پرونده‌های poی که مشخّص شده�مقصد‌های %d پرونده‌های منبعی هستند که منسوخ شده‌اند�مقصد‌های قالب پرونده‌های %d�شاخه‌ی قالب شامل پرونده‌های قالب�مؤلّفه‌ی قالب�افزونه‌ی %s مشخّص نکرده که آیا برای خواندن موازی امن هست یا نه. که فرض می‌گیریم نیست. لطفاً از نویسنده‌ی افزونه بخواهید این موضوع را بررسی و آن را مشخّص کند�افزونه‌ی %s مشخّص نکرده که آیا برای نوشتن موازی امن هست یا نه. که فرض می‌گیریم نیست. لطفاً از نویسنده‌ی افزونه بخواهید این موضوع را بررسی و آن را مشخّص کند�افزونه ی %sبرای خواندن موازی امن نیست�افزونه‌ی %s برای نوشتن موازی امن نیست�مستندات برای�افزونه‌ی %r از نسخه‌ی %s اسفینکس به بعد، در آن ادغام شده؛ بنابراین نادیده گرفته می‌شود.�پیوند هیچ برچسبی ندارد: %s�زمینه‌ی %r تنظیمات به ارث بری ندارد�زمینه ی %r فاقد تنظیمات است�درختواره‌ی فهرست مطالب شامل ارجاع به پرونده ناموجود %r است�فهرست مطالب دارای ارجاع به سند %r است که عنوانی ندارد: هیچ پیوندی تولید نخواهد شد�درختواره‌ی فهرست مطالب ارجاعی به سند کنار گذاشته شده %r را دارد�فهرست مطالب شامل ارجاع به سند ناموجود %r است�مقدار بسیار بزرگ :maxdepth:، نادیده گرفته شد.�تغییر هشدارها به خطاها�گونه�نویسه‌ی منبع غیرقابل رمزگشایی، جایگزین با «؟» : %r�برچشب تعریف نشده: %s�رابط برنامه‌نویسی مستند نشده‌ی C: %s [%s] در پرونده‌ی %s�کلاس مستندسازی نشده‌ی پایتون: %s :: %s�تابع پایتونی بدون مستندات: %s :: %s�شگرد مستندسازی نشده‌ی پایتون: %s :: %s :: %s�بست به کار نرفته: %r�اجتماع�قسمت‌بندی رده‌بالای %r ناشناخته برای کلاس %r�مقدار پیکربندی ناشناخته %r در ابطال، نادیده گرفته شد�نام نقش یا دستورالعمل ناشناخته: %s:%s�نوع ناشناخته مدخل نمایه %r�نوع ناشناخته مدخل نمایه%s پیدا شد�نوع رسانه‌ی ناشناخته %s، نادیده گرفته شد�بست از نوع ناشناخته: %r�گزینه‌ی پشتیبانی نشده‌ی زمینه %r داده شده�به روز رسانی محیط: �استفاده epub�اسفتاده از حالت ایجاد برای پرونده‌های Makefile/make.bat�هیچ پرونده‌ی پیکربندی‌ای استفاده نکن، فقط گزینه‌ی -D�متغیّر�نسخه انتشار پروژه�در انتظار برای ابزارهای کارگر...�که در آن سازنده یکی از سازنده‌های پشتیبانی شده است، مانند html, latex و یا linkcheck.�در حال راه اندازی افزونه‌ی%s:�با سوییچ -W، در هنگام گرفتن هشدار ادامه بده�نوشتن مدخل‌های لیست اقدام‌ها ("todo")که در ساخت می تواند نشان داده و یا پنهان شوند�نوشتن همه‌ی پرونده‌ها (پیش‌گزیده: فقط پرونده‌های جدید نو تغییر یافته را بنویس)�نوشتن هشدارها (و خطاها) در پرونده‌ی داده شده�در حال نوشتن�نوشتن پرونده‌ی %s...�نوشتن پرونده META-INF/container.xml...�نوشتن پرونده‌های اضافی�نوشتن صفحات اضافی�نوشتن پرونده‌ی content.opf...�خطای نوشتن: %s, %s�نوشتن سیاهه‌های پیام... �نوشتن پرونده‌های نوع رسانه...�نوشتن پرونده‌ی nav.xhtml...�نوشتن برون‌داد... �نوشتن پرونده‌ی خلاصه...�نوشتن پرونده‌ی خلاصه toc.ncx...���������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fa/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000422267�00000000000�021144� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Hadi F <h_adi_f@yahoo.com>, 2020 # Hadi F <h_adi_f@yahoo.com>, 2020-2021 # Pikhosh <pikhosh@gmail.com>, 2020 # Pikhosh <pikhosh@gmail.com>, 2020 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Persian (http://www.transifex.com/sphinx-doc/sphinx-1/language/fa/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: fa\n" "Plural-Forms: nplurals=2; plural=(n > 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "شاخه‌ی منبع(%s) پیدا نشد." #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "نشانی (%s) شاخه نیست" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "شاخه‌های مبدأ و مقصد نمی توانند یکسان باشند" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "اجرای اسفینکس نگارش %s" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "به دلایل امنیّتی، حالت موازی در macOS و پایتون 3.8 و جدیدتر از آن غیرفعّال است. برای جزئیّات بیشتر لطفاً این مقاله را بخوانید: https://github.com/sphinx-doc/sphinx/issues/6803" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "این پروژه دست که به افینکس نگارش%s نیاز دارد و برای همین با این نسخه قابل ساخت نیست." #: sphinx/application.py:243 msgid "making output directory" msgstr "ایجاد پوشه ی برون داد" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "در حال راه اندازی افزونه‌ی%s:" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' آن طور که در conf.py تعریف شده شیئ قابل فراخوانی پایتون نیست. لطفاً تعریفش را تغییر دهید تا تابع قابل فراخوان پایتون شود. این کار لازمه‌ی conf.py است تا به عنوان افزنه‌ی اسفینکس کار کند." #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "بارگذاری ترجمه ها [%s]... " #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "انجام شد" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "برای پیام‌های داخلی در دسترس نیست" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "بارگذاری محیط pckle شده" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "شکست خورد: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "هیچ سازنده‌ای برگزیده نشده، استفاده از قالب خروجی پیش‌فرض: html" #: sphinx/application.py:348 msgid "succeeded" msgstr "موفّقیّت‌آمیز بود" #: sphinx/application.py:349 msgid "finished with problems" msgstr "انجام شد ولی با مشکل" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "ساخت %s، %s هشدار (با هشدار به عنوان خطا رفتار می‌شود)." #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "ساخت %s، %s هشدار (با هشدار به عنوان خطا رفتار می‌شود)." #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "ساخت %s، %s هشدار." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "ساخت %s، %s هشدار." #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "ساخت %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "بست کلاس %r در حال حاضر ثبت نام شده است، بازدیدکنندگان این پیوند نادیده گرفته خواهد شد" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "دستور %r از قبل ثبت شده که مقدار قبلی نادیده گرفته خواهد شد" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "نقش %r از قبل ثبت شده که مقدار قبلی نادیده گرفته خواهد شد" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "افزونه‌ی %s مشخّص نکرده که آیا برای خواندن موازی امن هست یا نه. که فرض می‌گیریم نیست. لطفاً از نویسنده‌ی افزونه بخواهید این موضوع را بررسی و آن را مشخّص کند" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "افزونه ی %sبرای خواندن موازی امن نیست" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "افزونه‌ی %s مشخّص نکرده که آیا برای نوشتن موازی امن هست یا نه. که فرض می‌گیریم نیست. لطفاً از نویسنده‌ی افزونه بخواهید این موضوع را بررسی و آن را مشخّص کند" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "افزونه‌ی %s برای نوشتن موازی امن نیست" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "انجام چندباره‌ی %s" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "شاخه‌ی پیکربندی(%s)، پرونده‌ی conf.py را ندارد" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "امکان لغو تنظیمات پیکربندیdictionary %r ، نادیده گرفته می‌شود (برای تعیین تک تک عناصر %r را به کار ببرید)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "شماره نامعتبر %r برای پیکربندی مقدار %r، نادیده گرفته می‌شود" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "امکان لغو تنظیمات پیکربندی %r با نوع پشتیبانی نشده نبود، نادیده گرفته می‌شود" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "مقدار پیکربندی ناشناخته %r در ابطال، نادیده گرفته شد" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "چنین مقداری برای پیکربندی نبود: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "مقدار پیکربندی %r از قبل موجود است" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "خطای نحوی در پرونده‌ی پیکربندی شما وجود دارد: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "پرونده‌ی پیکربندی (یا یکی از ماژول هایی که وارد می کند) sys.exit() را فراخواند" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "یک خطای قابل برنامه ریزی در پرونده‌ی پیکربندی شما وجود دارد:\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "مقدار پیکربندی 'source_suffix' انتظار یک رشته، لیست رشته ها، یا فرهنگ لغت را داشت. اما '%r' داده شده است." #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "بخش%s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "شکل %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "جدول %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "فهرست %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "مقدار پیکربندی '{name}' باید یکی از {candidates} باشد، اما '{current}' داده شده." #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "مقدار پیکربندی '{name}' دارای نوع '{current.__name__}' است، ولی انتظار می‌رفت {permitted} می‌بود." #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "مقدار پیکربندی '{name}' دارای نوع '{current.__name__}' است، حالت پیش‌فرض {permitted} است." #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "دامنه‌ی اصلی %r یافت نشد، نادیده گرفته می‌شوند." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "از زمان نسخه‌ی ۲ تا به حال، اسفیکنس به صورت پیش فرض از \"index\" به عنوان ریشه‌ی سند(root_doc) استفاده می‌کند. لطفاً \"root_doc = 'contents'\" را به پرونده conf.py تان اضافه کنید." #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "رویداد %r در حال حاضر موجود است" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "نوع اتفاق نامشخّص است: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "مدیر %r برای رویداد %r یک باعث ایراد شد" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "تنظیمات needs_extensions (نیازهای افزونه) افزونه‌ی %s را نیاز دارد، ولی بارگذاری نمی شود." #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "این پروژه افزونه‌ی %s (دست کم نسخه‌ی %s) را نیاز دارد، بنابراین نمی تواند با نسخه بارگذاری شده (%s) ساخته شود." #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "نام رنگ‌مایه خوان %r شناخته شده نیست" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "امکان خواندن قسمت \"%s\" به عنوان بخش نثل قول ادبی نبود. برجسته کردن آن نادیده گرفته شد." #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "برای سند \"%s\": %r پرونده های متعدد یافت شده \nاز %r برای ساخت استفاده کنید." #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "سند قابل خواندن نیست. نادیده گرفته شد." #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "کلاس سازنده %s هیچ ویژگی‌ای به عنوان \"name\" ندارد" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "سازنده %r در حال حاضر وجود دارد (در پیمانه‌ی %s)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "نام سازنده %s یا ثبت شده نیست و یا فقط از طریق نقطه ورود در دسترس است" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "نام سازنده %s ثبت نشده است" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "دامنه ی %sپیش تر ثبت شده" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "دامنه %s هنوز ثبت نشده است" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "دستورالعمل %r قبلاً برای دامنه %s ثبت شده" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "نقش %r قبلاً برای دامنه %s ثبت شده" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "شاخص %r قبلاً برای دامنه %s ثبت شده" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "نوع شیئ (object_type) %r قبلاً برای دامنه ثبت شده" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "ارجاع متقابل (crossref_type) %r قبلاً ثبت شده" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "پسوند (source_suffix) %r قبلاً ثبت شده است" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "تحلیل‌گر منبع (source_parser) %r قبلاً ثبت شده است" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "تجزیه کننده مبدإ برای %s ثبت نشده است" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "در حال حاضر برای %r مترجم وجود دارد" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "مؤلّفه‌های کلیدی برای تابع add_node() باید تاپل تابعی (بازدید، خروج) باشند: %r=%r" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "بست قابل شمارش (enumerable_node) %r قبلاً ثبت شده است" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "ترسیم‌گر ریاضی %s قبلاً ثبت شده" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "افزونه‌ی %r از نسخه‌ی %s اسفینکس به بعد، در آن ادغام شده؛ بنابراین نادیده گرفته می‌شود." #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "ایراد اصلی:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "امکان وارد کردن افزونه‌ی %s نبود" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "افزونه‌ی %r هیچ تابع setup()ی ندارد؛ آیا این مورد واقعاً یک پیمانه‌ی افزونه‌ی اسفینکس است؟" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "افزونه‌ی %s که در این پروژه استفاده شده دست کم نیازمند اسفینکس نسخه‌ی %s است؛ بنابراین با این نسخه قابل ساخت نیست." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "افزونه‌ی %r شیئ پشتیبانی نشده‌‌ای از تابع setup()ش برگرداند؛ در حالی که می بایست مقدار تهی/هیچ و یا یک دیکشنری فراداده‌ برمی‌گرداند" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "زمینه ی %r فاقد تنظیمات است" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "زمینه‌ی %r تنظیمات به ارث بری ندارد" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "هیچ زمینه‌ای به نام %r پیدا نشد، که با %r جایگزین شود" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "تنظیمات %s. %s در هیچ یک از پیکربندی‌های جستجو شده رخ نمی‌دهد" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "گزینه‌ی پشتیبانی نشده‌ی زمینه %r داده شده" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "پرونده‌ی %r که مسیر زمینه به آن اشاره دارد یا پرونده زیپ معتبری نیست یا هیچ زمینه‌ای درونش ندارد" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "زمینه‌ی خواندن مستندات اسفینکس (< 0.3.0) پیدا شد. از نسخه‌ی ۶/۰ اسفینکس این زمینه‌ دیگر در دسترس نخواهد بود" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "هیچ زمینه‌ای با نام %r پیدا نشد(آیا پرونده theme.conf گم شده؟)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "تصویر مناسبی برای سازنده‌ی %s پیدا نشد: %s (%s)" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "تصویر مناسبی برای سازنده‌ی %s پیدا نشد: %s" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "ساخت پرونده‌ی [mo]: " #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "نوشتن برون‌داد... " #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "همه‌ی پرونده‌های %d po" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "اهداف برای %d پرونده‌های poی که مشخّص شده" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "مقصد‌های %d پرونده‌های poی هستند که منسوخ شده‌اند" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "همه‌ی پرونده‌های منبع" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "پرونده‌ی %r که در خط فرمان داده شده، در شاخه‌ی منبع نیست, نادیده گرفته می‌شود" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "پرونده‌ی %r که در خط فرمان داده شده، وجود ندارد، نادیده گرفته می‌شود" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "پرونده‌های منبع %d داده شده در خط فرمان" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "مقصد‌های %d پرونده‌های منبعی هستند که منسوخ شده‌اند" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "ساخت [%s]: " #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "در پی پرونده‌هایی که الآن منسوخ هستند... " #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "%d تا مورد پیدا شد" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "چیزی پیدا نشد" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "بارگذاری محیط pickle شده" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "بررسی ثبات" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "هیچ مقدار تاریخ منسوخ نیست." #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "به روز رسانی محیط: " #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "%s اضافه شد، %s تغییر کرد، %s حذف شد" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "خواندن منبع‌ها... " #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "در انتظار برای ابزارهای کارگر..." #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "نام مستندات برای نوشتن: %s" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "آماده سازی اسناد" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "عنوان تکراری در فهرست مطالب پیدا شد:%s" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "در حال رونوشت از تصاویر... " #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "امکان خواندن پرونده‌ی تصویری %r نبود: در عوض کپی می‌شود" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "نمی تواند پرونده‌ی تصویر %r: %s را کپی کند" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "نمی تواند پرونده‌ی تصویری %r: %s را بنویسد" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "Pillow پیدا نشد- رونوشت برداشتن از پرونده‌های تصویری" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "نوشتن پرونده‌های نوع رسانه..." #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "نوشتن پرونده META-INF/container.xml..." #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "نوشتن پرونده‌ی content.opf..." #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "نوع رسانه‌ی ناشناخته %s، نادیده گرفته شد" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "نوشتن پرونده‌ی خلاصه toc.ncx..." #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "نوشتن پرونده‌ی %s..." #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "پرونده‌ی بازبینی در پوشه‌ی %(outdir)s است." #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "بدون تغییرات در نسخه‌ی %s." #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "نوشتن پرونده‌ی خلاصه..." #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "درونی سازی" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "در سطح ماژول" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "رونوشت از پرونده‌های مبدأ..." #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "نمی‌توان %r را برای ایجاد گزارش تغییرات خواند" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "سازنده‌ی بدلی هیچ پرونده‌ای تولید نمی کند." #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "پرونده‌ی ePub در پوشه‌ی %(outdir)s است." #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "نوشتن پرونده‌ی nav.xhtml..." #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "مقدار پیکربندی زبان پرونده epub (\"epub_language\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "مقدار پیکربندی شناسه‌ی یکتای انتشار الکترونیکی (\"epub_uid\") باید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) یک XML NAME باشد" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "مقدار پیکربندی عنوان (\"html_title\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "مقدار پیکربندی مؤلّف (\"epub_author\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "مقدار پیکربندی حامی (\"epub_contributor\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "مقدار پیکربندی توضیحات (\"epub_description\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "مقدار پیکربندی ناشر (\"epub_publisher\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "مقدار پیکربندی حق انتشار (\"epub_copyright\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "مقدار پیکربندی شناسه (\"epub_identifier\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "مقدار پیکربندی ویراست (\"version\") نباید برای نسخه‌ی سوم پرونده‌های انتشار الکترونیک(EPUB3) خالی باشد" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "پرونده‌ی css نامعتبر%r: نادیده گرفته می‌شود" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "سیاهه‌های پیام‌ها در %(outdir)s است." #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "مقصد‌های قالب پرونده‌های %d" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "خواندن قالب‌ها... " #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "نوشتن سیاهه‌های پیام... " #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "به دنبال هر یک از خطاهای بالا در یا در برون‌داد و یا در %(outdir)s/output.txt بگردید" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "پیوند خراب: %s (%s)" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "مهار '%s' پیدا نشد" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "شکست در گردآوری عبارات باقاعده در linkcheck_allowed_redirects: %r %s" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "صفحات راهنما در %(outdir)s است." #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "هیچ مقداری برای تنظیمات «صفحات راهنما» ا نشد؛ بنابراین هیچ صفحه‌ی راهنمایی نوشته نخواهد شد" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "در حال نوشتن" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "پیکربندی مقدارهای «صفحات راهنما» به سند ناشناخته‌ای ارجاع می‌دهند %s" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "صفحه HTML در %(outdir)s است." #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "سر جمع کرد تک سند" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "نوشتن پرونده‌های اضافی" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "پرونده‌ی اطّلاعات متن در پوشه‌ی %(outdir)s است." #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "\nدر آن شاخه فرمان 'make' را اجرا کنید تا این‌ها رh با makeinfo اجرا کند\n(برای انجام خودکار `make info' را به کار ببرید)." #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "هیچ تنظیماتی برای «صفحات راهنما» پیدا نشد؛ بنابراین هیچ صفحه‌ی راهنمایی نوشته نخواهد شد" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "مقدار پیکربندی اطّلاعات متن سندها (texinfo_documents) به سند ناشناخته‌ی %s ارجاع می‌دهد" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "در حال پردازش %s" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "حل ارجاع‌ها..." #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (در " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "رونوشت از پرونده‌های با پشتیبانی اطلاعات متن" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "خطای نوشتن پرونده‌ی ساخت (Makefile) : %s" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "پرونده‌ی متنی در پوشه‌ی %(outdir)s است." #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "خطای نوشتن پرونده: %s, %s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "پرونده‌ی XML در پوشه‌ی %(outdir)s است." #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "پرونده‌های شبه XML در پوشه‌ی %(outdir)s." #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "پرونده‌ی اطّلاعات ساخت خراب است: %r" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "صفحات HTML در %(outdir)s است." #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "شکست در خواندن پرونده‌ی اطّلاعات ساخت: %r" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "فهرست کلی" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "فهرست" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "بعدی" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "قبلی" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "تولید نمایه‌ها" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "نوشتن صفحات اضافی" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "رونوشت از پرونده‌های قابل دریافت... " #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "نمی تواند از پرونده‌ی قابل دریافت %r: %s رونوشت بگیرد" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "شکست در رونوشت یک پرونده‌ی به html_static_file: %s: %r" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "رونوشت از پرونده‌های ثابت" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "نمی تواند از پرونده‌ی ثابت %r رونوشت بگیرد" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "رونوشت برداری از پرونده‌های اضافی" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "نمی تواند از پرونده‌ی اضافه‌ی %r رونوشت بگیرد" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "شکست در نوشتن پرونده‌ی اطّلاعات ساخت: %r" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "نمایه‌ی جستجو نمی‌تواند بارگزاری شود، ولی برای همه‌ی مستندات ساخته‌ نمی‌شود: نمایه‌ ناقص خواهد بود." #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "صفحه‌ی %s با دو الگو در نوار کناری صفحه (html_sidebars) هم‌خوانی دارد: %r و%r" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "هنگام ارائه‌ی صفحه‌ی %s خطای یونیکد رخ داد. لطفاً اطمینان حاصل کنید که تمام مقدارهای پیکربندی‌ها دارای محتوای غیر اَسکی، رشته‌متن‌های یونکد هستند." #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "خطایی در نمایش صفحه‌ی %s رخ داد.\nعلّت: %r" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "خالی کردن فهرست اشیاء" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "خالی کردن نمایه‌ی جستجو در %s" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "پرونده‌ی js نامعتبر%r: نادیده گرفته می‌شود" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "ارا‌ئه کننده‌های ریاضی زیادی ثبت شده‌اند، ولی هیچ کدام انتخاب نشده." #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "نمایش‌دهنده‌ی ریاضی نامشخّص %r داده شده." #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "مدخل مسیر اضافی (html_extra_path) %r وجود ندارد" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "مدخل مسیر اضافی (html_extra_path) %r درون شاخه‌ی خارجی قرار دارد" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "مدخل مسیر ثابت (html_static_path) %r وجود ندارد" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "مدخل مسیر ثابت (html_static_path) %r درون شاخه‌ی خارجی قرار دارد" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "پرونده‌ی آرم %r وجود ندارد" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "پرونده‌ی آیکون مورد علاقه %r وجود ندارد" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "از نسخه‌ی ۳.۵.۰ به بعد افزودن پیوند همیشگی (html_add_permalinks) منسوخ شده. لطفاً از به جایش html_permalinks و html_permalinks_icon را به کار ببرید." #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "مستندات %s%s" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "پرونده‌ی LaTeX در پوشه‌ی %(outdir)s است." #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\nدر آن شاخه فرمان 'make' را اجرا کنید تا این‌ها را با لتکس(pdf) اجرا کند\n(برای انجام خودکار `make latexpdf' را به کار ببرید)." #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "هیچ مقدار پیکربندی اسناد لتکسی (latex_documents) پیدا نشد؛ بنابراین هیچ سندی نوشته نخواهد شد" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "مقدار پیکربندی سندهای لتکس (latex_documents) به سند ناشناخته‌ی %s ارجاع می‌دهد" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "فهرست" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "انتشار" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "بدون گزینه‌ی Babel شناخته شده برای زبان %r" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "رونوشت از پرونده‌های پشتیبانی لتکس" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "رونوشت از پرونده‌های پشتیبانی لتکس..." #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "رونوشت برداری از پرونده‌های اضافی" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "کلید پیکربندی ناشناخته: latex_elements[%r]، نادیده گرفته می‌شود." #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "کلید زمینه‌ی ناشناخته: latex_theme_options[%r]، نادیده گرفته می‌شود." #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "%r فاقد تنظیمات زمینه است" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "%r فاقد تنظیمات \"%s\" است" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "در حین ساخت ایرادی رخ داد، شروع اشکال زدا:" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "قطع شد!" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "خطای نشانه‌گذاری متن بازساختمند (reST)" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "خطای کدگذاری نویسه:" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "اگر می‌‌خواهید مشکل را به توسعه‌دهندگان گزارش دهید، ردیابی کامل خطا در %s ذخیره شده است." #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "خطای بازگشتی:" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "این اتّفاق ممکن است برای پرونده‌های بسیار تو در توی منبع بیافتد. شما می‌توانید محدودیّت ۱۰۰۰ تایی مقدار پیش‌فرض اجرای بازگشت پایتون را در conf.py زیاد کنید، مثلاً با:" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "ایراد رخ داد:" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "لطفاً اگر این مورد خطای کاربر بوده، آن را گزارش دهید تا برای بارهای بعدی پیام خطای بهتری بتواند ارائه شود." #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "گزارش اشکال می تواند در ردیاب در مسیر <https://github.com/sphinx-doc/sphinx/issues> ثبت شود. با سپاس!" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "شماره‌ی کار باید یک عدد مثبت باشد" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "برای اطّلاعات بیشتر به <https://www.sphinx-doc.org/> بروید." #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "\nایجاد مستندات از پرونده‌های مبدأ.\n\nسازنده‌ی اسفنکس مستندات را از روی پرونده های مبنع در پوشه‌‌ی منبع تولید کرده در پوشه‌ی برون‌داد قرار می‌دهد.\nاین سازنده در پوشه‌ی مبدأ به دنبال پرونده 'conf.py' تنظیمات پیکربندی می‌گردد.\nاین امکان وجود دارد که از ابزار شروع سریع اسفینکس ('sphinx-quickstart') برای تولید پرونده‌های قالب، که شامل پرونده 'conf.py' هم می‌شود استفاده شود.\n\nسازنده‌ی اسفینکس می توند مستندات را در قالب‌های گوناگونی از پرونده‌های خروجی ایجاد کند. قالب پرونده خروجی با مشخّص کردن نام سازنده در خط فرمان مشخّص می‌شود که به صورت پیش فرض HTML است. همچنین، سازنده‌ها می‌توانند کارهای دیگر مربوط به فرآیند پردازش مستندسازی را انجام دهند.\n\nبه صورت پیش فرض، هر چیزی که منسوخ شده باشد تولید می‌شود. برون‌داد برای پرونده‌های منتخب می‌تواند فقط با مشخّص کردن نام تک تک پرونده‌ها ساخته شود.\n" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "مسیر پرونده‌های مستندات" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "مسیری برای شاخه‌ی برون داد" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "لیست پرونده‌هایی که قرار است دوباره ساخته شوند. اگر با -a مشخّص شده باشند نادیده گرفته می‌شوند" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "گزینه‌های کلی" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "قالب سازنده مورد استفاده (پیش‌فرض:html)" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "نوشتن همه‌ی پرونده‌ها (پیش‌گزیده: فقط پرونده‌های جدید نو تغییر یافته را بنویس)" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "از محیط ذخیره شده استفاده نکن، همیشه همه پرونده ها را بخوان" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "مسیر برای محیط ذخیره‌ شده و پرونده‌های doctree (پیش فرض: OUTPUTDIR /.doctrees)" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "درصورت امکان ساخت به صورت موازی با N فرآیند پردازشی (مقدار ویژه‌ی «خودکار» شمار N را به تعداد پردازنده تنظیم می‌کند)" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "مسیر جایی که پرونده‌ی پیکربندی (conf.py) قرار دارد ( پیش‌گزیده: مثل پوشه‌ی منبع)" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "هیچ پرونده‌ی پیکربندی‌ای استفاده نکن، فقط گزینه‌ی -D" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "نادیده گرفتن تنظیماتی در پرونده‌ی پیکره‌بندی" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "مقداری را به قالب‌های HTML بدهید" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "تعریف برچسب: «فقط» تکّه‌های با برچسب گنجانده شود" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "حالت ریزبینانه، هشدار درباره‌ی همه‌ی ارجاع‌های ناپیدا" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "گزنیه‌های برون‌داد میز فرمان" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "افزایش ارائه‌ی جزئیّات (می تواند تکرار شود)" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "بدون برون‌داد در درگاه خروجی استاندارد(stdout)، فقط هشدارها در درگاه استاندارد خطاها (stderr)" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "بدون هیچ برون‌داد، حتّی بدون هشدار" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "خروجی رنگ شده منتشر شود (پیش‌فرض: تشخیص خودکار)" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "خروجی رنگ شده منتشر نشود (پیش‌فرض: تشخیص خودکار)" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "نوشتن هشدارها (و خطاها) در پرونده‌ی داده شده" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "تغییر هشدارها به خطاها" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "با سوییچ -W، در هنگام گرفتن هشدار ادامه بده" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "نمایش گزارش کامل ردیابی ایراد" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "ایراد در اجرای Pdb" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "پرونده‌های %r پیدا نشدند" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "نمی توان گزینه‌ی -a را با نام پرونده‌ها ترکیب کرد" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "امکان باز کردن پرونده هشدار نبود %r: %s" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "نشانوند گزینه‌ی D- می‌بایست در قالب نام=مقدار (name=value) باشد" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "نشانوند گزینه‌ی A- می‌بایست در قالب نام=مقدار (name=value) باشد" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "درج خودکار رشته‌مستندات را از پیمانه‌ها" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "آزمایش خودکار تکّه‌کدها در قسمت‌های مختلف پیمانه‌ی doctest" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "پیوند بین اسناد Sphinx از پروژه های گوناگون" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "نوشتن مدخل‌های لیست اقدام‌ها (\"todo\")که در ساخت می تواند نشان داده و یا پنهان شوند" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "بررسی برای پوشش اسناد" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "گنجاندن رابطه‌های ریاضی که در قالب PNG یا SVG به نمایش در آمده" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "گنجاندن رابطه‌های ریاضی که MathJax در مرورگر نمایش در آورده" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "گنجاندن شرطی محتوا بر اساس مقادیر پیکربندی" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "گنجاندن ویندهای کد منبع اشیاء مستند شده‌ی پایتون" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "ساخت پرونده‌ی nojekyll برای انتشار سند در صفحات گیت-هاب" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "لطفاً نام مسیر معتبری را وارد کنید." #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "لطفاً متنی وارد کنید." #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "لطفاً یکی از %s وارد کنید." #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "لطفاً یا y و یا n وارد کنید." #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "لطفاً یک پسوند را وارد کنید، مثل: '.rst' یا '.txt'." #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "به ابزار شروع سریع اسفینکس %s خوش آمدید." #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "لطفاً مقدارهای تنظیمات زیر را وارد کنید\n(اگر مقدار پیش‌گزیده‌ای درون داده کروشه شده بود، برای برای پذیرش آن فقط کلید Enter‌را فشار دهید)." #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "مسیر برگزیده‌ی ریشه‌ی مستندات: %s" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "مسیر ریشه‌ی مستندات را وارد کنید." #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "مسیر ریشه‌ی مستندات" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "خطا: در مسیر ریشه‌ی انتخاب شده‌، پرونده‌ی conf.pyی دیگری یپدا شد." #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "ابراز شروع سریع اسفینکس روی پروژه‌های از قبل موجود اسفینکس بازنویسی نمی‌کند." #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "لطفاً یک مسیر ریشه‌ی جدید وارد کنید (یا برای خروج Enter‌ را بزنید)" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "شما برای تعیین شاخه‌ی ساخت برای برون‌داد اسفینکس دو گزینه دارید.\nیا از شاخه‌ای با نام \"_build\" درون شاخه‌ی ریشه استفاده کنید،\nو یا شاخه‌های را درون یک مسیر ریشه با نام‌های منبع (source) و ساخت (build) جدا کنید." #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "شاخه‌های منبع و ساخت از یکدیگر جدا شوند؟(y/n)" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "درون شاخه‌ی ریشه، دو شاخه‌ی دیگر ساخته خواهد شد؛\n\"_templates\" برای قالب‌های سفارشی HTML و \"_static\" برای قالب برگه‌ها و بقیّه‌ی پرونده‌های ثابت.\nشما می‌توانید پیشوند دیگری (مانند «.») برای جایگزینی نویسه‌ی خط به کار ببرید." #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "برای شاخه‌های قالب‌ها (templates) و ثابت‌ها (static) نویسه‌ی پیشوندی را بنویسید" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "نام پروژه در چندین جا در سند ساخته شده به کار می‌رود." #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "نام پروژه" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "نام نویسنده (ها)" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "اسفینکس نظریّه‌ای برای یک «نسخه» و یک «نگارش» برای نرم افزار دارد.\nهر نسخه‌ای می تواند چندید نگارش داشته باشد.\n مثلاً برای پایتون نسخه‌ چیزی شبیه به ۲/۵ یا ۳/۰ است،\n در حالی که انتشار چیزیست شبیه به ۲/۵/۱ یا ۳/۰a۱ \n.\nاگر شما نیازی به این ساختار دوگانه ندارید، هر دو را یکی تعیین کنید." #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "نسخه انتشار پروژه" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "انتشار پروژه" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "اگر مستندات قرار است با زبانی غیر از انگلیسی نوشته شود،\nمی توانید همین‌جا یک زبان را با انتخاب کد زبانیش انتخاب کنید.\nاسفینکس سپس متن‌هایی را که تولید می‌کند را به آن زبان ترجمه می‌کند.\n\nبرای فهرست زبان‌های پشتیبانی شده، به این نشانی مراجعه کنید\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "زبان پروژه" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "پسوند نام پرونده برای پرونده‌های منبع. معمولاً این پسوند یا \".txt\" است و یا \".rst\".\nفقط پرونده‌هایی بای این پسوند به عنوان اسناد در نظر گرفته می‌شوند." #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "پسوند پرونده‌ی منبع" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "یک سند از آن جهت خاص است که به عنوان بست بالایی «درختواره‌ی محتوا» در نظر گرفته می‌شود.\nیعنی، این سند ریشه‌ی ساختار سلسله مراتبی اسناد است.\nمعمولاً سند این کار «نمایه» است، ولی اگر سند «نمایه‌»‌ی شما قالب سفارشی است؛ می توانید آن را به نام دیگری تغییر دهید." #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "نام سند اصلی شما (بدون پسوند)" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "خطا: پرونده‌ی اصلی %s از قبل در مسیر ریشه‌ی برگزیده بوده‌است." #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "ابراز شروع سریع اسفینکس روی پرونده‌های از قبل موجود بازنویسی نمی‌کند." #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "لطفاُ یک نام جدید وارد کنید، یا نام پرونده‌ی موجود را تغییر دهید و Enter‌ را فشار دهید" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "مشخّص کنید کدام یک از این افزونه‌های اسفینکس باید فعّال باشد:" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "یادداشت: ابزارهای‌ imgmath و mathjax نمی‌توانند در یک زمان فعّال باشند. انتخاب imgmath لغو شد." #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "پرونده‌های خط‌فرمان ویندوز و Makefile می‌توانند برای شما تولید شوند، به گونه‌ای که شما فقط نیاز باشد تا مثلاً فرمان `make html' را به جای فراخوان مستقیم ابزار ساخت اسفینکس اجرا کنید." #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "آیا پرونده‌ی‌ make ایجاد شود؟ (y/n)" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "آیا پرونده‌ی خط فرمان ویندوز ساخته شود؟ (y/n)ٍ" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "ایجاد پرونده‌ی %s." #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "پرونده‌ی %s در حال حاضر وجود دارد، رد شدن." #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "پایان یافت: ساختار آغازین شاخه ایجاد شد." #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "شما باید حالا دیگر پرونده‌ی اصلی‌تان %s را جمع آوری کنید\n و بقیّه‌ی پرونده‌های منبع مستندات را ایجاد کنید. " #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "از Makefile برای ساختن مستندات استفاده کنید، مانند این:\n make builder" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "از فرمان ساخت اسفینکس برای ساختن مستندات استفاده کنید، مانند این:\n sphinx-build -b builder %s %s" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "که در آن سازنده یکی از سازنده‌های پشتیبانی شده است، مانند html, latex و یا linkcheck." #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "\nتولید پرونده‌های مورد نیاز برای یک پروژه‌ی اسفینکس\n\nابزار شروع سریع اسفینکس ابزاری تعاملی است که شماری سؤال درباره‌ی پروژه‌یتان از شما می پرسد\nو سپس یک شاخه‌ی کامل مستندات و پرونده ساخت Makefile را برای استفاده به همراه ابزار ساخت اسفینکس تولید می‌کند.\n" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "حالت سکوت" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "ریشه‌ی پروژه" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "گزینه‌های ساختار" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "در صورتی مشخّص شدن، شاخه‌های منبع و ساخت از یکدیگر جدا می‌شوند" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "در صورت مشخّص بودن، شاخه‌ی build (ساخت) را درون شاخه‌ی منبع بساز" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "جایگزینی نقطه در _templates (قالب‌ها) و ... ." #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "گزینه‌های اساسی پروژه" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "نام پروژه" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "نام نویسندگان" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "نسخه انتشار پروژه" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "انتشار پروژه" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "زبان سند" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "پسوند پرونده‌ی منبع" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "نام سند اصلی" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "استفاده epub" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "گزینه‌های افزونه" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "فعّال‌سازی %s افزونه" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "فعّال‌سازی افزونه‌های اختیاری" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "ایجاد Makefile و Batchfile" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "ایجاد پرونده‌ی سازنده (makefile)" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "پرونده‌ی سازنده (makefile) را ایجاد نکن" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "ایجاد Batchfile" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "batchfile را ایجاد نکن" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "اسفتاده از حالت ایجاد برای پرونده‌های Makefile/make.bat" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "عدم اسفتاده از حالت ایجاد برای پرونده‌های Makefile/make.bat" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "قالب سازی پروژه" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "شاخه‌ی قالب شامل پرونده‌های قالب" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "تعریف متغیّر قالب" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "حالت «ساکت» تعیین شده، ولی یکی از موارد «پروژه» یا «نویسنده» مشخّص نشده." #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "خطا: مسیر مشخّص شده پوشه نیست، یا از قبل پرونده‌های اسفینکس وجود داشته‌اند." #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "ابزار شروع سریع اسفینکس فقط یک پوشه‌ی خالی درست می کند. لطفاً یک مسیر ریشه‌ی جدید مشخّص کنید." #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "متغیرهای نامعتبرقالب؛ %s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "غیرفاصله‌ در فرآیند حذف فاصله‌ از ابتدای سطر حذف شد" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "برچسب نامعتبر:%s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "شماره‌ی سطر مشخّص شده خارج از بازه‌ی (1-%d) است: %r" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "امکان استفاده از هر دوی %sو%s نیست" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "پرونده‌ی گنجانده شده %r یا پیدا نشد و یا خواندن آن شکست خورد" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "کدگذاری %r که باری خواندن پرونده‌ی گنجانده شده‌ی %r اسفتاده شده به نظر می رسد اشتباه باشد، استفاده از گزینه‌ی کدگذاری ( :encoding:) را امتحان کنید" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "شیئ با نام %r در پرونده‌ی %r پیدا نشد" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "امکان استفاده‌ی گزینه‌ی «هم‌خوان شماره‌ی سطر» (lineno-match) با مجموعه‌ی سطرهای گسیخته وجود ندارد" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "سطر مشخّص شده %r: هیچ سطری از پرونده‌ی گنجانده شده %r بیرون کشیده نشده" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "نویسنده این بخش: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "نویسنده این ماژول: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "نویسنده ی کد: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "نویسنده: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "گزینه‌ی \":file:\" برای دستورالمعل جدول داده‌های جداشده با کاما (csv-table) حالا دیگر مسیر ثابت را یک مسیر نسبی از شاخه‌ی منبع در نظر می گیرد. لطفاُ سندتان را به روز رسانی کنید." #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "اعلان C تکراری، که در %s:%s هم تعریف شده.\nاعلان '.. c:%s:: %s' است." #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "%s (C %s)" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "پارامترها" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "بازگشت ها" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "نوع برگشتی" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "عضو" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "متغیّر" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "تابع" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "ماکرو" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "ساختار" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "اجتماع" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "شمارش" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "شمارنده" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "گونه" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "مؤلّفه‌ی تابع" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "جدید در نسخه %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "تغییر داده شده در نسخه %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "منسوخ شده از نسخه %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "نقل‌قول %s تکراری، مورد دیگر در %s قرار دارد" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "نقل [%s] قول ارجاع داده نشده." #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "اعلان ++C تکراری، که در %s:%s هم تعریف شده.\nاعلان '.. cpp:%s:: %s' است." #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "پارامترهای قالب" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "ایجاد" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "کلاس" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "کانسپت" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "مؤلّفه‌ی قالب" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (توابع درونی)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s متد)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s (کلاس)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (متغیّر عمومی یا مقدار ثابت)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s مشخصه)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "نشانوندها" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (ماژول)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "متد" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "داده" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "مشخّصه" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "ماژول" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "توضیح %s تکراری از %s، مورد دیگر%s در %s قرار دارد" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "بر چسب معادله ی %s تکرار است، مورد دیگر در %s قرار دارد" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "قالب مرجع معادله‌‌ی ریاضی (math_eqref_format) نامعتبر: %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "کلمه کلیدی" #: sphinx/domains/python.py:60 msgid "operator" msgstr "عملگر" #: sphinx/domains/python.py:61 msgid "object" msgstr "شیء" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "ایراد" #: sphinx/domains/python.py:63 msgid "statement" msgstr "گذاره" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "توابع درونی" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "متغیر ها" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "برانگیختن" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (در ماژول %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (در ماژول %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (متغیر درونی)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (کلاس درونی)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (کلاس در %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s شگرد کلاس)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "%s(%sویژگی)" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s متد استاتیک)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "نمایه ی ماژول های پایتون" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "ماژول ها" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "منسوخ شده" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "class method" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "متد استاتیک" #: sphinx/domains/python.py:1176 msgid "property" msgstr "ویژگی" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "توضیح تکراری شیئ %s، نمونه‌ی دیگر در %s قرار دارد، برای یک مورد از :noindex: استفاده کنید" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "برای ارجاع متقابل %r بیش از یک هدف پیدا شد: %s" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (منسوخ)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (دستورالمعل)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "%s (گزینه‌ی دستورالمعل)" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (نقش)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "دستورالمعل" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "گزینه‌ی دستورالمعل" #: sphinx/domains/rst.py:210 msgid "role" msgstr "نقش" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "توضیح تکراری از %s %s، مورد دیگر در %s قرار دارد" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "متغیرهای عمومی؛ %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "توضیح بدشکل برای گزینه‌ی %r، باید شبیه این‌ها باشد \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" یا \"+opt args\"" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "%s گزینه‌ی خط فرمان" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "گزینه خط فرمان" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "یک خط خالی باید پیش از اصطلاح واژه‌نامه باشد" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "اصطلاحات واژه‌نامه نباید با خطوط خالی از هم جدا شوند" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "به نظر می رسد واژه‌نامه اشتباه شکل داده شده است، فاصله‌گذاری از ابتدای سطر را بررسی کنید" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "اصطلاح واژه‌نامه" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "نشانه ی گرامری" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "برچسب ارجاع" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "متغیّر عمومی" #: sphinx/domains/std.py:568 msgid "program option" msgstr "اختیارات برنامه" #: sphinx/domains/std.py:569 msgid "document" msgstr "سند" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "فهرست ماژول ها" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "صفحه جستجو" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "بر چسب تکراری %s، مورد دیگر در %s قرار دارد" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "تکرار توضیح %s از %s، مورد دیگر در%s قرار دارد" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "شماره‌ی شکل غیر فعّال است. گزینه‌ی :numref: نادیده گرفته می‌شود." #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "شکست در ایجاد ارجاع متقابل. هیچ شماره انتساب داده نشده: %s" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "پیوند هیچ برچسبی ندارد: %s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "قالب شماره‌ی شکل نامعتبر: %s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "قالب شماره‌ی شکل نامعتبر: %s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "برچشب تعریف نشده: %s" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "شکست در ایجاد ارجاع متقابل. عنوان یا زیرنویس پیدا نشد: %s" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "پیکربندی جدید" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "پیکربندی تغییر داده شد" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "افزونه‌ها تغییر کردند" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "نسخه‌ی محیط ساخت به‌روز نیست" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "شاخه ی منبع تغییر کرد" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "این محیط با سازنده‌ی انتخاب شده سازگار نیست، لطفاً یک خوشه‌ی اسناد دیگری را انتخاب کنید." #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "پویش اسناد %s: %r شکست خورد" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "دامنه ی %r ثبت نشده" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "درختواره‌ی فهرست مطالب با ارجاع به خود پیدا شده. نادیده گرفته می‌شود." #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "سند در هیچ درختواره‌ی فهرست مطالبی گنجانده نشده" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "%s را ببینید" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "%s را هم ببینید" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "نوع ناشناخته مدخل نمایه %r" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "نماد ها" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "دور تسلسل در درختواره‌ی ارجاعات فهرست مطالب تشخیص داده شده، نادیده گرفته می‌شوند: %s <- %s" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "فهرست مطالب دارای ارجاع به سند %r است که عنوانی ندارد: هیچ پیوندی تولید نخواهد شد" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "درختواره‌ی فهرست مطالب ارجاعی به سند کنار گذاشته شده %r را دارد" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "فهرست مطالب شامل ارجاع به سند ناموجود %r است" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "پرونده‌ی تصویر خوانا نیست: %s" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "پرونده‌ی عکس %s خوانا نیست: %s" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "پرونده‌ی دریافت شده خوانا نیست: %s" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "شماره‌ی قسمت‌ها پیش‌تر به %s نسبت داده شده ( آیا درختواره‌ی فهرست مطالب شماره‌گذاری تو در تو دارد؟)" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "پرونده‌ی %s را می سازد." #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "\nبه صورت بازگشتی در مسیر <MODULE_PATH> دنبال پیمانه‌هاو بسته‌های پایتون بگرد و \nبا به ازای دستورالمعل‌های خودکار پیمانه‌ی هر بسته در مسیر خروجی <OUTPUT_PATH> یک پرونده‌ی reST بساز.\n\nالگوی استثتاء های <EXCLUDE_PATTERN> می‌تواند الگوی پرونده‌ها و یا شاخه‌هایی باشد که از تولید کنار گذاشته شده‌اند.\n\nتوجّه: به صورت پیش فرض این اسکریپت روی پرونده‌های از پیش ساخته شده دوباره نویسی نمی‌کند." #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "مسیر پیمانه به سند" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "الگوها‌ی به سبک fnmatch در پرونده و یا شاخه برای کنار گذاشتن از تولید" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "پوشه‌ای برای قرار دادن همه‌ی برون دادها" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "نهایت عمق زیر پیمانه‌ها برای نشان دادن در فهرست مطالب (پیش‌گزیده: ۴)" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "بازنویسی پرونده‌های موجود" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "ردگیری پیوند نمادین. وقتی با collective.recipe.omelette ترکیب می‌شود توانمند است." #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "اجرای اسکریپت بدون ساخت پرونده" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "قرار دادن مستندات هر پیمانه در صفحه‌ی خودش" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "در برداشتن پیمانه‌های «خصوصی»(_private)" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "نام پرونده فهرست مطالب (پیش‌گزیده: پیمانه‌ها)" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "پرونده‌ی فهرست مطالب را ایجاد نکن" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "برای بسته‌ها و پیمانه‌ها سربرگ نساز (مثلاً وقتی رشته‌متن‌های مستندات از قبل آن‌ها را داشته باشند)" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "قرار دادن مستندات پیمانه پیش از مستندات پیمانه‌ی زیرمجموعه‌‌اش" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "تفسیر مسیرهای پیمانه بر اساس ویژگی‌های ضمنی فضای نام‌ها در PEP -0420" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "پسوند پرونده ( پیش فرض: rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "تولید یک پروژه‌ی کامل با ابزار شروع سریع اسفینکس" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "پیوست مسیر پیمانه (module_path) به مسیر سیستم (sys.path)، هنگامی به کار می‌رود که گزینه‌ی full-- داده شود" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "نام پروژه (پیش‌گزیده: نام پیمانه‌ی ریشه)" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "نویسنده(های) پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "نسخه‌ی پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "نگارش پروژه، وقتی که گزینه‌ی --full داده شده باشد استفاده می شود، پیش‌گزیده همان شماره‌ی نسخه (--doc-version) است" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "گزینه های افزونه" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s شاخه نیست." #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "عبارت باقاعده‌ی نامعتبر %r در %s" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "آزمودن پوشش منابع پایان یافت، به نتایج در %(outdir)spython.txt نگاهی بیاندازید." #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "عبارات باقاعده‌ی نامعتبر %r در پوشش عبارت باقاعده‌ی زبان سی (coverage_c_regexes)" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "رابط برنامه‌نویسی مستند نشده‌ی C: %s [%s] در پرونده‌ی %s" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "امکان وارد کردن پیمانه‎ی %s نبود: %s" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "تابع پایتونی بدون مستندات: %s :: %s" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "کلاس مستندسازی نشده‌ی پایتون: %s :: %s" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "شگرد مستندسازی نشده‌ی پایتون: %s :: %s :: %s" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "فاقد «+» یا «-» در گزینه‌ی '%s'." #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "\"%s\" یک گزینه‌ی معتبر نیست." #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "'%s' یک گزینه‌ی معتبر نسخه‌ی پایتون (pyversion) نیست" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "نوع TestCode نامعتبر" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "آزمایش مستندات منابع به پایان رسید، به نتایج در %(outdir)s/output.txt نگاهی بیاندازید." #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "بدون کد/خروجی در تکّه‌ی %s در %s:%s" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "نادیده گرفتن کد پیمانه‌ی doctest : %r" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "====================== کند ترین زمان خواندن =======================" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "دستورالعمل Graphviz نمی تواند هم نشانوند محتوا را داشته باشد و هم نام پرونده" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "پرونده گنجانده شده‌ی خارجی Graphviz %r یا پیدا نشد و یا خواندنش با شکست رو به رو شد" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "نادیده گرفتن دستورالعمل «graphviz» بدون محتوا." #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot هیچ پرونده‌ی برون‌دادی تولید نکرد:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "فرمان dot %r نمی‌تواند اجرا شود (زیرا نیازمند برون‌داد graphviz است)، تنظیمات graphviz_dot را بررسی کنید" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot با خطایی از کار افتاد:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "قالب خروجی graphviz باید یکی از قالب های 'png' یا 'svg' باشد ولی %r است" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "کد دات: %r: %s" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[گراف:%s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[گراف:]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "فرمان تبدیل %r را نمی توان اجرا کرد، تنظیمات image_converter بررسی کنید: %s" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "تبدیل با خطایی از کار افتاد:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "فرمان تبدیل %r را نمی توان اجرا کرد، تنظیمات image_converter را بررسی کنید" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "فرمان لتکس %r را نمی توان اجرا کرد(برای نمایش ریاضی لازم است)، تنظیمات imgmath_latex را بررسی کنید" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "%sفرمان %r را نمی توان اجرا کرد(برای نمایش ریاضی لازم است)، تنظیمات imgmath_%s را بررسی کنید" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "نمایش لتکس: %r: %s" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "لتکس بین سطری: %r: %s" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "پیوند ثابت به این معادله" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "سیاهه‌ی بین اسفینکس جا به جایی را انجام داد: %s -> %s" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "بارگذاری سیاهه‌ی بین اسفینکس از %s..." #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "مشکلاتی در برخی از سیاهه‌ها به وجود آمد،ولی این مشکلات راه‌های جایگزین های داشته‌اند:" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "شکست در رسیدن به یکی از سیاهه‌ها به خاطر مشکلات زیر:" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(در %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(در %s )" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "شناساگر بین اسفینکس %r رشته‌متن نیست. نادیده گرفته شد" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "شکست در خواندن intersphinx_mapping[%s]، نادیده گرفته می‌شود: %r" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[منبع]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "در دست انجام" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "مدخل فهرست اقدام پیدا شد: %s" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<original entry>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(<original entry> در%s و سطر %d جای گرفته است.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "مدخل اصلی" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "برجسته کردن کد پیمانه... " #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[مستندات]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "کد ماژول" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>کد منبع برای %s </h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "بررسی اجمالی: کد ماژول" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1> همه‌ی پیمانه‌هایی که برایشان کد در دسترس است</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "مقدار نامعتبر برای گزینه‌ی ترتیب اعضا (member-order): %s" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "مقدار نامعتبر برای گزینه‌ی «از مستندات کلاس» class-doc-from:%s" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "امضای ناشناخته‌ برای %s (%r)" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "خطا در قالب بندی نشانوند برای %s: %s" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "ویژگی ناموجود %s در شیئ %s" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "مستندسازی خودکار: شکست در تشخیص %r برای مستندسازی، این ایراد به وجود آمد:\n%s" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "مشخّص نیست کدام پیمانه را برای مستندسازی خودکار فراخوان کند %r (سعی کنید دستورالعمل «module» یا «currentmodule» را در سند قرار دهید، یا یک نام واضح برای پیمانه ارائه دهید)" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "شیئ ساختگی شناسایی شد: %r" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "خطا در قالب بندی امضا برای %s: %s" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "\"::\" در پیمانه‌ی خودکار معنی نمی‌دهد" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "نشانوند‌های امضا یا یادداشت مقدار برگشتی داده شده برای پیمانه‌ی خودکار %s" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "__all__ باید لیستی از رشته‌متن ها باشد، نه %r (در پیمانه‌ی %s) -- __all__ نادیده گرفته می‌شود" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "ویژگی نایاب در گزینه‌ی :members: قید شده: پیمانه‌ی:%s، ویژگی %s" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "شکست در دریافت امضای تابع برای %s: مؤلّفه پیدا نشد: %s" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "شکست در دریافت امضای سازنده‌ی شیئ برای %s: مؤلّفه پیدا نشد: %s" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "پایه ها:%s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "نام جانشین %s" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "نام جانشین نوع متغیر(%s)" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "شکست در دریافت امضای شگرد برای %s: مؤلّفه پیدا نشد: %s" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "__slots__ نامعتبر در %sیدا شد و نادیده گرفته شد." #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "اعضای مستندسازی خودکار (autodoc_member_order) حالا دیگر ترتیب الفبایی «alphabetical» را به جای حالت منتسب به الفبا «alphabetic» می‌پذیرد. لطفاً تنظیمات خود را به روز رسانی کنید." #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "شکست در تحلیل مقدار پیش‌گزیده‌‌ی نشانوند برای %r: %s" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "شکست در به روز رسانی امضا برای %r: مؤلّفه پیدا نشد: %s" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "شکست در تحلیل نوع یادداشت برای %r: %s" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "ارجاعات خلاصه‌ی خودکار سند %r حذف کنار گذاشته. نادیده گرفته می‌شود." #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "خلاصه‌ی خودکار: خرده‌پرونده‌ی %r پیدا نشد. تنظیمات تولید خلاصه‌ی خودکار(autosummary_generate) را بررسی کنید." #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "خلاصه‌ی خودکار عنوان‌ٔار نیازمند گزینه‌ی :toctree: است، نادیده گرفته می‌شود." #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "خلاصه‌ی خودکار: فراخوان %s شکست خورد" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "شکست در تجزیه تحلیل نام %s" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "شکست در وارد کردن شیئ %s" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "تولید خلاصه خودکار: پرونده پیدا نشد: %s" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "خلاصه‌ی خودکار به طور داخلی پرونده‌های rst را ایجاد می‌کند. ولی پسوند منبع شما شامل rst نیست. نادیده گرفته می‌شود." #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "خلاصه‌ی خودکار: شکست در تشخیص %r برای مستندسازی، این ایراد به وجود آمد:\n%s" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[خلاصه‌ی خودکار] تولید خلاصه‌ی خودکار برای: %s" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "[خلاصه‌ی خودکار] نوشتن در %s" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "[خلاصه‌ی خودکار]: فراخوان %r: %s شکست خورد" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "\nتولید ReStructuredText با استفاده از دستورالعمل‌های خلاصه‌ی خودکار.\n\nخودکارساز اسفینکس رابط کابر پسندی برای sphinx.ext.autosummary.generate (پیمانه‌ی افزونه‌ی خلاصه‌ساز اسفنیکس) است.\nاین افزونه پرونده های متن reStructuredText را از دستورالعمل‌های خلاصه‌ی خودکاری تولید می‌کند که در پرونده‌های درون‌داد مشخّص شده قرار دارد.\n\nقالب دستورالعمل خلاصه‌ی خودکار درپیمانه‌ی افزونه‌ی خلاصه‌ی خودکار اسفنیکس (sphinx.ext.autosummary) مستند سازی شده می توان آن را با دستور زیر خواند::\n\n pydoc sphinx.ext.autosummary\n" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "پرونده‌های منبع برای تولید پرونده‌های rST" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "پوشه‌ای برای قرار دادن همه‌ی برون دادها در آن" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "پسوند پیش فرض برای پرونده‌ها (پیش‌فرض: %(default)s)" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "شاخه‌ی سفارشی قالب (پیش‌گزیده: %(default)s)" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "اجزای فراخوان شده‌ی سند (پیش‌گزیده: %(default)s)" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "نشانوندهای کلیدی" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "مثال" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "نمونه‎ها" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "یادداشت‌ها" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "مؤلّفه‌های دیگر" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "دریافت‌ها" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "منابع" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "هشدارها" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "فرآورده" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "مقدار نامعتبر تعیین شده (بدون کمانک انتهایی): %s" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "مقدار نامعتبر تعیین شده (بدون کمانک ابتدایی): %s" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "رشته‌متن ادبی ناقص (بدون علامت نقل‌قول انتهایی): %s" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "رشته‌متن ادبی ناقص (بدون علامت نقل‌قول ابتدایی): %s" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "دقت" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "ملاحظه" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "خطر" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "خطا" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "راهنمایی" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "مهم" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "توجه" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "همچنین ملاحظه نمائید" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "نکته" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "هشدار" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "ادامه از صفحه‌ی قبل" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "ادامه در صفحه‌ی بعد" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "غیر الفبایی" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "شماره ها" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "صفحه" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "فهرست عناوین" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "جستجو" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "برو" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "نمایش سورس" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "بررسی اجمالی" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "خوش آمدید! این" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "مستندات برای" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "آخرین بروزرسانی" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "ایندکس ها و جداول:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "فهرست کامل مطالب" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "فهرست تمامی بخش ها و زیر مجموعه ها" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "جستجو در این اسناد" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "فهرست کلی ماژول ها" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "دسترسی سریع به تمامی متدها" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "تمامی توابع ، کلاس ها ، اصطلاحات" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "فهرست – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "فهرست کامل در یک صفحه" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "فهرست صفحات بر اساس حروف" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "ممکن است سترگ باشد" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "ناوبری" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "جستجو در %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "درباره این مستندات" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "کپی رایت" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">حق نشر</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© حق نشر%(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "آخرین بروز رسانی در %(last_updated)s ." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "ایجاد شده با<a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s." #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "جستجو %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "موضوع قبلی" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "فصل قبلی" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "موضوع بعدی" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "فصل بعدی" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "لطفاً برای فعّال کردن کارکرد جستجو\nجاوا اسکریپت را فعّال کنید." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "در حال جستجو برای چندین واژه. فقط واژگانی را نشان می‌دهد که شامل این موارد باشد:\n همه‌ی کلمه‌ها." #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "جستجو" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "نتایج جستجو" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "جستجوی شما با هیچ سندی هم خوانی نداشت. لطفاً اطمینان حاصل کنید که همه ی واژه ها املای درستی دارند و دسته بندی های کافی را انتخاب کرده اید." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "جستجو سریع" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "صفحه فعلی" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "تغییرات در نسخه %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "لیست تولید شده خودکار از تغییرات در نسخه %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "تغییرات کتابخانه ایی" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API تغییرات" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "دگر تغییرات" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "پیوند ثابت به این سر مقاله" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "پیوند ثابت به این تعریف" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "عدم نمایش نتایج یافت شده" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "در حال جست و جو" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "آماده سازی جست و جو..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "جستجو پایان یافت و %sصفحه نتایج مطابق جستار پیدا شدن." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "، در " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "گسترش نوار کناره" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "تا کردن نوار کناره" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "محتوا ها" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "نمایه‌ای بر پایه‌ی ۴ ستون پیدا شد. شاید یک اشکال برنامه‌نویسی از افزونه‌هایی که استفاده می‌کنید باشد: %r" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "پانویس [%s] ارجاع داده نشده است." #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "پانویس [#] ارجاع داده نشده است." #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "ارجاعات پانویس ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "ارجاعات ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "ارجاعات نقل قول ادبی ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "ارجاعات اصطلاحی ناهناهنگ در پیام‌های ترجمه شده. اصلی:{0}، ترجمه شده:{1}" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "امکان تشخیص متن جایگزین برای ارجاع متقابل نبود. شاید یک اشکال برنامه نویسی باشد." #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "برای «هر» ارجاع متقابل بیشتر از یک هفد پیدا شد: %r شاید %s باشد" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "%s:%s مرجع هدف پیدا نشد: %s" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "مقصد ارجاع %r پیدا نشد %s" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "امکان دریافت تصویر از منبع راه دور نبود: %s [%d]" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "امکان دریافت تصویر از منبع راه دور نبود: %s [%s]" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "قالب تصویر ناشناخته: %s..." #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "نویسه‌ی منبع غیرقابل رمزگشایی، جایگزین با «؟» : %r" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "رد شدن و نادیده انگاشتن" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "شکست خورد" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "نام نقش یا دستورالعمل ناشناخته: %s:%s" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "خطای خواندن: %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "خطای نوشتن: %s, %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "پوشه‌ی محلّی %s وجود ندارد" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "قالب تاریخ ناشناخته. اگر می‌خواهید از رشته‌متن مستقیماً خروجی بگیرید، آن را با نقل قول رشته‌متنی محصور کنید: %s" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "درختواره‌ی فهرست مطالب شامل ارجاع به پرونده ناموجود %r است" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "ایراد در هنگام ارزیابی تنها عبارت دستور العمل: %s" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "نقش پیش‌فرض %s یافت نشد" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "قالب عدد شکل برای %s تعریف نشده" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "هر کدام از شناسه‌هایی که به بست %s اختصاص داده نشده" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "پیوند ثابت به این اصطلاح" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "پیوند ثابت به این جدول" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "پیوند ثابت به این کد" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "پیوند ثابت به این تصویر" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "پیوند ثابت به این فهرست عنوان ها" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "امکان دست یابی به اندازه‌ی عکس نبود. گزینه‌ی تغییر اندازه :scale: نادیده گرفته می‌شود." #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "قسمت‌بندی رده‌بالای %r ناشناخته برای کلاس %r" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "مقدار بسیار بزرگ :maxdepth:، نادیده گرفته شد." #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "عنوان سند یک بست متنی نیست" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "به بست عنوانی برخورد که در قسمت، موضوع، جدول، اندرز یا نوارکناری نبود" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "پانویس ها" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "هر دو مقدار tabularcolumns و :widths: داده شده، بنابراین :widths: حذف می شود." #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "ابعاد واحد %sنامعتبر است و نادیده گرفته شد." #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "نوع ناشناخته مدخل نمایه%s پیدا شد" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[تصویر%s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[تصویر]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "عنوان درون شکل نیست." #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "بست به کار نرفته: %r" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "بست از نوع ناشناخته: %r" �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3260071 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fi/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015501� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000032�00000000000�010210� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������26 mtime=1639903107.48049 ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fi/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017266� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fi/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000005552�00000000000�021144� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "fi", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "Tietoja t\u00e4st\u00e4 documentist\u00e4", "Automatically generated list of changes in version %(version)s": "Automaattisesti luotu muutoshistoria alkaen versiosta %(version)s", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "Hakemisto yhten\u00e4 luettelona", "General Index": "Yleinen sis\u00e4llysluettelo", "Global Module Index": "Yleinen moduulien sis\u00e4llysluettelo", "Go": "Siirry", "Hide Search Matches": "Piilota l\u00f6ydetyt", "Index": "Sis\u00e4llysluettelo", "Index – %(key)s": "", "Index pages by letter": "Hakemisto aakkostus sivuttain", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "Navikointi", "Next topic": ">>", "Other changes": "", "Overview": "Yhteenveto", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "Javascript pit\u00e4\u00e4 olla sallittu, jotta etsint\u00e4 toimii.", "Preparing search...": "", "Previous topic": "<<", "Quick search": "Pikahaku", "Search": "Etsi", "Search Page": "Etsi sivu", "Search Results": "Etsinn\u00e4n tulos", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "N\u00e4yt\u00e4 l\u00e4hdekoodina", "Table of Contents": "", "This Page": "T\u00e4m\u00e4 sivu", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "voi olla iso", "last updated": "", "lists all sections and subsections": "", "next chapter": ">>", "previous chapter": "<<", "quick access to all modules": "", "search": "etsi", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n != 1)" });������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fi/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000005540�00000000000�021140� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������6��������������������|�� ���}�� ����� ���������� ����������>�������� ����������'�� ���.�����9�����U�����[�� ���r���������������������� ��������������� ���������� ����� ��������� �� ��������(�����-��B���6�����y��$����� ���������� �������������������� ����� �������� ������������ ��������)�����/�����6�����>�� ���C�����P�����Y�����j����q�� ���7�����D�� ���M�����Z�����x�� ���}��A�������������������� ������������� ����� �����9 ��#���S �����w �����~ ����� ����� ����� ����� ����� ����� �� ���� �� ��� ����� �����) �����, �� ���3 ��8���> �����w ��$���z ����� ����� �� ��� ����� ����� �� ��� ����� �� ��� ����� ����� ����� �� ���) �� ���6 �����@ �����H �����Q �����S �����V �����X �����[ ��� (deprecated)�%b %d, %Y�%s (module)�About these documents�Attention�Author: �Automatically generated list of changes in version %(version)s�Caution�Changed in version %s�Danger�Deprecated�Deprecated since version %s�Error�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index pages by letter�Module Index�Module author: �Module level�Navigation�New in version %s�Next topic�Note�Overview�Please activate JavaScript to enable the search functionality.�Previous topic�Python Enhancement Proposals; PEP %s�Quick search�Search�Search Page�Search Results�Section author: �See also�Show Source�This Page�Tip�Todo�Warning�can be huge�index�module�modules�next�next chapter�previous�previous chapter�search�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: fi Language-Team: Finnish (http://www.transifex.com/sphinx-doc/sphinx-1/language/fi/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (poistettu)�%d.%m.%Y�%s (moduuli)�Tietoja tästä documentistä�Huom�Tekijä: �Automaattisesti luotu muutoshistoria alkaen versiosta %(version)s�Varoitus�Muutettu versiossa %s�Vaara�Poistettu�Poistettu versiosta %s alkaen�Virhe�Hakemisto yhtenä luettelona�Yleinen sisällysluettelo�Yleinen moduulien sisällysluettelo�Siirry�Piilota löydetyt�Vihje�Tärkeä�Sisällysluettelo�Hakemisto aakkostus sivuttain�Moduuli sisällysluettelo�Moduulin kirjoittaja: �Moduulitaso�Navikointi�Uusi versiossa %s�>>�Muista�Yhteenveto�Javascript pitää olla sallittu, jotta etsintä toimii.�<<�Python Enhancement Proposals; PEP %s�Pikahaku�Etsi�Etsi sivu�Etsinnän tulos�Luvun kirjoittaja: �Katso myös�Näytä lähdekoodina�Tämä sivu�Vihje�Tehtävä vielä�Varoitus�voi olla iso�hakemisto�moduuli�moduulit�>�>>�<�<<�etsi�����������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fi/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000243057�00000000000�021152� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # FIRST AUTHOR <EMAIL@ADDRESS>, 2009 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Finnish (http://www.transifex.com/sphinx-doc/sphinx-1/language/fi/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: fi\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Moduulitaso" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d.%m.%Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Yleinen sisällysluettelo" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "hakemisto" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr ">" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "<" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Sisällysluettelo" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Luvun kirjoittaja: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Moduulin kirjoittaja: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Tekijä: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Uusi versiossa %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Muutettu versiossa %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Poistettu versiosta %s alkaen" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (moduuli)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "moduuli" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "moduulit" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Poistettu" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (poistettu)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Moduuli sisällysluettelo" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Etsi sivu" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Tehtävä vielä" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Huom" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Varoitus" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Vaara" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Virhe" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Vihje" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Tärkeä" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Muista" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Katso myös" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Vihje" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Varoitus" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Etsi" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Siirry" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Näytä lähdekoodina" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Yhteenveto" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Yleinen moduulien sisällysluettelo" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Hakemisto yhtenä luettelona" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Hakemisto aakkostus sivuttain" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "voi olla iso" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navikointi" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Tietoja tästä documentistä" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "<<" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "<<" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr ">>" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr ">>" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Javascript pitää olla sallittu, jotta etsintä toimii." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "etsi" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Etsinnän tulos" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Pikahaku" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Tämä sivu" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automaattisesti luotu muutoshistoria alkaen versiosta %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Piilota löydetyt" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3261917 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fr/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015512� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4813082 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fr/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017277� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fr/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000010251�00000000000�021145� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "fr", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.", "© Copyright %(copyright)s.": "© Copyright %(copyright)s.", ", in ": ", dans", "About these documents": "\u00c0 propos de ces documents", "Automatically generated list of changes in version %(version)s": "Liste auto-g\u00e9n\u00e9r\u00e9e des modifications dans la version %(version)s", "C API changes": "Modifications de l'API C", "Changes in Version %(version)s — %(docstitle)s": "Changements dans la version %(version)s — %(docstitle)s", "Collapse sidebar": "R\u00e9duire la barre lat\u00e9rale", "Complete Table of Contents": "Table des mati\u00e8res compl\u00e8te", "Contents": "Contenu", "Copyright": "Copyright", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Agrandir la barre lat\u00e9rale", "Full index on one page": "Index complet sur une seule page", "General Index": "Index g\u00e9n\u00e9ral", "Global Module Index": "Index g\u00e9n\u00e9ral des modules", "Go": "Go", "Hide Search Matches": "Cacher les r\u00e9sultats de la recherche", "Index": "Index", "Index – %(key)s": "Index – %(key)s", "Index pages by letter": "Indexer les pages par lettre", "Indices and tables:": "Indices et tables :", "Last updated on %(last_updated)s.": "Mis \u00e0 jour le %(last_updated)s.", "Library changes": "Modifications de la biblioth\u00e8que", "Navigation": "Navigation", "Next topic": "Sujet suivant", "Other changes": "Autres modifications", "Overview": "R\u00e9sum\u00e9", "Permalink to this definition": "Lien permanent vers cette d\u00e9finition", "Permalink to this headline": "Lien permanent vers ce titre", "Please activate JavaScript to enable the search\n functionality.": "Veuillez activer le JavaScript pour que la recherche fonctionne.", "Preparing search...": "Pr\u00e9paration de la recherche...", "Previous topic": "Sujet pr\u00e9c\u00e9dent", "Quick search": "Recherche rapide", "Search": "Recherche", "Search Page": "Page de recherche", "Search Results": "R\u00e9sultats de la recherche", "Search finished, found %s page(s) matching the search query.": "La recherche est finie, %s page(s) trouv\u00e9e(s) qui corresponde(nt) \u00e0 la recherche.", "Search within %(docstitle)s": "Recherchez dans %(docstitle)s", "Searching": "Recherche en cours", "Searching for multiple words only shows matches that contain\n all words.": "Une recherche sur plusieurs mots ne retourne que les r\u00e9sultats contenant tous les mots.", "Show Source": "Montrer le code source", "Table of Contents": "Table des mati\u00e8res", "This Page": "Cette page", "Welcome! This is": "Bienvenue ! Ceci est", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Votre recherche ne correspond \u00e0 aucun document. Veuillez v\u00e9rifier que les mots sont correctement orthographi\u00e9s et que vous avez s\u00e9lectionn\u00e9 assez de cat\u00e9gories.", "all functions, classes, terms": "toutes les fonctions, classes, termes", "can be huge": "peut \u00eatre \u00e9norme", "last updated": "derni\u00e8re modification", "lists all sections and subsections": "lister l'ensemble des sections et sous-sections", "next chapter": "Chapitre suivant", "previous chapter": "Chapitre pr\u00e9c\u00e9dent", "quick access to all modules": "acc\u00e8s rapide \u00e0 l'ensemble des modules", "search": "rechercher", "search this documentation": "rechercher dans cette documentation", "the documentation for": "la documentation pour" }, "plural_expr": "(n > 1)" });�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fr/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000220772�00000000000�021157� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������\+����]+�����,��E��-��r���/��l���/�� ���/�����0��*��� 0��=���70��7���u0��H���0��?���0��"���61�� ���Y1�����c1��%���l1�����1�����1�����1�����1�����1�� ���1�����2�����2�����22�����C2�� ���R2�����s2�� ���2�� ���2�� ���2��S���2�����3��A���'3�����i3�����3�����3�����3�����3�� ���3�����3��6���3�����14�����Q4��$���m4�����4��3���L5�� ���5�����5�����5��1���5��1���5��G���5�����F6�����^6��0���q6�����6��H���6�����7��b���7�����8��6���8�����O8�� ���e8�� ���8�� ���8�����8�����8��>���8�� ���8��(���8��(���$9�����M9��?���l9�����9�� ���9��!���9��8���9��%���:�����D:�����L:��4���b:�� ���:�� ���:�����:�����:�����:�����;�� ���;��%���%;��%���K;�����q;��:���;��7���;�����<��"���<�����<<�����N<�� ���U<�����`<�����|<��`���<�����<��&��� =�����0=��D���6=��H���{=��K���=�����>�����)>�����1>��5���:>�����p>�����>�����>��8���>��D���>��B���#?��'���f?��"���?��3���?��"���?��#���@�����,@��!���4@��:���V@�����@�� ���@�� ���@�����@�� ���@�����A�����A��C���A�����\A�����pA��3��uA��.���B�� ���B��.���B�����C�����C�����-C��D���CC�����C�����C�� ���D�����D��[���D�����E�����"E�����@E��Y���RE��!���E�����E��2���E�� ���F��C���F�����`F��n���F��E���F�� ���5G�����BG�� ���RG�� ���^G��-���kG��(���G�� ���G�����G�� ���G��(���G�����H�����,H�����=H��Z���BH�����H�����H��,���H����H�����I�����J�� ���J��(���#J�����LJ�����UJ�� ���kJ�����vJ�����J�����J�����J�����J�����J�����K�����'K��&���AK��B���hK��i���K��2���L��I���HL��4���L�����L�����L�����M�����M��y���7M�����M�����M�����M�����M�� ���M�����N�����N�����+N��#���;N��$���_N�����N�� ���N�����N�����N�� ���N�����N�� ���N�����N�����N�����O�����O�����O�� ���3O�����?O��<���NO�����O�� ���O��K���O�� ���O�����P�����P�����"P��+���9P�� ���eP��k���qP��>���P�����Q��#���/Q�����SQ�����eQ�����mQ�����Q�����Q�����Q��Y���Q��Z��� R��*���fR��3���R��/���R��(���R��.���S��P���MS��p���S�����T��!���/T��"���QT��$���tT�� ���T��e���T��Z��� U��N���{U��T���U��K���V��%���kV�����V��[���V��#��� W��'���1W��#���YW��I���}W��'���W��!���W��=���X��7���OX�� ���X�����X��d���,Y��W���Y��v���Y�����`Z�����gZ�����kZ�� ���pZ��3���Z�����Z�����Z��"���Z��<���[��Y���X[�� ���[�����[�����[��,���[�����[�����\�����\�����%\��Y���\�����I]��%���]��,���]�����'^�����C^�� ���J^�����V^�� ���^^�����j^�����r^��N���{^�����^��?���V_��-���_��2���_�� ���_�����`�����!`�����4`��9���E`�����`�� ���`�� ���`��X���`��,��� a��2���7a��b���ja��5���a��\���b��M���`b��(���b��G���b�����c��7���4c�����lc��8���c�����c�� ���c��%���c��`���d�����cd�����d�����d�����d�����d�� ���d��&���d��$���e�����*e�����De�����be�����}e�����e��A���e��Z���e��-���Of�����}f�����f�����f��!���f��8���f�����)g�� ���/g�����<g�����Pg��7���Xg��6���g��;���g��I���h��;���Mh��:���h��H���h��9��� i��G���Gi��2���i��2���i�����i��4���j�����9j�����Pj�����mj��C���j��2���j�����j�����k�����2k�����Pk�����ik�����k�����k�����k�����k��(���k��=���l�����Cl�����Tl��0���dl�����l�����l��/���l�����l��*���l��&���*m�� ���Qm��9���[m�����m�����m�� ���m�����m��-���m�����(n�����@n��1���Wn��*���n�����n�����n��0���n��&���o�����+o�����=o��(���]o�����o�����o�����o��%���o��e���o�����\p��4���p�����3q�����8q��Y���Hq��;���q��.���q����� r�����,r�����Er��.���`r��4���r��+���r��4���r��(���%s��4���Ns��W���s�����s�����s�����t��X���*t��J���t�����t��%���t�� ���t�����u�����u��+���2u�����^u�����xu�� ���u��8���u��M���u��u���)v�����v�����v�����v�����v�����v��A���v�� ���@w�����Kw��6���jw��I���w��A���w�����-x��0���Hx�����yx��G���x��N���x�����'y�����0y��.���@y�����oy��4���y�� ���y��,���y��3���y�� ���&z��=���4z�����rz��'���z��0���z��(���z��1���{��,���C{��!���p{�����{�����{�����{��=���{��+���&|��0���R|��V���|��V���|��M���1}��R���}��$���}�����}�����}��N���~��0���`~��)���~�����~�����~�����~��/��� �����<�����V�����u��&�����!�����&����������E����� ���J��*���W��7�����"�����(���݀����������"�����@�����^��"���z�����������������;���Ё����� �������"�����!���=�����_��#���f�������D�����5���ׂ�� ��� ������� �����1���*��E���\��B�����G�����%���-�����S��#���m��#�����,����������-�����(���,��D���U�� �����#�����(���Ʌ��#������������������&��(���5�����^�����w��8���|�� �����P���ֆ��"���'�����J�����e��O���~�����·������������������%����� ���7�����E��,���T�� �����(�����E����� �����*��� �����5��1���>��7���p������� ���ĉ�����ω��������������� �����"�����2��&���E�����l�������4����������%���ӊ�������c���������d�����~�� �����'�����:����� �����@��������V�����^�����{��&�����*�����&�����W�����>���_��7����� ���֍�� ����� �����,�����*���%��0���P�������%��������Ŏ�����]��1�����1���'�����Y��\���o�����̐��'�����%�����+���6��^���b��2�����5��������*�����I�����c��5���h�������#�����&���֒��*��������(�����D��+���J��-���v��%��������ʓ��!�����!��������*��!���@�����b�����y��#�����*��������є�����ڔ�������P��������U��)���t��9�����;���ؕ��)��������>�����F�����Y�����r��������������������ږ�������������������7������$����M��›�������y����� ��� �������-�����L���M��M�����Q�����N���:��"����� ����� �����.������������� �����-�����3�����G�� ���X�����d�����x������������"��������Ԡ�� ����� �����.�����}���0�������Q���͡����������;�����[�����n������� ����������6���ɢ��������!��� ��(���B�����k��;���J������� ����������/�����/�����j��������{�������5����������Q��������O��}����������P��������������� ���.�� ���8�����B�� ���U��C���_�� �����4�����2����������P���6������������0�����C�����>���'�����f�����o��=�����(���ɪ��������������� ��1���>�����p�� ���x��.�����.�����*�����P��� ��I���\�������1���Ĭ��!���������� ��������)��$���H��n���m�����ܭ��4��������%��G���,��_���t��Z���Ԯ�����/�����N�����V��P���_����������ϯ�������?�����P���?��O�����0�����B�����=���T��)�����C�����������5�����1���>��3���p��4��������ٲ�� ������������������;��b���>��%����� ���dz��l��ҳ��/���?�� ���o��B���y����������µ�����ص��F��������<��#��P�� ���t�����������������"���<�����_�����w�� ��� ��!���,��H���N�������Z�����,��������.��K���ں�����&�����6�����J�����Y��)���`��G����� ���һ�����ݻ�� �����?�����(���F�����o�������d���������������>�����P��9�����������������6���Ⱦ������������ ���(�����4��%���P��#���v���������������׿�������-�����-���A��@���o��p�����E���!��e���g��F�����!��������6�����R�����m����������%�����E�����W�����s�� ��������������������-�����$�������������5�����F�����L�� ���c�����p�� ���x������������ ����� ���������������������S��������o�������X����� ���������� ����� ���'��/���H�����x�������B��������W��%���v����������������� ���������������z��� ��]�����/�����9�����3���N��,�����4�����X��������=��$�����$�����/��� ��1���=��-���o����������L��k��������G��T�����2�����+���O��r���{��$�����0�����/���D��T���t��0�����/�����J���*��C���u�� ����������u�����^��������q�� ���������������&���#��>���J�����������������R�����e���:�� ����� ����������8�������������������.�����5��r���'�������+���A��9���m������������ ���������� ���������������\��������^��`�����G���z��L����� �����%��������A�����Y��N���r�����������������b�����2���Z��B�����s�����:���D��f�����[�����.���B��T���q�������]�����$���7��^���\��%����������8�����`���-��=�����+������������� �����+�����<��9���O��7�����1�����,�����)��� �����J��9���a��]����������B���y��,�����3����������2���<��]���o����������������������H��� ��N���T��S�����b�����S���Z��R�����^�����Q���`��_�����K�����J���^�������C�������������(�����F��\���a��<�����!�����$�����%���B��"���h��(�����#������������������ ��4���(��D���]������������B���������� ���!��C���B��$�����D�����3����� ���$��<���.�����k��)�����)����������>��������0��!���O��E���q��0���������������5��� ��K���A�������$�����:����������������"���9��/���\��d����������O���������������z�����C�����8�����0�����!���.��&���P��A���w��E�����2�����E���2��9���x��>�����p�����=���b�������(����������h���d�� �����)����� �������������,��3���I��*���}��0����� �����K�����b���/������� ���$�����E�����`��%���i�������L����� �����&�����F���/��c���v��f�����(���A��9���j��#�����>�����Y��������a�����j��2���~�������?����������<�����K���X�������F�����*�����)���-��@���W��*�����A�����@�����"���F�����i������������B�����:�����D���@��`�����m�����T���T��\�����.�������5����;�a���R�E����.�������)�2���@�5���s�@����%����*�������;�)���U�#����0��������W�������5�C���L�9����/����/����%���*�#���P�)���t�"����$��������$��������U���+���������$����$��������'������� �R����1���e�������������5����[����]���Y�\����0��� �#���E �0���i �3��� �C��� ���� �X���0 �4��� �M��� ���� ���� �I���6 �"��� ���� � ��� ���� �6��� � ��� ���� �C���# �$���g �\��� �/��� �#��� ����= �r���] ���� ���� � ��� �����'���*����R����i�A���}� ����5����\�������`�?���q� ����=����<����'���8����`����p���������������������&��������'����G�4���L�*����,���� ����x����#���]����� ����P����U����0���>�M���o�������������@����,���C�-���p�����<���#�9���`��������� ����)����+����.����'���A����i��������d�A���J�C��������`���� ���G�0���h�.����O����u����>����P��������&���>����e�E���j�����'����)����/����"���J����m�0���s�>����+��������8���.�)���g�����/����"���� ����)��� �@���6����w�����*����\����,����9���G�E��������F���I ���� �"��� �,��� �"��� �(���!����;!�(���V!�&���!� ���!�#���!�!���!�� Generate ReStructuredText using autosummary directives. sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates the reStructuredText files from the autosummary directives contained in the given input files. The format of the autosummary directive is documented in the ``sphinx.ext.autosummary`` Python module and can be read using:: pydoc sphinx.ext.autosummary � Generate required files for a Sphinx project. sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build. � Look recursively in <MODULE_PATH> for Python modules and packages and create one reST file with automodule directives per package in the <OUTPUT_PATH>. The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be excluded from generation. Note: By default this script will not overwrite already created files.� Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� Run 'make' in that directory to run these through makeinfo (use 'make info' here to do that automatically).� (deprecated)� (in �"::" in automodule name doesn't make sense�"latex_documents" config value references unknown document %s�"man_pages" config value references unknown document %s�"quiet" is specified, but any of "project" or "author" is not specified.�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%r doesn't have "%s" setting�%r doesn't have "theme" setting�%s %s�%s %s documentation�%s (%s attribute)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command %r cannot be run (needed for math display), check the imgmath_%s setting�%s command line option�%s is already assigned section numbers (nested numbered toctree?)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �-A option argument must be in the form name=value�-D option argument must be in the form name=value�4 column based index found. It might be a bug of extensions you use: %r�:%s: (directive option)�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�====================== slowest reading durations =======================�A Makefile and a Windows command file can be generated for you so that you only have to run e.g. `make html' instead of invoking sphinx-build directly.�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�About these documents�An error happened in rendering the page %s. Reason: %r�Anchor '%s' not found�Any IDs not assigned for %s node�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not fetch remote image: %s [%d]�Could not fetch remote image: %s [%s]�Could not import extension %s�Could not lex literal_block as "%s". Highlighting skipped.�Could not obtain image size. :scale: option is ignored.�Create Makefile? (y/n)�Create Windows command file? (y/n)�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Encoding error:�Enter the root path for documentation.�Error�Error: an existing conf.py has been found in the selected root path.�Error: specified path is not a directory, or sphinx files already exist.�Error: the master file %s has already been found in the selected root path.�Event %r already present�Example�Examples�Exception occurred while building, starting debugger:�Exception occurred:�Expand sidebar�Extension options�External Graphviz file %r not found or reading it failed�Failed to create a cross reference. A title or caption not found: %s�Failed to create a cross reference. Any number is not assigned: %s�Failed to parse type_comment for %r: %s�Failed to read build info file: %r�Failed to read intersphinx_mapping[%s], ignored: %r�Failed to scan documents in %s: %r�Failed to write build info file: %r�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnote [#] is not referenced.�Footnote [%s] is not referenced.�Footnotes�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Hide Search Matches�Hint�If the documents are to be written in a language other than English, you can select a language here by its language code. Sphinx will then translate text that it generates into that language. For a list of supported codes, see https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indicate which of the following Sphinx extensions should be enabled:�Indices and tables:�Inside the root directory, two more directories will be created; "_templates" for custom HTML templates and "_static" for custom stylesheets and other static files. You can enter another prefix (such as ".") to replace the underscore.�Interrupted!�Invalid caption: %s�Invalid date format. Quote the string by single quote if you want to output it directly: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�Keyword Arguments�LaTeX command %r cannot be run (needed for math display), check the imgmath_latex setting�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Look for any errors in the above output or in %(outdir)s/output.txt�Makefile and Batchfile creation�Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Many math_renderers are registered. But no math_renderer is selected.�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Non-alphabetical�Note�Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.�Notes�Numbers�Object named %r not found in include file %r�One document is special in that it is considered the top node of the "contents tree", that is, it is the root of the hierarchical structure of the documents. Normally, this is "index", but if your "index" document is a custom template, you can also set this to another filename.�Original exception: �Other Parameters�Other changes�Output directory (%s) is not a directory�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this term�Permalink to this toctree�Pillow not found - copying image files�Please activate JavaScript to enable the search functionality.�Please also report this if it was a user error, so that a better error message can be provided next time.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter a new file name, or rename the existing file and press Enter�Please enter a new root path (or just Enter to exit)�Please enter a valid path name.�Please enter either 'y' or 'n'.�Please enter one of %s.�Please enter some text.�Please enter values for the following settings (just press Enter to accept a default value, if one is given in brackets).�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project templating�Project version�Pygments lexer name %r is not known�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Recursion error:�References�Release�Return type�Returns�Root path for the documentation�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Searching for multiple words only shows matches that contain all words.�Section %s�Section author: �See also�Selected root path: %s�Separate source and build directories (y/n)�Show Source�Since v2.0, Sphinx uses "index" as root_doc by default. Please add "root_doc = 'contents'" to your conf.py.�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Structure options�Symbols�TODO entry found: %s�Table %s�Table of Contents�Template Parameters�Testing of coverage in the sources finished, look at the results in %(outdir)spython.txt.�Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt.�The %r crossref_type is already registered�The %r directive is already registered to domain %s�The %r index is already registered to domain %s�The %r object_type is already registered�The %r role is already registered to domain %s�The %s extension is required by needs_extensions settings, but it is not loaded.�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.�The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.�The config value `{name}' has type `{current.__name__}'; expected {permitted}.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The dummy builder generates no files.�The ePub file is in %(outdir)s.�The full traceback has been saved in %s, if you want to report the issue to the developers.�The manual pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�The overview file is in %(outdir)s.�The project name will occur in several places in the built documentation.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This can happen with very large or deeply nested source files. You can carefully increase the default Python recursion limit of 1000 in conf.py with e.g.:�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Translator for %r already exists�Unknown configure key: latex_elements[%r], ignored.�Unknown event name: %s�Unknown image format: %s...�Unknown math_renderer %r is given.�Use the Makefile to build the docs, like so: make builder�Use the sphinx-build command to build the docs, like so: sphinx-build -b builder %s %s�Variables�Warning�Warns�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�Would create file %s.�Yields�You have two options for placing the build directory for Sphinx output. Either, you use a directory "_build" within the root path, or you separate "source" and "build" directories within the root path.�You should now populate your master file %s and create other documentation source files. �Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[autosummary] failed to import %r: %s�[autosummary] generating autosummary for: %s�[autosummary] writing to %s�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.�a list of specific files to rebuild. Ignored if -a is specified�a suitable image for %s builder not found: %s�a suitable image for %s builder not found: %s (%s)�alias of %s�all functions, classes, terms�all of %d po files�all source files�append module_path to sys.path, used when --full is given�assembling single document�attribute�author names�autodoc: failed to determine %r to be documented, the following exception was raised: %s�automatically insert docstrings from modules�automatically test code snippets in doctest blocks�autosummary generats .rst files internally. But your source_suffix does not contain .rst. Skipped.�autosummary references excluded document %r. Ignored.�autosummary: failed to determine %r to be documented, the following exception was raised: %s�autosummary: stub file not found %r. Check your autosummary_generate setting.�autosummary_generate: file not found: %s�both tabularcolumns and :widths: option are given. :widths: is ignored.�broken link: %s (%s)�build %s, %s warning (with warnings treated as errors).�build %s, %s warning.�build %s, %s warnings (with warnings treated as errors).�build %s, %s warnings.�build %s.�build environment version not current�build in parallel with N processes where possible (special value "auto" will set N to cpu-count)�build info file is broken: %r�builder to use (default: html)�building [%s]: �building [mo]: �built-in function�can be huge�cannot combine -a option and filenames�cannot copy downloadable file %r: %s�cannot copy extra file %r�cannot copy image file %r: %s�cannot copy static file %r�cannot find files %r�cannot open warning file %r: %s�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�cannot read image file %r: copying it instead�cannot write image file %r: %s�caption not inside a figure.�checking consistency�checks for documentation coverage�circular toctree references detected, ignoring: %s <- %s�class�class method�command line option�concept�conditional inclusion of content based on config values�conf value "epub_author" should not be empty for EPUB3�conf value "epub_contributor" should not be empty for EPUB3�conf value "epub_copyright" (or "copyright")should not be empty for EPUB3�conf value "epub_description" should not be empty for EPUB3�conf value "epub_identifier" should not be empty for EPUB3�conf value "epub_language" (or "language") should not be empty for EPUB3�conf value "epub_publisher" should not be empty for EPUB3�conf value "epub_title" (or "html_title") should not be empty for EPUB3�conf value "epub_uid" should be XML NAME for EPUB3�conf value "version" should not be empty for EPUB3�config changed�config directory doesn't contain a conf.py file (%s)�console output options�continued from previous page�continues on next page�convert command %r cannot be run, check the image_converter setting�convert exited with error: [stderr] %r [stdout] %r�copying TeX support files�copying TeX support files...�copying Texinfo support files�copying additional files�copying downloadable files... �copying extra files�copying images... �copying source files...�copying static files�could not read %r for changelog creation�create .nojekyll file to publish the document on GitHub pages�create batchfile�create makefile�custom template directory (default: %(default)s)�data�default role %s not found�default suffix for files (default: %(default)s)�define a template variable�define tag: include "only" blocks with TAG�dimension unit %s is invalid. Ignored.�directive�directive %r is already registered, it will be overridden�directive-option�directory to place all output�directory to place all output in�display latex %r: %s�do emit colored output (default: auto-detect)�do not create batchfile�do not create makefile�do not emit colored output (default: auto-detect)�do not use make-mode for Makefile/make.bat�docnames to write: %s�document�document imported members (default: %(default)s)�document isn't included in any toctree�document language�document not readable. Ignored.�document title is not a single Text node�doing serial %s�domain %s already registered�domain %s not yet registered�don't create a table of contents file�don't create headings for the module/package packages (e.g. when the docstrings already contain them)�don't know which module to import for autodocumenting %r (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)�don't use a saved environment, always read all files�done�dot code %r: %s�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�dot did not produce an output file: [stderr] %r [stdout] %r�dot exited with error: [stderr] %r [stdout] %r�download file not readable: %s�dumping object inventory�dumping search index in %s�duplicate %s description of %s, other %s in %s�duplicate %s description of %s, other instance in %s�duplicate citation %s, other instance in %s�duplicate description of %s %s, other instance in %s�duplicate label %s, other instance in %s�duplicate label of equation %s, other instance in %s�duplicate object description of %s, other instance in %s, use :noindex: for one of them�duplicated ToC entry found: %s�enable %s extension�enable arbitrary extensions�encountered some issues with some of the inventories, but they had working alternatives:�encountered title node not in section, topic, table, admonition or sidebar�enum�enumerable_node %r already registered�enumerator�environment variable�environment variable; %s�error while formatting arguments for %s: %s�error writing file %s: %s�error writing file Makefile: %s�exception�exception while evaluating only directive expression: %s�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extension options�extensions changed�failed�failed to import object %s�failed to parse name %s�failed to reach any of the inventories with the following issues:�failed: %s�favicon file %r does not exist�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�filename of table of contents (default: modules)�finished with problems�fnmatch-style file and/or directory patterns to exclude from generation�follow symbolic links. Powerful when combined with collective.recipe.omelette.�function�general options�generate a full project with sphinx-quickstart�generating indices�glossary seems to be misformatted, check indentation�glossary term�glossary term must be preceded by empty line�glossary terms must not be separated by empty lines�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�highlighting module code... �html_extra_path entry %r does not exist�html_extra_path entry %r is placed inside outdir�html_static_path entry %r does not exist�html_static_path entry %r is placed inside outdir�if specified, separate source and build dirs�ignoring invalid doctest code: %r�image file %s not readable: %s�image file not readable: %s�include "_private" modules�include links to the source code of documented Python objects�include math, rendered as PNG or SVG images�include math, rendered in the browser by MathJax�inconsistent citation references in translated message. original: {0}, translated: {1}�inconsistent footnote references in translated message. original: {0}, translated: {1}�inconsistent references in translated message. original: {0}, translated: {1}�inconsistent term references in translated message. original: {0}, translated: {1}�increase verbosity (can be repeated)�index�inline latex %r: %s�interpret module paths according to PEP-0420 implicit namespaces specification�intersphinx identifier %r is not string. Ignored�intersphinx inventory has moved: %s -> %s�invalid TestCode type�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�invalid regex %r in %s�invalid regex %r in coverage_c_regexes�invalid signature for auto%s (%r)�job number should be a positive number�keyword�kwargs for add_node() must be a (visit, depart) function tuple: %r=%r�last updated�line number spec is out of range(1-%d): %r�link between Sphinx documentation of different projects�lists all sections and subsections�loading intersphinx inventory from %s...�loading pickled environment�loading translations [%s]... �locale_dir %s does not exists�logo file %r does not exist�looking for now-outdated files... �macro�making output directory�master document name�maximum depth of submodules to show in the TOC (default: 4)�member�method�missing '+' or '-' in '%s' option.�missing attribute %s in object %s�module�module %s could not be imported: %s�modules�more than one target found for 'any' cross-reference %r: could be %s�more than one target found for cross-reference %r: %s�new config�next�next chapter�nit-picky mode, warn about all missing references�no "latex_documents" config value found; no documents will be written�no "man_pages" config value found; no manual pages will be written�no "texinfo_documents" config value found; no documents will be written�no Babel option known for language %r�no changes in version %s.�no code/output in %s block at %s:%s�no output at all, not even warnings�no output on stdout, just warnings on stderr�no targets are out of date.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�none found�not available for built-in messages�numfig is disabled. :numref: is ignored.�numfig_format is not defined for %s�object�operator�original entry�override a setting in configuration file�overwrite existing files�page�page %s matches two patterns in html_sidebars: %r and %r�pass a value into HTML templates�path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)�path to documentation source files�path to module to document�path to output directory�path where configuration file (conf.py) is located (default: same as SOURCEDIR)�pickling environment�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�program option�project author(s), used when --full is given�project name�project name (default: root module name)�project release, used when --full is given, defaults to --doc-version�project root�project version, used when --full is given�property�put documentation for each module on its own page�put module documentation before submodule documentation�quick access to all modules�quiet mode�reST markup error:�reading error: %s, %s�reading sources... �reading templates... �reference label�release of project�replacement for dot in _templates etc.�resolving references...�role�role %r is already registered, it will be overridden�run Pdb on exception�run the script without creating files�search�search index couldn't be loaded, but not all documents will be built: the index will be incomplete.�search this documentation�see %s�see also %s�self referenced toctree found. Ignored.�setting %s.%s occurs in none of the searched theme configs�show full traceback on exception�signature arguments or return annotation given for automodule %s�skipped�source directory has changed�source file suffix�source files to generate rST files for�source_parser for %r is already registered�source_suffix %r is already registered�sphinx-quickstart only generate into a empty directory. Please specify a new root path.�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�statement�static method�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�targets for %d template files�template directory for template files�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension is not safe for parallel reading�the %s extension is not safe for parallel writing�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�toctree contains ref to nonexisting file %r�toctree contains reference to document %r that doesn't have a title: no link will be generated�toctree contains reference to excluded document %r�toctree contains reference to nonexisting document %r�too large :maxdepth:, ignored.�turn warnings into errors�type�undecodable source characters, replacing with "?": %r�undefined label: %s�undocumented python class: %s :: %s�undocumented python function: %s :: %s�undocumented python method: %s :: %s :: %s�unimplemented node type: %r�union�unknown %r toplevel_sectioning for class %r�unknown config value %r in override, ignoring�unknown directive or role name: %s:%s�unknown index entry type %r�unknown index entry type %s found�unknown mimetype for %s, ignoring�unknown node type: %r�unsupported theme option %r given�updating environment: �use epub�use make-mode for Makefile/make.bat�use no config file at all, only -D options�variable�version of project�waiting for workers...�where "builder" is one of the supported builders, e.g. html, latex or linkcheck.�while setting up extension %s:�with -W, keep going when getting warnings�write "todo" entries that can be shown or hidden on build�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing�writing %s file...�writing additional files�writing additional pages�writing content.opf file...�writing error: %s, %s�writing message catalogs... �writing nav.xhtml file...�writing output... �writing summary file...�writing toc.ncx file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: fr Language-Team: French (http://www.transifex.com/sphinx-doc/sphinx-1/language/fr/) Plural-Forms: nplurals=2; plural=(n > 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � Engendre du ReStructuredText par les directives autosummary. sphinx-autogen est une interface à sphinx.ext.autosummary.generate. Il engendre les fichiers reStructuredText à partir des directives autosummary contenues dans les fichiers donnés en entrée. Le format de la directive autosummary est documentée dans le module Python "sphinx.ext.autosummary" et peut être lu via : :: pydoc sphinx.ext.autosummary � Engendre les fichiers requis pour un projet Sphinx. sphinx-quickstart est un outil interactif qui pose des questions à propos de votre projet et génère un répertoire avec la structure complète nécessaire ainsi qu'un Makefile qui peut être utilisé comme alternative à sphinx-build. � Cherche récursivement dans <MODULE_PATH> des modules et packages Python et crée dans <OUTPUT_PATH> un fichier reST par package avec des directives automodule. Les <EXCLUDE_PATTERN>s peuvent être tout pattern de fichiers et/ou de répertoires à exclure. Note : par défaut ce script n'écrasera pas des fichiers déjà créés.� Exécuter 'make' dans ce répertoire pour les soumettre à (pdf)latex (ou 'make latexpdf' directement ici pour l’automatiser).� Exécuter 'make' dans ce répertoire pour les soumettre à makeinfo (ou 'make info' directement ici pour l'automatiser).� (obsolète)�(dans�"::" dans le nom d'automodule n'a pas de sens�La valeur du paramètre "latex_documents" référence un document inconnu %s�le paramètre de configuration "man_pages" référence un document inconnu %s�vous avez spécifiez "quit" , mais "project" ou "author" ne sont pas spécifiés.�La valeur du paramètre "texinfo_documents" référence un document inconnu %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d trouvé�%d fichiers source saisis en ligne de commande�%r n'a pas d'option « %s »�%r n'a pas d'option « theme »�%s %s�Documentation %s %s�%s (attribut %s)�%s (C++ %s)�%s (classe de base)�%s (variable de base)�%s (classe dans %s)�%s (directive)�%s (variable globale ou constante)�%s (dans le module %s)�%s (module)�%s (role)�%s ajouté(s), %s modifié(s), %s supprimé(s)�La commande de %s, %r, ne pas être exécuté (nécessaire pour display mathématique), vérifier la configuration imgmath_%s�option de ligne de commande %s�%s a déjà des numéros de section attribués (toctree numérotés emboîtés ?)�%s n'est pas un répertoire�%s() (méthode de la classe %s)�%s() (méthode %s)�%s() (méthode statique %s)�%s() (fonction de base)�%s() (classe)�%s() (dans le module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' n'est pas une option valide.�%s n'est pas une option pyversion valide�'setup' tel que défini dans conf.py n'est pas un objet Python appelable. Veuillez modifier sa définition pour en faire une fonction appelable. Ceci est nécessaire pour que conf.py se comporte comme une extension Sphinx.�(l'<<entrée originale>> se trouve dans %s, à la ligne %d)�(disponible dans %s v%s)�(dans %s)�, dans�l'option -A doit être sous la forme nom=valeur�l'option -D doit être sous la forme nom=valeur�index trouvé avec style ancien à 4 colonnes. Possiblement un bogue d’extensions que vous utilisez : %r�:%s: (option de directive)�<<entrée originale>>�<h1>Modules pour lesquels le code est disponible</h1>�<h1>Code source de %s</h1>�====================== durées de lecture les plus lentes =======================�Un fichier Makefile et un fichier de commandes Windows peuvent être générés pour vous, afin que vous puissiez exécuter par exemple `make html' au lieu d'appeler directement sphinx-build.�Un rapport d'erreur peut être déposé dans le système de tickets à <https://github.com/sphinx-doc/sphinx/issues>. Merci !�À propos de ces documents�Un erreur est survenue lors de la génération de la page: %s. La raison est: %r�Ancre '%s' non trouvée�Aucun ID assigné au node %s�Arguments�Attention�Nom(s) de l'auteur�Auteur : �Liste auto-générée des modifications dans la version %(version)s�Bases : %s�Le constructeur %r existe déjà (dans le module %s)�La classe Builder %s n'a pas d'attribut « name »�Constructeur %s non enregistré�Le nom de Constructeur %s n'est ni enregistré ni accessible par point d'entrée�Fonctions de base�Modifications de l'API C�Impossible de trouver le répertoire source (%s)�On ne peut pas utiliser "lineno-match" avec un "lines" non contigu �Impossible d'utiliser les options "%s" et "%s" en même temps.�Prudence�Modifié dans la version %s�Changements dans la version %(version)s — %(docstitle)s�La citation [%s] n'est pas référencée�Auteur du code : �Réduire la barre latérale�Table des matières complète�L'option de configuration %r est déjà présente�Contenu�Copyright�impossible d'atteindre l'image distante %s[%d]�impossible d'atteindre l'image distante %s[%s]�L'extension %s ne peut pas être importée�Analyse lexicale de literal_bloc impossible en "%s". Mise en évidence annulée.�impossible d'obtenir la taille de l'image. L'option :scale: est ignorée.�Création du Makefile ? (y/n)�Création du fichier de commandes Windows ? (y/n)�Fichier en cours de création %s.�Danger�Obsolète�Obsolète depuis la version %s�le domaine %r n'est pas enregistré.�L’encodage %r utilisé pour lire le fichier inclus %r semble erroné, veuillez ajouter une option :encoding:�Erreur d'encodage :�Saisissez le répertoire racine de la documentation.�Erreur�Erreur : un fichier conf.py a été trouvé dans le répertoire racine.�Erreur : le chemin spécifié n'est pas un répertoire, ou les fichiers Sphinx existent déjà.�Erreur : le fichier principal %s est déjà présent dans le répertoire racine du projet.�Évènement %r déjà présent�Exemple�Exemples�Une exception a été levée lors de la génération, démarrage du débogueur :�Une exception a été levée :�Agrandir la barre latérale�Options d'extension�Fichier externe Graphviz %r non trouvé ou échec de sa lecture�Impossible de créer une référence croisée. Titre ou légende introuvable: %s�Impossible de créer une référence croisée. Aucun nombre n'est attribué: %s�Échec de l'analyse de type_comment pour %r : %s�Échec de lecture du fichier de configuration de construction : %r�Échec de la lecture de intersphinx_mapping[%s]; ignoré : %r�Échec du scan des documents dans %s : %r�Échec d'écriture du fichier de configuration de construction : %r�Fig. %s�Le fichier %s existe déjà, il ne sera pas remplacé�Terminé : la structure initiale a été créée.�La note de bas de page [#] n'est pas référencée.�La note de bas de page [%s] n'est pas référencée.�Notes de bas de page�Index complet sur une seule page�Index général�Index général des modules�Go�La directive Graphviz ne peut pas avoir simultanément du contenu et un argument de nom de fichier�Cacher les résultats de la recherche�Indication�Si les documents doivent être rédigés dans une langue autre que l’anglais, vous pouvez sélectionner une langue ici grâce à son identifiant. Sphinx utilisera ensuite cette langue pour traduire les textes que lui-même génère. Pour une liste des identifiants supportés, voir https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Directive « graphviz » sans contenu ignorée.�Important�Le fichier d'include %r est introuvable ou sa lecture a échouée.�Index�Index – %(key)s�Indexer les pages par lettre�Indiquer lesquelles de ces extensions Sphinx doivent être activées :�Indices et tables :�Dans le répertoire racine, deux autres répertoires seront créés : "_templates" pour les modèles HTML personnalisés et "_static" pour les feuilles de style personnalisées et autres fichiers statiques. Vous pouvez entrer un autre préfixe (p. ex. ".") pour remplacer le tiret bas ("_").�Interrompu !�Légende invalide: %s�Format de date invalide. Insérez la chaîne de caractères entre des guillemets simples si vous voulez l'afficher telle quelle : %s�math_eqref_format invalide : %r�Variable de template invalide : %s�Arguments de mots-clés�La commande LaTeX %r (nécessaire pour le rendu des équations mathématiques), ne peut pas être exécutée, vérifier le paramètre imgmath_latex�Mis à jour le %(last_updated)s.�Modifications de la bibliothèque�Spécification de lignes %r : aucune ligne extraite du fichier inclus %r�Code source %s�Recherchez les éventuelles erreurs dans la sortie ci-dessus ou dans %(outdir)s/output.txt�Création des fichiers Batchfile et Makefile�description de l'option malformée, elle doit ressembler à Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Plusieurs math_renderers sont enregistrés. Mais aucun n'est sélectionné.�Index du module�Auteur du module : �Code du module�Module�Non du fichier principal (sans extension)�Préfixe de nom pour les répertoires static et de gabarits (templates)�Navigation�Nouveau dans la version %s�Sujet suivant�Aucun constructeur sélectionné, utilisation du défaut : html�Option de configuration inexistante : %s�Non alphabétique�Note�Note : imgmath et mathjax ne peuvent pas être activés en même temps. imgmath a été désactivé.�Notes�Chiffres�L'objet nommé %r est introuvable dans le fichier d'include %r�Un document est particulier en ce sens qu'il est considéré comme le nœud supérieur de "l'arbre des contenus", c'est-à-dire la racine de la structure hiérarchique des documents. Normalement, il s'agit d'un "index", mais si votre "index" est un modèle personnalisé, vous pouvez également le définir sous un autre nom de fichier.�Exception initiale : �Autres paramètres�Autres modifications�Le répertoire de sortie (%s) n'est pas un répertoire�Résumé�Vue d'ensemble : code du module�Paramètres�Lien permanent vers ce code�Lien permanent vers cette définition�Lien permanent vers cette équation�Lien permanent vers ce titre�Lien permanent vers cette image�Lien permanent vers ce tableau�Lien permanent vers ce terme�Lien permanent vers cette table des matières�Pillow introuvable - copie des fichiers image�Veuillez activer le JavaScript pour que la recherche fonctionne.�Merci de rapporter ceci s'il s'agit d'une erreur utilisateur, afin d'améliorer le message d'erreur à l'avenir.�Merci de saisir l'extension du fichier, par exemple '.rst' ou '.txt'.�Merci de saisir un nouveau nom de fichier, ou de renommer le fichier existant et valider avec Entrée�Merci de saisir un nouveau répertoire racine (ou tapez juste Entrée)�Merci de saisir un chemin valide.�Merci de saisir 'y' ou 'n'.�Merci de saisir un des %s.�Merci de saisir du texte.�Veuillez saisir des valeurs pour les paramètres suivants (tapez Entrée pour accepter la valeur par défaut, lorsque celle-ci est indiquée entre crochets).�Préparation de la recherche...�Sujet précédent�Options basiques du projet.�Langue du projet�Nom du projet�version du projet�Gabarits de projet�Version du projet�Le nom du l'analyseur Pygments %r est inconnu�Python Enhancement Proposals; PEP %s�Index des modules Python�Recherche rapide�Lève�Erreur de récursion :�Références�Version�Type renvoyé�Renvoie�racine de la documentation.�Sphinx v%s en cours d'exécution�Recherche�Rechercher %(docstitle)s�Page de recherche�Résultats de la recherche�La recherche est finie, %s page(s) trouvée(s) qui corresponde(nt) à la recherche.�Recherchez dans %(docstitle)s�Recherche en cours�Une recherche sur plusieurs mots ne retourne que les résultats contenant tous les mots.�Section %s�Auteur de la section : �Voir aussi�Chemin racine sélectionné : %s�Séparer les répertoires build et source (y/n)�Montrer le code source�Depuis sa version 2.0, Sphinx utilise "index" comme root_doc par défaut. Veuillez ajouter "root_doc = 'contents'" à votre conf.py.�Les dossiers source et destination ne doivent pas être identiques�Extension des fichiers sources�source_parser pour %s non enregistré�Options de structure�Symboles�Entrée TODO trouvée : %s�Tableau %s�Table des matières�Paramètres du modèle�Vérification du taux de couverture documentaire dans les sources achevée, voir les résultats dans %(outdir)spython.txt.�Exécution des doctests des sources achevée, voir les résultats dans %(outdir)s/output.txt.�Le type %r crossref_type est déjà enregistré�La directive %r est déjà enregistrée sur le domaine %s�L'index %r est déjà enregistré sur le domaine %s�Le type de l'objet %r est déjà enregistré�Le rôle %r est déjà enregistré sur le domaine %s�L'extension %s est exigée par le paramètre needs_extensions, mais n'est pas chargée.�L'extension %s utilisée par ce projet nécessite au moins Sphinx v%s ; il ne peut donc pas être construit avec la version courante.�Les pages HTML sont dans %(outdir)s.�Les pages HTML sont dans %(outdir)s.�Les fichiers LaTex se trouvent dans %(outdir)s.�Les fichiers Texinfo se trouvent dans %(outdir)s.�Les fichiers XML se trouvent dans %(outdir)s.�Le paramètre « source_suffix » s'attend à recevoir une chaîne de caractères, une liste de chaînes de caractères ou un dictionnaire. Mais vous avez fourni un « %r ».�Le paramètre de configuration « {name} » a pour type « {current.__name__} », tandis que le type par défaut est « {default.__name__} ».�Le type du paramètre de configuration « {name} » doit être {permitted} et non « {current.__name__} ».�La valeur « {current} » du paramètre « {name} » ne figure pas dans la liste des possibilités valables « {candidates} ».�Le fichier de configuration (ou un des modules qu'il utilise) génère un sys.exit()�Le constructeur factice ne génère aucun fichier.�Le fichier ePub se trouve dans %(outdir)s .�Le traceback complet a été sauvé dans %s, au cas où vous souhaiteriez signaler le problème aux développeurs.�Le manuel se trouve dans %(outdir)s.�La liste des messages se trouve dans %(outdir)s.�Le fichier d'aperçu se trouve dans %(outdir)s.�Le nom du projet apparaîtra à plusieurs endroits dans la documentation construite.�Le fichier pseudo-XML se trouve dans %(outdir)s.�Les fichiers texte se trouvent dans %(outdir)s.�Votre fichier de configuration comporte une erreur de programmation : %s�Votre fichier de configuration comporte une erreur de syntaxe : %s �Cette page�Cela peut se produire avec des fichiers sources très volumineux ou profondément imbriqués. Vous pouvez augmenter avec attention la limite de récursivité par défaut de Python de 1000 dans conf.py avec p. ex. :�Cet environnement est incompatible avec le constructeur sélectionné, veuillez choisir un autre répertoire doctree.�Ce projet nécessite au minimum Sphinx v%s et ne peut donc être construit avec cette version.�Ce projet nécessite que l'extension %s soit au minimum en version %s et par conséquent il ne peut pas être construit avec la version chargée (%s).�Déclenche�Astuce�À faire�Il existe déjà un traducteur pour %r�Clé de configuration inconnue : latex_elements[%r]; ignorée.�Nom d'évènement inconnu : %s�Format d'image inconnu : %s...�math_renderer saisi %r inconnu.�Utilisez le Makefile pour construire la documentation comme ceci : make builder�Utilisez sphinx-build pour construire la documentation comme ceci : sphinx-build -b builder %s %s�Variables�Avertissement�Avertissements�Bienvenue dans le kit de démarrage rapide de Sphinx %s.�Bienvenue ! Ceci est�Créerait le fichier %s.�Yields�Vous avez deux options pour l'emplacement du répertoire de construction de la sortie de Sphinx. Soit vous utilisez un répertoire "_build" dans le chemin racine, soit vous séparez les répertoires "source" et "build" dans le chemin racine.�Vous devez maintenant compléter votre fichier principal %s et créer d'autres fichiers sources de documentation. �Votre recherche ne correspond à aucun document. Veuillez vérifier que les mots sont correctement orthographiés et que vous avez sélectionné assez de catégories.�[autosummary] échec de l'import de %r : %s�[autosummary] engendrement d’un auto-sommaire pour : %s�[autosummary] écriture dans %s�[docs]�[graphe: %s]�[graphe]�[image: %s]�[image]�[source]�__all__ devrait être une liste de chaînes, pas %r (dans module %s) -- __all__ sera ignoré�une erreur Unicode est survenue lors du rendu de la page %s. Veuillez vous assurer que toutes les valeurs de configuration comportant des caractères non-ASCII sont des chaînes Unicode.�une liste de fichiers spécifiques à reconstruire. Sera ignoré si l'option -a est spécifiée.�l'image appropriée pour le constructeur %s n'a pas été trouvée : %s�l'image appropriée pour le constructeur %s n'a pas été trouvée : %s (%s)�alias de %s�toutes les fonctions, classes, termes�tous les %d fichiers po�tous les fichiers source�ajoute module_path à la fin de sys.path, utilisé lorsque --full est présent�création du document unique�attribut�nom de l'auteur�autodoc : impossible de déterminer si %r est documenté; l'exception suivante a été levée : %s�insère automatiquement les docstrings des modules�tester automatiquement des extraits de code dans des blocs doctest�autosummary engendre les fichiers .rst de manière interne. Mais votre source_suffix ne contient pas .rst. Ignoré.�autosummary fait référence au document exclu %r. Ignoré�autosummary : impossible de déterminer si %r est documenté; l'exception suivante a été levée : %s�autosummary : fichier stub non trouvé %r. Vérifiez votre paramètre autosummary_generate.�autosummary_generate : fichier nontrouvé : %s�options tabularcolumns et :widths: simultanément présentes. :widths: sera ignoré.�lien mort: %s (%s)�La compilation %s, %s avertissement (avec les avertissements considérés comme des erreurs).�La compilation %s, %s avertissement.�La compilation %s, %s avertissements (avec les avertissements considérés comme des erreurs).�La compilation %s, %s avertissements.�La compilation %s.�version non à jour de l’environnement de construction�build parallèle avec N processus si possible (la valeur spéciale "auto" ajuste N à cpu-count)�le fichier de configuration de construction est corrompu : %r�constructeur à utiliser (par defaut: HTML)�Construction [%s] : �Construction en cours [mo] : �fonction de base�peut être énorme�impossible de combiner l'option -a avec le nom du fichier�impossible de copier le fichier téléchargeable %r: %s�copie des fichiers supplémentaires impossible %r�impossible de copier le fichier image %r: %s�impossible de copier le fichier static %r�fichier %r introuvable�impossible d'ouvrir le fichier des avertissements %r : %s�impossible de remplacer le paramètre de configuration %r par un type non-supporté ; ignoré�impossible d'écraser le dictionnaire de configuration %r ; ignoré (utilisez %r pour modifier les éléments individuellement)�impossible de lire le fichier image %r: il sera copié à la place�impossible d'écrire le fichier image %r: %s�la légende n'est pas à l'intérieur de la figure.�Vérification de la cohérence�vérification de la couverture de la documentation�table des matières avec une référence circulaire détectée, elle sera ignorée : %s <- %s�classe�méthode de classe�option de ligne de commande�concept�inclusion conditionnelle du contenu basé sur la valeur de configuration�le paramètre de configuration "epub_author" ne peut pas être vide pour EPUB3�le paramètre de configuration "epub_contributor" ne peut pas être vide pour EPUB3�le paramètre de configuration "epub_copyright" (ou "copyright") ne peut pas être vide pour EPUB3�le paramètre de configuration "epub_description" ne peut pas être vide pour EPUB3�le paramètre de configuration "epub_identifier" ne peut pas être vide pour EPUB3�la variable de configuration "epub_language" (ou "language") ne peut pas être vide pour EPUB3�le paramètre de configuration "epub_publisher" ne peut pas être vide pour EPUB3�le paramètre de configuration "epub_title" (ou "html_title") ne peut pas être vide pour EPUB3�le paramètre de configuration "epub_uid" ne peut pas être vide pour EPUB3�le paramètre de configuration "version" ne peut pas être vide pour EPUB3�la configuration a changé�Le dossier de configuration ne contient pas de fichier conf.py (%s)�options de la console de sortie�suite de la page précédente�suite sur la page suivante�la commande convert %r ne peut pas être exécutée; vérifiez le paramètre image_converter�convert a terminé avec une erreur : [stderr] %r [stdout] %r�Copie des fichiers de support TeX�Copie des fichiers de support TeX...�Copie des fichiers de support Texinfo�Copie de fichiers supplémentaires�Copie des fichiers téléchargeables... �Copie des fichiers complémentaires�Copie des images... �Copie des fichiers sources...�copie des fichiers statiques�impossible de lire %r pour la création du changelog�crée un fichier .nojekyll pour publier le document sur GitHub pages�créer un fichier batch�créer un fichier makefile�répertoire des templates spécifiques (par défaut : %(default)s)�données�rôle par défaut %s introuvable�extension par défaut pour les fichiers (par défaut : %(default)s)�définissez une variable de template�définit une balise : seules les blocs "only" avec TAG seront inclus�%s est invalide comme unité de dimension. Ignoré.�directive�la directive %r est déjà enregistrée, elle sera écrasée�option de directive�répertoire où placer toutes les sorties�répertoire où placer toutes les sorties�latex de type display %r : %s�émettre une sortie de couleur (par défaut : auto-détection)�ne pas créer un fichier batch�ne pas créer un fichier makefile�ne pas émettre une sortie de couleur (par défaut : auto-détection)�ne pas utiliser make-mode pour Makefile/make.bat�documents à écrire : %s�document�membres importés du document (défaut : %(default)s)�Le document n'est inclus dans aucune table des matières de l'arborescence.�langue du document�document illisible, il sera ignoré.�le titre du document n'est pas un unique node de type Text�sérialisation en cours %s�domaine %s déjà enregistré�domaine 1%s pas encore enregistré�ne pas créer de fichier de table des matières�ne pas créer de titres pour le module ou package (e.g. lorsque les doctrings en fournissent déjà)�module à importer pour auto-documenter %r est inconnu (essayer de placer une directive "module" ou "currentmodule" dans le document, ou de donner un nom de module explicite)�ne pas utiliser un environnement sauvegardé, relire toujours tous les fichiers�fait�dot code %r: %s�la commande dot %r ne peut pas être exécutée (nécessaire pour le rendu graphviz). Vérifiez le paramètre graphviz_dot�dot n'a pas produit de fichier de sortie : [stderr] %r [stdout] %r�dot a terminé avec une erreur : [stderr] %r [stdout] %r�le fichier téléchargé n’est pas lisible: %s�Export de l'inventaire des objets�Export de l'index de recherche dans %s�description de %s dupliquée pour%s; l'autre %s se trouve dans %s�description %s dupliquée pour %s; l'autre instance se trouve dans %s�citation dupliquée %s, une autre instance dans %s�description dupliquée pour %s %s; l'autre instance se trouve dans %s�libellé dupliqué %s, l'autre instance se trouve dans %s�Libellé dupliqué pour l'équation %s, autre instance dans %s�description dupliquée pour l'objet %s; l'autre instance se trouve dans %s, utilisez :noindex: sur l'une d'elles�Entrées dupliquées de la table des matières trouvées : %s�autoriser l'extension %s�active l'emploi d'extensions quelconques�quelques problèmes ont été rencontrés avec quelques uns des inventaires, mais ils disposaient d'alternatives fonctionnelles :�le titre de node rencontré n'est apparenté à aucun parmi section, topic, table, admonition ou sidebar�énumération�enumerable_node %r est déjà enregistré�énumérateur�variable d'environnement�variable d'environnement; %s�erreur pendant la mise en forme de l'argument %s:%s�erreur lors l'écriture du fichier %s : %s�erreur lors l'écriture du fichier Makefile : %s�exception�exception pendant l’évaluation de l'expression de la directive only : %s�l'extension %r n'a pas de fonction setup(); est-elle réellement un module d'extension de Sphinx ?�l'extension %r a renvoyé par sa fonction setup() un type d'objet non supporté ; elle devrait renvoyer None ou un dictionnaire de méta-données�options relatives aux extensions�les extensions ont changé�échoué�échec d’importation de l'object %s�échec de l’analyse du nom %s�échec d'accès à un quelconque inventaire, messages de contexte suivants :�échec : %s�le fichier de favicon %r n'existe pas �le fichier %r saisi en ligne de commande n'existe pas, il sera ignoré�le fichier %r saisi en ligne de commande n'est pas présent dans le dossier source, il sera ignoré�le fichier %r dans le dossier des thèmes n'est pas une archive zip valide ou ne contient aucun thème�extension du fichier (par défaut : rst)�nom du fichier de table des matières (défaut : modules)�s'est terminée avec des problèmes�patterns de fichier fnmatch-style et/ou répertoire à exclure�suivre les liens symboliques. Très utile en combinaison avec collective.recipe.omelette.�fonction�options générales�générer un projet complet avec sphinx-quickstart�Génération des index�le glossaire semble être mal formaté; vérifiez l'indentation�terme du glossaire�le terme du glossaire doit être précédé d'une ligne vide�les termes du glossaire ne doivent pas être séparés par des lignes vides�élément de grammaire�graphviz_output_format doit être « png » ou « svg », mais est %r�coloration syntaxique du code du module...�l'entrée html_extra_path %r n'existe pas�l'entrée html_extra_path %r se trouve à l'intérieur de outdir�l'entrée html_static_path %r n'existe pas�l'entrée html_static_path %r se trouve à l'intérieur de outdir�si spécifié, les répertoires source et build seront séparés�code doctest invalide ignoré : %r�fichier image %s illisible : %s�fichier image %s illisible �inclure le module "_private"�inclure des liens vers le code source documenté des objets Python�expressions mathématiques, traduites en images PNG ou SVG�expressions mathématiques, transmises dans le navigateur à MathJax�incohérences de références de citation dans le message traduit. Original : {0}, traduit : {1}�incohérences de références de notes de bas de page dans le message traduit. Original : {0}, traduit : {1} �incohérences de références dans le message traduit. Original : {0}, traduit : {1}�ncohérences de références de terme dans le message traduit. Original : {0}, traduit : {1}�augmenter la verbosité (peut être répété)�index�latex en ligne %r : %s�interprète les chemins de module selon la spécification PEP-0420 des espaces implicites de noms�l’identifiant intersphinx %r n'est pas une chaîne. Il sera ignoré�l’inventaire intersphinx a bougé : %s -> %s�type TestCode invalide�fichier CSS invalide : %r, le fichier sera ignoré�le fichier js_file : %r est invalide, il sera ignoré�nombre non valide %r pour l'option de configuration %r ; ignoré�format de numfig_format invalide : %s�format de numfig_format invalide : %s (%r)�regex invalide %r dans %s�regex invalide %r dans coverage_c_regexes�signature invalide pour auto%s (%r)�Le numéro du job doit être strictement positif�mot-clé�Les kwargs pour add_node() doivent être un tuple de fonction (visite, départ) : %r=%r�dernière modification�le numéro de ligne spécifiée est en dehors des limites (1-%d):%r�lien entre la documentation Sphinx de différents projets�lister l'ensemble des sections et sous-sections�chargement de l'inventaire intersphinx de %s...�Chargement de l'environnement pickled�chargement des traductions [%s]... �le répertoire locale_dir %s n'existe pas�le fichier de logo %r n'existe pas�Recherche des fichiers périmés... �macro�création du dossier de destinataire�nom du document principal�Nombre maximum de sous-modules visibles dans la table des matières (par défaut : 4)�membre�méthode�option '+' ou '-' manquante dans %s.�attribut manquant %s dans l'objet %s�module�le module %s ne pas être importé : %s�modules�plus d'une cible trouvée pour la référence %r de type 'any' : pourrait être %s�plusieurs cibles trouvées pour le renvoi %r : %s�nouvelle configuration�suivant�Chapitre suivant�mode sourcilleux, signale toute référence manquante�aucune valeur de configuration "latex_documents" trouvée; aucun document de sera généré�aucun valeur de configuration "man_pages" trouvée; aucun page du manuel ne sera enregistrée�aucun paramètre de configuration "texinfo_documents" trouvé: aucun document ne sera écrit�Aucune option Babel disponible pour la langue %r�aucun changement dans la version %s�pas de code ou sortie dans le bloc %s en %s : %s�aucune sortie du tout, même pas les avertissements�aucune sortie vers stdout, seulement les avertissements vers stderr�Aucune cible n'est périmée.�Le thème nommé %r n'a pas été trouvé (le fichier theme.conf est-il bien présent ?)�Aucun thème nommé %r n'est trouvé, hérité de %r�la classe de nœud %r est déjà enregistrée, ses visiteurs seront écrasés�aucun résultat�traductions indisponibles�le paramètre numfig est désactivé : le paramètre :numref: est ignoré�numfig_format n'est pas défini %s�objet�opérateur�entrée originale�outre passer un paramètre du fichier de configuration�remplacer les fichiers existants�page�la page %s correspond à deux modèles dans html_sidebars: %r et %r�passer une valeur aux templates HTML�chemin pour le cache d'environnement et de fichiers doctree (défaut : OUTPUTDIR/.doctrees) �chemin des fichiers sources de la documentation�chemin vers le module à documenter�chemin du répertoire de sortie�chemin dans lequel se trouve le fichier de configuration (conf.py). (valeur par défaut : identique à SOURCEDIR).�Environnement de sérialisation�Document en préparation�précédent�Chapitre précédent�primary_domain %r non trouvé; ignoré.�traitement en cours %s�option du programme�auteur(s) du projet, utilisé quand l'option -full est précisée�nom du projet�nom du projet (par défaut : nom du module principal)�révision du projet, utilisé lorsque --full est présent, par défaut reprend --doc-version�racine du projet�version du projet, utilisé quand l'option -full est précisée�propriété�afficher la documentation de chaque module sur sa propre page�mettre la documentation du module avant celle du sous-module�accès rapide à l'ensemble des modules�mode silencieux�Erreur de balise reST :�erreur de lecture : %s,%s�Lecture des sources... �lecture des gabarits... �étiquette de référence�version du projet�remplace le point dans _templates etc.�résolution des références...�role�le rôle %r est déjà enregistré, il sera écrasé�exécuter Pdb si une exception se produit.�exécuter le script sans créer les fichiers�rechercher�L'index de recherche n'a pas pu être chargé, mais tous les documents ne seront pas construits: l'index sera incomplet.�rechercher dans cette documentation�voir %s�voir aussi %s�une table des matières auto-référencée a été trouvée. Elle sera ignorée.�le paramètre %s.%s n'apparaît dans aucune des configurations de thème recherchées�montrer le retraçage complet en cas d'exception�arguments de signature ou annotation de return donnés pour l’automodule %s�ignoré�le répertoire racine a changé�préfixe des fichiers source�fichiers sources pour lesquels il faut produire des fichiers rST�source_parser pour %r est déjà enregistré�L'extension source %r est déjà enregistrée�sphinx-quickstart peut générer ces fichiers seulement dans un répertoire vide. Merci de spécifier un nouveau répertoire racine.�sphinx-quickstart n'écrasera pas un projet Sphinx existant.�sphinx-quickstart n'écrasera pas les fichiers existants.�état�méthode statique�a réussi�cibles périmées pour les fichiers po %d�cibles spécifiées pour les fichiers po %d�cibles périmées pour les fichiers sources %d�cibles pour les modèles de fichiers %d�répertoire des templates�l’extension %s ne se déclare pas compatible à la lecture en parallèle, on supposera qu’elle ne l'est pas - merci de demander à l'auteur de l’extension de vérifier ce qu’il en est et de le préciser explicitement�l’extension %s ne se déclare pas compatible à l’écriture en parallèle, on supposera qu’elle ne l’est pas - merci de demander à l'auteur de l’extension de vérifier ce qu’il en est et de le préciser explicitement�l'extension %s n'est pas compatible avec les lectures parallèles�l'extension %s n'est pas compatible avec les écritures parallèles�la documentation pour�l'extension %r a été intégrée à Sphinx depuis la version %s ; cette extension est ignorée.�le lien n'a pas de légende : %s�Le thème %r n'a pas de paramètre « inherit »�Le thème %r n'a pas de paramètre « theme »�la table des matières contient des références à des fichiers inexistants %r�la table des matières contient une référence à un document %r qui n'a pas de titre : aucun lien ne sera généré�le toctree contient une référence à des documents exclus %r�la table des matières contient des références à des documents inexistants %r�:maxdepth: trop grand, ignoré.�modifier les avertissements en erreurs�type�le caractère source est indécodable, il sera remplacé par "?" : %r�lablel non défini: 1%s�classe python non documentée: %s :: %s�fonction python non documentée: %s :: %s�méthode python non documentée: %s :: %s :: %s�type de node non-implémenté : %r�union�toplevel_sectioning %r inconnu pour la classe %r�paramètre de configuration %r inconnu dans override ; ignoré�nom de rôle ou de directive inconnu: %s:%s�type d'index saisie inconnu %r�le type inconnu d’entrée d’index %s a été trouvé�mimetype inconnu pour %s, il sera ignoré�type de node inconnu : %r�L'option %r n'est pas supportée pour ce thème�Mise à jour de l'environnement : �utilisé epub�utiliser make-mode pour Makefile/make.bat�n'utilisez aucun fichier de configuration, seulement l'option -D�variable�version du projet�En attente des processus parallélisés...�où « builder » est l'un des constructeurs disponibles, tel que html, latex, ou linkcheck.�lors de l'initialisation de l'extension %s :�avec -W, l'exécution se poursuit en cas d'avertissements�entrées "todo" pouvant être montrées ou cachées à la compilation�enregistrement des tous les fichiers (par défaut : enregistrement des nouveaux fichiers et des fichiers qui ont été modifiés)�écrire les avertissements (et les erreurs) vers le fichier spécifié�enregistrement�fichier %s en cours d'écriture...�Enregistrement des fichiers supplémentaires�écriture des pages additionnelles�enregistrement du fichier content.opf...�erreur d'écriture : %s,%s�écriture des catalogues de messages... �enregistrement du fichier nav.xhtml...�Écriture... �écriture du fichier de résumé...�enregistrement du fichier toc.ncx�������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fr/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000347414�00000000000�021165� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # ABOU SAMRA Jean <jean@abou-samra.fr>, 2020 # Adam Levine <adam.l.levine@gmail.com>, 2020 # Christophe CHAUVET <christophe.chauvet@gmail.com>, 2017 # Christophe CHAUVET <christophe.chauvet@gmail.com>, 2013,2015 # cyrille gachot <cyrille.gachot@smile.fr>, 2019 # Larlet David <david@larlet.fr>, 2008 # Denis Bitouzé <dbitouze@wanadoo.fr>, 2020-2021 # fgallaire <fgallaire@gmail.com>, 2010 # fgallaire <fgallaire@gmail.com>, 2010 # François Poirotte <clicky@erebot.net>, 2016-2017,2020 # Georg Brandl <g.brandl@gmx.net>, 2014 # Hugo Herbelin <Hugo.Herbelin@inria.fr>, 2021 # Jean-Daniel Browne <jeandaniel.browne@gmail.com>, 2010 # Jean-François B. <jfbu@free.fr>, 2017-2019 # Julien Palard <github@mandark.fr>, 2017 # Julien Malard <julien.malard@mail.mcgill.ca>, 2019 # Kim S. <kim.sylvestre@gmail.com>, 2019 # Larlet David <david@larlet.fr>, 2008 # LAURENT Raphaël <laurent@ined.fr>, 2018-2019 # 751bad527461b9b1a5628371fac587ce_51f5b30 <748bb51e7ee5d7c2fa68b9a5e88dc8fb_87395>, 2013-2014 # Nicolas Friedli <nicolas.friedli@gmail.com>, 2021 # Nikolaj van Omme <nikolaj.van.omme@gmail.com>, 2014-2015 # Olivier Bonaventure <bonaventure@acm.org>, 2019 # Pierre Grépon <pgrepon@yahoo.fr>, 2016 # Sebastien Douche <sdouche@gmail.com>, 2008 # Komiya Takeshi <i.tkomiya@gmail.com>, 2016,2020 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: French (http://www.transifex.com/sphinx-doc/sphinx-1/language/fr/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: fr\n" "Plural-Forms: nplurals=2; plural=(n > 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Impossible de trouver le répertoire source (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "Le répertoire de sortie (%s) n'est pas un répertoire" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Les dossiers source et destination ne doivent pas être identiques" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx v%s en cours d'exécution" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Ce projet nécessite au minimum Sphinx v%s et ne peut donc être construit avec cette version." #: sphinx/application.py:243 msgid "making output directory" msgstr "création du dossier de destinataire" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "lors de l'initialisation de l'extension %s :" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' tel que défini dans conf.py n'est pas un objet Python appelable. Veuillez modifier sa définition pour en faire une fonction appelable. Ceci est nécessaire pour que conf.py se comporte comme une extension Sphinx." #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "chargement des traductions [%s]... " #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "fait" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "traductions indisponibles" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "Chargement de l'environnement pickled" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "échec : %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "Aucun constructeur sélectionné, utilisation du défaut : html" #: sphinx/application.py:348 msgid "succeeded" msgstr "a réussi" #: sphinx/application.py:349 msgid "finished with problems" msgstr "s'est terminée avec des problèmes" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "La compilation %s, %s avertissement (avec les avertissements considérés comme des erreurs)." #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "La compilation %s, %s avertissements (avec les avertissements considérés comme des erreurs)." #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "La compilation %s, %s avertissement." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "La compilation %s, %s avertissements." #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "La compilation %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "la classe de nœud %r est déjà enregistrée, ses visiteurs seront écrasés" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "la directive %r est déjà enregistrée, elle sera écrasée" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "le rôle %r est déjà enregistré, il sera écrasé" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "l’extension %s ne se déclare pas compatible à la lecture en parallèle, on supposera qu’elle ne l'est pas - merci de demander à l'auteur de l’extension de vérifier ce qu’il en est et de le préciser explicitement" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "l'extension %s n'est pas compatible avec les lectures parallèles" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "l’extension %s ne se déclare pas compatible à l’écriture en parallèle, on supposera qu’elle ne l’est pas - merci de demander à l'auteur de l’extension de vérifier ce qu’il en est et de le préciser explicitement" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "l'extension %s n'est pas compatible avec les écritures parallèles" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "sérialisation en cours %s" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "Le dossier de configuration ne contient pas de fichier conf.py (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "impossible d'écraser le dictionnaire de configuration %r ; ignoré (utilisez %r pour modifier les éléments individuellement)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "nombre non valide %r pour l'option de configuration %r ; ignoré" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "impossible de remplacer le paramètre de configuration %r par un type non-supporté ; ignoré" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "paramètre de configuration %r inconnu dans override ; ignoré" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "Option de configuration inexistante : %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "L'option de configuration %r est déjà présente" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Votre fichier de configuration comporte une erreur de syntaxe : %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Le fichier de configuration (ou un des modules qu'il utilise) génère un sys.exit()" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "Votre fichier de configuration comporte une erreur de programmation : \n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "Le paramètre « source_suffix » s'attend à recevoir une chaîne de caractères, une liste de chaînes de caractères ou un dictionnaire. Mais vous avez fourni un « %r »." #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Section %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Fig. %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tableau %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Code source %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "La valeur « {current} » du paramètre « {name} » ne figure pas dans la liste des possibilités valables « {candidates} »." #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "Le type du paramètre de configuration « {name} » doit être {permitted} et non « {current.__name__} »." #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "Le paramètre de configuration « {name} » a pour type « {current.__name__} », tandis que le type par défaut est « {default.__name__} »." #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r non trouvé; ignoré." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "Depuis sa version 2.0, Sphinx utilise \"index\" comme root_doc par défaut. Veuillez ajouter \"root_doc = 'contents'\" à votre conf.py." #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "Évènement %r déjà présent" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Nom d'évènement inconnu : %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "L'extension %s est exigée par le paramètre needs_extensions, mais n'est pas chargée." #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "Ce projet nécessite que l'extension %s soit au minimum en version %s et par conséquent il ne peut pas être construit avec la version chargée (%s)." #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "Le nom du l'analyseur Pygments %r est inconnu" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "Analyse lexicale de literal_bloc impossible en \"%s\". Mise en évidence annulée." #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "document illisible, il sera ignoré." #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "La classe Builder %s n'a pas d'attribut « name »" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Le constructeur %r existe déjà (dans le module %s)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Le nom de Constructeur %s n'est ni enregistré ni accessible par point d'entrée" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "Constructeur %s non enregistré" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "domaine %s déjà enregistré" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "domaine 1%s pas encore enregistré" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "La directive %r est déjà enregistrée sur le domaine %s" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "Le rôle %r est déjà enregistré sur le domaine %s" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "L'index %r est déjà enregistré sur le domaine %s" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "Le type de l'objet %r est déjà enregistré" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "Le type %r crossref_type est déjà enregistré" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "L'extension source %r est déjà enregistrée" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "source_parser pour %r est déjà enregistré" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "source_parser pour %s non enregistré" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "Il existe déjà un traducteur pour %r" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "Les kwargs pour add_node() doivent être un tuple de fonction (visite, départ) : %r=%r" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "enumerable_node %r est déjà enregistré" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "l'extension %r a été intégrée à Sphinx depuis la version %s ; cette extension est ignorée." #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "Exception initiale :\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "L'extension %s ne peut pas être importée" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "l'extension %r n'a pas de fonction setup(); est-elle réellement un module d'extension de Sphinx ?" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "L'extension %s utilisée par ce projet nécessite au moins Sphinx v%s ; il ne peut donc pas être construit avec la version courante." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "l'extension %r a renvoyé par sa fonction setup() un type d'objet non supporté ; elle devrait renvoyer None ou un dictionnaire de méta-données" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "Le thème %r n'a pas de paramètre « theme »" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "Le thème %r n'a pas de paramètre « inherit »" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "Aucun thème nommé %r n'est trouvé, hérité de %r" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "le paramètre %s.%s n'apparaît dans aucune des configurations de thème recherchées" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "L'option %r n'est pas supportée pour ce thème" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "le fichier %r dans le dossier des thèmes n'est pas une archive zip valide ou ne contient aucun thème" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "Le thème nommé %r n'a pas été trouvé (le fichier theme.conf est-il bien présent ?)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "l'image appropriée pour le constructeur %s n'a pas été trouvée : %s (%s)" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "l'image appropriée pour le constructeur %s n'a pas été trouvée : %s" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "Construction en cours [mo] : " #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "Écriture... " #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "tous les %d fichiers po" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "cibles spécifiées pour les fichiers po %d" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "cibles périmées pour les fichiers po %d" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "tous les fichiers source" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "le fichier %r saisi en ligne de commande n'est pas présent dans le dossier source, il sera ignoré" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "le fichier %r saisi en ligne de commande n'existe pas, il sera ignoré" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "%d fichiers source saisis en ligne de commande" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "cibles périmées pour les fichiers sources %d" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "Construction [%s] : " #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "Recherche des fichiers périmés... " #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "%d trouvé" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "aucun résultat" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "Environnement de sérialisation" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "Vérification de la cohérence" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "Aucune cible n'est périmée." #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "Mise à jour de l'environnement : " #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "%s ajouté(s), %s modifié(s), %s supprimé(s)" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "Lecture des sources... " #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "En attente des processus parallélisés..." #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "documents à écrire : %s" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "Document en préparation" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "Entrées dupliquées de la table des matières trouvées : %s" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "Copie des images... " #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "impossible de lire le fichier image %r: il sera copié à la place" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "impossible de copier le fichier image %r: %s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "impossible d'écrire le fichier image %r: %s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "Pillow introuvable - copie des fichiers image" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "enregistrement du fichier content.opf..." #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "mimetype inconnu pour %s, il sera ignoré" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "enregistrement du fichier toc.ncx" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "fichier %s en cours d'écriture..." #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "Le fichier d'aperçu se trouve dans %(outdir)s." #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "aucun changement dans la version %s" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "écriture du fichier de résumé..." #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Fonctions de base" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Module" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "Copie des fichiers sources..." #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "impossible de lire %r pour la création du changelog" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "Le constructeur factice ne génère aucun fichier." #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "Le fichier ePub se trouve dans %(outdir)s ." #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "enregistrement du fichier nav.xhtml..." #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "la variable de configuration \"epub_language\" (ou \"language\") ne peut pas être vide pour EPUB3" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "le paramètre de configuration \"epub_uid\" ne peut pas être vide pour EPUB3" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "le paramètre de configuration \"epub_title\" (ou \"html_title\") ne peut pas être vide pour EPUB3" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "le paramètre de configuration \"epub_author\" ne peut pas être vide pour EPUB3" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "le paramètre de configuration \"epub_contributor\" ne peut pas être vide pour EPUB3" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "le paramètre de configuration \"epub_description\" ne peut pas être vide pour EPUB3" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "le paramètre de configuration \"epub_publisher\" ne peut pas être vide pour EPUB3" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "le paramètre de configuration \"epub_copyright\" (ou \"copyright\") ne peut pas être vide pour EPUB3" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "le paramètre de configuration \"epub_identifier\" ne peut pas être vide pour EPUB3" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "le paramètre de configuration \"version\" ne peut pas être vide pour EPUB3" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "fichier CSS invalide : %r, le fichier sera ignoré" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "La liste des messages se trouve dans %(outdir)s." #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "cibles pour les modèles de fichiers %d" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "lecture des gabarits... " #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "écriture des catalogues de messages... " #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "Recherchez les éventuelles erreurs dans la sortie ci-dessus ou dans %(outdir)s/output.txt" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "lien mort: %s (%s)" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "Ancre '%s' non trouvée" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "Le manuel se trouve dans %(outdir)s." #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "aucun valeur de configuration \"man_pages\" trouvée; aucun page du manuel ne sera enregistrée" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "enregistrement" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "le paramètre de configuration \"man_pages\" référence un document inconnu %s" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "Les pages HTML sont dans %(outdir)s." #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "création du document unique" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "Enregistrement des fichiers supplémentaires" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "Les fichiers Texinfo se trouvent dans %(outdir)s." #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "\nExécuter 'make' dans ce répertoire pour les soumettre à makeinfo\n(ou 'make info' directement ici pour l'automatiser)." #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "aucun paramètre de configuration \"texinfo_documents\" trouvé: aucun document ne sera écrit" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "La valeur du paramètre \"texinfo_documents\" référence un document inconnu %s" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "traitement en cours %s" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "résolution des références..." #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "(dans" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "Copie des fichiers de support Texinfo" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "erreur lors l'écriture du fichier Makefile : %s" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "Les fichiers texte se trouvent dans %(outdir)s." #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "erreur lors l'écriture du fichier %s : %s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "Les fichiers XML se trouvent dans %(outdir)s." #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "Le fichier pseudo-XML se trouve dans %(outdir)s." #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "le fichier de configuration de construction est corrompu : %r" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "Les pages HTML sont dans %(outdir)s." #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "Échec de lecture du fichier de configuration de construction : %r" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Index général" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "index" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "suivant" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "précédent" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "Génération des index" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "écriture des pages additionnelles" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "Copie des fichiers téléchargeables... " #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "impossible de copier le fichier téléchargeable %r: %s" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "copie des fichiers statiques" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "impossible de copier le fichier static %r" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "Copie des fichiers complémentaires" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "copie des fichiers supplémentaires impossible %r" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "Échec d'écriture du fichier de configuration de construction : %r" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "L'index de recherche n'a pas pu être chargé, mais tous les documents ne seront pas construits: l'index sera incomplet." #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "la page %s correspond à deux modèles dans html_sidebars: %r et %r" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "une erreur Unicode est survenue lors du rendu de la page %s. Veuillez vous assurer que toutes les valeurs de configuration comportant des caractères non-ASCII sont des chaînes Unicode." #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "Un erreur est survenue lors de la génération de la page: %s.\nLa raison est: %r" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "Export de l'inventaire des objets" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "Export de l'index de recherche dans %s" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "le fichier js_file : %r est invalide, il sera ignoré" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "Plusieurs math_renderers sont enregistrés. Mais aucun n'est sélectionné." #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "math_renderer saisi %r inconnu." #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "l'entrée html_extra_path %r n'existe pas" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "l'entrée html_extra_path %r se trouve à l'intérieur de outdir" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "l'entrée html_static_path %r n'existe pas" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "l'entrée html_static_path %r se trouve à l'intérieur de outdir" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "le fichier de logo %r n'existe pas" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "le fichier de favicon %r n'existe pas " #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "Documentation %s %s" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "Les fichiers LaTex se trouvent dans %(outdir)s." #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\nExécuter 'make' dans ce répertoire pour les soumettre à (pdf)latex\n(ou 'make latexpdf' directement ici pour l’automatiser)." #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "aucune valeur de configuration \"latex_documents\" trouvée; aucun document de sera généré" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "La valeur du paramètre \"latex_documents\" référence un document inconnu %s" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Index" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Version" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "Aucune option Babel disponible pour la langue %r" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "Copie des fichiers de support TeX" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "Copie des fichiers de support TeX..." #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "Copie de fichiers supplémentaires" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "Clé de configuration inconnue : latex_elements[%r]; ignorée." #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "%r n'a pas d'option « theme »" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "%r n'a pas d'option « %s »" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "Une exception a été levée lors de la génération, démarrage du débogueur :" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "Interrompu !" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "Erreur de balise reST :" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "Erreur d'encodage :" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "Le traceback complet a été sauvé dans %s, au cas où vous souhaiteriez signaler le problème aux développeurs." #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "Erreur de récursion :" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "Cela peut se produire avec des fichiers sources très volumineux ou profondément imbriqués. Vous pouvez augmenter avec attention la limite de récursivité par défaut de Python de 1000 dans conf.py avec p. ex. :" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "Une exception a été levée :" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "Merci de rapporter ceci s'il s'agit d'une erreur utilisateur, afin d'améliorer le message d'erreur à l'avenir." #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "Un rapport d'erreur peut être déposé dans le système de tickets à <https://github.com/sphinx-doc/sphinx/issues>. Merci !" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "Le numéro du job doit être strictement positif" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "chemin des fichiers sources de la documentation" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "chemin du répertoire de sortie" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "une liste de fichiers spécifiques à reconstruire. Sera ignoré si l'option -a est spécifiée." #: sphinx/cmd/build.py:133 msgid "general options" msgstr "options générales" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "constructeur à utiliser (par defaut: HTML)" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "enregistrement des tous les fichiers (par défaut : enregistrement des nouveaux fichiers et des fichiers qui ont été modifiés)" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "ne pas utiliser un environnement sauvegardé, relire toujours tous les fichiers" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "chemin pour le cache d'environnement et de fichiers doctree (défaut : OUTPUTDIR/.doctrees) " #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "build parallèle avec N processus si possible (la valeur spéciale \"auto\" ajuste N à cpu-count)" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "chemin dans lequel se trouve le fichier de configuration (conf.py). (valeur par défaut : identique à SOURCEDIR)." #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "n'utilisez aucun fichier de configuration, seulement l'option -D" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "outre passer un paramètre du fichier de configuration" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "passer une valeur aux templates HTML" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "définit une balise : seules les blocs \"only\" avec TAG seront inclus" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "mode sourcilleux, signale toute référence manquante" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "options de la console de sortie" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "augmenter la verbosité (peut être répété)" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "aucune sortie vers stdout, seulement les avertissements vers stderr" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "aucune sortie du tout, même pas les avertissements" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "émettre une sortie de couleur (par défaut : auto-détection)" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "ne pas émettre une sortie de couleur (par défaut : auto-détection)" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "écrire les avertissements (et les erreurs) vers le fichier spécifié" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "modifier les avertissements en erreurs" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "avec -W, l'exécution se poursuit en cas d'avertissements" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "montrer le retraçage complet en cas d'exception" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "exécuter Pdb si une exception se produit." #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "fichier %r introuvable" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "impossible de combiner l'option -a avec le nom du fichier" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "impossible d'ouvrir le fichier des avertissements %r : %s" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "l'option -D doit être sous la forme nom=valeur" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "l'option -A doit être sous la forme nom=valeur" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "insère automatiquement les docstrings des modules" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "tester automatiquement des extraits de code dans des blocs doctest" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "lien entre la documentation Sphinx de différents projets" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "entrées \"todo\" pouvant être montrées ou cachées à la compilation" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "vérification de la couverture de la documentation" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "expressions mathématiques, traduites en images PNG ou SVG" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "expressions mathématiques, transmises dans le navigateur à MathJax" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "inclusion conditionnelle du contenu basé sur la valeur de configuration" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "inclure des liens vers le code source documenté des objets Python" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "crée un fichier .nojekyll pour publier le document sur GitHub pages" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "Merci de saisir un chemin valide." #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "Merci de saisir du texte." #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "Merci de saisir un des %s." #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "Merci de saisir 'y' ou 'n'." #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "Merci de saisir l'extension du fichier, par exemple '.rst' ou '.txt'." #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "Bienvenue dans le kit de démarrage rapide de Sphinx %s." #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "Veuillez saisir des valeurs pour les paramètres suivants (tapez Entrée pour accepter la valeur par défaut, lorsque celle-ci est indiquée entre crochets)." #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "Chemin racine sélectionné : %s" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "Saisissez le répertoire racine de la documentation." #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "racine de la documentation." #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "Erreur : un fichier conf.py a été trouvé dans le répertoire racine." #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "sphinx-quickstart n'écrasera pas un projet Sphinx existant." #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "Merci de saisir un nouveau répertoire racine (ou tapez juste Entrée)" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "Vous avez deux options pour l'emplacement du répertoire de construction de la sortie de Sphinx.\nSoit vous utilisez un répertoire \"_build\" dans le chemin racine, soit vous séparez les répertoires \"source\" et \"build\" dans le chemin racine." #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "Séparer les répertoires build et source (y/n)" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "Dans le répertoire racine, deux autres répertoires seront créés : \"_templates\" pour les modèles HTML personnalisés et \"_static\" pour les feuilles de style personnalisées et autres fichiers statiques. Vous pouvez entrer un autre préfixe (p. ex. \".\") pour remplacer le tiret bas (\"_\")." #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "Préfixe de nom pour les répertoires static et de gabarits (templates)" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "Le nom du projet apparaîtra à plusieurs endroits dans la documentation construite." #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "Nom du projet" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "Nom(s) de l'auteur" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "Version du projet" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "version du projet" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "Si les documents doivent être rédigés dans une langue autre que l’anglais, vous pouvez sélectionner une langue ici grâce à son identifiant. Sphinx utilisera ensuite cette langue pour traduire les textes que lui-même génère.\n\nPour une liste des identifiants supportés, voir\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "Langue du projet" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "Extension des fichiers sources" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "Un document est particulier en ce sens qu'il est considéré comme le nœud supérieur de \"l'arbre des contenus\", c'est-à-dire la racine de la structure hiérarchique des documents. Normalement, il s'agit d'un \"index\", mais si votre \"index\" est un modèle personnalisé, vous pouvez également le définir sous un autre nom de fichier." #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "Non du fichier principal (sans extension)" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "Erreur : le fichier principal %s est déjà présent dans le répertoire racine du projet." #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "sphinx-quickstart n'écrasera pas les fichiers existants." #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "Merci de saisir un nouveau nom de fichier, ou de renommer le fichier existant et valider avec Entrée" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "Indiquer lesquelles de ces extensions Sphinx doivent être activées :" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "Note : imgmath et mathjax ne peuvent pas être activés en même temps. imgmath a été désactivé." #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "Un fichier Makefile et un fichier de commandes Windows peuvent être générés pour vous, afin que vous puissiez exécuter par exemple `make html' au lieu d'appeler directement sphinx-build." #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "Création du Makefile ? (y/n)" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "Création du fichier de commandes Windows ? (y/n)" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "Fichier en cours de création %s." #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "Le fichier %s existe déjà, il ne sera pas remplacé" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "Terminé : la structure initiale a été créée." #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "Vous devez maintenant compléter votre fichier principal %s et créer d'autres fichiers sources de documentation. " #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "Utilisez le Makefile pour construire la documentation comme ceci :\n make builder" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "Utilisez sphinx-build pour construire la documentation comme ceci : \n sphinx-build -b builder %s %s" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "où « builder » est l'un des constructeurs disponibles, tel que html, latex, ou linkcheck." #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "\nEngendre les fichiers requis pour un projet Sphinx.\n\nsphinx-quickstart est un outil interactif qui pose des questions à propos de votre projet et génère un répertoire avec la structure complète nécessaire ainsi qu'un Makefile qui peut être utilisé comme alternative à sphinx-build.\n" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "mode silencieux" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "racine du projet" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "Options de structure" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "si spécifié, les répertoires source et build seront séparés" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "remplace le point dans _templates etc." #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "Options basiques du projet." #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "nom du projet" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "nom de l'auteur" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "version du projet" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "version du projet" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "langue du document" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "préfixe des fichiers source" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "nom du document principal" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "utilisé epub" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "Options d'extension" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "autoriser l'extension %s" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "active l'emploi d'extensions quelconques" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "Création des fichiers Batchfile et Makefile" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "créer un fichier makefile" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "ne pas créer un fichier makefile" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "créer un fichier batch" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "ne pas créer un fichier batch" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "utiliser make-mode pour Makefile/make.bat" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "ne pas utiliser make-mode pour Makefile/make.bat" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "Gabarits de projet" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "répertoire des templates" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "définissez une variable de template" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "vous avez spécifiez \"quit\" , mais \"project\" ou \"author\" ne sont pas spécifiés." #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "Erreur : le chemin spécifié n'est pas un répertoire, ou les fichiers Sphinx existent déjà." #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "sphinx-quickstart peut générer ces fichiers seulement dans un répertoire vide. Merci de spécifier un nouveau répertoire racine." #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "Variable de template invalide : %s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "Légende invalide: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "le numéro de ligne spécifiée est en dehors des limites (1-%d):%r" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "Impossible d'utiliser les options \"%s\" et \"%s\" en même temps." #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "Le fichier d'include %r est introuvable ou sa lecture a échouée." #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "L’encodage %r utilisé pour lire le fichier inclus %r semble erroné, veuillez ajouter une option :encoding:" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "L'objet nommé %r est introuvable dans le fichier d'include %r" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "On ne peut pas utiliser \"lineno-match\" avec un \"lines\" non contigu " #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "Spécification de lignes %r : aucune ligne extraite du fichier inclus %r" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Auteur de la section : " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Auteur du module : " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Auteur du code : " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Auteur : " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Paramètres" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Renvoie" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Type renvoyé" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "membre" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "variable" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "fonction" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "macro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "union" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "énumération" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "énumérateur" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "type" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Nouveau dans la version %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Modifié dans la version %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Obsolète depuis la version %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "citation dupliquée %s, une autre instance dans %s" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "La citation [%s] n'est pas référencée" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Paramètres du modèle" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Déclenche" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "classe" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "concept" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (fonction de base)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (méthode %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (classe)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (variable globale ou constante)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (attribut %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Arguments" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (module)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "méthode" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "données" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "attribut" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "module" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "description de %s dupliquée pour%s; l'autre %s se trouve dans %s" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "Libellé dupliqué pour l'équation %s, autre instance dans %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "math_eqref_format invalide : %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "mot-clé" #: sphinx/domains/python.py:60 msgid "operator" msgstr "opérateur" #: sphinx/domains/python.py:61 msgid "object" msgstr "objet" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "exception" #: sphinx/domains/python.py:63 msgid "statement" msgstr "état" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "fonction de base" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Variables" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Lève" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (dans le module %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (dans le module %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (variable de base)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (classe de base)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (classe dans %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (méthode de la classe %s)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (méthode statique %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Index des modules Python" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "modules" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Obsolète" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "méthode de classe" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "méthode statique" #: sphinx/domains/python.py:1176 msgid "property" msgstr "propriété" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "description dupliquée pour l'objet %s; l'autre instance se trouve dans %s, utilisez :noindex: sur l'une d'elles" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "plusieurs cibles trouvées pour le renvoi %r : %s" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (obsolète)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (directive)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr ":%s: (option de directive)" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (role)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "directive" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "option de directive" #: sphinx/domains/rst.py:210 msgid "role" msgstr "role" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "description dupliquée pour %s %s; l'autre instance se trouve dans %s" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "variable d'environnement; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "description de l'option malformée, elle doit ressembler à \nMalformed option description %r, should look like \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" or \"+opt args\"" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "option de ligne de commande %s" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "option de ligne de commande" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "le terme du glossaire doit être précédé d'une ligne vide" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "les termes du glossaire ne doivent pas être séparés par des lignes vides" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "le glossaire semble être mal formaté; vérifiez l'indentation" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "terme du glossaire" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "élément de grammaire" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "étiquette de référence" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "variable d'environnement" #: sphinx/domains/std.py:568 msgid "program option" msgstr "option du programme" #: sphinx/domains/std.py:569 msgid "document" msgstr "document" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Index du module" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Page de recherche" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "libellé dupliqué %s, l'autre instance se trouve dans %s" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "description %s dupliquée pour %s; l'autre instance se trouve dans %s" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "le paramètre numfig est désactivé : le paramètre :numref: est ignoré" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "Impossible de créer une référence croisée. Aucun nombre n'est attribué: %s" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "le lien n'a pas de légende : %s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "format de numfig_format invalide : %s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "format de numfig_format invalide : %s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "lablel non défini: 1%s" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "Impossible de créer une référence croisée. Titre ou légende introuvable: %s" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "nouvelle configuration" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "la configuration a changé" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "les extensions ont changé" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "version non à jour de l’environnement de construction" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "le répertoire racine a changé" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "Cet environnement est incompatible avec le constructeur sélectionné, veuillez choisir un autre répertoire doctree." #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "Échec du scan des documents dans %s : %r" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "le domaine %r n'est pas enregistré." #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "une table des matières auto-référencée a été trouvée. Elle sera ignorée." #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "Le document n'est inclus dans aucune table des matières de l'arborescence." #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "voir %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "voir aussi %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "type d'index saisie inconnu %r" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Symboles" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "table des matières avec une référence circulaire détectée, elle sera ignorée : %s <- %s" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "la table des matières contient une référence à un document %r qui n'a pas de titre : aucun lien ne sera généré" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "le toctree contient une référence à des documents exclus %r" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "la table des matières contient des références à des documents inexistants %r" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "fichier image %s illisible " #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "fichier image %s illisible : %s" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "le fichier téléchargé n’est pas lisible: %s" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "%s a déjà des numéros de section attribués (toctree numérotés emboîtés ?)" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "Créerait le fichier %s." #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "\nCherche récursivement dans <MODULE_PATH> des modules et packages Python et crée\ndans <OUTPUT_PATH> un fichier reST par package avec des directives automodule.\n\nLes <EXCLUDE_PATTERN>s peuvent être tout pattern de fichiers et/ou de répertoires à exclure.\n\nNote : par défaut ce script n'écrasera pas des fichiers déjà créés." #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "chemin vers le module à documenter" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "patterns de fichier fnmatch-style et/ou répertoire à exclure" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "répertoire où placer toutes les sorties" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "Nombre maximum de sous-modules visibles dans la table des matières (par défaut : 4)" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "remplacer les fichiers existants" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "suivre les liens symboliques. Très utile en combinaison avec collective.recipe.omelette." #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "exécuter le script sans créer les fichiers" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "afficher la documentation de chaque module sur sa propre page" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "inclure le module \"_private\"" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "nom du fichier de table des matières (défaut : modules)" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "ne pas créer de fichier de table des matières" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "ne pas créer de titres pour le module ou package (e.g. lorsque les doctrings en fournissent déjà)" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "mettre la documentation du module avant celle du sous-module" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "interprète les chemins de module selon la spécification PEP-0420 des espaces implicites de noms" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "extension du fichier (par défaut : rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "générer un projet complet avec sphinx-quickstart" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "ajoute module_path à la fin de sys.path, utilisé lorsque --full est présent" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "nom du projet (par défaut : nom du module principal)" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "auteur(s) du projet, utilisé quand l'option -full est précisée" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "version du projet, utilisé quand l'option -full est précisée" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "révision du projet, utilisé lorsque --full est présent, par défaut reprend --doc-version" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "options relatives aux extensions" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s n'est pas un répertoire" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "regex invalide %r dans %s" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "Vérification du taux de couverture documentaire dans les sources achevée, voir les résultats dans %(outdir)spython.txt." #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "regex invalide %r dans coverage_c_regexes" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "le module %s ne pas être importé : %s" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "fonction python non documentée: %s :: %s" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "classe python non documentée: %s :: %s" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "méthode python non documentée: %s :: %s :: %s" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "option '+' ou '-' manquante dans %s." #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "'%s' n'est pas une option valide." #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "%s n'est pas une option pyversion valide" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "type TestCode invalide" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "Exécution des doctests des sources achevée, voir les résultats dans %(outdir)s/output.txt." #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "pas de code ou sortie dans le bloc %s en %s : %s" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "code doctest invalide ignoré : %r" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "====================== durées de lecture les plus lentes =======================" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "La directive Graphviz ne peut pas avoir simultanément du contenu et un argument de nom de fichier" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "Fichier externe Graphviz %r non trouvé ou échec de sa lecture" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "Directive « graphviz » sans contenu ignorée." #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot n'a pas produit de fichier de sortie : \n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "la commande dot %r ne peut pas être exécutée (nécessaire pour le rendu graphviz). Vérifiez le paramètre graphviz_dot" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot a terminé avec une erreur :\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "graphviz_output_format doit être « png » ou « svg », mais est %r" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "dot code %r: %s" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[graphe: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[graphe]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "convert a terminé avec une erreur :\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "la commande convert %r ne peut pas être exécutée; vérifiez le paramètre image_converter" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "La commande LaTeX %r (nécessaire pour le rendu des équations mathématiques), ne peut pas être exécutée, vérifier le paramètre imgmath_latex" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "La commande de %s, %r, ne pas être exécuté (nécessaire pour display mathématique), vérifier la configuration imgmath_%s" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "latex de type display %r : %s" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "latex en ligne %r : %s" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Lien permanent vers cette équation" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "l’inventaire intersphinx a bougé : %s -> %s" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "chargement de l'inventaire intersphinx de %s..." #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "quelques problèmes ont été rencontrés avec quelques uns des inventaires, mais ils disposaient d'alternatives fonctionnelles :" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "échec d'accès à un quelconque inventaire, messages de contexte suivants :" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(disponible dans %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(dans %s)" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "l’identifiant intersphinx %r n'est pas une chaîne. Il sera ignoré" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "Échec de la lecture de intersphinx_mapping[%s]; ignoré : %r" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[source]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "À faire" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "Entrée TODO trouvée : %s" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<entrée originale>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(l'<<entrée originale>> se trouve dans %s, à la ligne %d)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "entrée originale" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "coloration syntaxique du code du module..." #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[docs]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Code du module" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Code source de %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Vue d'ensemble : code du module" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Modules pour lesquels le code est disponible</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "signature invalide pour auto%s (%r)" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "erreur pendant la mise en forme de l'argument %s:%s" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "attribut manquant %s dans l'objet %s" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "autodoc : impossible de déterminer si %r est documenté; l'exception suivante a été levée :\n%s" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "module à importer pour auto-documenter %r est inconnu (essayer de placer une directive \"module\" ou \"currentmodule\" dans le document, ou de donner un nom de module explicite)" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "\"::\" dans le nom d'automodule n'a pas de sens" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "arguments de signature ou annotation de return donnés pour l’automodule %s" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "__all__ devrait être une liste de chaînes, pas %r (dans module %s) -- __all__ sera ignoré" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "Bases : %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "alias de %s" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "Échec de l'analyse de type_comment pour %r : %s" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "autosummary fait référence au document exclu %r. Ignoré" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary : fichier stub non trouvé %r. Vérifiez votre paramètre autosummary_generate." #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "échec de l’analyse du nom %s" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "échec d’importation de l'object %s" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate : fichier nontrouvé : %s" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "autosummary engendre les fichiers .rst de manière interne. Mais votre source_suffix ne contient pas .rst. Ignoré." #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "autosummary : impossible de déterminer si %r est documenté; l'exception suivante a été levée :\n%s" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[autosummary] engendrement d’un auto-sommaire pour : %s" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "[autosummary] écriture dans %s" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "[autosummary] échec de l'import de %r : %s" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "\nEngendre du ReStructuredText par les directives autosummary.\n\nsphinx-autogen est une interface à sphinx.ext.autosummary.generate. Il\nengendre les fichiers reStructuredText à partir des directives autosummary\ncontenues dans les fichiers donnés en entrée.\n\nLe format de la directive autosummary est documentée dans le module\nPython \"sphinx.ext.autosummary\" et peut être lu via : ::\n\npydoc sphinx.ext.autosummary\n" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "fichiers sources pour lesquels il faut produire des fichiers rST" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "répertoire où placer toutes les sorties" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "extension par défaut pour les fichiers (par défaut : %(default)s)" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "répertoire des templates spécifiques (par défaut : %(default)s)" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "membres importés du document (défaut : %(default)s)" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "Arguments de mots-clés" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "Exemple" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Exemples" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "Notes" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "Autres paramètres" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "Références" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "Avertissements" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "Yields" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Attention" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Prudence" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Danger" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Erreur" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Indication" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Important" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Note" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Voir aussi" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Astuce" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Avertissement" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "suite de la page précédente" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "suite sur la page suivante" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "Non alphabétique" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "Chiffres" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "page" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "Table des matières" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Recherche" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Go" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Montrer le code source" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Résumé" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Bienvenue ! Ceci est" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "la documentation pour" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "dernière modification" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Indices et tables :" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Table des matières complète" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "lister l'ensemble des sections et sous-sections" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "rechercher dans cette documentation" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Index général des modules" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "accès rapide à l'ensemble des modules" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "toutes les fonctions, classes, termes" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Index – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Index complet sur une seule page" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Indexer les pages par lettre" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "peut être énorme" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigation" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Recherchez dans %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "À propos de ces documents" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Copyright" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Copyright %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Mis à jour le %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Rechercher %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Sujet précédent" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "Chapitre précédent" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Sujet suivant" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "Chapitre suivant" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Veuillez activer le JavaScript pour que la recherche fonctionne." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "Une recherche sur plusieurs mots ne retourne que les résultats contenant tous les mots." #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "rechercher" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Résultats de la recherche" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Votre recherche ne correspond à aucun document. Veuillez vérifier que les mots sont correctement orthographiés et que vous avez sélectionné assez de catégories." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Recherche rapide" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Cette page" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Changements dans la version %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Liste auto-générée des modifications dans la version %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Modifications de la bibliothèque" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Modifications de l'API C" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Autres modifications" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Lien permanent vers ce titre" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Lien permanent vers cette définition" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Cacher les résultats de la recherche" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Recherche en cours" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Préparation de la recherche..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "La recherche est finie, %s page(s) trouvée(s) qui corresponde(nt) à la recherche." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", dans" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Agrandir la barre latérale" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Réduire la barre latérale" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Contenu" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "index trouvé avec style ancien à 4 colonnes. Possiblement un bogue d’extensions que vous utilisez : %r" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "La note de bas de page [%s] n'est pas référencée." #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "La note de bas de page [#] n'est pas référencée." #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "incohérences de références de notes de bas de page dans le message traduit. Original : {0}, traduit : {1} " #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "incohérences de références dans le message traduit. Original : {0}, traduit : {1}" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "incohérences de références de citation dans le message traduit. Original : {0}, traduit : {1}" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "ncohérences de références de terme dans le message traduit. Original : {0}, traduit : {1}" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "plus d'une cible trouvée pour la référence %r de type 'any' : pourrait être %s" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "impossible d'atteindre l'image distante %s[%d]" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "impossible d'atteindre l'image distante %s[%s]" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "Format d'image inconnu : %s..." #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "le caractère source est indécodable, il sera remplacé par \"?\" : %r" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "ignoré" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "échoué" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "nom de rôle ou de directive inconnu: %s:%s" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "erreur de lecture : %s,%s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "erreur d'écriture : %s,%s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "le répertoire locale_dir %s n'existe pas" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "Format de date invalide. Insérez la chaîne de caractères entre des guillemets simples si vous voulez l'afficher telle quelle : %s" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "la table des matières contient des références à des fichiers inexistants %r" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "exception pendant l’évaluation de l'expression de la directive only : %s" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "rôle par défaut %s introuvable" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "numfig_format n'est pas défini %s" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "Aucun ID assigné au node %s" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "Lien permanent vers ce terme" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Lien permanent vers ce tableau" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Lien permanent vers ce code" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Lien permanent vers cette image" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Lien permanent vers cette table des matières" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "impossible d'obtenir la taille de l'image. L'option :scale: est ignorée." #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "toplevel_sectioning %r inconnu pour la classe %r" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr ":maxdepth: trop grand, ignoré." #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "le titre du document n'est pas un unique node de type Text" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "le titre de node rencontré n'est apparenté à aucun parmi section, topic, table, admonition ou sidebar" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Notes de bas de page" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "options tabularcolumns et :widths: simultanément présentes. :widths: sera ignoré." #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "%s est invalide comme unité de dimension. Ignoré." #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "le type inconnu d’entrée d’index %s a été trouvé" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[image: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[image]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "la légende n'est pas à l'intérieur de la figure." #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "type de node non-implémenté : %r" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "type de node inconnu : %r" ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3263798 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fr_FR/�������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016101� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.482064 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fr_FR/LC_MESSAGES/�������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017666� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.js����������������������������������������������0000644�0000766�0000024�00000004605�00000000000�021542� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "fr_FR", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n > 1)" });���������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.mo����������������������������������������������0000644�0000766�0000024�00000001000�00000000000�021523� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$���������������,�����-����Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-10-31 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: fr_FR Language-Team: French (France) (http://www.transifex.com/sphinx-doc/sphinx-1/language/fr_FR/) Plural-Forms: nplurals=2; plural=(n > 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/fr_FR/LC_MESSAGES/sphinx.po����������������������������������������������0000644�0000766�0000024�00000241442�00000000000�021546� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-10-31 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: French (France) (http://www.transifex.com/sphinx-doc/sphinx-1/language/fr_FR/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: fr_FR\n" "Plural-Forms: nplurals=2; plural=(n > 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:430 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1166 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1173 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1167 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:421 msgid "Variables" msgstr "" #: sphinx/domains/python.py:425 msgid "Raises" msgstr "" #: sphinx/domains/python.py:648 sphinx/domains/python.py:792 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:708 sphinx/domains/python.py:884 #: sphinx/domains/python.py:935 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:710 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:735 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:736 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:797 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:799 sphinx/domains/python.py:939 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1093 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1094 msgid "modules" msgstr "" #: sphinx/domains/python.py:1143 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1169 msgid "class method" msgstr "" #: sphinx/domains/python.py:1170 msgid "static method" msgstr "" #: sphinx/domains/python.py:1172 msgid "property" msgstr "" #: sphinx/domains/python.py:1230 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1350 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1404 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:173 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:204 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:218 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:224 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:334 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:336 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:369 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:382 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:78 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.326564 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/he/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015477� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000032�00000000000�010210� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������26 mtime=1639903107.48279 ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/he/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017264� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/he/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000012156�00000000000�021140� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "he", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "\u05e2\u05dc \u05de\u05e1\u05de\u05db\u05d9\u05dd \u05d0\u05dc\u05d5", "Automatically generated list of changes in version %(version)s": "\u05d9\u05e6\u05e8 \u05d0\u05d5\u05d8\u05d5\u05de\u05d8\u05d9\u05ea \u05e8\u05e9\u05d9\u05de\u05d4 \u05e9\u05dc \u05e9\u05d9\u05e0\u05d5\u05d9\u05d9\u05dd \u05d1\u05d2\u05e8\u05e1\u05d4 %(version)s", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "\u05db\u05d5\u05d5\u05e5 \u05e1\u05e8\u05d2\u05dc \u05e6\u05d3", "Complete Table of Contents": "\u05ea\u05d5\u05db\u05df \u05e2\u05e0\u05d9\u05d9\u05e0\u05d9\u05dd \u05de\u05dc\u05d0", "Contents": "\u05ea\u05d5\u05db\u05df", "Copyright": "\u05d6\u05db\u05d5\u05d9\u05d5\u05ea \u05e9\u05de\u05d5\u05e8\u05d5\u05ea", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "\u05d4\u05e8\u05d7\u05d1 \u05e1\u05e8\u05d2\u05dc \u05e6\u05d3", "Full index on one page": "\u05d0\u05d9\u05e0\u05d3\u05e7\u05e1 \u05de\u05dc\u05d0 \u05d1\u05e2\u05de\u05d5\u05d3 \u05d0\u05d7\u05d3", "General Index": "", "Global Module Index": "\u05d0\u05d9\u05e0\u05d3\u05e7\u05e1 \u05de\u05d5\u05d3\u05d5\u05dc\u05d9\u05dd \u05d2\u05dc\u05d5\u05d1\u05dc\u05d9", "Go": "\u05dc\u05da", "Hide Search Matches": "\u05d4\u05e1\u05ea\u05e8 \u05ea\u05d5\u05e6\u05d0\u05d5\u05ea \u05d7\u05d9\u05e4\u05d5\u05e9", "Index": "\u05d0\u05d9\u05e0\u05d3\u05e7\u05e1", "Index – %(key)s": "", "Index pages by letter": "\u05e2\u05de\u05d5\u05d3\u05d9 \u05d0\u05d9\u05e0\u05d3\u05e7\u05e1 \u05dc\u05e4\u05d9 \u05d0\u05d5\u05ea\u05d9\u05d5\u05ea", "Indices and tables:": "", "Last updated on %(last_updated)s.": "\u05e2\u05d5\u05d3\u05db\u05df \u05dc\u05d0\u05d7\u05e8\u05d5\u05e0\u05d4 \u05d1 %(last_updated)s.", "Library changes": "", "Navigation": "\u05e0\u05d9\u05d5\u05d5\u05d8", "Next topic": "\u05e0\u05d5\u05e9\u05d0 \u05d4\u05d1\u05d0", "Other changes": "\u05e9\u05d9\u05e0\u05d5\u05d9\u05d9\u05dd \u05d0\u05d7\u05e8\u05d9\u05dd", "Overview": "\u05e1\u05e7\u05d9\u05e8\u05d4 \u05db\u05dc\u05dc\u05d9\u05ea", "Permalink to this definition": "\u05e7\u05d9\u05e9\u05d5\u05e8 \u05e7\u05d1\u05d5\u05e2 \u05dc\u05d4\u05d2\u05d3\u05e8\u05d4 \u05d6\u05d5", "Permalink to this headline": "\u05e7\u05d9\u05e9\u05d5\u05e8 \u05e7\u05d1\u05d5\u05e2 \u05dc\u05db\u05d5\u05ea\u05e8\u05ea \u05d6\u05d5", "Please activate JavaScript to enable the search\n functionality.": "\u05d0\u05e0\u05d0 \u05d4\u05e4\u05e2\u05dc \u05d2'\u05d0\u05d5\u05d0\u05e1\u05e7\u05e8\u05d9\u05e4\u05d8 \u05e2\"\u05de \u05dc\u05d0\u05e4\u05e9\u05e8 \u05d0\u05ea\n \u05d4\u05d7\u05d9\u05e4\u05d5\u05e9.", "Preparing search...": "", "Previous topic": "\u05e0\u05d5\u05e9\u05d0 \u05e7\u05d5\u05d3\u05dd", "Quick search": "\u05d7\u05d9\u05e4\u05d5\u05e9 \u05de\u05d4\u05d9\u05e8", "Search": "\u05d7\u05d9\u05e4\u05d5\u05e9", "Search Page": "\u05d3\u05e3 \u05d7\u05d9\u05e4\u05d5\u05e9", "Search Results": "\u05ea\u05d5\u05e6\u05d0\u05d5\u05ea \u05d4\u05d7\u05d9\u05e4\u05d5\u05e9", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "\u05d7\u05e4\u05e9 \u05d1\u05ea\u05d5\u05da %(docstitle)s", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "\u05d4\u05e6\u05d2 \u05de\u05e7\u05d5\u05e8", "Table of Contents": "", "This Page": "\u05e2\u05de\u05d5\u05d3 \u05d6\u05d4", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "\u05db\u05dc \u05d4\u05e4\u05d5\u05e0\u05e7\u05e6\u05d9\u05d5\u05ea, \u05d4\u05de\u05d7\u05dc\u05e7\u05d5\u05ea, \u05d4\u05de\u05d5\u05e9\u05d2\u05d9\u05dd", "can be huge": "\u05e2\u05e9\u05d5\u05d9 \u05dc\u05d4\u05d9\u05d5\u05ea \u05e2\u05e6\u05d5\u05dd", "last updated": "", "lists all sections and subsections": "", "next chapter": "\u05e4\u05e8\u05e7 \u05d4\u05d1\u05d0", "previous chapter": "\u05e4\u05e8\u05e7 \u05e7\u05d5\u05d3\u05dd", "quick access to all modules": "\u05d2\u05d9\u05e9\u05d4 \u05de\u05d4\u05d9\u05e8\u05d4 \u05dc\u05db\u05dc \u05d4\u05de\u05d5\u05d3\u05d5\u05dc\u05d9\u05dd", "search": "\u05d7\u05d9\u05e4\u05d5\u05e9", "search this documentation": "\u05d7\u05e4\u05e9 \u05d1\u05ea\u05d9\u05e2\u05d5\u05d3 \u05d6\u05d4", "the documentation for": "" }, "plural_expr": "(n == 1 && n % 1 == 0) ? 0 : (n == 2 && n % 1 == 0) ? 1: (n % 10 == 0 && n % 1 == 0 && n > 10) ? 2 : 3" });������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/he/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000011644�00000000000�021140� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������T��������������������\�����]�����c��0���w������������ ����������>��������,�����4�� ���J�����X�����i������� ������������������������� ������������������������������ ��� �����*�����0��!���F�� ���h�����u�� ����� ���������� ���������� ���������� ���������������B��������\�� ���k�����x������������ ������������������������� ����� �������� ����� �� ��� ����� ����� �����% �����- �����6 �� ���T �����` �����f ����� ����� ����� ����� ����� ����� ����� ����� �� ��� ����� ����� ����� ����� �����, �����3 �����M �� ���T �����` ��"��i �� ��� ����� ��<��� ��'��� ����� �����% �� ���5 ��M���? �� ��� ����� ����� ����� ����� ����� ������������+���(�� ���T�����_�����v��%�����(���������� ������������� �� �����+��� ��.���L�����{������������ ���������������������������������'��%���6��%���\��M��������������� ����� �������������#�����3�����M�����k�� ���~������� ���������� ����� ����� ����� ����� ����� �����7��������/�� ���L�����W�����t������������ ���������� ����� ���������� ���������� �������� ��+���0�� ���\�����g�� ���������� ������ (in �%s %s documentation�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Attention�Author: �Automatically generated list of changes in version %(version)s�Caution�Changed in version %s�Code author: �Collapse sidebar�Complete Table of Contents�Contents�Copyright�Danger�Deprecated since version %s�Error�Expand sidebar�Footnotes�Full index on one page�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index pages by letter�Last updated on %(last_updated)s.�Module Index�Module author: �Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Parameters�Permalink to this definition�Permalink to this headline�Please activate JavaScript to enable the search functionality.�Previous topic�Quick search�Release�Search�Search %(docstitle)s�Search Page�Search Results�Search within %(docstitle)s�Section author: �See also�Show Source�This Page�Tip�Todo�Variables�Warning�[docs]�[image]�[source]�all functions, classes, terms�can be huge�class�continued from previous page�environment variable�environment variable; %s�function�index�keyword�macro�module�next�next chapter�original entry�previous�previous chapter�quick access to all modules�search�search this documentation�see %s�see also %s�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: he Language-Team: Hebrew (http://www.transifex.com/sphinx-doc/sphinx-1/language/he/) Plural-Forms: nplurals=4; plural=(n == 1 && n % 1 == 0) ? 0 : (n == 2 && n % 1 == 0) ? 1: (n % 10 == 0 && n % 1 == 0 && n > 10) ? 2 : 3 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �(בתוך�תיעוד %s %s�<h1>כל המודולים שיש להם קוד זמין</h1>�<h1>הראה קוד מקור ל %s</h1>�על מסמכים אלו�תשומת לב�מחבר:�יצר אוטומטית רשימה של שינויים בגרסה %(version)s�זהירות�השתנה בגרסה %s�מחבר הקוד:�כווץ סרגל צד�תוכן עניינים מלא�תוכן�זכויות שמורות�סכנה� לא מומלץ לשימוש מגרסה %s�שגיאה�הרחב סרגל צד�הערות שוליים�אינדקס מלא בעמוד אחד�אינדקס מודולים גלובלי�לך�הסתר תוצאות חיפוש�רמז�חשוב�אינדקס�עמודי אינדקס לפי אותיות�עודכן לאחרונה ב %(last_updated)s.�מודול אינדקס�מחבר המודול:�רמת המודול�ניווט�חדש בגרסה %s�נושא הבא�הערה�שינויים אחרים�סקירה כללית�פרמטרים�קישור קבוע להגדרה זו�קישור קבוע לכותרת זו�אנא הפעל ג'אואסקריפט ע"מ לאפשר את החיפוש.�נושא קודם�חיפוש מהיר�מהדורה�חיפוש�חפש %(docstitle)s�דף חיפוש�תוצאות החיפוש�חפש בתוך %(docstitle)s�מחבר הקטע:�ראה גם�הצג מקור�עמוד זה�טיפ�לעשות�משתנים�אזהרה�[תיעוד]�[תמונה]�[מקור]�כל הפונקציות, המחלקות, המושגים�עשוי להיות עצום�מחלקה�המשך מעמוד קודם�משתנה סביבה�משתנה סביבה; %s�פונקציה�אינדקס�מילת מפתח�מאקרו�מודול�הבא�פרק הבא�הטקסט המקורי�הקודם�פרק קודם�גישה מהירה לכל המודולים�חיפוש�חפש בתיעוד זה�ראה %s�ראה גם %s�משתנה���������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/he/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000245137�00000000000�021151� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # FIRST AUTHOR <EMAIL@ADDRESS>, 2011 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Hebrew (http://www.transifex.com/sphinx-doc/sphinx-1/language/he/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: he\n" "Plural-Forms: nplurals=4; plural=(n == 1 && n % 1 == 0) ? 0 : (n == 2 && n % 1 == 0) ? 1: (n % 10 == 0 && n % 1 == 0 && n > 10) ? 2 : 3;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "רמת המודול" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "(בתוך" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "אינדקס" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "הבא" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "הקודם" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "תיעוד %s %s" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "אינדקס" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "מהדורה" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "מחבר הקטע:" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "מחבר המודול:" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "מחבר הקוד:" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "מחבר:" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "פרמטרים" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "משתנה" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "פונקציה" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "מאקרו" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "חדש בגרסה %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "השתנה בגרסה %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr " לא מומלץ לשימוש מגרסה %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "מחלקה" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "מודול" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "מילת מפתח" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "משתנים" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "משתנה סביבה; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "משתנה סביבה" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "מודול אינדקס" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "דף חיפוש" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "ראה %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "ראה גם %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[מקור]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "לעשות" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "הטקסט המקורי" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[תיעוד]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>הראה קוד מקור ל %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>כל המודולים שיש להם קוד זמין</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "תשומת לב" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "זהירות" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "סכנה" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "שגיאה" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "רמז" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "חשוב" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "הערה" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "ראה גם" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "טיפ" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "אזהרה" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "המשך מעמוד קודם" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "חיפוש" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "לך" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "הצג מקור" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "סקירה כללית" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "תוכן עניינים מלא" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "חפש בתיעוד זה" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "אינדקס מודולים גלובלי" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "גישה מהירה לכל המודולים" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "כל הפונקציות, המחלקות, המושגים" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "אינדקס מלא בעמוד אחד" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "עמודי אינדקס לפי אותיות" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "עשוי להיות עצום" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "ניווט" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "חפש בתוך %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "על מסמכים אלו" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "זכויות שמורות" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "עודכן לאחרונה ב %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "חפש %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "נושא קודם" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "פרק קודם" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "נושא הבא" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "פרק הבא" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "אנא הפעל ג'אואסקריפט ע\"מ לאפשר את\n החיפוש." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "חיפוש" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "תוצאות החיפוש" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "חיפוש מהיר" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "עמוד זה" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "יצר אוטומטית רשימה של שינויים בגרסה %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "שינויים אחרים" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "קישור קבוע לכותרת זו" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "קישור קבוע להגדרה זו" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "הסתר תוצאות חיפוש" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "הרחב סרגל צד" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "כווץ סרגל צד" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "תוכן" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "הערות שוליים" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[תמונה]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3267426 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hi/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015503� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4836607 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hi/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017270� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hi/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000020077�00000000000�021145� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "hi", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">\u0938\u0930\u094d\u0935\u093e\u0927\u093f\u0915\u093e\u0930</a> %(copyright)s.", "© Copyright %(copyright)s.": "© \u0938\u0930\u094d\u0935\u093e\u0927\u093f\u0915\u093e\u0930 %(copyright)s.", ", in ": ", \u092e\u0947\u0902 ", "About these documents": "\u0907\u0928 \u0932\u0947\u0916\u092a\u0924\u094d\u0930\u094b\u0902 \u0915\u0947 \u092c\u093e\u0930\u0947 \u092e\u0947\u0902", "Automatically generated list of changes in version %(version)s": "\u0938\u0902\u0938\u094d\u0915\u0930\u0923 %(version)s \u092e\u0947\u0902 \u0938\u094d\u0935\u0924\u0903 \u0930\u091a\u093f\u0924 \u092a\u0930\u093f\u0935\u0930\u094d\u0924\u0928\u094b\u0902 \u0915\u0940 \u0938\u0942\u091a\u0940", "C API changes": "\u0938\u0940 \u0910.\u092a\u0940.\u0906\u0908. \u092a\u0930\u093f\u0935\u0930\u094d\u0924\u0928", "Changes in Version %(version)s — %(docstitle)s": "\u092a\u0930\u093f\u0935\u0930\u094d\u0924\u093f\u0924 \u0938\u0902\u0938\u094d\u0915\u0930\u0923 %(version)s — %(docstitle)s", "Collapse sidebar": "\u0915\u093f\u0928\u093e\u0930\u0947 \u0915\u093e \u0938\u094d\u0925\u093e\u0928 \u0918\u091f\u093e\u090f\u0902", "Complete Table of Contents": "\u0935\u093f\u0938\u094d\u0924\u0943\u0924 \u0935\u093f\u0937\u092f-\u0938\u0942\u091a\u0940", "Contents": "\u0935\u093f\u0937\u092f \u0938\u093e\u092e\u093f\u0917\u094d\u0930\u0940", "Copyright": "\u0938\u0930\u094d\u0935\u093e\u0927\u093f\u0915\u093e\u0930", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "\u0915\u093f\u0928\u093e\u0930\u0947 \u0915\u093e \u0938\u094d\u0925\u093e\u0928 \u092c\u095d\u093e\u090f\u0902", "Full index on one page": "\u090f\u0915 \u092a\u0943\u0937\u094d\u0920 \u092a\u0930 \u092a\u0942\u0930\u0940 \u0905\u0928\u0941\u0915\u094d\u0930\u092e\u0923\u093f\u0915\u093e", "General Index": "\u0938\u093e\u092e\u093e\u0928\u094d\u092f \u0905\u0928\u0941\u0915\u094d\u0930\u092e\u093e\u0923\u093f\u0915\u093e", "Global Module Index": "\u0938\u093e\u0930\u094d\u0935\u092d\u094c\u092e\u093f\u0915 \u092a\u094d\u0930\u092d\u093e\u0917 \u0938\u0942\u091a\u0940", "Go": "\u091a\u0932\u093f\u090f", "Hide Search Matches": "\u0916\u094b\u091c\u0947 \u0917\u090f \u091c\u094b\u095c\u0947 \u091b\u093f\u092a\u093e\u090f\u0902", "Index": "\u0905\u0928\u0941\u0915\u094d\u0930\u092e\u0923\u093f\u0915\u093e", "Index – %(key)s": "\u0905\u0928\u0941\u0915\u094d\u0930\u092e\u0923\u093f\u0915\u093e – %(key)s", "Index pages by letter": "\u0905\u0915\u094d\u0937\u0930 \u0926\u094d\u0935\u093e\u0930\u093e \u0905\u0928\u0941\u0915\u094d\u0930\u092e\u093f\u0924 \u092a\u0943\u0937\u094d\u0920", "Indices and tables:": "\u0938\u0942\u091a\u093f\u092f\u093e\u0901 \u0914\u0930 \u0938\u093e\u0930\u0923\u093f\u092f\u093e\u0901:", "Last updated on %(last_updated)s.": "\u0905\u0902\u0924\u093f\u092e \u092c\u093e\u0930 \u0938\u092e\u094d\u092a\u093e\u0926\u093f\u0924 %(last_updated)s.", "Library changes": "\u092a\u0941\u0938\u094d\u0924\u0915\u093e\u0932\u092f \u092e\u0947\u0902 \u092a\u0930\u093f\u0935\u0930\u094d\u0924\u0928", "Navigation": "\u0938\u0902\u091a\u093e\u0932\u0928", "Next topic": "\u0905\u0917\u0932\u093e \u092a\u094d\u0930\u0915\u0930\u0923", "Other changes": "\u0905\u0928\u094d\u092f \u092a\u0930\u093f\u0935\u0930\u094d\u0924\u0928", "Overview": "\u0938\u093f\u0902\u0939\u093e\u0935\u0932\u094b\u0915\u0928", "Permalink to this definition": "\u0907\u0938 \u092a\u0930\u093f\u092d\u093e\u0937\u093e \u0915\u0940 \u0938\u094d\u0925\u093e\u092f\u0940 \u0915\u095c\u0940", "Permalink to this headline": "\u0907\u0938 \u0936\u0940\u0930\u094d\u0937-\u092a\u0902\u0915\u094d\u0924\u093f \u0915\u0940 \u0938\u094d\u0925\u093e\u092f\u0940 \u0915\u095c\u0940", "Please activate JavaScript to enable the search\n functionality.": "\u0916\u094b\u091c \u0915\u093e\u0930\u094d\u092f \u0915\u0947 \u0932\u093f\u090f \u091c\u093e\u0935\u093e \u0938\u094d\u0915\u094d\u0930\u093f\u092a\u094d\u091f \u0915\u093e \u0939\u094b\u0928\u093e \u0906\u0935\u0936\u094d\u092f\u0915 \u0939\u0948. \u0915\u0943\u092a\u092f\u093e \u091c\u093e\u0935\u093e \u0938\u094d\u0915\u094d\u0930\u093f\u092a\u094d\u091f \u0915\u094b \u0936\u0941\u0930\u0942 \u0915\u0930\u0947\u0902.", "Preparing search...": "\u0916\u094b\u091c \u0915\u0940 \u0924\u0948\u092f\u093e\u0930\u0940", "Previous topic": "\u092a\u093f\u091b\u0932\u093e \u092a\u094d\u0930\u0915\u0930\u0923", "Quick search": "\u0924\u094d\u0935\u0930\u093f\u0924 \u0916\u094b\u091c", "Search": "\u0916\u094b\u091c", "Search Page": "\u0916\u094b\u091c \u092a\u0943\u0937\u094d\u0920", "Search Results": "\u0916\u094b\u091c \u092a\u0930\u0940\u0923\u093e\u092e ", "Search finished, found %s page(s) matching the search query.": "\u0916\u094b\u091c \u092a\u0942\u0930\u094d\u0923, \u0916\u094b\u091c \u0935\u093f\u0937\u092f \u0915\u0947 \u0905\u0928\u0941\u0915\u0942\u0932 %s \u092a\u0943\u0937\u094d\u0920 \u092e\u093f\u0932\u093e (\u092e\u093f\u0932\u0947).", "Search within %(docstitle)s": "%(docstitle)s \u092e\u0947\u0902 \u0916\u094b\u091c\u0947\u0902", "Searching": "\u0916\u094b\u091c \u091c\u093e\u0930\u0940", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "\u0938\u094d\u0930\u094b\u0924 \u0926\u093f\u0916\u093e\u090f\u0901", "Table of Contents": "\u0935\u093f\u0937\u092f-\u0938\u0942\u091a\u0940", "This Page": "\u092f\u0939 \u092a\u0943\u0937\u094d\u0920 ", "Welcome! This is": "\u0928\u092e\u0938\u094d\u0924\u0947! \u092f\u0939 \u0939\u0948", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "\u0906\u092a\u0915\u0947 \u0916\u094b\u091c \u092a\u0930\u093f\u0923\u093e\u092e\u094b\u0902 \u092e\u0947\u0902 \u0915\u094b\u0908 \u092a\u094d\u0930\u0932\u0947\u0916 \u0928\u0939\u0940\u0902 \u092e\u093f\u0932\u093e. \u0915\u0943\u092a\u092f\u093e \u0938\u0941\u0928\u093f\u0936\u094d\u091a\u093f\u0924 \u0915\u0930\u0947\u0902 \u0915\u093f \u0938\u092d\u0940 \u0936\u092c\u094d\u0926\u094b\u0902 \u0915\u0940 \u0935\u0930\u094d\u0924\u0928\u0940 \u0936\u0941\u0926\u094d\u0927 \u0939\u0948 \u0914\u0930 \u0906\u092a\u0928\u0947 \u092f\u0925\u0947\u0937\u094d\u091f \u0936\u094d\u0930\u0947\u0923\u093f\u092f\u093e\u0902 \u091a\u0941\u0928\u0940 \u0939\u0948\u0902.", "all functions, classes, terms": "\u0938\u092d\u0940 \u0915\u093e\u0930\u094d\u092f\u092f\u0941\u0915\u094d\u0924\u093f\u092f\u093e\u0902, \u0935\u0930\u094d\u0917, \u0936\u092c\u094d\u0926", "can be huge": "\u092c\u0943\u0939\u0926\u093e\u0915\u093e\u0930 \u0939\u094b \u0938\u0915\u0924\u093e \u0939\u0948", "last updated": "\u0905\u0902\u0924\u093f\u092e \u092a\u0930\u093f\u0935\u0930\u094d\u0927\u0928", "lists all sections and subsections": "\u0938\u092d\u0940 \u0905\u0928\u0941\u092d\u093e\u0917\u094b\u0902 \u090f\u0935\u0902 \u0909\u092a-\u0905\u0928\u0941\u092d\u093e\u0917\u094b\u0902 \u0915\u0940 \u0938\u0942\u091a\u0940", "next chapter": "\u0905\u0917\u0932\u093e \u0905\u0927\u094d\u092f\u093e\u092f", "previous chapter": "\u092a\u093f\u091b\u0932\u093e \u0905\u0927\u094d\u092f\u093e\u092f", "quick access to all modules": "\u0938\u092d\u0940 \u092a\u094d\u0930\u092d\u093e\u0917 \u0924\u0915 \u0924\u0941\u0930\u0902\u0924 \u092a\u0939\u0941\u0901\u091a", "search": "\u0916\u094b\u091c", "search this documentation": "\u0907\u0938 \u0906\u0932\u0947\u0916 \u092e\u0947\u0902 \u0916\u094b\u091c\u0947\u0902", "the documentation for": "\u0906\u0932\u0947\u0916 \u0935\u093f\u0937\u092f" }, "plural_expr": "(n != 1)" });�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hi/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000301741�00000000000�021144� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$��������������,(����-(�����)��E��*��r���+��l���[,�� ���,�����,��*���,��=���-��7���E-��H���}-��?���-��"���.�� ���).�����3.��%���<.�����b.�����.�����.�����.�����.�� ���.�����.�����.�����/�����/�� ���"/�����C/�� ���U/�� ���a/�� ���k/��S���/��A���/�����"0�����90�����P0�����a0�����y0�� ���0�����0��6���0�����0����� 1��$���&1�����K1��3���2�� ���92�����E2�����M2��1���S2��1���2��G���2�����2��0���3�����C3��b���_3�����3��6���3�����4�� ���%4�� ���F4�� ���P4�����Z4�����i4��>���r4�� ���4��(���4��(���4����� 5��?���,5�����l5�� ���u5��!���5��8���5��%���5�����6����� 6��4���"6�� ���W6�� ���x6�����6�����6�����6�����6�� ���6��%���6��%��� 7�����17��:���O7��7���7�����7��"���7�����7�����8�� ���8����� 8�����<8��`���X8�����8��&���8�����8��D���8��H���;9��K���9�����9�����9�����9��5���9�����0:�����D:�����S:��8���e:��"���:��"���:��#���:�����;��!���;��:���2;�����m;�� ���;�� ���;�����;�� ���;�����;�����;��C���;�����8<�����L<��3��Q<��.���=�� ���=��.���=�����=�����=����� >��D���>�����d>�����x>�� ���c?�����p?��[���?�����?�����?�����@��Y���.@��!���@�����@��2���@�� ���@��C���@�����<A��n���\A��E���A�� ���B�����B�� ���.B�� ���:B��-���GB��(���uB�� ���B�����B�� ���B��(���B�����B�����C�����C��Z���C�����yC�����C��,���C�����C�����C�� ���C�����C�����C�� ���D�����D�����)D�����FD�����aD�����|D�����D�����D��&���D��B���D��i���0E��2���E��I���E��4���F�����LF�����lF�����F�����F��y���F�����6G�����JG�����YG�����oG�� ���G�����G�����G�����G��#���G��$���G����� H�� ���H�����*H�����1H�� ���BH�����MH�� ���UH�����aH�����iH�����H�����H�����H�� ���H�����H��<���H�����I�� ���,I�� ���6I�����AI�����RI�����[I��+���rI�� ���I��>���I�����I��#���I����� J�����2J�����:J�����OJ�����XJ�����jJ��Y���~J��Z���J��*���3K��3���^K��/���K��(���K��.���K��P���L��p���kL�����L��!���L��"���M��$���AM�� ���fM��e���M��Z���M��N���HN��T���N��K���N��%���8O�����^O��[���~O��#���O��'���O��#���&P��I���JP��'���P��!���P��=���P��7���Q�� ���TQ��d���^Q��W���Q��v���R�����R�����R�����R�� ���R�����R�����R��"���R�� ���S�����#S�����+S��,���1S�����^S�����oS�����S�����S�����VT��,���T�����U�����*U�� ���1U�����=U�� ���EU�����QU�����YU��N���bU�����U��?���=V��-���}V��2���V�����V�����V�����W��9��� W�����ZW�� ���uW�� ���W��,���W��2���W��b���W��G���OX�����X��7���X�����X�� ���X��%���Y��`���*Y�����Y�����Y�����Y�����Y�����Y�� ���Y��&���Z��$���-Z�����RZ�����lZ�����Z�����Z�����Z��A���Z��Z���[��-���w[�����[�����[�����[��!���[��8���\�����Q\�� ���W\�����d\��7���l\��6���\��;���\��I���]��;���a]��:���]��H���]��9���!^��G���[^��2���^��2���^����� _��4���_�����M_�����d_�����_��2���_�����_�����_�����`����� `�����9`�����X`�����l`�����`��(���`��=���`�����`�����a��0���a�����Pa�����Ua��/���oa�����a��*���a��&���a�� ��� b��9���b�����Pb�� ���nb�����b��-���b�����b�����b��1���c��*���3c�����^c�����tc��0���}c��&���c�����c�����c��(���d�����0d�����@d�����]d��%���zd��e���d�����e��4���e�����e�����e��Y���e��;���Lf��.���f�����f�����f�����f��+��� g��(���6g��4���_g�����g�����g�����g��X���g��J���<h�����h��%���h�� ���h�����h�����h��+���h�����i�����1i�� ���Qi��8���[i��M���i��u���i�����Xj�����jj�����}j�����j�����j��A���j�� ���j�����k��6���#k��I���Zk��A���k�����k��0���l�����2l��G���Il��N���l�����l�����l��.���l�����(m�� ���;m�� ���Im��=���Wm�����m��'���m��0���m��(��� n��1���4n��,���fn��!���n�����n�����n�����n��=��� o��+���Io��0���uo��V���o��V���o��M���Tp��R���p��$���p�����q����� q��N���4q��0���q��)���q�����q�����q�����r��/���/r�����_r�����yr�����r��&���r��!���r��&���r�����s��E���'s�� ���ms��*���zs��7���s��"���s��(����t�����)t�����Et�����ct��"���t�����t�����t�����t��;���t�����u�����u��"���u��!���Bu�����du��#���ku�����u��D���u��5���u�� ���v�����v�� ���"v��1���/v��E���av��B���v��G���v��%���2w�����Xw��#���rw��#���w��,���w�����w��-���x��(���1x��D���Zx�� ���x��#���x��(���x��#���x�����y�����"y�����+y��(���:y�����cy�����|y��8���y�� ���y��P���y��"���,z�����Oz�����jz��O���z�����z�����z�����z�����{��%���{�� ���<{�����J{��,���Y{�� ���{��(���{��E���{��*���|��1���-|��7���_|�����|�� ���|�����|�����|�����|�����|�����}�����!}��&���4}�����[}�����s}��4���x}�����}��%���}�����}��c���}�����S~�����m~�� ���t~��'���~��:���~�� ���~��@��������E�����M�����j��&���}��*�����&�����W�����>���N��7����� ���ŀ�� ���π�� ���݀��,�����*�����0���?�����p��%�������������L��1�����1��������H��\���^�������'���׃��%�����+���%��^���Q��2�����5�������������8�����R��5���W������������+�����-���ۅ����� ��!���%��!���G�����i��!���������������#�����*������������������,�����C��9���b��;�����)���؇���������� ����������6�����O�����e������������������q��|��6������D��ē��^�� �����h�� �����\����������{���k������������"���*�� ���M�����W��T���g��:�����@��������8��'���>�����f�� ���~��6�����7���������������?���3��%���s������������R���ɛ����������ݜ��>�����$���۝��������,�����>���D�������'�����K�����4��� ��C���@��i�����E����m���4������������ ���Ģ��~���Ѣ��~���P�����ϣ��)�����o���Ϥ��9���?�����y��@���R�������1�����q���H����������§��(���ا�� �����{����������k�����`�����O���i�������$���h��2�����M������������������$��*���:��S���e��N�����#�����9���,��/���f��V�����%����������V���2��V�����N��������/�������`���T��z�����7���0�� ���h�����u��?�����T���̱����!��)���0��M���Z�� �������������L����� ��C������������� �����)�����ζ��9�����&���&�����M��q�����e���V��X����������Z���(�������Z�����`���t��(���պ��L�����:���K��>����� ���Ż�����һ��3��������Ǽ����׼�����`��$��������#��!�����1�����N��������M��6�����S���� ���l��)�����8����(�����4�����7���N�������D�����>�������� ������������I���Y����������]������� ��� ��(���*�����S��r���s����������i��*���|������������K���W��,�������������������������x�����!���X��"���z��%����������H��������+��@���A��@�����=�����M�����:���O��:�����W���������������5����t��������:�������H�����y�����*���n��B���������#�����"�����E���>��,�����)�����.�����:��� ��.���E��R���t��[�����/���#�����S�����p��2���������������)����������3���+��I���_�� �����(���������������{�����'���������� ���������������W�����g���q��"����������9�����b�����)���5�����_��@���p������������&���������������A���G���������� ��?�����~��������W��*����K�����N���e��K�����M������T���N���������������T���������������R��4����� �� ��G�����K���^��U�����������a�����6���!��~���X��x��������P�����h�����L�����A�����7�� ���L�����Y��]���m��-�����?�����;���9�����u�������)����������!���N��'���p�����������Z��y��l�����<���A�����~�� ������������������������������i���������j�����o���I��P�����+��� ��,���6�����c��T���=�������#�������������K����������"����m����6���?����v�r�������Y����s���m�(����(��� �1���3�3���e�����x���(�p����s����m����J����T���? ���� �,��j ���� �V���7 �V��� �E��� �Y���+ ���� � ���N����[����u�}������� ����������������:��������^���������}����1��������N���H�3����0����p����w���m�w�������]�s����t���X�����`���O�m����x��������%���)�%���O�i���u�����>����b���/�D��������q��������{����l����Y����/���K�u���{�2����2���$ �{���W �`��� �A���4!����v!�T���!����!�)���o"�T���"�g���"�.���V#�[���#�^���#�B���@$����$���k%����'����'�&���'����'�z���(�a���P)�K���)�`���)�s���_*�p���*�p���D+����+�p���@,�,���,�E���,����$-����-� ���.�C���.���� /�*���!/�-���L/�g���z/�C���/�F���&0����m0�}���~0����0���1� ���2�(���3� ���:3�Q���G3�@���3����3����m4�`���~4����4����o5���:6�6���=7�b���t7�F���7����8����8����9�(���9����9�Y���r:�"���:�&���:����;����;�b���Q<�P���<�c���=�R���i=�}���=����:>�G���>�D���?�K���I?����?����5@����@����|A����B����B����LC�v���C�!���\D�;���~D����D����mE�~���E�F���zF�9���F�8���F����4G�$���G�)���G�B��� H�R���NH�W���H�o���H����iI����I�(��� J�r���2J����J�`���]K�t���K�^���3L�<���L�e���L�p���5M����M�V���M�6���N����GN����N�����O�M���O�E���aO����O�U���O����P����#P����P����TQ����qQ����Q����Q����QR����R����S�[���7T�]���T�f���T�|���XU����U�I���~V�}���V�h���FW����W�'���kX�k���X�K���X�g���KY����Y� ���Y�+���Y�e���Y�U���bZ����Z�p���Z�p���9[����[�J���9\�=���\�?���\����]�Z���]�=���]����+^�"���J^�W���m^�2���^�/���^����(_�)���_�h���_����U`����`����a���� b�C���b����b�9���b�*���/c�A���Zc�>���c�(���c�5���d�E���:d�c���d����d�x���d�I���pe�`���e� ���f����%f�-���$g����Rg����eg����g����h�c���h����i� ���i�f���i�9���@j�l���zj�H���j�A���0k���rk����l����em����n�(���n����Hn�X���\n�W���n�M��� o�?���[o�b���o���o���q����2s����s����kt����t�E���\u�c���u�_���v����fv� ��v����w����x�|���y�K���y����y�y���y�K���gz����z�~���z�z���B{�t���{�n���2|�[���|�9���|�l���7}�W���}�*���}�S���'~����{~� ����5����S���L�D������������x���N�$���ǁ�>����W���+�P����*���Ԃ�`����:���`�E����� Generate ReStructuredText using autosummary directives. sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates the reStructuredText files from the autosummary directives contained in the given input files. The format of the autosummary directive is documented in the ``sphinx.ext.autosummary`` Python module and can be read using:: pydoc sphinx.ext.autosummary � Generate required files for a Sphinx project. sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build. � Look recursively in <MODULE_PATH> for Python modules and packages and create one reST file with automodule directives per package in the <OUTPUT_PATH>. The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be excluded from generation. Note: By default this script will not overwrite already created files.� Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� Run 'make' in that directory to run these through makeinfo (use 'make info' here to do that automatically).� (deprecated)� (in �"::" in automodule name doesn't make sense�"latex_documents" config value references unknown document %s�"man_pages" config value references unknown document %s�"quiet" is specified, but any of "project" or "author" is not specified.�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%r doesn't have "%s" setting�%r doesn't have "theme" setting�%s %s�%s %s documentation�%s (%s attribute)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command %r cannot be run (needed for math display), check the imgmath_%s setting�%s is already assigned section numbers (nested numbered toctree?)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �-A option argument must be in the form name=value�-D option argument must be in the form name=value�4 column based index found. It might be a bug of extensions you use: %r�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�About these documents�An error happened in rendering the page %s. Reason: %r�Anchor '%s' not found�Any IDs not assigned for %s node�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not fetch remote image: %s [%d]�Could not fetch remote image: %s [%s]�Could not import extension %s�Could not lex literal_block as "%s". Highlighting skipped.�Could not obtain image size. :scale: option is ignored.�Create Makefile? (y/n)�Create Windows command file? (y/n)�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Encoding error:�Enter the root path for documentation.�Error�Error: an existing conf.py has been found in the selected root path.�Error: specified path is not a directory, or sphinx files already exist.�Error: the master file %s has already been found in the selected root path.�Event %r already present�Example�Examples�Exception occurred while building, starting debugger:�Exception occurred:�Expand sidebar�Extension options�External Graphviz file %r not found or reading it failed�Failed to read build info file: %r�Failed to scan documents in %s: %r�Failed to write build info file: %r�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnote [#] is not referenced.�Footnote [%s] is not referenced.�Footnotes�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Hide Search Matches�Hint�If the documents are to be written in a language other than English, you can select a language here by its language code. Sphinx will then translate text that it generates into that language. For a list of supported codes, see https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indicate which of the following Sphinx extensions should be enabled:�Indices and tables:�Inside the root directory, two more directories will be created; "_templates" for custom HTML templates and "_static" for custom stylesheets and other static files. You can enter another prefix (such as ".") to replace the underscore.�Interrupted!�Invalid caption: %s�Invalid date format. Quote the string by single quote if you want to output it directly: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�Keyword Arguments�LaTeX command %r cannot be run (needed for math display), check the imgmath_latex setting�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Look for any errors in the above output or in %(outdir)s/output.txt�Makefile and Batchfile creation�Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Many math_renderers are registered. But no math_renderer is selected.�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Non-alphabetical�Note�Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.�Notes�Numbers�Object named %r not found in include file %r�Original exception: �Other Parameters�Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Pillow not found - copying image files�Please activate JavaScript to enable the search functionality.�Please also report this if it was a user error, so that a better error message can be provided next time.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter a new file name, or rename the existing file and press Enter�Please enter a new root path (or just Enter to exit)�Please enter a valid path name.�Please enter either 'y' or 'n'.�Please enter one of %s.�Please enter some text.�Please enter values for the following settings (just press Enter to accept a default value, if one is given in brackets).�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project templating�Project version�Pygments lexer name %r is not known�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Recursion error:�References�Release�Return type�Returns�Root path for the documentation�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section %s�Section author: �See also�Selected root path: %s�Separate source and build directories (y/n)�Show Source�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Structure options�Symbols�TODO entry found: %s�Table %s�Table of Contents�Template Parameters�Testing of coverage in the sources finished, look at the results in %(outdir)spython.txt.�Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt.�The %r crossref_type is already registered�The %r directive is already registered to domain %s�The %r index is already registered to domain %s�The %r object_type is already registered�The %r role is already registered to domain %s�The %s extension is required by needs_extensions settings, but it is not loaded.�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.�The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.�The config value `{name}' has type `{current.__name__}'; expected {permitted}.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The dummy builder generates no files.�The ePub file is in %(outdir)s.�The full traceback has been saved in %s, if you want to report the issue to the developers.�The manual pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�The overview file is in %(outdir)s.�The project name will occur in several places in the built documentation.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Translator for %r already exists�Unknown event name: %s�Unknown image format: %s...�Unknown math_renderer %r is given.�Variables�Warning�Warns�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�Would create file %s.�Yields�You have two options for placing the build directory for Sphinx output. Either, you use a directory "_build" within the root path, or you separate "source" and "build" directories within the root path.�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[autosummary] generating autosummary for: %s�[autosummary] writing to %s�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.�a list of specific files to rebuild. Ignored if -a is specified�a suitable image for %s builder not found: %s�a suitable image for %s builder not found: %s (%s)�all functions, classes, terms�all of %d po files�all source files�append module_path to sys.path, used when --full is given�assembling single document�attribute�author names�automatically insert docstrings from modules�automatically test code snippets in doctest blocks�autosummary generats .rst files internally. But your source_suffix does not contain .rst. Skipped.�both tabularcolumns and :widths: option are given. :widths: is ignored.�broken link: %s (%s)�build %s, %s warning (with warnings treated as errors).�build %s, %s warning.�build %s.�build environment version not current�build in parallel with N processes where possible (special value "auto" will set N to cpu-count)�build info file is broken: %r�builder to use (default: html)�building [%s]: �building [mo]: �built-in function�can be huge�cannot combine -a option and filenames�cannot copy downloadable file %r: %s�cannot copy extra file %r�cannot copy image file %r: %s�cannot copy static file %r�cannot find files %r�cannot open warning file %r: %s�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�cannot read image file %r: copying it instead�cannot write image file %r: %s�caption not inside a figure.�checking consistency�checks for documentation coverage�circular toctree references detected, ignoring: %s <- %s�class�class method�concept�conditional inclusion of content based on config values�conf value "epub_author" should not be empty for EPUB3�conf value "epub_contributor" should not be empty for EPUB3�conf value "epub_copyright" (or "copyright")should not be empty for EPUB3�conf value "epub_description" should not be empty for EPUB3�conf value "epub_identifier" should not be empty for EPUB3�conf value "epub_language" (or "language") should not be empty for EPUB3�conf value "epub_publisher" should not be empty for EPUB3�conf value "epub_title" (or "html_title") should not be empty for EPUB3�conf value "epub_uid" should be XML NAME for EPUB3�conf value "version" should not be empty for EPUB3�config changed�config directory doesn't contain a conf.py file (%s)�console output options�continued from previous page�continues on next page�convert exited with error: [stderr] %r [stdout] %r�copying TeX support files�copying TeX support files...�copying Texinfo support files�copying additional files�copying downloadable files... �copying extra files�copying images... �copying source files...�could not read %r for changelog creation�create .nojekyll file to publish the document on GitHub pages�create batchfile�create makefile�custom template directory (default: %(default)s)�data�default role %s not found�default suffix for files (default: %(default)s)�define a template variable�define tag: include "only" blocks with TAG�dimension unit %s is invalid. Ignored.�directive�directive %r is already registered, it will be overridden�directory to place all output�directory to place all output in�display latex %r: %s�do emit colored output (default: auto-detect)�do not create batchfile�do not create makefile�do not emit colored output (default: auto-detect)�do not use make-mode for Makefile/make.bat�docnames to write: %s�document�document imported members (default: %(default)s)�document isn't included in any toctree�document language�document not readable. Ignored.�document title is not a single Text node�doing serial %s�domain %s already registered�domain %s not yet registered�don't create a table of contents file�don't create headings for the module/package packages (e.g. when the docstrings already contain them)�don't know which module to import for autodocumenting %r (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)�don't use a saved environment, always read all files�done�dot code %r: %s�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�dot did not produce an output file: [stderr] %r [stdout] %r�dot exited with error: [stderr] %r [stdout] %r�download file not readable: %s�dumping object inventory�dumping search index in %s�duplicate citation %s, other instance in %s�duplicate label %s, other instance in %s�duplicate label of equation %s, other instance in %s�duplicated ToC entry found: %s�enable %s extension�enable arbitrary extensions�encountered some issues with some of the inventories, but they had working alternatives:�encountered title node not in section, topic, table, admonition or sidebar�enum�enumerable_node %r already registered�enumerator�environment variable�environment variable; %s�error while formatting arguments for %s: %s�error writing file %s: %s�error writing file Makefile: %s�exception�exception while evaluating only directive expression: %s�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extension options�extensions changed�failed�failed to import object %s�failed to parse name %s�failed to reach any of the inventories with the following issues:�failed: %s�favicon file %r does not exist�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�filename of table of contents (default: modules)�finished with problems�fnmatch-style file and/or directory patterns to exclude from generation�follow symbolic links. Powerful when combined with collective.recipe.omelette.�function�general options�generate a full project with sphinx-quickstart�generating indices�glossary term�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�highlighting module code... �html_extra_path entry %r does not exist�html_extra_path entry %r is placed inside outdir�html_static_path entry %r does not exist�html_static_path entry %r is placed inside outdir�if specified, separate source and build dirs�ignoring invalid doctest code: %r�image file %s not readable: %s�image file not readable: %s�include "_private" modules�include links to the source code of documented Python objects�include math, rendered as PNG or SVG images�include math, rendered in the browser by MathJax�inconsistent citation references in translated message. original: {0}, translated: {1}�inconsistent footnote references in translated message. original: {0}, translated: {1}�inconsistent references in translated message. original: {0}, translated: {1}�inconsistent term references in translated message. original: {0}, translated: {1}�increase verbosity (can be repeated)�index�inline latex %r: %s�interpret module paths according to PEP-0420 implicit namespaces specification�intersphinx identifier %r is not string. Ignored�intersphinx inventory has moved: %s -> %s�invalid TestCode type�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�invalid regex %r in %s�invalid regex %r in coverage_c_regexes�invalid signature for auto%s (%r)�job number should be a positive number�keyword�kwargs for add_node() must be a (visit, depart) function tuple: %r=%r�last updated�line number spec is out of range(1-%d): %r�link between Sphinx documentation of different projects�lists all sections and subsections�loading intersphinx inventory from %s...�loading pickled environment�loading translations [%s]... �logo file %r does not exist�looking for now-outdated files... �macro�making output directory�master document name�maximum depth of submodules to show in the TOC (default: 4)�member�method�missing '+' or '-' in '%s' option.�missing attribute %s in object %s�module�module %s could not be imported: %s�modules�more than one target found for 'any' cross-reference %r: could be %s�more than one target found for cross-reference %r: %s�new config�next�next chapter�nit-picky mode, warn about all missing references�no "latex_documents" config value found; no documents will be written�no "man_pages" config value found; no manual pages will be written�no "texinfo_documents" config value found; no documents will be written�no Babel option known for language %r�no changes in version %s.�no code/output in %s block at %s:%s�no output at all, not even warnings�no output on stdout, just warnings on stderr�no targets are out of date.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�none found�not available for built-in messages�numfig is disabled. :numref: is ignored.�numfig_format is not defined for %s�object�operator�original entry�override a setting in configuration file�overwrite existing files�page�page %s matches two patterns in html_sidebars: %r and %r�pass a value into HTML templates�path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)�path to documentation source files�path to module to document�path to output directory�path where configuration file (conf.py) is located (default: same as SOURCEDIR)�pickling environment�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�program option�project author(s), used when --full is given�project name�project name (default: root module name)�project release, used when --full is given, defaults to --doc-version�project version, used when --full is given�put documentation for each module on its own page�put module documentation before submodule documentation�quick access to all modules�quiet mode�reST markup error:�reading error: %s, %s�reading sources... �reading templates... �reference label�release of project�replacement for dot in _templates etc.�resolving references...�role�role %r is already registered, it will be overridden�run Pdb on exception�run the script without creating files�search�search index couldn't be loaded, but not all documents will be built: the index will be incomplete.�search this documentation�see %s�see also %s�self referenced toctree found. Ignored.�setting %s.%s occurs in none of the searched theme configs�show full traceback on exception�signature arguments or return annotation given for automodule %s�skipped�source directory has changed�source file suffix�source files to generate rST files for�source_parser for %r is already registered�source_suffix %r is already registered�sphinx-quickstart only generate into a empty directory. Please specify a new root path.�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�statement�static method�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�targets for %d template files�template directory for template files�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension is not safe for parallel reading�the %s extension is not safe for parallel writing�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�toctree contains ref to nonexisting file %r�toctree contains reference to document %r that doesn't have a title: no link will be generated�toctree contains reference to excluded document %r�toctree contains reference to nonexisting document %r�too large :maxdepth:, ignored.�turn warnings into errors�type�undecodable source characters, replacing with "?": %r�unimplemented node type: %r�union�unknown %r toplevel_sectioning for class %r�unknown config value %r in override, ignoring�unknown index entry type %r�unknown index entry type %s found�unknown mimetype for %s, ignoring�unknown node type: %r�unsupported theme option %r given�updating environment: �use epub�use make-mode for Makefile/make.bat�use no config file at all, only -D options�variable�version of project�waiting for workers...�while setting up extension %s:�write "todo" entries that can be shown or hidden on build�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing�writing %s file...�writing additional files�writing additional pages�writing error: %s, %s�writing message catalogs... �writing output... �writing summary file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: hi Language-Team: Hindi (http://www.transifex.com/sphinx-doc/sphinx-1/language/hi/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � स्वतः सारांश #autosummary# निर्देश का प्रयोग करते हुए पुर्नसरंचितपाठ बनाता है. स्फिंक्स-ऑटोजेन स्फिंक्स.एक्स्ट.ऑटोसमरी.जेनेरेट का मुखड़ा है. यह प्रदत्त फाइलों में सम्मिलित ऑटो समरी निर्देशों के अनुसार पुर्नसरंचितपाठ बनाता है स्वतः सारांश #autosummary# निर्देश का प्रारूप स्फिंक्स.एक्स्ट.ऑटोसमरी पाइथन प्रभाग में निबंधित है और इसे आप निम्नलिखित माध्यम से पढ़ सकते हैं: pydoc sphinx.ext.autosummary � स्फिंक्स परियोजना के लिए आवश्यक फाइल बनाएं. स्फिंक्स-त्वरित-आरम्भ एक संवादपूर्ण उपकरण है जो आपकी परियोजना के बारे में कुछ प्रश्न पूछकर पूरी प्रलेखों की निर्देशिका और नमूना मेकफाइल बना देता है जिसे स्फिंक्स-बिल्ड में प्रयोग किया जा सकता है. � <MODULE_PATH> में पाइथन प्रभाग और पैकेज की पुनरावर्तित खोज करें और स्वतःप्रभाग निर्देश द्वारा <OUTPUT_PATH> में प्रति पैकेज एक रेस्ट #reST# फाइल बनाएं. <EXCLUDE_PATTERN> फाइल और/ अथवा निर्देशिका स्वरुप हो सकते हैं जो निर्माण प्रकिया में छोड़ दिए जाएंगे. नोट: सामान्यतया यह स्क्रिप्ट किसी पहले से बनाई गई फाइल पर पुनर्लेखन नहीं करती.� इन्हें (pdf)latex से चलाने के लिए उस निर्देशिका में 'मेक' आदेश चलायें (ऐसा स्वचालित रूप से करने के लिए यहाँ 'make latexpdf' आदेश का उपयोग करें)� इन्हें मेकइन्फो से चलाने के लिए उस निर्देशिका में 'मेक' आदेश चलायें (ऐसा स्वचालित रूप से करने के लिए यहाँ 'मेक इन्फो' आदेश का उपयोग करें)�(अवमानित)� (में�स्वतः प्रभाग नाम में "::" विवेकहीन है�"latex_documents" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है�"man_pages" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है�"शांत" निर्दिष्ट है, परन्तु कोई भी "परियोजना" अथवा "लेखक" निर्दिष्ट नहीं है.�"texinfo_documents" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है�%(filename)s — %(docstitle)s�%b %d, %Y�%d मिला�%d स्रोत फाइलें आदेश स्थान में दी �%r में कोई "%s " मान नहीं है�%r में कोई "रूप" मान नहीं है�%s %s�%s %s दिग्दर्शिका�%s (%s लक्षण)�%s (C++ %s)�%s (अंतर्निर्मित वर्ग)�%s (अंतर्निर्मित चर पद)�%s (%s वर्ग में)�%s (निर्देश)�%s (वैश्विक चरपद अथवा अचर) �%s (%s प्रभाग में )�%s (प्रभाग)�%s (भूमिका)�%s जोड़ा गया, %s बदला गया, %s हटाया गया�%s आदेश %r नहीं चलाया जा सकता (गणित दिखाने के लिए आवश्यक). imgmath_%s मान की जाँच करें�%s में पहले से भाग संख्या नियत है (एक के अन्दर दूसरा अंकित विषय-सूची-संरचना)�%s एक निर्देशिका नहीं है. �%s() (%s वर्ग विधि) �%s() (%s विधि)�%s() (%s स्थैतिक विधि)�%s() (अंतर्निर्मित फंक्शन)�%s() (वर्ग)�%s() (%s प्रभाग में )�© <a href="%(path)s">सर्वाधिकार</a> %(copyright)s.�© सर्वाधिकार %(copyright)s.�'%s' एक मान्य विकल्प नहीं है.�'%s' एक मान्य पाईवर्शन #pyversion# विकल्प नहीं है. �'स्थापना' को जैसा कि अभी कोन्फ़.पाई में परिभाषित किया गया है, पाइथन से निर्देशित नहीं है. कृपया इसकी परिभाषा में परिवर्तन करके इसे निर्देश योग्य कर्म बनाएं. कोन्फ़.पाई को स्फिंक्स के आयाम की तरह व्यवहार के लिए इसकी आवश्कयता है.�(<<मूल प्रविष्टि>> %s, पंक्ति %d में उपस्थित है.)�(%s v%s में)�(%s में)�, में �-A विकल्प का मान नाम = मान के रूप में होना आवश्यक है�-D विकल्प का मान नाम = मान के रूप में होना आवश्यक है�4 पंक्तिबद्ध सूचियाँ मिलीं. यह आपके द्वारा उपयोग किए गए आयाम की त्रुटि हो सकती है: %r�<<मूल प्रविष्टि>>�<h1>सभी प्रभाग जिनके लिए निर्देश उपलब्ध है</h1>�<h1>%s का स्रोत निर्देश </h1>�त्रुटि की सूचना <https://github.com/sphinx-doc/sphinx/issues> पर उपस्थित पंजिका में दर्ज की जा सकती है. धन्यवाद!�इन लेखपत्रों के बारे में�पृष्ठ %s की प्रस्तुति करते समय एक त्रुटि हुई. कारण: %r�लक्ष्य '%s' नहीं मिला�%s बिंदु के लिए कोई पहचान-चिन्ह नहीं दिया गया�चर �सावधानी�लेखक(कों) का नाम�लेखक:�संस्करण %(version)s में स्वतः रचित परिवर्तनों की सूची�आधार: %s�निर्माता %r पहले से (%s प्रभाग में) उपलब्ध है�निर्माण वर्ग %s का कोई "नाम" भाव नहीं है�निर्माता नाम %s पंजीकृत नहीं है�निर्माता नाम %s पंजीकृत नहीं है अथवा प्रवेश स्थान पर उपलब्ध नहीं है.�अंतर्निर्मित�सी ऐ.पी.आई. परिवर्तन�स्रोत निर्देशिका (%s) नहीं मिली�"lineno-match" का प्रयोग बिना जुडी "lines" के युग्म के साथ नहीं हो सकता�दोनों "%s" और "%s" विकल्पों का प्रयोग नहीं किया जा सकता�चेतावनी�संस्करण %s से अलग �परिवर्तित संस्करण %(version)s — %(docstitle)s�उद्धरण [%s] सन्दर्भ कहीं नहीं है�निर्देश लेखक:�किनारे का स्थान घटाएं�विस्तृत विषय-सूची�विन्यास मान %r पहले से विद्यमान है�विषय सामिग्री�सर्वाधिकार�दूरस्थ चित्र नहीं लाया जा सका: %s [%d]�दूरस्थ चित्र नहीं लाया जा सका: %s [%s]�%s आयाम का आयात नहीं किया जा सका�literal_block का "%s" नियमन नहीं हो सका. विशेषअंकन छोड़ दिया गया.�चित्र का आकार नहीं मिल सका. :scale: विकल्प की उपेक्षा की जा रही है.�मेकफाइल बनाएं? (हाँ के लिए y/ ना के लिए n)�विंडोज़ कमांड फाइल बनाएं? (हाँ के लिए y/ ना के लिए n)�फाइल बनाई जा रही है ...%s�खतरा�अवमानित �संस्करण %s से प्रतिबंधित �अधिकारक्षेत्र %r पंजीकृत नहीं है�कूटलेखन %r जो कि सम्मिलित फाइल %r में प्रयुक्त है, अशुद्ध प्रतीत हो रही है, एक :encoding: विकल्प देकर प्रयत्न करें�कूटलेखन त्रुटि:�आलेख का बुनियादी स्थान बताएं.�गलती�त्रुटि: एक मौजूदा conf.py फाइल दिए गए मूल पथ में प्राप्त हुई है.�त्रुटि: दिया गया पथ निर्देशिका नहीं है, अथवा स्फिंक्स फाइलें पहले से उपस्थित हैं.�त्रुटि: मुख्य फाइल %s चुने हुए मूल पथ में पहले से उपलब्ध है.�%r घटना पहले से विद्यमान है�उदाहरण�कुछ उदाहरण�निर्माण के दौरान अपवाद घटित हुआ है, दोष-मुक्तक चालू किया जा रहा �अपवाद घटित:�किनारे का स्थान बढ़ाएं�आयाम के विकल्प�बाहरी ग्राफविज़ फाइल %r नहीं मिली अथवा पढने में असफलता मिली�निर्माण सूचनापत्र फाइल को नहीं पढ़ा जा सका: %r�लेखपत्रों के पर्यवेक्षण में असफलता %s: %r�निर्माण फाइल को नहीं लिखा जा सका: %r�चित्र %s�फाइल %s पहले से उपस्थित है, छोड़ दी गई.�समाप्त: एक प्रारंभिक निर्देशिका का ढांचा बना दिया गया है.�पाद-टिप्पणी [#] सन्दर्भ कहीं नहीं है�पाद-टिप्पणी [%s] का कोई सन्दर्भ नहीं है.�पाद टिप्पणियां�एक पृष्ठ पर पूरी अनुक्रमणिका�सामान्य अनुक्रमाणिका�सार्वभौमिक प्रभाग सूची�चलिए�ग्राफविज़ निर्देश में दोनों मापदंड, विषय-वस्तु और फाइल का नाम, नहीं हो सकते�खोजे गए जोड़े छिपाएं�संकेत�यदि प्रलेखों को अंग्रेजी के अलावा अन्य किसी भाषा में लिखा जाना है, तो यहाँ पर आप भाषा का कूटशब्द दे सकते हैं. स्फिंक्स तदपुरांत, जो वाक्यांश बनाता है उसे उस भाषा में अनुवादित करेगा. मान्य भाषा कूटशब्द सूची यहाँ पर देखें https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�विषय-वस्तु के बिना ग्राफविज़ निर्देश की उपेक्षा की जा रही है. �महत्त्वपूर्ण�समावेशित फाइल %r नहीं मिली अथवा पढने में असफलता मिली�अनुक्रमणिका�अनुक्रमणिका – %(key)s�अक्षर द्वारा अनुक्रमित पृष्ठ�इनमें से कौन सा स्फिंक्स आयाम प्रयोग करना है, इंगित करें:�सूचियाँ और सारणियाँ:�मूल निर्देशिका के अन्दर, दो और निर्देशिका बनाई जाएँगी; परिवर्धित एच.टी.एम्.एल. नमूनों के लिए "_templates" और परिवर्धित रुपपत्रों और अन्य स्थैतिक फाइलों के लिए "_static" आप अधोरेखा के स्थान पर अन्य पूर्व-प्रत्यय (जैसे कि ".") का प्रयोग कर सकते हैं.�कार्य खंडित �अमान्य शीर्षक: %s�अमान्य तिथि प्रारूप. यदि आप सीधे परिणाम में दर्शाना चाहते हैं तो अक्षरमाला को एकाकी उद्धरण चिन्ह द्वारा चिन्हित करें: %s�अमान्य math_eqref_format: %r�अमान्य नमूना चर-पद: %s�मुख्य शब्दों के चर-पद�लाटेक्स आदेश %r नहीं चलाया जा सकता (गणित दिखाने के लिए आवश्यक). आई.एम्.जी.मैथ_लाटेक्स मान की जाँच करें�अंतिम बार सम्पादित %(last_updated)s.�पुस्तकालय में परिवर्तन�लाइन ब्यौरा %r: सम्मिलित फाइल %r से कोई लाइन नहीं ली जा सकीं�सूची %s�उपरोक्त परिणाम में अथवा %(outdir)s /output.txt में त्रुटियाँ ढूँढने का प्रयास �मेकफाइल और बैचफाइल का सर्जन�अशुद्ध रूप विकल्प विवरण %r, अपेक्षित प्रारूप "opt", "-opt args", "--opt args", "/opt args" अथवा "+opt args"�कई math_renderers पंजीकृत हैं. लेकिन कोई math_renderers नहीं चुना गया है.�प्रभाग सूची�प्रभाग लेखक:�प्रभाग निर्देश�प्रभाग स्तर�आपने मुख्य लेखपत्र का नाम दें (प्रत्यय रहित)�नमूने और स्थैतिक डायरेक्टरी के लिए पूर्व-प्रत्यय�संचालन�संस्करण %s से नया �अगला प्रकरण�किसी निर्माता को नहीं चुना गया, मानक उपयोग: एच्.टी.ऍम.एल.�ऐसा कोई विन्यास मान नहीं है: %s�अकारादि-क्रमहीन �टिप्पणी �टिप्पणी: imgmath और mathjax एक साथ समर्थ नहीं हो सकते. imgmath को अचिन्हित कर दिया गया है.�टिप्पणियाँ�संख्याएं �%r नामक विषयवस्तु सम्मिलित फाइल %r में नहीं मिली�मौलिक अपवाद: �अन्य मापदण्ड�अन्य परिवर्तन�सिंहावलोकन�सिंहावलोकन: प्रभाग निर्देश�मापदण्ड�इस निर्देश की स्थायी कड़ी�इस परिभाषा की स्थायी कड़ी�इस समीकरण की स्थायी कड़ी�इस शीर्ष-पंक्ति की स्थायी कड़ी�इस चित्र की स्थायी कड़ी�इस सारणी की स्थायी कड़ी�इस विषय-सूची-संरचना की स्थायी कड़ी�पिलो नहीं मिला - चित्र फाइलों की प्रतिलिपि बनाई जा रही है�खोज कार्य के लिए जावा स्क्रिप्ट का होना आवश्यक है. कृपया जावा स्क्रिप्ट को शुरू करें.�यदि यह प्रयोक्ता की गलती थी तो कृपया इसको भी रिपोर्ट करें ताकि अगली बार गलती होने पर अधिक अर्थपूर्ण सन्देश दिया जा सके.�कृपया एक फाइल प्रत्यय दें, जैसे कि '.rst' अथवा '.txt'.�कृपया एक नया फाइल नाम दें, अथवा मौजूदा फाइल का पुनर्नामकरण करें और एन्टर दबाएँ�कृपया एक नया मूल पथ दें (अथवा निकलने हेतु सिर्फ एन्टर #Enter# कर दें)�कृपया एक मान्य पथ का नाम दें�कृपया हाँ के लिए 'y' अथवा नहीं के लिए 'n' मात्र दें. �%s में से एक चुनें�कृपया कुछ वाक्यांश लिखें�कृपया निम्न विन्यासों के लिए मान प्रदान करें (मानक मान, यदि कोष्ठक में हो तो, स्वीकार करने के लिए एन्टर दबाएँ)�खोज की तैयारी�पिछला प्रकरण�परोयोजना के मूलभूत विकल्प�परियोजना की भाषा�परियोजना का नाम�परियोजना आवृत्ति�परियोजना नमूनावृत्ति�परियोजना संस्करण�पिगमेंटस लेक्सर नाम %r अज्ञात है�पाइथन अभिवृद्धि प्रस्ताव; पी.ई.पी. %s�पाइथन प्रभाग सूची�त्वरित खोज�उभारता है �पुनरावर्तन त्रुटि:�सन्दर्भ�आवृत्ति�प्रदत्त प्रकार �प्रदत्त �आलेख का बुनियादी पथ�स्फिंक्स %s संस्करण चल रहा है�खोज� %(docstitle)s में खोजें�खोज पृष्ठ�खोज परीणाम �खोज पूर्ण, खोज विषय के अनुकूल %s पृष्ठ मिला (मिले).�%(docstitle)s में खोजें�खोज जारी�भाग %s�भाग के लेखक:�यह भी देखिए�चुना हुआ बुनियादी तथा मूल स्थान: %s�विभिन्न स्रोत और निर्माण डायरेक्टरी (y/n)�स्रोत दिखाएँ�स्रोत निर्देशिका और गंतव्य निर्देशिका समरूप नहीं हो सकतीं�स्रोत फाइल का प्रत्यय�%s का स्रोत व्याख्याता पंजीकृत नहीं है�ढांचे के विकल्प�संकेत �अपूर्ण प्रविष्टि मिली: %s �सारणी %s�विषय-सूची�नमूना मानदण्ड �स्रोतों की व्यापकता की जांच पूरी, परिणाम %(outdir)spython.txt में देखें. �स्रोतों में डॉकटेस्ट्स की जांच पूरी, परिणाम %(outdir)s/output.txt में देखें. �%r crossref_type पहले से पंजीकृत है�%r निर्देश पहले से अधिकार-क्षेत्र %s में पंजीकृत है, �%r अनुक्रमणिका पहले से अधिकार-क्षेत्र %s में पंजीकृत है�%r object_type पहले से पंजीकृत है�%r भूमिका पहले से अधिकार-क्षेत्र %s में पंजीकृत है, �आयाम %s की needs_extensions मान में आवश्कता है, पर यह नहीं चढ़ाया गया है.�इस परियोजना में प्रयुक्त %s परिवर्धक को स्फिंक्स का कम से कम %s संस्करण चाहिए; इसलिए इस संस्करण से बनाना संभव नहीं है.�एच.टी.एम्.एल. पृष्ठ %(outdir)sमें है.�एच.टी.एम्.एल. पृष्ठ %(outdir)sमें हैं.�लाटेक्स लेखपत्र %(outdir)s में हैं.�टेक्सइन्फो पृष्ठ %(outdir)sमें हैं.�एक्स.एम्.एल. लेखपत्र %(outdir)s में हैं.�विन्यास मान `source_suffix' में अक्षर-समूह, अक्षर-समूहों की सूची, अथवा कोष की अनुमति है. लेकिन `%r' दिया गया है.�विन्यास मान `{name}' का प्रकार `{current.__name__}' है; मानक `{default.__name__}' का प्रयोग किया गया.�विन्यास मान `{name}' का प्रकार `{current.__name__}' है; अपेक्षित {permitted}.�`{name}` विन्यास मान, {candidates} में से एक होना चाहिए, परन्तु `{current}` दिया गया है.�विन्यास फाइल (अथवा इसके द्वारा आयातित प्रभागों) द्वारा sys.exit() का आह्वान किया गया�मूक निर्माता से किसी फाइलों की उत्पत्ति नहीं होती.�ई-पब फाइल %(outdir)s में है.�यदि आप इस विषय को कूटलिपिकारों के संज्ञान में लाना चाहते है तो पिछला पूरा विवरण %s में सहेज दिया गया है�पुस्तिका पृष्ठ %(outdir)sमें हैं.�सन्देश सूचीपत्र %(outdir)s में हैं.�संक्षिप्त विवरण फाइल %(outdir)s में है.�परियोजना का नाम बनाये गए प्रपत्रों में बहुत से स्थानों पर प्रयुक्त होगा.�छद्म-एक्स.एम्.एल. लेखपत्र %(outdir)s में हैं.�पाठ फाइल %(outdir)s में हैं.�विन्यास फाइल में प्रोग्राम के योग्य त्रुटि है: %s�आपकी विन्यास फाइल में रचनाक्रम की त्रुटि है: %s �यह पृष्ठ �यह परिस्थिति चुने गए निर्माता से मेल नहीं खाती, कृपया दूसरी डॉक-ट्री निर्देशिका चुनें. �इस परियोजना में स्फिंक्स का कम से कम %s संस्करण चाहिए और इसलिए इस संस्करण से बनाना संभव नहीं है.�इस परियोजना में आयाम %s का कम से कम %s संस्करण चाहिए इसलिए उपलब्ध संस्करण (%s) से बनाना संभव नहीं है.�देता है �सलाह�अपूर्ण �%r के लिए अनुवादक पहले से विद्यमान है�अज्ञात घटना नाम: %s�अज्ञात चित्र प्रारूप: %s...�अज्ञात math_renderer %r दिया गया.�चर पद �चेतावनी�चेतावनी देता है�स्फिंक्स %s त्वरित-आरंभ #sphinx-quickstart# उपकरण के लिए अभिनन्दन�नमस्ते! यह है�%s फाइल बन जाएगी.�मिलता है�आपके पास Sphinx द्वारा बनाई गई फाइलों को सहेजने के लिए दो विकल्प हैं. या तो आप मूल स्थान में ही "_build" निर्देशिका प्रयोग करें, अथवा मूल पथ में भिन्न "स्रोत" और "build" निर्देशिका प्रयोग करें.�आपके खोज परिणामों में कोई प्रलेख नहीं मिला. कृपया सुनिश्चित करें कि सभी शब्दों की वर्तनी शुद्ध है और आपने यथेष्ट श्रेणियां चुनी हैं.�[ऑटोसमरी] अब इसका स्वतःसारांश बना रहा है: %s�[ऑटोसमरी] %s पर लिख रहा है�[docs]�[graph: %s]�[graph]�[चित्र: %s]�[चित्र]�[स्रोत]�__all__ अंतिम अक्षरमाला होनी चाहिए, न कि %r (%s प्रभाग में) -- __all__ की उपेक्षा की जाएगी�पृष्ठ %s की प्रस्तुति करते समय यूनिकोड त्रुटि हुई. कृपया यह सुनिश्चित कर लें कि सभी नॉन-असकी #non-ASCII# विहित विन्यास मान यूनिकोड अक्षरों में हैं.�पुनर्निर्माण के लिए निश्चित फाइलों की सूची. यदि -a निर्दिष्ट है तो उपेक्षा कर दी जाएगी�%s निर्माता के लिए योग्य चित्र नहीं मिला: %s�%s निर्माता के लिए योग्य चित्र नहीं मिला: %s.(%s)�सभी कार्ययुक्तियां, वर्ग, शब्द�सभी %d पी.ओ. फाइलें�सभी स्रोत फाइलें�मोड्यूल_पाथ #module_path# को सिस.पाथ #sys.path# में जोड़ें, जब --full दिया जाता है तब इसका प्रयोग होता है �एकल लेखपत्र संकलन किया जा रहा है�लक्षण�लेखकों के नाम�प्रभागों में से डॉक्-स्ट्रिंग स्वतःसम्मिलित करें�डॉक्-टेस्ट अंशों के निर्देश भाग की स्वतः जाँच करें�ऑटोसमरी आतंरिक रूप से आर.एस.टी. फाइलें बनाता है. आपके सोर्स_सफिक्स में आर.एस.टी. सम्मिलित नहीं है. छोड़ा गया.�दोनों तालिका-स्तंभ और :चौड़ाई: विकल्प दिए गए हैं. :चौड़ाई: मान की उपेक्षा की जाएगी.�खंडित कड़ी: %s (%s)�%s निर्माण, चेतावनी %s (चेतावनी को गलती माने)| �%s सम्पूर्ण, %s चेतावनी.�%s निर्मित.�निर्मित परिस्थिति वर्तमान संस्करण नहीं है �यदि संभव हो तो समानांतर N प्रक्रियाओं में निर्माण करें (ऑटो #auto# विशेष मान द्वारा cpu-count को N पर लगा दिया जाएगा)�निर्माण सूचनापत्र फाइल खंडित है: %r�प्रयोग के लिए निर्माता (मानक: एच.टी.एम्.एल. #html#)�निर्माणाधीन [%s]: �निर्माणाधीन [mo]: �अंतर्निर्मित कर्म�बृहदाकार हो सकता है�-a विकल्प और फाइल के नामों को सम्मिलित नहीं किया जा सकता�उतारी गई फाइलों %r की प्रतिलिपि नहीं की जा सकी: %s�अतिरिक्त फाइल %r की प्रतिलिपि नहीं की जा सकी�चित्रलेख फाइल %r की प्रतिलिपि नहीं की जा सकी:%s�स्थैतिक फाइल %r की प्रतिलिपि नहीं की जा सकी�%r फाइलों को नहीं ढूँढा जा सका�चेतावनी फाइल %r नहीं खोली जा सकी: %s�असमर्थित प्रकार के साथ विन्यास मान %r का उल्लंघन नहीं किया जा सकता, अनदेखा किया गया�शब्दकोष विन्यास मान %r की उल्लंघन नहीं किया जा सकता, अनदेखा किया गया (प्रत्येक अवयव का मान रखने के लिए %r का उपयोग करें)�चित्रलेख फाइल %r नहीं पढ़ा जा सका: इसकी प्रतिलिपि बनाई जा रही है�चित्रलेख फाइल %r नहीं लिखा जा सका:%s�शीर्षक रेखाचित्र के भीतर नहीं है�संगतता की जांच की जा रही है�प्रलेखों की व्याप्ति की जाँच करें�पारस्परिक संदर्भित विषय-सूची-संरचना सन्दर्भ पाए गए, उपेक्षा की जा रही है: %s <- %s�वर्ग�वर्ग विधि�अवधारणा �विन्यास मान के आधार पर सामिग्री का सशर्त समावेश�ई-पब3 के लिए विन्यास मान "epub_author" खाली नहीं होना चाहिए�ई-पब3 के लिए विन्यास मान "epub_contributor" खाली नहीं होना चाहिए�ई-पब3 के लिए विन्यास मान "epub_copyright" (अथवा "copyright") खाली नहीं होना चाहिए�ई-पब3 के लिए विन्यास मान "epub_description" खाली नहीं होना चाहिए�ई-पब3 के लिए विन्यास मान "epub_identifier" खाली नहीं होना चाहिए�ई-पब3 के लिए विन्यास मान "epub_language" (अथवा "language") खाली नहीं होना चाहिए�ई-पब3 के लिए विन्यास मान "epub_publisher" खाली नहीं होना चाहिए�ई-पब3 के लिए विन्यास मान "epub_title" (अथवा "html_title") खाली नहीं होना चाहिए�ई-पब3 के लिए विन्यास मान "epub_uid" एक्स.एम्.एल. नाम होना चाहिए�ई-पब3 के लिए विन्यास मान "version" खाली नहीं होना चाहिए�विन्यास परिवर्तित�विन्यास निर्देशिका में कोन्फ़.पाय #conf.py# फाइल (%s) नहीं है �प्रदर्शित परिणामों के विकल्प�पिछले पृष्ठ से जारी�अगले पृष्ठ पर जारी�परिवर्तक त्रुटि के साथ बहार आ गया: [stderr] %r [stdout] %r�टेक्स सहायक फाइलों की प्रतिलिपि की जा रही है...�टेक्स सहायक फाइलों की प्रतिलिपि की जा रही है...�टेक्सइन्फो सहायक फाइलों की प्रतिलिपि की जा रही है...�अतिरिक्त फाइलों की प्रतिकृति बनाई जा रही है�उतारी गई फाइलों की प्रतिलिपि बनाई जा रही है...�अतिरिक्त फाइलों की प्रतिलिपियां बनाये जा रहे है| �चित्रों की प्रतिलिपि बनाई जा रही है...�स्रोत फाइलों की प्रतिलिपि बनाई जा रही है...�परिवर्तन सूची बनाने के लिए %r को नहीं पढ़ा जा सका�गिटहब GitHub पर लेखपत्र प्रकाशित करने के लिए .nojekyll फाइल बनाएं�बैचफाइल बनाएं�मेकफाइल बनाएं�पारंपरिक प्रारूप निर्देशिका (मानक: %(default)s)�आंकड़े �मानक भूमिका '%s' नहीं मिली�फाइलों के लिए मानक प्रत्यय (मानक: %(default)s)�नमूना चर-पद का निरूपण करें�नाम-पत्र परिभाषित करें: केवल नाम-पत्र वाले खण्डों का समावेश करें�परिमाण मात्रक %s अमान्य है. उपेक्षा की जाएगी.�निर्देश�निर्देश %r पहले से पंजीकृत है, यह निरस्त हो जाएगा�सभी परिणामों को सहेजने के लिए निर्देशिका�सभी परिणाम रखने के लिए निर्देशिका�लाटेक्स दिखाएँ %r: %s�रंगीन परिणाम ही दिखाएँ (मानक: स्वतः अनुमानित)�बैचफाइल नहीं बनाएं�मेकफाइल नहीं बनाएं�रंगीन परिणाम नहीं दिखाएँ (मानक: स्वतः अनुमानित)�Makefile/make.bat के लिए make-mode का प्रयोग नहीं करें�लेखन के लिए शेष लेखपत्र: %s�लेखपत्र�लेखपत्र आयातित सदस्य (मानक: %(default)s)�लेखपत्र किसी भी विषय-सूची-संरचना में सम्मिलित नहीं है�लेखपत्र की भाषा�लेखपत्र पठनीय नहीं है. उपेक्षित.�लेखपत्र का शीर्षक एकल पाठ बिंदु नहीं है�%s पर काम कर रहे हैं�अधिकारक्षेत्र %s पहले से पंजीकृत है�अधिकारक्षेत्र %s अभी पंजीकृत नहीं है�विषय-सूची की फाइल न बनाएं �प्रभाग/पैकेज पैकेजों का शीर्षक न बनाएं (उदाहरणार्थ, जब डॉकस्ट्रिंग्स में यह पहले से हों) �पता नहीं है कि कौन सा प्रभाग स्वतःप्रलेखन %r के लिए आयात करना है (लेखपत्र में "प्रभाग" या "वर्तमान-प्रभाग" निर्देश रख कर देखें; अथवा स्पष्ट प्रभाग नाम देकर देखें)�सहेजी गयी परिस्थिति का प्रयोग न करें, सदैव सभी फाइलों को पढ़ें�संपन्न�डॉट निर्देश %r: %s�डॉट निर्देश %r नहीं चलाया जा सकता (ग्राफविज़ परिणाम के लिए आवश्यक), ग्राफविज़_डॉट मान की जांच करें�डॉट ने किसी परिणाम फाइल का नहीं बनाया: [stderr] %r [stdout] %r�डॉट त्रुटि के साथ बहार आ गया: [stderr] %r [stdout] %r�उतारी गई फाइल पठनीय नहीं है: %s�विषयवस्तुओं का भंडार बनाया जा रहा है�%s में खोज अनुक्रमाणिका भंडार बनाया जा रहा है�प्रतिरूप उद्धरण %s, दूसरी प्रतिकृति %s में है �प्रतिरूप शीर्षक %s, दूसरी प्रतिकृति %s में है �समीकरण का प्रतिरूप शीर्षक %s, दूसरी प्रतिकृति %s में है �विषय-सूची प्रविष्टि की प्रतिलिपि पायी गई: %s�आयाम %s सक्षम करें�स्वेच्छित आयाम सक्षम करें�कुछ चीजों के साथ कुछ समस्या है, लेकिन काम के दूसरे विकल्प उपलब्ध हैं: �पाया गया शीर्ष बिंदु किसी भाग, प्रसंग, तालिका, विषय-प्रबोध अथवा पार्श्व-स्थान में नहीं है�गणक�enumerable_node %r पहले से पंजीकृत है�प्रगणक �परिस्थिति चर पद �परिस्थिति चर पद; %s�%s के पदों का प्रारूप बनाने में व्यवधान: %s�%s फाइल लिखने में व्यवधान: %s�मेकफाइल लिखने में त्रुटि: %s�अपवाद �केवल निर्देशक भाव का मूल्यांकन करते समय अपवाद: %s�आयाम %r में कोई सेटअप #setup()# कारक नहीं है; क्या यह वास्तव में स्फिंक्स का परिवर्धक प्रभाग है?�परिवर्धक %r के सेटअप() कर्म से एक असहाय वस्तु वापस मिली है; इसको 'कुछ नहीं' अथवा मेटाडाटा कोश भेजना चाहिए था�आयाम विकल्प �आयाम परिवर्तित�असफल�विषय-वस्तु के आयात में असफलता: %s�पद-विच्छेदन में असफलता: %s�कुछ चीजों पहुँचने में असफलता मिली और यह समस्याएँ मिलीं: �असफल: %s�इष्ट चिन्ह फाइल %r का अस्तित्व नहीं है�आदेश स्थान में दी गयी फाइल %r का नहीं है, उपेक्षा कर दी गई�आदेश स्थान में दी गयी फाइल %r स्रोत निर्देशिका में नहीं है, उपेक्षा की जा रही है�रुपविन्यास के पथ में फाइल %r कोई प्रमाणिक ज़िप फाइल नहीं है या इसमें कोई रुपविन्यास नहीं सहेजा गया है�फाइल प्रत्यय (मानक: rst)�विषय-सूची की फाइल का नाम (मानक: प्रभाग) �समस्याओं के साथ समाप्त हुआ�fnmatch-style फाइल और/ अथवा निर्देशिका स्वरुप जो निर्माण प्रक्रिया से छोड़ने हैं�सांकेतिक कड़ियों का अनुसरण करें. कलेक्टिव.रेसिपी.ऑमलेट के साथ प्रभावशाली. �फंक्शन�सामान्य विकल्प�स्फिंक्स-त्वरित-आरम्भ के साथ पूर्ण परियोजना उत्पन्न करें �अनुक्रमाणिका निर्मित की जा रही है�पारिभाषिक पद�व्याकरण संकेत �ग्राफविज़_आउटपुट_फॉर्मेट का 'पी.एन.जी', 'एस.वी.जी.', होना आवश्यक है, पर यह %r है�प्रभाग निर्देश विशिष्ट रूप से दर्शाया जा रहा है...�html_extra_path प्रविष्टि %r का अस्तित्व नहीं है�html_extra_path का प्रविष्टि %r outdir में है| �html_static_path प्रविष्टि %r का अस्तित्व नहीं है�html_static_path का प्रविष्टि %r outdir में है| �यदि निर्दिष्ट हो तो विभिन्न स्रोत और निर्माण पथ�अमान्य डॉकटेस्ट निर्देश की उपेक्षा की जा रही है: %r�चित्र फाइल %s पठनीय नहीं है: %s�चित्र फाइल पठनीय नहीं है: %s�"_private" प्रभाग को सम्मिलित करें �पाइथन विषयवस्तुओं के प्रलेखों के स्रोत निर्देश की कड़ी जोड़ें�गणित को सम्मिलित करें, पी.एन.जी. अथवा एस.वी.जी. में चित्रित�गणित को सम्मिलित करें, दिग्दर्शक में मैथजाक्स #MathJax# द्वारा प्रदर्शित�अनुवादित संदेश में असंगत उद्धरण के प्रसंग. मूल: {0}, अनुवादित: {1}�अनुवादित संदेश में असंगत पाद-टिप्पणी के प्रसंग. मूल: {0}, अनुवादित: {1}�अनुवादित संदेश में असंगत प्रसंग. मूल: {0}, अनुवादित: {1}�अनुवादित संदेश में असंगत शब्द के प्रसंग. मूल: {0}, अनुवादित: {1}�शब्द-प्रयोग बढ़ाएं (पुनरावृत्ति की जा सकती है) �अनुक्रमणिका�पंक्तिबद्ध लाटेक्स %r: %s�प्रभाग पथ की व्याख्या 'पी.ई.पी.-0420 निहित नामराशि विवरण' के आधार पर करें �इन्टरस्फिंक्स निर्धारक %r अक्षरमाला नहीं है. उपेक्षित�इन्टरस्फिंक्स सामान स्थानांतरित हो चुका है: %s -> %s�अमान्य टेस्टकोड का प्रकार �अमान्य css_file: %r, उपेक्षित�अमान्य js_file: %r, उपेक्षित�विन्यास मान %r के लिए अमान्य संख्या %r, अनदेखा किया गया�अमान्य numfig_format: %s�अमान्य numfig_format: %s (%r)�अमान्य रेगएक्स #regex# %r, %s में �अमान्य रेगएक्स #regex# %r, coverage_c_regexes में �स्वतः %s (%r) के लिए अमान्य हस्ताक्षर�कार्य संख्या एक धनात्मक संख्या होनी चाहिए�मुख्य-शब्द �add_node() के kwargs एक (visit, depart) फंक्शन टपल #function tuple# होने चाहिए: %r=%r�अंतिम परिवर्धन�पंक्ति संख्या का ब्यौरा सीमा से बाहर है (1-%d): %r�भिन्न परियोजनाओं के स्फिंक्स प्रलेखों का पारस्परिक सम्बन्ध करने दें�सभी अनुभागों एवं उप-अनुभागों की सूची�इन्टरस्फिंक्स सामान को %s से चढ़ाया जा रहा है ...�रक्षित स्थिति को लागू किया जा रहा है�[%s] अनुवाद पढ़ा जा रहा है...�प्रतीकचिन्ह फाइल %r का अस्तित्व नहीं है�अप्रचलित फाइलों को चिन्हित किया जा रहा है...�मैक्रो�परिणाम निर्देशिका बनाई जा रही है�मुख्य लेखपत्र का नाम�विषय-सूची में दिखाए जाने वाले उपप्रभागों की अधिकतम गहराई (मानक: 4)�सदस्य�पद्धति�'%s' विकल्प में अनुपस्थित '+' या '-'.�%s गुण %s वस्तु में अनुपस्थित�प्रभाग�प्रभाग %s का आयत नहीं किया जा सका: %s�प्रभाग�किसी भी पारस्परिक-सन्दर्भ के लिए एक से अधिक लक्ष्य मिले %r: %s संभव�पारस्परिक-सन्दर्भों के लिए एक से अधिक लक्ष्य मिले %r: %s�नव विन्यास�आगामी�अगला अध्याय�गहन जांच का पालन करें, सभी अनुपस्थित संदर्भों के बारे में सचेत करें�कोई "latex_documents" विन्यास मान नहीं मिला; कोई नहीं लिखे जाएंगे�कोई "man_pages" विन्यास मान नहीं मिला; कोई नियमावली पृष्ठ नहीं लिखे जाएंगे�कोई "texinfo_documents" विन्यास मान नहीं मिला; कोई लेखपत्र नहीं लिखे जाएंगे�%r भाषा के लिए कोई बाबेल विकल्प नहीं �%s संस्करण में कोई परिवर्तन नहीं हैं.�%s भाग में %s पर कोई निर्देश / परिणाम नहीं: %s�कुछ भी निर्गमित नहीं, यहाँ तक कि चेतावनी भी नहीं�एस.टी.डी आउट #stdout# पर कोई परिणाम नहीं, एस.टी.डी एरर #stderr# पर चेतावनियाँ �कोई प्रयोजन कालातीत नहीं है�%r नामक कोई रूप विन्यास नहीं मिला (theme.conf अनुपस्थित?)�%r नाम से कोई रूप नहीं मिला, %r द्वारा अनुगत�निर्देशक कक्षा #node class# %r पहले से पंजीकृत है, इसके अभ्यागत निरस्त हो जाएंगे �एक भी नहीं मिला�अंतर्निर्मित संदेशों में उपलब्ध नहीं है�numfig असमर्थ है. :numref: उपेक्षित है.�%s के लिए नमफिग_फॉर्मेट नहीं बताया गया है�वस्तु�चालक�मौलिक प्रविष्टि�विन्यास फाइल के एक मान का उल्लंघन करें �मौजूदा फाइलों पर पुनर्लेखन करें�पृष्ठ�पृष्ठ %s html_sidebars में दो आकृतियों से मिलता है: %r %r�एच.टी.एम्.एल. के नमूने में राशि प्रेषित करें�संचित परिस्थिति और डॉक-ट्री फाइलों का पथ (मानक: OUTPUTDIR/.doctrees)�अभिलेख की स्रोत फाइलों का पथ�प्रभाग से लेखपत्र का पथ�परिणाम निर्देशिका का पथ�पथ जहाँ पर विन्यास फाइल (conf.py) स्थित है (मानक: SOURCEDIR के समरूप)�स्थिति को परिरक्षित किया जा रहा है�लेखपत्र बनाए जा रहे हैं�पूर्ववर्ती�पिछला अध्याय�primary_domain %r नहीं मिला, अनदेखा किया गया.�%s की प्रक्रिया जारी�प्रोग्राम विकल्प �परियोजना लेखक(गण), जब --full दिया जाता है तब इसका प्रयोग होता है �परियोजना का नाम�परियोजना का नाम (मानक: मूल प्रभाग का नाम) �परियोजना आवृत्ति, जब --full दिया जाता है तब इसका प्रयोग होता है �परियोजना संस्करण, जब --full दिया जाता है तब इसका प्रयोग होता है �प्रत्येक प्रभाग के आलेख उसके अपने पृष्ठ में रखें� मुख्य प्रभाग के आलेख को उपप्रभाग के आलेख से पहले रखें�सभी प्रभाग तक तुरंत पहुँच�शांत ढंग �रेस्ट सुसज्जा त्रुटि:�अशुद्धि पाठन: %s, %s�स्रोतों को पढ़ा जा रहा है...�नमूनों को पढ़ा जा रहा है...�सन्दर्भ शीर्षक�परियोजना की आवृत्ति�_templates आदि में बिंदु का बदलाव�सन्दर्भों का विश्लेषण किया जा रहा है...�भूमिका�भूमिका %r पहले से पंजीकृत है, यह निरस्त हो जाएगी�अपवाद होने पर पी.डी.बी. चलाएं�फाइलों को बनाए बिना स्क्रिप्ट चलाएं �खोज�खोज अनुक्रमाणिका नहीं चढाई जा सकी, लेकिन सभी लेखपत्र नहीं बनाए जाएंगे: अनुक्रमणिका अपूर्ण रहेगी.�इस आलेख में खोजें�%s देखिए�%s भी देखिए�स्वयं-संदर्भित विषय-सूची-संरचना मिली है. उपेक्षा की गई.�विन्यास मान %s.%s खोजे गए किसी भी रूप विन्यास में नहीं दिखा�अपवाद होने पर पूरा विलोम-अनुगमन देखें�स्वतः-प्रभाग %s के लिए हस्ताक्षर पद अथवा प्रत्युत्तरित टिप्पणी प्रदान की गई�छोड़ा �स्रोत निर्देशिका परिवर्तित हो चुकी है �स्रोत फाइल का प्रत्यय�आर.एस.टी. फाइलें बनाने के लिए स्रोत फाइलें�%r का source_parser पहले से पंजीकृत है�source_suffix %r पहले से पंजीकृत है�स्फिंक्स-त्वरित-आरम्भ केवल एक खाली निर्देशिका में कार्यशील हो सकती है. कृपया एक नया मूल पथ निर्दिष्ट करें.�स्फिंक्स-त्वरित-आरम्भ #sphinx-quickstart# मौजूदा स्फिंक्स परियोजनाओं पर पुनर्लेखन नहीं करेगा.�स्फिंक्स-त्वरित-आरम्भ मौजूदा फाइलों पर पुनर्लेखन नहीं करेगा.�वक्तव्य �स्थैतिक पद्धति�सफल हुआ�%d पी.ओ. फाइलों के लक्ष्य कालातीत है�निर्दिष्ट %d पी.ओ. फाइलों के लक्ष्य�%d फाइलों के लक्ष्य कालातीत है�%d नमूना फाइलों के लक्ष्य�नमूना फाइलों के लिए नमूना निर्देशिका�%s आयाम यह घोषित नहीं करता कि यह समानांतर पाठन के लिए सुरक्षित है. यह मानते हुए की ऐसा नहीं है - कृपया आयाम के लेखक को जांच करने और स्पष्ट व्यक्त करने के लिए कहें.�%s आयाम यह घोषित नहीं करता कि यह समानांतर लेखन के लिए सुरक्षित है. यह मानते हुए की ऐसा नहीं है - कृपया आयाम के लेखक को जांच करने और स्पष्ट व्यक्त करने के लिए कहें.�समानांतर पठन के लिए यह %s विस्तार अथवा आयाम सुरक्षित नहीं है | �समानांतर लेखन के लिए %s विस्तार अथवा आयाम सुरक्षित नहीं है | �आलेख विषय�%r आयाम को %sसंस्करण से स्फिंक्स में सम्मिलित किया जा चुका है; आयाम की उपेक्षा की गयी.�कड़ी का कोई शीर्षक नहीं है: %s�रुपविन्यास %r में कोई अनुगत मान नहीं है�रुपविन्यास %r में कोई "रूप" मान नहीं है�विषय-सूची-संरचना में अविद्यमान फाइल %r का सन्दर्भ है�विषय-सूची-संरचना में लेखपत्र %r, जिसका कोई शीर्षक नहीं है, का सन्दर्भ है: कोई सम्बन्ध नहीं बनाया जा सकेगा�विषय-सूची-संरचना में छोड़े गए लेखपत्र %r का सन्दर्भ है�विषय-सूची-संरचना में अविद्यमान लेखपत्र %r का सन्दर्भ है�अत्याधिक अधिकतम गहराई # :maxdepth: #, उपेक्षित किया गया.�चेतावनियों को अशुद्धि मानें�प्रकार�असाधनीय स्रोत अक्षर, "?" द्वारा बदले जा रहे हैं: %r�अकार्यान्वित बिंदु प्रकार: %r�युग्म�अज्ञात %r उच्चतमस्तर_विभाजन #toplevel_sectioning# %r वर्ग के लिए�आरोहण में अज्ञात विन्यास मान %r, अनदेखा किया गया�अनुक्रमणिका की प्रविष्टि का प्रकार अज्ञात %r�अनुक्रमणिका की प्रविष्टि का प्रकार %s मिला�%s के लिए अज्ञात लेख प्रकार, छोड़ा गया�अज्ञात बिंदु प्रकार: %r�विन्यास का असमर्थित रूप विकल्प %r दिया गया�स्थिति का नवीनीकरण किया जा रहा है�ई-पब प्रयोग करें�Makefile/make.bat के लिए make-mode का प्रयोग करें�किसी भी विन्यास फाइल का उपयोग ही न करें, मात्र -D विकल्प�चर पद�परियोजना का संस्करण�कर्मियों की प्रतीक्षा हो रही है�%s आयाम को स्थापित करते हुए:�वह "शेष" प्रविष्टियाँ लिख लें, जिन्हें निर्माण के समय दिखाया या छिपाया जा सकता है�सभी फाइलें लिखें (मानक: केवल नई और परिवर्तित फाइलें लिखें)�चेतावनियाँ (और त्रुटियाँ) दी गई फाइल में लिखें�लिखा जा रहा है�%s फाइल को लिखा जा रहा है...�अतिरिक्त फाइलों को लिखा जा रहा है�अतिरिक्त पृष्ठ लिखे जा रहे हैं�अशुद्धि लेखन: %s, %s�सन्देश सूचीपत्रों को लिखा जा रहा है...�परिणाम लिखा जा रहा है...�सार फाइल को लिखा जा रहा है...��������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hi/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000435531�00000000000�021154� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Ajay Singh <ajaysajay@gmail.com>, 2019 # Purnank H. Ghumalia <me@purnank.in>, 2015-2016 # Sumanjali Damarla <damarlasumanjali@gmail.com>, 2020 # Komiya Takeshi <i.tkomiya@gmail.com>, 2019 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Hindi (http://www.transifex.com/sphinx-doc/sphinx-1/language/hi/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: hi\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "स्रोत निर्देशिका (%s) नहीं मिली" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "स्रोत निर्देशिका और गंतव्य निर्देशिका समरूप नहीं हो सकतीं" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "स्फिंक्स %s संस्करण चल रहा है" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "इस परियोजना में स्फिंक्स का कम से कम %s संस्करण चाहिए और इसलिए इस संस्करण से बनाना संभव नहीं है." #: sphinx/application.py:243 msgid "making output directory" msgstr "परिणाम निर्देशिका बनाई जा रही है" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "%s आयाम को स्थापित करते हुए:" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'स्थापना' को जैसा कि अभी कोन्फ़.पाई में परिभाषित किया गया है, पाइथन से निर्देशित नहीं है. कृपया इसकी परिभाषा में परिवर्तन करके इसे निर्देश योग्य कर्म बनाएं. कोन्फ़.पाई को स्फिंक्स के आयाम की तरह व्यवहार के लिए इसकी आवश्कयता है." #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "[%s] अनुवाद पढ़ा जा रहा है..." #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "संपन्न" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "अंतर्निर्मित संदेशों में उपलब्ध नहीं है" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "रक्षित स्थिति को लागू किया जा रहा है" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "असफल: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "किसी निर्माता को नहीं चुना गया, मानक उपयोग: एच्.टी.ऍम.एल." #: sphinx/application.py:348 msgid "succeeded" msgstr "सफल हुआ" #: sphinx/application.py:349 msgid "finished with problems" msgstr "समस्याओं के साथ समाप्त हुआ" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "%s निर्माण, चेतावनी %s (चेतावनी को गलती माने)| " #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "%s सम्पूर्ण, %s चेतावनी." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "%s निर्मित." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "निर्देशक कक्षा #node class# %r पहले से पंजीकृत है, इसके अभ्यागत निरस्त हो जाएंगे " #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "निर्देश %r पहले से पंजीकृत है, यह निरस्त हो जाएगा" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "भूमिका %r पहले से पंजीकृत है, यह निरस्त हो जाएगी" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "%s आयाम यह घोषित नहीं करता कि यह समानांतर पाठन के लिए सुरक्षित है. यह मानते हुए की ऐसा नहीं है - कृपया आयाम के लेखक को जांच करने और स्पष्ट व्यक्त करने के लिए कहें." #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "समानांतर पठन के लिए यह %s विस्तार अथवा आयाम सुरक्षित नहीं है | " #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "%s आयाम यह घोषित नहीं करता कि यह समानांतर लेखन के लिए सुरक्षित है. यह मानते हुए की ऐसा नहीं है - कृपया आयाम के लेखक को जांच करने और स्पष्ट व्यक्त करने के लिए कहें." #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "समानांतर लेखन के लिए %s विस्तार अथवा आयाम सुरक्षित नहीं है | " #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "%s पर काम कर रहे हैं" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "विन्यास निर्देशिका में कोन्फ़.पाय #conf.py# फाइल (%s) नहीं है " #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "शब्दकोष विन्यास मान %r की उल्लंघन नहीं किया जा सकता, अनदेखा किया गया (प्रत्येक अवयव का मान रखने के लिए %r का उपयोग करें)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "विन्यास मान %r के लिए अमान्य संख्या %r, अनदेखा किया गया" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "असमर्थित प्रकार के साथ विन्यास मान %r का उल्लंघन नहीं किया जा सकता, अनदेखा किया गया" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "आरोहण में अज्ञात विन्यास मान %r, अनदेखा किया गया" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "ऐसा कोई विन्यास मान नहीं है: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "विन्यास मान %r पहले से विद्यमान है" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "आपकी विन्यास फाइल में रचनाक्रम की त्रुटि है: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "विन्यास फाइल (अथवा इसके द्वारा आयातित प्रभागों) द्वारा sys.exit() का आह्वान किया गया" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "विन्यास फाइल में प्रोग्राम के योग्य त्रुटि है:\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "विन्यास मान `source_suffix' में अक्षर-समूह, अक्षर-समूहों की सूची, अथवा कोष की अनुमति है. लेकिन `%r' दिया गया है." #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "भाग %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "चित्र %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "सारणी %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "सूची %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "`{name}` विन्यास मान, {candidates} में से एक होना चाहिए, परन्तु `{current}` दिया गया है." #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "विन्यास मान `{name}' का प्रकार `{current.__name__}' है; अपेक्षित {permitted}." #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "विन्यास मान `{name}' का प्रकार `{current.__name__}' है; मानक `{default.__name__}' का प्रयोग किया गया." #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r नहीं मिला, अनदेखा किया गया." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "%r घटना पहले से विद्यमान है" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "अज्ञात घटना नाम: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "आयाम %s की needs_extensions मान में आवश्कता है, पर यह नहीं चढ़ाया गया है." #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "इस परियोजना में आयाम %s का कम से कम %s संस्करण चाहिए इसलिए उपलब्ध संस्करण (%s) से बनाना संभव नहीं है." #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "पिगमेंटस लेक्सर नाम %r अज्ञात है" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "literal_block का \"%s\" नियमन नहीं हो सका. विशेषअंकन छोड़ दिया गया." #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "लेखपत्र पठनीय नहीं है. उपेक्षित." #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "निर्माण वर्ग %s का कोई \"नाम\" भाव नहीं है" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "निर्माता %r पहले से (%s प्रभाग में) उपलब्ध है" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "निर्माता नाम %s पंजीकृत नहीं है अथवा प्रवेश स्थान पर उपलब्ध नहीं है." #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "निर्माता नाम %s पंजीकृत नहीं है" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "अधिकारक्षेत्र %s पहले से पंजीकृत है" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "अधिकारक्षेत्र %s अभी पंजीकृत नहीं है" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "%r निर्देश पहले से अधिकार-क्षेत्र %s में पंजीकृत है, " #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "%r भूमिका पहले से अधिकार-क्षेत्र %s में पंजीकृत है, " #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "%r अनुक्रमणिका पहले से अधिकार-क्षेत्र %s में पंजीकृत है" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "%r object_type पहले से पंजीकृत है" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "%r crossref_type पहले से पंजीकृत है" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "source_suffix %r पहले से पंजीकृत है" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "%r का source_parser पहले से पंजीकृत है" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "%s का स्रोत व्याख्याता पंजीकृत नहीं है" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "%r के लिए अनुवादक पहले से विद्यमान है" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "add_node() के kwargs एक (visit, depart) फंक्शन टपल #function tuple# होने चाहिए: %r=%r" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "enumerable_node %r पहले से पंजीकृत है" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "%r आयाम को %sसंस्करण से स्फिंक्स में सम्मिलित किया जा चुका है; आयाम की उपेक्षा की गयी." #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "मौलिक अपवाद:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "%s आयाम का आयात नहीं किया जा सका" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "आयाम %r में कोई सेटअप #setup()# कारक नहीं है; क्या यह वास्तव में स्फिंक्स का परिवर्धक प्रभाग है?" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "इस परियोजना में प्रयुक्त %s परिवर्धक को स्फिंक्स का कम से कम %s संस्करण चाहिए; इसलिए इस संस्करण से बनाना संभव नहीं है." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "परिवर्धक %r के सेटअप() कर्म से एक असहाय वस्तु वापस मिली है; इसको 'कुछ नहीं' अथवा मेटाडाटा कोश भेजना चाहिए था" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "पाइथन अभिवृद्धि प्रस्ताव; पी.ई.पी. %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "रुपविन्यास %r में कोई \"रूप\" मान नहीं है" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "रुपविन्यास %r में कोई अनुगत मान नहीं है" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "%r नाम से कोई रूप नहीं मिला, %r द्वारा अनुगत" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "विन्यास मान %s.%s खोजे गए किसी भी रूप विन्यास में नहीं दिखा" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "विन्यास का असमर्थित रूप विकल्प %r दिया गया" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "रुपविन्यास के पथ में फाइल %r कोई प्रमाणिक ज़िप फाइल नहीं है या इसमें कोई रुपविन्यास नहीं सहेजा गया है" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "%r नामक कोई रूप विन्यास नहीं मिला (theme.conf अनुपस्थित?)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "%s निर्माता के लिए योग्य चित्र नहीं मिला: %s.(%s)" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "%s निर्माता के लिए योग्य चित्र नहीं मिला: %s" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "निर्माणाधीन [mo]: " #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "परिणाम लिखा जा रहा है..." #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "सभी %d पी.ओ. फाइलें" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "निर्दिष्ट %d पी.ओ. फाइलों के लक्ष्य" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "%d पी.ओ. फाइलों के लक्ष्य कालातीत है" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "सभी स्रोत फाइलें" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "आदेश स्थान में दी गयी फाइल %r स्रोत निर्देशिका में नहीं है, उपेक्षा की जा रही है" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "आदेश स्थान में दी गयी फाइल %r का नहीं है, उपेक्षा कर दी गई" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "%d स्रोत फाइलें आदेश स्थान में दी " #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "%d फाइलों के लक्ष्य कालातीत है" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "निर्माणाधीन [%s]: " #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "अप्रचलित फाइलों को चिन्हित किया जा रहा है..." #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "%d मिला" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "एक भी नहीं मिला" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "स्थिति को परिरक्षित किया जा रहा है" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "संगतता की जांच की जा रही है" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "कोई प्रयोजन कालातीत नहीं है" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "स्थिति का नवीनीकरण किया जा रहा है" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "%s जोड़ा गया, %s बदला गया, %s हटाया गया" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "स्रोतों को पढ़ा जा रहा है..." #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "कर्मियों की प्रतीक्षा हो रही है" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "लेखन के लिए शेष लेखपत्र: %s" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "लेखपत्र बनाए जा रहे हैं" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "विषय-सूची प्रविष्टि की प्रतिलिपि पायी गई: %s" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "चित्रों की प्रतिलिपि बनाई जा रही है..." #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "चित्रलेख फाइल %r नहीं पढ़ा जा सका: इसकी प्रतिलिपि बनाई जा रही है" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "चित्रलेख फाइल %r की प्रतिलिपि नहीं की जा सकी:%s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "चित्रलेख फाइल %r नहीं लिखा जा सका:%s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "पिलो नहीं मिला - चित्र फाइलों की प्रतिलिपि बनाई जा रही है" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "%s के लिए अज्ञात लेख प्रकार, छोड़ा गया" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "%s फाइल को लिखा जा रहा है..." #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "संक्षिप्त विवरण फाइल %(outdir)s में है." #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "%s संस्करण में कोई परिवर्तन नहीं हैं." #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "सार फाइल को लिखा जा रहा है..." #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "अंतर्निर्मित" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "प्रभाग स्तर" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "स्रोत फाइलों की प्रतिलिपि बनाई जा रही है..." #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "परिवर्तन सूची बनाने के लिए %r को नहीं पढ़ा जा सका" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "मूक निर्माता से किसी फाइलों की उत्पत्ति नहीं होती." #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "ई-पब फाइल %(outdir)s में है." #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "ई-पब3 के लिए विन्यास मान \"epub_language\" (अथवा \"language\") खाली नहीं होना चाहिए" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "ई-पब3 के लिए विन्यास मान \"epub_uid\" एक्स.एम्.एल. नाम होना चाहिए" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "ई-पब3 के लिए विन्यास मान \"epub_title\" (अथवा \"html_title\") खाली नहीं होना चाहिए" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "ई-पब3 के लिए विन्यास मान \"epub_author\" खाली नहीं होना चाहिए" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "ई-पब3 के लिए विन्यास मान \"epub_contributor\" खाली नहीं होना चाहिए" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "ई-पब3 के लिए विन्यास मान \"epub_description\" खाली नहीं होना चाहिए" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "ई-पब3 के लिए विन्यास मान \"epub_publisher\" खाली नहीं होना चाहिए" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "ई-पब3 के लिए विन्यास मान \"epub_copyright\" (अथवा \"copyright\") खाली नहीं होना चाहिए" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "ई-पब3 के लिए विन्यास मान \"epub_identifier\" खाली नहीं होना चाहिए" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "ई-पब3 के लिए विन्यास मान \"version\" खाली नहीं होना चाहिए" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "अमान्य css_file: %r, उपेक्षित" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "सन्देश सूचीपत्र %(outdir)s में हैं." #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "%d नमूना फाइलों के लक्ष्य" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "नमूनों को पढ़ा जा रहा है..." #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "सन्देश सूचीपत्रों को लिखा जा रहा है..." #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "उपरोक्त परिणाम में अथवा %(outdir)s /output.txt में त्रुटियाँ ढूँढने का प्रयास " #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "खंडित कड़ी: %s (%s)" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "लक्ष्य '%s' नहीं मिला" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "पुस्तिका पृष्ठ %(outdir)sमें हैं." #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "कोई \"man_pages\" विन्यास मान नहीं मिला; कोई नियमावली पृष्ठ नहीं लिखे जाएंगे" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "लिखा जा रहा है" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "\"man_pages\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "एच.टी.एम्.एल. पृष्ठ %(outdir)sमें है." #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "एकल लेखपत्र संकलन किया जा रहा है" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "अतिरिक्त फाइलों को लिखा जा रहा है" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "टेक्सइन्फो पृष्ठ %(outdir)sमें हैं." #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "\nइन्हें मेकइन्फो से चलाने के लिए उस निर्देशिका में 'मेक' आदेश चलायें\n(ऐसा स्वचालित रूप से करने के लिए यहाँ 'मेक इन्फो' आदेश का उपयोग करें)" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "कोई \"texinfo_documents\" विन्यास मान नहीं मिला; कोई लेखपत्र नहीं लिखे जाएंगे" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "\"texinfo_documents\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "%s की प्रक्रिया जारी" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "सन्दर्भों का विश्लेषण किया जा रहा है..." #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (में" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "टेक्सइन्फो सहायक फाइलों की प्रतिलिपि की जा रही है..." #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "मेकफाइल लिखने में त्रुटि: %s" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "पाठ फाइल %(outdir)s में हैं." #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "%s फाइल लिखने में व्यवधान: %s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "एक्स.एम्.एल. लेखपत्र %(outdir)s में हैं." #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "छद्म-एक्स.एम्.एल. लेखपत्र %(outdir)s में हैं." #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "निर्माण सूचनापत्र फाइल खंडित है: %r" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "एच.टी.एम्.एल. पृष्ठ %(outdir)sमें हैं." #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "निर्माण सूचनापत्र फाइल को नहीं पढ़ा जा सका: %r" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "सामान्य अनुक्रमाणिका" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "अनुक्रमणिका" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "आगामी" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "पूर्ववर्ती" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "अनुक्रमाणिका निर्मित की जा रही है" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "अतिरिक्त पृष्ठ लिखे जा रहे हैं" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "उतारी गई फाइलों की प्रतिलिपि बनाई जा रही है..." #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "उतारी गई फाइलों %r की प्रतिलिपि नहीं की जा सकी: %s" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "स्थैतिक फाइल %r की प्रतिलिपि नहीं की जा सकी" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "अतिरिक्त फाइलों की प्रतिलिपियां बनाये जा रहे है| " #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "अतिरिक्त फाइल %r की प्रतिलिपि नहीं की जा सकी" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "निर्माण फाइल को नहीं लिखा जा सका: %r" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "खोज अनुक्रमाणिका नहीं चढाई जा सकी, लेकिन सभी लेखपत्र नहीं बनाए जाएंगे: अनुक्रमणिका अपूर्ण रहेगी." #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "पृष्ठ %s html_sidebars में दो आकृतियों से मिलता है: %r %r" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "पृष्ठ %s की प्रस्तुति करते समय यूनिकोड त्रुटि हुई. कृपया यह सुनिश्चित कर लें कि सभी नॉन-असकी #non-ASCII# विहित विन्यास मान यूनिकोड अक्षरों में हैं." #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "पृष्ठ %s की प्रस्तुति करते समय एक त्रुटि हुई.\nकारण: %r" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "विषयवस्तुओं का भंडार बनाया जा रहा है" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "%s में खोज अनुक्रमाणिका भंडार बनाया जा रहा है" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "अमान्य js_file: %r, उपेक्षित" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "कई math_renderers पंजीकृत हैं. लेकिन कोई math_renderers नहीं चुना गया है." #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "अज्ञात math_renderer %r दिया गया." #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "html_extra_path प्रविष्टि %r का अस्तित्व नहीं है" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "html_extra_path का प्रविष्टि %r outdir में है| " #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "html_static_path प्रविष्टि %r का अस्तित्व नहीं है" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "html_static_path का प्रविष्टि %r outdir में है| " #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "प्रतीकचिन्ह फाइल %r का अस्तित्व नहीं है" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "इष्ट चिन्ह फाइल %r का अस्तित्व नहीं है" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s दिग्दर्शिका" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "लाटेक्स लेखपत्र %(outdir)s में हैं." #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\nइन्हें (pdf)latex से चलाने के लिए उस निर्देशिका में 'मेक' आदेश चलायें\n(ऐसा स्वचालित रूप से करने के लिए यहाँ 'make latexpdf' आदेश का उपयोग करें)" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "कोई \"latex_documents\" विन्यास मान नहीं मिला; कोई नहीं लिखे जाएंगे" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "\"latex_documents\" विन्यास मान अज्ञात लेखपत्र %s का सन्दर्भ है" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "अनुक्रमणिका" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "आवृत्ति" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "%r भाषा के लिए कोई बाबेल विकल्प नहीं " #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "टेक्स सहायक फाइलों की प्रतिलिपि की जा रही है..." #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "टेक्स सहायक फाइलों की प्रतिलिपि की जा रही है..." #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "अतिरिक्त फाइलों की प्रतिकृति बनाई जा रही है" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "%r में कोई \"रूप\" मान नहीं है" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "%r में कोई \"%s \" मान नहीं है" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "निर्माण के दौरान अपवाद घटित हुआ है, दोष-मुक्तक चालू किया जा रहा " #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "कार्य खंडित " #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "रेस्ट सुसज्जा त्रुटि:" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "कूटलेखन त्रुटि:" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "यदि आप इस विषय को कूटलिपिकारों के संज्ञान में लाना चाहते है तो पिछला पूरा विवरण %s में सहेज दिया गया है" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "पुनरावर्तन त्रुटि:" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "अपवाद घटित:" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "यदि यह प्रयोक्ता की गलती थी तो कृपया इसको भी रिपोर्ट करें ताकि अगली बार गलती होने पर अधिक अर्थपूर्ण सन्देश दिया जा सके." #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "त्रुटि की सूचना <https://github.com/sphinx-doc/sphinx/issues> पर उपस्थित पंजिका में दर्ज की जा सकती है. धन्यवाद!" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "कार्य संख्या एक धनात्मक संख्या होनी चाहिए" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "अभिलेख की स्रोत फाइलों का पथ" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "परिणाम निर्देशिका का पथ" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "पुनर्निर्माण के लिए निश्चित फाइलों की सूची. यदि -a निर्दिष्ट है तो उपेक्षा कर दी जाएगी" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "सामान्य विकल्प" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "प्रयोग के लिए निर्माता (मानक: एच.टी.एम्.एल. #html#)" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "सभी फाइलें लिखें (मानक: केवल नई और परिवर्तित फाइलें लिखें)" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "सहेजी गयी परिस्थिति का प्रयोग न करें, सदैव सभी फाइलों को पढ़ें" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "संचित परिस्थिति और डॉक-ट्री फाइलों का पथ (मानक: OUTPUTDIR/.doctrees)" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "यदि संभव हो तो समानांतर N प्रक्रियाओं में निर्माण करें (ऑटो #auto# विशेष मान द्वारा cpu-count को N पर लगा दिया जाएगा)" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "पथ जहाँ पर विन्यास फाइल (conf.py) स्थित है (मानक: SOURCEDIR के समरूप)" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "किसी भी विन्यास फाइल का उपयोग ही न करें, मात्र -D विकल्प" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "विन्यास फाइल के एक मान का उल्लंघन करें " #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "एच.टी.एम्.एल. के नमूने में राशि प्रेषित करें" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "नाम-पत्र परिभाषित करें: केवल नाम-पत्र वाले खण्डों का समावेश करें" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "गहन जांच का पालन करें, सभी अनुपस्थित संदर्भों के बारे में सचेत करें" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "प्रदर्शित परिणामों के विकल्प" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "शब्द-प्रयोग बढ़ाएं (पुनरावृत्ति की जा सकती है) " #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "एस.टी.डी आउट #stdout# पर कोई परिणाम नहीं, एस.टी.डी एरर #stderr# पर चेतावनियाँ " #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "कुछ भी निर्गमित नहीं, यहाँ तक कि चेतावनी भी नहीं" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "रंगीन परिणाम ही दिखाएँ (मानक: स्वतः अनुमानित)" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "रंगीन परिणाम नहीं दिखाएँ (मानक: स्वतः अनुमानित)" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "चेतावनियाँ (और त्रुटियाँ) दी गई फाइल में लिखें" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "चेतावनियों को अशुद्धि मानें" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "अपवाद होने पर पूरा विलोम-अनुगमन देखें" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "अपवाद होने पर पी.डी.बी. चलाएं" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "%r फाइलों को नहीं ढूँढा जा सका" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "-a विकल्प और फाइल के नामों को सम्मिलित नहीं किया जा सकता" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "चेतावनी फाइल %r नहीं खोली जा सकी: %s" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "-D विकल्प का मान नाम = मान के रूप में होना आवश्यक है" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "-A विकल्प का मान नाम = मान के रूप में होना आवश्यक है" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "प्रभागों में से डॉक्-स्ट्रिंग स्वतःसम्मिलित करें" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "डॉक्-टेस्ट अंशों के निर्देश भाग की स्वतः जाँच करें" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "भिन्न परियोजनाओं के स्फिंक्स प्रलेखों का पारस्परिक सम्बन्ध करने दें" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "वह \"शेष\" प्रविष्टियाँ लिख लें, जिन्हें निर्माण के समय दिखाया या छिपाया जा सकता है" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "प्रलेखों की व्याप्ति की जाँच करें" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "गणित को सम्मिलित करें, पी.एन.जी. अथवा एस.वी.जी. में चित्रित" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "गणित को सम्मिलित करें, दिग्दर्शक में मैथजाक्स #MathJax# द्वारा प्रदर्शित" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "विन्यास मान के आधार पर सामिग्री का सशर्त समावेश" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "पाइथन विषयवस्तुओं के प्रलेखों के स्रोत निर्देश की कड़ी जोड़ें" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "गिटहब GitHub पर लेखपत्र प्रकाशित करने के लिए .nojekyll फाइल बनाएं" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "कृपया एक मान्य पथ का नाम दें" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "कृपया कुछ वाक्यांश लिखें" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "%s में से एक चुनें" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "कृपया हाँ के लिए 'y' अथवा नहीं के लिए 'n' मात्र दें. " #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "कृपया एक फाइल प्रत्यय दें, जैसे कि '.rst' अथवा '.txt'." #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "स्फिंक्स %s त्वरित-आरंभ #sphinx-quickstart# उपकरण के लिए अभिनन्दन" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "कृपया निम्न विन्यासों के लिए मान प्रदान करें (मानक मान, यदि कोष्ठक में हो तो, स्वीकार करने के लिए एन्टर दबाएँ)" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "चुना हुआ बुनियादी तथा मूल स्थान: %s" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "आलेख का बुनियादी स्थान बताएं." #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "आलेख का बुनियादी पथ" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "त्रुटि: एक मौजूदा conf.py फाइल दिए गए मूल पथ में प्राप्त हुई है." #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "स्फिंक्स-त्वरित-आरम्भ #sphinx-quickstart# मौजूदा स्फिंक्स परियोजनाओं पर पुनर्लेखन नहीं करेगा." #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "कृपया एक नया मूल पथ दें (अथवा निकलने हेतु सिर्फ एन्टर #Enter# कर दें)" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "आपके पास Sphinx द्वारा बनाई गई फाइलों को सहेजने के लिए दो विकल्प हैं.\nया तो आप मूल स्थान में ही \"_build\" निर्देशिका प्रयोग करें, अथवा\nमूल पथ में भिन्न \"स्रोत\" और \"build\" निर्देशिका प्रयोग करें." #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "विभिन्न स्रोत और निर्माण डायरेक्टरी (y/n)" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "मूल निर्देशिका के अन्दर, दो और निर्देशिका बनाई जाएँगी;\nपरिवर्धित एच.टी.एम्.एल. नमूनों के लिए \"_templates\" और परिवर्धित रुपपत्रों और अन्य स्थैतिक फाइलों के लिए \"_static\"\nआप अधोरेखा के स्थान पर अन्य पूर्व-प्रत्यय (जैसे कि \".\") का प्रयोग कर सकते हैं." #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "नमूने और स्थैतिक डायरेक्टरी के लिए पूर्व-प्रत्यय" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "परियोजना का नाम बनाये गए प्रपत्रों में बहुत से स्थानों पर प्रयुक्त होगा." #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "परियोजना का नाम" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "लेखक(कों) का नाम" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "परियोजना संस्करण" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "परियोजना आवृत्ति" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "यदि प्रलेखों को अंग्रेजी के अलावा अन्य किसी भाषा में लिखा जाना है,\nतो यहाँ पर आप भाषा का कूटशब्द दे सकते हैं. स्फिंक्स तदपुरांत,\nजो वाक्यांश बनाता है उसे उस भाषा में अनुवादित करेगा.\n\nमान्य भाषा कूटशब्द सूची यहाँ पर देखें\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "परियोजना की भाषा" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "स्रोत फाइल का प्रत्यय" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "आपने मुख्य लेखपत्र का नाम दें (प्रत्यय रहित)" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "त्रुटि: मुख्य फाइल %s चुने हुए मूल पथ में पहले से उपलब्ध है." #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "स्फिंक्स-त्वरित-आरम्भ मौजूदा फाइलों पर पुनर्लेखन नहीं करेगा." #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "कृपया एक नया फाइल नाम दें, अथवा मौजूदा फाइल का पुनर्नामकरण करें और एन्टर दबाएँ" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "इनमें से कौन सा स्फिंक्स आयाम प्रयोग करना है, इंगित करें:" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "टिप्पणी: imgmath और mathjax एक साथ समर्थ नहीं हो सकते. imgmath को अचिन्हित कर दिया गया है." #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "मेकफाइल बनाएं? (हाँ के लिए y/ ना के लिए n)" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "विंडोज़ कमांड फाइल बनाएं? (हाँ के लिए y/ ना के लिए n)" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "फाइल बनाई जा रही है ...%s" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "फाइल %s पहले से उपस्थित है, छोड़ दी गई." #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "समाप्त: एक प्रारंभिक निर्देशिका का ढांचा बना दिया गया है." #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "\nस्फिंक्स परियोजना के लिए आवश्यक फाइल बनाएं.\n\nस्फिंक्स-त्वरित-आरम्भ एक संवादपूर्ण उपकरण है जो आपकी परियोजना के \nबारे में कुछ प्रश्न पूछकर पूरी प्रलेखों की निर्देशिका और नमूना मेकफाइल \nबना देता है जिसे स्फिंक्स-बिल्ड में प्रयोग किया जा सकता है.\n" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "शांत ढंग " #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "ढांचे के विकल्प" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "यदि निर्दिष्ट हो तो विभिन्न स्रोत और निर्माण पथ" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "_templates आदि में बिंदु का बदलाव" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "परोयोजना के मूलभूत विकल्प" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "परियोजना का नाम" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "लेखकों के नाम" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "परियोजना का संस्करण" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "परियोजना की आवृत्ति" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "लेखपत्र की भाषा" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "स्रोत फाइल का प्रत्यय" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "मुख्य लेखपत्र का नाम" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "ई-पब प्रयोग करें" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "आयाम के विकल्प" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "आयाम %s सक्षम करें" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "स्वेच्छित आयाम सक्षम करें" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "मेकफाइल और बैचफाइल का सर्जन" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "मेकफाइल बनाएं" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "मेकफाइल नहीं बनाएं" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "बैचफाइल बनाएं" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "बैचफाइल नहीं बनाएं" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "Makefile/make.bat के लिए make-mode का प्रयोग करें" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "Makefile/make.bat के लिए make-mode का प्रयोग नहीं करें" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "परियोजना नमूनावृत्ति" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "नमूना फाइलों के लिए नमूना निर्देशिका" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "नमूना चर-पद का निरूपण करें" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "\"शांत\" निर्दिष्ट है, परन्तु कोई भी \"परियोजना\" अथवा \"लेखक\" निर्दिष्ट नहीं है." #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "त्रुटि: दिया गया पथ निर्देशिका नहीं है, अथवा स्फिंक्स फाइलें पहले से उपस्थित हैं." #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "स्फिंक्स-त्वरित-आरम्भ केवल एक खाली निर्देशिका में कार्यशील हो सकती है. कृपया एक नया मूल पथ निर्दिष्ट करें." #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "अमान्य नमूना चर-पद: %s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "अमान्य शीर्षक: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "पंक्ति संख्या का ब्यौरा सीमा से बाहर है (1-%d): %r" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "दोनों \"%s\" और \"%s\" विकल्पों का प्रयोग नहीं किया जा सकता" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "समावेशित फाइल %r नहीं मिली अथवा पढने में असफलता मिली" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "कूटलेखन %r जो कि सम्मिलित फाइल %r में प्रयुक्त है, अशुद्ध प्रतीत हो रही है, एक :encoding: विकल्प देकर प्रयत्न करें" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "%r नामक विषयवस्तु सम्मिलित फाइल %r में नहीं मिली" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "\"lineno-match\" का प्रयोग बिना जुडी \"lines\" के युग्म के साथ नहीं हो सकता" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "लाइन ब्यौरा %r: सम्मिलित फाइल %r से कोई लाइन नहीं ली जा सकीं" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "भाग के लेखक:" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "प्रभाग लेखक:" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "निर्देश लेखक:" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "लेखक:" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "मापदण्ड" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "प्रदत्त " #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "प्रदत्त प्रकार " #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "सदस्य" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "चर पद" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "फंक्शन" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "मैक्रो" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "युग्म" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "गणक" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "प्रगणक " #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "प्रकार" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "संस्करण %s से नया " #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "संस्करण %s से अलग " #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "संस्करण %s से प्रतिबंधित " #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "प्रतिरूप उद्धरण %s, दूसरी प्रतिकृति %s में है " #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "उद्धरण [%s] सन्दर्भ कहीं नहीं है" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "नमूना मानदण्ड " #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "देता है " #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "वर्ग" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "अवधारणा " #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (अंतर्निर्मित फंक्शन)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s विधि)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (वर्ग)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (वैश्विक चरपद अथवा अचर) " #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s लक्षण)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "चर " #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (प्रभाग)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "पद्धति" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "आंकड़े " #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "लक्षण" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "प्रभाग" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "समीकरण का प्रतिरूप शीर्षक %s, दूसरी प्रतिकृति %s में है " #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "अमान्य math_eqref_format: %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "मुख्य-शब्द " #: sphinx/domains/python.py:60 msgid "operator" msgstr "चालक" #: sphinx/domains/python.py:61 msgid "object" msgstr "वस्तु" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "अपवाद " #: sphinx/domains/python.py:63 msgid "statement" msgstr "वक्तव्य " #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "अंतर्निर्मित कर्म" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "चर पद " #: sphinx/domains/python.py:429 msgid "Raises" msgstr "उभारता है " #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (%s प्रभाग में )" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (%s प्रभाग में )" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (अंतर्निर्मित चर पद)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (अंतर्निर्मित वर्ग)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (%s वर्ग में)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s वर्ग विधि) " #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s स्थैतिक विधि)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "पाइथन प्रभाग सूची" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "प्रभाग" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "अवमानित " #: sphinx/domains/python.py:1173 msgid "class method" msgstr "वर्ग विधि" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "स्थैतिक पद्धति" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "पारस्परिक-सन्दर्भों के लिए एक से अधिक लक्ष्य मिले %r: %s" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "(अवमानित)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (निर्देश)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (भूमिका)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "निर्देश" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "भूमिका" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "परिस्थिति चर पद; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "अशुद्ध रूप विकल्प विवरण %r, अपेक्षित प्रारूप \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" अथवा \"+opt args\"" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "पारिभाषिक पद" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "व्याकरण संकेत " #: sphinx/domains/std.py:565 msgid "reference label" msgstr "सन्दर्भ शीर्षक" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "परिस्थिति चर पद " #: sphinx/domains/std.py:568 msgid "program option" msgstr "प्रोग्राम विकल्प " #: sphinx/domains/std.py:569 msgid "document" msgstr "लेखपत्र" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "प्रभाग सूची" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "खोज पृष्ठ" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "प्रतिरूप शीर्षक %s, दूसरी प्रतिकृति %s में है " #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "numfig असमर्थ है. :numref: उपेक्षित है." #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "कड़ी का कोई शीर्षक नहीं है: %s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "अमान्य numfig_format: %s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "अमान्य numfig_format: %s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "नव विन्यास" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "विन्यास परिवर्तित" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "आयाम परिवर्तित" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "निर्मित परिस्थिति वर्तमान संस्करण नहीं है " #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "स्रोत निर्देशिका परिवर्तित हो चुकी है " #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "यह परिस्थिति चुने गए निर्माता से मेल नहीं खाती, कृपया दूसरी डॉक-ट्री निर्देशिका चुनें. " #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "लेखपत्रों के पर्यवेक्षण में असफलता %s: %r" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "अधिकारक्षेत्र %r पंजीकृत नहीं है" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "स्वयं-संदर्भित विषय-सूची-संरचना मिली है. उपेक्षा की गई." #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "लेखपत्र किसी भी विषय-सूची-संरचना में सम्मिलित नहीं है" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "%s देखिए" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "%s भी देखिए" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "अनुक्रमणिका की प्रविष्टि का प्रकार अज्ञात %r" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "संकेत " #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "पारस्परिक संदर्भित विषय-सूची-संरचना सन्दर्भ पाए गए, उपेक्षा की जा रही है: %s <- %s" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "विषय-सूची-संरचना में लेखपत्र %r, जिसका कोई शीर्षक नहीं है, का सन्दर्भ है: कोई सम्बन्ध नहीं बनाया जा सकेगा" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "विषय-सूची-संरचना में छोड़े गए लेखपत्र %r का सन्दर्भ है" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "विषय-सूची-संरचना में अविद्यमान लेखपत्र %r का सन्दर्भ है" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "चित्र फाइल पठनीय नहीं है: %s" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "चित्र फाइल %s पठनीय नहीं है: %s" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "उतारी गई फाइल पठनीय नहीं है: %s" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "%s में पहले से भाग संख्या नियत है (एक के अन्दर दूसरा अंकित विषय-सूची-संरचना)" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "%s फाइल बन जाएगी." #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "\n<MODULE_PATH> में पाइथन प्रभाग और पैकेज की पुनरावर्तित खोज करें और\nस्वतःप्रभाग निर्देश द्वारा <OUTPUT_PATH> में प्रति पैकेज एक रेस्ट #reST# फाइल बनाएं.\n\n<EXCLUDE_PATTERN> फाइल और/ अथवा निर्देशिका स्वरुप हो सकते हैं\nजो निर्माण प्रकिया में छोड़ दिए जाएंगे.\n\nनोट: सामान्यतया यह स्क्रिप्ट किसी पहले से बनाई गई फाइल पर पुनर्लेखन नहीं करती." #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "प्रभाग से लेखपत्र का पथ" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "fnmatch-style फाइल और/ अथवा निर्देशिका स्वरुप जो निर्माण प्रक्रिया से छोड़ने हैं" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "सभी परिणामों को सहेजने के लिए निर्देशिका" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "विषय-सूची में दिखाए जाने वाले उपप्रभागों की अधिकतम गहराई (मानक: 4)" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "मौजूदा फाइलों पर पुनर्लेखन करें" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "सांकेतिक कड़ियों का अनुसरण करें. कलेक्टिव.रेसिपी.ऑमलेट के साथ प्रभावशाली. " #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "फाइलों को बनाए बिना स्क्रिप्ट चलाएं " #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "प्रत्येक प्रभाग के आलेख उसके अपने पृष्ठ में रखें" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "\"_private\" प्रभाग को सम्मिलित करें " #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "विषय-सूची की फाइल का नाम (मानक: प्रभाग) " #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "विषय-सूची की फाइल न बनाएं " #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "प्रभाग/पैकेज पैकेजों का शीर्षक न बनाएं (उदाहरणार्थ, जब डॉकस्ट्रिंग्स में यह पहले से हों) " #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr " मुख्य प्रभाग के आलेख को उपप्रभाग के आलेख से पहले रखें" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "प्रभाग पथ की व्याख्या 'पी.ई.पी.-0420 निहित नामराशि विवरण' के आधार पर करें " #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "फाइल प्रत्यय (मानक: rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "स्फिंक्स-त्वरित-आरम्भ के साथ पूर्ण परियोजना उत्पन्न करें " #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "मोड्यूल_पाथ #module_path# को सिस.पाथ #sys.path# में जोड़ें, जब --full दिया जाता है तब इसका प्रयोग होता है " #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "परियोजना का नाम (मानक: मूल प्रभाग का नाम) " #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "परियोजना लेखक(गण), जब --full दिया जाता है तब इसका प्रयोग होता है " #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "परियोजना संस्करण, जब --full दिया जाता है तब इसका प्रयोग होता है " #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "परियोजना आवृत्ति, जब --full दिया जाता है तब इसका प्रयोग होता है " #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "आयाम विकल्प " #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s एक निर्देशिका नहीं है. " #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "अमान्य रेगएक्स #regex# %r, %s में " #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "स्रोतों की व्यापकता की जांच पूरी, परिणाम %(outdir)spython.txt में देखें. " #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "अमान्य रेगएक्स #regex# %r, coverage_c_regexes में " #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "प्रभाग %s का आयत नहीं किया जा सका: %s" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "'%s' विकल्प में अनुपस्थित '+' या '-'." #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "'%s' एक मान्य विकल्प नहीं है." #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "'%s' एक मान्य पाईवर्शन #pyversion# विकल्प नहीं है. " #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "अमान्य टेस्टकोड का प्रकार " #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "स्रोतों में डॉकटेस्ट्स की जांच पूरी, परिणाम %(outdir)s/output.txt में देखें. " #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "%s भाग में %s पर कोई निर्देश / परिणाम नहीं: %s" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "अमान्य डॉकटेस्ट निर्देश की उपेक्षा की जा रही है: %r" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "ग्राफविज़ निर्देश में दोनों मापदंड, विषय-वस्तु और फाइल का नाम, नहीं हो सकते" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "बाहरी ग्राफविज़ फाइल %r नहीं मिली अथवा पढने में असफलता मिली" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "विषय-वस्तु के बिना ग्राफविज़ निर्देश की उपेक्षा की जा रही है. " #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "डॉट ने किसी परिणाम फाइल का नहीं बनाया:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "डॉट निर्देश %r नहीं चलाया जा सकता (ग्राफविज़ परिणाम के लिए आवश्यक), ग्राफविज़_डॉट मान की जांच करें" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "डॉट त्रुटि के साथ बहार आ गया:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "ग्राफविज़_आउटपुट_फॉर्मेट का 'पी.एन.जी', 'एस.वी.जी.', होना आवश्यक है, पर यह %r है" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "डॉट निर्देश %r: %s" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[graph: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[graph]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "परिवर्तक त्रुटि के साथ बहार आ गया:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "लाटेक्स आदेश %r नहीं चलाया जा सकता (गणित दिखाने के लिए आवश्यक). आई.एम्.जी.मैथ_लाटेक्स मान की जाँच करें" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "%s आदेश %r नहीं चलाया जा सकता (गणित दिखाने के लिए आवश्यक). imgmath_%s मान की जाँच करें" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "लाटेक्स दिखाएँ %r: %s" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "पंक्तिबद्ध लाटेक्स %r: %s" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "इस समीकरण की स्थायी कड़ी" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "इन्टरस्फिंक्स सामान स्थानांतरित हो चुका है: %s -> %s" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "इन्टरस्फिंक्स सामान को %s से चढ़ाया जा रहा है ..." #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "कुछ चीजों के साथ कुछ समस्या है, लेकिन काम के दूसरे विकल्प उपलब्ध हैं: " #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "कुछ चीजों पहुँचने में असफलता मिली और यह समस्याएँ मिलीं: " #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(%s v%s में)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(%s में)" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "इन्टरस्फिंक्स निर्धारक %r अक्षरमाला नहीं है. उपेक्षित" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[स्रोत]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "अपूर्ण " #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "अपूर्ण प्रविष्टि मिली: %s " #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<मूल प्रविष्टि>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(<<मूल प्रविष्टि>> %s, पंक्ति %d में उपस्थित है.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "मौलिक प्रविष्टि" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "प्रभाग निर्देश विशिष्ट रूप से दर्शाया जा रहा है..." #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[docs]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "प्रभाग निर्देश" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>%s का स्रोत निर्देश </h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "सिंहावलोकन: प्रभाग निर्देश" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>सभी प्रभाग जिनके लिए निर्देश उपलब्ध है</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "स्वतः %s (%r) के लिए अमान्य हस्ताक्षर" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "%s के पदों का प्रारूप बनाने में व्यवधान: %s" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "%s गुण %s वस्तु में अनुपस्थित" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "पता नहीं है कि कौन सा प्रभाग स्वतःप्रलेखन %r के लिए आयात करना है (लेखपत्र में \"प्रभाग\" या \"वर्तमान-प्रभाग\" निर्देश रख कर देखें; अथवा स्पष्ट प्रभाग नाम देकर देखें)" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "स्वतः प्रभाग नाम में \"::\" विवेकहीन है" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "स्वतः-प्रभाग %s के लिए हस्ताक्षर पद अथवा प्रत्युत्तरित टिप्पणी प्रदान की गई" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "__all__ अंतिम अक्षरमाला होनी चाहिए, न कि %r (%s प्रभाग में) -- __all__ की उपेक्षा की जाएगी" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "आधार: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "पद-विच्छेदन में असफलता: %s" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "विषय-वस्तु के आयात में असफलता: %s" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "ऑटोसमरी आतंरिक रूप से आर.एस.टी. फाइलें बनाता है. आपके सोर्स_सफिक्स में आर.एस.टी. सम्मिलित नहीं है. छोड़ा गया." #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[ऑटोसमरी] अब इसका स्वतःसारांश बना रहा है: %s" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "[ऑटोसमरी] %s पर लिख रहा है" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "\nस्वतः सारांश #autosummary# निर्देश का प्रयोग करते हुए पुर्नसरंचितपाठ बनाता है.\n\nस्फिंक्स-ऑटोजेन स्फिंक्स.एक्स्ट.ऑटोसमरी.जेनेरेट का मुखड़ा है.\nयह प्रदत्त फाइलों में सम्मिलित ऑटो समरी निर्देशों के अनुसार पुर्नसरंचितपाठ बनाता है\n\nस्वतः सारांश #autosummary# निर्देश का प्रारूप स्फिंक्स.एक्स्ट.ऑटोसमरी \nपाइथन प्रभाग में निबंधित है और इसे आप निम्नलिखित माध्यम से पढ़ सकते हैं:\n\n pydoc sphinx.ext.autosummary\n" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "आर.एस.टी. फाइलें बनाने के लिए स्रोत फाइलें" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "सभी परिणाम रखने के लिए निर्देशिका" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "फाइलों के लिए मानक प्रत्यय (मानक: %(default)s)" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "पारंपरिक प्रारूप निर्देशिका (मानक: %(default)s)" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "लेखपत्र आयातित सदस्य (मानक: %(default)s)" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "मुख्य शब्दों के चर-पद" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "उदाहरण" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "कुछ उदाहरण" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "टिप्पणियाँ" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "अन्य मापदण्ड" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "सन्दर्भ" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "चेतावनी देता है" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "मिलता है" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "सावधानी" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "चेतावनी" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "खतरा" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "गलती" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "संकेत" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "महत्त्वपूर्ण" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "टिप्पणी " #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "यह भी देखिए" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "सलाह" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "चेतावनी" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "पिछले पृष्ठ से जारी" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "अगले पृष्ठ पर जारी" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "अकारादि-क्रमहीन " #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "संख्याएं " #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "पृष्ठ" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "विषय-सूची" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "खोज" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "चलिए" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "स्रोत दिखाएँ" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "सिंहावलोकन" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "नमस्ते! यह है" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "आलेख विषय" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "अंतिम परिवर्धन" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "सूचियाँ और सारणियाँ:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "विस्तृत विषय-सूची" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "सभी अनुभागों एवं उप-अनुभागों की सूची" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "इस आलेख में खोजें" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "सार्वभौमिक प्रभाग सूची" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "सभी प्रभाग तक तुरंत पहुँच" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "सभी कार्ययुक्तियां, वर्ग, शब्द" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "अनुक्रमणिका – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "एक पृष्ठ पर पूरी अनुक्रमणिका" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "अक्षर द्वारा अनुक्रमित पृष्ठ" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "बृहदाकार हो सकता है" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "संचालन" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "%(docstitle)s में खोजें" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "इन लेखपत्रों के बारे में" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "सर्वाधिकार" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">सर्वाधिकार</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© सर्वाधिकार %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "अंतिम बार सम्पादित %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr " %(docstitle)s में खोजें" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "पिछला प्रकरण" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "पिछला अध्याय" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "अगला प्रकरण" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "अगला अध्याय" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "खोज कार्य के लिए जावा स्क्रिप्ट का होना आवश्यक है. कृपया जावा स्क्रिप्ट को शुरू करें." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "खोज" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "खोज परीणाम " #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "आपके खोज परिणामों में कोई प्रलेख नहीं मिला. कृपया सुनिश्चित करें कि सभी शब्दों की वर्तनी शुद्ध है और आपने यथेष्ट श्रेणियां चुनी हैं." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "त्वरित खोज" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "यह पृष्ठ " #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "परिवर्तित संस्करण %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "संस्करण %(version)s में स्वतः रचित परिवर्तनों की सूची" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "पुस्तकालय में परिवर्तन" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "सी ऐ.पी.आई. परिवर्तन" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "अन्य परिवर्तन" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "इस शीर्ष-पंक्ति की स्थायी कड़ी" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "इस परिभाषा की स्थायी कड़ी" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "खोजे गए जोड़े छिपाएं" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "खोज जारी" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "खोज की तैयारी" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "खोज पूर्ण, खोज विषय के अनुकूल %s पृष्ठ मिला (मिले)." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", में " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "किनारे का स्थान बढ़ाएं" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "किनारे का स्थान घटाएं" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "विषय सामिग्री" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "4 पंक्तिबद्ध सूचियाँ मिलीं. यह आपके द्वारा उपयोग किए गए आयाम की त्रुटि हो सकती है: %r" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "पाद-टिप्पणी [%s] का कोई सन्दर्भ नहीं है." #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "पाद-टिप्पणी [#] सन्दर्भ कहीं नहीं है" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "अनुवादित संदेश में असंगत पाद-टिप्पणी के प्रसंग. मूल: {0}, अनुवादित: {1}" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "अनुवादित संदेश में असंगत प्रसंग. मूल: {0}, अनुवादित: {1}" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "अनुवादित संदेश में असंगत उद्धरण के प्रसंग. मूल: {0}, अनुवादित: {1}" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "अनुवादित संदेश में असंगत शब्द के प्रसंग. मूल: {0}, अनुवादित: {1}" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "किसी भी पारस्परिक-सन्दर्भ के लिए एक से अधिक लक्ष्य मिले %r: %s संभव" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "दूरस्थ चित्र नहीं लाया जा सका: %s [%d]" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "दूरस्थ चित्र नहीं लाया जा सका: %s [%s]" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "अज्ञात चित्र प्रारूप: %s..." #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "असाधनीय स्रोत अक्षर, \"?\" द्वारा बदले जा रहे हैं: %r" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "छोड़ा " #: sphinx/util/__init__.py:537 msgid "failed" msgstr "असफल" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "अशुद्धि पाठन: %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "अशुद्धि लेखन: %s, %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "अमान्य तिथि प्रारूप. यदि आप सीधे परिणाम में दर्शाना चाहते हैं तो अक्षरमाला को एकाकी उद्धरण चिन्ह द्वारा चिन्हित करें: %s" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "विषय-सूची-संरचना में अविद्यमान फाइल %r का सन्दर्भ है" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "केवल निर्देशक भाव का मूल्यांकन करते समय अपवाद: %s" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "मानक भूमिका '%s' नहीं मिली" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "%s के लिए नमफिग_फॉर्मेट नहीं बताया गया है" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "%s बिंदु के लिए कोई पहचान-चिन्ह नहीं दिया गया" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "इस सारणी की स्थायी कड़ी" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "इस निर्देश की स्थायी कड़ी" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "इस चित्र की स्थायी कड़ी" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "इस विषय-सूची-संरचना की स्थायी कड़ी" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "चित्र का आकार नहीं मिल सका. :scale: विकल्प की उपेक्षा की जा रही है." #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "अज्ञात %r उच्चतमस्तर_विभाजन #toplevel_sectioning# %r वर्ग के लिए" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "अत्याधिक अधिकतम गहराई # :maxdepth: #, उपेक्षित किया गया." #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "लेखपत्र का शीर्षक एकल पाठ बिंदु नहीं है" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "पाया गया शीर्ष बिंदु किसी भाग, प्रसंग, तालिका, विषय-प्रबोध अथवा पार्श्व-स्थान में नहीं है" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "पाद टिप्पणियां" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "दोनों तालिका-स्तंभ और :चौड़ाई: विकल्प दिए गए हैं. :चौड़ाई: मान की उपेक्षा की जाएगी." #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "परिमाण मात्रक %s अमान्य है. उपेक्षा की जाएगी." #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "अनुक्रमणिका की प्रविष्टि का प्रकार %s मिला" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[चित्र: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[चित्र]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "शीर्षक रेखाचित्र के भीतर नहीं है" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "अकार्यान्वित बिंदु प्रकार: %r" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "अज्ञात बिंदु प्रकार: %r" �����������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.326924 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hi_IN/�������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016071� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4844513 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hi_IN/LC_MESSAGES/�������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017656� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.js����������������������������������������������0000644�0000766�0000024�00000004606�00000000000�021533� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "hi_IN", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n != 1)" });��������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.mo����������������������������������������������0000644�0000766�0000024�00000000777�00000000000�021537� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$���������������,�����-����Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: hi_IN Language-Team: Hindi (India) (http://www.transifex.com/sphinx-doc/sphinx-1/language/hi_IN/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 ��././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hi_IN/LC_MESSAGES/sphinx.po����������������������������������������������0000644�0000766�0000024�00000241442�00000000000�021536� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Hindi (India) (http://www.transifex.com/sphinx-doc/sphinx-1/language/hi_IN/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: hi_IN\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000032�00000000000�010210� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������26 mtime=1639903107.32711 ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hr/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015514� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.485205 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hr/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017301� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hr/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000007571�00000000000�021162� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "hr", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Sva prava zadr\u017eana</a> %(copyright)s.", "© Copyright %(copyright)s.": "© Sva prava zadr\u017eana %(copyright)s.", ", in ": ", u ", "About these documents": "O ovim dokumentima", "Automatically generated list of changes in version %(version)s": "Automatski generirani popis promjena u verziji %(version)s", "C API changes": "C API promjene", "Changes in Version %(version)s — %(docstitle)s": "Promjene u verziji %(version)s — %(docstitle)s", "Collapse sidebar": "Sakrij pomo\u0107nu traku", "Complete Table of Contents": "Detaljni sadr\u017eaj", "Contents": "Sadr\u017eaj", "Copyright": "Sva prava zadr\u017eana", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Poka\u017ei pomo\u0107nu traku", "Full index on one page": "Potpun indeks na jednoj stranici", "General Index": "Opceniti abecedni indeks", "Global Module Index": "Op\u0107eniti popis modula", "Go": "Tra\u017ei", "Hide Search Matches": "Sakrij rezultate pretrage", "Index": "Abecedni popis", "Index – %(key)s": "Index – %(key)s", "Index pages by letter": "Indeksiraj stranice po slovu", "Indices and tables:": "Kazala i tablice:", "Last updated on %(last_updated)s.": "Zadnji put a\u017eurirano %(last_updated)s.", "Library changes": "Promjene lib-ova", "Navigation": "Navigacija", "Next topic": "Sljede\u0107a tema", "Other changes": "Ostale promjene", "Overview": "Pregled", "Permalink to this definition": "Link na tu definiciju", "Permalink to this headline": "Link na taj naslov", "Please activate JavaScript to enable the search\n functionality.": "Molimo omogu\u0107ite JavaScript\n za djelovanje tra\u017eilice.", "Preparing search...": "Priprema pretrage...", "Previous topic": "Prija\u0161nja tema", "Quick search": "Brzo pretra\u017eivanje", "Search": "Tra\u017ei", "Search Page": "Tra\u017eilica", "Search Results": "Rezultati pretrage", "Search finished, found %s page(s) matching the search query.": "Pretraga zavr\u0161ena, prona\u0111eno %s stranica.", "Search within %(docstitle)s": "Tra\u017ei izme\u0111u %(docstitle)s", "Searching": "Pretra\u017eivanje", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Prika\u017ei izvorni kod", "Table of Contents": "", "This Page": "Trenutna stranica", "Welcome! This is": "Dobro do\u0161li! Ovo je", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Zadanim uvjetima nije prona\u0111en dokument. Molim provjerite to\u010dnost upisanih rije\u010di i odabir ozna\u010denih kategija.", "all functions, classes, terms": "sve funkcije, razredi, izrazi", "can be huge": "mo\u017ee biti ogromno", "last updated": "posljednja promjena", "lists all sections and subsections": "prika\u017ei sve sekcije i podsekcije", "next chapter": "sljede\u0107e poglavlje", "previous chapter": "Prija\u0161nje poglavlje", "quick access to all modules": "brz dostup do svih modula", "search": "tra\u017ei", "search this documentation": "tra\u017ei po dokumentaciji", "the documentation for": "dokumentacija za" }, "plural_expr": "n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2" });���������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hr/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000041746�00000000000�021163� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ �� ��� �������"���!�� ���D�����N�����T�����h�����z����������������� ���������� ����� �������������%�����6�����N�� ���g�����t��6���������������$�������� ��3����� ������������� ��0���3�����d������� ����� ����������>����� �����(�����(���%�����N��?���m������� �����!�����8�����%��������E�����M��4���c�� ������������������������� �������������#�� ���*�����5��`���Q����������������������8��������"�� ���*�����4�� ���K�����Y�����m��C���p������������.����� �����.��������5�����;�����Q�����g�����{�������!����������2����� ����� ���������� ���.�� ���:�� ���G�����R�� ���d��(���o������������,���������� ��������������� ���%�����0�����G�����d����������������������B��������'�����;��$���J�����o�� ��������������� ������������������������� ����������<��������:�� ���V�� ���`�����k�����|�� �����>��������������������p�����7���f�� �����W�����v���������w�����~������������ �����������������������L�� ���S�����_�� ���g�����s�����{������� ���������� ���������� �����A�����Z���,������� ����������4��������������� �������� ����� �����) �����F ��Y���K ��4��� ����� �� ��� ����� ����� �� ���!��M���"!��u���p!�� ���!��A���!�����3"�����J"�� ���S"�� ���a"��=���o"�����"��/���"�����"�� ���"��"���"�����#�����9#�����?#�����W#�����^#��"���e#�����#�����#��D���#�����#�� ���#��-���#��(���$�����E$�����L$�����U$�����d$�����i$�����r$��%���$�����$�����$�����$�����$�����$�����$����� %�� ���%��:���%��*���X%�� ���%�� ���%�� ���%�����%�����=&�����&��\���&��'���H'��%���p'�����'��-���'�����'����'�� ���)�����)��"���)�� ���*�����!*�����'*�����;*�����K*�����`*�����x*�����*��%���*�����*�� ���*�� ���*�����*�����*����� +�����'+�� ���A+�����O+��@���b+��)���+�����+��"���+����� ,��.���,�� ��� -�����-�����-��+���/-�����[-�����v-�� ���-�����-�����-��:���-�� ���-��%���-�����.�����,.��=���H.�����.�����.�����.��A���.��3��� /�����=/�����E/��4���_/�� ���/�����/�����/��*���/�����/�����/��$���0�����50�� ���>0�����I0��]���c0�����0�����0�����0�����0��?���1�����B1�����K1�� ���S1�����t1�����1�����1��H���1�����1�����2��/���2�����E2��>���L2�����2�����2�����2�����2�����2�� ���2��'���2�����&3��D���73�����|3�� ���3�����3�� ���3�� ���3�� ���3�����3�����3��,���3��)���4�����;4��.���D4�����s4�����4�����4�����4�� ���4�����4�����4�����4�����4�����5�����'5�����@5��:���[5�����5�����5��$���5�����5�����5����� 6�� ���6�� ���6�����)6�����06�����J6�����Q6�� ���f6�����q6��+���6�����6�����6�� ���6�����6�����6����� 7��5��� 7�����V7�� ���^7�����i7��`���~7��:���7�����8��q���,8��p���8�����9�����9�����%9�����*9�� ���F9�� ���P9�����[9��r���p9�����9�� ���9�����9�� ���9����� :�����:�����:�����9:�����A:�� ���Z:�����d:�����v:��M���:��v���:�����N;�� ���U;�����b;��?���j;�����;�����;�� ���;�����;�����;�� ���<�� ���#<��c���/<��8���<�����<�� ���<�����<�����<����� =��W���=��t���k=�����=��B���=�����3>�����I>�����R>�����c>��;���s>�����>��8���>�����>�����?��!���?�����>?�����]?�����c?�����w?�����}?��$���?�����?�����?��<���?�����?�����?��$���@��*���5@�����`@�����g@�����p@�����@�����@�����@��0���@�����@�����@�����A�����A�����A�����$A�� ���<A�����JA��C���bA��'���A�����A�����A�� ���A�����A�����vB�����B��U��� C�����cC�����C�����C��6���C�� ���C��� (deprecated)� (in �%(filename)s — %(docstitle)s�%b %d, %Y�%s %s�%s %s documentation�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�, in �<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not import extension %s�Danger�Deprecated�Deprecated since version %s�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Error�Event %r already present�Examples�Expand sidebar�External Graphviz file %r not found or reading it failed�Fig. %s�Footnotes�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Hide Search Matches�Hint�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Invalid caption: %s�Keyword Arguments�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Note�Object named %r not found in include file %r�Original exception: �Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Please activate JavaScript to enable the search functionality.�Preparing search...�Previous topic�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Release�Return type�Returns�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section %s�Section author: �See also�Show Source�Source directory and destination directory cannot be identical�Symbols�Table %s�Template Parameters�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�There is a syntax error in your configuration file: %s �This Page�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Unknown event name: %s�Variables�Warning�Welcome! This is�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�all functions, classes, terms�attribute�build %s, %s warning.�build %s.�built-in function�can be huge�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�class�class method�concept�config directory doesn't contain a conf.py file (%s)�continued from previous page�data�directive�document�domain %s already registered�domain %s not yet registered�done�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�duplicate label of equation %s, other instance in %s�enum�enumerator�environment variable�environment variable; %s�exception�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�failed: %s�file %r on theme path is not a valid zipfile or contains no theme�finished with problems�function�glossary term�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�index�invalid number %r for config value %r, ignoring�keyword�last updated�lists all sections and subsections�loading translations [%s]... �macro�making output directory�member�method�missing '+' or '-' in '%s' option.�module�modules�more than one target found for 'any' cross-reference %r: could be %s�next�next chapter�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�object�operator�original entry�page�previous�previous chapter�primary_domain %r not found, ignored.�program option�quick access to all modules�reference label�role�search�search this documentation�see %s�see also %s�setting %s.%s occurs in none of the searched theme configs�source_parser for %r is already registered�statement�static method�succeeded�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�type�unknown config value %r in override, ignoring�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: hr Language-Team: Croatian (http://www.transifex.com/sphinx-doc/sphinx-1/language/hr/) Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (zastarjelo)� (u �%(filename)s — %(docstitle)s�%b %d, %Y�%s %s�%s %s dokumentacija�%s (%s atribut)�%s (ugrađen razred)�%s (ugrađene variable)�%s (razred u %s)�%s (directive)�%s (globalna varijabla ili konstanta)�%s (u modulu %s)�%s (modul)�%s (role)�%s() (%s metoda klase)�%s() (%s metoda)�%s() (%s statična metoda)�%s() (ugrađene funkcije)�%s() (razred)�%s() (u modulu %s)�© <a href="%(path)s">Sva prava zadržana</a> %(copyright)s.�© Sva prava zadržana %(copyright)s.�'%s' nije valjana opcija.�'%s' nije valjana pyversion opcija�'setup' koji je postavljen u conf.py nije moguće pozvati. Molimo izmijenite definiciju 'setup' funkcije kako bi ju mogli izvršiti iz Pythona. Ovo je potrebno kako bi conf.py imao karakter Sphinx proširenja. �(<<original entry>> se nalazi u %s, redak %d.)�(u %s v%s)�, u �<<original entry>>�<h1>Svi moduli za koje je dostupan kod</h1>�<h1>Izvorni kod za %s</h1>�O ovim dokumentima�Argumenti�Pozor�Autor:�Automatski generirani popis promjena u verziji %(version)s�Osnovice: %s�Builder %r već postoji (u modulu %s)�Klasa %s nema "name" svojstvo�Builder %s nije registriran�Builder imena %s nije registriran ili dostupan pomoću poziva�Ugrađeni dijelovi�C API promjene�Nema izvornog direktorija (%s)�Ne može se koristiti "lineno-match" sa nespojivom grupom "lines"�Ne mogu se istovremeno koristiti *%s* i *%s* opcije�Pažnja�Promijenjeno u verziji %s�Promjene u verziji %(version)s — %(docstitle)s�Autor koda:�Sakrij pomoćnu traku�Detaljni sadržaj�Konfiguracijska vrijednost %r već postoji�Sadržaj�Sva prava zadržana�Proširenje %s ne može biti uvezena�Opasnost�Zastarjelo�Zastarijelo od verzije %s�Encoding %r za čitanje import datoteke %r nije ispravan, pokušajte dodati :encoding: opciju�Greška�Događaj %r već postoji�Primjeri�Pokaži pomoćnu traku�Vanjska Graphviz datoteka %r ne postoji ili se ne može čitati�Slika %s�Fusnote�Potpun indeks na jednoj stranici�Opceniti abecedni indeks�Općeniti popis modula�Traži�Graphviz direktiva ne može imati i sadržaj i ime datoteke za argumente�Sakrij rezultate pretrage�Savjet�Ignoriranje "graphviz" direktive bez sadržaja.�Važno�Include datoteka %r nije pronađena ili se ne može pročitati�Abecedni popis�Index – %(key)s�Indeksiraj stranice po slovu�Kazala i tablice:�Neispravan navod: %s�Argumenti�Zadnji put ažurirano %(last_updated)s.�Promjene lib-ova�Specifikacija retka %r: nema redaka preuzetih iz include datoteke %r�Ispis %s�Popis modula�Autor modula: �Kod modula�Nivo modula�Navigacija�Novo u verziji %s�Sljedeća tema�Nije odabran format, koristi se zadani: html�Ne postoji konfiguracijska vrijednost: %s�Napomena�Objekt %r nije pronađen u include datoteci %r�Izvorna iznimka: �Ostale promjene�Pregled�Pregled: kod modula�Parametri�Permalink na ovaj kod�Link na tu definiciju�Link na tu definiciju�Link na taj naslov�Permalink na ovu sliku�Permalink na ovu tablicu�Permalink na ovaj sadržaj�Molimo omogućite JavaScript za djelovanje tražilice.�Priprema pretrage...�Prijašnja tema�Python Enhancement Proposals; PEP %s�Python indeks modula�Brzo pretraživanje�Podiže�Distribucija�Vraća tip�Vraća�Izrada pomoću Sphinx v%s�Traži�Traži %(docstitle)s�Tražilica�Rezultati pretrage�Pretraga završena, pronađeno %s stranica.�Traži između %(docstitle)s�Pretraživanje�Poglavlje %s�Autor sekcije: �Više informacija�Prikaži izvorni kod�Izvorni i odredišni direktorij ne smiju biti jednaki�Simboli�Tablica %s�Parametri predloška�%s proširenje traži Sphinx verzije v%s; stoga projekt ne može biti izgrađen s ovom verzijom.�Postoji sintaksna greška u konfiguracijskoj datoteci: %s �Trenutna stranica�Ovaj projekt se ne može izgraditi s instaliranom verzijom, potrebno je instalirati Sphinx v%s ili višu verziju.�Ovaj projekt treba proširenje %s najmanje u verziji %si stoga se ne može izraditi s postojećom verzijom (%s).�Baca (iznimke)�Savjet�Todo�Nepoznato ime događaja: %s�Varijable�Upozorenje�Dobro došli! Ovo je�Zadanim uvjetima nije pronađen dokument. Molim provjerite točnost upisanih riječi i odabir označenih kategija.�[docs]�[graph: %s]�[graph]�[slika: %s]�[slika]�[source]�sve funkcije, razredi, izrazi�atribut�build %s, %s upozorenje.�build %s.�ugrađen funkcije�može biti ogromno�ne može se nadjačati konf. vrijednost %r zbog nepodržanog tipa, zanemareno�ne može se nadjačati osnovna konf. postavka %r, zanemarena je (koristite %r za postavljanje pojedinačnih elemenata)�razred�metoda klase�koncept�u konfiguracijskom direktoriju ne postoji datoteka conf.py (%s)�nastavak sa prethodne stranice�podaci�Direktive�dokument�domena %s je već registrirana�domena %s nije još registrirana�napravljeno�dot naredba %r ne može se pokrenuti (potrebna za graphviz izlaz), provjerite postavku graphviz_dot�dvostruka oznaka jednakosti %s, drugo pojavljivanje u %s�enum�enumerator�varijabla okruženja�varijabla okruženja; %s�izuzetak�proširenje %r nema funkciju setup(); radi li se o ispravnom Sphinx modulu proširenja?�proširenje %r vratio je nepodržan objekt iz setup() funkcije; rezultat treba biti None ili riječnik metapodataka�neuspješno: %s�datoteka %r iz teme nije ispravna (zip) arhiva ili ne sadrži temu�završeno uz probleme�funkcija�termin rječnika�token gramatike�graphviz_output_format mora biti 'png' ili 'svg', ali je %r�abecedni indeks�nepravilan broj %r za konf. vrijednost %r, zanemaruje se�ključna riječ�posljednja promjena�prikaži sve sekcije i podsekcije�učitavanje prijevoda [%s]... �makro�izrada izlazne mape�član�metoda�nedostaje '+' ili '-' u '%s' opciji.�modul�Moduli�više od jednog targeta za 'any' referencu %r: može biti %s�naprijed�sljedeće poglavlje�nema teme %r (nedostaje theme.conf?)�tema %r nije pronađena, nasljeđuje ju %r�objekt�operator�izvorna stavka�stranica�nazad�Prijašnje poglavlje�primary_domain %r nije pronađen, zanemareno je.�programske mogućnosti�brz dostup do svih modula�referentna oznaka�uloga�traži�traži po dokumentaciji�pogledajte %s�Dodatne informacije: %s�postavka %s.%s ne pojavljuje se u pretraženim konfiguracijama tema�source_parser za %r je već registriran�izjava�statična metoda�uspješno�%s proširenje nema deklaraciju paralelnog čitanja, uz pretpostavku da nije - zamolite autora za provjeru i postavljanje deklaracije�%s proširenje nema deklaraciju paralelnog čitanja, uz pretpostavku da nije - zamolite autora za provjeru i postavljanje deklaracije�dokumentacija za�proširenje %r se već nalazi u Sphinxu od verzije %s; ovo proširenje se zanemaruje.�tema %r nema postavku "inherit"�tema %r nema postavku "theme"�tip�nepoznata konfiguracijska vrijednost %r, zanemaruje se�varijabla���������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hr/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000256242�00000000000�021165� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Mario Šarić, 2015-2020 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Croatian (http://www.transifex.com/sphinx-doc/sphinx-1/language/hr/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: hr\n" "Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Nema izvornog direktorija (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Izvorni i odredišni direktorij ne smiju biti jednaki" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Izrada pomoću Sphinx v%s" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Ovaj projekt se ne može izgraditi s instaliranom verzijom, potrebno je instalirati Sphinx v%s ili višu verziju." #: sphinx/application.py:243 msgid "making output directory" msgstr "izrada izlazne mape" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' koji je postavljen u conf.py nije moguće pozvati. Molimo izmijenite definiciju 'setup' funkcije kako bi ju mogli izvršiti iz Pythona. Ovo je potrebno kako bi conf.py imao karakter Sphinx proširenja. " #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "učitavanje prijevoda [%s]... " #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "napravljeno" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "neuspješno: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "Nije odabran format, koristi se zadani: html" #: sphinx/application.py:348 msgid "succeeded" msgstr "uspješno" #: sphinx/application.py:349 msgid "finished with problems" msgstr "završeno uz probleme" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "build %s, %s upozorenje." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "build %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "%s proširenje nema deklaraciju paralelnog čitanja, uz pretpostavku da nije - zamolite autora za provjeru i postavljanje deklaracije" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "%s proširenje nema deklaraciju paralelnog čitanja, uz pretpostavku da nije - zamolite autora za provjeru i postavljanje deklaracije" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "u konfiguracijskom direktoriju ne postoji datoteka conf.py (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "ne može se nadjačati osnovna konf. postavka %r, zanemarena je (koristite %r za postavljanje pojedinačnih elemenata)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "nepravilan broj %r za konf. vrijednost %r, zanemaruje se" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "ne može se nadjačati konf. vrijednost %r zbog nepodržanog tipa, zanemareno" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "nepoznata konfiguracijska vrijednost %r, zanemaruje se" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "Ne postoji konfiguracijska vrijednost: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "Konfiguracijska vrijednost %r već postoji" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Postoji sintaksna greška u konfiguracijskoj datoteci: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Poglavlje %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Slika %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tablica %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Ispis %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r nije pronađen, zanemareno je." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "Događaj %r već postoji" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Nepoznato ime događaja: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "Ovaj projekt treba proširenje %s najmanje u verziji %si stoga se ne može izraditi s postojećom verzijom (%s)." #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "Klasa %s nema \"name\" svojstvo" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Builder %r već postoji (u modulu %s)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Builder imena %s nije registriran ili dostupan pomoću poziva" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "Builder %s nije registriran" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "domena %s je već registrirana" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "domena %s nije još registrirana" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "source_parser za %r je već registriran" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "proširenje %r se već nalazi u Sphinxu od verzije %s; ovo proširenje se zanemaruje." #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "Izvorna iznimka:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "Proširenje %s ne može biti uvezena" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "proširenje %r nema funkciju setup(); radi li se o ispravnom Sphinx modulu proširenja?" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "%s proširenje traži Sphinx verzije v%s; stoga projekt ne može biti izgrađen s ovom verzijom." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "proširenje %r vratio je nepodržan objekt iz setup() funkcije; rezultat treba biti None ili riječnik metapodataka" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "tema %r nema postavku \"theme\"" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "tema %r nema postavku \"inherit\"" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "tema %r nije pronađena, nasljeđuje ju %r" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "postavka %s.%s ne pojavljuje se u pretraženim konfiguracijama tema" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "datoteka %r iz teme nije ispravna (zip) arhiva ili ne sadrži temu" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "nema teme %r (nedostaje theme.conf?)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Ugrađeni dijelovi" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Nivo modula" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (u " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Opceniti abecedni indeks" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "abecedni indeks" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "naprijed" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "nazad" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s dokumentacija" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Abecedni popis" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Distribucija" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "Neispravan navod: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "Ne mogu se istovremeno koristiti *%s* i *%s* opcije" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "Include datoteka %r nije pronađena ili se ne može pročitati" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "Encoding %r za čitanje import datoteke %r nije ispravan, pokušajte dodati :encoding: opciju" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "Objekt %r nije pronađen u include datoteci %r" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "Ne može se koristiti \"lineno-match\" sa nespojivom grupom \"lines\"" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "Specifikacija retka %r: nema redaka preuzetih iz include datoteke %r" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Autor sekcije: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Autor modula: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Autor koda:" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autor:" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametri" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Vraća" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Vraća tip" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "član" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "varijabla" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funkcija" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "makro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "enum" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "enumerator" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "tip" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Novo u verziji %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Promijenjeno u verziji %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Zastarijelo od verzije %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Parametri predloška" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Baca (iznimke)" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "razred" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "koncept" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (ugrađene funkcije)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s metoda)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (razred)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (globalna varijabla ili konstanta)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s atribut)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumenti" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modul)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "metoda" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "podaci" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atribut" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modul" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "dvostruka oznaka jednakosti %s, drugo pojavljivanje u %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "ključna riječ" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operator" #: sphinx/domains/python.py:61 msgid "object" msgstr "objekt" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "izuzetak" #: sphinx/domains/python.py:63 msgid "statement" msgstr "izjava" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "ugrađen funkcije" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Varijable" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Podiže" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (u modulu %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (u modulu %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (ugrađene variable)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (ugrađen razred)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (razred u %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s metoda klase)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s statična metoda)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Python indeks modula" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "Moduli" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Zastarjelo" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "metoda klase" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "statična metoda" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (zastarjelo)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (directive)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (role)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "Direktive" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "uloga" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "varijabla okruženja; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "termin rječnika" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "token gramatike" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "referentna oznaka" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "varijabla okruženja" #: sphinx/domains/std.py:568 msgid "program option" msgstr "programske mogućnosti" #: sphinx/domains/std.py:569 msgid "document" msgstr "dokument" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Popis modula" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Tražilica" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "pogledajte %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "Dodatne informacije: %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Simboli" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "nedostaje '+' ili '-' u '%s' opciji." #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "'%s' nije valjana opcija." #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "'%s' nije valjana pyversion opcija" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "Graphviz direktiva ne može imati i sadržaj i ime datoteke za argumente" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "Vanjska Graphviz datoteka %r ne postoji ili se ne može čitati" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "Ignoriranje \"graphviz\" direktive bez sadržaja." #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "dot naredba %r ne može se pokrenuti (potrebna za graphviz izlaz), provjerite postavku graphviz_dot" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "graphviz_output_format mora biti 'png' ili 'svg', ali je %r" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[graph: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[graph]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Link na tu definiciju" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(u %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[source]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Todo" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<original entry>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(<<original entry>> se nalazi u %s, redak %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "izvorna stavka" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[docs]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Kod modula" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Izvorni kod za %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Pregled: kod modula" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Svi moduli za koje je dostupan kod</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "Osnovice: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "Argumenti" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Primjeri" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Pozor" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Pažnja" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Opasnost" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Greška" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Savjet" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Važno" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Napomena" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Više informacija" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Savjet" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Upozorenje" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "nastavak sa prethodne stranice" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "stranica" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Traži" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Traži" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Prikaži izvorni kod" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Pregled" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Dobro došli! Ovo je" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "dokumentacija za" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "posljednja promjena" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Kazala i tablice:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Detaljni sadržaj" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "prikaži sve sekcije i podsekcije" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "traži po dokumentaciji" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Općeniti popis modula" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "brz dostup do svih modula" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "sve funkcije, razredi, izrazi" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Index – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Potpun indeks na jednoj stranici" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Indeksiraj stranice po slovu" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "može biti ogromno" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigacija" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Traži između %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "O ovim dokumentima" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Sva prava zadržana" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Sva prava zadržana</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Sva prava zadržana %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Zadnji put ažurirano %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Traži %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Prijašnja tema" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "Prijašnje poglavlje" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Sljedeća tema" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "sljedeće poglavlje" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Molimo omogućite JavaScript\n za djelovanje tražilice." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "traži" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Rezultati pretrage" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Zadanim uvjetima nije pronađen dokument. Molim provjerite točnost upisanih riječi i odabir označenih kategija." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Brzo pretraživanje" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Trenutna stranica" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Promjene u verziji %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automatski generirani popis promjena u verziji %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Promjene lib-ova" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API promjene" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Ostale promjene" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Link na taj naslov" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Link na tu definiciju" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Sakrij rezultate pretrage" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Pretraživanje" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Priprema pretrage..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Pretraga završena, pronađeno %s stranica." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", u " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Pokaži pomoćnu traku" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Sakrij pomoćnu traku" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Sadržaj" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "više od jednog targeta za 'any' referencu %r: može biti %s" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Permalink na ovu tablicu" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Permalink na ovaj kod" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Permalink na ovu sliku" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Permalink na ovaj sadržaj" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Fusnote" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[slika: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[slika]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3272886 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hu/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015517� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4859443 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hu/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017304� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hu/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000010301�00000000000�021146� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "hu", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": ", ", "About these documents": "N\u00e9vjegy ezekr\u0151l a dokumentumokr\u00f3l", "Automatically generated list of changes in version %(version)s": "Automatikusan gener\u00e1lt v\u00e1ltoz\u00e1slista a(z) %(version)s v\u00e1ltozathoz", "C API changes": "C API v\u00e1ltoz\u00e1sok", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "Oldals\u00e1v \u00f6sszez\u00e1r\u00e1sa", "Complete Table of Contents": "Teljes tartalomjegyz\u00e9k", "Contents": "Tartalom", "Copyright": "Minden jog fenntartva", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Oldals\u00e1v kinyit\u00e1sa", "Full index on one page": "Teljes t\u00e1rgymutat\u00f3 egy oldalon", "General Index": "\u00c1ltal\u00e1nos t\u00e1rgymutat\u00f3", "Global Module Index": "Teljes modul t\u00e1rgymutat\u00f3", "Go": "Ok", "Hide Search Matches": "Keres\u00e9si Tal\u00e1latok Elrejt\u00e9se", "Index": "T\u00e1rgymutat\u00f3", "Index – %(key)s": "T\u00e1rgymutat\u00f3 – %(key)s", "Index pages by letter": "Oldalak ABC sorrendben", "Indices and tables:": "T\u00e1rgymutat\u00f3 \u00e9s t\u00e1bl\u00e1zatok", "Last updated on %(last_updated)s.": "Utols\u00f3 friss\u00edt\u00e9s %(last_updated)s.", "Library changes": "K\u00f6nyvt\u00e1r v\u00e1ltoz\u00e1sok", "Navigation": "Navig\u00e1ci\u00f3", "Next topic": "K\u00f6vetkez\u0151 t\u00e9mak\u00f6r", "Other changes": "Egy\u00e9b v\u00e1ltoz\u00e1sok", "Overview": "\u00c1ttekint\u00e9s", "Permalink to this definition": "Hivatkoz\u00e1s erre a defin\u00edci\u00f3ra", "Permalink to this headline": "Hivatkoz\u00e1s erre a fejezetc\u00edmre", "Please activate JavaScript to enable the search\n functionality.": "K\u00e9rem enged\u00e9lyezze a JavaScriptet a keres\u0151 funkci\u00f3\n haszn\u00e1lat\u00e1hoz.", "Preparing search...": "Felk\u00e9sz\u00fcl\u00e9s a keres\u00e9sre...", "Previous topic": "El\u0151z\u0151 t\u00e9mak\u00f6r", "Quick search": "Gyorskeres\u00e9s", "Search": "Keres\u00e9s", "Search Page": "Keres\u00e9s", "Search Results": "Keres\u00e9si Eredm\u00e9nyek", "Search finished, found %s page(s) matching the search query.": "A keres\u00e9s befejez\u0151d\u00f6tt, %s oldal egyezik a keres\u00e9si fel\u00e9teleknek.", "Search within %(docstitle)s": "Keres\u00e9s k\u00f6zt\u00fck: %(docstitle)s", "Searching": "Keres\u00e9s folyamatban", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Forr\u00e1s megtekint\u00e9se", "Table of Contents": "", "This Page": "Ez az Oldal", "Welcome! This is": "\u00dcdv\u00f6z\u00f6lj\u00fck! Ez a", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "A keres\u00e9se nem hozott eredm\u00e9nyt. Ellen\u0151rizze, a megadott kulcsszavakat \u00e9s azt, hogy megfelel\u0151 sz\u00e1m\u00fa kateg\u00f3ria van-e kiv\u00e1lasztva.", "all functions, classes, terms": "\u00f6sszes funkci\u00f3, oszt\u00e1ly \u00e9s kifejez\u00e9s", "can be huge": "nagy lehet", "last updated": "utolj\u00e1ra friss\u00edtve", "lists all sections and subsections": "kilist\u00e1zza az \u00f6sszes fejezetet \u00e9s alfejezetet", "next chapter": "k\u00f6vetkez\u0151 fejezet", "previous chapter": "el\u0151z\u0151 fejezet", "quick access to all modules": "gyors hozz\u00e1f\u00e9r\u00e9s az \u00f6sszes modulhoz", "search": "keres\u00e9s", "search this documentation": "keres\u00e9s ebben a dokument\u00e1ci\u00f3ban", "the documentation for": "dokument\u00e1ci\u00f3" }, "plural_expr": "(n != 1)" });�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hu/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000026776�00000000000�021174� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ �� ��� ����� �� ��� ����� ����� �����% �����7 �����K �����b �����s �� ��� ����� �� ��� �� ��� ����� ����� ����� ����� �����" �� ���; �����H �����\ �� ��������"��0���(�����Y�����u�� ����� ����������>���������� �����!�������� �����(�� ���>�����L�����]�����x�� ���������� ���������������H��������������� ��������)�� ���@�����N�����b�����e�����y�� ���~����������������������!���������� ������ ��� ������� ���(�� ���4�� ���A�����L�� ���^��(���i������� ��������������� ����������������������������9�����Q��B���i������������$���������� ��������������� ���$�����0�����8�����K�����R�� ���g�����s��<���������� ����� ��������������� ��� ��>��������U�����]�����f�� ���z��W�������������������� ������������������������� ���������� �������������������� �����7��������2��8���H������� ���������� ���������� �����4�������������%�� ���*��9���4�����n�����s�� ���x������������ ����� ��������������� ����� ��������������� �����"��������@�����\�����z�������������������������������� �����D�����#��� �����0�����7�����@�����O�����T�����]�����n�����}��������������������������� ���������� ����� ��� �� ��������!�����7�����<�����E����d�� ���,�����7�� ���:�����D�����J�����_�����s�����������������&���������� �������� �� ��������)�����E�����X�����t���������������������������6����������$����� ���4�����?�� ���H��E���R�� ����������(������������������ ����� �����, �����D �����M �����c �����l �����t ����� ��L��� ����� �� ��� �� ���!�� ���!�����1!�����K!�����f!�����i!�����!�����!�� ���!�����!�����!�����!��%���!�����"�����5"�����D"�����L"�����\"�� ���n"�� ���z"�����"�����"��I���"�� ���"����� #�� ���#�����*#�� ���J#�����W#�� ���w#��(���#�� ���#�����#�����#��K���$�����d$�����$��&���$�����$�� ���$�����$�����$�����$�����%�����%�����:%�����C%�����Z%�����c%��F���y%�� ���%�����%�� ���%�����&�� ���&�����!&��7���7&�� ���o&�����|&�����&�� ���&��o���&�����'�����'�� ���''�� ���2'�����='�����F'�����['�����'�� ���'�����'�� ����(����� (�����(��)���(�� ���G(��]���S(��(���(��]���(��(���8)�����a)�����v)�� ���)�����)�����)��<���)�����)�����*�� ���*��@���(*�����i*�� ���o*�� ���|*�����*�����*�����*�����*�����*�� ���*�� ���*�� ���+�� ���+�� ��� +�����*+��0���?+�����p+�� ���+�����+��"���+�����+�����+�����+�����+�� ���+�����,��Y���,��(���p,�����,�� ���,�����,�����,�����,�����,�����,��'���,�����-�� ���%-�����0-��"���9-�����\-�� ���e-�����s-�� ���-�����-�� ���-�����-�����-�� ���-��'���-��� (deprecated)� (in �%b %d, %Y�%s %s�%s %s documentation�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(in %s v%s)�, in �<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Cannot find source directory (%s)�Caution�Changed in version %s�Code author: �Collapse sidebar�Complete Table of Contents�Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Error: specified path is not a directory, or sphinx files already exist.�Expand sidebar�Fig. %s�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Listing %s�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�No builder selected, using default: html�Note�Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Please activate JavaScript to enable the search functionality.�Preparing search...�Previous topic�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Release�Return type�Returns�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section %s�Section author: �See also�Show Source�Source directory and destination directory cannot be identical�Symbols�Table %s�Template Parameters�This Page�This project needs at least Sphinx v%s and therefore cannot be built with this version.�Throws�Tip�Todo�Variables�Warning�Welcome! This is�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�all functions, classes, terms�attribute�build %s, %s warning (with warnings treated as errors).�build %s, %s warning.�build %s, %s warnings (with warnings treated as errors).�build %s, %s warnings.�build %s.�built-in function�can be huge�class�class method�config directory doesn't contain a conf.py file (%s)�continued from previous page�data�directive�directive %r is already registered, it will be overridden�done�enum�enumerator�environment variable�environment variable; %s�exception�failed: %s�finished with problems�function�glossary term�grammar token�index�keyword�last updated�lists all sections and subsections�loading pickled environment�loading translations [%s]... �macro�making output directory�member�method�module�modules�next�next chapter�node class %r is already registered, its visitors will be overridden�not available for built-in messages�object�operator�original entry�page�previous�previous chapter�program option�quick access to all modules�reference label�role�search�search this documentation�see %s�see also %s�source directory has changed�statement�static method�succeeded�the documentation for�type�variable�while setting up extension %s:�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: hu Language-Team: Hungarian (http://www.transifex.com/sphinx-doc/sphinx-1/language/hu/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (elavult)� (�%b %d, %Y�%s %s�%s %s dokumentáció�%s (%s attribútum)�%s (beépített osztály)�%s (beépített változó)�%s (osztály %s)�%s (direktíva)�%s (globális változó vagy konstans)�%s (%s modulban)�%s (modul)�%s (szerepkör)�%s nem mappa�%s() (%s osztály metódus)�%s() (%s metódus)�%s() (%s statikus metódus)�%s() (beépített függvény)�%s() (osztály)�%s() (%s modulban)�A „setup”, ahogy jelenleg a conf.py fájlban meg van határozva, nem meghívható Python függvény. Módosítsa a meghatározását, hogy meghívható függvénnyé tegye. Ez ahhoz szükséges, hogy a conf.py Sphinx kiterjesztésként viselkedjen.�(%s v%s)�, �<h1>Az összes modul, melynek forrása elérhető</h1>�<h1>%s forráskódja</h1>�Névjegy ezekről a dokumentumokról�Argumentum�Figyelem�Szerző: �Automatikusan generált változáslista a(z) %(version)s változathoz�Beépített�C API változások�Nem található a forráskönyvtár (%s)�Figyelem�A %s verzióban változott�Kód szerző: �Oldalsáv összezárása�Teljes tartalomjegyzék�Tartalom�Minden jog fenntartva�Veszély�Elavult�Elavult a(z) %s verzió óta�Hiba�A megadott útvonal nem egy mappa vagy a sphinx állományok már léteznek.�Oldalsáv kinyitása�%s. ábra�Lábjegyzetek�Teljes tárgymutató egy oldalon�Általános tárgymutató�Teljes modul tárgymutató�Ok�Keresési Találatok Elrejtése�Tipp�Fontos�Tárgymutató�Tárgymutató – %(key)s�Oldalak ABC sorrendben�Tárgymutató és táblázatok�Utolsó frissítés %(last_updated)s.�Könyvtár változások�%s. felsorlás�Modulok�Modul szerző: �Modul forráskód�Modul szint�Navigáció�Új a(z) %s verzióban�Következő témakör�Nincs összeállító kiválasztva, az alapértelmezett használata: html�Megjegyzés�Egyéb változások�Áttekintés�Áttekintés: modul forráskód�Paraméterek�Permalink erre a kódrészletre�Hivatkozás erre a definícióra�Állandó hivatkozás erre az egyenletre�Hivatkozás erre a fejezetcímre�Permalink erre a képre�Permalink erre a táblázatra�Kérem engedélyezze a JavaScriptet a kereső funkció használatához.�Felkészülés a keresésre...�Előző témakör�Python Fejlesztési Javaslatok; PEP %s�Python Modul Mutató�Gyorskeresés�Kivétel�Kiadás�Visszatérés típusa�Visszatérési érték�Sphinx %s verzió futtatása�Keresés�Keresés %(docstitle)s�Keresés�Keresési Eredmények�A keresés befejeződött, %s oldal egyezik a keresési felételeknek.�Keresés köztük: %(docstitle)s�Keresés folyamatban�%s. bekezdés�Fejezet szerző: �Lásd még�Forrás megtekintése�A forráskönyvtár és célkönyvtár nem lehet azonos�Szimbólumok�%s. táblázat�Sablonparaméterek�Ez az Oldal�Ez a projekt legalább a Sphinx %s verzióját igényli, és emiatt nem állítható össze ezzel a verzióval.�Dob�Javaslat�Tennivaló�Változók�Figyelem�Üdvözöljük! Ez a�A keresése nem hozott eredményt. Ellenőrizze, a megadott kulcsszavakat és azt, hogy megfelelő számú kategória van-e kiválasztva.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�összes funkció, osztály és kifejezés�attribútum�%s összeállítás, %s figyelmeztetés (a figyelmeztetések hibákként való kezelésével)�%s összeállítás, %s figyelmeztetés.�%s összeállítás, %s figyelmeztetés (a figyelmeztetések hibákként való kezelésével)�%s összeállítás, %s figyelmeztetés.�%s összeállítás.�beépített függvény�nagy lehet�osztály�osztály szintű metódus�a beállítási könyvtár nem tartalmaz conf.py fájlt (%s)�folytatás az előző oldalról�adat�direktíva�a(z) %r direktíva már regisztrálva van, felül lesz bírálva�kész�enumeráció�enumerátor�környezeti változó�környezeti változó; %s�kivétel�sikertelen: %s�problémákkal befejeződött�függvény�szójegyzék�nyelvtani jel�nyitóoldal�kulcsszó�utoljára frissítve�kilistázza az összes fejezetet és alfejezetet�pickle-t környezet betöltése�fordítások betöltése [%s]…�makró�kimeneti könyvtár elkészítése�tag�metódus�modul�modulok�következő�következő fejezet�a(z) %r csomópontosztály már regisztrálva van, a látogatói felül lesznek bírálva�nem érhető el beépített üzenetekhez�objektum�operátor�eredeti bejegyzés�oldal�előző�előző fejezet�program opció�gyors hozzáférés az összes modulhoz�referencia cimke�szerepkör�keresés�keresés ebben a dokumentációban�lásd %s�lásd még %s�forrás mappa megváltozott�utasítás�statikus metódus�sikerült�dokumentáció�típus�változó�a(z) %s kiterjesztés beállításakor:���././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/hu/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000252437�00000000000�021172� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Balázs Úr, 2020 # FIRST AUTHOR <EMAIL@ADDRESS>, 2011 # Molnár Dénes <denes.molnar2@stud.uni-corvinus.hu>, 2017 # Peter Schön <slapec@gmail.com>, 2018 # Tibor Toth <szunyog@gmail.com>, 2013,2015 # Tibor Toth <szunyog@gmail.com>, 2019 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Hungarian (http://www.transifex.com/sphinx-doc/sphinx-1/language/hu/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: hu\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Nem található a forráskönyvtár (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "A forráskönyvtár és célkönyvtár nem lehet azonos" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx %s verzió futtatása" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Ez a projekt legalább a Sphinx %s verzióját igényli, és emiatt nem állítható össze ezzel a verzióval." #: sphinx/application.py:243 msgid "making output directory" msgstr "kimeneti könyvtár elkészítése" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "a(z) %s kiterjesztés beállításakor:" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "A „setup”, ahogy jelenleg a conf.py fájlban meg van határozva, nem meghívható Python függvény. Módosítsa a meghatározását, hogy meghívható függvénnyé tegye. Ez ahhoz szükséges, hogy a conf.py Sphinx kiterjesztésként viselkedjen." #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "fordítások betöltése [%s]…" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "kész" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "nem érhető el beépített üzenetekhez" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "pickle-t környezet betöltése" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "sikertelen: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "Nincs összeállító kiválasztva, az alapértelmezett használata: html" #: sphinx/application.py:348 msgid "succeeded" msgstr "sikerült" #: sphinx/application.py:349 msgid "finished with problems" msgstr "problémákkal befejeződött" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "%s összeállítás, %s figyelmeztetés (a figyelmeztetések hibákként való kezelésével)" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "%s összeállítás, %s figyelmeztetés (a figyelmeztetések hibákként való kezelésével)" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "%s összeállítás, %s figyelmeztetés." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "%s összeállítás, %s figyelmeztetés." #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "%s összeállítás." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "a(z) %r csomópontosztály már regisztrálva van, a látogatói felül lesznek bírálva" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "a(z) %r direktíva már regisztrálva van, felül lesz bírálva" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "a beállítási könyvtár nem tartalmaz conf.py fájlt (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "%s. bekezdés" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "%s. ábra" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "%s. táblázat" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "%s. felsorlás" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Fejlesztési Javaslatok; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Beépített" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Modul szint" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Általános tárgymutató" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "nyitóoldal" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "következő" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "előző" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s dokumentáció" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Tárgymutató" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Kiadás" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "A megadott útvonal nem egy mappa vagy a sphinx állományok már léteznek." #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Fejezet szerző: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Modul szerző: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Kód szerző: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Szerző: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Paraméterek" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Visszatérési érték" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Visszatérés típusa" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "tag" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "változó" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "függvény" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "makró" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "enumeráció" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "enumerátor" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "típus" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Új a(z) %s verzióban" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "A %s verzióban változott" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Elavult a(z) %s verzió óta" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Sablonparaméterek" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Dob" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "osztály" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (beépített függvény)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s metódus)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (osztály)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (globális változó vagy konstans)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s attribútum)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumentum" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modul)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "metódus" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "adat" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "attribútum" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modul" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "kulcsszó" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operátor" #: sphinx/domains/python.py:61 msgid "object" msgstr "objektum" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "kivétel" #: sphinx/domains/python.py:63 msgid "statement" msgstr "utasítás" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "beépített függvény" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Változók" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Kivétel" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (%s modulban)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (%s modulban)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (beépített változó)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (beépített osztály)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (osztály %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s osztály metódus)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s statikus metódus)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Python Modul Mutató" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "modulok" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Elavult" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "osztály szintű metódus" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "statikus metódus" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (elavult)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (direktíva)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (szerepkör)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "direktíva" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "szerepkör" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "környezeti változó; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "szójegyzék" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "nyelvtani jel" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "referencia cimke" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "környezeti változó" #: sphinx/domains/std.py:568 msgid "program option" msgstr "program opció" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Modulok" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Keresés" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "forrás mappa megváltozott" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "lásd %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "lásd még %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Szimbólumok" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s nem mappa" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[graph: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[graph]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Állandó hivatkozás erre az egyenletre" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(%s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[source]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Tennivaló" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "eredeti bejegyzés" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[docs]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Modul forráskód" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>%s forráskódja</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Áttekintés: modul forráskód" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Az összes modul, melynek forrása elérhető</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Figyelem" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Figyelem" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Veszély" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Hiba" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Tipp" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Fontos" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Megjegyzés" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Lásd még" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Javaslat" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Figyelem" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "folytatás az előző oldalról" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "oldal" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Keresés" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Ok" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Forrás megtekintése" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Áttekintés" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Üdvözöljük! Ez a" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "dokumentáció" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "utoljára frissítve" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Tárgymutató és táblázatok" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Teljes tartalomjegyzék" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "kilistázza az összes fejezetet és alfejezetet" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "keresés ebben a dokumentációban" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Teljes modul tárgymutató" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "gyors hozzáférés az összes modulhoz" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "összes funkció, osztály és kifejezés" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Tárgymutató – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Teljes tárgymutató egy oldalon" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Oldalak ABC sorrendben" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "nagy lehet" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigáció" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Keresés köztük: %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Névjegy ezekről a dokumentumokról" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Minden jog fenntartva" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Utolsó frissítés %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Keresés %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Előző témakör" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "előző fejezet" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Következő témakör" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "következő fejezet" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Kérem engedélyezze a JavaScriptet a kereső funkció\n használatához." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "keresés" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Keresési Eredmények" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "A keresése nem hozott eredményt. Ellenőrizze, a megadott kulcsszavakat és azt, hogy megfelelő számú kategória van-e kiválasztva." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Gyorskeresés" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Ez az Oldal" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automatikusan generált változáslista a(z) %(version)s változathoz" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Könyvtár változások" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API változások" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Egyéb változások" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Hivatkozás erre a fejezetcímre" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Hivatkozás erre a definícióra" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Keresési Találatok Elrejtése" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Keresés folyamatban" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Felkészülés a keresésre..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "A keresés befejeződött, %s oldal egyezik a keresési felételeknek." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Oldalsáv kinyitása" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Oldalsáv összezárása" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Tartalom" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Permalink erre a táblázatra" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Permalink erre a kódrészletre" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Permalink erre a képre" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Lábjegyzetek" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[image: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[image]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3274682 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/id/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015477� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4867418 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/id/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017264� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/id/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000007361�00000000000�021142� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "id", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Hak cipta</a> %(copyright)s.", "© Copyright %(copyright)s.": "© Hak cipta %(copyright)s.", ", in ": ", di", "About these documents": "Tentang dokumen ini", "Automatically generated list of changes in version %(version)s": "Daftar perubahan dibuat otomatis untuk versi %(version)s", "C API changes": "Perubahan API C", "Changes in Version %(version)s — %(docstitle)s": "Perubahan pada Versi %(version)s — %(docstitle)s", "Collapse sidebar": "Tutup sidebar", "Complete Table of Contents": "Daftar Isi Lengkap", "Contents": "Konten", "Copyright": "Hak Cipta", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Buka sidebar", "Full index on one page": "Index penuh dalam satu halaman", "General Index": "Indeks Umum", "Global Module Index": "Index Modul Global", "Go": "Go", "Hide Search Matches": "Sembunyikan Hasil Pencarian", "Index": "Indeks", "Index – %(key)s": "Index – %(key)s", "Index pages by letter": "Index halaman berdasarkan huruf", "Indices and tables:": "Indeks dan tabel:", "Last updated on %(last_updated)s.": "Terakhir diperbarui pada %(last_updated)s.", "Library changes": "Perubahan library", "Navigation": "Navigasi", "Next topic": "Topik berikutnya", "Other changes": "Perubahan lain", "Overview": "Tinjauan", "Permalink to this definition": "Link permanen untuk definisi ini", "Permalink to this headline": "Link permanen untuk headline ini", "Please activate JavaScript to enable the search\n functionality.": "Tolong aktifkan JavaScript untuk melakukan pencarian.\n ", "Preparing search...": "Penyiapkan pencarian...", "Previous topic": "Topik sebelumnya", "Quick search": "Pencarian cepat", "Search": "Pencarian", "Search Page": "Pencarian Halaman", "Search Results": "Hasil Pencarian", "Search finished, found %s page(s) matching the search query.": "Pencarian selesai, menemukan %s halaman yang cocok dengan kueri pencarian.", "Search within %(docstitle)s": "Pencarian dalam %(docstitle)s", "Searching": "Pencarian", "Searching for multiple words only shows matches that contain\n all words.": "Mencari beberapa kata hanya menunjukkan kecocokan yang mengandung\n \u00a0\u00a0 semua kata.", "Show Source": "Lihat Sumber", "Table of Contents": "Daftar Isi", "This Page": "Halaman Ini", "Welcome! This is": "Selamat Datang! Ini adalah", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Tidak ada dokumen yang cocok dengan pencarian anda. Pastikan semua kata ditulis dengan benar dan sudah memilih cukup kategori.", "all functions, classes, terms": "semua fungsi, class, term", "can be huge": "dapat menjadi besar", "last updated": "terakhir diperbarui", "lists all sections and subsections": "daftar semua seksi dan subseksi", "next chapter": "bab berikutnya", "previous chapter": "bab sebelum", "quick access to all modules": "akses cepat semua modul", "search": "pencarian", "search this documentation": "pencarian pada dokumentasi ini", "the documentation for": "dokumentasi untuk" }, "plural_expr": "0" });�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/id/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000167214�00000000000�021145� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������(����(�����)��E��*��r���+��l���K,�� ���,�����,��*���,��=���,��7���5-��H���m-��?���-��"���-�� ���.�����#.��%���,.�����R.�����X.�����l.�� ���~.�����.�����.�����.�����.�� ���.�����.�� ���/�� ���/�� ���/��S���?/��A���/�����/�����/�����0�����0�����,0�� ���E0�����R0��6���f0�����0�����0��$���0�����0��3���1�� ���1�����1������2��1���2��1���82��G���j2�����2��0���2�����2��b���3�����u3��6���3�����3�� ���3�� ���3�� ���4����� 4�����4��>���%4�� ���d4��(���n4��(���4�����4��?���4�����5�� ���(5��!���65��8���X5��%���5�����5�����5��4���5�� ��� 6�� ���+6�����96�����J6�����e6�����6�� ���6��%���6��%���6�����6��:���7��7���=7�����u7��"���7�����7�����7�� ���7�����7�����7��`��� 8�����l8��&���|8�����8��D���8��H���8��K���79�����9�����9�����9��5���9�����9�����9�����:��8���:��"���Q:��"���t:��#���:�����:��!���:��:���:����� ;�� ���@;�� ���a;�����k;�� ���;�����;�����;��C���;�����;�����;��.���<�� ���3<��.���=<�����l<�����r<�����<��D���<�����<�� ���<�����=��[���=�����t=�����=�����=��Y���=��!���>�����>>��2���N>�� ���>��C���>�����>��n���>��E���_?�� ���?�����?�� ���?�� ���?��-���?��(��� @�� ���2@�����=@�� ���O@��(���Z@�����@�����@�����@��Z���@����� A�����A��,���A�����HA�����]A�� ���nA�����|A�����A�� ���A�����A�����A�����A�����A�����B�����(B�����@B��&���ZB��B���B��i���B��2���.C��I���aC��4���C�����C������D����� D�����8D��y���PD�����D�����D�����D�����E�� ���E�����!E�����1E�����DE��#���TE��$���xE�����E�� ���E�����E�����E�� ���E�����E�� ���E�����E�����E�����F�����0F�����7F�� ���LF�����XF��<���gF�����F�� ���F��K���F�� ���G�����!G�����2G��+���;G�� ���gG��>���sG�����G��#���G�����G�����G�����H�����H�����!H�����3H��Y���GH��Z���H��*���H��3���'I��/���[I��(���I��.���I��P���I��p���4J�����J��!���J��"���J��$��� K�� ���/K��e���PK��Z���K��N���L��T���`L��K���L��%���M�����'M��[���GM��#���M��'���M��#���M��I���N��'���]N��!���N��=���N��7���N�� ���O��d���'O��W���O��v���O�����[P�����bP�����fP�� ���kP�����P�����P��"���P�� ���P�����P�����P��,���P�����'Q�����8Q�����NQ�����UQ��,���Q����� R�����)R�� ���0R�����<R�� ���DR�����PR�����XR��N���aR�����R��?���<S��-���|S��2���S�����S�����S�����T��9���T�����YT�� ���tT�� ���~T��,���T��2���T��b���T��G���NU�����U��7���U�����U�� ���U��%���V��`���)V�����V�����V�����V�����V�����V�� ���V��&���W��$���,W�����QW�����kW�����W�����W�����W��A���W��Z���X��-���vX�����X�����X�����X��!���X��8���Y�����PY�� ���VY�����cY�����wY��7���Y��6���Y��;���Y��I���*Z��;���tZ��:���Z��H���Z��9���4[��G���n[��2���[��2���[�����\��4���+\�����`\�����w\�����\��2���\�����\�����\�����]�����3]�����L]�����k]�����]�����]��(���]��=���]�����^�����"^��0���2^�����c^�����h^��/���^�����^��*���^��&���^�� ���_��9���)_�����c_�����t_�� ���_�����_��-���_�����_�����`��1���%`��*���W`�����`�����`��0���`��&���`�����`����� a��(���+a�����Ta�����da�����a��%���a��e���a�����*b��4���b�����c�����c��Y���c��;���pc��.���c�����c�����c��+���d��(���?d��4���hd�����d�����d�����d��X���d��J���Ee�����e��%���e�� ���e�����e�����e��+���e����� f�����:f�� ���Zf��8���df��M���f��u���f�����ag�����sg�����g�����g�����g��A���g�� ���h����� h��6���,h��I���ch��A���h�����h��0��� i�����;i��G���Ri��N���i�����i�����i��.���j�����1j��4���Dj�� ���yj��,���j��3���j�� ���j��=���j�����4k��'���Qk��(���yk��,���k��!���k�����k�����l�����,l��=���Gl��+���l��0���l��V���l��V���9m��M���m��R���m��$���1n�����Vn�����\n��N���pn��0���n��)���n�����o�����0o�����No��/���ko�����o�����o�����o��&���o��!���p��&���4p�����[p��E���cp�� ���p��*���p��7���p��"���q��(���<q�����eq�����q�����q��"���q�����q�����q�����q��;���r�����Mr�����Tr��"���[r��!���~r�����r��#���r�����r��D���r��5���s�� ���Ns�����Ys�� ���^s��1���ks��E���s��B���s��G���&t��%���nt�����t��#���t��#���t��,���t�����#u��-���?u��(���mu��D���u�� ���u��#���u��(��� v��#���3v�����Wv�����^v�����gv��(���vv�����v�����v��8���v�� ���v��P���w��"���hw�����w�����w��O���w�����x�����$x�����8x�����Ax��%���Rx�� ���xx�����x��,���x�� ���x��(���x��E���x�� ���>y��*���Ky��1���vy��7���y�����y�� ���y�����z�����z�����0z�����Dz�����Zz�����jz��&���}z�����z�����z��4���z�����z��%��� {�����1{��c���8{�����{�����{�� ���{��'���{��:���{�� ���,|��@���M|�����|�����|�����|��&���|��*���|��&���}��W���?}��>���}��7���}�� ���~�� ���~�� ���&~��,���0~��*���]~��0���~�����~��%���~�����~�������1���-��1���_�������\����������'��� ��%���H��+���n��^�����2�����5���,�����b������������5��������ւ�������+�����-���$�����R��!���n��!����������!���ȃ������������#��� ��*���.�����Y�����b�����u��P��������݄��9�����;���6��)���r��������������������Ѕ��������������������/����G���� �� ����O�������������� ��������*��+���3��P���_��E�����M�����R���D��"����� ����� ���Ď��*���ю����������������� ���$�����0�����D�����[�� ���l��!���z������� ����� �����%���Ï��m�����;���W��������������������ϐ������� �������� ��6��������U�����u��$����������.����� ���’�� ���Β�����ْ��-���ޒ��-��� ��T���:�������)��������̓��d��������O��4���c�������4�������������������� �����8����� ���R��"���\��+����������A���˕����� �������+���,��M���X��0����� ���ז�������6��������.�� ���J�� ���X�����f�����y������� �����0�����0���ڗ��!��� ��P���-��?���~�������#���Ә��������������������!�����=��s���W�����˙��&���ߙ�� �����?�����M���P��F��������������� �����1��� �����?�� ���P�� ���]��>���k��#�����#���Λ��#����� ��������!��.���<�����k�� ����� ���������� ���؜������������Q��������L�����h��/���q�������?��������������������=���&�����d�� ���v�������r�����!����� ���2�����S��s���f��*���ڟ�������A����� ���Y��P���c�� �����z���ՠ��T���P�� ���������� ���á�� ���Ρ��(���ڡ��)��������-�����6�����I��9���Z��-����� ���¢�����̢��g���Ԣ�����<�����D��8���J��������������������������� ���գ�����ߣ�� ���������� ���8�����Y�����x�������/�����7���ߤ�������A�����N���ڥ��?���)��"���i��)�������������Ӧ����������h������������ ����� ����� ��������ʧ�� �����&�����$��������:�����N�����^�����e�� ���x������� �������������������� ���ɨ�����Ө������������J��� �����X�� ���v��S��������ԩ�����۩�� �����)����� ���!��6���.�����e��&���{�� ������������������Ъ�� ���٪�������O�����M���F��"�����*�����&����� ��� ��%���*��O���P��v�����"�����"���:��"���]��$����� �����o���ƭ��^���6��V�����Z�����K���G��0�����!���į��[�����$���B��#���g��%�����I�����'�����!���#��B���E��8����� �����d���ͱ��^���2��z�������� ��������������������:��"���W��0���z������� ����� �����,���˳���������������+��~���1��0��������������� ���������� ��������%�����.��T���7�������F�����7���b��<��������׶���������� ��F��������d�����|�� �����0�����2���·��l�����N���b�������H���Ǹ������� ���)��)���3��p���]�����ι��&�������������"�����3�����C��1���W��5�����%�����)�����%��������5��,���S��`�����{�����F���]��(�����!���ͼ������������=���"�����`�� ���f�����s�������4�����<���ý��A������R���B��A�����@���׾��P�����?���i��O�����7�����8���1�����j��6���~������� ����������9��� �����C��!���a��!����������&��������������������0���,��<���]������� �����0���������������1��� �����?��+���_��&����������/����� �����*�����0���$�����U��.���l������������5�����0��������3�����R��<���Z��$����������&�����'�������������0�����J�� ���f��_����������8���������������n�����>���W��5�����%����������(�����&���8��,���_�����������������c�����Q���B�������"����� ���������������-��������#��%���C�����i��<���q��\�������� �� �������������������������<����� ���!�����+��D���G��Y�����U��������<��$���Y�����~��M�����R��������4�� ���;��2���E�����x��C����������=�����B����� ���`��D���n�������"�����#�����:�����-���M��'���{��$����������E�����8���(��D���a��_�����i�����\���p��d�����$���2�����W�����]��N���q��/�����3��������$��$���>��#���c��;����������"����������*���"��+���M��-���y�������J����������2�����6���A�����x��)����� ���������������"��������:�����@�����[��@���n������������'����� ���������� ��� �����.��I���4��>���~�����������������<�����O���"��P���r��Q�����1�����$���G��0���l��.�����6����������8��� ��3���Y��;����������&�����)�����*���1�����\�����c�� ���l��,���w������������C�����%�����S���*�����~������������Q�������������/�����B�� ���J��-���V�� ����� �����;����� �����&�����H��� �� ���U��/���a��=�����7���������� ��������)�����<�����V�����i�����}�� ����� ���������������*����������#����� ���A��l���K������������ �����0�����F�����&���f��I��������������������/�����(���E��"���n��Y�����B�����;���.�� ���j�� ���t�������%�����/�����.����������&���/�����V�������.�����.����������O���,�����|��+�����(�����.�����g�����8�����5�����$�������������9��8���>�� ���w�������5�����I�����"�����.���A��1���p�������*���������� �����)�����0���:�����k�� ���t�������f����������G�����E���a��1����� �����������������������'�����A�����[�����p��� Generate ReStructuredText using autosummary directives. sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates the reStructuredText files from the autosummary directives contained in the given input files. The format of the autosummary directive is documented in the ``sphinx.ext.autosummary`` Python module and can be read using:: pydoc sphinx.ext.autosummary � Generate required files for a Sphinx project. sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build. � Look recursively in <MODULE_PATH> for Python modules and packages and create one reST file with automodule directives per package in the <OUTPUT_PATH>. The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be excluded from generation. Note: By default this script will not overwrite already created files.� Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� Run 'make' in that directory to run these through makeinfo (use 'make info' here to do that automatically).� (deprecated)� (in �"::" in automodule name doesn't make sense�"latex_documents" config value references unknown document %s�"man_pages" config value references unknown document %s�"quiet" is specified, but any of "project" or "author" is not specified.�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%s %s�%s %s documentation�%s (%s attribute)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command %r cannot be run (needed for math display), check the imgmath_%s setting�%s is already assigned section numbers (nested numbered toctree?)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �-A option argument must be in the form name=value�-D option argument must be in the form name=value�4 column based index found. It might be a bug of extensions you use: %r�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�About these documents�An error happened in rendering the page %s. Reason: %r�Anchor '%s' not found�Any IDs not assigned for %s node�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not fetch remote image: %s [%d]�Could not fetch remote image: %s [%s]�Could not import extension %s�Could not lex literal_block as "%s". Highlighting skipped.�Could not obtain image size. :scale: option is ignored.�Create Makefile? (y/n)�Create Windows command file? (y/n)�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Encoding error:�Enter the root path for documentation.�Error�Error: an existing conf.py has been found in the selected root path.�Error: specified path is not a directory, or sphinx files already exist.�Error: the master file %s has already been found in the selected root path.�Event %r already present�Example�Examples�Exception occurred while building, starting debugger:�Exception occurred:�Expand sidebar�Extension options�External Graphviz file %r not found or reading it failed�Failed to read build info file: %r�Failed to scan documents in %s: %r�Failed to write build info file: %r�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnote [#] is not referenced.�Footnote [%s] is not referenced.�Footnotes�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Hide Search Matches�Hint�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indicate which of the following Sphinx extensions should be enabled:�Indices and tables:�Interrupted!�Invalid caption: %s�Invalid date format. Quote the string by single quote if you want to output it directly: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�Keyword Arguments�LaTeX command %r cannot be run (needed for math display), check the imgmath_latex setting�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Look for any errors in the above output or in %(outdir)s/output.txt�Makefile and Batchfile creation�Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Many math_renderers are registered. But no math_renderer is selected.�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Non-alphabetical�Note�Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.�Notes�Numbers�Object named %r not found in include file %r�Original exception: �Other Parameters�Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Pillow not found - copying image files�Please activate JavaScript to enable the search functionality.�Please also report this if it was a user error, so that a better error message can be provided next time.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter a new file name, or rename the existing file and press Enter�Please enter a new root path (or just Enter to exit)�Please enter a valid path name.�Please enter either 'y' or 'n'.�Please enter one of %s.�Please enter some text.�Please enter values for the following settings (just press Enter to accept a default value, if one is given in brackets).�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project templating�Project version�Pygments lexer name %r is not known�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Recursion error:�References�Release�Return type�Returns�Root path for the documentation�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Searching for multiple words only shows matches that contain all words.�Section %s�Section author: �See also�Separate source and build directories (y/n)�Show Source�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Structure options�Symbols�TODO entry found: %s�Table %s�Table of Contents�Template Parameters�Testing of coverage in the sources finished, look at the results in %(outdir)spython.txt.�Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt.�The %r crossref_type is already registered�The %r directive is already registered to domain %s�The %r index is already registered to domain %s�The %r object_type is already registered�The %r role is already registered to domain %s�The %s extension is required by needs_extensions settings, but it is not loaded.�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.�The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.�The config value `{name}' has type `{current.__name__}'; expected {permitted}.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The dummy builder generates no files.�The ePub file is in %(outdir)s.�The full traceback has been saved in %s, if you want to report the issue to the developers.�The manual pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�The overview file is in %(outdir)s.�The project name will occur in several places in the built documentation.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Translator for %r already exists�Unknown event name: %s�Unknown image format: %s...�Unknown math_renderer %r is given.�Variables�Warning�Warns�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�Would create file %s.�Yields�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[autosummary] generating autosummary for: %s�[autosummary] writing to %s�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.�a list of specific files to rebuild. Ignored if -a is specified�a suitable image for %s builder not found: %s�a suitable image for %s builder not found: %s (%s)�all functions, classes, terms�all of %d po files�all source files�append module_path to sys.path, used when --full is given�assembling single document�attribute�author names�automatically insert docstrings from modules�automatically test code snippets in doctest blocks�autosummary generats .rst files internally. But your source_suffix does not contain .rst. Skipped.�both tabularcolumns and :widths: option are given. :widths: is ignored.�broken link: %s (%s)�build %s, %s warning (with warnings treated as errors).�build %s, %s warning.�build %s.�build environment version not current�build in parallel with N processes where possible (special value "auto" will set N to cpu-count)�build info file is broken: %r�builder to use (default: html)�building [%s]: �building [mo]: �built-in function�can be huge�cannot combine -a option and filenames�cannot copy downloadable file %r: %s�cannot copy extra file %r�cannot copy image file %r: %s�cannot copy static file %r�cannot find files %r�cannot open warning file %r: %s�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�cannot read image file %r: copying it instead�cannot write image file %r: %s�caption not inside a figure.�checking consistency�checks for documentation coverage�circular toctree references detected, ignoring: %s <- %s�class�class method�command line option�concept�conditional inclusion of content based on config values�conf value "epub_author" should not be empty for EPUB3�conf value "epub_contributor" should not be empty for EPUB3�conf value "epub_copyright" (or "copyright")should not be empty for EPUB3�conf value "epub_description" should not be empty for EPUB3�conf value "epub_identifier" should not be empty for EPUB3�conf value "epub_language" (or "language") should not be empty for EPUB3�conf value "epub_publisher" should not be empty for EPUB3�conf value "epub_title" (or "html_title") should not be empty for EPUB3�conf value "epub_uid" should be XML NAME for EPUB3�conf value "version" should not be empty for EPUB3�config changed�config directory doesn't contain a conf.py file (%s)�console output options�continued from previous page�continues on next page�convert exited with error: [stderr] %r [stdout] %r�copying TeX support files�copying TeX support files...�copying Texinfo support files�copying additional files�copying downloadable files... �copying extra files�copying images... �copying source files...�could not read %r for changelog creation�create .nojekyll file to publish the document on GitHub pages�create batchfile�create makefile�custom template directory (default: %(default)s)�data�default role %s not found�default suffix for files (default: %(default)s)�define a template variable�define tag: include "only" blocks with TAG�dimension unit %s is invalid. Ignored.�directive�directive %r is already registered, it will be overridden�directive-option�directory to place all output�directory to place all output in�display latex %r: %s�do emit colored output (default: auto-detect)�do not create batchfile�do not create makefile�do not emit colored output (default: auto-detect)�do not use make-mode for Makefile/make.bat�docnames to write: %s�document�document imported members (default: %(default)s)�document isn't included in any toctree�document language�document not readable. Ignored.�document title is not a single Text node�doing serial %s�domain %s already registered�domain %s not yet registered�don't create a table of contents file�don't create headings for the module/package packages (e.g. when the docstrings already contain them)�don't know which module to import for autodocumenting %r (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)�don't use a saved environment, always read all files�done�dot code %r: %s�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�dot did not produce an output file: [stderr] %r [stdout] %r�dot exited with error: [stderr] %r [stdout] %r�download file not readable: %s�dumping object inventory�duplicate citation %s, other instance in %s�duplicate label %s, other instance in %s�duplicate label of equation %s, other instance in %s�duplicated ToC entry found: %s�enable %s extension�enable arbitrary extensions�encountered some issues with some of the inventories, but they had working alternatives:�encountered title node not in section, topic, table, admonition or sidebar�enum�enumerable_node %r already registered�enumerator�environment variable�environment variable; %s�error while formatting arguments for %s: %s�error writing file %s: %s�error writing file Makefile: %s�exception�exception while evaluating only directive expression: %s�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extension options�extensions changed�failed�failed to import object %s�failed to parse name %s�failed to reach any of the inventories with the following issues:�failed: %s�favicon file %r does not exist�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�filename of table of contents (default: modules)�finished with problems�fnmatch-style file and/or directory patterns to exclude from generation�follow symbolic links. Powerful when combined with collective.recipe.omelette.�function�general options�generate a full project with sphinx-quickstart�generating indices�glossary seems to be misformatted, check indentation�glossary term�glossary term must be preceded by empty line�glossary terms must not be separated by empty lines�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�highlighting module code... �html_extra_path entry %r does not exist�html_static_path entry %r does not exist�if specified, separate source and build dirs�ignoring invalid doctest code: %r�image file %s not readable: %s�image file not readable: %s�include "_private" modules�include links to the source code of documented Python objects�include math, rendered as PNG or SVG images�include math, rendered in the browser by MathJax�inconsistent citation references in translated message. original: {0}, translated: {1}�inconsistent footnote references in translated message. original: {0}, translated: {1}�inconsistent references in translated message. original: {0}, translated: {1}�inconsistent term references in translated message. original: {0}, translated: {1}�increase verbosity (can be repeated)�index�inline latex %r: %s�interpret module paths according to PEP-0420 implicit namespaces specification�intersphinx identifier %r is not string. Ignored�intersphinx inventory has moved: %s -> %s�invalid TestCode type�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�invalid regex %r in %s�invalid regex %r in coverage_c_regexes�invalid signature for auto%s (%r)�job number should be a positive number�keyword�kwargs for add_node() must be a (visit, depart) function tuple: %r=%r�last updated�line number spec is out of range(1-%d): %r�link between Sphinx documentation of different projects�lists all sections and subsections�loading intersphinx inventory from %s...�loading pickled environment�loading translations [%s]... �logo file %r does not exist�looking for now-outdated files... �macro�making output directory�master document name�maximum depth of submodules to show in the TOC (default: 4)�member�method�missing '+' or '-' in '%s' option.�missing attribute %s in object %s�module�module %s could not be imported: %s�modules�more than one target found for 'any' cross-reference %r: could be %s�more than one target found for cross-reference %r: %s�new config�next�next chapter�nit-picky mode, warn about all missing references�no "latex_documents" config value found; no documents will be written�no "man_pages" config value found; no manual pages will be written�no "texinfo_documents" config value found; no documents will be written�no Babel option known for language %r�no changes in version %s.�no code/output in %s block at %s:%s�no output at all, not even warnings�no output on stdout, just warnings on stderr�no targets are out of date.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�none found�not available for built-in messages�numfig is disabled. :numref: is ignored.�numfig_format is not defined for %s�object�operator�original entry�override a setting in configuration file�overwrite existing files�page�page %s matches two patterns in html_sidebars: %r and %r�pass a value into HTML templates�path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)�path to documentation source files�path to module to document�path to output directory�path where configuration file (conf.py) is located (default: same as SOURCEDIR)�pickling environment�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�program option�project author(s), used when --full is given�project name�project name (default: root module name)�project release, used when --full is given, defaults to --doc-version�project root�project version, used when --full is given�put documentation for each module on its own page�put module documentation before submodule documentation�quick access to all modules�quiet mode�reST markup error:�reading error: %s, %s�reading sources... �reading templates... �reference label�release of project�replacement for dot in _templates etc.�resolving references...�role�role %r is already registered, it will be overridden�run Pdb on exception�run the script without creating files�search�search index couldn't be loaded, but not all documents will be built: the index will be incomplete.�search this documentation�see %s�see also %s�self referenced toctree found. Ignored.�setting %s.%s occurs in none of the searched theme configs�show full traceback on exception�signature arguments or return annotation given for automodule %s�skipped�source directory has changed�source file suffix�source files to generate rST files for�source_parser for %r is already registered�source_suffix %r is already registered�sphinx-quickstart only generate into a empty directory. Please specify a new root path.�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�statement�static method�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�targets for %d template files�template directory for template files�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension is not safe for parallel reading�the %s extension is not safe for parallel writing�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�toctree contains ref to nonexisting file %r�toctree contains reference to document %r that doesn't have a title: no link will be generated�toctree contains reference to excluded document %r�toctree contains reference to nonexisting document %r�too large :maxdepth:, ignored.�turn warnings into errors�type�undecodable source characters, replacing with "?": %r�unimplemented node type: %r�union�unknown %r toplevel_sectioning for class %r�unknown config value %r in override, ignoring�unknown index entry type %r�unknown index entry type %s found�unknown mimetype for %s, ignoring�unknown node type: %r�unsupported theme option %r given�updating environment: �use epub�use make-mode for Makefile/make.bat�use no config file at all, only -D options�variable�version of project�waiting for workers...�where "builder" is one of the supported builders, e.g. html, latex or linkcheck.�while setting up extension %s:�write "todo" entries that can be shown or hidden on build�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing�writing %s file...�writing additional files�writing additional pages�writing error: %s, %s�writing message catalogs... �writing output... �writing summary file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: id Language-Team: Indonesian (http://www.transifex.com/sphinx-doc/sphinx-1/language/id/) Plural-Forms: nplurals=1; plural=0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � Hasilkan ReStructuredText menggunakan pengarahan autosummary. sphinx-autogen adalah tampilan depan ke sphinx.ext.autosummary.generate. Ini menghasilkan file reStructuredText dari pengarahan autosummary yang terkandung dalam file input yang diberikan. Format pengarahan autosummary didokumentasikan dalam modul ``sphinx.ext.autosummary`` dan dapat dibaca menggunakan:: pydoc sphinx.ext.autosummary � Hasilkan file yang diperlukan untuk proyek Sphinx. sphinx-quickstart adalah alat interaktif yang menanyakan beberapa pertanyaan tentang proyek Anda dan kemudian menghasilkan direktori dokumentasi lengkap dan contoh Makefile untuk digunakan dengan sphinx-build. � Lihat secara rekursif dalam <MODULE_PATH> untuk modul dan paket Python dan buat satu berkas reST dengan arahan automodule per paket di <OUTPUT_PATH>. <EXCLUDE_PATTERN> dapat berupa pola berkas dan/atau direktori yang akan dikecualikan dari pembuatan. Catatan: Secara bawaan skrip ini tidak akan menimpa berkas yang sudah dibuat.� Jalankan 'make' di direktori tersebut untuk menjalankannya melalui (pdf)latex (gunakan 'make latexpdf' di sini untuk melakukannya secara otomatis).� Jalankan 'make' di direktori tersebut untuk menjalankannya melalui makeinfo (gunakan 'make info' di sini untuk melakukannya secara otomatis).� (obsolet)� (dalam �"::" dalam nama automodule tidak masuk akal�nilai konfigurasi "latex_documents" mereferensikan dokumen yang tidak dikenal %s�"man_pages" nilai konfigurasi mengacu pada dokumen tidak diketahui %s�"quiet" ditentukan, tetapi tidak ada "project" atau "author" yang ditentukan.�nilai konfigurasi "texinfo_documents" mereferensikan dokumen yang tidak dikenal %s�%(filename)s — %(docstitle)s�%d %b, %Y�%d ditemukan�%d berkas sumber diberikan di command line�%s %s�Dokumentasi %s %s�%s (atribut %s)�%s (C++ %s)�%s (class built-in)�%s (variabel built-in)�%s (class di %s)�%s (direktif)�%s (variabel global atau konstan)�%s (di modul %s)�%s (module)�%s (role)�%s ditambahkan, %s diubah, %s dihapus�%s perintah %r tidak dapat dioperasikan (diperlukan untuk tampilan matematika), periksa pengaturan imgmath_%s�%s sudah diberi nomor bagian (penomoran bersarang toctree?)�%s bukan direktori.�%s() (method class %s)�%s() (method %s)�%s() (method static %s)�%s() (fungsi built-in)�%s() (class)�%s() (di modul %s)�© <a href="%(path)s">Hak cipta</a> %(copyright)s.�© Hak cipta %(copyright)s.�'%s' bukan opsi yang valid.�'%s' bukan opsi pyversion yang valid�'setup' yang saat ini didefinisikan pada conf.py bukanlah sebuah Python callable. Silakan modifikasi definisinya untuk membuatnya menjadi fungsi callable. Hal ini diperlukan guna conf.py berjalan sebagai ekstensi Sphinx.�(<<original entry>> terletak di %s, baris %d.)�(di %s v%s)�(dalam %s)�, di�argumen opsi -A harus dalam bentuk name=value�argumen opsi -D harus dalam bentuk name=value�4 kolom berdasarkan indeks ditemukan. Ini mungkin bug ekstensi yang Anda gunakan: %r�<<original entry>>�<h1>Semua modul dimana kode tersedia</h1>�<h1>Kode sumber untuk %s</h1>�Laporan bug dapat diisi pada tracker di <https://github.com/sphinx-doc/sphinx/issues>. Terima kasih!�Tentang dokumen ini�Kesalahan terjadi saat render halaman %s. Alasan: %r�Anchor '%s' tidak ditemukan�Tidak ada ID apa pun yang ditugaskan untuk simpul %s�Argumen�Pehatian�Nama(-nama) pembuat�Penyusun: �Daftar perubahan dibuat otomatis untuk versi %(version)s�Basis: %s�Builder %r sudah ada (di modul %s)�Class Builder %s tidak punya atribut "name"�Nama Builder %s tidak terdaftar�Nama Builder %s todal terdaftar atau tersedia melalui entry point�Modul Internal�Perubahan API C�Tidak dapat menemukan direktori sumber (%s)�Tidak dapat menggunakan "lineno-match" dengan rangkaian "baris" yang terpisah�Tidak dapat menggunakan kedua opsi "%s" dan "%s"�Hati-hati�Berubah pada versi %s�Perubahan pada Versi %(version)s — %(docstitle)s�Kutipan [%s] tidak dirujuk.�Penulis kode:�Tutup sidebar�Daftar Isi Lengkap�Nilai konfigurasi %r sudah ada�Konten�Hak Cipta�Tidak dapat mengambil gambar jarak jauh: %s [%d]�Tidak dapat mengambil gambar jarak jauh: %s [%s]�Tidak dapat mengimpor ekstensi %s�Tidak dapat menjalankan lex literal_block sebagai "%s". Menyoroti yang terlewat.�Tidak dapat memperoleh ukuran gambar. :scale: option diabaikan.�Buat Makefile? (y/n)�Buat berkas perintah Windows? (y/n)�Membuat file %s.�Bahaya�Akan ditinggalkan�Ditinggalkan sejak versi %s�Domain %r tidak terdaftar�Pengkodean %r yang digunakan untuk membaca file yang disertakan %r tampaknya salah, mencoba berikan opsi :encoding:�Kesalahan encoding:�Masukkan jalur root untuk dokumentasi.�Kesalahan�Galat: berkas conf.py telah ditemukan dalam root path terpilih.�Kesalahan: jalur yang ditentukan bukan direktori, atau file sphinx sudah ada.�Kesalahan: file master %s telah ditemukan di jalur utama yang dipilih.�Event %r sudah ada�Contoh�Contoh-contoh�Eksepsi terjadi saat membangun, memulai debugger:�Terjadi eksepsi:�Buka sidebar�Opsi ekstensi�Berkas Graphviz eksternal %r tidak ditemukan atau gagal dibaca�Gagal membaca berkas info build: %r�Gagal memindai dokumen dalam %s: %r�Gagal menulis berkas info build: %r�Gambar. %s�File %s sudah ada, lewati.�Selesai: Struktur direktori awal telah dibuat.�Catatan kaki [#] tidak dirujuk.�Catatan kaki [%s] tidak dirujuk.�Catatan kaki�Index penuh dalam satu halaman�Indeks Umum�Index Modul Global�Go�Pengarahan Graphviz tidak dapat memiliki konten dan argumen nama berkas sekaligus�Sembunyikan Hasil Pencarian�Petunjuk�Mengabaikan pengarahan "graphviz" tanpa konten.�Penting�Berkas yang disertakan %r tidak ditemukan atau gagal membacanya�Indeks�Index – %(key)s�Index halaman berdasarkan huruf�Tunjukkan ekstensi Sphinx berikut mana yang harus diaktifkan:�Indeks dan tabel:�Diinterupsi�Keterangan tidak valid: %s�Format tanggal tidak valid. Kutip string dengan kutipan tunggal jika Anda ingin menampilkannya secara langsung: %s�Math_eqref_format tidak valid: %r�Variabel templat tidak valid: %s�Argumen Kata Kunci�Perintah LaTeX %r tidak dapat dioperasikan (diperlukan untuk tampilan matematika), periksa pengaturan imgmath_latex�Terakhir diperbarui pada %(last_updated)s.�Perubahan library�Spesifikasi baris %r: tidak ada baris yang ditarik dari berkas %r�Daftar %s�Mencari kesalahan sembarang dalam keluaran di atas atau di %(outdir)s/output.txt�Pembuatan Makefile dan Batchfile�Deskripsi opsi salah bentuk %r, seharusnya terlihat seperti "opt", "-opt args", "--opt args", "/opt args" atau "+opt args"�Banyak math_renderers teregistrasi. Namun tidak satu pun math_renderer yang dipilih.�Indeks Modul�Penyusun modul: �Kode modul�Level Modul�Nama dokumen master Anda (tanpa akhiran)�Nama prefiks untuk dir templat dan static�Navigasi�Baru pada versi %s�Topik berikutnya�Tidak ada builder yang dipilih, menggunakan default: html�Tidak terdapat nilai konfigurasi demikian: %s�Non-abjad�Catatan�Catatan: imgmath dan mathjax tidak dapat diaktifkan secara bersamaan. imgmath telah diubah tidak pilih.�Catatan�Angka�Objek bernama %r tidak ditemukan disertakan di berkas %r�Eksepsi orisinal: �Parameter lainnya�Perubahan lain�Tinjauan�Tinjauan: kode modul�Parameter�Link permanen untuk kode ini�Link permanen untuk definisi ini�Tautan untuk persamaan ini�Link permanen untuk headline ini�Link permanen untuk gambar ini�Link permanen untuk table ini�Tautan ke daftar isi ini�Pillow tidak ditemukan - menyalin berkas gambar�Tolong aktifkan JavaScript untuk melakukan pencarian. �Mohon juga melaporkan hal ini jika sebuah kesalahan pengguna sehingga lain kali perintah salah yang lebih baik dapat disediakan.�Mohon masukkan satu suffiks berkas, contohnya '.rst' atau '.txt'.�Silakan masukkan nama file baru, atau ganti nama file yang ada dan tekan Enter�Silakan masukkan root path baru (atau tekan Enter untuk keluar)�Mohon masukkan nama path yang sah.�Mohon ketik salah satu dari 'y' atau 'n'.�Mohon masukkan satu dari %s.�Mohon masukan teks.�Silakan masukkan nilai untuk pengaturan berikut (cukup tekan Enter to menerima nilai bawaan, jika diberikan dalam tanda kurung).�Penyiapkan pencarian...�Topik sebelumnya�Opsi dasar proyek�Bahasa proyek�Nama proyek�Rilis proyek�Membuat templat proyek�Versi proyek�Nama Pygments lexer %r tidak diketahui�Python Enhancement Proposals; PEP %s�Indeks Modul Python�Pencarian cepat�Raises�Kesalahan rekursi:�Referensi�Rilis�Return type�Kembali�Root path dokumentasi�Menjalankan Sphinx v%s�Pencarian�Pencarian %(docstitle)s�Pencarian Halaman�Hasil Pencarian�Pencarian selesai, menemukan %s halaman yang cocok dengan kueri pencarian.�Pencarian dalam %(docstitle)s�Pencarian�Mencari beberapa kata hanya menunjukkan kecocokan yang mengandung    semua kata.�Bab %s�Penyusun bagian:�Lihat juga�Pisahkan direktori source dan build (y/n)�Lihat Sumber�Direktori sumber dan direktori tujuan tidak boleh sama�Akhiran berkas sumber�Parser sumber untuk %s tidak terdaftar�Opsi struktur�Simbol�Entri TODO ditemukan: %s�Tabel %s�Daftar Isi�Parameter Templat�Pengujian cakupan di sumber selesai, lihat hasilnya dalam %(outdir)spython.txt.�Pengujian dokumen di sumber selesai, lihat hasil dalam %(outdir)s/output.txt.�crossref_type %r telah didaftarkan�Pengarahan %r sudah terdaftar di domain %s�Indeks %r sudah terdaftar ke domain %s�object_type %r telah didaftarkan�Peran %r sudah terdaftar di domain %s�Ekstensi %s diperlukan oleh pengaturan needs_extensions, tapi itu tidak dimuat.�Ekstensi %s yang digunakan proyek ini memerlukan sedikitnya Sphinx v%s; maka itu tidak bisa dibangun dengan versi ini.�Halaman HTML berada di %(outdir)s.�Halaman HTML berada di %(outdir)s.�Berkas LaTeX berada di %(outdir)s.�Berkas Texinfo berada di %(outdir)s.�Berkas XML berada di %(outdir)s.�Nilai konfigurasi `source_suffix 'mengharapkan sebuah string, daftar string, atau kamus. Tetapi `%r' diberikan.�Nilai konfigurasi `{name}` bertipe `{current.__name__}', default menjadi `{default.__name__}'.�Nilai konfigurasi `{name}' memiliki tipe `{current.__name__}'; diharapkan {permitted}.�Nilai konfigurasi `{name}` harus salah satu dari {candidates}, tapi `{current}` diberikan.�Berkas konfigurasi (atau salah satu dari modul terimpor) disebut sys.exit()�Builder contoh tidak menghasilkan berkas apapun.�Berkas ePub berada di %(outdir)s.�Traceback lengkap telah disimpan di %s, bila ingin melaporkan masalah ini kepada developer.�Halaman manual berada di %(outdir)s.�Katalog pesan berada di %(outdir)s.�Berkas tinjauan berada di %(outdir)s.�Nama proyek akan muncul di beberapa tempat dalam dokumentasi yang dibuat.�Berkas pseudo-XML berada di %(outdir)s.�Berkas teks berada di %(outdir)s.�Terdapat kesalahan programmable dalam berkas konfigurasi anda: %s�Ada kesalahan sintaksis dalam file konfigurasi Anda: %s �Halaman Ini�Lingkungan ini tidak kompatibel dengan pembangun yang dipilih, silakan pilih direktori doctree lain.�Proyek ini memerlukan sedikitnya Sphinx v%s dan maka itu tidak bisa dibangun dengan versi ini.�Proyek ini memerlukan ekstensi %s sedikitnya pada versi %s dan maka itu tidak bisa dibangun dengan versi yang dimuat (%s).�Throws�Tip�Todo�Penerjemah untuk %r sudah ada�Nama event tidak dikenal: %s�Format gambar tidak dikenal: %s...�math_renderer %r yang tidak diketahui diberikan.�Variabel�Peringatan�Peringatkan�Selamat datang ke alat quickstart Sphinx %s.�Selamat Datang! Ini adalah�Akan membuat berkas %s.�Hasil�Tidak ada dokumen yang cocok dengan pencarian anda. Pastikan semua kata ditulis dengan benar dan sudah memilih cukup kategori.�[autosummary] menghasilkan autosummary untuk: %s�[autosummary] menulis ke %s�[docs]�[graph: %s]�[graph]�[gambar: %s]�[gambar]�[sumber]�__all__ harus berupa daftar string, bukan %r (dalam modul %s) -- mengabaikan __all__�kesalahan Unicode terjadi saat render halaman %s. Silakan pastikan semua nilai konfigurasi yang berisi konten non-ASCII adalah string Unicode.�daftar berkas spesifik yang dibuat ulang. Diabaikan jika -a ditentukan�gambar yang sesuai untuk builder %s tidak ditemukan: %s�gambar yang sesuai untuk builder %s tidak ditemukan: %s (%s)�semua fungsi, class, term�semua dari %d berkas po�semua berkas sumber�menambahkan module_path ke sys.path, digunakan ketika --full diberikan�merakit dokumen tunggal�atribut�nama penulis�masukkan docstrings secara otomatis dari modules�uji snippet kode secara otomatis pada blok doctest�autosummary menghasilkan file .rst secara internal. Tapi source_suffix Anda tidak mengandung .rst. Dilewati.�opsi tabularcolumns dan :widths: opsi diberikan bersamaan. :widths: diabaikan.�tautan rusak: %s (%s)�bangun %s, %s peringatan (dengan peringatan dianggap sebagai kesalahan).�build %s, %s peringatan.�build %s.�membangun lingkungan bukan versi saat ini�build secara parallel dengan N processes jika memungkinkan (nilai spesial "auto" akan menetapkan N ke cpu-count)�berkas info build rusak: %r�builder yang digunakan (default: html)�membangun [%s]: �membangun [mo]: �fungsi built-in�dapat menjadi besar�tidak dapat menggabungkan opsi -a dan nama berkas�tidak dapat menyalin berkas yang dapat diunduh %r: %s�tidak dapat menyalin berkas ekstra %r�tidak dapat menyalin berkas gambar %r: %s�tidak dapat menyalin berkas statik %r�tidak dapat mencari berkas %r�tidak dapat membuka berkas peringatan %r: %s�tidak dapat menulis ulang pengaturan konfigurasi %r dengan tipe yang tidak didukung, mengabaikan�tidak dapat menulis ulang pengaturan direktori konfigurasi %r, mengabaikan (gunakan %r untuk mengatur elemen-elemen satuan)�tidak dapat membaca berkas gambar %r: menyalin gambar sebagai gantinya�tidak dapat menulis berkas gambar %r: %s�keterangan tidak di dalam gambar.�memeriksa konsistensi�periksa coverage dokumentasi�referensi toctree melingkar terdeteksi, mengabaikan: %s <- %s�class�method class�opsi baris perintah�konsep�inklusi bersyarat untuk isi berdasarkan nilai konfig�nilai conf "epub_author" tidak seharusnya kosong untuk EPUB3�nilai conf "epub_contributor" tidak seharusnya kosong untuk EPUB3�nilai conf "epub_copyright" (atau "copyright") tidak seharusnya kosong untuk EPUB3�nilai conf "epub_description" tidak seharusnya kosong untuk EPUB3�nilai conf "epub_identifier" tidak seharusnya kosong untuk EPUB3�nilai conf "epub_language" (atau "language") tidak seharsunya kosong untuk EPUB3�nilai conf "epub_publisher" tidak seharusnya kosong untuk EPUB3�nilai conf "epub_title" (atau "html_title") tidak seharusnya kosong untuk EPUB3�nilai conf "epub_uid" harus berupa XML NAME untuk EPUB3�bilai conf "version" tidak seharusnya kosong untuk EPUB3�konfigurasi berubah�direktori konfigurasi tidak berisi berkas conf.py (%s)�opsi output konsol�lanjutan dari halaman sebelumnya�berlanjut ke halaman berikutnya�convert keluar dengan kesalahan: [stderr] %r [stdout] %r�menyalin berkas pendukung TeX�menyalin berkas pendukung TeX... �menyalin berkas pendukung Texinfo�menyalin berkas tambahan�menyalin berkas yang dapat diunduh... �menyalin berkas tambahan�menyalin gambar... �menyalin berkas sumber...�tidak dapat membaca %r untuk pembuatan changelog�buat berkas .nojekyll untuk menerbitkannya di halaman GitHub�buat batchfile�buat makefile�direktori templat ubahsuai (bawaan: %(default)s)�data�peran bawaan %s tidak ditemukan�akhiran bawaan untuk berkas (bawaan: %(default)s)�mendefinisikan variabel templat�define tag: masukkan blok "only" dengan TAG�unit dimensi %s tidak valid. Diabaikan�direktif�pengarahan %r sudah terdaftar, itu akan diganti�opsi-direktif�direktori untuk menempatkan semua keluaran�direktori untuk menempatkan semua keluaran dalam�tampilkan latex %r: %s�siarkan output berwarna (default: auto-detect)�jangan membuat batchfile�jangan membuat makefile�jangan siarkan output berwarna (default: auto-detect)�jangan gunakan make-mode untuk Makefile/make.bat�docnames yang akan ditulis: %s�dokumen�mendokumentasikan anggota yang diimpor (bawaan: %(default)s)�dokumen tidak termasuk dalam toctree�bahasa dokumen�dokumen tidak dapat dibaca. Diabaikan.�judul dokumen bukan simpul Text tunggal�mengerjakan serial %s�domain %s telah terdaftar�domain %s belum didaftarkan�jangan membuat berkas daftar isi�jangan membuat judul untuk paket modul/paket (mis. ketika docstrings sudah berisi hal tersebut)�tidak tahu modul mana yang akan diimpor untuk autodocumenting %r (coba letakkan pengarahan "module" atau "currentmodule" dalam dokumen, atau berikan nama modul yang eksplisit)�jangan pakai saved environment, selalu baca semua berkas�selesai�kode dot %r: %s�perintah dot %r tidak dapat dioperasikan (diperlukan untuk keluaran graphviz), periksa pengaturan graphviz_dot�dot tidak menghasilkan berkas output: [stderr] %r [stdout] %r�dot keluar dengan kesalahan: [stderr] %r [stdout] %r�berkas unduhan tidak dapat dibaca: %s�menyisihkan persediaan obyek�kutipan rangkap %s, contoh lain dalam %s�label rangkap %s, contoh lain dalam %s�duplikasi label persamaan %s, misalnya di %s�entri ToC ganda ditemukan: %s�aktifkan ekstensi %s�aktifkan ekstensi berubah-ubah�mengalami beberapa masalah dengan beberapa inventaris, tetapi mereka memiliki alternatif berfungsi:�simpul judul tidak ditemui dalam bagian, topik, tabel, peringatan atau sisi bilah�enum�enumerable_node %r telah terdaftar�enumerator�variabel environment�variabel environment; %s�kesalahan saat memformat argumen untuk %s: %s�kesalahan menulis berkas %s: %s�kesalahan menulis berkas Makefile: %s�eksepsi�pengecualian saat mengevaluasi hanya ekspresi pengarahan: %s�ekstensi %r tidak memiliki fungsi setup(); apa itu benar-benar sebuah modul ekstensi Sphinx?�ekstensi %r mengembalikan objek yang tidak didukung dari fungsi setup() nya; seharusnya mengembalikan None atau dictionary metadata�opsi ekstensi�ekstensi berubah�gagal�gagal mengimpor objek %s�gagal mengurai nama %s�gagal mencapai salah satu inventaris dengan masalah berikut:�gagal: %s�berkas favicon %r tidak ada�berkas %r yang diberikan di command line tidak tersedia, mengabaikan�berkas %r yang diberikan di command line tidak berada dalam direktori sumber, mengabaikan�berkas %r pada path tema merupakan berkas zip yang tidak valid atau tidak berisi tema�akhiran berkas (bawaan: rst)�nama file daftar isi (bawaan: modul)�selesai with masalah�Berkas gaya-fnmatch dan/atau pola direktori untuk dikecualikan dari pembuatan�ikuti tautan simbolik. Berdaya bila digabungkan dengan collective.recipe.omelette.�fungsi�opsi umum�menghasilkan proyek penuh dengan sphinx-quickstart�menghasilkan indeks�Daftar istilah kata sulit tampaknya salah format, periksa indentasi�daftar istilah�Daftar Istilah kata sulit harus didahului dengan baris kosong�Daftar istilah kata sulit tidak boleh dipisahkan oleh garis kosong�token grammar�graphviz_output_format harus salah satu dari 'png', 'svg', tetapi %r�menyoroti kode modul...�entri html_extra_path %r tidak ada�entri html_static_path %r tidak ada�jika ditentukan, pisahkan direktori sumber dan pembangunan�mengabaikan kode dokumen yang tidak valid: %r�berkas gambar %s tidak dapat dibaca: %s�berkas gambar tidak dapat dibaca: %s�termasuk modul "_private"�masukkan tautan ke sumber kode untuk objek Python yang terdokumentasi�masukkan math, yang dirender sebagai gambar PNG atau SVG�masukkan math, yang dirender di perambah sebagai gambar PNG atau SVG�referensi kutipan tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}�referensi catatan kaki yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}�referensi yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}�referensi istilah yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}�tingkatkan verbosity (dapat diulang)�index�inline latex %r: %s�menafsirkan jalur modul sesuai dengan spesifikasi namespaces implisit PEP-0420�pengenal intersphinx %r bukan string. Diabaikan�pengimpanan intersphinx telah dipindahkan: %s -> %s�tipe TestCode tidak valid�css_file yang salah: %r, mengabaikan�js_file yang salah: %r, mengabaikan�nomor %r yang salah untuk konfigurasi nilai %r, mengabaikan�numfig_format tidak valid: %s�numfig_format tidak valid: %s (%r)�regex tidak valid %r dalam %s�%r regex tidak valid di coverage_c_regexes�tanda tangan tidak valid untuk outo %s (%r)�job number seharusnya sebuah bilangan positif�keyword�kwargs untuk add_node() harus berupa (visit, depart) function tuple: %r=%r�terakhir diperbarui�spesifikasi nomor baris di luar kisaran (1-%d): %r�tautkan antara dokumentasi Sphinx dari berbagai proyek�daftar semua seksi dan subseksi�memuat penyimpanan intersphinx dari %s...�memuat lingkungan yang diawetkan�memuat terjemahan [%s]... �berkas logo %r tidak ada�mencari berkas yang kini-usang... �macro�membuat direktori keluaran�nama dokumen utama�kedalaman maksimum submodul untuk ditampilkan di TOC (bawaan: 4)�anggota�method�tidak ada '+' atau '-' dalam opsi '%s'.�atribut hilang %s dalam objek %s�modul�modul %s tidak dapat diimpor: %s�modul�lebih dari satu target ditemukan untuk referensi silang 'any' %r: bisa %s�lebih dari satu target ditemukan untuk referensi silang %r: %s�konfigurasi baru�berikut�bab berikutnya�mode nit-picky, ingatkan tentang semua referensi yang hilang�tidak ditemukan nilai konfigurasi "latex_documents"; dokumen tidak akan ditulis�tidak ditemukan nilai konfigurasi "man_pages"; halaman manual tidak akan ditulis�tidak ditemukan nilai konfigurasi "texinfo_documents"; dokumen tidak akan ditulis�tidak ada opsi Babel yang dikenal untuk bahasa %r�tidak ada pengubahan dalam versi %s.�tidak ada kode/keluaran dalam blok %s pada %s:%s�tanpa output sama sekali, peringatan sekalipun�tanpa output pada stdout, hanya peringatan pada stderr�tidak ada target yang usang.�tema bernama %r tidak ditemukan (kehilangan theme.conf?)�tema berjudul %r tidak ditemukan, inherited oleh %r�kelas simpul %r sudah terdaftar, pengunjungnya akan diganti�tidak ditemukan apapun�tidak tersedia untuk built-in messages�numfig dinonaktifkan. :numref: diabaikan.�numfig_format tidak didefinisikan untuk %s�object�operator�entri asli�override sebuah aturan di berkas konfigurasi�menimpa file yang ada�laman�halaman %s sebanding dengan dua pola dalam html_sidebars: %r dan %r�masukkan sebuah nilai ke templat HTML�path untuk the cached environment dan berkas doctree (default: OUTPUTDIR/.doctrees)�path ke berkas sumber�jalur ke modul ke dokumen�path ke direktori output�path tempat berkas konfigurasi (conf.py) berada (default: sama seperti SOURCEDIR)�lingkungan pengawetan�menyiapkan dokumen�sebelum�bab sebelum�primary_domain %r tidak ditemukan, diabaikan.�memroses %s�opsi program�penulis-(penulis) proyek, digunakan ketika --full diberikan�nama proyek�nama proyek (bawaan: nama modul utama)�rilis proyek, digunakan ketika --full diberikan, bawaan ke --doc-version�root proyek�versi proyek, digunakan ketika --full diberikan�letakkan dokumentasi untuk setiap modul di halamannya sendiri�letakkan dokumentasi modul sebelum dokumentasi submodul�akses cepat semua modul�mode diam�markup reST salah:�kesalahan membaca: %s, %s�membaca sumber... �membaca templat... �label referensi�rilis proyek�pengganti dot di _templates dll.�memecahkan referensi...�role�peran %r sudah terdaftar, itu akan diganti�jalankan Pdb pada eksepsi�operasikan skrip tanpa membuat file�pencarian�indeks pencarian tidak dapat dimuat, tapi tidak semua dokumen akan dibangun: indeks akan jadi tidak lengkap.�pencarian pada dokumentasi ini�lihat %s�lihat juga %s�totree referensikan sendiri ditemukan. Diabaikan�pengaturan %s.%s terjadi pada tak satupun konfigurasi tema yang dicari�tampilkan traceback penuh pada eksepsi�argumen tanda tangan atau anotasi kembalian diberikan untuk automodule %s�dilewati�direktori sumber telah berubah�akhiran berkas sumber�berkas sumber untuk menghasilkan file rST untuk�source_parser untuk %r telah didaftarkan�source_suffix %r telah didaftarkan�sphinx-quickstart hanya menghasilkan direktori kosong. Silakan tentukan jalur utama baru.�sphinx-quickstart tidak akan menulis ulang proyek Sphinx yang ada.�sphinx-quickstart tidak akan menimpa berkas yang sudah ada.�statement�method static�berhasil�target untuk %d berkas po telah usang�target untuk %d berkas po yang telah ditetapkan�target untuk %d berkas sumber yang telah usang�target untuk %d berkas templat�direktori templat untuk berkas templat�ekstensi %s tidak akan dinyatakan jika itu aman untuk pembacaan paralel, dengan anggapan itu tidak aman - silakan tanya pembuat ekstensi untuk memeriksa dan membuatnya eksplisit� ekstensi %s tidak akan dinyatakan jika itu aman untuk penulisan paralel, dengan anggapan itu tidak aman - silakan tanya pembuat ekstensi untuk memeriksa dan membuatnya eksplisit�ekstensi %s tidak aman untuk pembacaan paralel�ekstensi %s tidak aman untuk penulisan paralel�dokumentasi untuk�ekstensi %r telah digabungkan dengan Sphinx sejak versi %s; ekstensi diabaikan.�tautan tidak memiliki teks: %s�tema %r tidak memiliki pengaturan "inherit"�tema %r tidak memiliki pengaturan "tema"�toctree berisi ref ke berkas yang tidak ada %r�toctree berisi referensi ke dokumen %r yang tidak memiliki judul: tidak ada tautan yang akan dihasilkan�toctree berisi referensi ke dokumen yang dikecualikan %r�toctree berisi referensi ke dokumen yang tidak ada %r�:maxdepth: terlalu besar, diabaikan.�ubah peringatan menjadi galat�tipe�karakter sumber undecodable, menggantinya dengan "?": %r�tipe simpul tidak diterapkan: %r�union�%r toplevel_sectioning tidak diketahui untuk kelas %r�nilai konfigurasi %r yang tidak dikenal pada penulisan ulang, mengabaikan�tipe entri indeks tidak dikenal %r�entri indeks tidak diketahui ditemukan tipe %s�mimetype yang tidak dikenal untuk %s, mengabaikan�tipe simpul tidak dikenal: %r�opsi tema yang tidak didukung %r diberikan�memperbarui lingkungan:�gunakan epub�gunakan mode-make untuk Makefile/make.bat�jalankan tanpa berkas sama sekali, hanya opsi -D�variabel�versi proyek�menunggu workers...�di mana "pembangun" adalah salah satu pembangun yang didukung, mis. html, lateks, atau periksa tautan.�saat menyiapkan ekstensi %s:�tulis entri "todo" yang dapat ditampilan atau disembunyikan dalam build�tulis semua berkas (default: hanya tulis berkas yang baru dan diubah)�tulis peringatan (dan galat) pada berkas terpilih�penulisan�menulis %s berkas...�menulis file tambahan�menulis halaman tambahan�kesalahan menulis: %s, %s�menulis katalog pesan... �menulis keluaran... �menulis berkas ringkasan...�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/id/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000324166�00000000000�021151� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Arif Budiman <arifpedia@gmail.com>, 2016-2017 # FIRST AUTHOR <EMAIL@ADDRESS>, 2009 # oon arfiandwi <oon.arfiandwi@gmail.com>, 2019-2020 # Sakti Dwi Cahyono <54krpl@gmail.com>, 2013,2015 # Tumpal Gemelli, 2018 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Indonesian (http://www.transifex.com/sphinx-doc/sphinx-1/language/id/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: id\n" "Plural-Forms: nplurals=1; plural=0;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Tidak dapat menemukan direktori sumber (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Direktori sumber dan direktori tujuan tidak boleh sama" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Menjalankan Sphinx v%s" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Proyek ini memerlukan sedikitnya Sphinx v%s dan maka itu tidak bisa dibangun dengan versi ini." #: sphinx/application.py:243 msgid "making output directory" msgstr "membuat direktori keluaran" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "saat menyiapkan ekstensi %s:" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' yang saat ini didefinisikan pada conf.py bukanlah sebuah Python callable. Silakan modifikasi definisinya untuk membuatnya menjadi fungsi callable. Hal ini diperlukan guna conf.py berjalan sebagai ekstensi Sphinx." #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "memuat terjemahan [%s]... " #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "selesai" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "tidak tersedia untuk built-in messages" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "memuat lingkungan yang diawetkan" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "gagal: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "Tidak ada builder yang dipilih, menggunakan default: html" #: sphinx/application.py:348 msgid "succeeded" msgstr "berhasil" #: sphinx/application.py:349 msgid "finished with problems" msgstr "selesai with masalah" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "bangun %s, %s peringatan (dengan peringatan dianggap sebagai kesalahan)." #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "build %s, %s peringatan." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "build %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "kelas simpul %r sudah terdaftar, pengunjungnya akan diganti" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "pengarahan %r sudah terdaftar, itu akan diganti" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "peran %r sudah terdaftar, itu akan diganti" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "ekstensi %s tidak akan dinyatakan jika itu aman untuk pembacaan paralel, dengan anggapan itu tidak aman - silakan tanya pembuat ekstensi untuk memeriksa dan membuatnya eksplisit" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "ekstensi %s tidak aman untuk pembacaan paralel" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr " \nekstensi %s tidak akan dinyatakan jika itu aman untuk penulisan paralel, dengan anggapan itu tidak aman - silakan tanya pembuat ekstensi untuk memeriksa dan membuatnya eksplisit" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "ekstensi %s tidak aman untuk penulisan paralel" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "mengerjakan serial %s" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "direktori konfigurasi tidak berisi berkas conf.py (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "tidak dapat menulis ulang pengaturan direktori konfigurasi %r, mengabaikan (gunakan %r untuk mengatur elemen-elemen satuan)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "nomor %r yang salah untuk konfigurasi nilai %r, mengabaikan" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "tidak dapat menulis ulang pengaturan konfigurasi %r dengan tipe yang tidak didukung, mengabaikan" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "nilai konfigurasi %r yang tidak dikenal pada penulisan ulang, mengabaikan" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "Tidak terdapat nilai konfigurasi demikian: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "Nilai konfigurasi %r sudah ada" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Ada kesalahan sintaksis dalam file konfigurasi Anda: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Berkas konfigurasi (atau salah satu dari modul terimpor) disebut sys.exit()" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "Terdapat kesalahan programmable dalam berkas konfigurasi anda:\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "Nilai konfigurasi `source_suffix 'mengharapkan sebuah string, daftar string, atau kamus. Tetapi `%r' diberikan." #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Bab %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Gambar. %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tabel %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Daftar %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "Nilai konfigurasi `{name}` harus salah satu dari {candidates}, tapi `{current}` diberikan." #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "Nilai konfigurasi `{name}' memiliki tipe `{current.__name__}'; diharapkan {permitted}." #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "Nilai konfigurasi `{name}` bertipe `{current.__name__}', default menjadi `{default.__name__}'." #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r tidak ditemukan, diabaikan." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "Event %r sudah ada" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Nama event tidak dikenal: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "Ekstensi %s diperlukan oleh pengaturan needs_extensions, tapi itu tidak dimuat." #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "Proyek ini memerlukan ekstensi %s sedikitnya pada versi %s dan maka itu tidak bisa dibangun dengan versi yang dimuat (%s)." #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "Nama Pygments lexer %r tidak diketahui" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "Tidak dapat menjalankan lex literal_block sebagai \"%s\". Menyoroti yang terlewat." #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "dokumen tidak dapat dibaca. Diabaikan." #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "Class Builder %s tidak punya atribut \"name\"" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Builder %r sudah ada (di modul %s)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Nama Builder %s todal terdaftar atau tersedia melalui entry point" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "Nama Builder %s tidak terdaftar" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "domain %s telah terdaftar" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "domain %s belum didaftarkan" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "Pengarahan %r sudah terdaftar di domain %s" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "Peran %r sudah terdaftar di domain %s" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "Indeks %r sudah terdaftar ke domain %s" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "object_type %r telah didaftarkan" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "crossref_type %r telah didaftarkan" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "source_suffix %r telah didaftarkan" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "source_parser untuk %r telah didaftarkan" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "Parser sumber untuk %s tidak terdaftar" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "Penerjemah untuk %r sudah ada" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "kwargs untuk add_node() harus berupa (visit, depart) function tuple: %r=%r" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "enumerable_node %r telah terdaftar" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "ekstensi %r telah digabungkan dengan Sphinx sejak versi %s; ekstensi diabaikan." #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "Eksepsi orisinal:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "Tidak dapat mengimpor ekstensi %s" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "ekstensi %r tidak memiliki fungsi setup(); apa itu benar-benar sebuah modul ekstensi Sphinx?" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "Ekstensi %s yang digunakan proyek ini memerlukan sedikitnya Sphinx v%s; maka itu tidak bisa dibangun dengan versi ini." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "ekstensi %r mengembalikan objek yang tidak didukung dari fungsi setup() nya; seharusnya mengembalikan None atau dictionary metadata" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "tema %r tidak memiliki pengaturan \"tema\"" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "tema %r tidak memiliki pengaturan \"inherit\"" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "tema berjudul %r tidak ditemukan, inherited oleh %r" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "pengaturan %s.%s terjadi pada tak satupun konfigurasi tema yang dicari" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "opsi tema yang tidak didukung %r diberikan" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "berkas %r pada path tema merupakan berkas zip yang tidak valid atau tidak berisi tema" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "tema bernama %r tidak ditemukan (kehilangan theme.conf?)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "gambar yang sesuai untuk builder %s tidak ditemukan: %s (%s)" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "gambar yang sesuai untuk builder %s tidak ditemukan: %s" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "membangun [mo]: " #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "menulis keluaran... " #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "semua dari %d berkas po" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "target untuk %d berkas po yang telah ditetapkan" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "target untuk %d berkas po telah usang" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "semua berkas sumber" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "berkas %r yang diberikan di command line tidak berada dalam direktori sumber, mengabaikan" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "berkas %r yang diberikan di command line tidak tersedia, mengabaikan" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "%d berkas sumber diberikan di command line" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "target untuk %d berkas sumber yang telah usang" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "membangun [%s]: " #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "mencari berkas yang kini-usang... " #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "%d ditemukan" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "tidak ditemukan apapun" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "lingkungan pengawetan" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "memeriksa konsistensi" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "tidak ada target yang usang." #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "memperbarui lingkungan:" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "%s ditambahkan, %s diubah, %s dihapus" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "membaca sumber... " #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "menunggu workers..." #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "docnames yang akan ditulis: %s" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "menyiapkan dokumen" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "entri ToC ganda ditemukan: %s" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "menyalin gambar... " #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "tidak dapat membaca berkas gambar %r: menyalin gambar sebagai gantinya" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "tidak dapat menyalin berkas gambar %r: %s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "tidak dapat menulis berkas gambar %r: %s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "Pillow tidak ditemukan - menyalin berkas gambar" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "mimetype yang tidak dikenal untuk %s, mengabaikan" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "menulis %s berkas..." #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "Berkas tinjauan berada di %(outdir)s." #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "tidak ada pengubahan dalam versi %s." #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "menulis berkas ringkasan..." #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Modul Internal" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Level Modul" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "menyalin berkas sumber..." #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "tidak dapat membaca %r untuk pembuatan changelog" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "Builder contoh tidak menghasilkan berkas apapun." #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "Berkas ePub berada di %(outdir)s." #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "nilai conf \"epub_language\" (atau \"language\") tidak seharsunya kosong untuk EPUB3" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "nilai conf \"epub_uid\" harus berupa XML NAME untuk EPUB3" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "nilai conf \"epub_title\" (atau \"html_title\") tidak seharusnya kosong untuk EPUB3" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "nilai conf \"epub_author\" tidak seharusnya kosong untuk EPUB3" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "nilai conf \"epub_contributor\" tidak seharusnya kosong untuk EPUB3" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "nilai conf \"epub_description\" tidak seharusnya kosong untuk EPUB3" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "nilai conf \"epub_publisher\" tidak seharusnya kosong untuk EPUB3" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "nilai conf \"epub_copyright\" (atau \"copyright\") tidak seharusnya kosong untuk EPUB3" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "nilai conf \"epub_identifier\" tidak seharusnya kosong untuk EPUB3" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "bilai conf \"version\" tidak seharusnya kosong untuk EPUB3" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "css_file yang salah: %r, mengabaikan" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "Katalog pesan berada di %(outdir)s." #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "target untuk %d berkas templat" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "membaca templat... " #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "menulis katalog pesan... " #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "Mencari kesalahan sembarang dalam keluaran di atas atau di %(outdir)s/output.txt" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "tautan rusak: %s (%s)" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "Anchor '%s' tidak ditemukan" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "Halaman manual berada di %(outdir)s." #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "tidak ditemukan nilai konfigurasi \"man_pages\"; halaman manual tidak akan ditulis" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "penulisan" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "\"man_pages\" nilai konfigurasi mengacu pada dokumen tidak diketahui %s" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "Halaman HTML berada di %(outdir)s." #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "merakit dokumen tunggal" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "menulis file tambahan" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "Berkas Texinfo berada di %(outdir)s." #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "\nJalankan 'make' di direktori tersebut untuk menjalankannya melalui makeinfo\n(gunakan 'make info' di sini untuk melakukannya secara otomatis)." #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "tidak ditemukan nilai konfigurasi \"texinfo_documents\"; dokumen tidak akan ditulis" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "nilai konfigurasi \"texinfo_documents\" mereferensikan dokumen yang tidak dikenal %s" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "memroses %s" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "memecahkan referensi..." #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (dalam " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "menyalin berkas pendukung Texinfo" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "kesalahan menulis berkas Makefile: %s" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "Berkas teks berada di %(outdir)s." #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "kesalahan menulis berkas %s: %s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "Berkas XML berada di %(outdir)s." #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "Berkas pseudo-XML berada di %(outdir)s." #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "berkas info build rusak: %r" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "Halaman HTML berada di %(outdir)s." #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "Gagal membaca berkas info build: %r" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d %b, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Indeks Umum" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "index" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "berikut" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "sebelum" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "menghasilkan indeks" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "menulis halaman tambahan" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "menyalin berkas yang dapat diunduh... " #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "tidak dapat menyalin berkas yang dapat diunduh %r: %s" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "tidak dapat menyalin berkas statik %r" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "menyalin berkas tambahan" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "tidak dapat menyalin berkas ekstra %r" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "Gagal menulis berkas info build: %r" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "indeks pencarian tidak dapat dimuat, tapi tidak semua dokumen akan dibangun: indeks akan jadi tidak lengkap." #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "halaman %s sebanding dengan dua pola dalam html_sidebars: %r dan %r" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "kesalahan Unicode terjadi saat render halaman %s. Silakan pastikan semua nilai konfigurasi yang berisi konten non-ASCII adalah string Unicode." #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "Kesalahan terjadi saat render halaman %s.\nAlasan: %r" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "menyisihkan persediaan obyek" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "js_file yang salah: %r, mengabaikan" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "Banyak math_renderers teregistrasi. Namun tidak satu pun math_renderer yang dipilih." #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "math_renderer %r yang tidak diketahui diberikan." #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "entri html_extra_path %r tidak ada" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "entri html_static_path %r tidak ada" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "berkas logo %r tidak ada" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "berkas favicon %r tidak ada" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "Dokumentasi %s %s" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "Berkas LaTeX berada di %(outdir)s." #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\nJalankan 'make' di direktori tersebut untuk menjalankannya melalui (pdf)latex\n(gunakan 'make latexpdf' di sini untuk melakukannya secara otomatis)." #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "tidak ditemukan nilai konfigurasi \"latex_documents\"; dokumen tidak akan ditulis" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "nilai konfigurasi \"latex_documents\" mereferensikan dokumen yang tidak dikenal %s" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Indeks" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Rilis" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "tidak ada opsi Babel yang dikenal untuk bahasa %r" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "menyalin berkas pendukung TeX" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "menyalin berkas pendukung TeX... " #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "menyalin berkas tambahan" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "Eksepsi terjadi saat membangun, memulai debugger:" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "Diinterupsi" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "markup reST salah:" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "Kesalahan encoding:" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "Traceback lengkap telah disimpan di %s, bila ingin melaporkan masalah ini kepada developer." #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "Kesalahan rekursi:" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "Terjadi eksepsi:" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "Mohon juga melaporkan hal ini jika sebuah kesalahan pengguna sehingga lain kali perintah salah yang lebih baik dapat disediakan." #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "Laporan bug dapat diisi pada tracker di <https://github.com/sphinx-doc/sphinx/issues>. Terima kasih!" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "job number seharusnya sebuah bilangan positif" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "path ke berkas sumber" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "path ke direktori output" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "daftar berkas spesifik yang dibuat ulang. Diabaikan jika -a ditentukan" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "opsi umum" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "builder yang digunakan (default: html)" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "tulis semua berkas (default: hanya tulis berkas yang baru dan diubah)" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "jangan pakai saved environment, selalu baca semua berkas" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "path untuk the cached environment dan berkas doctree (default: OUTPUTDIR/.doctrees)" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "build secara parallel dengan N processes jika memungkinkan (nilai spesial \"auto\" akan menetapkan N ke cpu-count)" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "path tempat berkas konfigurasi (conf.py) berada (default: sama seperti SOURCEDIR)" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "jalankan tanpa berkas sama sekali, hanya opsi -D" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "override sebuah aturan di berkas konfigurasi" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "masukkan sebuah nilai ke templat HTML" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "define tag: masukkan blok \"only\" dengan TAG" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "mode nit-picky, ingatkan tentang semua referensi yang hilang" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "opsi output konsol" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "tingkatkan verbosity (dapat diulang)" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "tanpa output pada stdout, hanya peringatan pada stderr" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "tanpa output sama sekali, peringatan sekalipun" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "siarkan output berwarna (default: auto-detect)" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "jangan siarkan output berwarna (default: auto-detect)" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "tulis peringatan (dan galat) pada berkas terpilih" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "ubah peringatan menjadi galat" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "tampilkan traceback penuh pada eksepsi" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "jalankan Pdb pada eksepsi" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "tidak dapat mencari berkas %r" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "tidak dapat menggabungkan opsi -a dan nama berkas" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "tidak dapat membuka berkas peringatan %r: %s" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "argumen opsi -D harus dalam bentuk name=value" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "argumen opsi -A harus dalam bentuk name=value" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "masukkan docstrings secara otomatis dari modules" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "uji snippet kode secara otomatis pada blok doctest" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "tautkan antara dokumentasi Sphinx dari berbagai proyek" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "tulis entri \"todo\" yang dapat ditampilan atau disembunyikan dalam build" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "periksa coverage dokumentasi" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "masukkan math, yang dirender sebagai gambar PNG atau SVG" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "masukkan math, yang dirender di perambah sebagai gambar PNG atau SVG" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "inklusi bersyarat untuk isi berdasarkan nilai konfig" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "masukkan tautan ke sumber kode untuk objek Python yang terdokumentasi" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "buat berkas .nojekyll untuk menerbitkannya di halaman GitHub" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "Mohon masukkan nama path yang sah." #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "Mohon masukan teks." #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "Mohon masukkan satu dari %s." #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "Mohon ketik salah satu dari 'y' atau 'n'." #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "Mohon masukkan satu suffiks berkas, contohnya '.rst' atau '.txt'." #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "Selamat datang ke alat quickstart Sphinx %s." #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "Silakan masukkan nilai untuk pengaturan berikut (cukup tekan Enter to\nmenerima nilai bawaan, jika diberikan dalam tanda kurung)." #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "Masukkan jalur root untuk dokumentasi." #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "Root path dokumentasi" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "Galat: berkas conf.py telah ditemukan dalam root path terpilih." #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "sphinx-quickstart tidak akan menulis ulang proyek Sphinx yang ada." #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "Silakan masukkan root path baru (atau tekan Enter untuk keluar)" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "Pisahkan direktori source dan build (y/n)" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "Nama prefiks untuk dir templat dan static" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "Nama proyek akan muncul di beberapa tempat dalam dokumentasi yang dibuat." #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "Nama proyek" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "Nama(-nama) pembuat" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "Versi proyek" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "Rilis proyek" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "Bahasa proyek" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "Akhiran berkas sumber" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "Nama dokumen master Anda (tanpa akhiran)" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "Kesalahan: file master %s telah ditemukan di jalur utama yang dipilih." #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "sphinx-quickstart tidak akan menimpa berkas yang sudah ada." #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "Silakan masukkan nama file baru, atau ganti nama file yang ada dan tekan Enter" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "Tunjukkan ekstensi Sphinx berikut mana yang harus diaktifkan:" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "Catatan: imgmath dan mathjax tidak dapat diaktifkan secara bersamaan. imgmath telah diubah tidak pilih." #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "Buat Makefile? (y/n)" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "Buat berkas perintah Windows? (y/n)" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "Membuat file %s." #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "File %s sudah ada, lewati." #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "Selesai: Struktur direktori awal telah dibuat." #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "di mana \"pembangun\" adalah salah satu pembangun yang didukung, mis. html, lateks, atau periksa tautan." #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "\nHasilkan file yang diperlukan untuk proyek Sphinx. \n\nsphinx-quickstart adalah alat interaktif yang menanyakan beberapa pertanyaan tentang proyek Anda \ndan kemudian menghasilkan direktori dokumentasi lengkap dan contoh \nMakefile untuk digunakan dengan sphinx-build.\n" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "mode diam" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "root proyek" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "Opsi struktur" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "jika ditentukan, pisahkan direktori sumber dan pembangunan" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "pengganti dot di _templates dll." #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "Opsi dasar proyek" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "nama proyek" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "nama penulis" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "versi proyek" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "rilis proyek" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "bahasa dokumen" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "akhiran berkas sumber" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "nama dokumen utama" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "gunakan epub" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "Opsi ekstensi" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "aktifkan ekstensi %s" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "aktifkan ekstensi berubah-ubah" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "Pembuatan Makefile dan Batchfile" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "buat makefile" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "jangan membuat makefile" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "buat batchfile" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "jangan membuat batchfile" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "gunakan mode-make untuk Makefile/make.bat" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "jangan gunakan make-mode untuk Makefile/make.bat" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "Membuat templat proyek" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "direktori templat untuk berkas templat" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "mendefinisikan variabel templat" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "\"quiet\" ditentukan, tetapi tidak ada \"project\" atau \"author\" yang ditentukan." #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "Kesalahan: jalur yang ditentukan bukan direktori, atau file sphinx sudah ada." #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "sphinx-quickstart hanya menghasilkan direktori kosong. Silakan tentukan jalur utama baru." #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "Variabel templat tidak valid: %s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "Keterangan tidak valid: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "spesifikasi nomor baris di luar kisaran (1-%d): %r" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "Tidak dapat menggunakan kedua opsi \"%s\" dan \"%s\"" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "Berkas yang disertakan %r tidak ditemukan atau gagal membacanya" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "Pengkodean %r yang digunakan untuk membaca file yang disertakan %r tampaknya salah, mencoba berikan opsi :encoding:" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "Objek bernama %r tidak ditemukan disertakan di berkas %r" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "Tidak dapat menggunakan \"lineno-match\" dengan rangkaian \"baris\" yang terpisah" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "Spesifikasi baris %r: tidak ada baris yang ditarik dari berkas %r" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Penyusun bagian:" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Penyusun modul: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Penulis kode:" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Penyusun: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parameter" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Kembali" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Return type" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "anggota" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "variabel" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "fungsi" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "macro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "union" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "enum" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "enumerator" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "tipe" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Baru pada versi %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Berubah pada versi %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Ditinggalkan sejak versi %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "kutipan rangkap %s, contoh lain dalam %s" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "Kutipan [%s] tidak dirujuk." #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Parameter Templat" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Throws" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "class" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "konsep" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (fungsi built-in)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (method %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (class)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (variabel global atau konstan)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (atribut %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumen" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (module)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "method" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "data" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atribut" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modul" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "duplikasi label persamaan %s, misalnya di %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "Math_eqref_format tidak valid: %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "keyword" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operator" #: sphinx/domains/python.py:61 msgid "object" msgstr "object" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "eksepsi" #: sphinx/domains/python.py:63 msgid "statement" msgstr "statement" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "fungsi built-in" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Variabel" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Raises" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (di modul %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (di modul %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (variabel built-in)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (class built-in)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (class di %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (method class %s)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (method static %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Indeks Modul Python" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "modul" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Akan ditinggalkan" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "method class" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "method static" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "lebih dari satu target ditemukan untuk referensi silang %r: %s" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (obsolet)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (direktif)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (role)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "direktif" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "opsi-direktif" #: sphinx/domains/rst.py:210 msgid "role" msgstr "role" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "variabel environment; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "Deskripsi opsi salah bentuk %r, seharusnya terlihat seperti \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" atau \"+opt args\"" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "opsi baris perintah" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "Daftar Istilah kata sulit harus didahului dengan baris kosong" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "Daftar istilah kata sulit tidak boleh dipisahkan oleh garis kosong" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "Daftar istilah kata sulit tampaknya salah format, periksa indentasi" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "daftar istilah" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "token grammar" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "label referensi" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "variabel environment" #: sphinx/domains/std.py:568 msgid "program option" msgstr "opsi program" #: sphinx/domains/std.py:569 msgid "document" msgstr "dokumen" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Indeks Modul" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Pencarian Halaman" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "label rangkap %s, contoh lain dalam %s" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "numfig dinonaktifkan. :numref: diabaikan." #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "tautan tidak memiliki teks: %s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "numfig_format tidak valid: %s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "numfig_format tidak valid: %s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "konfigurasi baru" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "konfigurasi berubah" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "ekstensi berubah" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "membangun lingkungan bukan versi saat ini" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "direktori sumber telah berubah" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "Lingkungan ini tidak kompatibel dengan pembangun yang dipilih, silakan pilih direktori doctree lain." #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "Gagal memindai dokumen dalam %s: %r" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "Domain %r tidak terdaftar" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "totree referensikan sendiri ditemukan. Diabaikan" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "dokumen tidak termasuk dalam toctree" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "lihat %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "lihat juga %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "tipe entri indeks tidak dikenal %r" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Simbol" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "referensi toctree melingkar terdeteksi, mengabaikan: %s <- %s" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "toctree berisi referensi ke dokumen %r yang tidak memiliki judul: tidak ada tautan yang akan dihasilkan" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "toctree berisi referensi ke dokumen yang dikecualikan %r" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "toctree berisi referensi ke dokumen yang tidak ada %r" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "berkas gambar tidak dapat dibaca: %s" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "berkas gambar %s tidak dapat dibaca: %s" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "berkas unduhan tidak dapat dibaca: %s" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "%s sudah diberi nomor bagian (penomoran bersarang toctree?)" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "Akan membuat berkas %s." #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "\nLihat secara rekursif dalam <MODULE_PATH> untuk modul dan paket Python dan buat \nsatu berkas reST dengan arahan automodule per paket di <OUTPUT_PATH>. \n\n<EXCLUDE_PATTERN> dapat berupa pola berkas dan/atau direktori yang akan \ndikecualikan dari pembuatan. \n\nCatatan: Secara bawaan skrip ini tidak akan menimpa berkas yang sudah dibuat." #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "jalur ke modul ke dokumen" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "Berkas gaya-fnmatch dan/atau pola direktori untuk dikecualikan dari pembuatan" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "direktori untuk menempatkan semua keluaran" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "kedalaman maksimum submodul untuk ditampilkan di TOC (bawaan: 4)" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "menimpa file yang ada" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "ikuti tautan simbolik. Berdaya bila digabungkan dengan collective.recipe.omelette." #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "operasikan skrip tanpa membuat file" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "letakkan dokumentasi untuk setiap modul di halamannya sendiri" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "termasuk modul \"_private\"" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "nama file daftar isi (bawaan: modul)" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "jangan membuat berkas daftar isi" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "jangan membuat judul untuk paket modul/paket (mis. ketika docstrings sudah berisi hal tersebut)" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "letakkan dokumentasi modul sebelum dokumentasi submodul" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "menafsirkan jalur modul sesuai dengan spesifikasi namespaces implisit PEP-0420" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "akhiran berkas (bawaan: rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "menghasilkan proyek penuh dengan sphinx-quickstart" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "menambahkan module_path ke sys.path, digunakan ketika --full diberikan" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "nama proyek (bawaan: nama modul utama)" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "penulis-(penulis) proyek, digunakan ketika --full diberikan" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "versi proyek, digunakan ketika --full diberikan" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "rilis proyek, digunakan ketika --full diberikan, bawaan ke --doc-version" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "opsi ekstensi" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s bukan direktori." #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "regex tidak valid %r dalam %s" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "Pengujian cakupan di sumber selesai, lihat hasilnya dalam %(outdir)spython.txt." #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "%r regex tidak valid di coverage_c_regexes" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "modul %s tidak dapat diimpor: %s" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "tidak ada '+' atau '-' dalam opsi '%s'." #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "'%s' bukan opsi yang valid." #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "'%s' bukan opsi pyversion yang valid" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "tipe TestCode tidak valid" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "Pengujian dokumen di sumber selesai, lihat hasil dalam %(outdir)s/output.txt." #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "tidak ada kode/keluaran dalam blok %s pada %s:%s" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "mengabaikan kode dokumen yang tidak valid: %r" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "Pengarahan Graphviz tidak dapat memiliki konten dan argumen nama berkas sekaligus" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "Berkas Graphviz eksternal %r tidak ditemukan atau gagal dibaca" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "Mengabaikan pengarahan \"graphviz\" tanpa konten." #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot tidak menghasilkan berkas output: \n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "perintah dot %r tidak dapat dioperasikan (diperlukan untuk keluaran graphviz), periksa pengaturan graphviz_dot" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot keluar dengan kesalahan: \n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "graphviz_output_format harus salah satu dari 'png', 'svg', tetapi %r" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "kode dot %r: %s" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[graph: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[graph]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "convert keluar dengan kesalahan: \n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "Perintah LaTeX %r tidak dapat dioperasikan (diperlukan untuk tampilan matematika), periksa pengaturan imgmath_latex" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "%s perintah %r tidak dapat dioperasikan (diperlukan untuk tampilan matematika), periksa pengaturan imgmath_%s" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "tampilkan latex %r: %s" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "inline latex %r: %s" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Tautan untuk persamaan ini" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "pengimpanan intersphinx telah dipindahkan: %s -> %s" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "memuat penyimpanan intersphinx dari %s..." #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "mengalami beberapa masalah dengan beberapa inventaris, tetapi mereka memiliki alternatif berfungsi:" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "gagal mencapai salah satu inventaris dengan masalah berikut:" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(di %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(dalam %s)" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "pengenal intersphinx %r bukan string. Diabaikan" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[sumber]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Todo" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "Entri TODO ditemukan: %s" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<original entry>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(<<original entry>> terletak di %s, baris %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "entri asli" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "menyoroti kode modul..." #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[docs]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Kode modul" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Kode sumber untuk %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Tinjauan: kode modul" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Semua modul dimana kode tersedia</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "tanda tangan tidak valid untuk outo %s (%r)" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "kesalahan saat memformat argumen untuk %s: %s" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "atribut hilang %s dalam objek %s" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "tidak tahu modul mana yang akan diimpor untuk autodocumenting %r (coba letakkan pengarahan \"module\" atau \"currentmodule\" dalam dokumen, atau berikan nama modul yang eksplisit)" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "\"::\" dalam nama automodule tidak masuk akal" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "argumen tanda tangan atau anotasi kembalian diberikan untuk automodule %s" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "__all__ harus berupa daftar string, bukan %r (dalam modul %s) -- mengabaikan __all__" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "Basis: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "gagal mengurai nama %s" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "gagal mengimpor objek %s" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "autosummary menghasilkan file .rst secara internal. Tapi source_suffix Anda tidak mengandung .rst. Dilewati." #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[autosummary] menghasilkan autosummary untuk: %s" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "[autosummary] menulis ke %s" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "\nHasilkan ReStructuredText menggunakan pengarahan autosummary.\n\nsphinx-autogen adalah tampilan depan ke sphinx.ext.autosummary.generate. Ini menghasilkan \nfile reStructuredText dari pengarahan autosummary yang terkandung dalam \nfile input yang diberikan.\n\nFormat pengarahan autosummary didokumentasikan dalam \nmodul ``sphinx.ext.autosummary`` dan dapat dibaca menggunakan::\n\n pydoc sphinx.ext.autosummary\n" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "berkas sumber untuk menghasilkan file rST untuk" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "direktori untuk menempatkan semua keluaran dalam" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "akhiran bawaan untuk berkas (bawaan: %(default)s)" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "direktori templat ubahsuai (bawaan: %(default)s)" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "mendokumentasikan anggota yang diimpor (bawaan: %(default)s)" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "Argumen Kata Kunci" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "Contoh" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Contoh-contoh" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "Catatan" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "Parameter lainnya" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "Referensi" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "Peringatkan" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "Hasil" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Pehatian" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Hati-hati" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Bahaya" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Kesalahan" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Petunjuk" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Penting" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Catatan" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Lihat juga" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Tip" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Peringatan" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "lanjutan dari halaman sebelumnya" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "berlanjut ke halaman berikutnya" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "Non-abjad" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "Angka" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "laman" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "Daftar Isi" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Pencarian" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Go" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Lihat Sumber" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Tinjauan" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Selamat Datang! Ini adalah" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "dokumentasi untuk" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "terakhir diperbarui" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Indeks dan tabel:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Daftar Isi Lengkap" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "daftar semua seksi dan subseksi" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "pencarian pada dokumentasi ini" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Index Modul Global" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "akses cepat semua modul" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "semua fungsi, class, term" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Index – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Index penuh dalam satu halaman" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Index halaman berdasarkan huruf" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "dapat menjadi besar" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigasi" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Pencarian dalam %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Tentang dokumen ini" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Hak Cipta" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Hak cipta</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Hak cipta %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Terakhir diperbarui pada %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Pencarian %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Topik sebelumnya" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "bab sebelum" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Topik berikutnya" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "bab berikutnya" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Tolong aktifkan JavaScript untuk melakukan pencarian.\n " #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "Mencari beberapa kata hanya menunjukkan kecocokan yang mengandung\n    semua kata." #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "pencarian" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Hasil Pencarian" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Tidak ada dokumen yang cocok dengan pencarian anda. Pastikan semua kata ditulis dengan benar dan sudah memilih cukup kategori." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Pencarian cepat" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Halaman Ini" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Perubahan pada Versi %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Daftar perubahan dibuat otomatis untuk versi %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Perubahan library" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Perubahan API C" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Perubahan lain" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Link permanen untuk headline ini" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Link permanen untuk definisi ini" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Sembunyikan Hasil Pencarian" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Pencarian" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Penyiapkan pencarian..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Pencarian selesai, menemukan %s halaman yang cocok dengan kueri pencarian." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", di" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Buka sidebar" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Tutup sidebar" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Konten" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "4 kolom berdasarkan indeks ditemukan. Ini mungkin bug ekstensi yang Anda gunakan: %r" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "Catatan kaki [%s] tidak dirujuk." #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "Catatan kaki [#] tidak dirujuk." #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "referensi catatan kaki yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "referensi yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "referensi kutipan tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "referensi istilah yang tidak konsisten dalam pesan yang diterjemahkan. asli: {0}, diterjemahkan: {1}" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "lebih dari satu target ditemukan untuk referensi silang 'any' %r: bisa %s" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "Tidak dapat mengambil gambar jarak jauh: %s [%d]" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "Tidak dapat mengambil gambar jarak jauh: %s [%s]" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "Format gambar tidak dikenal: %s..." #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "karakter sumber undecodable, menggantinya dengan \"?\": %r" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "dilewati" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "gagal" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "kesalahan membaca: %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "kesalahan menulis: %s, %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "Format tanggal tidak valid. Kutip string dengan kutipan tunggal jika Anda ingin menampilkannya secara langsung: %s" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "toctree berisi ref ke berkas yang tidak ada %r" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "pengecualian saat mengevaluasi hanya ekspresi pengarahan: %s" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "peran bawaan %s tidak ditemukan" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "numfig_format tidak didefinisikan untuk %s" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "Tidak ada ID apa pun yang ditugaskan untuk simpul %s" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Link permanen untuk table ini" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Link permanen untuk kode ini" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Link permanen untuk gambar ini" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Tautan ke daftar isi ini" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "Tidak dapat memperoleh ukuran gambar. :scale: option diabaikan." #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "%r toplevel_sectioning tidak diketahui untuk kelas %r" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr ":maxdepth: terlalu besar, diabaikan." #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "judul dokumen bukan simpul Text tunggal" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "simpul judul tidak ditemui dalam bagian, topik, tabel, peringatan atau sisi bilah" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Catatan kaki" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "opsi tabularcolumns dan :widths: opsi diberikan bersamaan. :widths: diabaikan." #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "unit dimensi %s tidak valid. Diabaikan" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "entri indeks tidak diketahui ditemukan tipe %s" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[gambar: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[gambar]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "keterangan tidak di dalam gambar." #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "tipe simpul tidak diterapkan: %r" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "tipe simpul tidak dikenal: %r" ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3276522 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/is/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015516� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4874809 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/is/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017303� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/is/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000006114�00000000000�021154� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "is", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "Heildarefnisyfirlit", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "Almennt yfirlit", "Global Module Index": "", "Go": "", "Hide Search Matches": "Fela leitarni\u00f0urst\u00f6\u00f0ur", "Index": "Yfirlit", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "Atri\u00f0askr\u00e1 og t\u00f6flur:", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "N\u00e6sta efni", "Other changes": "", "Overview": "", "Permalink to this definition": "Varanlegur hlekkur \u00e1 \u00feessa skilgreiningu", "Permalink to this headline": "Varanlegur hlekkur \u00e1 \u00feennan titil", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "Undirb\u00fdr leit...", "Previous topic": "Fyrra efni", "Quick search": "Fl\u00fdtileit", "Search": "Leit", "Search Page": "Leitars\u00ed\u00f0a", "Search Results": "Leitarni\u00f0urst\u00f6\u00f0ur", "Search finished, found %s page(s) matching the search query.": "Leit loki\u00f0, fann %s s\u00ed\u00f0u(r) sem p\u00f6ssu\u00f0u vi\u00f0 leitarskilyr\u00f0in.", "Search within %(docstitle)s": "Leita \u00ed %(docstitle)s", "Searching": "Leitar", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "Efnisyfirlit", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Leitin bar ekki \u00e1rangur. Vinsamlegast gangi\u00f0 \u00far skugga um a\u00f0 or\u00f0in s\u00e9u r\u00e9tt skrifu\u00f0 og a\u00f0 \u00fe\u00fa hafir vali\u00f0 n\u00e6gilega marga flokka.", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "n\u00e6sti kafli", "previous chapter": "fyrri kafli", "quick access to all modules": "", "search": "leita", "search this documentation": "leita", "the documentation for": "" }, "plural_expr": "(n % 10 != 1 || n % 100 == 11)" });����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/is/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000006353�00000000000�021160� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������6��������������������|�� ���}��������������������������� ��������������� ��������������� ��� �� �������� �����%�����<�����Y�����t��������������������������� �������������������� ���*�����6��<���E������� ����� ����������������������������������� ���n�����z���������������������� ���������������������������� �� ����������������� ����� ����� �����& �����, �����4 �����D �� ���^ �� ���h �����s �����{ ����� �� ��� �� ��� ��$��� ��*��� ��#��� ��#���( ��!���L ��#���n ��#��� ����� �� ��� �� ��� ����� ����� ����� �� ��� ����� ��C���% �����i ����� ����� �� ��� ����� �� ��� �� ��� �� ��� ����� �� ���S �����^ �����e ����� ����� ����� �� ��� ����� �� ��� ����� ����� ����� ����� ���Attention�Caution�Complete Table of Contents�Danger�Error�Fig. %s�General Index�Hide Search Matches�Hint�Important�Index�Indices and tables:�Listing %s�Next topic�Note�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this term�Preparing search...�Previous topic�Quick search�Release�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section %s�See also�Table %s�Table of Contents�Tip�Warning�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[image: %s]�[image]�continued from previous page�continues on next page�index�next�next chapter�previous�previous chapter�search�search this documentation�see %s�see also %s�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: is Language-Team: Icelandic (http://www.transifex.com/sphinx-doc/sphinx-1/language/is/) Plural-Forms: nplurals=2; plural=(n % 10 != 1 || n % 100 == 11) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �Athugið�Aðgát�Heildarefnisyfirlit�Hætta�Villa�Mynd %s�Almennt yfirlit�Fela leitarniðurstöður�Ábending�Mikilvægt�Yfirlit�Atriðaskrá og töflur:�Listi %s�Næsta efni�Athugasemd�Varanlegur hlekkur á þennan kóða�Varanlegur hlekkur á þessa skilgreiningu�Varanlegur hlekkur á þessa jöfnu�Varanlegur hlekkur á þennan titil�Varanlegur hlekkur á þessa mynd�Varanlegur hlekkur á þessa töflu�Varanlegur hlekkur á þetta hugtak�Undirbýr leit...�Fyrra efni�Flýtileit�Útgáfa�Leit�Leita í %(docstitle)s�Leitarsíða�Leitarniðurstöður�Leit lokið, fann %s síðu(r) sem pössuðu við leitarskilyrðin.�Leita í %(docstitle)s�Leitar�Kafli %s�Sjá einnig�Tafla %s�Efnisyfirlit�Ábending�Aðvörun�Leitin bar ekki árangur. Vinsamlegast gangið úr skugga um að orðin séu rétt skrifuð og að þú hafir valið nægilega marga flokka.�[mynd: %s]�[mynd]�framhald frá fyrri síðu�framhald á næstu síðu�yfirlit�næsta�næsti kafli�fyrri�fyrri kafli�leita�leita�sjá %s�sjá einnig %s��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/is/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000243416�00000000000�021166� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Tryggvi Kalman <tkj3@hi.is>, 2021 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Icelandic (http://www.transifex.com/sphinx-doc/sphinx-1/language/is/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: is\n" "Plural-Forms: nplurals=2; plural=(n % 10 != 1 || n % 100 == 11);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Kafli %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Mynd %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tafla %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Listi %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Almennt yfirlit" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "yfirlit" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "næsta" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "fyrri" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Yfirlit" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Útgáfa" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Leitarsíða" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "sjá %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "sjá einnig %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Varanlegur hlekkur á þessa jöfnu" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Athugið" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Aðgát" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Hætta" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Villa" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Ábending" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Mikilvægt" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Athugasemd" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Sjá einnig" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Ábending" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Aðvörun" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "framhald frá fyrri síðu" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "framhald á næstu síðu" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "Efnisyfirlit" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Leit" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Atriðaskrá og töflur:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Heildarefnisyfirlit" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "leita" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Leita í %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Leita í %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Fyrra efni" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "fyrri kafli" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Næsta efni" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "næsti kafli" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "leita" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Leitarniðurstöður" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Leitin bar ekki árangur. Vinsamlegast gangið úr skugga um að orðin séu rétt skrifuð og að þú hafir valið nægilega marga flokka." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Flýtileit" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Varanlegur hlekkur á þennan titil" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Varanlegur hlekkur á þessa skilgreiningu" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Fela leitarniðurstöður" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Leitar" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Undirbýr leit..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Leit lokið, fann %s síðu(r) sem pössuðu við leitarskilyrðin." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "Varanlegur hlekkur á þetta hugtak" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Varanlegur hlekkur á þessa töflu" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Varanlegur hlekkur á þennan kóða" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Varanlegur hlekkur á þessa mynd" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[mynd: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[mynd]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.327838 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/it/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015517� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4882004 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/it/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017304� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/it/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000007436�00000000000�021165� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "it", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.", "© Copyright %(copyright)s.": "© Copyright %(copyright)s.", ", in ": ", in ", "About these documents": "A proposito di questi documenti", "Automatically generated list of changes in version %(version)s": "Lista delle modifiche generata automaticamente nella versione %(version)s", "C API changes": "Modifiche nelle API C", "Changes in Version %(version)s — %(docstitle)s": "Cambiamenti nella Versione %(version)s — %(docstitle)s", "Collapse sidebar": "Comprimi la barra laterale", "Complete Table of Contents": "Tabella dei contenuti completa", "Contents": "Contenuti", "Copyright": "Copyright", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Espandi la barra laterale", "Full index on one page": "Indice completo in una pagina", "General Index": "Indice generale", "Global Module Index": "Indice dei moduli", "Go": "Vai", "Hide Search Matches": "Nascondi i risultati della ricerca", "Index": "Indice", "Index – %(key)s": "Indice – %(key)s", "Index pages by letter": "Indice delle pagine per lettera", "Indices and tables:": "Indici e tabelle:", "Last updated on %(last_updated)s.": "Ultimo aggiornamento %(last_updated)s.", "Library changes": "Modifiche nella libreria", "Navigation": "Navigazione", "Next topic": "Argomento successivo", "Other changes": "Altre modifiche", "Overview": "Sintesi", "Permalink to this definition": "Link a questa definizione", "Permalink to this headline": "Link a questa intestazione", "Please activate JavaScript to enable the search\n functionality.": "Attiva JavaScript per abilitare la funzione\u23ce\ndi ricerca.", "Preparing search...": "Preparo la ricerca...", "Previous topic": "Argomento precedente", "Quick search": "Ricerca veloce", "Search": "Cerca", "Search Page": "Cerca", "Search Results": "Risultati della ricerca", "Search finished, found %s page(s) matching the search query.": "Ricerca completata, trovata/e %s pagina/e corrispondenti.", "Search within %(docstitle)s": "Cerca in %(docstitle)s", "Searching": "Cerca", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Mostra sorgente", "Table of Contents": "", "This Page": "Questa pagina", "Welcome! This is": "Benvenuto! Questa \u00e8", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "La tua ricerca non corrisponde a nessun documento. Verifica che tutte le parole siano scritte correttamente e di aver scelto un numero sufficiente di categorie.", "all functions, classes, terms": "tutte le funzioni, classi e moduli", "can be huge": "pu\u00f2 essere enorme", "last updated": "ultimo aggiornamento", "lists all sections and subsections": "elenca l'insieme delle sezioni e sottosezioni", "next chapter": "capitolo successivo", "previous chapter": "capitolo precedente", "quick access to all modules": "accesso veloce ai moduli", "search": "cerca", "search this documentation": "cerca in questa documentazione", "the documentation for": "la documentazione per" }, "plural_expr": "(n != 1)" });����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/it/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000023751�00000000000�021162� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ �� ��� ����� ��"��� �� ��� ����� ����� ����� ����� ����� �����% �����6 �� ���E �����f �� ���x �� ��� ����� ����� ����� ����� �� ��� ����� ��6��� �����? �����_ ��3���{ �� ��� ����� ����� ��0��� ����������!�� ���7�� ���A�����K��>���T�� ���������� �����%���������������4����� ���-�����;�����L�����g�� ���p�����z�� ������������������������������ ���������� �����������������������(�� ���-�����7�����=�����S�����i�����}�������!���������� ����� ���������� ����� ��� �� ��������!�� ���3�����>�� ���C�����Q�����Z�� ���p�����{��������������������������������B���/�����r�������$���������� ��������������� �������������������� ��������&��<���5�����r�� ����� ��������������� �������������������� �������������������� ������������������+������� ���������� �������������������� ��� ������� ���(�����4�� ���:�����G�����O�����l�� ���q�����{�������4���������� ��������������� ��������������� ���&�� ���4�����B�����H�� ���P��"���]�����������������"�������������������� �����������������������������������%��������<�����K�����g�����w�����|������������ ����� ����� ������������������������ ����������"����������������������� ����������3�����K�����]��!���l������� ����� �������������������������� ��������'��6���<�����s�������4����� ���������������7��������H�����h�� ����� ����������I����� ���������������<����� ���X�����c��<���~����������������� ��� �� ���������� ���&�����0�����L�����S�����Z�����t�����|����������������������"����� ����� ������������������/�����O�����a�����{��&���������� ������������������ ����� �� ���, �����8 �����P �����e �����j �����z ��!��� �� ��� ����� ����� ����� ����� �����!�����,!�����B!��:���W!�����!�����!��$���!�����!�����!����� "�����"�����"�����*"�����2"�����8"�����L"�����R"��9���j"�����"�����"�� ���"�����"�� ���"�����"�����"�� ���#�����#�� ���'#�����5#�� ���=#�����J#�� ���R#�� ���\#�����i#�����~#�� ���$�� ���+$�� ���9$�����C$�� ���R$�� ���]$��"���h$�� ���$�����$�����$�����$�����$�����$�� ���$�����$�� ���%�� ���%�����%��:���%�����Y%�� ���^%�����j%�����%�� ���%�����%�����%�����%�����%�����%�����%�����%��-���&�����=&�����C&�����J&��#���Q&�����u&�����|&�� ���&�����&�����&�� ���&�����&�����&�� ���&�����&��8���&�����"'�����8'�����Q'�����j'�����p'�����v'�����'�� ���'�� ���'�����'�����'�����'�� ���'��� (deprecated)� (in �%(filename)s — %(docstitle)s�%b %d, %Y�%s %s�%s %s documentation�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�, in �<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builtins�C API changes�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Code author: �Collapse sidebar�Complete Table of Contents�Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Examples�Expand sidebar�Fig. %s�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Invalid caption: %s�Keyword Arguments�Last updated on %(last_updated)s.�Library changes�Listing %s�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Please activate JavaScript to enable the search functionality.�Preparing search...�Previous topic�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Release�Return type�Returns�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section %s�Section author: �See also�Show Source�Symbols�Table %s�Template Parameters�This Page�Throws�Tip�Todo�Variables�Warning�Welcome! This is�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�all functions, classes, terms�attribute�built-in function�can be huge�class�class method�concept�continued from previous page�data�directive�document�done�duplicate label of equation %s, other instance in %s�enum�enumerator�environment variable�environment variable; %s�exception�finished with problems�function�glossary term�grammar token�index�keyword�last updated�lists all sections and subsections�macro�member�method�missing '+' or '-' in '%s' option.�module�modules�next�next chapter�object�operator�original entry�page�previous�previous chapter�primary_domain %r not found, ignored.�program option�quick access to all modules�reference label�role�search�search this documentation�see %s�see also %s�statement�static method�the documentation for�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: it Language-Team: Italian (http://www.transifex.com/sphinx-doc/sphinx-1/language/it/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (deprecato)� (in �%(filename)s — %(docstitle)s�%d %b %Y�%s %s�%s %s documentazione�%s (%s attributo)�%s (classe built-in)�%s (variabile built-in)�%s (classe in %s)�%s (direttiva)�%s (variabile globale o costante)�%s (nel modulo %s)�%s (modulo)�%s (ruolo)�%s() (%s metodo della classe)�%s() (%s metodo)�%s() (%s metodo statico)�%s() (funzione built-in)�%s() (classe)�%s() (nel modulo %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' non è un'opzione valida.�(L'<<elemento originale>> si trova in %s, linea %d.)�(in %s v%s)�, in �<<elemento originale>>�<h1>Tutti i moduli di cui è disponibile il codice</h1>�<h1>Codice sorgente per %s</h1>�A proposito di questi documenti�Parametri�Attenzione�Autore: �Lista delle modifiche generata automaticamente nella versione %(version)s� Basi: %s�Builtins�Modifiche nelle API C�Impossibile usare contemporaneamente le opzioni "%s" e "%s"�Attenzione�Cambiato nella versione %s�Cambiamenti nella Versione %(version)s — %(docstitle)s�Autore del codice: �Comprimi la barra laterale�Tabella dei contenuti completa�Contenuti�Copyright�Pericolo�Deprecato�Deprecato dalla versione %s�Errore�Esempi�Espandi la barra laterale�Fig. %s�Note a piè di pagina�Indice completo in una pagina�Indice generale�Indice dei moduli�Vai�Nascondi i risultati della ricerca�Suggerimento�Importante�Indice�Indice – %(key)s�Indice delle pagine per lettera�Indici e tabelle:�Didascalia non valida: %s�Argomenti parole chiave�Ultimo aggiornamento %(last_updated)s.�Modifiche nella libreria�Listato %s�Indice dei moduli�Autore del modulo: �Codice del modulo�Al livello del modulo�Navigazione�Nuovo nella versione %s�Argomento successivo�Nota�Altre modifiche�Sintesi�Vista generale: codice del modulo�Parametri�Link a questo codice�Link a questa definizione�Permalink a questa equazione�Link a questa intestazione�Link a questa immagine�Link a questa tabella�Link a questo indice�Attiva JavaScript per abilitare la funzione⏎ di ricerca.�Preparo la ricerca...�Argomento precedente�Python Enhancement Proposals; PEP %s�Indice del modulo Python�Ricerca veloce�Solleva�Release�Tipo di ritorno�Ritorna�Cerca�Cerca %(docstitle)s�Cerca�Risultati della ricerca�Ricerca completata, trovata/e %s pagina/e corrispondenti.�Cerca in %(docstitle)s�Cerca�Sezione %s�Autore della sezione: �Vedi anche�Mostra sorgente�Simboli�Tabella %s�Parametri del modello�Questa pagina�Solleva�Suggerimento�Da fare�Variabili�Avvertimento�Benvenuto! Questa è�La tua ricerca non corrisponde a nessun documento. Verifica che tutte le parole siano scritte correttamente e di aver scelto un numero sufficiente di categorie.�[documenti]�[grafico: %s]�[grafico]�[immagine: %s]�[immagine]�[sorgente]�tutte le funzioni, classi e moduli�attributo�funzione built-in�può essere enorme�classe�metodo della classe�concetto�continua dalla pagina precedente�dati�direttiva�documento�fatto�etichetta dell'equazione %s duplicata, altra istanza in %s�enum�enumeratore�variabile d'ambiente�variabile d'ambiente, %s�eccezione�terminato con problemi�funzione�voce del glossario�elemento grammaticale�indice�keyword�ultimo aggiornamento�elenca l'insieme delle sezioni e sottosezioni�macro�membro�metodo�manca '+' or'-' nell'opzione '%s'.�modulo�moduli�successivo�capitolo successivo�oggetto�operatore�riga originale�pagina�precedente�capitolo precedente�il primary_domain %r non è stato trovato, tralasciato.�opzione del programma�accesso veloce ai moduli�etichetta di riferimento�ruolo�cerca�cerca in questa documentazione�vedi %s�vedi anche %s�statement�metodo statico�la documentazione per�tipo�variabile������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/it/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000250611�00000000000�021162� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Denis Cappellin <denis@cappell.in>, 2018 # Paolo Cavallini <cavallini@faunalia.it>, 2013-2017 # Roland Puntaier <roland.puntaier@chello.at>, 2013 # Sandro Dentella <sandro@e-den.it>, 2008 # Komiya Takeshi <i.tkomiya@gmail.com>, 2016 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Italian (http://www.transifex.com/sphinx-doc/sphinx-1/language/it/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: it\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "fatto" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "terminato con problemi" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Sezione %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Fig. %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tabella %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Listato %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "il primary_domain %r non è stato trovato, tralasciato." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Builtins" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Al livello del modulo" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (in " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d %b %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Indice generale" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "indice" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "successivo" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "precedente" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s documentazione" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Indice" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Release" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "Didascalia non valida: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "Impossibile usare contemporaneamente le opzioni \"%s\" e \"%s\"" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Autore della sezione: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Autore del modulo: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Autore del codice: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autore: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametri" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Ritorna" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Tipo di ritorno" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "membro" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "variabile" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funzione" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "macro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "enum" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "enumeratore" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "tipo" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Nuovo nella versione %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Cambiato nella versione %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Deprecato dalla versione %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Parametri del modello" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Solleva" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "classe" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "concetto" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (funzione built-in)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s metodo)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (classe)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (variabile globale o costante)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s attributo)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Parametri" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modulo)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "metodo" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "dati" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "attributo" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modulo" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "etichetta dell'equazione %s duplicata, altra istanza in %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "keyword" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operatore" #: sphinx/domains/python.py:61 msgid "object" msgstr "oggetto" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "eccezione" #: sphinx/domains/python.py:63 msgid "statement" msgstr "statement" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "funzione built-in" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Variabili" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Solleva" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (nel modulo %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (nel modulo %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (variabile built-in)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (classe built-in)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (classe in %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s metodo della classe)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s metodo statico)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Indice del modulo Python" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "moduli" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Deprecato" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "metodo della classe" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "metodo statico" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (deprecato)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (direttiva)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (ruolo)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "direttiva" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "ruolo" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "variabile d'ambiente, %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "voce del glossario" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "elemento grammaticale" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "etichetta di riferimento" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "variabile d'ambiente" #: sphinx/domains/std.py:568 msgid "program option" msgstr "opzione del programma" #: sphinx/domains/std.py:569 msgid "document" msgstr "documento" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Indice dei moduli" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Cerca" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "vedi %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "vedi anche %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Simboli" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "manca '+' or'-' nell'opzione '%s'." #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "'%s' non è un'opzione valida." #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[grafico: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[grafico]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Permalink a questa equazione" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(in %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[sorgente]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Da fare" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<elemento originale>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(L'<<elemento originale>> si trova in %s, linea %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "riga originale" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[documenti]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Codice del modulo" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Codice sorgente per %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Vista generale: codice del modulo" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Tutti i moduli di cui è disponibile il codice</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr " Basi: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "Argomenti parole chiave" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Esempi" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Attenzione" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Attenzione" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Pericolo" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Errore" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Suggerimento" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Importante" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Nota" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Vedi anche" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Suggerimento" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Avvertimento" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "continua dalla pagina precedente" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "pagina" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Cerca" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Vai" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Mostra sorgente" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Sintesi" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Benvenuto! Questa è" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "la documentazione per" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "ultimo aggiornamento" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Indici e tabelle:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Tabella dei contenuti completa" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "elenca l'insieme delle sezioni e sottosezioni" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "cerca in questa documentazione" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Indice dei moduli" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "accesso veloce ai moduli" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "tutte le funzioni, classi e moduli" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Indice – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Indice completo in una pagina" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Indice delle pagine per lettera" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "può essere enorme" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigazione" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Cerca in %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "A proposito di questi documenti" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Copyright" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Copyright %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Ultimo aggiornamento %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Cerca %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Argomento precedente" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "capitolo precedente" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Argomento successivo" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "capitolo successivo" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Attiva JavaScript per abilitare la funzione⏎\ndi ricerca." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "cerca" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Risultati della ricerca" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "La tua ricerca non corrisponde a nessun documento. Verifica che tutte le parole siano scritte correttamente e di aver scelto un numero sufficiente di categorie." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Ricerca veloce" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Questa pagina" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Cambiamenti nella Versione %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Lista delle modifiche generata automaticamente nella versione %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Modifiche nella libreria" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Modifiche nelle API C" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Altre modifiche" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Link a questa intestazione" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Link a questa definizione" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Nascondi i risultati della ricerca" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Cerca" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Preparo la ricerca..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Ricerca completata, trovata/e %s pagina/e corrispondenti." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", in " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Espandi la barra laterale" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Comprimi la barra laterale" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Contenuti" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Link a questa tabella" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Link a questo codice" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Link a questa immagine" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Link a questo indice" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Note a piè di pagina" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[immagine: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[immagine]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �����������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3280213 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ja/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015475� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4890347 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ja/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017262� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ja/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000012515�00000000000�021135� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "ja", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.", "© Copyright %(copyright)s.": "© Copyright %(copyright)s.", ", in ": ", in ", "About these documents": "\u3053\u306e\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u306b\u3064\u3044\u3066", "Automatically generated list of changes in version %(version)s": "\u30d0\u30fc\u30b8\u30e7\u30f3 %(version)s \u306e\u5909\u66f4\u70b9\uff08\u3053\u306e\u30ea\u30b9\u30c8\u306f\u81ea\u52d5\u751f\u6210\u3055\u308c\u3066\u3044\u307e\u3059\uff09", "C API changes": "C API \u306b\u95a2\u3059\u308b\u5909\u66f4", "Changes in Version %(version)s — %(docstitle)s": "\u30d0\u30fc\u30b8\u30e7\u30f3 %(version)s \u306e\u5909\u66f4\u70b9 — %(docstitle)s", "Collapse sidebar": "\u30b5\u30a4\u30c9\u30d0\u30fc\u3092\u305f\u305f\u3080", "Complete Table of Contents": "\u7dcf\u5408\u76ee\u6b21", "Contents": "\u30b3\u30f3\u30c6\u30f3\u30c4", "Copyright": "\u8457\u4f5c\u6a29", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "\u30b5\u30a4\u30c9\u30d0\u30fc\u3092\u5c55\u958b", "Full index on one page": "\u7dcf\u7d22\u5f15", "General Index": "\u7dcf\u5408\u7d22\u5f15", "Global Module Index": "\u30e2\u30b8\u30e5\u30fc\u30eb\u7dcf\u7d22\u5f15", "Go": "\u691c\u7d22", "Hide Search Matches": "\u691c\u7d22\u7d50\u679c\u3092\u96a0\u3059", "Index": "\u7d22\u5f15", "Index – %(key)s": "\u7d22\u5f15 – %(key)s", "Index pages by letter": "\u982d\u6587\u5b57\u5225\u7d22\u5f15", "Indices and tables:": "\u7d22\u5f15\u3068\u8868\u4e00\u89a7:", "Last updated on %(last_updated)s.": "\u6700\u7d42\u66f4\u65b0: %(last_updated)s", "Library changes": "\u30e9\u30a4\u30d6\u30e9\u30ea\u306b\u95a2\u3059\u308b\u5909\u66f4", "Navigation": "\u30ca\u30d3\u30b2\u30fc\u30b7\u30e7\u30f3", "Next topic": "\u6b21\u306e\u30c8\u30d4\u30c3\u30af\u3078", "Other changes": "\u305d\u306e\u4ed6\u306e\u5909\u66f4", "Overview": "\u6982\u8981", "Permalink to this definition": "\u3053\u306e\u5b9a\u7fa9\u3078\u306e\u30d1\u30fc\u30de\u30ea\u30f3\u30af", "Permalink to this headline": "\u3053\u306e\u30d8\u30c3\u30c9\u30e9\u30a4\u30f3\u3078\u306e\u30d1\u30fc\u30de\u30ea\u30f3\u30af", "Please activate JavaScript to enable the search\n functionality.": "\u691c\u7d22\u6a5f\u80fd\u3092\u4f7f\u3046\u306b\u306f JavaScript \u3092\u6709\u52b9\u306b\u3057\u3066\u304f\u3060\u3055\u3044\u3002", "Preparing search...": "\u691c\u7d22\u3092\u6e96\u5099\u3057\u3066\u3044\u307e\u3059...", "Previous topic": "\u524d\u306e\u30c8\u30d4\u30c3\u30af\u3078", "Quick search": "\u30af\u30a4\u30c3\u30af\u691c\u7d22", "Search": "\u691c\u7d22", "Search Page": "\u691c\u7d22\u30da\u30fc\u30b8", "Search Results": "\u691c\u7d22\u7d50\u679c", "Search finished, found %s page(s) matching the search query.": "\u691c\u7d22\u304c\u5b8c\u4e86\u3057\u3001 %s \u30da\u30fc\u30b8\u898b\u3064\u3051\u307e\u3057\u305f\u3002", "Search within %(docstitle)s": "%(docstitle)s \u5185\u3092\u691c\u7d22", "Searching": "\u691c\u7d22\u4e2d", "Searching for multiple words only shows matches that contain\n all words.": "\u8907\u6570\u306e\u5358\u8a9e\u3092\u691c\u7d22\u3059\u308b\u3068\u3001\u6b21\u3092\u542b\u3080\u4e00\u81f4\u306e\u307f\u304c\u8868\u793a\u3055\u308c\u307e\u3059\n \u00a0\u00a0\u00a0 \u3059\u3079\u3066\u306e\u7528\u8a9e\u3002", "Show Source": "\u30bd\u30fc\u30b9\u30b3\u30fc\u30c9\u3092\u8868\u793a", "Table of Contents": "\u76ee\u6b21", "This Page": "\u3053\u306e\u30da\u30fc\u30b8", "Welcome! This is": "Welcome! This is", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "\u691c\u7d22\u3057\u305f\u6587\u5b57\u5217\u306f\u3069\u306e\u6587\u66f8\u306b\u3082\u898b\u3064\u304b\u308a\u307e\u305b\u3093\u3067\u3057\u305f\u3002\u3059\u3079\u3066\u306e\u5358\u8a9e\u304c\u6b63\u78ba\u306b\u8a18\u8ff0\u3055\u308c\u3066\u3044\u308b\u304b\u3001\u3042\u308b\u3044\u306f\u3001\u5341\u5206\u306a\u30ab\u30c6\u30b4\u30ea\u30fc\u304c\u9078\u629e\u3055\u308c\u3066\u3044\u308b\u304b\u78ba\u8a8d\u3057\u3066\u304f\u3060\u3055\u3044\u3002", "all functions, classes, terms": "\u95a2\u6570\u3001\u30af\u30e9\u30b9\u304a\u3088\u3073\u7528\u8a9e\u7dcf\u89a7", "can be huge": "\u5927\u304d\u3044\u5834\u5408\u304c\u3042\u308b\u306e\u3067\u6ce8\u610f", "last updated": "\u6700\u7d42\u66f4\u65b0", "lists all sections and subsections": "\u7ae0\uff0f\u7bc0\u4e00\u89a7", "next chapter": "\u6b21\u306e\u7ae0\u3078", "previous chapter": "\u524d\u306e\u7ae0\u3078", "quick access to all modules": "\u5168\u30e2\u30b8\u30e5\u30fc\u30eb\u65e9\u898b\u8868", "search": "\u691c\u7d22", "search this documentation": "\u30c9\u30ad\u30e5\u30e1\u30f3\u30c8\u3092\u691c\u7d22", "the documentation for": "the documentation for" }, "plural_expr": "0" });�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ja/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000233210�00000000000�021131� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������\+����]+�����,��E��-��r���/��l���/�� ���/�����0��*��� 0��=���70��7���u0��H���0��?���0��"���61�� ���Y1�����c1��%���l1�����1�����1�����1�����1�����1�����1�� ��� 2�� ���2�����"2�����62�����M2�����^2�� ���m2�����2�� ���2�� ���2�� ���2��S���2�����+3��A���B3�����3�����3�����3�����3�����3�� ���3�����4��6���4�����L4�����l4��$���4�����4��3���g5�� ���5�����5�����5��1���5��1���5��G���6�����a6�����y6��0���6�����6��H���6�����"7��b���7�����8��6���38�����j8�� ���8�� ���8�� ���8�����8�����8��>���8�� ��� 9��(���9��(���?9�����h9��?���9�����9�� ���9��!���9��8����:��%���9:�����_:�����g:��4���}:�� ���:�� ���:�����:�����:����� ;�����-;�� ���6;��%���@;��%���f;�����;��:���;��7���;�����<��"���4<�����W<�����i<�� ���p<�����{<�����<��`���<�����=��&���$=�����K=��D���Q=��H���=��K���=�����+>�����D>�����L>��5���U>�����>�����>�����>��8���>��=���>��1���7?��'���i?��"���?��3���?��"���?��#��� @�����/@��!���7@��:���Y@�����@�� ���@�� ���@�����@�����A�� ���A�����A�����A��C���A������B�����B��3��B��.���MC�� ���|C��.���C�����C�����C�����C��D���C�����,D�����@D�� ���+E�����8E��[���LE�����E�����E�����E��Y���E��!���PF�����rF��2���F�� ���F��C���F�����G��n���$G��E���G�� ���G�����G�� ���G�� ���H��-���H��(���=H�� ���fH�����qH�� ���H��(���H�����H�����H�����H��Z���H�����AI�����GI��,���OI����|I�����J�����J�� ���J��(���J�����J�����J�� ���K�����K�����1K�����NK�����iK�����K�����K�����K��&���K��B���K��i���8L��2���L��I���L��4���M�����TM�����tM�����M�����M��y���M�����>N�����RN�����aN�����wN�� ���N�����N�����N�����N��#���N��$���N�����O�� ���%O�����2O�����9O�� ���JO�����UO�� ���]O�����iO�����qO�����O�����O�����O�� ���O�����O��<���O�����P�� ���4P��K���>P�� ���P�����P�����P�����P��+���P�� ���P��>���P�����=Q��#���PQ�����tQ�����Q�����Q�����Q�����Q�����Q��Y���Q��Z���,R��*���R��3���R��/���R��(���S��.���?S��P���nS��p���S�����0T��!���PT��"���rT��$���T�� ���T��e���T��Z���AU��N���U��T���U��K���@V��%���V�����V��[���V��#���.W��'���RW��#���zW��I���W��'���W��!���X��=���2X��7���pX�� ���X��d���X��W���Y��v���oY�����Y�����Y�����Y�� ���Y��3���Z�����KZ�����bZ��"���~Z��7���Z��<���Z��Y���[�� ���p[�����z[�����[��,���[�����[�����[�����[�����[��Y���\�����]��%���]��,���]�����]�����^�� ���^�����^�� ���^�����(^�����0^��N���9^�����^��?���_��-���T_��2���_�����_�����_�����_��9���_�����1`�� ���L`�� ���V`��X���c`��,���`��2���`��b���a��5���a��\���a��M���b��(���`b��G���b�����b��7���b�����c��8���4c�����mc�� ���c��%���c��`���c�����d�����3d�����Rd�����bd�����rd�� ���d��&���d��$���d�����d�����d�����e�����/e�����De��A���de��Z���e��-���f�����/f�����Nf�����kf��!���f��8���f�����f�� ���f�����f�����g��7��� g��6���Bg��;���yg��I���g��;���g��:���;h��H���vh��9���h��G���h��2���Ai��2���ti�����i��4���i�����i�����j�����j��C���6j��2���zj�����j�����j�����j�����k�����k�����:k�����Nk�����ak�����yk��(���k��=���k�����k�����l��0���l�����Gl�����Ll��/���fl�����l��*���l��&���l�� ���m��9��� m�����Gm�����Xm�� ���vm�����m��-���m�����m�����m��1��� n��*���;n�����fn�����|n��0���n��&���n�����n�����n��(���o�����8o�����Ho�����eo��%���o��e���o�����p��4���p�����p�����p��Y���p��;���Tq��.���q�����q�����q�����q��.���r��4���Ar��+���vr��4���r��(���r��4����s��W���5s�����s�����s�����s��X���s��J���5t�����t��%���t�� ���t�����t�����t��+���t�����u�����*u�� ���Ju��8���Tu��M���u��u���u�����Qv�����cv�����vv�����}v�����v��A���v�� ���v�����v��6���w��I���Sw��A���w�����w��0���w�����+x��G���Bx��N���x�����x�����x��.���x�����!y��4���4y�� ���iy��,���wy��3���y�� ���y��=���y�����$z��'���Az��0���iz��(���z��1���z��,���z��!���"{�����D{�����c{�����{��=���{��+���{��0���|��V���5|��V���|��M���|��R���1}��$���}�����}�����}��N���}��0���~��)���C~�����m~�����~�����~��/���~�����~����������'��&���>��!���e��&����������E����� �����*��� ��7���4��"���l��(�������������Ԁ������������"���,�����O�����U�����m��&�����;���������������"�����!��������8��#���?�����c��D���k��5����� ���������� �����1�����E���5��B���{��G�����%��������,��#���F��#���j��,����������-���ׄ��(�����D���.�� ���s��#���~��(�����#���˅�����������������(��������7�����P��8���U�� �����P�����"���������#�����>��O���W���������������Ї�����ه��%����� ����������,���-�� ���Z��(���g��E����� ���ֈ��*����������1�����7���I������� ������������������щ��������������� ��&��������E�����]��4���b�������%��������Ҋ��c���ي�����=�����W�� ���^��'���j��:����� ���͋��@��������/�����7�����T��&���g��*�����&�����W�����>���8��7���w��K����� ����� ���������� �����,���$��*���Q��0���|�������%���ˎ������������1���!��1���S�������\����������'�����%���<��+���b��^�����2�����5��� �����V�����u�������5��������ʒ�������+�����-��������F��!���b��!����������!��������ޓ�������#�����*���"�����M�����V�����i��P��������є��)�����9�����;���T��)�������������•��&���Օ���������������.�����J�����`�����}���������������Ö�����ۖ����������H�����������������؞�� ����������2�����Y�����P���G��t�����[��� ��"���i������������D�����$�����'���"�����J�����P�����i�����{�� ����� �������������Ǣ�����ߢ�������)��������9�����Q�����f��(���u�������'���#��p���K��0�����"�������������*�����J�����d�����u��6��������ƥ��5�����@��������]��2���.�� ���a�����m�����u��O���{��O���˧�������+��������˨��B���ި��!���!��M���C����������i��$�����S�����*���l��G��������߫�����������������^��������n��I�����=���Ϭ��1��� ��Q���?�� ����������5�����I�����A���7�����y�������>�����-���ܮ����� ������� ���;��(���H�����q�� �����<�����<���ȯ��"�����{���(��b�����+�����A���3��+���u������� ����������4���ұ������������B���˲�� �����Z��������s��g�����4���\�� ����� �����L������������������-��P���C��\�����L�����7���>��?���v��S�����D��� ��9���O�������F�����B���׷��.�����/���I�����y������� ���f�� ���p�����}�������u���������� ���)��i��3��K����������O��������@�����G�����^��S���q�����ż����ټ������������m���þ�����1��%���Q�����w������������!���7��e���Y�� �����f�����2���3�����f��o��������d�����z������������3�����K��������G�����]�����z��Z�����'�������������/��w���6������������g�������$�����������������K��������O�� ���V�����w��'�����$�����$�����0�����$���*��*���O��$���z��Z�����H��������C��V��������"��m�����0�����0���B��0���s��!����������!���m�������*���������������!�����$���$��$���I��0���n��$������������������������������ ��������+�� ���;��$���E�����j����������������� �����7���������� �����o��������������������"�����P��������%��u���A��*�����1�������������*��0���1�����b�����i��!���p��{�����w�����5�����K�����K�����3���T��?�����e��������.��-�����,�����0���#��2���T��.�������������R��~�����~���S��s�����5���F��/���|�������9���-��:���g��(�����i�����5���5��7���k��G�����A��������-�����=��g��������0������� ����������4�����A��������Y��(���v��6�����U�����Z���,��������������������&��I���-�����w��4���������������n��������-��;�����-���K��#���y������������ ����� ���������� �������������v��p�����?�����D�����'��� �����5�����O��d���n��7����� ��� �� �����n�����;�����P����������a�����r���6��r�����>�����s���[��'�����U��������M��U���g������� �����?��������$��0�����4�������������$�����8��$���K��P���p��A�����9�����5���=��1���s��(�����,�����9�����v���5��X�����2�����6���8�����o��0�����X����� ����������$���5�����Z��9���j��A�����=�����_���$��=�����E�����]�����D���f��\�����A�����4���J�������=�����$���������������g���0��C�����1�����(�����5���7��0���m��0����� ����������'��� ��!���2��:���T��c���������������O���*�� ���z��7�����F�����!�����,���%��F���R�������j�����$�����<���?��<���|�������<�����!��� �����/��B���J��I���������������U�����B���N�������9�����T��������9��4���O��4�����$������������c��N���w�����������������O���m��;�����:�����.���4��'���c��?�����8�����2����8���7�5���p�>��������.���n�����!����y����~���U� ����7���� ���� ���!����.�I���?�(����%��������T����^���4��������*����@����V�?���i�-����d���� ���<�*���G�X���r�|����s���H�/����;�������( ����A �q��� � ���A ����K �H���g ���� �l��� ����0 �'���C �<���k ���� �Y��� �<��� �+���R �4���~ �,��� �5��� �T��� �4���k �2��� �.��� �,����\���/�K����M����a���&�e����[����a���J�'��������%����Z����L���\�=��������.����-���3�I���a����� ����;����A���$�$���f�6��������w���� ���J�/���W�E��������;����0����6���J�#����(����4���� ����3����!���D�5���f�N�������� ����E��� �5���Q�����A��������~����G���h��������� ����R����d���'�^����f����D���R�1����E����'����N���7�3����A����V����Z���S�����$����:����3���-����a� ���t����~�-����*���� ����U����%���J�k���p�3����-����'���>�g���f�����$������� � ��� �?���# � ���c ����p �`��� ���� �D���!����K!� ���!�[���!����?"�Q���O"�c���"����#����!#�!���1#����S#����q#�'���#����#�!���#�,���#�!���$� ���9$�R���C$�0���$�<���$����%�f��� %����r%� ���%� ���%�N���%�1���%�6���'&�_���^&����&�3���&�*��� '�=���6'�7���t'�5���'�~���'�V���a(�E���(�n���(����m)����q)����)����)�'���)�'���)�.���)�7���*�E���L*����*����x+�D���^,�D���,����,�r���,�4���q-�3���-�1���-�M��� .����Z.�P���.�S���,/�8���/�!���/����/�M���/�"���90����\0�0���b0�@���0�3���0�L���1�,���U1����1�R���1����1����2�1���%2�D���W2����2�$���2�-���2�o���2�(���f3�J���3�P���3�z���+4�B���4����4�%���4�,���5����L5����k5�!���5����5�+���5����5����6� ���56�'���B6����j6�� Generate ReStructuredText using autosummary directives. sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates the reStructuredText files from the autosummary directives contained in the given input files. The format of the autosummary directive is documented in the ``sphinx.ext.autosummary`` Python module and can be read using:: pydoc sphinx.ext.autosummary � Generate required files for a Sphinx project. sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build. � Look recursively in <MODULE_PATH> for Python modules and packages and create one reST file with automodule directives per package in the <OUTPUT_PATH>. The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be excluded from generation. Note: By default this script will not overwrite already created files.� Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� Run 'make' in that directory to run these through makeinfo (use 'make info' here to do that automatically).� (deprecated)� (in �"::" in automodule name doesn't make sense�"latex_documents" config value references unknown document %s�"man_pages" config value references unknown document %s�"quiet" is specified, but any of "project" or "author" is not specified.�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%r doesn't have "%s" setting�%r doesn't have "theme" setting�%s %s�%s %s documentation�%s (%s attribute)�%s (%s property)�%s (C %s)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command %r cannot be run (needed for math display), check the imgmath_%s setting�%s command line option�%s is already assigned section numbers (nested numbered toctree?)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �-A option argument must be in the form name=value�-D option argument must be in the form name=value�4 column based index found. It might be a bug of extensions you use: %r�:%s: (directive option)�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�====================== slowest reading durations =======================�A Makefile and a Windows command file can be generated for you so that you only have to run e.g. `make html' instead of invoking sphinx-build directly.�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�About these documents�An error happened in rendering the page %s. Reason: %r�Anchor '%s' not found�Any IDs not assigned for %s node�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not fetch remote image: %s [%d]�Could not fetch remote image: %s [%s]�Could not import extension %s�Could not lex literal_block as "%s". Highlighting skipped.�Could not obtain image size. :scale: option is ignored.�Create Makefile? (y/n)�Create Windows command file? (y/n)�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Encoding error:�Enter the root path for documentation.�Error�Error: an existing conf.py has been found in the selected root path.�Error: specified path is not a directory, or sphinx files already exist.�Error: the master file %s has already been found in the selected root path.�Event %r already present�Example�Examples�Exception occurred while building, starting debugger:�Exception occurred:�Expand sidebar�Extension options�External Graphviz file %r not found or reading it failed�Failed to compile regex in linkcheck_allowed_redirects: %r %s�Failed to copy a file in html_static_file: %s: %r�Failed to parse type_comment for %r: %s�Failed to read build info file: %r�Failed to read intersphinx_mapping[%s], ignored: %r�Failed to scan documents in %s: %r�Failed to write build info file: %r�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnote [#] is not referenced.�Footnote [%s] is not referenced.�Footnotes�For security reasons, parallel mode is disabled on macOS and python3.8 and above. For more details, please read https://github.com/sphinx-doc/sphinx/issues/6803�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Hide Search Matches�Hint�If the documents are to be written in a language other than English, you can select a language here by its language code. Sphinx will then translate text that it generates into that language. For a list of supported codes, see https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indicate which of the following Sphinx extensions should be enabled:�Indices and tables:�Inside the root directory, two more directories will be created; "_templates" for custom HTML templates and "_static" for custom stylesheets and other static files. You can enter another prefix (such as ".") to replace the underscore.�Interrupted!�Invalid caption: %s�Invalid date format. Quote the string by single quote if you want to output it directly: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�Keyword Arguments�LaTeX command %r cannot be run (needed for math display), check the imgmath_latex setting�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Look for any errors in the above output or in %(outdir)s/output.txt�Makefile and Batchfile creation�Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Many math_renderers are registered. But no math_renderer is selected.�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Non-alphabetical�Note�Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.�Notes�Numbers�Object named %r not found in include file %r�One document is special in that it is considered the top node of the "contents tree", that is, it is the root of the hierarchical structure of the documents. Normally, this is "index", but if your "index" document is a custom template, you can also set this to another filename.�Original exception: �Other Parameters�Other changes�Output directory (%s) is not a directory�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Pillow not found - copying image files�Please activate JavaScript to enable the search functionality.�Please also report this if it was a user error, so that a better error message can be provided next time.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter a new file name, or rename the existing file and press Enter�Please enter a new root path (or just Enter to exit)�Please enter a valid path name.�Please enter either 'y' or 'n'.�Please enter one of %s.�Please enter some text.�Please enter values for the following settings (just press Enter to accept a default value, if one is given in brackets).�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project templating�Project version�Pygments lexer name %r is not known�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Recursion error:�References�Release�Return type�Returns�Root path for the documentation�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Searching for multiple words only shows matches that contain all words.�Section %s�Section author: �See also�Selected root path: %s�Separate source and build directories (y/n)�Show Source�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Structure options�Symbols�TODO entry found: %s�Table %s�Table of Contents�Template Parameters�Testing of coverage in the sources finished, look at the results in %(outdir)spython.txt.�Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt.�The %r crossref_type is already registered�The %r directive is already registered to domain %s�The %r index is already registered to domain %s�The %r object_type is already registered�The %r role is already registered to domain %s�The %s extension is required by needs_extensions settings, but it is not loaded.�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.�The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.�The config value `{name}' has type `{current.__name__}'; expected {permitted}.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The dummy builder generates no files.�The ePub file is in %(outdir)s.�The full traceback has been saved in %s, if you want to report the issue to the developers.�The manual pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�The overview file is in %(outdir)s.�The project name will occur in several places in the built documentation.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Translator for %r already exists�Unknown configure key: latex_elements[%r], ignored.�Unknown event name: %s�Unknown image format: %s...�Unknown math_renderer %r is given.�Unknown theme option: latex_theme_options[%r], ignored.�Use the Makefile to build the docs, like so: make builder�Use the sphinx-build command to build the docs, like so: sphinx-build -b builder %s %s�Variables�Warning�Warns�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�Would create file %s.�Yields�You have two options for placing the build directory for Sphinx output. Either, you use a directory "_build" within the root path, or you separate "source" and "build" directories within the root path.�You should now populate your master file %s and create other documentation source files. �Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[autosummary] failed to import %r: %s�[autosummary] generating autosummary for: %s�[autosummary] writing to %s�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.�a list of specific files to rebuild. Ignored if -a is specified�a suitable image for %s builder not found: %s�a suitable image for %s builder not found: %s (%s)�all functions, classes, terms�all of %d po files�all source files�append module_path to sys.path, used when --full is given�assembling single document�attribute�author names�autodoc: failed to determine %r to be documented, the following exception was raised: %s�automatically insert docstrings from modules�automatically test code snippets in doctest blocks�autosummary generats .rst files internally. But your source_suffix does not contain .rst. Skipped.�autosummary references excluded document %r. Ignored.�autosummary: failed to determine %r to be documented, the following exception was raised: %s�autosummary: stub file not found %r. Check your autosummary_generate setting.�autosummary_generate: file not found: %s�both tabularcolumns and :widths: option are given. :widths: is ignored.�broken link: %s (%s)�build %s, %s warning (with warnings treated as errors).�build %s, %s warning.�build %s, %s warnings (with warnings treated as errors).�build %s, %s warnings.�build %s.�build environment version not current�build in parallel with N processes where possible (special value "auto" will set N to cpu-count)�build info file is broken: %r�builder to use (default: html)�building [%s]: �building [mo]: �built-in function�can be huge�cannot combine -a option and filenames�cannot copy downloadable file %r: %s�cannot copy extra file %r�cannot copy image file %r: %s�cannot copy static file %r�cannot find files %r�cannot open warning file %r: %s�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�cannot read image file %r: copying it instead�cannot write image file %r: %s�caption not inside a figure.�checking consistency�checks for documentation coverage�circular toctree references detected, ignoring: %s <- %s�class�class method�command line option�concept�conditional inclusion of content based on config values�conf value "epub_author" should not be empty for EPUB3�conf value "epub_contributor" should not be empty for EPUB3�conf value "epub_copyright" (or "copyright")should not be empty for EPUB3�conf value "epub_description" should not be empty for EPUB3�conf value "epub_identifier" should not be empty for EPUB3�conf value "epub_language" (or "language") should not be empty for EPUB3�conf value "epub_publisher" should not be empty for EPUB3�conf value "epub_title" (or "html_title") should not be empty for EPUB3�conf value "epub_uid" should be XML NAME for EPUB3�conf value "version" should not be empty for EPUB3�config changed�config directory doesn't contain a conf.py file (%s)�console output options�continued from previous page�continues on next page�convert command %r cannot be run, check the image_converter setting�convert exited with error: [stderr] %r [stdout] %r�copying TeX support files�copying TeX support files...�copying Texinfo support files�copying additional files�copying downloadable files... �copying extra files�copying images... �copying source files...�copying static files�could not read %r for changelog creation�create .nojekyll file to publish the document on GitHub pages�create batchfile�create makefile�custom template directory (default: %(default)s)�data�default role %s not found�default suffix for files (default: %(default)s)�define a template variable�define tag: include "only" blocks with TAG�dimension unit %s is invalid. Ignored.�directive�directive %r is already registered, it will be overridden�directive-option�directory to place all output�directory to place all output in�display latex %r: %s�do emit colored output (default: auto-detect)�do not create batchfile�do not create makefile�do not emit colored output (default: auto-detect)�do not use make-mode for Makefile/make.bat�docnames to write: %s�document�document imported members (default: %(default)s)�document isn't included in any toctree�document language�document not readable. Ignored.�document title is not a single Text node�doing serial %s�domain %s already registered�domain %s not yet registered�don't create a table of contents file�don't create headings for the module/package packages (e.g. when the docstrings already contain them)�don't know which module to import for autodocumenting %r (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)�don't use a saved environment, always read all files�done�dot code %r: %s�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�dot did not produce an output file: [stderr] %r [stdout] %r�dot exited with error: [stderr] %r [stdout] %r�download file not readable: %s�dumping object inventory�dumping search index in %s�duplicate %s description of %s, other %s in %s�duplicate %s description of %s, other instance in %s�duplicate citation %s, other instance in %s�duplicate description of %s %s, other instance in %s�duplicate label %s, other instance in %s�duplicate label of equation %s, other instance in %s�duplicate object description of %s, other instance in %s, use :noindex: for one of them�duplicated ToC entry found: %s�enable %s extension�enable arbitrary extensions�encountered some issues with some of the inventories, but they had working alternatives:�encountered title node not in section, topic, table, admonition or sidebar�enum�enumerable_node %r already registered�enumerator�environment variable�environment variable; %s�error while formatting arguments for %s: %s�error writing file %s: %s�error writing file Makefile: %s�exception�exception while evaluating only directive expression: %s�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extension options�extensions changed�failed�failed to import object %s�failed to parse name %s�failed to reach any of the inventories with the following issues:�failed: %s�favicon file %r does not exist�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�filename of table of contents (default: modules)�finished with problems�fnmatch-style file and/or directory patterns to exclude from generation�follow symbolic links. Powerful when combined with collective.recipe.omelette.�function�general options�generate a full project with sphinx-quickstart�generating indices�glossary seems to be misformatted, check indentation�glossary term�glossary term must be preceded by empty line�glossary terms must not be separated by empty lines�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�highlighting module code... �html_extra_path entry %r does not exist�html_extra_path entry %r is placed inside outdir�html_static_path entry %r does not exist�html_static_path entry %r is placed inside outdir�if specified, separate source and build dirs�ignoring invalid doctest code: %r�image file %s not readable: %s�image file not readable: %s�include "_private" modules�include links to the source code of documented Python objects�include math, rendered as PNG or SVG images�include math, rendered in the browser by MathJax�inconsistent citation references in translated message. original: {0}, translated: {1}�inconsistent footnote references in translated message. original: {0}, translated: {1}�inconsistent references in translated message. original: {0}, translated: {1}�inconsistent term references in translated message. original: {0}, translated: {1}�increase verbosity (can be repeated)�index�inline latex %r: %s�interpret module paths according to PEP-0420 implicit namespaces specification�intersphinx identifier %r is not string. Ignored�intersphinx inventory has moved: %s -> %s�invalid TestCode type�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�invalid regex %r in %s�invalid regex %r in coverage_c_regexes�invalid signature for auto%s (%r)�job number should be a positive number�keyword�kwargs for add_node() must be a (visit, depart) function tuple: %r=%r�last updated�line number spec is out of range(1-%d): %r�link between Sphinx documentation of different projects�lists all sections and subsections�loading intersphinx inventory from %s...�loading pickled environment�loading translations [%s]... �locale_dir %s does not exists�logo file %r does not exist�looking for now-outdated files... �macro�making output directory�master document name�math renderer %s is already registered�maximum depth of submodules to show in the TOC (default: 4)�member�method�missing '+' or '-' in '%s' option.�missing attribute %s in object %s�module�module %s could not be imported: %s�modules�more than one target found for 'any' cross-reference %r: could be %s�more than one target found for cross-reference %r: %s�new config�next�next chapter�nit-picky mode, warn about all missing references�no "latex_documents" config value found; no documents will be written�no "man_pages" config value found; no manual pages will be written�no "texinfo_documents" config value found; no documents will be written�no Babel option known for language %r�no changes in version %s.�no code/output in %s block at %s:%s�no output at all, not even warnings�no output on stdout, just warnings on stderr�no targets are out of date.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�none found�not available for built-in messages�numfig is disabled. :numref: is ignored.�numfig_format is not defined for %s�object�operator�original entry�override a setting in configuration file�overwrite existing files�page�page %s matches two patterns in html_sidebars: %r and %r�pass a value into HTML templates�path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)�path to documentation source files�path to module to document�path to output directory�path where configuration file (conf.py) is located (default: same as SOURCEDIR)�pickling environment�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�program option�project author(s), used when --full is given�project name�project name (default: root module name)�project release, used when --full is given, defaults to --doc-version�project root�project version, used when --full is given�property�put documentation for each module on its own page�put module documentation before submodule documentation�quick access to all modules�quiet mode�reST markup error:�reading error: %s, %s�reading sources... �reading templates... �reference label�release of project�replacement for dot in _templates etc.�resolving references...�role�role %r is already registered, it will be overridden�run Pdb on exception�run the script without creating files�search�search index couldn't be loaded, but not all documents will be built: the index will be incomplete.�search this documentation�see %s�see also %s�self referenced toctree found. Ignored.�setting %s.%s occurs in none of the searched theme configs�show full traceback on exception�signature arguments or return annotation given for automodule %s�skipped�source directory has changed�source file suffix�source files to generate rST files for�source_parser for %r is already registered�source_suffix %r is already registered�sphinx-quickstart only generate into a empty directory. Please specify a new root path.�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0�statement�static method�struct�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�targets for %d template files�template directory for template files�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension is not safe for parallel reading�the %s extension is not safe for parallel writing�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�toctree contains ref to nonexisting file %r�toctree contains reference to document %r that doesn't have a title: no link will be generated�toctree contains reference to excluded document %r�toctree contains reference to nonexisting document %r�too large :maxdepth:, ignored.�turn warnings into errors�type�undecodable source characters, replacing with "?": %r�unimplemented node type: %r�union�unknown %r toplevel_sectioning for class %r�unknown config value %r in override, ignoring�unknown index entry type %r�unknown index entry type %s found�unknown mimetype for %s, ignoring�unknown node type: %r�unsupported theme option %r given�updating environment: �use epub�use make-mode for Makefile/make.bat�use no config file at all, only -D options�variable�version of project�waiting for workers...�where "builder" is one of the supported builders, e.g. html, latex or linkcheck.�while setting up extension %s:�with -W, keep going when getting warnings�write "todo" entries that can be shown or hidden on build�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing�writing %s file...�writing META-INF/container.xml file...�writing additional files�writing additional pages�writing content.opf file...�writing error: %s, %s�writing message catalogs... �writing mimetype file...�writing nav.xhtml file...�writing output... �writing summary file...�writing toc.ncx file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: ja Language-Team: Japanese (http://www.transifex.com/sphinx-doc/sphinx-1/language/ja/) Plural-Forms: nplurals=1; plural=0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � autosummary ディレクティブを使って ReStructuredText を生成します。 sphinx-autogen は sphinx.ext.autosummary.generate のフロントエンドです。 入力されたファイルを含む autosummary ディレクティブから reStructuredText ファイルを 生成します。 autosummary ディレクティブのフォーマットは ``sphinx.ext.autosummary`` に記載されています。Pythonモジュールと :: を使って読むことができます。 pydoc sphinx.ext.autosummary � Sphinx プロジェクトに必要なファイルを生成します。 sphinx-quickstart は、いくつかの質問であなたの プロジェクトを生成するためのディレクトリと、sphinx-build と一緒に使える サンプルのMakefileを作成してくれるインタラクティブなツールです。 � <MODULE_PATH> 内を再帰的に調べてPython のモジュールとパッケージ、 後は1つのreST ファイルを <OUTPUT_PATH> 内にあるパッケージ毎の automodule ディレクティブに作成します。 <EXCLUDE_PATTERN> は、ファイル、またはディレクトリ、または両方のパターンを 生成処理から除外することができます。 注：デフォルトでは、このスクリプトはすでに作成されているファイルを上書きしません。� (pdf)latex コマンドで処理するために、そのディレクトリで 'make' を実行してください。 （これを自動的に行うには、ここで 'make latexpdf' を使用してください）。� makeinfo コマンドで処理するため、そのディレクトリで 'make' を実行してください。 （これを自動的に行うには、ここで 'make info' を使用してください）。� (非推奨)� (in �automodule 名の "::" は意味がありません�設定値 "latex_documents" は、不明なドキュメント %s を参照しています�設定値 "man_pages" が不明なドキュメント %s を参照しています�"quiet" が指定されていますが、 "project" または "author" のいずれも指定されていません。�設定値 "texinfo_documents" は、不明なドキュメント %s を参照しています�%(filename)s — %(docstitle)s�%Y年%m月%d日�%d 件見つかりました�コマンドラインで指定された%d件のソースファイル�%r に "%s" 設定がありません�%r に "theme" 設定がありません�%s %s�%s %s ドキュメント�%s (%s の属性)�%s (%s のプロパティ)�%s (C %s)�%s (C++ %s)�%s (組み込みクラス)�%s (組み込み変数)�%s (%s のクラス)�%s (ディレクティブ)�%s (グローバル変数または定数)�%s (%s モジュール)�%s (モジュール)�%s (ロール)�%s 件追加, %s 件更新, %s 件削除�%s コマンド %r を実行できません (数式表示のために必要です)。imgmath_%s の設定を確認してください�%s コマンドラインオプション�%s はすでにセクション番号が割り当てられています (入れ子になった番号の toctree ?)�%s はディレクトリではありません。�%s() (%s のクラスメソッド)�%s() (%s のメソッド)�%s() (%s の静的メソッド)�%s() (組み込み関数)�%s() (クラス)�%s() (%s モジュール)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' は正しいオプションではありません�'%s' は正しい pyversion オプションではありません�conf.pyにある'setup'はPythonのcallableではありません。定義を修正してcallableである関数にしてください。これはconf.pyがSphinx拡張として動作するのに必要です。�(<<original entry>> は、 %s の %d 行目です)�(in %s v%s)�(in %s)�, in �-Aオプション引数は name = value の形式でなければなりません�-Dオプション引数は name = value の形式でなければなりません�4列ベースのインデックスが見つかりました。あなたが使っている拡張子のバグかもしれません: %r�:%s: (ディレクティブオプション)�<<original entry>>�<h1>全モジュールのうち、コードを読めるもの</h1>�<h1>%s のソースコード</h1>�====================== 最も遅い読み取り時間 =======================�Makefile と Windows コマンドファイルは生成することができるので、 後は実行するだけです。例えば、直接 sphinx-build を実行する代わりに `make html` を 実行します。�バグ報告はこちらにお願いします <https://github.com/sphinx-doc/sphinx/issues> 。ご協力ありがとうございます！�このドキュメントについて�%sページのレンダリング中にエラーが発生しました。 理由: %r �アンカー '%s' が見つかりません�いくつかの ID が %s ノードに割り当てられていません�引数�注意�著者名（複数可）�作者: �バージョン %(version)s の変更点（このリストは自動生成されています）�ベースクラス: %s�ビルダー %r (モジュール %s) がすでに登録されています�ビルダークラス %s には"name"属性がありません�ビルダー名 %s は登録されていません�ビルダー名 %s は登録されておらず、entry pointにもありません�組み込み�C API に関する変更�ソースディレクトリが存在しません (%s)� "lineno-match" は不連続な "lines" に対して使用できません�"%s" と "%s" のオプションは同時に使用できません�注意�バージョン %s で変更�バージョン %(version)s の変更点 — %(docstitle)s�引用 [%s] は参照されていません。�コードの作者: �サイドバーをたたむ�総合目次�設定値 %r は既に登録済みです�コンテンツ�著作権�リモート画像を取得できませんでした: %s [%d]�リモート画像を取得できませんでした: %s [%s]�拡張 %s をimportできません�リテラルブロックを "%s" として解釈できませんでした。ハイライト処理をスキップします。�画像サイズを取得できませんでした。:scale: オプションは無視されます。�Makefile を作成しますか？ （y/n）�Windows コマンドファイルを作成しますか？（y/n）�ファイル %s を作成しています。�危険�非推奨�バージョン %s で非推奨�ドメイン %r はまだ登録されていません�エンコーディング %r はインクルードファイル %r の読み込みに適さないようです。:encoding: オプションを追加してみてください�エンコードエラー:�ドキュメントのルートパスを入力してください。�エラー�エラー：選択されたルートパスに既存の conf.py が見つかりました。�エラー：指定されたパスはディレクトリではないか、または sphinx ファイルが既に存在します。�エラー：マスタファイル %s は、選択されたルートパス上で既に存在します。�イベント %r はすでに登録されています�サンプル�サンプル�ビルド中に例外が発生しました。デバッガを起動します:�例外が発生しました�サイドバーを展開�拡張オプション�外部の Graphviz ファイル %r が見つからないか読み込めません�linkcheck_allowed_redirects 内の正規表現のコンパイルに失敗しました: %r %s�html_static_file 内のファイルのコピーに失敗しました: %s: %r�%rのtype_commentを解析できませんでした: %s�build info ファイルの読み込みに失敗しました: %r�intersphinx_mapping [%s] の読み取りに失敗しました。無視します: %r�%s のドキュメントをスキャンできませんでした: %r �build info ファイル %r の出力に失敗しました�図 %s�ファイル %s は既に存在しますのでスキップします。�終了：初期ディレクトリ構造が作成されました。�Footnote [#] は参照されていません。�Footnote [%s] は参照されていません。�注記�セキュリティ上の問題により、macOS で python3.8 以上をお使いの場合はパラレルモードは利用できません。詳しくは https://github.com/sphinx-doc/sphinx/issues/6803 をお読みください。�総索引�総合索引�モジュール総索引�検索�Graphviz ディレクティブはコンテンツとファイル名の両方の引数を持つことは出来ません�検索結果を隠す�ヒント�ドキュメントを英語以外の言語で書く場合は、 言語コードで言語を選択できます。Sphinx は生成したテキストをその言語に翻訳します。 サポートされているコードのリストについては、 https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language を参照してください。�コンテンツのない "graphviz" ディレクティブを無視します�重要�インクルードファイル %r が見つからないか読み込めません�索引�索引 – %(key)s�頭文字別索引�次の Sphinx 拡張機能のうちどれを有効にするかを指定します。�索引と表一覧:�プロジェクトのルートディレクトリに 2つ以上のディレクトリが作成されます。 カスタマイズしたHTMLテンプレート用の"_templates"ディレクトリと、カスタマイズしたスタイルシート等を置く"_static"ディレクトリがあります。 これらのディレクトリは "_" で始まっていますが、別の文字("."など)で始まるように指定できます。�割り込まれました！�不正な caption です: %s�日付形式が無効です。直接出力したい場合は、文字列を一重引用符で囲みます: %s�無効な math_eqref_format: %r�無効なテンプレート変数: %s�キーワード引数�LaTeX コマンド %r を実行できません (数式表示のために必要です)。imgmath_latex の設定を確認してください�最終更新: %(last_updated)s�ライブラリに関する変更�指定された %r に一致する行がインクルードファイル %r にありませんでした�リスト %s�上記の出力結果、または %(outdir)s /output.txt を見てエラーを確認してください�Makefileとbatファイルの生成オプション�不正なオプションの説明 %r は、"opt"、"-opt args"、"--opt args"、"/opt args" または "+opt args" のようになります。�複数の math_renderer が登録されています。しかし math_renderer は選択されていません。�モジュール索引�モジュールの作者: �モジュールコード�モジュールレベル�マスター文書の名前（拡張子を除く）�テンプレートと静的ディレクトリの名前プレフィックス�ナビゲーション�バージョン %s で追加�次のトピックへ�ビルダーが選択されていないので、デフォルトの html を使用します�%s という設定値はありません�アルファベット以外�注釈�注：imgmath と mathjax を同時に有効にすることはできません。 imgmath は未選択になります。�メモ�番号�%r という名前のオブジェクトがインクルードファイル %r 内に見つかりません�1つのドキュメントは、"コンテンツツリー"の最上位ノードと 見なされるという点で特別です。つまり、それはドキュメントにおける階層構造のルートである ということです。通常、これは "index" ですが、 "index" ドキュメントがカスタムテンプレートの場合、これを別のファイル名に設定することもできます。�元の例外: �その他のパラメータ�その他の変更�出力先ディレクトリ (%s) はディレクトリではありません�概要�概要: モジュールコード�パラメータ�このコードへのパーマリンク�この定義へのパーマリンク�この数式へのパーマリンク�このヘッドラインへのパーマリンク�この画像へのパーマリンク�このテーブルへのパーマリンク�この目次へのパーマリンク�Pillowがインストールされていません。代わりに画像をコピーします�検索機能を使うには JavaScript を有効にしてください。�次期バージョンでのエラーメッセージ改善のために、ユーザーエラーの場合にも報告してください。�ファイルの拡張子を入力してください。例: '.rst' または '.txt'。�新しいファイル名を入力するか、既存のファイルの名前を変更してEnterキーを押してください。�新しいルートパスを入力してください（または Enter を押すことで終了します）。�有効なパス名を入力してください。�'y' または 'n' を入力してください。�%sのいずれかを入力してください。 �何か入力してください。�以下の設定値を入力してください（Enter キーのみ押した場合、 かっこで囲まれた値をデフォルト値として受け入れます）。�検索を準備しています...�前のトピックへ�プロジェクトの基本オプション�プロジェクトの言語�プロジェクト名�プロジェクトのリリース�プロジェクトテンプレート�プロジェクトのバージョン�Pygments に %r というlexerがありません�Python Enhancement Proposals; PEP %s�Pythonモジュール索引�クイック検索�例外�再起呼び出しエラー:�参照�リリース�戻り値の型�戻り値�ドキュメントのルートパス�Sphinx v%s を実行中�検索�%(docstitle)s 内を検索�検索ページ�検索結果�検索が完了し、 %s ページ見つけました。�%(docstitle)s 内を検索�検索中�複数の単語を検索すると、次を含む一致のみが表示されます     すべての用語。�%s 章�この節の作者: �参考�選択されたルートパス: %s�ソースディレクトリとビルドディレクトリを分ける（y / n）�ソースコードを表示�出力先ディレクトリにはソースディレクトリと異なるディレクトリを指定してください�ソース・ファイルサフィックス�%s のsource_parserは登録されていません�構成オプション�記号�TODO エントリーが見つかりました: %s�表 %s�目次�テンプレートパラメータ�ソース内のカバレッジのテストが終了したら、%(outdir)spython.txt の結果を確認してください。�ソース内の doctests のテストが終了したら、%(outdir)s/output.txt の結果を確認してください。�classref_type %r はすでに登録されています�ディレクティブ %r は既に%sドメインに登録されています�インデックス %r はすでに%sドメインに登録されています�object_type %r はすでに登録されています�ロール %r は既にドメイン%sに登録されています�needs_extensions設定で %s 拡張が要求されていますが、その拡張がありません。�このプロジェクトで使われている拡張 %s はSphinx v%s 以降が必要なため、現在のバージョンではビルドできません。�HTML ページは%(outdir)sにあります。�HTMLページは%(outdir)sにあります。�LaTeXファイルは%(outdir)sにあります。�Texinfoファイルは%(outdir)sにあります。�XMLファイルは%(outdir)sにあります。�設定値 `source_suffix' に `%r' が指定されましたが、文字列、文字列のリスト、辞書、のいずれかを指定してください。�設定値 `{name}' に `{current.__name__}' 型が指定されています。デフォルト値は `{default.__name__}' です。�設定値 `{name}' に `{current.__name__}' 型が指定されていますが、 {permitted} 型を指定してください。� 設定値 `{name}` に `{current}` が指定されましたが、 {candidates} のいずれかを指定してください。�設定ファイル（あるいはインポートしたどれかのモジュール）がsys.exit()を呼びました�dummyビルダーはファイルを出力しません�ePubファイルは%(outdir)sにあります。�完全なトレースバックを%sに保存しました。問題を開発者に報告するときに添付してください。�マニュアルページは %(outdir)s にあります。�メッセージカタログは%(outdir)sにあります。�ファイルは%(outdir)sにあります�プロジェクト名は、ビルドされたドキュメントのいくつかの場所にあります。�pseudo-XMLファイルは%(outdir)sにあります。�テキストファイルは%(outdir)sにあります。�設定ファイルにプログラム上のエラーがあります: %s�設定ファイルに文法エラーが見つかりました: %s �このページ�この環境は選択したビルダーと互換性がありません。別の doctree ディレクトリーを選択してください。�このプロジェクトはSphinx v%s以降のバージョンでなければビルドできません。�このプロジェクトは拡張 %s の %s 以降のバージョンが必要なため、現在のバージョン(%s)ではビルドできません。�例外�ちなみに�課題�%r のTranslatorはすでに登録されています�不明な設定値 latex_elements[%r] は無視されました。�不明なイベント名: %s�不明な画像フォーマット: %s...�不明な math_renderer %r が指定されました。�不明なテーマオプション latex_theme_options[%r] は無視されました。�次のように Makefile を使ってドキュメントを作成します。 make builder�次のように、ドキュメントを構築するには sphinx-build コマンドを使用してください。 sphinx-build -b builder %s %s�変数�警告�警告�Sphinx %s クイックスタートユーティリティへようこそ。�Welcome! This is�ファイル %s を作成したものとします。�列挙�Sphinx 出力用のビルドディレクトリを配置する方法は2つあります。 ルートパス内にある "_build" ディレクトリを使うか、 ルートパス内に "source" と "build" ディレクトリを分ける方法です。�マスターファイル %s を作成して 他のドキュメントソースファイルを作成します。�検索した文字列はどの文書にも見つかりませんでした。すべての単語が正確に記述されているか、あるいは、十分なカテゴリーが選択されているか確認してください。�[autosummary] %rのインポートに失敗しました: %s�[autosummary] %s の autosummary を生成中�[autosummary] %s に書き込み中�[ドキュメント]�[グラフ: %s]�[グラフ]�[画像: %s]�[画像]�[ソース]�__all__ は文字列のリストでなければなりません。%r (%s モジュールの中) ではないです -- ignoring __all__�ページ%sの読み込み中にUnicodeエラーが発生しました。非アスキー文字を含む設定値は全てUnicode文字列にしてください。�再構築するための設定ファイルのリスト。 -a が指定されている場合は無視されます�%sビルダー向けの画像形式が見つかりません: %s�%sビルダー向けの画像形式が見つかりません: %s (%s)�関数、クラスおよび用語総覧�全%d件のpoファイル�全てのソースファイル�module_pathを sys.path に追加します。--full が与えられたときに使用されます。�ドキュメントを1ページにまとめています�の属性�著者名�autodoc: ドキュメント化する %r の決定に失敗しました。次の例外が発生しました: %s�モジュールから自動的に docstring を挿入する�doctest ブロック内のコードスニペットを自動的にテストする�autosummary は内部的に rst ファイルを生成します。しかしあなたの source_suffix は rst ファイルに含まれていませんでした。スキップします。�autosummary は除外したドキュメント %r を参照しています。無視されます。�autosummary: ドキュメント化する %r の決定に失敗しました。次の例外が発生しました: %s�autosummary: stubファイルが見つかりません%r。autosummary_generate設定を確認してください。�autosummary_generate: ファイルが見つかりません: %s�tabularcolumns と :widths: オプションの両方が設定されています。:widths: は無視されます。�リンクが切れています: %s (%s)�警告%s、%sをビルドします（警告はエラーとして扱われます）。�ビルド %s, %s warning.�警告%s、%sをビルドします（警告はエラーとして扱われます）。�ビルド %s, %s 警告.�ビルド %s.�ビルド環境のバージョンが最新ではありません�可能な場合、ビルドを N 個のプロセスで並列実行する（特別な値 "auto" は N を cpu-count に設定する）�build info ファイルが壊れています: %r�使用するビルダー（デフォルト：html）�ビルド中 [%s]: �ビルド中 [mo]: �組み込み関数�大きい場合があるので注意�-aオプションとファイル名を組み合わせることはできません�ダウンロードファイル %r をコピーできません: %s�extraファイル %r をコピーできませんでした�画像ファイル %r をコピーできません: %s�静的ファイル %r をコピーできません�ファイル %r が見つかりません�警告ファイル %r を開けません: %s�%r は正しい型ではないため無視されました�設定値の辞書 %r は上書きないため無視されました (%r を使って個別に設定してください)�画像ファイル %r をPILで読み込めないため、そのままコピーします�画像ファイル %r を書き込めません: %s�キャプションは図の中にはありません。�整合性をチェック中�ドキュメントの適用範囲を確認する�循環参照している toctree が検出されましたので無視します: %s <- %s�クラス�クラスメソッド�コマンドラインオプション�コンセプト�設定値に基づくコンテンツの条件付き包含�EPUB3出力では設定値 "epub_author" の指定が必要です�EPUB3出力では設定値 "epub_contributor" が必要です�EPUB3出力では設定値 "epub_copyright" (あるいは "copyright") の指定が必要です�EPUB3出力では設定値 "epub_description" が必要です�EPUB3出力では設定値 "epub_identifier" の指定が必要です�EPUB3出力では設定値 "epub_language" (あるいは "language") の指定が必要です�EPUB3出力では設定値 "epub_publisher" の指定が必要です�EPUB3出力では設定値 "epub_title" (あるいは "html_title") の指定が必要です�EPUB3では設定値 "epub_uid" はXML NAMEにするべきです�EPUB3出力では設定値 "version" が必要です�変更された設定�conf.py が設定ディレクトリに存在しません (%s)�コンソール出力オプション�前のページからの続き�次のページに続く�convert コマンド %r は実行できません。image_converter の設定を確認してください�変換処理はエラー終了しました: [stderr] %r [stdout] %r�TeX 関連ファイルをコピーしています�TeX 関連ファイルをコピー中...�Texinfo 関連ファイルをコピーしています�追加のファイルをコピーしています�ダウンロードファイルをコピー中...�extraファイルをコピー中�画像をコピー中... �ソースファイルをコピー中...�静的ファイルをコピー中�Changelog作成中に %r を読み込めませんでした�GitHub ページにドキュメントを公開するための .nojekyll ファイルを作成する�batファイルを作成する�makefileを作成する�カスタムテンプレートディレクトリ (デフォルト: %(default)s)�データ�デフォルトのロール %s が見つかりません�ファイルのデフォルト拡張子 (デフォルト: %(default)s)�テンプレート変数の定義�定義タグ: TAG ブロック"のみ"含む�ディメンション単位 %s が無効です。無視されます。�ディレクティブ�ディレクティブ %r は既に登録されています。ディレクティブは上書きされます�ディレクティブオプション�すべての生成データを配置するディレクトリ�すべての生成データを配置するディレクトリ�latex の表示 %r: %s�色分けで出力する（デフォルト：自動検出）�batファイルを作成しない�makefileを作成しない�色分けの出力をしない（デフォルト：自動検出）�Makefile / make.bat 向けに make-mode を使わないでください。�書き込むdocname: %s�document�インポートしたメンバーのドキュメント (デフォルト: %(default)s)�ドキュメントはどの toctree にも含まれていません�ドキュメント言語�ドキュメントを読めません。無視します。�ドキュメントのタイトルは、単一の Text ノードではありません�直列で %sします�ドメイン %s はすでに登録されています�ドメイン %s はまだ登録されていません�目次ファイルを生成しない�module/package パッケージの見出しを生成しない (例: docstring にすでにそれらが含まれている場合など)�ドキュメントの自動生成 %r のためにどのモジュールをインポートするのか分かりません (ドキュメントに "module"または "currentmodule"ディレクティブを配置するか、明示的なモジュール名を指定してください)�保存された環境は使わず、常に全てのファイルを読み込む�完了�dot コード %r: %s�dot コマンド %r は実行できません (graphviz 出力のために必要です)。graphviz_dot の設定を確認してください�dotは出力ファイルを生成しませんでした: [stderr] %r [stdout] %r�dot はエラー終了しました: [stderr] %r [stdout] %r�ダウンロードファイルが読み込めません: %s�オブジェクト インベントリを出力�%s の検索インデックスを出力�%s の記述 %s はすでに %s で %s が使われています�%s の記述 %s はすでに %s で使われています�引用 %s はすでに %s で使われています�%s の記述 %s はすでに %s で使われています�ラベル %s はすでに %s で使われています�数式 %s のラベルはすでに %s で使われています�%s のオブジェクト記述、 %s の他の​​インスタンスを複製し、そのうちの1つに :noindex: を使用します�Tocエントリーが重複しています: %s�%s 拡張を有効にする�任意の拡張を有効にする�いくつかのインベントリでいくつかの問題に遭遇しましたが、代替手段を持っていました:�セクション、トピック、表、訓戒またはサイドバーにないタイトルノードが見つかりました。�列挙型�enumerable_node %r はすでに登録されています�enumerator�環境変数�環境変数; %s�%sの引数のフォーマット中にエラーが発生しました: %s �ファイル書き込みエラー %s: %s�Makefile の書き込みエラー: %s�例外�only ディレクティブの条件式の評価中に例外が発生しました: %s�拡張 %r には setup() 関数がありません。これは本当にSphinx拡張ですか？�拡張 %r のsetup()関数が、対応していないオブジェクトを返しました。Noneまたはメタデータ辞書を返してください�拡張オプション�変更された拡張�失敗しました�%sオブジェクトをインポートできませんでした �%sの名前を解析できませんでした �以下の問題があるため、いくつかのインベントリは到達できませんでした:�失敗: %s�favicon ファイル %r がありません�コマンドラインに指定されたファイル %r がないため無視されます�コマンドラインに指定されたファイル %r はソースディレクトリ以下にないため無視されます�テーマパス上のファイル %r は正しいzipファイルではないか、テーマを含んでいません�ファイルの拡張子 (デフォルト: rst)�目次のファイル名 (デフォルト: モジュール)�完了（問題あり）�生成処理から除外するための、ファイル、ディレクトリ、または両方のパターンを記した fnmatch-style 形式�シンボリックリンクをたどります。collective.recipe.omeletteと組み合わせると強力です。�の関数�一般的なオプション�sphinx-quickstart を使って完全なプロジェクトを生成する�索引を生成中�用語集のフォーマットが間違っているようです。インデントを確認してください�用語集の項目�用語集の前に空行が必要です�用語集の用語は空行で区切ってはいけません�文法トークン�graphviz_output_format は %r ではなく 'png' か 'svg' でなければなりません�モジュールコードをハイライトしています...�html_extra_path %r が見つかりません�html_extra_path %r がoutdir内に配置されます�html_static_path %r が見つかりません�html_static_path %r がoutdir内に配置されます�記述した場合、ソースとビルドのディレクトリを分割します。�無効な doctest コードは無視されます: %r�画像ファイル %s が読み込めません: %s�画像ファイルが読み込めません: %s�"_private" モジュールを含めます。�文書化された Python オブジェクトのソースコードへのリンクを含める�PNG または SVG 画像としてレンダリングされた数学を含む�MathJax によってブラウザにレンダリングされた数学を含む�翻訳されたメッセージの引用参照が矛盾しています。原文: {0}、翻訳: {1}�翻訳されたメッセージの footnote 参照が矛盾しています。原文: {0}、翻訳: {1}�翻訳されたメッセージの参照が矛盾しています。原文: {0}、翻訳: {1}�翻訳されたメッセージの用語参照が矛盾しています。原文: {0}、翻訳: {1}�精度の増加（繰り返し可能）�索引�latex のインライン表示 %r: %s�PEP-0420 暗黙の名前空間の指定に従って、モジュールパスを解釈する�intersphinx 識別子 %r は文字列ではありません。無視します�intersphinx インベントリは移動しました: %s -> %s�無効な TestCode タイプ�無効な css_file %r は無視されました�無効な js_file %r は無視されました�%r は設定値 %r の正しい値ではないため無視されました�無効な numfig_format: %s�無効な numfig_format: %s (%r)�無効な正規表現 %r が %s 内に見つかりました�coverage_c_regexes 内に無効な正規表現 %r があります�auto%s (%r) の署名が無効です�ジョブ番号は正数でなければなりません�キーワード�add_node() のキーワード引数は (visit, depart) の形式で関数をタプルで指定してください: %r=%r�最終更新�行番号の指定が範囲外です (1-%d): %r�異なるプロジェクトのSphinxドキュメント間のリンク�章／節一覧�%s から intersphinx インベントリをロード中...�保存された環境データを読み込み中�翻訳カタログをロードしています [%s]... �locale_dir %s は存在しません�ロゴファイル %r がありません�更新されたファイルを探しています... �のマクロ�出力先ディレクトリを作成しています�マスタードキュメント名�math renderer %s はすでに登録されています�目次に表示するサブモジュールの最大深度 (デフォルト: 4)�のメンバ変数�メソッド�'%s' オプション内に '+' または '-' が不足しています�オブジェクト %s に属性 %s がありません�モジュール�モジュール %s をインポートできませんでした: %s�モジュール�'any' クロスリファレンス %r のターゲットが1つ以上みつかりました。 %s に参照を設定します。�相互参照 %r に複数のターゲットが見つかりました: %s�新しい設定�次へ�次の章へ�nit-picky モード。不足しているすべての参照について警告する�設定値 "latex_documents" が見つかりません。ドキュメントは書き込まれません�設定値 "man_pages" が見つかりません。マニュアルページは書かれません�設定値 "texinfo_documents" が見つかりません。ドキュメントは書き込まれません�%r 言語向けの 既知の Babel オプションはありません�バージョン %s での変更はありません�%sブロックにあるコード/出力 が %s にありません: %s�何も出力せず、警告もしない�標準出力には出力せず、標準エラー出力に警告を出すのみ�更新が必要な対象はありませんでした�テーマ %r がありません(theme.confが見つからない?)�テーマ %r が %r から継承されていますが、見つかりませんでした�nodeクラス %r は既に登録されています。visitor関数は上書きされます�見つかりませんでした�翻訳が用意されていません�numfig は無効です。:numref: は無視されます。�%s に numfig_format は定義されていません�オブジェクト�演算子�元のエントリ�設定ファイルの設定を上書きする�存在するファイルは上書きする�ページ�ページ %s がhtml_sidebarsの複数のパターンに一致しました: %r と %r�HTMLテンプレートに値を渡す�キャッシュされた環境とDoctreeファイルへのパス（デフォルト：OUTPUTDIR/.doctrees）�ドキュメントソースファイルへのパス�ドキュメントへのモジュールパス�出力先ディレクトリへのパス�設定ファイル（conf.py）がある場所のパス（デフォルト：SOURCEDIRと同じ場所）�環境データを保存中�ドキュメントの出力準備中�前へ�前の章へ�primary_domain %r が見つかりません。無視します。�処理中 %s�プログラムオプション�プロジェクト著者名(複数可)。--full が与えられたときに使用されます。�プロジェクト名�プロジェクト名 (デフォルト: ルートモジュール名)�プロジェクトのリリースバージョン。--full が与えられたときに使用されます。デフォルトは --doc-version�project root�プロジェクトバージョン。--full が与えられたときに使用されます。�プロパティ�各モジュールのドキュメントをそれぞれのページに配置する�サブモジュールのドキュメントの前に、モジュールのドキュメントを置く�全モジュール早見表�Quiet モード�reST マークアップエラー:�読み取りエラー: %s, %s�ソースを読み込み中...�テンプレートの読み込み中...�参照ラベル�プロジェクトのリリース�_templates などのドットの置き換え�参照を解決しています...�ロール�ロール %r は既に登録されています。ロールは上書きされます�例外が発生したときにPdbを実行する�ファイルを作成せずにスクリプトを実行する�検索�検索インデックスを読み込めず、ドキュメントビルドの一部が不完全です。�ドキュメントを検索�%sを参照�%sも参照�自己参照している toctree が見つかりました。無視します。�設定 %s.%s がテーマ設定にありません�例外時にフルトレースバックを表示する�automodule に与えられた署名引数、または戻り値となるアノテーション %s�スキップしました�ソースディレクトリが変更されました�ソース・ファイルサフィックス�rST ファイルを生成するためのソースファイル�%r のsource_parserはすでに登録されています�source_suffix %r はすでに登録されています�sphinx-quickstart は空のディレクトリにのみ生成します。新しいルートパスを指定してください。�sphinx-quickstart は、既存の Sphinx プロジェクトを上書きしません。�sphinx-quickstart は既存のファイルを上書きしません。�sphinx_rtd_theme (< 0.3.0) が検出されました。Sphinx-6.0 以降では利用できなくなります。�文�の静的メソッド�struct�成功�更新された %d 件のpoファイル�指定された %d 件のpoファイル�更新された %d 件のソースファイル�指定された %d 件のテンプレートファイル�テンプレートファイルのテンプレートディレクトリ�拡張 %s は並列読み込みが可能かどうかを宣言していないため、おそらく並列読み込みに対応していないでしょう。拡張の実装者に連絡して、明示してもらってください。�拡張 %s は並列書き込みが可能かどうかを宣言していないため、おそらく並列書き込みに対応していないでしょう。拡張の実装者に連絡して、明示してもらってください。�%s拡張は並列読み込みに対して安全ではありません�%s拡張は並列書き込みに対して安全ではありません�the documentation for�拡張 %r はSphinxのバージョン%sでSphinxに統合されています。この拡張は無視されます。�リンクにキャプションがありません: %s�テーマ %r に "inherit" 設定がありません�テーマ %r に "theme" 設定がありません�toctree に存在しないファイルへの参照が含まれています %r�toctree にはタイトルのないドキュメント %r への参照が含まれています: リンクは生成されません�toctree に除外したドキュメントへの参照が含まれています %r�toctree に存在しないドキュメントへの参照が含まれています %r�:maxdepth: が大きすぎるので無視されます。�警告をエラーとして扱う�のデータ型�デコードできないソース文字です。"?" に置き換えます: %r�未実装のノードタイプ: %r�union�不明なクラス %r の toplevel_sectioning %r�不明な設定値 %r による上書きは無視されました�不明なインデックスエントリタイプ %r�不明なインデックスエントリタイプ %s が見つかりました�不明なmimetype %sのため無視します�不明なノードタイプ: %r�サポートされていないテーマオプション %r が指定されました�環境データを更新中�epubを利用する�Makefile / make.bat 向けに make-mode を使う�設定ファイルを使用せず、-Dオプションのみを使用�変数�プロジェクトのバージョン�ワーカーの終了を待っています...�"builder" はサポートされているビルダーの 1 つです。 例: html, latex, または linkcheck。�拡張機能のセットアップ中 %s:�-Wを指定すると、警告が表示されたときは実行を続ける�ビルド時に表示または非表示にできる "todo" エントリを書く�すべてのファイルに書き込む（デフォルト: 新規ファイルまたは変更されたファイルのみ）�指定ファイルに警告（およびエラー）を書き込む�書き込み中�ファイル %s を書き込み中...�META-INF/container.xml を書き込み中...�追加のファイルを出力�追加のページを出力中�content.opf を書き込み中...�書き込みエラー: %s, %s�メッセージカタログを出力中... �mimetype を書き込み中...�nav.xhtml を書き込み中...�出力中...�概要ファイルを書き出し中...�tox.ncx を書き込み中...�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ja/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000360573�00000000000�021151� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # shirou - しろう <shirou.faw@gmail.com>, 2013 # Akitoshi Ohta <fire.kuma8@gmail.com>, 2011 # tomo, 2018 # Hisahiro Ohmura, 2017 # Komiya Takeshi <i.tkomiya@gmail.com>, 2021 # Kouhei Sutou <kou@clear-code.com>, 2011 # sutefu7, 2019-2020 # shirou - しろう <shirou.faw@gmail.com>, 2017 # Taizo Ito <taizo.ito@hennge.com>, 2019 # Takayuki Shimizukawa <shimizukawa@gmail.com>, 2013-2016 # Takayuki Shimizukawa <shimizukawa@gmail.com>, 2016-2017,2019 # Komiya Takeshi <i.tkomiya@gmail.com>, 2016-2017,2019 # Tetsuo Koyama <tkoyama010@gmail.com>, 2020 # tomo, 2019 # shirou - しろう <shirou.faw@gmail.com>, 2014 # Yasushi Masuda <whosaysni@gmail.com>, 2008 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Japanese (http://www.transifex.com/sphinx-doc/sphinx-1/language/ja/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: ja\n" "Plural-Forms: nplurals=1; plural=0;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "ソースディレクトリが存在しません (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "出力先ディレクトリ (%s) はディレクトリではありません" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "出力先ディレクトリにはソースディレクトリと異なるディレクトリを指定してください" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx v%s を実行中" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "セキュリティ上の問題により、macOS で python3.8 以上をお使いの場合はパラレルモードは利用できません。詳しくは https://github.com/sphinx-doc/sphinx/issues/6803 をお読みください。" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "このプロジェクトはSphinx v%s以降のバージョンでなければビルドできません。" #: sphinx/application.py:243 msgid "making output directory" msgstr "出力先ディレクトリを作成しています" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "拡張機能のセットアップ中 %s:" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "conf.pyにある'setup'はPythonのcallableではありません。定義を修正してcallableである関数にしてください。これはconf.pyがSphinx拡張として動作するのに必要です。" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "翻訳カタログをロードしています [%s]... " #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "完了" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "翻訳が用意されていません" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "保存された環境データを読み込み中" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "失敗: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "ビルダーが選択されていないので、デフォルトの html を使用します" #: sphinx/application.py:348 msgid "succeeded" msgstr "成功" #: sphinx/application.py:349 msgid "finished with problems" msgstr "完了（問題あり）" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "警告%s、%sをビルドします（警告はエラーとして扱われます）。" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "警告%s、%sをビルドします（警告はエラーとして扱われます）。" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "ビルド %s, %s warning." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "ビルド %s, %s 警告." #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "ビルド %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "nodeクラス %r は既に登録されています。visitor関数は上書きされます" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "ディレクティブ %r は既に登録されています。ディレクティブは上書きされます" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "ロール %r は既に登録されています。ロールは上書きされます" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "拡張 %s は並列読み込みが可能かどうかを宣言していないため、おそらく並列読み込みに対応していないでしょう。拡張の実装者に連絡して、明示してもらってください。" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "%s拡張は並列読み込みに対して安全ではありません" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "拡張 %s は並列書き込みが可能かどうかを宣言していないため、おそらく並列書き込みに対応していないでしょう。拡張の実装者に連絡して、明示してもらってください。" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "%s拡張は並列書き込みに対して安全ではありません" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "直列で %sします" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "conf.py が設定ディレクトリに存在しません (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "設定値の辞書 %r は上書きないため無視されました (%r を使って個別に設定してください)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "%r は設定値 %r の正しい値ではないため無視されました" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "%r は正しい型ではないため無視されました" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "不明な設定値 %r による上書きは無視されました" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "%s という設定値はありません" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "設定値 %r は既に登録済みです" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "設定ファイルに文法エラーが見つかりました: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "設定ファイル（あるいはインポートしたどれかのモジュール）がsys.exit()を呼びました" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "設定ファイルにプログラム上のエラーがあります:\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "設定値 `source_suffix' に `%r' が指定されましたが、文字列、文字列のリスト、辞書、のいずれかを指定してください。" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "%s 章" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "図 %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "表 %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "リスト %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr " 設定値 `{name}` に `{current}` が指定されましたが、 {candidates} のいずれかを指定してください。" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "設定値 `{name}' に `{current.__name__}' 型が指定されていますが、 {permitted} 型を指定してください。" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "設定値 `{name}' に `{current.__name__}' 型が指定されています。デフォルト値は `{default.__name__}' です。" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r が見つかりません。無視します。" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "イベント %r はすでに登録されています" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "不明なイベント名: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "needs_extensions設定で %s 拡張が要求されていますが、その拡張がありません。" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "このプロジェクトは拡張 %s の %s 以降のバージョンが必要なため、現在のバージョン(%s)ではビルドできません。" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "Pygments に %r というlexerがありません" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "リテラルブロックを \"%s\" として解釈できませんでした。ハイライト処理をスキップします。" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "ドキュメントを読めません。無視します。" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "ビルダークラス %s には\"name\"属性がありません" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "ビルダー %r (モジュール %s) がすでに登録されています" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "ビルダー名 %s は登録されておらず、entry pointにもありません" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "ビルダー名 %s は登録されていません" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "ドメイン %s はすでに登録されています" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "ドメイン %s はまだ登録されていません" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "ディレクティブ %r は既に%sドメインに登録されています" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "ロール %r は既にドメイン%sに登録されています" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "インデックス %r はすでに%sドメインに登録されています" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "object_type %r はすでに登録されています" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "classref_type %r はすでに登録されています" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "source_suffix %r はすでに登録されています" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "%r のsource_parserはすでに登録されています" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "%s のsource_parserは登録されていません" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "%r のTranslatorはすでに登録されています" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "add_node() のキーワード引数は (visit, depart) の形式で関数をタプルで指定してください: %r=%r" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "enumerable_node %r はすでに登録されています" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "math renderer %s はすでに登録されています" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "拡張 %r はSphinxのバージョン%sでSphinxに統合されています。この拡張は無視されます。" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "元の例外:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "拡張 %s をimportできません" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "拡張 %r には setup() 関数がありません。これは本当にSphinx拡張ですか？" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "このプロジェクトで使われている拡張 %s はSphinx v%s 以降が必要なため、現在のバージョンではビルドできません。" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "拡張 %r のsetup()関数が、対応していないオブジェクトを返しました。Noneまたはメタデータ辞書を返してください" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "テーマ %r に \"theme\" 設定がありません" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "テーマ %r に \"inherit\" 設定がありません" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "テーマ %r が %r から継承されていますが、見つかりませんでした" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "設定 %s.%s がテーマ設定にありません" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "サポートされていないテーマオプション %r が指定されました" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "テーマパス上のファイル %r は正しいzipファイルではないか、テーマを含んでいません" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "sphinx_rtd_theme (< 0.3.0) が検出されました。Sphinx-6.0 以降では利用できなくなります。" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "テーマ %r がありません(theme.confが見つからない?)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "%sビルダー向けの画像形式が見つかりません: %s (%s)" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "%sビルダー向けの画像形式が見つかりません: %s" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "ビルド中 [mo]: " #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "出力中..." #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "全%d件のpoファイル" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "指定された %d 件のpoファイル" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "更新された %d 件のpoファイル" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "全てのソースファイル" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "コマンドラインに指定されたファイル %r はソースディレクトリ以下にないため無視されます" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "コマンドラインに指定されたファイル %r がないため無視されます" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "コマンドラインで指定された%d件のソースファイル" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "更新された %d 件のソースファイル" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "ビルド中 [%s]: " #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "更新されたファイルを探しています... " #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "%d 件見つかりました" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "見つかりませんでした" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "環境データを保存中" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "整合性をチェック中" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "更新が必要な対象はありませんでした" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "環境データを更新中" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "%s 件追加, %s 件更新, %s 件削除" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "ソースを読み込み中..." #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "ワーカーの終了を待っています..." #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "書き込むdocname: %s" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "ドキュメントの出力準備中" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "Tocエントリーが重複しています: %s" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "画像をコピー中... " #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "画像ファイル %r をPILで読み込めないため、そのままコピーします" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "画像ファイル %r をコピーできません: %s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "画像ファイル %r を書き込めません: %s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "Pillowがインストールされていません。代わりに画像をコピーします" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "mimetype を書き込み中..." #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "META-INF/container.xml を書き込み中..." #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "content.opf を書き込み中..." #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "不明なmimetype %sのため無視します" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "tox.ncx を書き込み中..." #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "ファイル %s を書き込み中..." #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "ファイルは%(outdir)sにあります" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "バージョン %s での変更はありません" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "概要ファイルを書き出し中..." #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "組み込み" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "モジュールレベル" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "ソースファイルをコピー中..." #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "Changelog作成中に %r を読み込めませんでした" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "dummyビルダーはファイルを出力しません" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "ePubファイルは%(outdir)sにあります。" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "nav.xhtml を書き込み中..." #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "EPUB3出力では設定値 \"epub_language\" (あるいは \"language\") の指定が必要です" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "EPUB3では設定値 \"epub_uid\" はXML NAMEにするべきです" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "EPUB3出力では設定値 \"epub_title\" (あるいは \"html_title\") の指定が必要です" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "EPUB3出力では設定値 \"epub_author\" の指定が必要です" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "EPUB3出力では設定値 \"epub_contributor\" が必要です" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "EPUB3出力では設定値 \"epub_description\" が必要です" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "EPUB3出力では設定値 \"epub_publisher\" の指定が必要です" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "EPUB3出力では設定値 \"epub_copyright\" (あるいは \"copyright\") の指定が必要です" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "EPUB3出力では設定値 \"epub_identifier\" の指定が必要です" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "EPUB3出力では設定値 \"version\" が必要です" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "無効な css_file %r は無視されました" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "メッセージカタログは%(outdir)sにあります。" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "指定された %d 件のテンプレートファイル" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "テンプレートの読み込み中..." #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "メッセージカタログを出力中... " #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "上記の出力結果、または %(outdir)s /output.txt を見てエラーを確認してください" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "リンクが切れています: %s (%s)" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "アンカー '%s' が見つかりません" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "linkcheck_allowed_redirects 内の正規表現のコンパイルに失敗しました: %r %s" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "マニュアルページは %(outdir)s にあります。" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "設定値 \"man_pages\" が見つかりません。マニュアルページは書かれません" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "書き込み中" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "設定値 \"man_pages\" が不明なドキュメント %s を参照しています" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "HTML ページは%(outdir)sにあります。" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "ドキュメントを1ページにまとめています" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "追加のファイルを出力" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "Texinfoファイルは%(outdir)sにあります。" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "\nmakeinfo コマンドで処理するため、そのディレクトリで 'make' を実行してください。\n（これを自動的に行うには、ここで 'make info' を使用してください）。" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "設定値 \"texinfo_documents\" が見つかりません。ドキュメントは書き込まれません" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "設定値 \"texinfo_documents\" は、不明なドキュメント %s を参照しています" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "処理中 %s" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "参照を解決しています..." #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (in " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "Texinfo 関連ファイルをコピーしています" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "Makefile の書き込みエラー: %s" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "テキストファイルは%(outdir)sにあります。" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "ファイル書き込みエラー %s: %s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "XMLファイルは%(outdir)sにあります。" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "pseudo-XMLファイルは%(outdir)sにあります。" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "build info ファイルが壊れています: %r" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "HTMLページは%(outdir)sにあります。" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "build info ファイルの読み込みに失敗しました: %r" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%Y年%m月%d日" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "総合索引" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "索引" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "次へ" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "前へ" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "索引を生成中" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "追加のページを出力中" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "ダウンロードファイルをコピー中..." #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "ダウンロードファイル %r をコピーできません: %s" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "html_static_file 内のファイルのコピーに失敗しました: %s: %r" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "静的ファイルをコピー中" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "静的ファイル %r をコピーできません" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "extraファイルをコピー中" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "extraファイル %r をコピーできませんでした" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "build info ファイル %r の出力に失敗しました" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "検索インデックスを読み込めず、ドキュメントビルドの一部が不完全です。" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "ページ %s がhtml_sidebarsの複数のパターンに一致しました: %r と %r" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "ページ%sの読み込み中にUnicodeエラーが発生しました。非アスキー文字を含む設定値は全てUnicode文字列にしてください。" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "%sページのレンダリング中にエラーが発生しました。\n理由: %r " #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "オブジェクト インベントリを出力" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "%s の検索インデックスを出力" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "無効な js_file %r は無視されました" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "複数の math_renderer が登録されています。しかし math_renderer は選択されていません。" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "不明な math_renderer %r が指定されました。" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "html_extra_path %r が見つかりません" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "html_extra_path %r がoutdir内に配置されます" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "html_static_path %r が見つかりません" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "html_static_path %r がoutdir内に配置されます" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "ロゴファイル %r がありません" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "favicon ファイル %r がありません" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s ドキュメント" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "LaTeXファイルは%(outdir)sにあります。" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\n(pdf)latex コマンドで処理するために、そのディレクトリで 'make' を実行してください。\n（これを自動的に行うには、ここで 'make latexpdf' を使用してください）。" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "設定値 \"latex_documents\" が見つかりません。ドキュメントは書き込まれません" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "設定値 \"latex_documents\" は、不明なドキュメント %s を参照しています" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "索引" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "リリース" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "%r 言語向けの 既知の Babel オプションはありません" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "TeX 関連ファイルをコピーしています" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "TeX 関連ファイルをコピー中..." #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "追加のファイルをコピーしています" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "不明な設定値 latex_elements[%r] は無視されました。" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "不明なテーマオプション latex_theme_options[%r] は無視されました。" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "%r に \"theme\" 設定がありません" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "%r に \"%s\" 設定がありません" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "ビルド中に例外が発生しました。デバッガを起動します:" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "割り込まれました！" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "reST マークアップエラー:" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "エンコードエラー:" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "完全なトレースバックを%sに保存しました。問題を開発者に報告するときに添付してください。" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "再起呼び出しエラー:" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "例外が発生しました" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "次期バージョンでのエラーメッセージ改善のために、ユーザーエラーの場合にも報告してください。" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "バグ報告はこちらにお願いします <https://github.com/sphinx-doc/sphinx/issues> 。ご協力ありがとうございます！" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "ジョブ番号は正数でなければなりません" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "ドキュメントソースファイルへのパス" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "出力先ディレクトリへのパス" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "再構築するための設定ファイルのリスト。 -a が指定されている場合は無視されます" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "一般的なオプション" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "使用するビルダー（デフォルト：html）" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "すべてのファイルに書き込む（デフォルト: 新規ファイルまたは変更されたファイルのみ）" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "保存された環境は使わず、常に全てのファイルを読み込む" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "キャッシュされた環境とDoctreeファイルへのパス（デフォルト：OUTPUTDIR/.doctrees）" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "可能な場合、ビルドを N 個のプロセスで並列実行する（特別な値 \"auto\" は N を cpu-count に設定する）" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "設定ファイル（conf.py）がある場所のパス（デフォルト：SOURCEDIRと同じ場所）" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "設定ファイルを使用せず、-Dオプションのみを使用" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "設定ファイルの設定を上書きする" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "HTMLテンプレートに値を渡す" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "定義タグ: TAG ブロック\"のみ\"含む" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "nit-picky モード。不足しているすべての参照について警告する" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "コンソール出力オプション" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "精度の増加（繰り返し可能）" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "標準出力には出力せず、標準エラー出力に警告を出すのみ" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "何も出力せず、警告もしない" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "色分けで出力する（デフォルト：自動検出）" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "色分けの出力をしない（デフォルト：自動検出）" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "指定ファイルに警告（およびエラー）を書き込む" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "警告をエラーとして扱う" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "-Wを指定すると、警告が表示されたときは実行を続ける" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "例外時にフルトレースバックを表示する" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "例外が発生したときにPdbを実行する" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "ファイル %r が見つかりません" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "-aオプションとファイル名を組み合わせることはできません" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "警告ファイル %r を開けません: %s" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "-Dオプション引数は name = value の形式でなければなりません" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "-Aオプション引数は name = value の形式でなければなりません" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "モジュールから自動的に docstring を挿入する" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "doctest ブロック内のコードスニペットを自動的にテストする" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "異なるプロジェクトのSphinxドキュメント間のリンク" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "ビルド時に表示または非表示にできる \"todo\" エントリを書く" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "ドキュメントの適用範囲を確認する" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "PNG または SVG 画像としてレンダリングされた数学を含む" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "MathJax によってブラウザにレンダリングされた数学を含む" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "設定値に基づくコンテンツの条件付き包含" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "文書化された Python オブジェクトのソースコードへのリンクを含める" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "GitHub ページにドキュメントを公開するための .nojekyll ファイルを作成する" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "有効なパス名を入力してください。" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "何か入力してください。" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "%sのいずれかを入力してください。 " #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "'y' または 'n' を入力してください。" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "ファイルの拡張子を入力してください。例: '.rst' または '.txt'。" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "Sphinx %s クイックスタートユーティリティへようこそ。" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "以下の設定値を入力してください（Enter キーのみ押した場合、\nかっこで囲まれた値をデフォルト値として受け入れます）。" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "選択されたルートパス: %s" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "ドキュメントのルートパスを入力してください。" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "ドキュメントのルートパス" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "エラー：選択されたルートパスに既存の conf.py が見つかりました。" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "sphinx-quickstart は、既存の Sphinx プロジェクトを上書きしません。" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "新しいルートパスを入力してください（または Enter を押すことで終了します）。" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "Sphinx 出力用のビルドディレクトリを配置する方法は2つあります。\nルートパス内にある \"_build\" ディレクトリを使うか、\nルートパス内に \"source\" と \"build\" ディレクトリを分ける方法です。" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "ソースディレクトリとビルドディレクトリを分ける（y / n）" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "プロジェクトのルートディレクトリに 2つ以上のディレクトリが作成されます。\nカスタマイズしたHTMLテンプレート用の\"_templates\"ディレクトリと、カスタマイズしたスタイルシート等を置く\"_static\"ディレクトリがあります。\nこれらのディレクトリは \"_\" で始まっていますが、別の文字(\".\"など)で始まるように指定できます。" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "テンプレートと静的ディレクトリの名前プレフィックス" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "プロジェクト名は、ビルドされたドキュメントのいくつかの場所にあります。" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "プロジェクト名" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "著者名（複数可）" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "プロジェクトのバージョン" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "プロジェクトのリリース" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "ドキュメントを英語以外の言語で書く場合は、\n 言語コードで言語を選択できます。Sphinx は生成したテキストをその言語に翻訳します。\n\nサポートされているコードのリストについては、\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language を参照してください。" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "プロジェクトの言語" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "ソース・ファイルサフィックス" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "1つのドキュメントは、\"コンテンツツリー\"の最上位ノードと\n見なされるという点で特別です。つまり、それはドキュメントにおける階層構造のルートである\nということです。通常、これは \"index\" ですが、\n\"index\" ドキュメントがカスタムテンプレートの場合、これを別のファイル名に設定することもできます。" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "マスター文書の名前（拡張子を除く）" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "エラー：マスタファイル %s は、選択されたルートパス上で既に存在します。" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "sphinx-quickstart は既存のファイルを上書きしません。" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "新しいファイル名を入力するか、既存のファイルの名前を変更してEnterキーを押してください。" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "次の Sphinx 拡張機能のうちどれを有効にするかを指定します。" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "注：imgmath と mathjax を同時に有効にすることはできません。 imgmath は未選択になります。" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "Makefile と Windows コマンドファイルは生成することができるので、\n後は実行するだけです。例えば、直接 sphinx-build を実行する代わりに `make html` を\n実行します。" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "Makefile を作成しますか？ （y/n）" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "Windows コマンドファイルを作成しますか？（y/n）" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "ファイル %s を作成しています。" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "ファイル %s は既に存在しますのでスキップします。" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "終了：初期ディレクトリ構造が作成されました。" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "マスターファイル %s を作成して\n他のドキュメントソースファイルを作成します。" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "次のように Makefile を使ってドキュメントを作成します。\n make builder" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "次のように、ドキュメントを構築するには sphinx-build コマンドを使用してください。\n sphinx-build -b builder %s %s" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "\"builder\" はサポートされているビルダーの 1 つです。 例: html, latex, または linkcheck。" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "\nSphinx プロジェクトに必要なファイルを生成します。\n\nsphinx-quickstart は、いくつかの質問であなたの\nプロジェクトを生成するためのディレクトリと、sphinx-build と一緒に使える\nサンプルのMakefileを作成してくれるインタラクティブなツールです。\n" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "Quiet モード" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "project root" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "構成オプション" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "記述した場合、ソースとビルドのディレクトリを分割します。" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "_templates などのドットの置き換え" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "プロジェクトの基本オプション" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "プロジェクト名" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "著者名" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "プロジェクトのバージョン" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "プロジェクトのリリース" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "ドキュメント言語" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "ソース・ファイルサフィックス" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "マスタードキュメント名" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "epubを利用する" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "拡張オプション" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "%s 拡張を有効にする" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "任意の拡張を有効にする" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "Makefileとbatファイルの生成オプション" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "makefileを作成する" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "makefileを作成しない" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "batファイルを作成する" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "batファイルを作成しない" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "Makefile / make.bat 向けに make-mode を使う" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "Makefile / make.bat 向けに make-mode を使わないでください。" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "プロジェクトテンプレート" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "テンプレートファイルのテンプレートディレクトリ" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "テンプレート変数の定義" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "\"quiet\" が指定されていますが、 \"project\" または \"author\" のいずれも指定されていません。" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "エラー：指定されたパスはディレクトリではないか、または sphinx ファイルが既に存在します。" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "sphinx-quickstart は空のディレクトリにのみ生成します。新しいルートパスを指定してください。" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "無効なテンプレート変数: %s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "不正な caption です: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "行番号の指定が範囲外です (1-%d): %r" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "\"%s\" と \"%s\" のオプションは同時に使用できません" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "インクルードファイル %r が見つからないか読み込めません" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "エンコーディング %r はインクルードファイル %r の読み込みに適さないようです。:encoding: オプションを追加してみてください" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "%r という名前のオブジェクトがインクルードファイル %r 内に見つかりません" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr " \"lineno-match\" は不連続な \"lines\" に対して使用できません" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "指定された %r に一致する行がインクルードファイル %r にありませんでした" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "この節の作者: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "モジュールの作者: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "コードの作者: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "作者: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "%s (C %s)" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "パラメータ" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "戻り値" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "戻り値の型" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "のメンバ変数" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "変数" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "の関数" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "のマクロ" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "struct" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "union" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "列挙型" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "enumerator" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "のデータ型" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "バージョン %s で追加" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "バージョン %s で変更" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "バージョン %s で非推奨" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "引用 %s はすでに %s で使われています" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "引用 [%s] は参照されていません。" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "テンプレートパラメータ" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "例外" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "クラス" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "コンセプト" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (組み込み関数)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s のメソッド)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (クラス)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (グローバル変数または定数)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s の属性)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "引数" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (モジュール)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "メソッド" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "データ" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "の属性" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "モジュール" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "%s の記述 %s はすでに %s で %s が使われています" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "数式 %s のラベルはすでに %s で使われています" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "無効な math_eqref_format: %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "キーワード" #: sphinx/domains/python.py:60 msgid "operator" msgstr "演算子" #: sphinx/domains/python.py:61 msgid "object" msgstr "オブジェクト" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "例外" #: sphinx/domains/python.py:63 msgid "statement" msgstr "文" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "組み込み関数" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "変数" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "例外" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (%s モジュール)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (%s モジュール)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (組み込み変数)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (組み込みクラス)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (%s のクラス)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s のクラスメソッド)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "%s (%s のプロパティ)" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s の静的メソッド)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Pythonモジュール索引" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "モジュール" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "非推奨" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "クラスメソッド" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "の静的メソッド" #: sphinx/domains/python.py:1176 msgid "property" msgstr "プロパティ" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "%s のオブジェクト記述、 %s の他の​​インスタンスを複製し、そのうちの1つに :noindex: を使用します" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "相互参照 %r に複数のターゲットが見つかりました: %s" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (非推奨)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (ディレクティブ)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr ":%s: (ディレクティブオプション)" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (ロール)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "ディレクティブ" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "ディレクティブオプション" #: sphinx/domains/rst.py:210 msgid "role" msgstr "ロール" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "%s の記述 %s はすでに %s で使われています" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "環境変数; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "不正なオプションの説明 %r は、\"opt\"、\"-opt args\"、\"--opt args\"、\"/opt args\" または \"+opt args\" のようになります。" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "%s コマンドラインオプション" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "コマンドラインオプション" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "用語集の前に空行が必要です" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "用語集の用語は空行で区切ってはいけません" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "用語集のフォーマットが間違っているようです。インデントを確認してください" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "用語集の項目" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "文法トークン" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "参照ラベル" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "環境変数" #: sphinx/domains/std.py:568 msgid "program option" msgstr "プログラムオプション" #: sphinx/domains/std.py:569 msgid "document" msgstr "document" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "モジュール索引" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "検索ページ" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "ラベル %s はすでに %s で使われています" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "%s の記述 %s はすでに %s で使われています" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "numfig は無効です。:numref: は無視されます。" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "リンクにキャプションがありません: %s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "無効な numfig_format: %s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "無効な numfig_format: %s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "新しい設定" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "変更された設定" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "変更された拡張" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "ビルド環境のバージョンが最新ではありません" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "ソースディレクトリが変更されました" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "この環境は選択したビルダーと互換性がありません。別の doctree ディレクトリーを選択してください。" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "%s のドキュメントをスキャンできませんでした: %r " #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "ドメイン %r はまだ登録されていません" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "自己参照している toctree が見つかりました。無視します。" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "ドキュメントはどの toctree にも含まれていません" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "%sを参照" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "%sも参照" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "不明なインデックスエントリタイプ %r" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "記号" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "循環参照している toctree が検出されましたので無視します: %s <- %s" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "toctree にはタイトルのないドキュメント %r への参照が含まれています: リンクは生成されません" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "toctree に除外したドキュメントへの参照が含まれています %r" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "toctree に存在しないドキュメントへの参照が含まれています %r" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "画像ファイルが読み込めません: %s" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "画像ファイル %s が読み込めません: %s" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "ダウンロードファイルが読み込めません: %s" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "%s はすでにセクション番号が割り当てられています (入れ子になった番号の toctree ?)" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "ファイル %s を作成したものとします。" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "\n<MODULE_PATH> 内を再帰的に調べてPython のモジュールとパッケージ、\n後は1つのreST ファイルを <OUTPUT_PATH> 内にあるパッケージ毎の automodule ディレクティブに作成します。\n\n<EXCLUDE_PATTERN> は、ファイル、またはディレクトリ、または両方のパターンを\n生成処理から除外することができます。\n\n注：デフォルトでは、このスクリプトはすでに作成されているファイルを上書きしません。" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "ドキュメントへのモジュールパス" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "生成処理から除外するための、ファイル、ディレクトリ、または両方のパターンを記した fnmatch-style 形式" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "すべての生成データを配置するディレクトリ" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "目次に表示するサブモジュールの最大深度 (デフォルト: 4)" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "存在するファイルは上書きする" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "シンボリックリンクをたどります。collective.recipe.omeletteと組み合わせると強力です。" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "ファイルを作成せずにスクリプトを実行する" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "各モジュールのドキュメントをそれぞれのページに配置する" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "\"_private\" モジュールを含めます。" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "目次のファイル名 (デフォルト: モジュール)" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "目次ファイルを生成しない" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "module/package パッケージの見出しを生成しない (例: docstring にすでにそれらが含まれている場合など)" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "サブモジュールのドキュメントの前に、モジュールのドキュメントを置く" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "PEP-0420 暗黙の名前空間の指定に従って、モジュールパスを解釈する" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "ファイルの拡張子 (デフォルト: rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "sphinx-quickstart を使って完全なプロジェクトを生成する" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "module_pathを sys.path に追加します。--full が与えられたときに使用されます。" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "プロジェクト名 (デフォルト: ルートモジュール名)" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "プロジェクト著者名(複数可)。--full が与えられたときに使用されます。" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "プロジェクトバージョン。--full が与えられたときに使用されます。" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "プロジェクトのリリースバージョン。--full が与えられたときに使用されます。デフォルトは --doc-version" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "拡張オプション" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s はディレクトリではありません。" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "無効な正規表現 %r が %s 内に見つかりました" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "ソース内のカバレッジのテストが終了したら、%(outdir)spython.txt の結果を確認してください。" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "coverage_c_regexes 内に無効な正規表現 %r があります" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "モジュール %s をインポートできませんでした: %s" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "'%s' オプション内に '+' または '-' が不足しています" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "'%s' は正しいオプションではありません" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "'%s' は正しい pyversion オプションではありません" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "無効な TestCode タイプ" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "ソース内の doctests のテストが終了したら、%(outdir)s/output.txt の結果を確認してください。" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "%sブロックにあるコード/出力 が %s にありません: %s" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "無効な doctest コードは無視されます: %r" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "====================== 最も遅い読み取り時間 =======================" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "Graphviz ディレクティブはコンテンツとファイル名の両方の引数を持つことは出来ません" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "外部の Graphviz ファイル %r が見つからないか読み込めません" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "コンテンツのない \"graphviz\" ディレクティブを無視します" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dotは出力ファイルを生成しませんでした:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "dot コマンド %r は実行できません (graphviz 出力のために必要です)。graphviz_dot の設定を確認してください" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot はエラー終了しました:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "graphviz_output_format は %r ではなく 'png' か 'svg' でなければなりません" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "dot コード %r: %s" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[グラフ: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[グラフ]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "変換処理はエラー終了しました:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "convert コマンド %r は実行できません。image_converter の設定を確認してください" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "LaTeX コマンド %r を実行できません (数式表示のために必要です)。imgmath_latex の設定を確認してください" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "%s コマンド %r を実行できません (数式表示のために必要です)。imgmath_%s の設定を確認してください" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "latex の表示 %r: %s" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "latex のインライン表示 %r: %s" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "この数式へのパーマリンク" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "intersphinx インベントリは移動しました: %s -> %s" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "%s から intersphinx インベントリをロード中..." #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "いくつかのインベントリでいくつかの問題に遭遇しましたが、代替手段を持っていました:" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "以下の問題があるため、いくつかのインベントリは到達できませんでした:" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(in %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(in %s)" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "intersphinx 識別子 %r は文字列ではありません。無視します" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "intersphinx_mapping [%s] の読み取りに失敗しました。無視します: %r" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[ソース]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "課題" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "TODO エントリーが見つかりました: %s" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<original entry>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(<<original entry>> は、 %s の %d 行目です)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "元のエントリ" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "モジュールコードをハイライトしています..." #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[ドキュメント]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "モジュールコード" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>%s のソースコード</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "概要: モジュールコード" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>全モジュールのうち、コードを読めるもの</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "auto%s (%r) の署名が無効です" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "%sの引数のフォーマット中にエラーが発生しました: %s " #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "オブジェクト %s に属性 %s がありません" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "autodoc: ドキュメント化する %r の決定に失敗しました。次の例外が発生しました:\n%s" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "ドキュメントの自動生成 %r のためにどのモジュールをインポートするのか分かりません (ドキュメントに \"module\"または \"currentmodule\"ディレクティブを配置するか、明示的なモジュール名を指定してください)" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "automodule 名の \"::\" は意味がありません" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "automodule に与えられた署名引数、または戻り値となるアノテーション %s" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "__all__ は文字列のリストでなければなりません。%r (%s モジュールの中) ではないです -- ignoring __all__" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "ベースクラス: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "%rのtype_commentを解析できませんでした: %s" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "autosummary は除外したドキュメント %r を参照しています。無視されます。" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary: stubファイルが見つかりません%r。autosummary_generate設定を確認してください。" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "%sの名前を解析できませんでした " #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "%sオブジェクトをインポートできませんでした " #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: ファイルが見つかりません: %s" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "autosummary は内部的に rst ファイルを生成します。しかしあなたの source_suffix は rst ファイルに含まれていませんでした。スキップします。" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "autosummary: ドキュメント化する %r の決定に失敗しました。次の例外が発生しました:\n%s" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[autosummary] %s の autosummary を生成中" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "[autosummary] %s に書き込み中" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "[autosummary] %rのインポートに失敗しました: %s" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "\nautosummary ディレクティブを使って ReStructuredText を生成します。\n\nsphinx-autogen は sphinx.ext.autosummary.generate のフロントエンドです。\n入力されたファイルを含む autosummary ディレクティブから reStructuredText ファイルを\n生成します。\n\nautosummary ディレクティブのフォーマットは\n``sphinx.ext.autosummary`` に記載されています。Pythonモジュールと :: を使って読むことができます。\n\npydoc sphinx.ext.autosummary\n" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "rST ファイルを生成するためのソースファイル" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "すべての生成データを配置するディレクトリ" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "ファイルのデフォルト拡張子 (デフォルト: %(default)s)" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "カスタムテンプレートディレクトリ (デフォルト: %(default)s)" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "インポートしたメンバーのドキュメント (デフォルト: %(default)s)" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "キーワード引数" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "サンプル" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "サンプル" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "メモ" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "その他のパラメータ" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "参照" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "警告" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "列挙" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "注意" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "注意" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "危険" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "エラー" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "ヒント" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "重要" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "注釈" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "参考" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "ちなみに" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "警告" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "前のページからの続き" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "次のページに続く" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "アルファベット以外" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "番号" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "ページ" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "目次" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "検索" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "検索" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "ソースコードを表示" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "概要" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Welcome! This is" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "the documentation for" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "最終更新" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "索引と表一覧:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "総合目次" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "章／節一覧" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "ドキュメントを検索" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "モジュール総索引" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "全モジュール早見表" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "関数、クラスおよび用語総覧" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "索引 – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "総索引" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "頭文字別索引" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "大きい場合があるので注意" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "ナビゲーション" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "%(docstitle)s 内を検索" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "このドキュメントについて" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "著作権" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Copyright %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "最終更新: %(last_updated)s" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "%(docstitle)s 内を検索" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "前のトピックへ" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "前の章へ" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "次のトピックへ" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "次の章へ" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "検索機能を使うには JavaScript を有効にしてください。" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "複数の単語を検索すると、次を含む一致のみが表示されます\n     すべての用語。" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "検索" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "検索結果" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "検索した文字列はどの文書にも見つかりませんでした。すべての単語が正確に記述されているか、あるいは、十分なカテゴリーが選択されているか確認してください。" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "クイック検索" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "このページ" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "バージョン %(version)s の変更点 — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "バージョン %(version)s の変更点（このリストは自動生成されています）" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "ライブラリに関する変更" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API に関する変更" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "その他の変更" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "このヘッドラインへのパーマリンク" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "この定義へのパーマリンク" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "検索結果を隠す" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "検索中" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "検索を準備しています..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "検索が完了し、 %s ページ見つけました。" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", in " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "サイドバーを展開" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "サイドバーをたたむ" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "コンテンツ" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "4列ベースのインデックスが見つかりました。あなたが使っている拡張子のバグかもしれません: %r" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "Footnote [%s] は参照されていません。" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "Footnote [#] は参照されていません。" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "翻訳されたメッセージの footnote 参照が矛盾しています。原文: {0}、翻訳: {1}" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "翻訳されたメッセージの参照が矛盾しています。原文: {0}、翻訳: {1}" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "翻訳されたメッセージの引用参照が矛盾しています。原文: {0}、翻訳: {1}" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "翻訳されたメッセージの用語参照が矛盾しています。原文: {0}、翻訳: {1}" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "'any' クロスリファレンス %r のターゲットが1つ以上みつかりました。 %s に参照を設定します。" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "リモート画像を取得できませんでした: %s [%d]" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "リモート画像を取得できませんでした: %s [%s]" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "不明な画像フォーマット: %s..." #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "デコードできないソース文字です。\"?\" に置き換えます: %r" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "スキップしました" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "失敗しました" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "読み取りエラー: %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "書き込みエラー: %s, %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "locale_dir %s は存在しません" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "日付形式が無効です。直接出力したい場合は、文字列を一重引用符で囲みます: %s" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "toctree に存在しないファイルへの参照が含まれています %r" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "only ディレクティブの条件式の評価中に例外が発生しました: %s" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "デフォルトのロール %s が見つかりません" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "%s に numfig_format は定義されていません" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "いくつかの ID が %s ノードに割り当てられていません" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "このテーブルへのパーマリンク" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "このコードへのパーマリンク" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "この画像へのパーマリンク" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "この目次へのパーマリンク" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "画像サイズを取得できませんでした。:scale: オプションは無視されます。" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "不明なクラス %r の toplevel_sectioning %r" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr ":maxdepth: が大きすぎるので無視されます。" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "ドキュメントのタイトルは、単一の Text ノードではありません" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "セクション、トピック、表、訓戒またはサイドバーにないタイトルノードが見つかりました。" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "注記" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "tabularcolumns と :widths: オプションの両方が設定されています。:widths: は無視されます。" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "ディメンション単位 %s が無効です。無視されます。" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "不明なインデックスエントリタイプ %s が見つかりました" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[画像: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[画像]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "キャプションは図の中にはありません。" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "未実装のノードタイプ: %r" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "不明なノードタイプ: %r" �������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3282092 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ko/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015514� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4899156 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ko/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017301� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ko/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000012051�00000000000�021147� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "ko", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">\uc800\uc791\uad8c</a> %(copyright)s.", "© Copyright %(copyright)s.": "© \uc800\uc791\uad8c %(copyright)s.", ", in ": ", \ubb38\uc11c - ", "About these documents": "\uc774 \ubb38\uc11c \uc815\ubcf4", "Automatically generated list of changes in version %(version)s": "\ubc84\uc804 %(version)s\uc758 \ubcc0\uacbd \uc0ac\ud56d (\uc790\ub3d9\uc73c\ub85c \uc0dd\uc131\ub41c \ubaa9\ub85d)", "C API changes": "C API \ubcc0\uacbd \uc0ac\ud56d", "Changes in Version %(version)s — %(docstitle)s": "\ubc84\uc804 %(version)s\uc758 \ubcc0\uacbd \uc0ac\ud56d — %(docstitle)s", "Collapse sidebar": "\uc0ac\uc774\ub4dc\ubc14 \ub2eb\uae30", "Complete Table of Contents": "\uc885\ud569 \ubaa9\ucc28", "Contents": "\ub0b4\uc6a9", "Copyright": "\uc800\uc791\uad8c", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "<a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s \ubc84\uc804\uc73c\ub85c \uc0dd\uc131\ub418\uc5c8\uc2b5\ub2c8\ub2e4.", "Expand sidebar": "\uc0ac\uc774\ub4dc\ubc14 \uc5f4\uae30", "Full index on one page": "\ud55c \ud398\uc774\uc9c0\uc5d0 \uc804\uccb4 \uc0c9\uc778 \ubcf4\uae30", "General Index": "\uc804\uccb4 \uc0c9\uc778", "Global Module Index": "\ubaa8\ub4c8 \ucd1d \uc0c9\uc778", "Go": "\uc774\ub3d9", "Hide Search Matches": "\uac80\uc0c9 \uc77c\uce58 \uc228\uae30\uae30", "Index": "\uc0c9\uc778", "Index – %(key)s": "\uc0c9\uc778 – %(key)s", "Index pages by letter": "\uc54c\ud30c\ubcb3\ubcc4 \uc0c9\uc778", "Indices and tables:": "\uc0c9\uc778 \ubc0f \ud45c \ubaa9\ub85d:", "Last updated on %(last_updated)s.": "\ucd5c\uc885 \uc5c5\ub370\uc774\ud2b8: %(last_updated)s", "Library changes": "\ub77c\uc774\ube0c\ub7ec\ub9ac \ubcc0\uacbd \uc0ac\ud56d", "Navigation": "\ud0d0\uc0c9", "Next topic": "\ub2e4\uc74c \ud56d\ubaa9", "Other changes": "\ub2e4\ub978 \ubcc0\uacbd \uc0ac\ud56d", "Overview": "\uac1c\uc694", "Permalink to this definition": "\uc774 \uc815\uc758\uc5d0 \ub300\ud55c \ud37c\uba38\ub9c1\ud06c", "Permalink to this headline": "\uc774 \ud45c\uc81c\uc5d0 \ub300\ud55c \ud37c\uba38\ub9c1\ud06c", "Please activate JavaScript to enable the search\n functionality.": "\uac80\uc0c9 \uae30\ub2a5\uc744 \uc0ac\uc6a9\ud558\ub824\uba74 JavaScript\ub97c \ud65c\uc131\ud654\ud558\uc2ed\uc2dc\uc624.", "Preparing search...": "\uac80\uc0c9 \uc900\ube44 \uc911\u2026", "Previous topic": "\uc774\uc804 \ud56d\ubaa9", "Quick search": "\ube60\ub978 \uac80\uc0c9", "Search": "\uac80\uc0c9", "Search Page": "\uac80\uc0c9 \ud398\uc774\uc9c0", "Search Results": "\uac80\uc0c9 \uacb0\uacfc", "Search finished, found %s page(s) matching the search query.": "\uac80\uc0c9\uc774 \uc644\ub8cc\ub418\uc5c8\uc73c\uba70, \uac80\uc0c9\uc5b4\uc640 \uc77c\uce58\ud558\ub294 %s \uac1c \ud398\uc774\uc9c0\ub97c \ucc3e\uc558\uc2b5\ub2c8\ub2e4.", "Search within %(docstitle)s": "%(docstitle)s\uc5d0\uc11c \ucc3e\uae30", "Searching": "\uac80\uc0c9 \uc911", "Searching for multiple words only shows matches that contain\n all words.": "\uc5ec\ub7ec \ub2e8\uc5b4\ub97c \uac80\uc0c9\ud558\uba74 \ubaa8\ub4e0 \ub2e8\uc5b4\uac00 \ud3ec\ud568\ub41c \uc77c\uce58 \ud56d\ubaa9\ub9cc \ud45c\uc2dc\ub429\ub2c8\ub2e4.", "Show Source": "\uc18c\uc2a4 \ubcf4\uae30", "Table of Contents": "\ubaa9\ucc28", "This Page": "\ud604\uc7ac \ubb38\uc11c", "Welcome! This is": "\ud658\uc601\ud569\ub2c8\ub2e4!", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "\uac80\uc0c9\uc5b4\uc640 \uc77c\uce58\ud558\ub294 \ubb38\uc11c\uac00 \uc5c6\uc2b5\ub2c8\ub2e4. \ubaa8\ub4e0 \ub2e8\uc5b4\uc758 \ucca0\uc790\uac00 \uc62c\ubc14\ub978\uc9c0, \ucda9\ubd84\ud55c \uce74\ud14c\uace0\ub9ac\ub97c \uc120\ud0dd\ud588\ub294\uc9c0 \ud655\uc778\ud558\uc2ed\uc2dc\uc624.", "all functions, classes, terms": "\ud568\uc218, \ud074\ub798\uc2a4 \ubc0f \uc6a9\uc5b4 \uac1c\uad00", "can be huge": "\ud070 \uacbd\uc6b0\uac00 \uc788\uc73c\ubbc0\ub85c \uc8fc\uc758", "last updated": "\ucd5c\uc885 \uc5c5\ub370\uc774\ud2b8", "lists all sections and subsections": "\ubaa8\ub4e0 \uad6c\uc5ed\uacfc \ud558\uc704 \uad6c\uc5ed \ubaa9\ub85d", "next chapter": "\ub2e4\uc74c \uc7a5", "previous chapter": "\uc774\uc804 \uc7a5", "quick access to all modules": "\ubaa8\ub4e0 \ubaa8\ub4c8 \uc870\uacac\ud45c", "search": "\uac80\uc0c9", "search this documentation": "\ubb38\uc11c \uac80\uc0c9", "the documentation for": "\ubb38\uc11c:" }, "plural_expr": "0" });���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ko/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000242124�00000000000�021154� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������\��������������.����.����$0�����2��E��3��r���4��l���[5�� ���5�����5��*���5�����6��=���6��7���6��H��� 7��?���U7��"���7�� ���7�����7��%���7�����7�����8��!���.8�����P8�����V8�����j8�����|8�� ���8�� ���8�����8�����8�����8�����8�� ���8�����9�� ���!9�� ���-9�� ���79��S���X9�����9��A���9�����:�����:�����3:�����D:�����\:�� ���u:�����:��$���:��6���:�����:�����;��$���.;�����S;��3��� <�� ���A<�����M<�����U<��1���[<��1���<��G���<�����=�����=��0���2=�����c=��H���=�����=��b���`>��;���>�����>�����?��6���5?�����l?�� ���?�� ���?�� ���?�����?�����?��>���?�� ���@��(���@��(���A@�����j@��?���@�����@�� ���@��!���@��8���A��%���;A�����aA�����iA��4���A�� ���A�� ���A�����A�����A�����B�����/B�� ���8B��N���BB��%���B��%���B�����B��:���B��7���6C�����nC��"���C��R���C�����C����� D�� ���D�����D�����;D��N���WD��R���D��`���D�����ZE��&���jE�����E��D���E��H���E��K���%F�����qF�����F�����F��5���F�����F�����F�����F��8���G��=���?G��1���}G��D���G��B���G��0���7H��-���hH��+���H��3���H��'���H��"���I��3���AI��"���uI��:���I��#���I�����I��!���I��:���!J�����\J�� ���|J�� ���J��:���J�����J�����K�� ���K�����K�����K��C���K��*���L�����.L�����BL��3��GL��.���{M�� ���M��.���M�����M�����M�����M��D���N�����ZN�����nN�� ���YO��'���fO�����O��[���O�����O�����P�����:P��Y���LP��!���P�����P��2���P�� ��� Q��C���Q�����ZQ��n���zQ��E���Q�� ���/R�����<R�� ���LR�� ���XR��-���eR��(���R�� ���R�����R�� ���R��(���R����� S�����&S�����7S��Z���<S�����S�����S��,���S����S�����T�����T�� ���U��(���U�����FU�����OU�� ���eU�����pU�����U�����U�����U�����U�����U����� V�����!V��&���;V��B���bV��i���V��2���W��I���BW��4���W�����W�����W�����X�����X��y���1X�����X�����X�����X�����X�� ���X�����Y�����Y�����%Y��#���5Y��$���YY�����~Y�� ���Y�����Y�����Y�����Y�� ���Y�����Y�� ���Y�� ���Y�����Y�����Y�����Z�����(Z�����/Z�� ���DZ�����PZ��<���_Z�����Z�� ���Z��K���Z�� ���[�����[�����*[�����3[��+���J[�� ���v[��k���[��>���[�����-\��#���@\��-��d\�����]�����]�����]�����]�����]�����]��Y���]��Z���J^��*���^��3���^��/���_��(���4_��.���]_��P���_��p���_�����N`��!���n`��"���`��$���`�� ���`��e���`��Z���_a��N���a��T��� b��K���^b��%���b�����b�����b��[���xc��#���c��'���c��#��� d��I���Dd��'���d��!���d��=���d��7���e�� ���Ne�����Xe��d���e��W���Xf��v���f�����'g�����.g�����2g�� ���7g��3���Xg�����g�����g��"���g��7���g��<���h��Y���Wh�� ���h�����h�����h��,���h�����h�����i�����i�����$i��Y���i�����Hj��%���j��,���j�����&k�����Bk�� ���Ik�����Uk�� ���]k�����ik�����qk��N���zk�����k��?���Ul��-���l��2���l�� ���l�����m�����m�����5m�����Hm��9���Ym�����m�� ���m�� ���m��X���m��d���n��,���n��2���n��b���n��5���Fo��\���|o�� ���o��M���o��(���Hp��G���qp�����p��7���p�����q��8���q�����Uq�� ���lq��%���vq��`���q�����q�����r�����:r�����Jr�����Zr�� ���lr��&���xr��$���r�����r�����r�����r�����s�����,s��A���Ls��Z���s��-���s�����t�����6t�����St��!���ht��8���t�����t�� ���t�����t�����t��7���t��6���*u��;���au��I���u��;���u��:���#v��H���^v��9���v��G���v��2���)w��2���\w�����w��4���w�����w�����w�����x��C���x��G���bx��2���x�����x�����x�����y�����2y�����Ky�����jy�����~y�����y�����y��(���y��=���y�����%z�����6z��0���Fz�����wz�����|z��/���z�����z��*���z��&��� {�� ���3{��9���={�����w{�����{�� ���{�����{��-���{����� |�����"|��1���9|��*���k|�����|�����|��0���|��&���|����� }�����}��(���?}�����h}�����x}�����}��%���}��e���}�����>~��4���~������������Y���*��;�����.������������������'��.���B��4���q��+�����4���Ҁ��(�����4���0��W���e����������܁�������X��� ��J���e�������%����� ���ۂ������������+�����+���@�����l������� �����8�����M�����u���7���������������҄�����ل�������A��� �� ���N�����Y��6���x��I�����A��������;��0���V�������G�����N��������5�����>�����Q��.���a�������4����� ���؇��,�����3����� ���G��=���U�������r�����'���#��0���K��(���|��1�����/���׉��,�����!���4�����V�����u�������=�����+�����0�����V���G��V�����M�����R���C��$���������������N���Ռ��0���$��)���U�����������������/���Ѝ����������������9��&���P��!���w��+�����)���Ŏ��-�����-�����&���K�����r��E���z�� �����*���͏��7�����"���0��(���S�����|���������������Ԑ��"���������������4���1��4���f�������&�����;���ב������������"���!��!���D��H���f�������#��������ڒ��D�����5���'��D���]�� ���������� �����1�����E�����B���7��G���z��%���”�������#�����#���&��,���J�����w��-�����(�����D�����!���/�� ���Q��#���\��(�����#��������͖�����Ԗ�����ݖ��(�������������.��8���3�� ���l��P�����"���ޗ������������O���5����������������������%���Ș�� ����������,��� �� ���8��(���E��E���n�� �����*����������1�����7���'�����_�� ���{��������������������Ú�����ٚ�������&��������#�����;��4���@�����u��%����������c�������������5�� ���<��'���H��:���p�� �����@���̜����� ����������2��&���E��*���l��&�����W�����>�����7���U��K����� ���ٞ�� ���������� �����,�����*���/��0���Z�������%��������ϟ����������z��1�����1���D�����v��\����������'�����%���-��+���S��^�����2���ޢ��5��������G�����f�������5����������&���ϣ��#�����&�����*���A�����l�������+�����-�����%����������!���*��!���L�����n��!���������������#���ƥ��*������������������1��P���H�������)�����9�����;�����)���X������������&��������ħ�����ݧ���������������(�����E�����^�����x������������������y����D����L��v��b�����ٱ������� ���3�� ���@��-���J�����x��O�����I���g��Y�����Q��� ��"���]������� �����.�����!���ϵ��$�����)��������@�� ���F�����S�����e�� ���w�� �����������������������ȶ�� ���׶������� ����� �����4�����r���T�����Ƿ��V���۷��(���2�� ���[�����|���������������ø�����Ը��,�����6��������I��.���i��7��������й��9���ú������� ��� �� �����8���#��8���\��o���������������5���/�����e��J��������ͼ��~���{��Z�����*���U�������O�����+�����#��������2�����9�����@�� ���Q��C���]�������9�����4�����5���%��g���[������������3�����O�����=���b������������9�����1��������*�����=�� ���Q��+���_������� �����c�����7������7���8��3���p��b�����R�����(���Z��5�����g�����$���!�����F�� ���M�����W��)���q��Z�����^��������U�������.����������U�����_���s��S�����+���'�����S�����Z��4���a�����������������M�����U�����G���r��b�����`�����A���~��>�����A�����B���A��=�����3�����H�����3���?��f���s��&����� �����2��� ��?���>��+���~��1����������H��������,��%����� ���"�����0�����B��Y���I��I���������������Z�� ��9���g�������D������������������ ��X��������x��<���������H��������,��p���A�����������������x�����%����������C����� ��� ��T����� ���h��z�����l����� ���q������� ����� �����-�����5��������������� ���-��F���;��$���������������p��������0�����7��I���>��,�������������������<��������+�����2�� ���H��!���U��!���w��!�����!�����$����������!���!��!���C��G���e��E����������C���|��c�����G���$��.���l��%�����$����� ��������������� ����������������������������&�����=��F���Q������������ ����� �������������������� ����� ��� �� ��������%�����,�����D�����`�����g������� �����\���������� �����Z���$�� ���������� ����������*����� ����������E����������=�����y��)�� ������������������������������u�����p���j��0�����9��� ��6���F��.���}��6�����d��������H��-�����-�����+���E��-���q��)����������l���Y��j�����n���1��X�����5�����*���/�����Z��m�����2���_��5�����,�����M�����0���C��/���t��9�����3����� �������� ��o�����s���X����������W�����^�����b��0���j��?�����#�����&�����>���&��G���e��W�����s��������y������������F����������������������� ��d��������^��:�����&���2�����Y�����t�����}�� ����� ���������������m��������&��M�����9���-��>���g�� ����������#���������������:��������X�����q�����x��d�����y�����*���h��9����������L���b��h�����5�����q���N��5�����_��������V��L���p��/�����L�����/���:�� ���j��(���u�������1���$��"���V�����y������� �����!�����?�����G��� ��/���U��:�����/�����%�����8����c���O�����H���4�:���}�,������������F���� ���_����i����}� ����7����F����K����]���c�K����J��� �[���X�I����E����E���D�B��������:�����������1����O�b���j�e����J���3�%���~�(����)����!����5��� �!���O �!���q �$��� �!��� �A��� �I��� ����f ����{ �@��� � ��� �*��� �3��� ����5 �:���M �@��� � ��� �A��� ���� �'���& �'���N ����v �/��� �$��� ���� �?��� �7���? ����w ���� �3��� �9��� � ����3����2���J����}�)����0����!����a��� ����m�D���9����~�����x����M����F���^�3��������$����F����G���d�5����;����8����B���W�u����"�������3����K�w���j�Y���� ���<�7���F� ���~� ��������?����?�������(����D����_�;���f�Y��������������������&����%����L���!� ���n�3���y�S����d����f���f�!����,���� ����J���=�`������������ ����/�������B�V���T� ����,����6���� ����V���+���������.���6�<���e�/����=����S����B���d�#����1����)�������'�D���@�3����<����[����[���R �T��� �[���!� ���_!����!����!�L���!�K���!�/���7"����g"�'���"�&���"�P���"����!#� ���=#�!���^#�2���#�&���#�1���#�/��� $�2���<$�2���o$�'���$� ���$�c���$����8%�3���L%�/���%�%���%�0���%�.���&�#���6&�/���Z&�2���&�"���&� ���&�!���&�;��� '�;���H'����'�8���'�A���'� ���(� ���%(�*���/(� ���Z(�J���{(����(�+���(����(�g����)�F���h)�c���)����*����$*� ���+*�D���6*�P���{*�W���*�R���$+�:���w+�.���+�(���+�5��� ,�9���@,�!���z,�M���,�=���,�R���(-�5���{-����-�5���-�C���-�1���@.����r.� ���y.� ���.����.����.� ���.�I���.����/�K���</����/����/����/�H���/�$���*0����O0����a0� ���h0�8���s0� ���0����0�2���0����1�5���1�d���K1� ���1�/���1����2�9���2�3���B2����v2����2����2����2����2����2����3����3�/���,3����\3����q3�>���x3����3�1���3����4���� 4� ���4� ���4� ���4�C���4�G���4�&���?5�K���f5� ���5� ���5����5�%���5�:���6�5���Y6�e���6�N���6�A���D7�p���7����7����7� ��� 8����8�$���8�$���B8�(���g8�!���8�1���8����8����8����9�>���:�>���:����:�u���;�$���};�-���;�+���;�C���;�k���@<�9���<�C���<�-���*=����X=� ���s=�H���}=�!���=�0���=�1���>�.���K>�7���z>�%���>� ���>�4���>�:���?�4���R?�&���?�8���?�<���?� ���$@�?���E@����@� ���@�*���@�C���@����A����$A� ���;A�\���\A����A�C���A�D���B�J���_B�0���B� ���B� ���B�+���C����3C����LC� ���hC����C�%���C����C����C����D����D����7D�� Generate ReStructuredText using autosummary directives. sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates the reStructuredText files from the autosummary directives contained in the given input files. The format of the autosummary directive is documented in the ``sphinx.ext.autosummary`` Python module and can be read using:: pydoc sphinx.ext.autosummary � Generate documentation from source files. sphinx-build generates documentation from the files in SOURCEDIR and places it in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration settings. The 'sphinx-quickstart' tool may be used to generate template files, including 'conf.py' sphinx-build can create documentation in different formats. A format is selected by specifying the builder name on the command line; it defaults to HTML. Builders can also perform other tasks related to documentation processing. By default, everything that is outdated is built. Output only for selected files can be built by specifying individual filenames. � Generate required files for a Sphinx project. sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build. � Look recursively in <MODULE_PATH> for Python modules and packages and create one reST file with automodule directives per package in the <OUTPUT_PATH>. The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be excluded from generation. Note: By default this script will not overwrite already created files.� Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� Run 'make' in that directory to run these through makeinfo (use 'make info' here to do that automatically).� (deprecated)� (in �"::" in automodule name doesn't make sense�":file:" option for csv-table directive now recognizes an absolute path as a relative path from source directory. Please update your document.�"latex_documents" config value references unknown document %s�"man_pages" config value references unknown document %s�"quiet" is specified, but any of "project" or "author" is not specified.�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%r doesn't have "%s" setting�%r doesn't have "theme" setting�%r reference target not found: %s�%s %s�%s %s documentation�%s (%s attribute)�%s (%s property)�%s (C %s)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command %r cannot be run (needed for math display), check the imgmath_%s setting�%s command line option�%s is already assigned section numbers (nested numbered toctree?)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�%s:%s reference target not found: %s�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �-A option argument must be in the form name=value�-D option argument must be in the form name=value�4 column based index found. It might be a bug of extensions you use: %r�:%s: (directive option)�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�====================== slowest reading durations =======================�A Makefile and a Windows command file can be generated for you so that you only have to run e.g. `make html' instead of invoking sphinx-build directly.�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�A captioned autosummary requires :toctree: option. ignored.�A mocked object is detected: %r�About these documents�An error happened in rendering the page %s. Reason: %r�Anchor '%s' not found�Any IDs not assigned for %s node�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not determine the fallback text for the cross-reference. Might be a bug.�Could not fetch remote image: %s [%d]�Could not fetch remote image: %s [%s]�Could not import extension %s�Could not lex literal_block as "%s". Highlighting skipped.�Could not obtain image size. :scale: option is ignored.�Create Makefile? (y/n)�Create Windows command file? (y/n)�Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> %(sphinx_version)s.�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Duplicate C declaration, also defined at %s:%s. Declaration is '.. c:%s:: %s'.�Duplicate C++ declaration, also defined at %s:%s. Declaration is '.. cpp:%s:: %s'.�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Encoding error:�Enter the root path for documentation.�Error�Error: an existing conf.py has been found in the selected root path.�Error: specified path is not a directory, or sphinx files already exist.�Error: the master file %s has already been found in the selected root path.�Event %r already present�Example�Examples�Exception occurred while building, starting debugger:�Exception occurred:�Expand sidebar�Extension options�External Graphviz file %r not found or reading it failed�Failed to compile regex in linkcheck_allowed_redirects: %r %s�Failed to copy a file in html_static_file: %s: %r�Failed to create a cross reference. A title or caption not found: %s�Failed to create a cross reference. Any number is not assigned: %s�Failed to get a constructor signature for %s: %s�Failed to get a function signature for %s: %s�Failed to get a method signature for %s: %s�Failed to parse a default argument value for %r: %s�Failed to parse type_comment for %r: %s�Failed to read build info file: %r�Failed to read intersphinx_mapping[%s], ignored: %r�Failed to scan documents in %s: %r�Failed to update signature for %r: parameter not found: %s�Failed to write build info file: %r�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnote [#] is not referenced.�Footnote [%s] is not referenced.�Footnotes�For more information, visit <https://www.sphinx-doc.org/>.�For security reasons, parallel mode is disabled on macOS and python3.8 and above. For more details, please read https://github.com/sphinx-doc/sphinx/issues/6803�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Handler %r for event %r threw an exception�Hide Search Matches�Hint�If the documents are to be written in a language other than English, you can select a language here by its language code. Sphinx will then translate text that it generates into that language. For a list of supported codes, see https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indicate which of the following Sphinx extensions should be enabled:�Indices and tables:�Inside the root directory, two more directories will be created; "_templates" for custom HTML templates and "_static" for custom stylesheets and other static files. You can enter another prefix (such as ".") to replace the underscore.�Interrupted!�Invalid __slots__ found on %s. Ignored.�Invalid caption: %s�Invalid date format. Quote the string by single quote if you want to output it directly: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�Keyword Arguments�LaTeX command %r cannot be run (needed for math display), check the imgmath_latex setting�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Look for any errors in the above output or in %(outdir)s/output.txt�Makefile and Batchfile creation�Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Many math_renderers are registered. But no math_renderer is selected.�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Non-alphabetical�Note�Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.�Notes�Numbers�Object named %r not found in include file %r�One document is special in that it is considered the top node of the "contents tree", that is, it is the root of the hierarchical structure of the documents. Normally, this is "index", but if your "index" document is a custom template, you can also set this to another filename.�Original exception: �Other Parameters�Other changes�Output directory (%s) is not a directory�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this term�Permalink to this toctree�Pillow not found - copying image files�Please activate JavaScript to enable the search functionality.�Please also report this if it was a user error, so that a better error message can be provided next time.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter a new file name, or rename the existing file and press Enter�Please enter a new root path (or just Enter to exit)�Please enter a valid path name.�Please enter either 'y' or 'n'.�Please enter one of %s.�Please enter some text.�Please enter values for the following settings (just press Enter to accept a default value, if one is given in brackets).�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project templating�Project version�Pygments lexer name %r is not known�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Receives�Recursion error:�References�Release�Return type�Return values�Returns�Root path for the documentation�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Searching for multiple words only shows matches that contain all words.�Section %s�Section author: �See also�Selected root path: %s�Separate source and build directories (y/n)�Show Source�Since v2.0, Sphinx uses "index" as root_doc by default. Please add "root_doc = 'contents'" to your conf.py.�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Sphinx has the notion of a "version" and a "release" for the software. Each version can have multiple releases. For example, for Python the version is something like 2.5 or 3.0, while the release is something like 2.5.1 or 3.0a1. If you don't need this dual structure, just set both to the same value.�Structure options�Symbols�TODO entry found: %s�Table %s�Table of Contents�Template Parameters�Testing of coverage in the sources finished, look at the results in %(outdir)spython.txt.�Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt.�The %r crossref_type is already registered�The %r directive is already registered to domain %s�The %r index is already registered to domain %s�The %r object_type is already registered�The %r role is already registered to domain %s�The %s extension is required by needs_extensions settings, but it is not loaded.�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.�The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.�The config value `{name}' has type `{current.__name__}'; expected {permitted}.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The dummy builder generates no files.�The ePub file is in %(outdir)s.�The file name suffix for source files. Commonly, this is either ".txt" or ".rst". Only files with this suffix are considered documents.�The full traceback has been saved in %s, if you want to report the issue to the developers.�The manual pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�The overview file is in %(outdir)s.�The project name will occur in several places in the built documentation.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This can happen with very large or deeply nested source files. You can carefully increase the default Python recursion limit of 1000 in conf.py with e.g.:�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Translator for %r already exists�Unknown configure key: latex_elements[%r], ignored.�Unknown event name: %s�Unknown image format: %s...�Unknown math_renderer %r is given.�Unknown theme option: latex_theme_options[%r], ignored.�Use the Makefile to build the docs, like so: make builder�Use the sphinx-build command to build the docs, like so: sphinx-build -b builder %s %s�Variables�Warning�Warns�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�Would create file %s.�Yields�You have two options for placing the build directory for Sphinx output. Either, you use a directory "_build" within the root path, or you separate "source" and "build" directories within the root path.�You should now populate your master file %s and create other documentation source files. �Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[autosummary] failed to import %r: %s�[autosummary] generating autosummary for: %s�[autosummary] writing to %s�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.�a list of specific files to rebuild. Ignored if -a is specified�a suitable image for %s builder not found: %s�a suitable image for %s builder not found: %s (%s)�alias of %s�alias of TypeVar(%s)�all functions, classes, terms�all of %d po files�all source files�append module_path to sys.path, used when --full is given�assembling single document�attribute�author names�autodoc: failed to determine %r to be documented, the following exception was raised: %s�autodoc_member_order now accepts "alphabetical" instead of "alphabetic". Please update your setting.�automatically insert docstrings from modules�automatically test code snippets in doctest blocks�autosummary generats .rst files internally. But your source_suffix does not contain .rst. Skipped.�autosummary references excluded document %r. Ignored.�autosummary: failed to determine %r to be documented, the following exception was raised: %s�autosummary: failed to import %s�autosummary: stub file not found %r. Check your autosummary_generate setting.�autosummary_generate: file not found: %s�both tabularcolumns and :widths: option are given. :widths: is ignored.�broken link: %s (%s)�build %s, %s warning (with warnings treated as errors).�build %s, %s warning.�build %s, %s warnings (with warnings treated as errors).�build %s, %s warnings.�build %s.�build environment version not current�build in parallel with N processes where possible (special value "auto" will set N to cpu-count)�build info file is broken: %r�builder to use (default: html)�building [%s]: �building [mo]: �built-in function�can be huge�cannot combine -a option and filenames�cannot copy downloadable file %r: %s�cannot copy extra file %r�cannot copy image file %r: %s�cannot copy static file %r�cannot find files %r�cannot open warning file %r: %s�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�cannot read image file %r: copying it instead�cannot write image file %r: %s�caption not inside a figure.�checking consistency�checks for documentation coverage�circular toctree references detected, ignoring: %s <- %s�class�class method�command line option�concept�conditional inclusion of content based on config values�conf value "epub_author" should not be empty for EPUB3�conf value "epub_contributor" should not be empty for EPUB3�conf value "epub_copyright" (or "copyright")should not be empty for EPUB3�conf value "epub_description" should not be empty for EPUB3�conf value "epub_identifier" should not be empty for EPUB3�conf value "epub_language" (or "language") should not be empty for EPUB3�conf value "epub_publisher" should not be empty for EPUB3�conf value "epub_title" (or "html_title") should not be empty for EPUB3�conf value "epub_uid" should be XML NAME for EPUB3�conf value "version" should not be empty for EPUB3�config changed�config directory doesn't contain a conf.py file (%s)�console output options�continued from previous page�continues on next page�convert command %r cannot be run, check the image_converter setting�convert command %r cannot be run, check the image_converter setting: %s�convert exited with error: [stderr] %r [stdout] %r�copying TeX support files�copying TeX support files...�copying Texinfo support files�copying additional files�copying downloadable files... �copying extra files�copying images... �copying source files...�copying static files�could not read %r for changelog creation�create .nojekyll file to publish the document on GitHub pages�create batchfile�create makefile�custom template directory (default: %(default)s)�data�default role %s not found�default suffix for files (default: %(default)s)�define a template variable�define tag: include "only" blocks with TAG�dimension unit %s is invalid. Ignored.�directive�directive %r is already registered, it will be overridden�directive-option�directory to place all output�directory to place all output in�display latex %r: %s�do emit colored output (default: auto-detect)�do not create batchfile�do not create makefile�do not emit colored output (default: auto-detect)�do not use make-mode for Makefile/make.bat�docnames to write: %s�document�document imported members (default: %(default)s)�document isn't included in any toctree�document language�document not readable. Ignored.�document title is not a single Text node�doing serial %s�domain %s already registered�domain %s not yet registered�don't create a table of contents file�don't create headings for the module/package packages (e.g. when the docstrings already contain them)�don't know which module to import for autodocumenting %r (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)�don't use a saved environment, always read all files�done�dot code %r: %s�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�dot did not produce an output file: [stderr] %r [stdout] %r�dot exited with error: [stderr] %r [stdout] %r�download file not readable: %s�dumping object inventory�dumping search index in %s�duplicate %s description of %s, other %s in %s�duplicate %s description of %s, other instance in %s�duplicate citation %s, other instance in %s�duplicate description of %s %s, other instance in %s�duplicate label %s, other instance in %s�duplicate label of equation %s, other instance in %s�duplicate object description of %s, other instance in %s, use :noindex: for one of them�duplicated ToC entry found: %s�enable %s extension�enable arbitrary extensions�encountered some issues with some of the inventories, but they had working alternatives:�encountered title node not in section, topic, table, admonition or sidebar�enum�enumerable_node %r already registered�enumerator�environment variable�environment variable; %s�error while formatting arguments for %s: %s�error while formatting signature for %s: %s�error writing file %s: %s�error writing file Makefile: %s�exception�exception while evaluating only directive expression: %s�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extension options�extensions changed�failed�failed to import object %s�failed to parse name %s�failed to reach any of the inventories with the following issues:�failed: %s�favicon file %r does not exist�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�filename of table of contents (default: modules)�finished with problems�fnmatch-style file and/or directory patterns to exclude from generation�follow symbolic links. Powerful when combined with collective.recipe.omelette.�function�function parameter�general options�generate a full project with sphinx-quickstart�generating indices�glossary seems to be misformatted, check indentation�glossary term�glossary term must be preceded by empty line�glossary terms must not be separated by empty lines�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�highlighting module code... �html_add_permalinks has been deprecated since v3.5.0. Please use html_permalinks and html_permalinks_icon instead.�html_extra_path entry %r does not exist�html_extra_path entry %r is placed inside outdir�html_static_path entry %r does not exist�html_static_path entry %r is placed inside outdir�if specified, create build dir under source dir�if specified, separate source and build dirs�ignoring invalid doctest code: %r�image file %s not readable: %s�image file not readable: %s�include "_private" modules�include links to the source code of documented Python objects�include math, rendered as PNG or SVG images�include math, rendered in the browser by MathJax�inconsistent citation references in translated message. original: {0}, translated: {1}�inconsistent footnote references in translated message. original: {0}, translated: {1}�inconsistent references in translated message. original: {0}, translated: {1}�inconsistent term references in translated message. original: {0}, translated: {1}�increase verbosity (can be repeated)�index�inline latex %r: %s�interpret module paths according to PEP-0420 implicit namespaces specification�intersphinx identifier %r is not string. Ignored�intersphinx inventory has moved: %s -> %s�invalid TestCode type�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�invalid regex %r in %s�invalid regex %r in coverage_c_regexes�invalid signature for auto%s (%r)�invalid value for class-doc-from option: %s�invalid value for member-order option: %s�invalid value set (missing closing brace): %s�invalid value set (missing opening brace): %s�job number should be a positive number�keyword�kwargs for add_node() must be a (visit, depart) function tuple: %r=%r�last updated�line number spec is out of range(1-%d): %r�link between Sphinx documentation of different projects�lists all sections and subsections�loading intersphinx inventory from %s...�loading pickled environment�loading translations [%s]... �locale_dir %s does not exists�logo file %r does not exist�looking for now-outdated files... �macro�making output directory�malformed string literal (missing closing quote): %s�malformed string literal (missing opening quote): %s�master document name�math renderer %s is already registered�maximum depth of submodules to show in the TOC (default: 4)�member�method�missing '+' or '-' in '%s' option.�missing attribute %s in object %s�missing attribute mentioned in :members: option: module %s, attribute %s�module�module %s could not be imported: %s�modules�more than one target found for 'any' cross-reference %r: could be %s�more than one target found for cross-reference %r: %s�multiple files found for the document "%s": %r Use %r for the build.�new config�next�next chapter�nit-picky mode, warn about all missing references�no "latex_documents" config value found; no documents will be written�no "man_pages" config value found; no manual pages will be written�no "texinfo_documents" config value found; no documents will be written�no Babel option known for language %r�no changes in version %s.�no code/output in %s block at %s:%s�no output at all, not even warnings�no output on stdout, just warnings on stderr�no targets are out of date.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�non-whitespace stripped by dedent�none found�not available for built-in messages�numfig is disabled. :numref: is ignored.�numfig_format is not defined for %s�object�operator�original entry�override a setting in configuration file�overwrite existing files�page�page %s matches two patterns in html_sidebars: %r and %r�pass a value into HTML templates�path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)�path to documentation source files�path to module to document�path to output directory�path where configuration file (conf.py) is located (default: same as SOURCEDIR)�pickling environment�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�program option�project author(s), used when --full is given�project name�project name (default: root module name)�project release, used when --full is given, defaults to --doc-version�project root�project version, used when --full is given�property�put documentation for each module on its own page�put module documentation before submodule documentation�quick access to all modules�quiet mode�reST markup error:�reading error: %s, %s�reading sources... �reading templates... �reference label�release of project�replacement for dot in _templates etc.�resolving references...�role�role %r is already registered, it will be overridden�run Pdb on exception�run the script without creating files�search�search index couldn't be loaded, but not all documents will be built: the index will be incomplete.�search this documentation�see %s�see also %s�self referenced toctree found. Ignored.�setting %s.%s occurs in none of the searched theme configs�show full traceback on exception�signature arguments or return annotation given for automodule %s�skipped�source directory has changed�source file suffix�source files to generate rST files for�source_parser for %r is already registered�source_suffix %r is already registered�sphinx-quickstart only generate into a empty directory. Please specify a new root path.�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0�statement�static method�struct�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�targets for %d template files�template directory for template files�template parameter�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension is not safe for parallel reading�the %s extension is not safe for parallel writing�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�toctree contains ref to nonexisting file %r�toctree contains reference to document %r that doesn't have a title: no link will be generated�toctree contains reference to excluded document %r�toctree contains reference to nonexisting document %r�too large :maxdepth:, ignored.�turn warnings into errors�type�undecodable source characters, replacing with "?": %r�undefined label: %s�undocumented c api: %s [%s] in file %s�undocumented python class: %s :: %s�undocumented python function: %s :: %s�undocumented python method: %s :: %s :: %s�unimplemented node type: %r�union�unknown %r toplevel_sectioning for class %r�unknown config value %r in override, ignoring�unknown directive or role name: %s:%s�unknown index entry type %r�unknown index entry type %s found�unknown mimetype for %s, ignoring�unknown node type: %r�unsupported theme option %r given�updating environment: �use epub�use make-mode for Makefile/make.bat�use no config file at all, only -D options�variable�version of project�waiting for workers...�where "builder" is one of the supported builders, e.g. html, latex or linkcheck.�while setting up extension %s:�with -W, keep going when getting warnings�write "todo" entries that can be shown or hidden on build�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing�writing %s file...�writing META-INF/container.xml file...�writing additional files�writing additional pages�writing content.opf file...�writing error: %s, %s�writing message catalogs... �writing mimetype file...�writing nav.xhtml file...�writing output... �writing summary file...�writing toc.ncx file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: ko Language-Team: Korean (http://www.transifex.com/sphinx-doc/sphinx-1/language/ko/) Plural-Forms: nplurals=1; plural=0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � autosummary 지시문을 사용하여 ReStructuredText를 생성합니다. sphinx-autogen은 sphinx.ext.autosummary.generate의 프런트엔드입니다. 주어진 입력 파일에 포함된 autosummary 지시문에서 reStructuredText 파일을 생성합니다. autosummary 지시문의 형식은 ``sphinx.ext.autosummary`` Python 모듈에 문서화되어 있으며 다음 명령을 사용하여 읽을 수 있습니다. pydoc sphinx.ext.autosummary � 소스 파일로부터 문서를 생성합니다. sphinx-build는 SOURCEDIR에 있는 파일로부터 문서를 생성하여 OUTPUTDIR에 저장합니다. 구성 설정을 위해 SOURCEDIR에서 'conf.py' 파일을 찾습니다. 'sphinx-quickstart' 도구는 'conf.py'를 포함하여 템플릿 파일을 생성하는 데 사용할 수 있습니다. sphinx-build는 다양한 형식으로 문서를 생성할 수 있습니다. 형식은 명령줄에서 빌더 이름을 지정하여 선택하며, 기본값은 HTML입니다. 빌더는 문서 처리와 관련한 다른 태스크를 수행할 수도 있습니다. 기본적으로 오래된 모든 항목을 빌드합니다. 개별 파일명을 지정하여 선택한 파일에 대한 출력만 빌드할 수 있습니다. � Sphinx 프로젝트에 필요한 파일을 생성합니다. sphinx-quickstart는 대화형 도구로서, 프로젝트에 대한 몇 가지 질문을 한 다음 완전한 문서 디렉토리와 (sphinx-build와 함께 사용할 수 있는) 견본 Makefile을 생성합니다. � <MODULE_PATH>에서 Python 모듈 및 패키지를 재귀적으로 찾고 automodule 지시문이 있는 패키지 당 하나의 reST 파일을 <OUTPUT_PATH>에 만듭니다. <EXCLUDE_PATTERN>은 생성에서 제외할 파일 또는 디렉토리 패턴일 수 있습니다. 참고: 기본적으로이 스크립트는 이미 생성된 파일을 덮어 쓰지 않습니다.� (pdf)latex을 통해 작업하려면 해당 디렉토리에서 'make'를 실행하십시오 (자동으로 수행하려면 여기에서 'make latexpdf'를 사용하십시오).� makeinfo를 통해 작업하려면 해당 디렉토리에서 'make'를 실행하십시오 (자동으로 수행하려면 여기에서 'make info'를 사용하십시오).� (폐지됨)� (문서 �automodule 이름의 "::"은 의미가 없음�csv-table 지시문의 ":file:" 옵션은 이제 절대 경로를 소스 디렉토리의 상대 경로로 인식합니다. 문서를 업데이트하십시오.�"latex_documents" 설정값이 알 수 없는 문서 %s을(를) 참조합니다�"man_pages" 설정값이 알 수 없는 문서 %s을(를) 참조합니다�"quiet"이 지정되었지만, "project" 또는 "author"가 정의되지 않았습니다.�"texinfo_documents" 설정값이 알 수 없는 문서 %s을(를) 참조합니다�%(filename)s — %(docstitle)s�%Y년 %m월 %d일�%d 개 찾음�명령줄에 지정된 %d 개의 원본 파일�%r에 "%s" 설정이 없습니다�%r에 "theme" 설정이 없습니다�%r 참조 대상을 찾을 수 없음: %s�%s %s�%s %s 문서�%s (%s의 속성)�%s (%s의 특성)�%s (C %s)�%s (C++ %s)�%s (내장 클래스)�%s (내장 변수)�%s (%s 클래스)�%s (지시문)�%s (전역 변수 또는 상수)�%s (%s 모듈)�%s (모듈)�%s (역할)�%s 개 추가됨, %s 개 변경됨, %s 개 제거됨�%s 명령 %r을(를) 실행할 수 없습니다 (수식 표시에 필요). imgmath_%s 설정을 확인하십시오�%s 명령줄 옵션�%s에 이미 구역 번호가 할당되었습니다 (중첩된 번호 붙인 toctree?)�%s은(는) 디렉토리가 아닙니다.�%s() (%s의 클래스 메서드)�%s() (%s 메서드)�%s() (%s의 정적 메서드)�%s() (내장 함수)�%s() (클래스)�%s() (%s 모듈)�%s:%s 참조 대상을 찾을 수 없음: %s�© <a href="%(path)s">저작권</a> %(copyright)s.�© 저작권 %(copyright)s.�'%s'은(는) 유효한 옵션이 아닙니다.�'%s'은(는) 유효한 pyversion 옵션이 아닙니다�현재 conf.py 파일에 정의된 'setup'은 호출 가능한 Python 객체가 아닙니다. 호출 가능한 함수가 되도록 정의를 수정하십시오. 이것은 conf.py가 Sphinx 확장 기능으로 동작하는 데 필요합니다.�(<<원래 항목>>은 %s 파일, %d 행에 있습니다.)�(%s v%s에서)�(%s에서)�, 문서 - �-A 옵션 인수는 name=value 형식이어야 합니다�-D 옵션 인수는 name=value 형식이어야 합니다�4 개 열 기반 색인을 찾았습니다. 사용하고 있는 확장 기능의 버그일 수 있습니다: %r�:%s: (지시문 옵션)�<<원래 항목>>�<h1>코드를 확인할 수 있는 모든 모듈</h1>�<h1>%s의 소스 코드</h1>�====================== 가장 느린 읽기 시간 =======================�Makefile 및 Windows 명령 파일을 생성할 수 있으므로, sphinx-build를 직접 호출하는 대신 (예를 들어) `make html'을 실행하기만 하면 됩니다.�버그 보고서는 <https://github.com/sphinx-doc/sphinx/issues>의 트래커에 제출할 수 있습니다. 감사합니다!�캡션이 있는 자동 요약에는 :toctree: 옵션이 필요합니다. 무시합니다.�모의 객체가 감지되었습니다: %r�이 문서 정보�%s 페이지를 렌더링하는 중에 오류가 발생했습니다. 원인: %r�앵커 '%s'을(를) 찾을 수 없습니다�%s 노드에 할당되지 않은 ID�인수�주의�작성자 이름�작성자: �버전 %(version)s의 변경 사항 (자동으로 생성된 목록)�기반 클래스: %s�%r 빌더가 이미 존재합니다 (%s 모듈에 있음)�빌더 클래스 %s에 "name" 속성이 없습니다�빌더 이름 %s이(가) 등록되지 않았습니다�빌더 이름 %s이(가) 등록되지 않았거나 진입점을 통해서만 사용할 수 있습니다�내장�C API 변경 사항�원본 디렉토리를 찾을 수 없습니다 (%s)�분리된 "lines" 집합과 함께 "lineno-match"를 사용할 수 없습니다�"%s"과(와) "%s" 옵션을 모두 사용할 수 없습니다�조심�버전 %s에서 변경�버전 %(version)s의 변경 사항 — %(docstitle)s�인용 [%s]이(가) 참조되지 않았습니다.�코드 작성자: �사이드바 닫기�종합 목차�설정값 %r이(가) 이미 존재합니다�내용�저작권�상호 참조에 대한 대체 텍스트를 결정할 수 없습니다. 버그일 수 있습니다.�원격 이미지를 가져올 수 없습니다: %s [%d]�원격 이미지를 가져올 수 없습니다: %s [%s]�확장 기능 %s을(를) 가져올 수 없습니다�literal_block을 "%s"(으)로 구문 분석할 수 없습니다. 구문 강조를 건너뜁니다.�이미지 크기를 얻어올 수 없습니다. :scale: 옵션을 무시합니다.�Makefile을 만드시겠습니까? (y/n)�Windows 명령 파일을 만드시겠습니까? (y/n)�<a href="https://www.sphinx-doc.org/">Sphinx</a> %(sphinx_version)s 버전으로 생성되었습니다.�%s 파일을 만드는 중입니다.�위험�폐지됨�버전 %s부터 폐지됨�%r 영역이 등록되지 않았습니다�중복 C 선언이며, %s:%s에 정의되었습니다. 선언은 '.. c:%s:: %s' 입니다.�중복 C++ 선언이며, %s:%s에 정의되었습니다. 선언은 '.. cpp:%s:: %s' 입니다.�포함 파일 %r을 읽는데 사용한 %r 인코딩이 잘못된 것 같습니다. :encoding: 옵션을 지정해 보십시오�인코딩 오류:�문서의 루트 경로를 입력하십시오.�오류�오류: 선택한 루트 경로에서 기존 conf.py 파일이 발견되었습니다.�오류: 지정된 경로가 디렉토리가 아니거나, Sphinx 파일이 이미 있습니다.�오류: 선택한 루트 경로에 마스터 파일 %s이(가) 이미 있습니다.�이벤트 %r이(가) 이미 존재합니다�예제�예제�빌드하는 동안 예외 발생, 디버거 시작:�예외 발생:�사이드바 열기�확장 기능 옵션�외부 Graphviz 파일 %r을(를) 찾을 수 없거나 읽지 못했습니다�linkcheck_allowed_redirects에서 정규식을 컴파일하지 못했습니다: %r %s�html_static_file에 있는 파일을 복사할 수 없습니다: %s: %r�상호 참조를 생성하지 못했습니다. 제목 또는 캡션을 찾을 수 없습니다: %s�상호 참조를 생성하지 못했습니다. 어떤 번호도 할당되지 않았습니다: %s�%s에 대한 생성자 서명을 가져오지 못했습니다: %s�%s에 대한 함수 서명을 가져오지 못했습니다: %s�%s에 대한 메소드 서명을 가져오지 못했습니다: %s�%r에 대한 기본 인수 값을 해석하지 못했습니다: %s�%r에 대한 type_comment를 해석하지 못했습니다: %s�빌드 정보 파일을 읽을 수 없습니다: %r�intersphinx_mapping[%s]을(를) 읽지 못했으며, 무시합니다: %r�%s에서 문서를 탐색하지 못했습니다: %r�%r에 대한 서명을 업데이트하지 못했습니다. 매개변수를 찾을 수 없습니다: %s�빌드 정보 파일 쓰기 실패: %r�그림 %s�%s 파일이 이미 존재하여, 건너뜁니다.�완료됨: 초기 디렉토리 구조가 생성되었습니다.�각주 [#]이 참조되지 않았습니다.�각주 [%s]이(가) 참조되지 않았습니다.�각주�자세한 내용은 <https://www.sphinx-doc.org/>를 참조하십시오.�보안상의 이유로 macOS의 Python 3.8 버전 이상에서는 병렬 모드가 비활성화되어 있습니다. 자세한 내용은 https://github.com/sphinx-doc/sphinx/issues/6803 을 참조하십시오�한 페이지에 전체 색인 보기�전체 색인�모듈 총 색인�이동�Graphviz 지시문에 내용과 파일 이름 인수를 모두 지정할 수 없습니다�처리기 %r (이벤트 %r에 대한) 에서 예외를 발생했습니다�검색 일치 숨기기�힌트�문서를 영어 이외의 언어로 작성하려는 경우, 여기에서 해당 언어 코드로 언어를 선택할 수 있습니다. 그러면 Sphinx가 생성한 텍스트를 해당 언어로 번역합니다. 지원되는 코드 목록은 https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language 를 참조하십시오.�내용이 없는 "graphviz" 지시문을 무시합니다.�중요�포함 파일 %r을(를) 찾을 수 없거나 읽지 못했습니다�색인�색인 – %(key)s�알파벳별 색인�다음 Sphinx 확장 기능 중 사용 설정해야 하는 항목을 지정하십시오:�색인 및 표 목록:�루트 디렉토리 내에 두 개의 추가 디렉토리가 생성됩니다. 사용자 정의 HTML 템플릿의 경우 "_templates", 사용자 정의 스타일시트 및 기타 정적 파일의 경우 "_static" 입니다. 다른 접두사("." 과 같은)를 입력하여 밑줄 문자를 변경할 수 있습니다.�중단되었습니다!�%s에서 잘못된 __slots__ 가 발견되었습니다. 무시합니다.�잘못된 캡션: %s�잘못된 날짜 형식입니다. 바로 출력하려면 작은 따옴표로 문자열을 인용하십시오: %s�잘못된 math_eqref_format: %r�잘못된 템플릿 변수: %s�키워드 매개변수�LaTeX 명령 %r을(를) 실행할 수 없습니다 (수식 표시에 필요). imgmath_latex 설정을 확인하십시오�최종 업데이트: %(last_updated)s�라이브러리 변경 사항�행 지정 %r: 포함 파일 %r에서 가져온 줄이 없습니다�예시 %s�위의 출력 또는 %(outdir)s/output.txt 파일에서 오류를 확인하십시오�Makefile과 배치 파일 생성�잘못된 옵션 설명 %r, "opt", "-opt args", "--opt args", "/opt args", "+opt args"와 같은 형식이어야 합니다�여러 math_renderers가 등록되어 있습니다. 하지만 math_renderer가 선택되지 않았습니다.�모듈 목록�모듈 작성자: �모듈 코드�모듈 수준�마스터 문서의 이름 (접미사 없이)�템플릿 및 정적 디렉토리의 이름 접두사�탐색�버전 %s에 추가�다음 항목�선택한 빌더가 없으므로, 기본값인 html을 사용합니다�해당 설정값이 없습니다: %s�알파벳 이외�참고�참고: imgmath와 mathjax는 동시에 활성화 할 수 없습니다. imgmath가 선택 취소되었습니다.�참고�숫자�포함 파일 %r에서 이름이 %r 인 객체를 찾을 수 없습니다�한 문서는 "컨텐츠 트리"의 최상위 노드, 즉 문서 계층 구조의 루트로 간주된다는 점에서 특별합니다. 일반적으로 이 값은 "index" 이지만, "index" 문서가 사용자 정의 템플릿일 경우 이를 다른 파일 이름으로 설정할 수도 있습니다.�원래 예외: �기타 매개변수�다른 변경 사항�출력 디렉토리 %s은(는) 디렉토리가 아닙니다.�개요�개요: 모듈 코드�매개변수�이 코드에 대한 퍼머링크�이 정의에 대한 퍼머링크�이 수식에 대한 퍼머링크�이 표제에 대한 퍼머링크�이 이미지에 대한 퍼머링크�이 표에 대한 퍼머링크�이 용어에 대한 퍼머링크�이 목차에 대한 퍼머링크�Pillow를 찾을 수 없습니다 - 이미지 파일을 복사합니다�검색 기능을 사용하려면 JavaScript를 활성화하십시오.�사용자 오류인 경우에도 이를 보고하여, 다음에 더 나은 오류 메시지를 제공할 수 있도록 해 주십시오.�파일 접미사를 입력하십시오 (예: '.rst' 또는 '.txt').�새 파일 이름을 입력하거나 기존 파일의 이름을 바꾸고, Enter를 누르십시오�새 루트 경로를 입력하십시오 (또는 Enter를 눌러 종료)�유효한 경로 이름을 입력하십시오.�'y' 또는 'n'을 입력하십시오.�%s 중 하나를 입력하십시오.�텍스트를 입력하십시오.�다음 설정에 대한 값을 입력하십시오 (대괄호로 묶여 있는 기본값이 존재하고 이 값을 사용하려면 바로 Enter를 누릅니다).�검색 준비 중…�이전 항목�프로젝트 기본 옵션�프로젝트 언어�프로젝트 이름�프로젝트 릴리스�프로젝트 템플릿�프로젝트 버전�Pygments 구문 분석기 이름 %r을(를) 확인할 수 없습니다�Python 향상 제안; PEP %s�Python 모듈 목록�빠른 검색�예외 발생�수신�재귀 오류:�참조�릴리스�반환 형식�반환값�반환�문서의 루트 경로�Sphinx 버전 %s 실행 중�검색�%(docstitle)s에서 찾기�검색 페이지�검색 결과�검색이 완료되었으며, 검색어와 일치하는 %s 개 페이지를 찾았습니다.�%(docstitle)s에서 찾기�검색 중�여러 단어를 검색하면 모든 단어가 포함된 일치 항목만 표시됩니다.�제 %s 절�구역 작성자: �더 보기�선택한 루트 경로: %s�원본과 빌드 디렉토리 분리 (y/n)�소스 보기�2.0 버전부터 Sphinx는 기본적으로 "index"를 root_doc으로 사용합니다. conf.py에 "root_doc = 'contents'"를 추가하십시오.�원본 디렉토리와 대상 디렉토리는 같을 수 없습니다�원본 파일 접미사�%s에 대한 소스 해석기가 등록되지 않았습니다�Sphinx는 소프트웨어에 대한 "버전"과 "릴리스"라는 개념을 가지고 있습니다. 각 버전에는 여러 릴리스가 있을 수 있습니다. 예를 들어 Python의 경우 버전은 2.5나 3.0과 같은 반면 릴리스는 2.5.1 또는 3.0a1과 같습니다. 이러한 이중 구조가 필요하지 않으면 둘 다 동일한 값으로 설정하십시오.�구조 옵션�기호�TODO 항목 발견: %s�표 %s�목차�템플릿 매개변수�소스에서 커버리지 테스트가 완료되었으며, %(outdir)s/python.txt 에서 결과를 확인하십시오.�소스에서 doctest 테스트가 완료되었으며, %(outdir)s/output.txt 에서 결과를 확인하십시오.�%r crossref_type이 이미 등록되었습니다�%r 지시문이 %s 영역에 이미 등록되었습니다�%r 색인이 %s 영역에 이미 등록되었습니다�%r object_type이 이미 등록되었습니다�%r 역할이 %s 영역에 이미 등록되었습니다�%s 확장 기능은 needs_extensions 설정에 따라 필요하지만, 로드되지 않았습니다.�이 프로젝트에서 사용하는 %s 확장 기능에는 최소한 Sphinx v%s이(가) 필요합니다. 따라서 이 버전으로 빌드 할 수 없습니다.�HTML 페이지는 %(outdir)s에 있습니다.�HTML 페이지는 %(outdir)s에 있습니다.�LaTeX 파일은 %(outdir)s에 있습니다.�Texinfo 파일은 %(outdir)s에 있습니다.�XML 파일은 %(outdir)s에 있습니다.�설정값 'source_suffix'는 문자열, 문자열의 목록 또는 dictionary를 예상합니다. 그러나 `%r'이(가) 지정되었습니다.�설정값 `{name}'은(는) `{current.__name__}' 유형이지만, 기본값은 `{default.__name__}'입니다.�설정값 `{name}'은(는) `{current.__name__}' 유형이지만, {permitted} 유형을 기대했습니다.�설정값 `{name}`은(는) {candidates} 중 하나여야 하지만, `{current}`이(가) 지정되었습니다.�구성 파일(또는 가져온 모듈 중 하나)에서 sys.exit()을 호출했습니다�더미 빌더는 파일을 생성하지 않습니다.�ePub 파일은 %(outdir)s에 있습니다.�원본 파일의 파일 이름 접미사. 일반적으로 ".txt" 또는 ".rst" 입니다. 이 접미사가 있는 파일만 문서로 간주됩니다.�개발자에게 문제를 보고할 경우를 위해, 전체 역추적 정보가 %s에 저장되었습니다.�매뉴얼 페이지는 %(outdir)s에 있습니다.�메시지 카탈로그는 %(outdir)s에 있습니다.�개요 파일은 %(outdir)s에 있습니다.�프로젝트 이름은 빌드 된 문서의 여러 위치에 표시됩니다.�의사 XML 파일은 %(outdir)s에 있습니다.�텍스트 파일은 %(outdir)s에 있습니다.�구성 파일에 프로그램 오류가 있습니다: %s�구성 파일에 구문 오류가 있습니다: %s �현재 문서�이 상황은 매우 크거나 많이 중첩된 원본 파일에서 발생할 수 있습니다. 다음과 같이 conf.py에서 Python 재귀 제한 기본값 1000을 늘릴 수 있습니다 (주의):�이 환경은 선택한 빌더와 호환되지 않습니다. 다른 doctree 디렉토리를 선택하십시오.�이 프로젝트는 최소 Sphinx 버전 %s이(가) 필요하므로 현재 버전으로 빌드할 수 없습니다.�이 프로젝트에는 최소한 %s 버전의 %s 확장 기능이 필요하므로 로드 된 버전(%s)으로 빌드 할 수 없습니다.�예외�팁�할 일�%r에 대한 변환기가 이미 존재합니다�알 수 없는 설정 키: latex_elements[%r], 무시합니다.�알 수 없는 이벤트 이름: %s�알 수 없는 이미지 형식: %s…�알 수 없는 math_renderer %r이(가) 지정되었습니다.�알 수 없는 테마 옵션: latex_theme_options[%r], 무시합니다.�Makefile을 사용하여 다음과 같이 문서를 빌드하십시오: make builder�sphinx-build 명령을 사용하여 다음과 같이 문서를 빌드하십시오: sphinx-build -b builder %s %s�변수�경고�경고�Sphinx %s 빠른 시작 유틸리티에 오신 것을 환영합니다.�환영합니다!�%s 파일을 작성합니다.�생성�Sphinx 출력을 위한 빌드 디렉토리를 배치하는 두 가지 옵션이 있습니다. 루트 경로 내에서 "_build" 디렉토리를 사용하거나, 루트 경로 내에서 "source"와 "build" 디렉토리로 분리합니다.�이제 마스터 파일 %s을(를) 채우고 다른 원본 문서 파일을 만들어야 합니다. �검색어와 일치하는 문서가 없습니다. 모든 단어의 철자가 올바른지, 충분한 카테고리를 선택했는지 확인하십시오.�[autosummary] %r을(를) import 하지 못했습니다: %s�[autosummary] 자동 요약 생성: %s�[autosummary] %s에 기록�[문서]�[그래프: %s]�[그래프]�[그림: %s]�[그림]�[소스]�__all__은 %r이(가) 아닌 문자열의 목록이어야 합니다 (모듈 %s) -- __all__을 무시합니다�%s 페이지를 렌더링 할 때 유니코드 오류가 발생했습니다. ASCII가 아닌 내용을 포함하는 모든 설정값이 유니코드 문자열인지 확인하십시오.�다시 빌드 할 특정 파일의 목록. -a가 지정되면 무시합니다�%s 빌더에 적합한 이미지를 찾을 수 없음: %s�%s 빌더에 적합한 이미지를 찾을 수 없음: %s (%s)�%s의 별칭�TypeVar(%s)의 별칭�함수, 클래스 및 용어 개관�모든 %d 개의 po 파일�모든 원본 파일�--full이 주어졌을 때, sys.path에 module_path 추가�단일 문서 조합 중�속성�작성자 이름�autodoc: 문서화 할 %r을(를) 결정하지 못했으며, 다음 예외가 발생했습니다: %s�autodoc_member_order는 이제 "alphabetical" 대신 "alphabetic"을 허용합니다. 설정을 업데이트하십시오.�모듈에서 자동으로 docstring 삽입�doctest 블록의 코드 조각을 자동으로 테스트�autosummary는 내부적으로 .rst 파일을 생성합니다. 하지만 source_suffix에 .rst가 포함되어 있지 않습니다. 건너뜁니다.�autosummary가 제외된 문서 %r을(를) 참조합니다. 무시합니다.�autosummary: 문서화 할 %r을(를) 결정하지 못했으며, 다음 예외가 발생했습니다: %s�autosummary: %s을(를) import 하지 못했습니다�autosummary: 스텁 파일 %r을(를) 찾을 수 없습니다. autosummary_generate 설정을 확인하십시오.�autosummary_generate: 파일을 찾을 수 없음: %s�tabularcolumns와 :widths: 옵션이 모두 설정되었습니다. :widths:는 무시됩니다.�끊어진 링크: %s (%s)�빌드 %s, 경고가 %s 개 발생했습니다 (경고를 오류로 처리).�빌드 %s, 경고가 %s 개 발생했습니다.�빌드 %s, 경고가 %s 개 발생했습니다 (경고를 오류로 처리).�빌드 %s, 경고가 %s 개 발생했습니다.�빌드 %s.�빌드 환경 버전이 최신이 아님�가능한 경우 N 개의 프로세스를 사용하여 병렬로 빌드 (특수 값 "auto"는 CPU 개수로 N 값을 설정합니다)�빌드 정보 파일이 손상되었습니다: %r�사용할 빌더 (기본값: html)�빌드 중 [%s]: �빌드 중 [mo]: �내장 함수�큰 경우가 있으므로 주의�-a 옵션과 파일 이름을 함께 사용할 수 없습니다�다운로드 가능한 파일 %r을(를) 복사할 수 없습니다: %s�추가 파일을 복사할 수 없습니다: %r�이미지 파일 %r을(를) 복사할 수 없습니다: %s�정적 파일을 복사할 수 없습니다: %r�파일을 찾을 수 없습니다: %r�경고 기록 파일 %r을(를) 열 수 없습니다: %s�지원되지 않는 유형의 구성 설정 %r을(를) 재정의 할 수 없으며, 무시합니다�Dictionary 구성 설정 %r을(를) 재정의할 수 없으며, 무시합니다 (개별 요소를 설정하기 위해 %r 사용)�이미지 파일 %r을(를) 읽을 수 없으며, 대신 복사합니다�이미지 파일 %r을(를) 기록할 수 없습니다: %s�캡션이 그림 안에 있지 않습니다.�일관성 확인 중�문서의 커버리지 확인�순환 toctree 참조가 감지되었으며, 무시합니다: %s <- %s�클래스�클래스 메서드�명령줄 옵션�콘셉트�설정값을 기반으로 콘텐츠를 조건부 포함�설정값 "epub_author"는 EPUB3의 경우 비워 둘 수 없습니다�설정값 "epub_contributor"는 EPUB3의 경우 비워 둘 수 없습니다�설정값 "epub_copyright"(또는 "copyright")는 EPUB3의 경우 비워 둘 수 없습니다�설정값 "epub_description"은 EPUB3의 경우 비워 둘 수 없습니다�설정값 "epub_identifier"는 EPUB3의 경우 비워 둘 수 없습니다�설정값 "epub_language"(또는 "language")는 EPUB3의 경우 비워 둘 수 없습니다�설정값 "epub_publisher"는 EPUB3의 경우 비워 둘 수 없습니다�설정값 "epub_title"은 EPUB3의 경우 비워 둘 수 없습니다�설정값 "epub_uid"는 EPUB3의 경우 XML 이름이어야 합니다�설정값 "version"은 EPUB3의 경우 비워 둘 수 없습니다�설정이 변경됨�설정 디렉토리에 conf.py 파일이 없습니다 (%s)�콘솔 출력 옵션�이전 페이지에서 계속�다음 페이지에 계속�변환 명령 %r을(를) 실행할 수 없습니다. image_converter 설정을 확인하십시오.�변환 명령 %r을(를) 실행할 수 없습니다. image_converter 설정을 확인하십시오: %s�convert가 오류와 함께 종료되었습니다: [stderr] %r [stdout] %r�TeX 지원 파일을 복사하는 중�TeX 지원 파일을 복사하는 중…�Texinfo 지원 파일을 복사하는 중�추가 파일을 복사하는 중�다운로드 가능한 파일을 복사하는 중… �추가 파일을 복사하는 중�이미지를 복사하는 중… �원본 파일을 복사하는 중…�정적 파일을 복사하는 중�변경 로그 생성을 위해 %r을(를) 읽을 수 없습니다�GitHub 페이지에 문서를 게시하기 위해 .nojekyll 파일 생성�배치 파일 생성�makefile 생성�사용자 정의 템플릿 디렉토리 (기본값: %(default)s)�데이터�기본 역할 %s을(를) 찾을 수 없음�파일의 기본 확장자 (기본값: %(default)s)�템플릿 변수 정의�태그를 정의: 태그가 있는 "only" 블록을 포함�치수 단위 %s이(가) 잘못되었습니다. 무시합니다.�지시문�%r 지시문이 이미 등록되어 있으며, 재정의됩니다�지시문 옵션�모든 출력을 저장할 디렉토리�모든 출력을 저장할 디렉토리�표시 LaTeX %r: %s�컬러 출력 허용 (기본값: 자동 감지)�배치 파일을 생성하지 않음�makefile을 생성하지 않음�컬러 출력을 허용하지 않음 (기본값: 자동 감지)�Makefile/make.bat에서 make 모드 사용하지 않음�기록할 문서 이름: %s�문서�가져온 멤버 문서화 (기본값: %(default)s)�문서가 어느 toctree에도 포함되어 있지 않음�문서 언어�문서를 읽을 수 없습니다. 무시합니다.�문서 제목이 단일 텍스트 노드가 아님�병렬 %s 처리�%s 영역이 이미 등록되었습니다�%s 영역이 아직 등록되지 않았습니다�목차 파일을 만들지 않음�모듈/패키지에 대한 제목을 만들지 않음 (예: docstring에 이미 포함된 경우)�%r의 자동 문서화를 위해 가져올 모듈을 알 수 없습니다 (문서에 "module" 또는 "currentmodule" 지시문을 배치하거나, 명시적으로 모듈 이름을 지정해 보십시오)�저장된 환경을 사용하지 않고, 항상 모든 파일 읽기�완료�dot 코드 %r: %s�dot 명령 %r을(를) 실행할 수 없습니다 (graphviz 출력에 필요). graphviz_dot 설정을 확인하십시오.�dot이 출력 파일을 생성하지 않았습니다: [stderr] %r [stdout] %r�dot이 오류와 함께 종료되었습니다: [stderr] %r [stdout] %r�다운로드 가능 파일을 읽을 수 없음: %s�객체 인벤토리 덤프 중�%s에서 검색 인덱스 덤프 중�중복된 %s 설명 (%s에 대한), 다른 항목은 %s (%s)에 있음�중복된 %s 설명 (%s에 대한), 다른 인스턴스는 %s에 있음�중복 인용 %s, 다른 인스턴스는 %s에 있음�중복된 %s %s 설명, 다른 인스턴스는 %s에 있음�중복 레이블 %s, 다른 인스턴스는 %s에 있음�중복 레이블의 수식 %s, 다른 인스턴스는 %s에 있음�%s의 중복 객체 설명, 다른 인스턴스는 %s에 있으며, 이 중 하나에 :noindex:를 사용하십시오�중복된 목차 항목 발견: %s�%s 확장 기능 사용�임의의 확장 기능 사용�일부 인벤토리에서 몇 가지 문제가 발생했지만, 동작하는 대체 인벤토리로 처리했습니다:�구역, 주제, 표, 조언, 사이드바 안에 있지 않은 제목 노드가 발견됨�열거형�enumerable_node %r이(가) 이미 등록되었습니다�열거자�환경 변수�환경 변수; %s�%s에 대한 인수를 서식화하는 동안 오류 발생: %s�%s에 대한 서명을 서식화하는 동안 오류 발생: %s�%s 파일 쓰기 오류: %s�Makefile 쓰기 오류: %s�예외�only 지시문 식을 평가하는 동안 예외 발생: %s�확장 기능 %r에 setup() 함수가 없습니다. Sphinx 확장 모듈이 맞습니까?�확장 기능 %r이(가) setup() 함수에서 지원되지 않는 개체를 반환했습니다. None 또는 메타데이터 dictionary를 반환해야 합니다�확장 기능 옵션�확장 기능이 변경됨�실패�객체 %s을(를) import 하지 못함�이름 %s을(를) 해석하지 못함�다음 문제가 있어 어느 인벤토리도 도달하지 못했습니다:�실패: %s�Favicon 파일 %r이(가) 존재하지 않습니다�명령줄에 지정된 파일 %r이(가) 존재하지 않으므로, 무시합니다�명령줄에 지정된 파일 %r이(가) 원본 디렉토리에 있지 않으므로, 무시합니다�테마 경로의 %r 파일이 유효한 ZIP 파일이 아니거나 테마를 포함하지 않습니다�파일 확장자 (기본값: rst)�목차의 파일 이름 (기본값: modules)�완료했으나 문제점 발견�생성에서 제외할 fnmatch 형식의 파일 또는 디렉토리 패턴�심볼릭 링크를 따라갑니다. collective.recipe.omelette과 결합하면 강력합니다.�함수�함수 매개변수�일반 옵션�sphinx-quickstart로 전체 프로젝트 생성�색인 생성 중�용어 정의 형식이 잘못된 것 같습니다. 들여쓰기를 확인하십시오�용어 항목�용어 앞에는 빈 줄이 와야 합니다�용어 정의는 빈 줄로 구분하면 안됩니다.�문법 토큰�graphviz_output_format은 'png', 'svg' 중 하나여야 하지만, 값이 %r 입니다�모듈 코드 강조 중… �html_add_permalinks는 3.5.0 버전부터 더 이상 사용되지 않습니다. 대신 html_permalinks 및 html_permalinks_icon을 사용하십시오.�html_extra_path 항목 %r이(가) 없습니다�html_extra_path 항목 %r이(가) outdir 안에 있습니다�html_static_path 항목 %r이(가) 없습니다�html_static_path 항목 %r이(가) outdir 안에 있습니다�지정된 경우, 원본 디렉토리 아래에 빌드 디렉토리를 만듭니다�지정된 경우, 원본과 빌드 디렉토리를 구분합니다�잘못된 doctest 코드 무시: %r�이미지 파일 %s을(를) 읽을 수 없음: %s�이미지 파일을 읽을 수 없음: %s�"_private" 모듈 포함�문서화 된 Python 객체의 소스 코드에 대한 링크 포함�PNG나 SVG 이미지로 렌더링 된 수식 포함�MathJax로 브라우저에서 렌더링 하는 수식 포함�번역된 메시지의 인용 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}�번역된 메시지의 각주 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}�번역된 메시지의 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}�번역된 메시지의 용어 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}�상세도 높임 (반복 가능)�색인�인라인 LaTeX %r: %s�PEP-0420 암시적 네임 스페이스 사양에 따라 모듈 경로 해석�intersphinx 식별자 %r이(가) 문자열이 아닙니다. 무시합니다�intersphinx 인벤토리가 이동함: %s -> %s�잘못된 TestCode 유형�잘못된 css_file: %r, 무시합니다�잘못된 js_file: %r, 무시합니다�숫자 %r이(가) 설정값 %r에 대해 유효하지 않으며, 무시합니다�잘못된 numfig_format: %s�잘못된 numfig_format: %s (%r)�잘못된 정규식 %r (%s에서)�coverage_c_regexes의 잘못된 정규표현식 %r�auto%s (%r)에 대한 잘못된 서명�class-doc-from 옵션에 대해 잘못된 값: %s�member-order 옵션에 대해 잘못된 값: %s�잘못된 값 세트 (닫는 중괄호 누락): %s�잘못된 값 세트 (여는 중괄호 누락): %s�작업 숫자는 양수여야 합니다�키워드�add_node()에 대한 kwargs는 반드시 (visit, depart)의 함수 튜플이어야 합니다: %r=%r�최종 업데이트�줄 번호 지정이 범위를 벗어남 (1-%d): %r�다른 프로젝트의 Sphinx 문서 간 링크�모든 구역과 하위 구역 목록�%s 에서 intersphinx 인벤토리 로드 중…�pickle로 저장된 환경을 불러오는 중�번역을 불러오는 중 [%s]… �locale_dir %s이(가) 존재하지 않습니다�로고 파일 %r이(가) 존재하지 않습니다�오래된 파일을 찾는 중… �매크로�출력 디렉토리 만드는 중�잘못된 문자열 리터럴 (닫는 따옴표 누락): %s�잘못된 문자열 리터럴 (여는 따옴표 누락): %s�마스터 문서 이름�수식 렌더러 %s이(가) 이미 등록되었습니다�목차에 표시할 하위 모듈의 최대 깊이 (기본값: 4)�멤버 변수�메서드�'%s' 옵션에 '+'나 '-'가 없습니다.�%s 속성이 %s 객체에 없음�:members: 옵션에 언급된 속성이 없습니다: 모듈 %s, 속성 %s�모듈�%s 모듈을 가져올 수 없습니다: %s�모듈�'any' 상호 참조 %r에 대해 둘 이상의 대상이 발견되었습니다: %s 일 수 있습니다�상호 참조 %r에 대해 둘 이상의 대상을 찾았습니다: %s�문서 "%s"에 대해 여러 파일을 발견했습니다: %r 빌드에 %r을(를) 사용합니다.�새로운 설정�다음�다음 장�까다로움 모드, 모든 누락된 참조에 대해 경고 발생�"latex_documents" 설정값이 없으므로, 문서를 작성하지 않습니다�"man_pages" 설정값이 없으므로, 매뉴얼 페이지를 작성하지 않습니다�"texinfo_documents" 설정값이 없으므로, 문서를 작성하지 않습니다�%r 언어에 대해 알려진 Babel 옵션이 없습니다�버전 %s에는 변경 사항이 없습니다.�%s 블록(%s:%s)에 코드/출력 없음�경고를 포함하여 아무 출력도 하지 않음�stdout에 출력하지 않고, stderr에 경고만 표시�오래된 대상이 없습니다.�이름이 %r인 테마를 찾을 수 없습니다 (theme.conf 파일 누락?)�이름이 %r인 테마가 없으며, %r에서 상속합니다�%r 노드 클래스가 이미 등록되어 있으며, 방문자를 무시합니다�내어쓰기에 의해 비 공백 문자가 제거됨�찾은 것이 없음�기본 제공 메시지를 사용할 수 없습니다�numfig가 비활성화되었습니다. :numref:는 무시됩니다.�numfig_format이 %s에 대해 정의되지 않음�객체�연산자�원래 항목�구성 파일의 설정 무시�기존 파일 덮어쓰기�페이지�%s 페이지가 html_sidebars의 두 패턴(%r 및 %r)과 일치합니다�HTML 템플릿에 값 전달�캐시된 환경 및 doctree 파일 경로 (기본값: OUTPUTDIR/.doctrees)�문서 원본 파일의 경로�문서에 대한 모듈 경로�출력 디렉토리 경로�구성 파일(conf.py)이 있는 경로 (기본값: SOURCEDIR과 동일)�pickle로 환경을 저장하는 중�문서 준비 중�이전�이전 장�primary_domain %r(이)가 없으므로, 무시합니다.�%s 처리 중�프로그램 옵션�--full이 주어졌을 때, 프로젝트 작성자�프로젝트 이름�프로젝트 이름 (기본값: 루트 모듈 이름)�--full이 주어졌을 때, 프로젝트의 릴리스이며 기본값은 --doc-version 값과 같음�프로젝트 루트 디렉토리�--full이 주어졌을 때, 프로젝트 버전�특성�각 모듈에 대한 문서를 개별 페이지에 배치�서브 모듈 문서 앞에 모듈 문서를 넣음�모든 모듈 조견표�조용한 모드�reST 마크업 오류:�읽기 오류: %s, %s�원본을 읽는 중… �템플릿을 읽는 중… �참조 레이블�프로젝트의 릴리스�_templates 등에서 마침표의 대체 문자�참조 처리 중…�역할�%r 역할이 이미 등록되어 있으며, 재정의됩니다�예외 발생 시 Pdb 실행�파일을 생성하지 않고 스크립트 실행�검색�검색 색인을 불러올 수 없지만 모든 문서가 작성되지는 않은 것은 아닙니다. 색인이 불완전합니다.�문서 검색�%s 문서�%s 참조�자체 참조된 toctree가 발견되었습니다. 무시합니다.�검색된 테마 구성에서 %s.%s 설정이 존재하지 않습니다�예외 발생 시 전체 추적 표시�automodule %s에 대해 서명 인수 또는 반환 값 주석이 지정됨�건너뜀�원본 디렉토리가 변경됨�원본 파일의 접미사�rST 파일을 생성할 원본 파일�%r에 대한 source_parser가 이미 등록되었습니다�source_suffix %r이(가) 이미 등록되었습니다�sphinx-quickstart는 빈 디렉토리에만 생성됩니다. 새 루트 경로를 지정하십시오.�sphinx-quickstart는 기존 Sphinx 프로젝트를 덮어 쓰지 않습니다.�sphinx-quickstart는 기존 파일을 덮어 쓰지 않습니다.�sphinx_rtd_theme (< 0.3.0) 가 발견되었습니다. 이 테마는 Sphinx 6.0부터 사용할 수 없습니다.�문�정적 메서드�구조체�성공�오래된 %d 개의 po 파일 대상�지정된 %d 개의 po 파일 대상�오래된 %d 개의 원본 파일 대상�%d 개의 템플릿 파일 대상�템플릿 파일에 대한 템플릿 디렉토리�템플릿 매개변수�%s 확장 기능은 병렬 읽기에 안전한지 선언하지 않았으므로, 그렇지 않다고 가정합니다. 확장 기능 작성자에게 확인하고 명시하도록 요청하십시오�%s 확장 기능은 병렬 쓰기에 안전한지 선언하지 않았으므로, 그렇지 않다고 가정합니다. 확장 기능 작성자에게 확인하고 명시하도록 요청하십시오�%s 확장 기능은 병렬 읽기에 안전하지 않습니다�%s 확장 기능은 병렬 쓰기에 안전하지 않습니다�문서:�%r 확장 기능은 Sphinx에 버전 %s 이후로 이미 병합되었습니다. 이 확장 기능은 무시됩니다.�링크에 캡션이 없습니다: %s�테마 %r에 "inherit" 설정이 없습니다�테마 %r에 "theme" 설정이 없습니다�toctree에 존재하지 않는 파일 %r에 대한 참조가 있음�toctree에 제목이 없는 문서 %r에 대한 참조가 있습니다. 링크가 생성되지 않습니다�toctree에 제외된 문서 %r에 대한 참조가 있음�toctree에 존재하지 않는 문서 %r에 대한 참조가 있음�:maxdepth:가 너무 크며, 무시합니다.�경고를 오류로 바꿈�자료형�디코드 할 수 없는 원본 문자이며, "?"로 대체합니다: %r�정의되지 않은 레이블: %s�문서화되지 않은 C API: %s [%s], 파일 %s�문서화되지 않은 Python 클래스: %s :: %s�문서화되지 않은 Python 함수: %s :: %s�문서화되지 않은 Python 메소드: %s :: %s :: %s�구현되지 않은 노드 유형: %r�공용체�알 수 없는 %r toplevel_sectioning (클래스 %r)�재정의 중 알 수 없는 설정값 %r, 무시합니다�알 수 없는 지시문 또는 역할 이름: %s:%s�알 수 없는 색인 항목 유형 %r�알 수 없는 색인 항목 유형 %s이(가) 발견됨�%s은(는) 알 수 없는 MIME 유형이며, 무시합니다�알 수 없는 노드 유형: %r�지원하지 않는 테마 옵션 %r을(를) 설정했습니다�환경을 갱신하는 중: �EPUB 사용�Makefile/make.bat에서 make 모드 사용�설정 파일을 전혀 사용하지 않고, -D 옵션들만 사용�변수�프로젝트의 버전�작업자를 기다리는 중…�여기서 "builder"는 지원되는 빌더 중 하나(예: html, latex, linkcheck)입니다.�확장 기능 %s 설정 중:�-W와 함께 지정하여, 경고가 발생했을 때 계속 진행�빌드 시 표시하거나 숨길 수 있는 "할 일" 항목 작성�모든 파일 기록 (기본값: 새 파일과 변경된 파일만 기록)�주어진 파일에 경고(및 오류)를 기록�작성 중�%s 파일을 기록하는 중…�META-INF/container.xml 파일 쓰는 중…�추가 파일 작성 중�추가 페이지 작성 중�content.opf 파일 쓰는 중…�쓰기 오류: %s, %s�메시지 카탈로그 작성 중… �mimetype 파일 쓰는 중…�nav.xhtml 파일 쓰는 중…�출력을 쓰는 중… �요약 파일 작성 중…�toc.ncx 파일 쓰는 중…���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ko/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000355444�00000000000�021171� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Minho Ryang <minhoryang@gmail.com>, 2019 # YT H <dev@theYT.net>, 2019-2021 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Korean (http://www.transifex.com/sphinx-doc/sphinx-1/language/ko/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: ko\n" "Plural-Forms: nplurals=1; plural=0;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "원본 디렉토리를 찾을 수 없습니다 (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "출력 디렉토리 %s은(는) 디렉토리가 아닙니다." #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "원본 디렉토리와 대상 디렉토리는 같을 수 없습니다" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx 버전 %s 실행 중" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "보안상의 이유로 macOS의 Python 3.8 버전 이상에서는 병렬 모드가 비활성화되어 있습니다. 자세한 내용은 https://github.com/sphinx-doc/sphinx/issues/6803 을 참조하십시오" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "이 프로젝트는 최소 Sphinx 버전 %s이(가) 필요하므로 현재 버전으로 빌드할 수 없습니다." #: sphinx/application.py:243 msgid "making output directory" msgstr "출력 디렉토리 만드는 중" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "확장 기능 %s 설정 중:" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "현재 conf.py 파일에 정의된 'setup'은 호출 가능한 Python 객체가 아닙니다. 호출 가능한 함수가 되도록 정의를 수정하십시오.\n이것은 conf.py가 Sphinx 확장 기능으로 동작하는 데 필요합니다." #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "번역을 불러오는 중 [%s]… " #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "완료" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "기본 제공 메시지를 사용할 수 없습니다" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "pickle로 저장된 환경을 불러오는 중" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "실패: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "선택한 빌더가 없으므로, 기본값인 html을 사용합니다" #: sphinx/application.py:348 msgid "succeeded" msgstr "성공" #: sphinx/application.py:349 msgid "finished with problems" msgstr "완료했으나 문제점 발견" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "빌드 %s, 경고가 %s 개 발생했습니다 (경고를 오류로 처리)." #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "빌드 %s, 경고가 %s 개 발생했습니다 (경고를 오류로 처리)." #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "빌드 %s, 경고가 %s 개 발생했습니다." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "빌드 %s, 경고가 %s 개 발생했습니다." #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "빌드 %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "%r 노드 클래스가 이미 등록되어 있으며, 방문자를 무시합니다" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "%r 지시문이 이미 등록되어 있으며, 재정의됩니다" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "%r 역할이 이미 등록되어 있으며, 재정의됩니다" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "%s 확장 기능은 병렬 읽기에 안전한지 선언하지 않았으므로, 그렇지 않다고 가정합니다. 확장 기능 작성자에게 확인하고 명시하도록 요청하십시오" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "%s 확장 기능은 병렬 읽기에 안전하지 않습니다" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "%s 확장 기능은 병렬 쓰기에 안전한지 선언하지 않았으므로, 그렇지 않다고 가정합니다. 확장 기능 작성자에게 확인하고 명시하도록 요청하십시오" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "%s 확장 기능은 병렬 쓰기에 안전하지 않습니다" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "병렬 %s 처리" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "설정 디렉토리에 conf.py 파일이 없습니다 (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "Dictionary 구성 설정 %r을(를) 재정의할 수 없으며, 무시합니다 (개별 요소를 설정하기 위해 %r 사용)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "숫자 %r이(가) 설정값 %r에 대해 유효하지 않으며, 무시합니다" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "지원되지 않는 유형의 구성 설정 %r을(를) 재정의 할 수 없으며, 무시합니다" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "재정의 중 알 수 없는 설정값 %r, 무시합니다" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "해당 설정값이 없습니다: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "설정값 %r이(가) 이미 존재합니다" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "구성 파일에 구문 오류가 있습니다: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "구성 파일(또는 가져온 모듈 중 하나)에서 sys.exit()을 호출했습니다" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "구성 파일에 프로그램 오류가 있습니다:\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "설정값 'source_suffix'는 문자열, 문자열의 목록 또는 dictionary를 예상합니다. 그러나 `%r'이(가) 지정되었습니다." #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "제 %s 절" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "그림 %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "표 %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "예시 %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "설정값 `{name}`은(는) {candidates} 중 하나여야 하지만, `{current}`이(가) 지정되었습니다." #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "설정값 `{name}'은(는) `{current.__name__}' 유형이지만, {permitted} 유형을 기대했습니다." #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "설정값 `{name}'은(는) `{current.__name__}' 유형이지만, 기본값은 `{default.__name__}'입니다." #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r(이)가 없으므로, 무시합니다." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "2.0 버전부터 Sphinx는 기본적으로 \"index\"를 root_doc으로 사용합니다. conf.py에 \"root_doc = 'contents'\"를 추가하십시오." #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "이벤트 %r이(가) 이미 존재합니다" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "알 수 없는 이벤트 이름: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "처리기 %r (이벤트 %r에 대한) 에서 예외를 발생했습니다" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "%s 확장 기능은 needs_extensions 설정에 따라 필요하지만, 로드되지 않았습니다." #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "이 프로젝트에는 최소한 %s 버전의 %s 확장 기능이 필요하므로 로드 된 버전(%s)으로 빌드 할 수 없습니다." #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "Pygments 구문 분석기 이름 %r을(를) 확인할 수 없습니다" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "literal_block을 \"%s\"(으)로 구문 분석할 수 없습니다. 구문 강조를 건너뜁니다." #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "문서 \"%s\"에 대해 여러 파일을 발견했습니다: %r\n빌드에 %r을(를) 사용합니다." #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "문서를 읽을 수 없습니다. 무시합니다." #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "빌더 클래스 %s에 \"name\" 속성이 없습니다" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "%r 빌더가 이미 존재합니다 (%s 모듈에 있음)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "빌더 이름 %s이(가) 등록되지 않았거나 진입점을 통해서만 사용할 수 있습니다" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "빌더 이름 %s이(가) 등록되지 않았습니다" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "%s 영역이 이미 등록되었습니다" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "%s 영역이 아직 등록되지 않았습니다" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "%r 지시문이 %s 영역에 이미 등록되었습니다" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "%r 역할이 %s 영역에 이미 등록되었습니다" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "%r 색인이 %s 영역에 이미 등록되었습니다" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "%r object_type이 이미 등록되었습니다" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "%r crossref_type이 이미 등록되었습니다" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "source_suffix %r이(가) 이미 등록되었습니다" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "%r에 대한 source_parser가 이미 등록되었습니다" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "%s에 대한 소스 해석기가 등록되지 않았습니다" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "%r에 대한 변환기가 이미 존재합니다" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "add_node()에 대한 kwargs는 반드시 (visit, depart)의 함수 튜플이어야 합니다: %r=%r" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "enumerable_node %r이(가) 이미 등록되었습니다" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "수식 렌더러 %s이(가) 이미 등록되었습니다" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "%r 확장 기능은 Sphinx에 버전 %s 이후로 이미 병합되었습니다. 이 확장 기능은 무시됩니다." #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "원래 예외:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "확장 기능 %s을(를) 가져올 수 없습니다" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "확장 기능 %r에 setup() 함수가 없습니다. Sphinx 확장 모듈이 맞습니까?" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "이 프로젝트에서 사용하는 %s 확장 기능에는 최소한 Sphinx v%s이(가) 필요합니다. 따라서 이 버전으로 빌드 할 수 없습니다." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "확장 기능 %r이(가) setup() 함수에서 지원되지 않는 개체를 반환했습니다. None 또는 메타데이터 dictionary를 반환해야 합니다" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python 향상 제안; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "테마 %r에 \"theme\" 설정이 없습니다" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "테마 %r에 \"inherit\" 설정이 없습니다" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "이름이 %r인 테마가 없으며, %r에서 상속합니다" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "검색된 테마 구성에서 %s.%s 설정이 존재하지 않습니다" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "지원하지 않는 테마 옵션 %r을(를) 설정했습니다" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "테마 경로의 %r 파일이 유효한 ZIP 파일이 아니거나 테마를 포함하지 않습니다" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "sphinx_rtd_theme (< 0.3.0) 가 발견되었습니다. 이 테마는 Sphinx 6.0부터 사용할 수 없습니다." #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "이름이 %r인 테마를 찾을 수 없습니다 (theme.conf 파일 누락?)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "%s 빌더에 적합한 이미지를 찾을 수 없음: %s (%s)" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "%s 빌더에 적합한 이미지를 찾을 수 없음: %s" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "빌드 중 [mo]: " #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "출력을 쓰는 중… " #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "모든 %d 개의 po 파일" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "지정된 %d 개의 po 파일 대상" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "오래된 %d 개의 po 파일 대상" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "모든 원본 파일" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "명령줄에 지정된 파일 %r이(가) 원본 디렉토리에 있지 않으므로, 무시합니다" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "명령줄에 지정된 파일 %r이(가) 존재하지 않으므로, 무시합니다" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "명령줄에 지정된 %d 개의 원본 파일" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "오래된 %d 개의 원본 파일 대상" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "빌드 중 [%s]: " #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "오래된 파일을 찾는 중… " #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "%d 개 찾음" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "찾은 것이 없음" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "pickle로 환경을 저장하는 중" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "일관성 확인 중" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "오래된 대상이 없습니다." #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "환경을 갱신하는 중: " #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "%s 개 추가됨, %s 개 변경됨, %s 개 제거됨" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "원본을 읽는 중… " #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "작업자를 기다리는 중…" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "기록할 문서 이름: %s" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "문서 준비 중" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "중복된 목차 항목 발견: %s" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "이미지를 복사하는 중… " #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "이미지 파일 %r을(를) 읽을 수 없으며, 대신 복사합니다" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "이미지 파일 %r을(를) 복사할 수 없습니다: %s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "이미지 파일 %r을(를) 기록할 수 없습니다: %s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "Pillow를 찾을 수 없습니다 - 이미지 파일을 복사합니다" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "mimetype 파일 쓰는 중…" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "META-INF/container.xml 파일 쓰는 중…" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "content.opf 파일 쓰는 중…" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "%s은(는) 알 수 없는 MIME 유형이며, 무시합니다" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "toc.ncx 파일 쓰는 중…" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "%s 파일을 기록하는 중…" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "개요 파일은 %(outdir)s에 있습니다." #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "버전 %s에는 변경 사항이 없습니다." #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "요약 파일 작성 중…" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "내장" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "모듈 수준" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "원본 파일을 복사하는 중…" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "변경 로그 생성을 위해 %r을(를) 읽을 수 없습니다" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "더미 빌더는 파일을 생성하지 않습니다." #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "ePub 파일은 %(outdir)s에 있습니다." #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "nav.xhtml 파일 쓰는 중…" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "설정값 \"epub_language\"(또는 \"language\")는 EPUB3의 경우 비워 둘 수 없습니다" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "설정값 \"epub_uid\"는 EPUB3의 경우 XML 이름이어야 합니다" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "설정값 \"epub_title\"은 EPUB3의 경우 비워 둘 수 없습니다" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "설정값 \"epub_author\"는 EPUB3의 경우 비워 둘 수 없습니다" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "설정값 \"epub_contributor\"는 EPUB3의 경우 비워 둘 수 없습니다" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "설정값 \"epub_description\"은 EPUB3의 경우 비워 둘 수 없습니다" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "설정값 \"epub_publisher\"는 EPUB3의 경우 비워 둘 수 없습니다" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "설정값 \"epub_copyright\"(또는 \"copyright\")는 EPUB3의 경우 비워 둘 수 없습니다" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "설정값 \"epub_identifier\"는 EPUB3의 경우 비워 둘 수 없습니다" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "설정값 \"version\"은 EPUB3의 경우 비워 둘 수 없습니다" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "잘못된 css_file: %r, 무시합니다" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "메시지 카탈로그는 %(outdir)s에 있습니다." #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "%d 개의 템플릿 파일 대상" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "템플릿을 읽는 중… " #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "메시지 카탈로그 작성 중… " #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "위의 출력 또는 %(outdir)s/output.txt 파일에서 오류를 확인하십시오" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "끊어진 링크: %s (%s)" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "앵커 '%s'을(를) 찾을 수 없습니다" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "linkcheck_allowed_redirects에서 정규식을 컴파일하지 못했습니다: %r %s" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "매뉴얼 페이지는 %(outdir)s에 있습니다." #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "\"man_pages\" 설정값이 없으므로, 매뉴얼 페이지를 작성하지 않습니다" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "작성 중" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "\"man_pages\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "HTML 페이지는 %(outdir)s에 있습니다." #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "단일 문서 조합 중" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "추가 파일 작성 중" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "Texinfo 파일은 %(outdir)s에 있습니다." #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "\nmakeinfo를 통해 작업하려면 해당 디렉토리에서 'make'를 실행하십시오\n(자동으로 수행하려면 여기에서 'make info'를 사용하십시오)." #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "\"texinfo_documents\" 설정값이 없으므로, 문서를 작성하지 않습니다" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "\"texinfo_documents\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "%s 처리 중" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "참조 처리 중…" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (문서 " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "Texinfo 지원 파일을 복사하는 중" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "Makefile 쓰기 오류: %s" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "텍스트 파일은 %(outdir)s에 있습니다." #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "%s 파일 쓰기 오류: %s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "XML 파일은 %(outdir)s에 있습니다." #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "의사 XML 파일은 %(outdir)s에 있습니다." #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "빌드 정보 파일이 손상되었습니다: %r" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "HTML 페이지는 %(outdir)s에 있습니다." #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "빌드 정보 파일을 읽을 수 없습니다: %r" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%Y년 %m월 %d일" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "전체 색인" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "색인" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "다음" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "이전" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "색인 생성 중" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "추가 페이지 작성 중" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "다운로드 가능한 파일을 복사하는 중… " #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "다운로드 가능한 파일 %r을(를) 복사할 수 없습니다: %s" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "html_static_file에 있는 파일을 복사할 수 없습니다: %s: %r" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "정적 파일을 복사하는 중" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "정적 파일을 복사할 수 없습니다: %r" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "추가 파일을 복사하는 중" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "추가 파일을 복사할 수 없습니다: %r" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "빌드 정보 파일 쓰기 실패: %r" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "검색 색인을 불러올 수 없지만 모든 문서가 작성되지는 않은 것은 아닙니다. 색인이 불완전합니다." #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "%s 페이지가 html_sidebars의 두 패턴(%r 및 %r)과 일치합니다" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "%s 페이지를 렌더링 할 때 유니코드 오류가 발생했습니다. ASCII가 아닌 내용을 포함하는 모든 설정값이 유니코드 문자열인지 확인하십시오." #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "%s 페이지를 렌더링하는 중에 오류가 발생했습니다.\n원인: %r" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "객체 인벤토리 덤프 중" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "%s에서 검색 인덱스 덤프 중" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "잘못된 js_file: %r, 무시합니다" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "여러 math_renderers가 등록되어 있습니다. 하지만 math_renderer가 선택되지 않았습니다." #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "알 수 없는 math_renderer %r이(가) 지정되었습니다." #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "html_extra_path 항목 %r이(가) 없습니다" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "html_extra_path 항목 %r이(가) outdir 안에 있습니다" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "html_static_path 항목 %r이(가) 없습니다" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "html_static_path 항목 %r이(가) outdir 안에 있습니다" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "로고 파일 %r이(가) 존재하지 않습니다" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "Favicon 파일 %r이(가) 존재하지 않습니다" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "html_add_permalinks는 3.5.0 버전부터 더 이상 사용되지 않습니다. 대신 html_permalinks 및 html_permalinks_icon을 사용하십시오." #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s 문서" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "LaTeX 파일은 %(outdir)s에 있습니다." #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\n(pdf)latex을 통해 작업하려면 해당 디렉토리에서 'make'를 실행하십시오\n(자동으로 수행하려면 여기에서 'make latexpdf'를 사용하십시오)." #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "\"latex_documents\" 설정값이 없으므로, 문서를 작성하지 않습니다" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "\"latex_documents\" 설정값이 알 수 없는 문서 %s을(를) 참조합니다" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "색인" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "릴리스" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "%r 언어에 대해 알려진 Babel 옵션이 없습니다" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "TeX 지원 파일을 복사하는 중" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "TeX 지원 파일을 복사하는 중…" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "추가 파일을 복사하는 중" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "알 수 없는 설정 키: latex_elements[%r], 무시합니다." #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "알 수 없는 테마 옵션: latex_theme_options[%r], 무시합니다." #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "%r에 \"theme\" 설정이 없습니다" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "%r에 \"%s\" 설정이 없습니다" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "빌드하는 동안 예외 발생, 디버거 시작:" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "중단되었습니다!" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "reST 마크업 오류:" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "인코딩 오류:" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "개발자에게 문제를 보고할 경우를 위해, 전체 역추적 정보가 %s에 저장되었습니다." #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "재귀 오류:" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "이 상황은 매우 크거나 많이 중첩된 원본 파일에서 발생할 수 있습니다. 다음과 같이 conf.py에서 Python 재귀 제한 기본값 1000을 늘릴 수 있습니다 (주의):" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "예외 발생:" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "사용자 오류인 경우에도 이를 보고하여, 다음에 더 나은 오류 메시지를 제공할 수 있도록 해 주십시오." #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "버그 보고서는 <https://github.com/sphinx-doc/sphinx/issues>의 트래커에 제출할 수 있습니다. 감사합니다!" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "작업 숫자는 양수여야 합니다" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "자세한 내용은 <https://www.sphinx-doc.org/>를 참조하십시오." #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "\n소스 파일로부터 문서를 생성합니다.\n\nsphinx-build는 SOURCEDIR에 있는 파일로부터 문서를 생성하여 OUTPUTDIR에 저장합니다.\n구성 설정을 위해 SOURCEDIR에서 'conf.py' 파일을 찾습니다.\n'sphinx-quickstart' 도구는 'conf.py'를 포함하여 템플릿 파일을 생성하는 데 사용할 수 있습니다.\n\nsphinx-build는 다양한 형식으로 문서를 생성할 수 있습니다.\n형식은 명령줄에서 빌더 이름을 지정하여 선택하며, 기본값은 HTML입니다.\n빌더는 문서 처리와 관련한 다른 태스크를 수행할 수도 있습니다.\n\n기본적으로 오래된 모든 항목을 빌드합니다.\n개별 파일명을 지정하여 선택한 파일에 대한 출력만 빌드할 수 있습니다.\n" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "문서 원본 파일의 경로" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "출력 디렉토리 경로" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "다시 빌드 할 특정 파일의 목록. -a가 지정되면 무시합니다" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "일반 옵션" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "사용할 빌더 (기본값: html)" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "모든 파일 기록 (기본값: 새 파일과 변경된 파일만 기록)" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "저장된 환경을 사용하지 않고, 항상 모든 파일 읽기" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "캐시된 환경 및 doctree 파일 경로 (기본값: OUTPUTDIR/.doctrees)" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "가능한 경우 N 개의 프로세스를 사용하여 병렬로 빌드 (특수 값 \"auto\"는 CPU 개수로 N 값을 설정합니다)" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "구성 파일(conf.py)이 있는 경로 (기본값: SOURCEDIR과 동일)" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "설정 파일을 전혀 사용하지 않고, -D 옵션들만 사용" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "구성 파일의 설정 무시" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "HTML 템플릿에 값 전달" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "태그를 정의: 태그가 있는 \"only\" 블록을 포함" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "까다로움 모드, 모든 누락된 참조에 대해 경고 발생" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "콘솔 출력 옵션" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "상세도 높임 (반복 가능)" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "stdout에 출력하지 않고, stderr에 경고만 표시" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "경고를 포함하여 아무 출력도 하지 않음" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "컬러 출력 허용 (기본값: 자동 감지)" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "컬러 출력을 허용하지 않음 (기본값: 자동 감지)" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "주어진 파일에 경고(및 오류)를 기록" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "경고를 오류로 바꿈" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "-W와 함께 지정하여, 경고가 발생했을 때 계속 진행" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "예외 발생 시 전체 추적 표시" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "예외 발생 시 Pdb 실행" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "파일을 찾을 수 없습니다: %r" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "-a 옵션과 파일 이름을 함께 사용할 수 없습니다" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "경고 기록 파일 %r을(를) 열 수 없습니다: %s" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "-D 옵션 인수는 name=value 형식이어야 합니다" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "-A 옵션 인수는 name=value 형식이어야 합니다" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "모듈에서 자동으로 docstring 삽입" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "doctest 블록의 코드 조각을 자동으로 테스트" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "다른 프로젝트의 Sphinx 문서 간 링크" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "빌드 시 표시하거나 숨길 수 있는 \"할 일\" 항목 작성" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "문서의 커버리지 확인" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "PNG나 SVG 이미지로 렌더링 된 수식 포함" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "MathJax로 브라우저에서 렌더링 하는 수식 포함" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "설정값을 기반으로 콘텐츠를 조건부 포함" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "문서화 된 Python 객체의 소스 코드에 대한 링크 포함" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "GitHub 페이지에 문서를 게시하기 위해 .nojekyll 파일 생성" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "유효한 경로 이름을 입력하십시오." #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "텍스트를 입력하십시오." #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "%s 중 하나를 입력하십시오." #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "'y' 또는 'n'을 입력하십시오." #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "파일 접미사를 입력하십시오 (예: '.rst' 또는 '.txt')." #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "Sphinx %s 빠른 시작 유틸리티에 오신 것을 환영합니다." #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "다음 설정에 대한 값을 입력하십시오 (대괄호로 묶여 있는 기본값이 존재하고\n이 값을 사용하려면 바로 Enter를 누릅니다)." #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "선택한 루트 경로: %s" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "문서의 루트 경로를 입력하십시오." #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "문서의 루트 경로" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "오류: 선택한 루트 경로에서 기존 conf.py 파일이 발견되었습니다." #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "sphinx-quickstart는 기존 Sphinx 프로젝트를 덮어 쓰지 않습니다." #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "새 루트 경로를 입력하십시오 (또는 Enter를 눌러 종료)" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "Sphinx 출력을 위한 빌드 디렉토리를 배치하는 두 가지 옵션이 있습니다.\n루트 경로 내에서 \"_build\" 디렉토리를 사용하거나, 루트 경로 내에서\n\"source\"와 \"build\" 디렉토리로 분리합니다." #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "원본과 빌드 디렉토리 분리 (y/n)" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "루트 디렉토리 내에 두 개의 추가 디렉토리가 생성됩니다. 사용자 정의 HTML 템플릿의\n경우 \"_templates\", 사용자 정의 스타일시트 및 기타 정적 파일의 경우 \"_static\"\n입니다. 다른 접두사(\".\" 과 같은)를 입력하여 밑줄 문자를 변경할 수 있습니다." #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "템플릿 및 정적 디렉토리의 이름 접두사" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "프로젝트 이름은 빌드 된 문서의 여러 위치에 표시됩니다." #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "프로젝트 이름" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "작성자 이름" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "Sphinx는 소프트웨어에 대한 \"버전\"과 \"릴리스\"라는 개념을 가지고 있습니다.\n각 버전에는 여러 릴리스가 있을 수 있습니다. 예를 들어 Python의 경우 버전은\n2.5나 3.0과 같은 반면 릴리스는 2.5.1 또는 3.0a1과 같습니다.\n이러한 이중 구조가 필요하지 않으면 둘 다 동일한 값으로 설정하십시오." #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "프로젝트 버전" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "프로젝트 릴리스" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "문서를 영어 이외의 언어로 작성하려는 경우, 여기에서 해당 언어 코드로 언어를\n선택할 수 있습니다. 그러면 Sphinx가 생성한 텍스트를 해당 언어로 번역합니다.\n\n지원되는 코드 목록은\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language\n를 참조하십시오." #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "프로젝트 언어" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "원본 파일의 파일 이름 접미사. 일반적으로 \".txt\" 또는 \".rst\" 입니다. 이 접미사가\n있는 파일만 문서로 간주됩니다." #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "원본 파일 접미사" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "한 문서는 \"컨텐츠 트리\"의 최상위 노드, 즉 문서 계층 구조의 루트로 간주된다는\n점에서 특별합니다. 일반적으로 이 값은 \"index\" 이지만, \"index\" 문서가\n사용자 정의 템플릿일 경우 이를 다른 파일 이름으로 설정할 수도 있습니다." #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "마스터 문서의 이름 (접미사 없이)" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "오류: 선택한 루트 경로에 마스터 파일 %s이(가) 이미 있습니다." #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "sphinx-quickstart는 기존 파일을 덮어 쓰지 않습니다." #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "새 파일 이름을 입력하거나 기존 파일의 이름을 바꾸고, Enter를 누르십시오" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "다음 Sphinx 확장 기능 중 사용 설정해야 하는 항목을 지정하십시오:" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "참고: imgmath와 mathjax는 동시에 활성화 할 수 없습니다. imgmath가 선택 취소되었습니다." #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "Makefile 및 Windows 명령 파일을 생성할 수 있으므로, sphinx-build를 직접 호출하는\n대신 (예를 들어) `make html'을 실행하기만 하면 됩니다." #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "Makefile을 만드시겠습니까? (y/n)" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "Windows 명령 파일을 만드시겠습니까? (y/n)" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "%s 파일을 만드는 중입니다." #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "%s 파일이 이미 존재하여, 건너뜁니다." #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "완료됨: 초기 디렉토리 구조가 생성되었습니다." #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "이제 마스터 파일 %s을(를) 채우고 다른 원본 문서 파일을 만들어야 합니다. " #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "Makefile을 사용하여 다음과 같이 문서를 빌드하십시오:\n make builder" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "sphinx-build 명령을 사용하여 다음과 같이 문서를 빌드하십시오:\n sphinx-build -b builder %s %s" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "여기서 \"builder\"는 지원되는 빌더 중 하나(예: html, latex, linkcheck)입니다." #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "\nSphinx 프로젝트에 필요한 파일을 생성합니다.\n\nsphinx-quickstart는 대화형 도구로서, 프로젝트에 대한 몇 가지 질문을 한 다음\n완전한 문서 디렉토리와 (sphinx-build와 함께 사용할 수 있는) 견본 Makefile을 생성합니다.\n" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "조용한 모드" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "프로젝트 루트 디렉토리" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "구조 옵션" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "지정된 경우, 원본과 빌드 디렉토리를 구분합니다" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "지정된 경우, 원본 디렉토리 아래에 빌드 디렉토리를 만듭니다" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "_templates 등에서 마침표의 대체 문자" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "프로젝트 기본 옵션" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "프로젝트 이름" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "작성자 이름" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "프로젝트의 버전" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "프로젝트의 릴리스" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "문서 언어" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "원본 파일의 접미사" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "마스터 문서 이름" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "EPUB 사용" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "확장 기능 옵션" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "%s 확장 기능 사용" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "임의의 확장 기능 사용" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "Makefile과 배치 파일 생성" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "makefile 생성" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "makefile을 생성하지 않음" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "배치 파일 생성" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "배치 파일을 생성하지 않음" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "Makefile/make.bat에서 make 모드 사용" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "Makefile/make.bat에서 make 모드 사용하지 않음" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "프로젝트 템플릿" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "템플릿 파일에 대한 템플릿 디렉토리" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "템플릿 변수 정의" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "\"quiet\"이 지정되었지만, \"project\" 또는 \"author\"가 정의되지 않았습니다." #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "오류: 지정된 경로가 디렉토리가 아니거나, Sphinx 파일이 이미 있습니다." #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "sphinx-quickstart는 빈 디렉토리에만 생성됩니다. 새 루트 경로를 지정하십시오." #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "잘못된 템플릿 변수: %s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "내어쓰기에 의해 비 공백 문자가 제거됨" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "잘못된 캡션: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "줄 번호 지정이 범위를 벗어남 (1-%d): %r" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "\"%s\"과(와) \"%s\" 옵션을 모두 사용할 수 없습니다" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "포함 파일 %r을(를) 찾을 수 없거나 읽지 못했습니다" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "포함 파일 %r을 읽는데 사용한 %r 인코딩이 잘못된 것 같습니다. :encoding: 옵션을 지정해 보십시오" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "포함 파일 %r에서 이름이 %r 인 객체를 찾을 수 없습니다" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "분리된 \"lines\" 집합과 함께 \"lineno-match\"를 사용할 수 없습니다" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "행 지정 %r: 포함 파일 %r에서 가져온 줄이 없습니다" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "구역 작성자: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "모듈 작성자: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "코드 작성자: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "작성자: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "csv-table 지시문의 \":file:\" 옵션은 이제 절대 경로를 소스 디렉토리의 상대 경로로 인식합니다. 문서를 업데이트하십시오." #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "중복 C 선언이며, %s:%s에 정의되었습니다.\n선언은 '.. c:%s:: %s' 입니다." #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "%s (C %s)" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "매개변수" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "반환값" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "반환" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "반환 형식" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "멤버 변수" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "변수" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "함수" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "매크로" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "구조체" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "공용체" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "열거형" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "열거자" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "자료형" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "함수 매개변수" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "버전 %s에 추가" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "버전 %s에서 변경" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "버전 %s부터 폐지됨" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "중복 인용 %s, 다른 인스턴스는 %s에 있음" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "인용 [%s]이(가) 참조되지 않았습니다." #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "중복 C++ 선언이며, %s:%s에 정의되었습니다.\n선언은 '.. cpp:%s:: %s' 입니다." #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "템플릿 매개변수" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "예외" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "클래스" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "콘셉트" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "템플릿 매개변수" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (내장 함수)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s 메서드)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (클래스)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (전역 변수 또는 상수)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s의 속성)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "인수" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (모듈)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "메서드" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "데이터" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "속성" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "모듈" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "중복된 %s 설명 (%s에 대한), 다른 항목은 %s (%s)에 있음" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "중복 레이블의 수식 %s, 다른 인스턴스는 %s에 있음" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "잘못된 math_eqref_format: %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "키워드" #: sphinx/domains/python.py:60 msgid "operator" msgstr "연산자" #: sphinx/domains/python.py:61 msgid "object" msgstr "객체" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "예외" #: sphinx/domains/python.py:63 msgid "statement" msgstr "문" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "내장 함수" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "변수" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "예외 발생" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (%s 모듈)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (%s 모듈)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (내장 변수)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (내장 클래스)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (%s 클래스)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s의 클래스 메서드)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "%s (%s의 특성)" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s의 정적 메서드)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Python 모듈 목록" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "모듈" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "폐지됨" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "클래스 메서드" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "정적 메서드" #: sphinx/domains/python.py:1176 msgid "property" msgstr "특성" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "%s의 중복 객체 설명, 다른 인스턴스는 %s에 있으며, 이 중 하나에 :noindex:를 사용하십시오" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "상호 참조 %r에 대해 둘 이상의 대상을 찾았습니다: %s" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (폐지됨)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (지시문)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr ":%s: (지시문 옵션)" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (역할)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "지시문" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "지시문 옵션" #: sphinx/domains/rst.py:210 msgid "role" msgstr "역할" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "중복된 %s %s 설명, 다른 인스턴스는 %s에 있음" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "환경 변수; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "잘못된 옵션 설명 %r, \"opt\", \"-opt args\", \"--opt args\", \"/opt args\", \"+opt args\"와 같은 형식이어야 합니다" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "%s 명령줄 옵션" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "명령줄 옵션" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "용어 앞에는 빈 줄이 와야 합니다" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "용어 정의는 빈 줄로 구분하면 안됩니다." #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "용어 정의 형식이 잘못된 것 같습니다. 들여쓰기를 확인하십시오" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "용어 항목" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "문법 토큰" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "참조 레이블" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "환경 변수" #: sphinx/domains/std.py:568 msgid "program option" msgstr "프로그램 옵션" #: sphinx/domains/std.py:569 msgid "document" msgstr "문서" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "모듈 목록" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "검색 페이지" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "중복 레이블 %s, 다른 인스턴스는 %s에 있음" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "중복된 %s 설명 (%s에 대한), 다른 인스턴스는 %s에 있음" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "numfig가 비활성화되었습니다. :numref:는 무시됩니다." #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "상호 참조를 생성하지 못했습니다. 어떤 번호도 할당되지 않았습니다: %s" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "링크에 캡션이 없습니다: %s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "잘못된 numfig_format: %s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "잘못된 numfig_format: %s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "정의되지 않은 레이블: %s" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "상호 참조를 생성하지 못했습니다. 제목 또는 캡션을 찾을 수 없습니다: %s" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "새로운 설정" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "설정이 변경됨" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "확장 기능이 변경됨" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "빌드 환경 버전이 최신이 아님" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "원본 디렉토리가 변경됨" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "이 환경은 선택한 빌더와 호환되지 않습니다. 다른 doctree 디렉토리를 선택하십시오." #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "%s에서 문서를 탐색하지 못했습니다: %r" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "%r 영역이 등록되지 않았습니다" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "자체 참조된 toctree가 발견되었습니다. 무시합니다." #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "문서가 어느 toctree에도 포함되어 있지 않음" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "%s 문서" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "%s 참조" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "알 수 없는 색인 항목 유형 %r" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "기호" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "순환 toctree 참조가 감지되었으며, 무시합니다: %s <- %s" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "toctree에 제목이 없는 문서 %r에 대한 참조가 있습니다. 링크가 생성되지 않습니다" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "toctree에 제외된 문서 %r에 대한 참조가 있음" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "toctree에 존재하지 않는 문서 %r에 대한 참조가 있음" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "이미지 파일을 읽을 수 없음: %s" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "이미지 파일 %s을(를) 읽을 수 없음: %s" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "다운로드 가능 파일을 읽을 수 없음: %s" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "%s에 이미 구역 번호가 할당되었습니다 (중첩된 번호 붙인 toctree?)" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "%s 파일을 작성합니다." #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "\n<MODULE_PATH>에서 Python 모듈 및 패키지를 재귀적으로 찾고\nautomodule 지시문이 있는 패키지 당 하나의 reST 파일을 <OUTPUT_PATH>에 만듭니다.\n\n<EXCLUDE_PATTERN>은 생성에서 제외할 파일 또는 디렉토리 패턴일 수 있습니다.\n\n참고: 기본적으로이 스크립트는 이미 생성된 파일을 덮어 쓰지 않습니다." #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "문서에 대한 모듈 경로" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "생성에서 제외할 fnmatch 형식의 파일 또는 디렉토리 패턴" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "모든 출력을 저장할 디렉토리" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "목차에 표시할 하위 모듈의 최대 깊이 (기본값: 4)" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "기존 파일 덮어쓰기" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "심볼릭 링크를 따라갑니다. collective.recipe.omelette과 결합하면 강력합니다." #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "파일을 생성하지 않고 스크립트 실행" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "각 모듈에 대한 문서를 개별 페이지에 배치" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "\"_private\" 모듈 포함" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "목차의 파일 이름 (기본값: modules)" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "목차 파일을 만들지 않음" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "모듈/패키지에 대한 제목을 만들지 않음 (예: docstring에 이미 포함된 경우)" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "서브 모듈 문서 앞에 모듈 문서를 넣음" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "PEP-0420 암시적 네임 스페이스 사양에 따라 모듈 경로 해석" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "파일 확장자 (기본값: rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "sphinx-quickstart로 전체 프로젝트 생성" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "--full이 주어졌을 때, sys.path에 module_path 추가" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "프로젝트 이름 (기본값: 루트 모듈 이름)" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "--full이 주어졌을 때, 프로젝트 작성자" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "--full이 주어졌을 때, 프로젝트 버전" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "--full이 주어졌을 때, 프로젝트의 릴리스이며 기본값은 --doc-version 값과 같음" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "확장 기능 옵션" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s은(는) 디렉토리가 아닙니다." #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "잘못된 정규식 %r (%s에서)" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "소스에서 커버리지 테스트가 완료되었으며, %(outdir)s/python.txt 에서 결과를 확인하십시오." #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "coverage_c_regexes의 잘못된 정규표현식 %r" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "문서화되지 않은 C API: %s [%s], 파일 %s" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "%s 모듈을 가져올 수 없습니다: %s" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "문서화되지 않은 Python 함수: %s :: %s" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "문서화되지 않은 Python 클래스: %s :: %s" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "문서화되지 않은 Python 메소드: %s :: %s :: %s" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "'%s' 옵션에 '+'나 '-'가 없습니다." #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "'%s'은(는) 유효한 옵션이 아닙니다." #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "'%s'은(는) 유효한 pyversion 옵션이 아닙니다" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "잘못된 TestCode 유형" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "소스에서 doctest 테스트가 완료되었으며, %(outdir)s/output.txt 에서 결과를 확인하십시오." #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "%s 블록(%s:%s)에 코드/출력 없음" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "잘못된 doctest 코드 무시: %r" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "====================== 가장 느린 읽기 시간 =======================" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "Graphviz 지시문에 내용과 파일 이름 인수를 모두 지정할 수 없습니다" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "외부 Graphviz 파일 %r을(를) 찾을 수 없거나 읽지 못했습니다" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "내용이 없는 \"graphviz\" 지시문을 무시합니다." #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot이 출력 파일을 생성하지 않았습니다:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "dot 명령 %r을(를) 실행할 수 없습니다 (graphviz 출력에 필요). graphviz_dot 설정을 확인하십시오." #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot이 오류와 함께 종료되었습니다:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "graphviz_output_format은 'png', 'svg' 중 하나여야 하지만, 값이 %r 입니다" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "dot 코드 %r: %s" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[그래프: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[그래프]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "변환 명령 %r을(를) 실행할 수 없습니다. image_converter 설정을 확인하십시오: %s" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "convert가 오류와 함께 종료되었습니다:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "변환 명령 %r을(를) 실행할 수 없습니다. image_converter 설정을 확인하십시오." #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "LaTeX 명령 %r을(를) 실행할 수 없습니다 (수식 표시에 필요). imgmath_latex 설정을 확인하십시오" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "%s 명령 %r을(를) 실행할 수 없습니다 (수식 표시에 필요). imgmath_%s 설정을 확인하십시오" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "표시 LaTeX %r: %s" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "인라인 LaTeX %r: %s" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "이 수식에 대한 퍼머링크" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "intersphinx 인벤토리가 이동함: %s -> %s" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "%s 에서 intersphinx 인벤토리 로드 중…" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "일부 인벤토리에서 몇 가지 문제가 발생했지만, 동작하는 대체 인벤토리로 처리했습니다:" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "다음 문제가 있어 어느 인벤토리도 도달하지 못했습니다:" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(%s v%s에서)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(%s에서)" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "intersphinx 식별자 %r이(가) 문자열이 아닙니다. 무시합니다" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "intersphinx_mapping[%s]을(를) 읽지 못했으며, 무시합니다: %r" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[소스]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "할 일" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "TODO 항목 발견: %s" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<원래 항목>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(<<원래 항목>>은 %s 파일, %d 행에 있습니다.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "원래 항목" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "모듈 코드 강조 중… " #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[문서]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "모듈 코드" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>%s의 소스 코드</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "개요: 모듈 코드" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>코드를 확인할 수 있는 모든 모듈</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "member-order 옵션에 대해 잘못된 값: %s" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "class-doc-from 옵션에 대해 잘못된 값: %s" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "auto%s (%r)에 대한 잘못된 서명" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "%s에 대한 인수를 서식화하는 동안 오류 발생: %s" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "%s 속성이 %s 객체에 없음" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "autodoc: 문서화 할 %r을(를) 결정하지 못했으며, 다음 예외가 발생했습니다:\n%s" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "%r의 자동 문서화를 위해 가져올 모듈을 알 수 없습니다 (문서에 \"module\" 또는 \"currentmodule\" 지시문을 배치하거나, 명시적으로 모듈 이름을 지정해 보십시오)" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "모의 객체가 감지되었습니다: %r" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "%s에 대한 서명을 서식화하는 동안 오류 발생: %s" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "automodule 이름의 \"::\"은 의미가 없음" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "automodule %s에 대해 서명 인수 또는 반환 값 주석이 지정됨" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "__all__은 %r이(가) 아닌 문자열의 목록이어야 합니다 (모듈 %s) -- __all__을 무시합니다" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr ":members: 옵션에 언급된 속성이 없습니다: 모듈 %s, 속성 %s" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "%s에 대한 함수 서명을 가져오지 못했습니다: %s" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "%s에 대한 생성자 서명을 가져오지 못했습니다: %s" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "기반 클래스: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "%s의 별칭" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "TypeVar(%s)의 별칭" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "%s에 대한 메소드 서명을 가져오지 못했습니다: %s" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "%s에서 잘못된 __slots__ 가 발견되었습니다. 무시합니다." #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "autodoc_member_order는 이제 \"alphabetical\" 대신 \"alphabetic\"을 허용합니다. 설정을 업데이트하십시오." #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "%r에 대한 기본 인수 값을 해석하지 못했습니다: %s" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "%r에 대한 서명을 업데이트하지 못했습니다. 매개변수를 찾을 수 없습니다: %s" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "%r에 대한 type_comment를 해석하지 못했습니다: %s" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "autosummary가 제외된 문서 %r을(를) 참조합니다. 무시합니다." #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary: 스텁 파일 %r을(를) 찾을 수 없습니다. autosummary_generate 설정을 확인하십시오." #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "캡션이 있는 자동 요약에는 :toctree: 옵션이 필요합니다. 무시합니다." #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "autosummary: %s을(를) import 하지 못했습니다" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "이름 %s을(를) 해석하지 못함" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "객체 %s을(를) import 하지 못함" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: 파일을 찾을 수 없음: %s" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "autosummary는 내부적으로 .rst 파일을 생성합니다. 하지만 source_suffix에 .rst가 포함되어 있지 않습니다. 건너뜁니다." #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "autosummary: 문서화 할 %r을(를) 결정하지 못했으며, 다음 예외가 발생했습니다:\n%s" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[autosummary] 자동 요약 생성: %s" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "[autosummary] %s에 기록" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "[autosummary] %r을(를) import 하지 못했습니다: %s" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "\nautosummary 지시문을 사용하여 ReStructuredText를 생성합니다.\n\nsphinx-autogen은 sphinx.ext.autosummary.generate의 프런트엔드입니다.\n주어진 입력 파일에 포함된 autosummary 지시문에서 reStructuredText 파일을 생성합니다.\n\nautosummary 지시문의 형식은 ``sphinx.ext.autosummary`` Python 모듈에 문서화되어 있으며 다음 명령을 사용하여 읽을 수 있습니다.\n\n pydoc sphinx.ext.autosummary\n" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "rST 파일을 생성할 원본 파일" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "모든 출력을 저장할 디렉토리" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "파일의 기본 확장자 (기본값: %(default)s)" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "사용자 정의 템플릿 디렉토리 (기본값: %(default)s)" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "가져온 멤버 문서화 (기본값: %(default)s)" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "키워드 매개변수" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "예제" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "예제" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "참고" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "기타 매개변수" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "수신" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "참조" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "경고" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "생성" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "잘못된 값 세트 (닫는 중괄호 누락): %s" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "잘못된 값 세트 (여는 중괄호 누락): %s" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "잘못된 문자열 리터럴 (닫는 따옴표 누락): %s" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "잘못된 문자열 리터럴 (여는 따옴표 누락): %s" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "주의" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "조심" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "위험" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "오류" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "힌트" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "중요" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "참고" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "더 보기" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "팁" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "경고" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "이전 페이지에서 계속" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "다음 페이지에 계속" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "알파벳 이외" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "숫자" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "페이지" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "목차" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "검색" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "이동" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "소스 보기" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "개요" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "환영합니다!" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "문서:" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "최종 업데이트" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "색인 및 표 목록:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "종합 목차" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "모든 구역과 하위 구역 목록" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "문서 검색" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "모듈 총 색인" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "모든 모듈 조견표" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "함수, 클래스 및 용어 개관" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "색인 – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "한 페이지에 전체 색인 보기" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "알파벳별 색인" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "큰 경우가 있으므로 주의" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "탐색" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "%(docstitle)s에서 찾기" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "이 문서 정보" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "저작권" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">저작권</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© 저작권 %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "최종 업데이트: %(last_updated)s" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "<a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s 버전으로 생성되었습니다." #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "%(docstitle)s에서 찾기" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "이전 항목" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "이전 장" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "다음 항목" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "다음 장" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "검색 기능을 사용하려면 JavaScript를 활성화하십시오." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "여러 단어를 검색하면 모든 단어가 포함된 일치 항목만 표시됩니다." #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "검색" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "검색 결과" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "검색어와 일치하는 문서가 없습니다. 모든 단어의 철자가 올바른지, 충분한 카테고리를 선택했는지 확인하십시오." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "빠른 검색" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "현재 문서" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "버전 %(version)s의 변경 사항 — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "버전 %(version)s의 변경 사항 (자동으로 생성된 목록)" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "라이브러리 변경 사항" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API 변경 사항" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "다른 변경 사항" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "이 표제에 대한 퍼머링크" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "이 정의에 대한 퍼머링크" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "검색 일치 숨기기" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "검색 중" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "검색 준비 중…" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "검색이 완료되었으며, 검색어와 일치하는 %s 개 페이지를 찾았습니다." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", 문서 - " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "사이드바 열기" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "사이드바 닫기" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "내용" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "4 개 열 기반 색인을 찾았습니다. 사용하고 있는 확장 기능의 버그일 수 있습니다: %r" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "각주 [%s]이(가) 참조되지 않았습니다." #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "각주 [#]이 참조되지 않았습니다." #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "번역된 메시지의 각주 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "번역된 메시지의 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "번역된 메시지의 인용 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "번역된 메시지의 용어 참조가 일치하지 않습니다. 원본: {0}, 번역: {1}" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "상호 참조에 대한 대체 텍스트를 결정할 수 없습니다. 버그일 수 있습니다." #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "'any' 상호 참조 %r에 대해 둘 이상의 대상이 발견되었습니다: %s 일 수 있습니다" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "%s:%s 참조 대상을 찾을 수 없음: %s" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "%r 참조 대상을 찾을 수 없음: %s" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "원격 이미지를 가져올 수 없습니다: %s [%d]" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "원격 이미지를 가져올 수 없습니다: %s [%s]" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "알 수 없는 이미지 형식: %s…" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "디코드 할 수 없는 원본 문자이며, \"?\"로 대체합니다: %r" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "건너뜀" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "실패" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "알 수 없는 지시문 또는 역할 이름: %s:%s" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "읽기 오류: %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "쓰기 오류: %s, %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "locale_dir %s이(가) 존재하지 않습니다" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "잘못된 날짜 형식입니다. 바로 출력하려면 작은 따옴표로 문자열을 인용하십시오: %s" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "toctree에 존재하지 않는 파일 %r에 대한 참조가 있음" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "only 지시문 식을 평가하는 동안 예외 발생: %s" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "기본 역할 %s을(를) 찾을 수 없음" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "numfig_format이 %s에 대해 정의되지 않음" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "%s 노드에 할당되지 않은 ID" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "이 용어에 대한 퍼머링크" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "이 표에 대한 퍼머링크" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "이 코드에 대한 퍼머링크" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "이 이미지에 대한 퍼머링크" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "이 목차에 대한 퍼머링크" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "이미지 크기를 얻어올 수 없습니다. :scale: 옵션을 무시합니다." #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "알 수 없는 %r toplevel_sectioning (클래스 %r)" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr ":maxdepth:가 너무 크며, 무시합니다." #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "문서 제목이 단일 텍스트 노드가 아님" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "구역, 주제, 표, 조언, 사이드바 안에 있지 않은 제목 노드가 발견됨" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "각주" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "tabularcolumns와 :widths: 옵션이 모두 설정되었습니다. :widths:는 무시됩니다." #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "치수 단위 %s이(가) 잘못되었습니다. 무시합니다." #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "알 수 없는 색인 항목 유형 %s이(가) 발견됨" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[그림: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[그림]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "캡션이 그림 안에 있지 않습니다." #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "구현되지 않은 노드 유형: %r" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "알 수 없는 노드 유형: %r" ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3283956 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/lt/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015522� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4906983 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/lt/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017307� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/lt/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000007174�00000000000�021167� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "lt", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "Apie \u0161iuos dokumentus", "Automatically generated list of changes in version %(version)s": "Automati\u0161kai sugeneruotas pakeitim\u0173 %(version)s versijoje s\u0105ra\u0161as", "C API changes": "C API pakeitimai", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "Pasl\u0117pti \u0161onin\u0119 juost\u0105", "Complete Table of Contents": "Pilnas Turinys", "Contents": "Turinys", "Copyright": "Autoriaus teis\u0117s", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "I\u0161pl\u0117sti \u0161onin\u0119 juost\u0105", "Full index on one page": "Pilnas indeksas viename puslapyje", "General Index": "Bendras indeksas", "Global Module Index": "Globalus Modulio Indeksas", "Go": "Pirmyn", "Hide Search Matches": "Pasl\u0117pti paie\u0161kos rezultatus", "Index": "Indeksas", "Index – %(key)s": "Indeksas – %(key)s", "Index pages by letter": "Indekso puslapiai pagal raid\u0119", "Indices and tables:": "Indeksai ir lentel\u0117s:", "Last updated on %(last_updated)s.": "Paskutinis atnaujinimas %(last_updated)s.", "Library changes": "Bibliotekos pakeitimai", "Navigation": "Navigacija", "Next topic": "Kita tema", "Other changes": "Kiti pakeitimai", "Overview": "Ap\u017evalga", "Permalink to this definition": "Nuoroda \u012f \u0161\u012f apibr\u0117\u017eim\u0105", "Permalink to this headline": "Nuoroda \u012f \u0161i\u0105 antra\u0161t\u0119", "Please activate JavaScript to enable the search\n functionality.": "Pra\u0161ome aktyvuoti JavaScript, kad veikt\u0173 paie\u0161kos\n funkcionalumas.", "Preparing search...": "", "Previous topic": "Praeita tema", "Quick search": "Greitoji paie\u0161ka", "Search": "Paie\u0161ka", "Search Page": "Paie\u0161kos puslapis", "Search Results": "Paie\u0161kos rezultatai", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "Ie\u0161koti tarp %(docstitle)s", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Rodyti pirmin\u012f kod\u0105", "Table of Contents": "", "This Page": "\u0160is puslapis", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "visos funkcijos, klas\u0117s ir terminai", "can be huge": "gali b\u016bti didelis", "last updated": "", "lists all sections and subsections": "sura\u0161yti visus skyrius ir poskyrius", "next chapter": "kita dalis", "previous chapter": "praeita dalis", "quick access to all modules": "greitas vis\u0173 moduli\u0173 pasiekimas", "search": "ie\u0161koti", "search this documentation": "ie\u0161koti \u0161iame dokumente", "the documentation for": "" }, "plural_expr": "(n % 10 == 1 && (n % 100 > 19 || n % 100 < 11) ? 0 : (n % 10 >= 2 && n % 10 <=9) && (n % 100 > 19 || n % 100 < 11) ? 1 : n % 1 != 0 ? 2: 3)" });����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/lt/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000015774�00000000000�021173� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������L��������������|�� ���}������� ����������������������������������� �������� �� ���1 �� ���= �����G �����^ �����o ����� �� ��� ����� ��0��� ����� ����� �� ���$ �� ���. �����8 ��>���A ����� �� ��� ����� ����� �� ��� ����� ����� ����� �� ��� ����� �� ��� ����� �����0 �����6 �� ���E �����O �� ���f �����t ����� ����� ����� �� ��� ����� ����� ����� ����� ��!��� ����� �� ���& �����3 �� ���C �� ���O �� ���\ �����g �� ���y ����� �� ��� ����� ����� �� ��� ����� ����� ��B��� �����< ��$���K �� ���p �����} ����� �� ��� ����� ����� ����� �� ��� ����� ����� ����� ������� ��� �� ��������#�����*�����.�� ���3�����=�����E�����L�����T�����]�� ���{������� ���������� ��������������� ��������������� ���������� ���#�� ���1�����?�����E��"���M�����p�����v�����}����������������� ������������������������������������������� ���������������%�� ���?�� ���I�����W�����\��K��e�� ����� ��������������������������������� �����3��'���B�����j�� ���z�� ������������������������� ����������%��������;�����M�� ���d�����p�� ���y��E����� ���������� �����������������������3�����B�����J�� ���\�����f�����o������������ �����!������������������������� ���-�����7�����>�����G�����`�������)�������������������� ����� ��� �� ��������"�� ���5�����?�����G�� ���W�����a�� ���z������������H����� �����$��������:�����L�����T�����]�����{����������������������������������� �����!�� ���7�����E�� ���M�����W�� ���`�� ���k�� ���w������� �����$����� ���������������������������������,�� ���5�����?�����S�����k�����t�����}�����������������$����� ������������������������������ ��������!�� ���*�����6�����J�� ���S�����a��!���u������������������������������������� ������ (deprecated)� (in �%b %d, %Y�%s %s�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Caution�Changed in version %s�Code author: �Collapse sidebar�Complete Table of Contents�Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Expand sidebar�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Overview: module code�Parameters�Permalink to this definition�Permalink to this headline�Please activate JavaScript to enable the search functionality.�Previous topic�Python Enhancement Proposals; PEP %s�Quick search�Raises�Release�Return type�Returns�Search�Search %(docstitle)s�Search Page�Search Results�Search within %(docstitle)s�Section author: �See also�Show Source�This Page�Throws�Tip�Todo�Variables�Warning�[docs]�[image]�[source]�all functions, classes, terms�attribute�built-in function�can be huge�class�class method�continued from previous page�data�directive�environment variable�environment variable; %s�exception�function�glossary term�grammar token�index�keyword�lists all sections and subsections�macro�member�method�module�modules�next�next chapter�object�operator�original entry�previous�previous chapter�program option�quick access to all modules�reference label�role�search�search this documentation�statement�static method�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: lt Language-Team: Lithuanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/lt/) Plural-Forms: nplurals=4; plural=(n % 10 == 1 && (n % 100 > 19 || n % 100 < 11) ? 0 : (n % 10 >= 2 && n % 10 <=9) && (n % 100 > 19 || n % 100 < 11) ? 1 : n % 1 != 0 ? 2: 3) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (atmestas)� (kuris yra �%Y-%m-%d�%s %s�%s (%s atributas)�%s (įtaisytoji klasė)�%s (įtaisytasis kintamasis)�%s (klasė iš %s)�%s (direktyva)�%s (globalus kintamasis arba konstanta)�%s (modulje %s)�%s (modulis)�%s (rolė)�%s() (%s klasės metodas)�%s() (%s metodas)�%s() (%s statinis metodas)�%s() (itaisytoji funkcija)�%s() (klasė)�%s() (modulyje %s)�<h1>Visi moduliai turintys kodą</h1>�<h1>Kodas %s</h1>�Apie šiuos dokumentus�Argumentais�Dėmesio�Autorius: �Automatiškai sugeneruotas pakeitimų %(version)s versijoje sąrašas�Įtaisytieji�C API pakeitimai�Atsargiai�Pakeista %s versijoje�Kodo autorius: �Paslėpti šoninę juostą�Pilnas Turinys�Turinys�Autoriaus teisės�Pavojinga�Atmestas�Nebepalaikoma nuo %s versijos�Klaida�Išplėsti šoninę juostą�Išnašos�Pilnas indeksas viename puslapyje�Bendras indeksas�Globalus Modulio Indeksas�Pirmyn�Paslėpti paieškos rezultatus�Patarimas�Svarbu�Indeksas�Indeksas – %(key)s�Indekso puslapiai pagal raidę�Indeksai ir lentelės:�Paskutinis atnaujinimas %(last_updated)s.�Bibliotekos pakeitimai�Modulio indeksas�Modulio autorius: �Modulio kodas�Modulio lygis�Navigacija�Nauja %s versijoje�Kita tema�Pastaba�Kiti pakeitimai�Apžvalga�Apžvalga: modulio kodas�Parametrai�Nuoroda į šį apibrėžimą�Nuoroda į šią antraštę�Prašome aktyvuoti JavaScript, kad veiktų paieškos funkcionalumas.�Praeita tema�Python Enhancement Proposals; PEP %s�Greitoji paieška�Sukelia�Leidimas�Grąžinamos reikšmės tipas�Grąžinamos reikšmės�Paieška�Ieškoti %(docstitle)s�Paieškos puslapis�Paieškos rezultatai�Ieškoti tarp %(docstitle)s�Skyriaus autorius: �Taip pat žiūrėkite�Rodyti pirminį kodą�Šis puslapis�Išmeta�Patarimas�Padaryti�Kintamieji�Įspėjimas�[dokumentai]�[paveiksliukas]�[šaltinis]�visos funkcijos, klasės ir terminai�atribudas�įtaisytoji funkcija�gali būti didelis�klasė�klasės metodas�tęsinys iš praeito puslapio�duomenys�direktyva�aplinkos kintamasis�aplinkos kintamasis; %s�išimtis�funkcija�aiškinamasis terminas�gramatinė leksema�indeksas�bazinis žodis�surašyti visus skyrius ir poskyrius�makrokomanda�narys�metodas�modulis�moduliai�kitas�kita dalis�objektas�operatorius�originalus įrašas�praeitas�praeita dalis�programos parinktis�greitas visų modulių pasiekimas�nuorodos požymis�rolė�ieškoti�ieškoti šiame dokumente�sakinis�statinis metodas�tipas�kintamasis�����././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/lt/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000246223�00000000000�021171� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # DALIUS DOBRAVOLSKAS <DALIUS@SANDBOX.LT>, 2010 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Lithuanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/lt/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: lt\n" "Plural-Forms: nplurals=4; plural=(n % 10 == 1 && (n % 100 > 19 || n % 100 < 11) ? 0 : (n % 10 >= 2 && n % 10 <=9) && (n % 100 > 19 || n % 100 < 11) ? 1 : n % 1 != 0 ? 2: 3);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Įtaisytieji" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Modulio lygis" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (kuris yra " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%Y-%m-%d" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Bendras indeksas" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "indeksas" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "kitas" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "praeitas" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Indeksas" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Leidimas" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Skyriaus autorius: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Modulio autorius: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Kodo autorius: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autorius: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametrai" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Grąžinamos reikšmės" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Grąžinamos reikšmės tipas" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "narys" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "kintamasis" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funkcija" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "makrokomanda" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "tipas" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Nauja %s versijoje" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Pakeista %s versijoje" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Nebepalaikoma nuo %s versijos" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Išmeta" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "klasė" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (itaisytoji funkcija)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s metodas)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (klasė)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (globalus kintamasis arba konstanta)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s atributas)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumentais" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modulis)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "metodas" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "duomenys" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atribudas" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modulis" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "bazinis žodis" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operatorius" #: sphinx/domains/python.py:61 msgid "object" msgstr "objektas" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "išimtis" #: sphinx/domains/python.py:63 msgid "statement" msgstr "sakinis" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "įtaisytoji funkcija" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Kintamieji" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Sukelia" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (modulyje %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (modulje %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (įtaisytasis kintamasis)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (įtaisytoji klasė)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (klasė iš %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s klasės metodas)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s statinis metodas)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "moduliai" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Atmestas" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "klasės metodas" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "statinis metodas" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (atmestas)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (direktyva)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (rolė)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "direktyva" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "rolė" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "aplinkos kintamasis; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "aiškinamasis terminas" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "gramatinė leksema" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "nuorodos požymis" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "aplinkos kintamasis" #: sphinx/domains/std.py:568 msgid "program option" msgstr "programos parinktis" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Modulio indeksas" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Paieškos puslapis" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[šaltinis]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Padaryti" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "originalus įrašas" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[dokumentai]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Modulio kodas" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Kodas %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Apžvalga: modulio kodas" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Visi moduliai turintys kodą</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Dėmesio" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Atsargiai" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Pavojinga" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Klaida" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Patarimas" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Svarbu" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Pastaba" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Taip pat žiūrėkite" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Patarimas" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Įspėjimas" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "tęsinys iš praeito puslapio" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Paieška" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Pirmyn" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Rodyti pirminį kodą" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Apžvalga" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Indeksai ir lentelės:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Pilnas Turinys" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "surašyti visus skyrius ir poskyrius" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "ieškoti šiame dokumente" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Globalus Modulio Indeksas" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "greitas visų modulių pasiekimas" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "visos funkcijos, klasės ir terminai" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Indeksas – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Pilnas indeksas viename puslapyje" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Indekso puslapiai pagal raidę" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "gali būti didelis" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigacija" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Ieškoti tarp %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Apie šiuos dokumentus" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Autoriaus teisės" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Paskutinis atnaujinimas %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Ieškoti %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Praeita tema" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "praeita dalis" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Kita tema" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "kita dalis" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Prašome aktyvuoti JavaScript, kad veiktų paieškos\n funkcionalumas." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "ieškoti" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Paieškos rezultatai" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Greitoji paieška" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Šis puslapis" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automatiškai sugeneruotas pakeitimų %(version)s versijoje sąrašas" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Bibliotekos pakeitimai" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API pakeitimai" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Kiti pakeitimai" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Nuoroda į šią antraštę" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Nuoroda į šį apibrėžimą" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Paslėpti paieškos rezultatus" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Išplėsti šoninę juostą" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Paslėpti šoninę juostą" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Turinys" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Išnašos" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[paveiksliukas]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3285735 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/lv/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015524� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4921215 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/lv/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017311� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/lv/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000007150�00000000000�021163� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "lv", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "Par \u0161iem dokumentiem", "Automatically generated list of changes in version %(version)s": "Autom\u0101tiski sagatavots izmai\u0146u saraksts versijai %(version)s", "C API changes": "Izmai\u0146as iek\u0161 C API", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "Sav\u0113rst s\u0101njoslu", "Complete Table of Contents": "Pilns saturs", "Contents": "Saturs", "Copyright": "Copyright", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Izplest s\u0101njoslu", "Full index on one page": "Pilns indekss vien\u0101 lappus\u0113", "General Index": "Visp\u0101r\u0113js indekss", "Global Module Index": "Visp\u0101r\u0113js modu\u013cu indekss", "Go": "Izpild\u012bt", "Hide Search Matches": "Pasl\u0113pt atlases v\u0101rdus", "Index": "Indekss", "Index – %(key)s": "Indekss – %(key)s", "Index pages by letter": "Lappu\u0161u indekss p\u0113c burtiem", "Indices and tables:": "Indeksi un tabulas:", "Last updated on %(last_updated)s.": "P\u0113d\u0113jas izmai\u0146as %(last_updated)s.", "Library changes": "Bibliot\u0113kas izmai\u0146as", "Navigation": "Navig\u0101cija", "Next topic": "n\u0101ko\u0161a t\u0113ma", "Other changes": "Citas izmai\u0146as", "Overview": "Apskats", "Permalink to this definition": "Past\u0101v\u012bga nor\u0101de uz \u0161o defin\u012bciju", "Permalink to this headline": "Past\u0101v\u012bga nor\u0101de \u0161o virsrakstu", "Please activate JavaScript to enable the search\n functionality.": "Lai iesp\u0113jotu mekl\u0113\u0161anu, l\u016bdzu aktiviz\u0113t JavaScript.", "Preparing search...": "", "Previous topic": "iepriek\u0161\u0113ja t\u0113ma", "Quick search": "\u0100tra mekl\u0113\u0161ana", "Search": "Mekl\u0113t", "Search Page": "Atlases lapa", "Search Results": "Atlases rezult\u0101ti", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "Mekl\u0113t iek\u0161 %(docstitle)s", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "R\u0101d\u012bt izejas tekstu", "Table of Contents": "", "This Page": "\u0160\u012b lappuse", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "visas funkcijas, klases un termini", "can be huge": "var b\u016bt milz\u012bgs", "last updated": "", "lists all sections and subsections": "r\u0101da visas sekcijas un apak\u0161sekcijas", "next chapter": "n\u0101ko\u0161a sada\u013ca", "previous chapter": "iepriek\u0161\u0113ja sada\u013ca", "quick access to all modules": "\u0101tra piek\u013cuve visiem moduliem", "search": "mekl\u0113t", "search this documentation": "mekl\u0113t \u0161aj\u0101 dokument\u0101cij\u0101", "the documentation for": "" }, "plural_expr": "(n%10==1 && n%100!=11 ? 0 : n != 0 ? 1 : 2)" });������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/lv/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000015331�00000000000�021162� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������<��������������\�����]�� ���c�����m�����s���������������������� ���������� ��� �� ��� ����� �����0 �����A �����Y �����r ��0��� ����� ����� �� ��� �� ��� ����� ��>��� �����E �� ���N �����\ �����d �� ���z ����� ����� ����� �� ��� ����� �� ��� ����� ����� ����� �� ��� ����� �� ���+ �����9 �����M �����P �����d �� ���i �����s �����y ����� ����� ��!��� ����� �� ��� ����� �� ��� �� ��� �� ���! �����, �� ���> �����I �� ���N �����\ �����e �� ���{ ����� ����� ��B��� ����� �� ��� ����� �����$ �� ���, �����8 �����@ �����G �� ���\ �����h �����w ����� ����� �� ��� �� ��� ����� ����� ����� �� ��� ����� ����� �� ��� ����� ����������� �� ���'�����1�� ���C�����O�� ���U�����b������� ��������������� ���������� ����� ���������������"�������������"�����)�����0�����7�����?�� ���D�����Q�����X�����a�����p�����y�������������������������������� ����� �������������������������������� ����������#�����9�����V�����j��(���z������� ����� ����������������������������+��.���>�����m������� ����� ����������>����� ������������������$�� ���9�����G�� ���Z�����g�� ���n�����x�� ���������������������������������������� ��������#�����<�����E�����N�����V�����n�������%���������������������������� �� ��������*�����<�����K�����T�����d�����l�� �����&�����"�����9�������������&�����8�� ���=�����G�����Z�����c�����k�� �������������������� ���������� ���������������� ��� �� ����� ���!�� ���/�� ���;�� ���I�����S��"���Z�����}����������������� �����(���������� ��������������� ���)�����4�����=�����P�����h�����p��&������������������������������ ��������������� ���������� ��������!�����7�����I�����i�����}������������ ��������������� ������ (in �%b %d, %Y�%s %s�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (in module %s)�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Caution�Changed in version %s�Code author: �Collapse sidebar�Complete Table of Contents�Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Expand sidebar�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Overview: module code�Parameters�Permalink to this definition�Permalink to this headline�Please activate JavaScript to enable the search functionality.�Previous topic�Quick search�Raises�Release�Return type�Returns�Search�Search %(docstitle)s�Search Page�Search Results�Search within %(docstitle)s�Section author: �See also�Show Source�This Page�Throws�Tip�Todo�Variables�Warning�[docs]�[image: %s]�[image]�[source]�all functions, classes, terms�attribute�built-in function�can be huge�class�class method�continued from previous page�data�directive�environment variable�environment variable; %s�exception�function�glossary term�grammar token�index�keyword�lists all sections and subsections�macro�member�method�module�modules�next�next chapter�object�operator�original entry�previous�previous chapter�program option�quick access to all modules�reference label�role�search�search this documentation�statement�static method�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: lv Language-Team: Latvian (http://www.transifex.com/sphinx-doc/sphinx-1/language/lv/) Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n != 0 ? 1 : 2) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (iekš �%d.%m.%Y�%s %s�%s (%s atributs)�%s (iebūvēta klase)�%s (iebūvētais mainīgais)�%s (klase iekš %s)�%s (direktīva)�%s (globālais mainīgais vai konstanta)�%s (moduļī %s)�%s (modulis)�%s (role)�%s() (%s klases metods)�%s() (%s metods)�%s() (%s statiskais metods)�%s() (iebūvēta funkcija)�%s() (moduļī %s)�<h1>Visi moduļi, kuriem ir izejas teksti</h1>�<h1>%s izejas teksts</h1>�Par šiem dokumentiem�Argumenti�Uzmanību�Autors: �Automātiski sagatavots izmaiņu saraksts versijai %(version)s�Iebūvētie�Izmaiņas iekš C API�Uzmanies�Mainīts versijā %s�Koda autors: �Savērst sānjoslu�Pilns saturs�Saturs�Copyright�Bīstami�Nav ieteicams�Neieteicams no versijas %s�Kļūda�Izplest sānjoslu�Vēres�Pilns indekss vienā lappusē�Vispārējs indekss�Vispārējs moduļu indekss�Izpildīt�Paslēpt atlases vārdus�Mājiens�Svarīgi�Indekss�Indekss – %(key)s�Lappušu indekss pēc burtiem�Indeksi un tabulas:�Pēdējas izmaiņas %(last_updated)s.�Bibliotēkas izmaiņas�Moduļu indekss�Moduļa autors: �Moduļa teksts�Moduļu līmenis�Navigācija�Jauns versijā %s�nākoša tēma�Piezīme�Citas izmaiņas�Apskats�Apskats: moduļa teksts�Parametri�Pastāvīga norāde uz šo definīciju�Pastāvīga norāde šo virsrakstu�Lai iespējotu meklēšanu, lūdzu aktivizēt JavaScript.�iepriekšēja tēma�Ātra meklēšana�Ceļ�Izlaidums�Atgriežamais tips�Atgriež�Meklēt�%(docstitle)s meklēšana�Atlases lapa�Atlases rezultāti�Meklēt iekš %(docstitle)s�Sekcijas autors: �Skat.arī�Rādīt izejas tekstu�Šī lappuse�Izmet�Padoms�Jāizdara�Mainīgie�Brīdinājums�[dokumenti]�[attēls: %s]�[attēls]�[kods]�visas funkcijas, klases un termini�atributs�iebūvēta funkcija�var būt milzīgs�klase�klases metods�turpinājums no iepriekšējās lappuses�dati�direktīva�apkārtnes mainīgais�apkārtnes mainīgais; %s�izņēmums�funkcija�glosārija termins�gramatiskais marķieris�indekss�atslēgas vārds�rāda visas sekcijas un apakšsekcijas�makross�loceklis�metods�modulis�moduļi�nākošais�nākoša sadaļa�objekts�operators�sākotnējs ieraksts�iepriekšējs�iepriekšēja sadaļa�programmas opcija�ātra piekļuve visiem moduliem�atsauces virsraksts�role�meklēt�meklēt šajā dokumentācijā�priekšraksts�statiskais metods�tips�mainīgais��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/lv/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000245625�00000000000�021200� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Latvian (http://www.transifex.com/sphinx-doc/sphinx-1/language/lv/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: lv\n" "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n != 0 ? 1 : 2);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Iebūvētie" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Moduļu līmenis" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (iekš " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d.%m.%Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Vispārējs indekss" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "indekss" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "nākošais" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "iepriekšējs" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Indekss" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Izlaidums" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Sekcijas autors: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Moduļa autors: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Koda autors: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autors: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametri" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Atgriež" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Atgriežamais tips" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "loceklis" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "mainīgais" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funkcija" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "makross" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "tips" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Jauns versijā %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Mainīts versijā %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Neieteicams no versijas %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Izmet" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "klase" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (iebūvēta funkcija)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s metods)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (globālais mainīgais vai konstanta)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s atributs)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumenti" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modulis)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "metods" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "dati" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atributs" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modulis" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "atslēgas vārds" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operators" #: sphinx/domains/python.py:61 msgid "object" msgstr "objekts" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "izņēmums" #: sphinx/domains/python.py:63 msgid "statement" msgstr "priekšraksts" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "iebūvēta funkcija" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Mainīgie" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Ceļ" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (moduļī %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (moduļī %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (iebūvētais mainīgais)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (iebūvēta klase)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (klase iekš %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s klases metods)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s statiskais metods)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "moduļi" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Nav ieteicams" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "klases metods" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "statiskais metods" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (direktīva)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (role)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "direktīva" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "role" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "apkārtnes mainīgais; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "glosārija termins" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "gramatiskais marķieris" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "atsauces virsraksts" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "apkārtnes mainīgais" #: sphinx/domains/std.py:568 msgid "program option" msgstr "programmas opcija" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Moduļu indekss" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Atlases lapa" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[kods]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Jāizdara" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "sākotnējs ieraksts" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[dokumenti]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Moduļa teksts" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>%s izejas teksts</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Apskats: moduļa teksts" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Visi moduļi, kuriem ir izejas teksti</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Uzmanību" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Uzmanies" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Bīstami" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Kļūda" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Mājiens" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Svarīgi" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Piezīme" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Skat.arī" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Padoms" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Brīdinājums" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "turpinājums no iepriekšējās lappuses" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Meklēt" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Izpildīt" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Rādīt izejas tekstu" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Apskats" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Indeksi un tabulas:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Pilns saturs" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "rāda visas sekcijas un apakšsekcijas" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "meklēt šajā dokumentācijā" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Vispārējs moduļu indekss" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "ātra piekļuve visiem moduliem" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "visas funkcijas, klases un termini" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Indekss – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Pilns indekss vienā lappusē" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Lappušu indekss pēc burtiem" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "var būt milzīgs" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigācija" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Meklēt iekš %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Par šiem dokumentiem" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Copyright" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Pēdējas izmaiņas %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "%(docstitle)s meklēšana" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "iepriekšēja tēma" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "iepriekšēja sadaļa" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "nākoša tēma" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "nākoša sadaļa" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Lai iespējotu meklēšanu, lūdzu aktivizēt JavaScript." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "meklēt" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Atlases rezultāti" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Ātra meklēšana" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Šī lappuse" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automātiski sagatavots izmaiņu saraksts versijai %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Bibliotēkas izmaiņas" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Izmaiņas iekš C API" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Citas izmaiņas" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Pastāvīga norāde šo virsrakstu" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Pastāvīga norāde uz šo definīciju" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Paslēpt atlases vārdus" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Izplest sānjoslu" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Savērst sānjoslu" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Saturs" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Vēres" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[attēls: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[attēls]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �����������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3287513 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/mk/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015512� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4929433 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/mk/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017277� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/mk/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000004766�00000000000�021163� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "mk", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "\u0413\u043b\u0430\u0432\u043d\u0430 \u0441\u043e\u0434\u0440\u0436\u0438\u043d\u0430", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n % 10 == 1 && n % 100 != 11) ? 0 : 1" });����������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/mk/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000003715�00000000000�021153� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� ��������������������������� ���#�����-�����3�����G�����X�� ���q�����~������� ����� ���������� ����� �����$����� ������������� ����������&�����-�����3�����<�����B�����H�����O�����T�����]�� ���d�����p�����u����~�����e�� ���m�����w�� ���}�������(���������� ������������� �����$�����B�����^�����w��>���������� �����#��������������� ���(�����3�����D�� ���U�����`�� ���i�����v����������������������� (in �%b %d, %Y�%s %s�%s %s documentation�%s() (%s method)�%s() (built-in function)�%s() (class)�Author: �Builtins�Code author: �General Index�Module author: �Module level�Parameters�Python Enhancement Proposals; PEP %s�Return type�Returns�Section author: �Symbols�Throws�class�function�index�macro�member�next�previous�see %s�see also %s�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: mk Language-Team: Macedonian (http://www.transifex.com/sphinx-doc/sphinx-1/language/mk/) Plural-Forms: nplurals=2; plural=(n % 10 == 1 && n % 100 != 11) ? 0 : 1 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (во �%d %b, %Y�%s %s�%s %s документација�%s() (%s метод)�%s() (вградена функција)�%s() (класа)�Автор: �Вградени�Автор на код:�Главна содржина�Автор на модул:�Ниво на модул�Параметри�Предлог за подобрување на Python; PEP %s�Повратен тип�Враќа�Автор на секцијата:�Симболи�Фрла�класа�функција�содржина�макро�член�следна�претходна�погледни %s�погледни %s�тип�променлива����������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/mk/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000242663�00000000000�021165� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Vasil Vangelovski <vvangelovski@gmail.com>, 2013 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Macedonian (http://www.transifex.com/sphinx-doc/sphinx-1/language/mk/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: mk\n" "Plural-Forms: nplurals=2; plural=(n % 10 == 1 && n % 100 != 11) ? 0 : 1;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Предлог за подобрување на Python; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Вградени" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Ниво на модул" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (во " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d %b, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Главна содржина" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "содржина" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "следна" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "претходна" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s документација" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Автор на секцијата:" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Автор на модул:" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Автор на код:" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Автор: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Параметри" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Враќа" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Повратен тип" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "член" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "променлива" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "функција" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "макро" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "тип" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Фрла" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "класа" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (вградена функција)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s метод)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (класа)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "погледни %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "погледни %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Симболи" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �����������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3289313 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/nb_NO/�������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016076� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4937363 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/nb_NO/LC_MESSAGES/�������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017663� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.js����������������������������������������������0000644�0000766�0000024�00000006351�00000000000�021537� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "nb_NO", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "Om disse dokumenter", "Automatically generated list of changes in version %(version)s": "Automatisk generert liste over endringer i versjon %(version)s", "C API changes": "Endringer i C API", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "Skjul sidepanelet", "Complete Table of Contents": "Komplett Innholdsfortegnelse", "Contents": "Innhold", "Copyright": "Copyright", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Utvid sidepanelet", "Full index on one page": "Hele innholdsfortegnelsen p\u00e5 en side", "General Index": "Hovedindex", "Global Module Index": "Global Modulindex", "Go": "G\u00e5", "Hide Search Matches": "Skjul s\u00f8keresultat", "Index": "Index", "Index – %(key)s": "Index – %(key)s", "Index pages by letter": "Innholdsfortegnelse per bokstav", "Indices and tables:": "Index og tabeller", "Last updated on %(last_updated)s.": "Sist oppdatert %(last_updated)s.", "Library changes": "Endringer i biblioteket", "Navigation": "Navigering", "Next topic": "Neste emne", "Other changes": "Andre endringer", "Overview": "Oversikt", "Permalink to this definition": "Permalink til denne definisjonen", "Permalink to this headline": "Permalink til denne oversikten", "Please activate JavaScript to enable the search\n functionality.": "Vennligst aktiver JavaScript for \u00e5 aktivere s\u00f8k.", "Preparing search...": "", "Previous topic": "Forrige tittel", "Quick search": "Hurtigs\u00f8k", "Search": "S\u00f8k", "Search Page": "S\u00f8keside", "Search Results": "S\u00f8keresultat", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "S\u00f8k blant %(docstitle)s", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Vis kildekode", "Table of Contents": "", "This Page": "Denne siden", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "alla funksjoner, klasser, vilk\u00e5r", "can be huge": "kan bli stor", "last updated": "", "lists all sections and subsections": "liste over alle paragrafer og underparagrafer", "next chapter": "neste kapittel", "previous chapter": "Forrige kapittel", "quick access to all modules": "snarvei til alle moduler", "search": "s\u00f8k", "search this documentation": "s\u00f8k i dette dokumentet", "the documentation for": "" }, "plural_expr": "(n != 1)" });���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.mo����������������������������������������������0000644�0000766�0000024�00000015301�00000000000�021531� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������d���������������� ���������� ���������������������������� ����� �� ���. �����O �� ���a �� ���m �����w ����� ����� ����� �� ��� ����� ��0��� �����" �����> �� ���T �� ���^ �����h ��>���q ����� �� ��� ����� ����� �� ��� ����� ����� ����� �� ���( �����2 �� ���9 �����D �����` �����f �� ���u ����� �� ��� ����� ����� ����� ����� �� ��� ����� ����� ����� ����� ��!���$ �����F �� ���V �����c �� ���s �� ��� �� ��� ����� �� ��� ����� �� ��� ����� ����� �� ��� ����� ����� ��B���) �����l ��$���{ ����� �� ��� ����� ����� �� ��� ����� ����� ����� �� ��������� ����������7�����H�� ���Q�� ���]�����g�����n�����r�� ���w��������������������������� ���������� ���������� ��������������� ��������&�����;�� ���T�����^�� ���g�� ���u������������"����������������������������������� ���������������������������������"�����1�����M�����]�����b�����i������� ����� ����� ������������������� ���������� ������������������������������ ��� ��#��������;�� ���K�� ���V�����a�����x������������ ����������+�������������!�����5�����>�� ���B��>���N�� �������������������������������������� �� �������������"�����+�����E�����J�����\��%���e�� �������������������������������������������������� ��������;�� ���S�����^�����p�� ����� ���������� ������������������������� ����� ����������2���4�����g��$���v������� ���������� ����� ����� ��������������� ����� �������� �����&�����:�� ���C�� ���Q�����]�����d�����i�� ���n�����x�����������������!����� ���������� ���������� �������������!�����&�����/�����>�����Q�����W�����`�����i�����z�� �����-������������������������������������������������������������������ ���0�����<�����U�����g�����m�����r������� �������������������������� (deprecated)� (in �%b %d, %Y�%s %s�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Caution�Changed in version %s�Code author: �Collapse sidebar�Complete Table of Contents�Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Expand sidebar�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Overview: module code�Parameters�Permalink to this definition�Permalink to this headline�Please activate JavaScript to enable the search functionality.�Previous topic�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Release�Return type�Returns�Search�Search %(docstitle)s�Search Page�Search Results�Search within %(docstitle)s�Section author: �See also�Show Source�This Page�Throws�Tip�Todo�Variables�Warning�[docs]�[image]�[source]�all functions, classes, terms�attribute�built-in function�can be huge�class�class method�continued from previous page�data�directive�environment variable�environment variable; %s�exception�function�glossary term�grammar token�index�keyword�lists all sections and subsections�macro�member�method�module�modules�next�next chapter�object�operator�original entry�previous�previous chapter�program option�quick access to all modules�reference label�role�search�search this documentation�see %s�see also %s�statement�static method�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-10-31 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: nb_NO Language-Team: Norwegian Bokmål (Norway) (http://www.transifex.com/sphinx-doc/sphinx-1/language/nb_NO/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (foreldet)�(i �%b %d, %Y�%s %s�%s (%s attribut)�%s (innebygd klasse)�%s (innebygd variabel)�%s (klasse i %s)�%s (direktiv)�%s (global variabel eller konstant)�%s (i modul %s)�%s (modul)�%s (rolle)�%s() (%s klassemetode)�%s() (%s metode)�%s() (%s statisk metode)�%s() (innebygd funksjon)�%s() (klasse)�%s() (i modul %s)�<h1>Alla moduler hvor kildekode finnes</h1>�<h1>Kildekode for %s</h1>�Om disse dokumenter�Argument�Obs�Forfatter: �Automatisk generert liste over endringer i versjon %(version)s�Innebygde�Endringer i C API�Advarsel�Endret i version %s�Kildekode forfatter: �Skjul sidepanelet�Komplett Innholdsfortegnelse�Innhold�Copyright�Fare�Foreldet�Foreldet siden version %s�Feil�Utvid sidepanelet�Fotnoter�Hele innholdsfortegnelsen på en side�Hovedindex�Global Modulindex�Gå�Skjul søkeresultat�Hint�Viktig�Index�Index – %(key)s�Innholdsfortegnelse per bokstav�Index og tabeller�Sist oppdatert %(last_updated)s.�Endringer i biblioteket�Modulindex�Modul forfattar: �Modul kildekode�Modulnivå�Navigering�Nytt i version %s�Neste emne�Obs�Andre endringer�Oversikt�Oversikt: modulkildekode�Parametere�Permalink til denne definisjonen�Permalink til denne oversikten�Vennligst aktiver JavaScript for å aktivere søk.�Forrige tittel�Python Enhancement Proposals; PEP %s�Python Modulindex�Hurtigsøk�Hever�Utgivelse�Retur type�Returnere�Søk�Søk %(docstitle)s�Søkeside�Søkeresultat�Søk blant %(docstitle)s�Seksjon forfatter: �Se også�Vis kildekode�Denne siden�Kaster�Tips�Todo�Variabler�Advarsel�[dokumentasjon]�[bilde]�[kilde]�alla funksjoner, klasser, vilkår�attributt�innebygde funksjoner�kan bli stor�klasse�klassemetode�fortsettelse fra forrige side�data�direktiv�miljøvariabel�miljøvariabel; %s�untak�funksjon�ordliste�grammatikk token�index�nøkkelord�liste over alle paragrafer og underparagrafer�makro�medlem�metode�modul�moduler�neste�neste kapittel�objekt�operator�opprinnelig oppføring�forrige�Forrige kapittel�programvalg�snarvei til alle moduler�referanse-etikett�rolle�søk�søk i dette dokumentet�se %s�se også %s�uttrykk�statisk metode�type�variabel��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/nb_NO/LC_MESSAGES/sphinx.po����������������������������������������������0000644�0000766�0000024�00000245314�00000000000�021545� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-10-31 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Norwegian Bokmål (Norway) (http://www.transifex.com/sphinx-doc/sphinx-1/language/nb_NO/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: nb_NO\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Innebygde" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Modulnivå" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "(i " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Hovedindex" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "index" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "neste" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "forrige" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Index" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Utgivelse" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Seksjon forfatter: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Modul forfattar: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Kildekode forfatter: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Forfatter: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametere" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428 msgid "Returns" msgstr "Returnere" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:430 msgid "Return type" msgstr "Retur type" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "medlem" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "variabel" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164 msgid "function" msgstr "funksjon" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "makro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "type" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Nytt i version %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Endret i version %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Foreldet siden version %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Kaster" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1166 msgid "class" msgstr "klasse" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (innebygd funksjon)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s metode)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (klasse)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (global variabel eller konstant)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s attribut)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argument" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modul)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168 msgid "method" msgstr "metode" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165 msgid "data" msgstr "data" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171 msgid "attribute" msgstr "attributt" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1173 msgid "module" msgstr "modul" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "nøkkelord" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operator" #: sphinx/domains/python.py:61 msgid "object" msgstr "objekt" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1167 msgid "exception" msgstr "untak" #: sphinx/domains/python.py:63 msgid "statement" msgstr "uttrykk" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "innebygde funksjoner" #: sphinx/domains/python.py:421 msgid "Variables" msgstr "Variabler" #: sphinx/domains/python.py:425 msgid "Raises" msgstr "Hever" #: sphinx/domains/python.py:648 sphinx/domains/python.py:792 #, python-format msgid "%s() (in module %s)" msgstr "%s() (i modul %s)" #: sphinx/domains/python.py:708 sphinx/domains/python.py:884 #: sphinx/domains/python.py:935 #, python-format msgid "%s (in module %s)" msgstr "%s (i modul %s)" #: sphinx/domains/python.py:710 #, python-format msgid "%s (built-in variable)" msgstr "%s (innebygd variabel)" #: sphinx/domains/python.py:735 #, python-format msgid "%s (built-in class)" msgstr "%s (innebygd klasse)" #: sphinx/domains/python.py:736 #, python-format msgid "%s (class in %s)" msgstr "%s (klasse i %s)" #: sphinx/domains/python.py:797 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s klassemetode)" #: sphinx/domains/python.py:799 sphinx/domains/python.py:939 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s statisk metode)" #: sphinx/domains/python.py:1093 msgid "Python Module Index" msgstr "Python Modulindex" #: sphinx/domains/python.py:1094 msgid "modules" msgstr "moduler" #: sphinx/domains/python.py:1143 msgid "Deprecated" msgstr "Foreldet" #: sphinx/domains/python.py:1169 msgid "class method" msgstr "klassemetode" #: sphinx/domains/python.py:1170 msgid "static method" msgstr "statisk metode" #: sphinx/domains/python.py:1172 msgid "property" msgstr "" #: sphinx/domains/python.py:1230 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1350 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1404 msgid " (deprecated)" msgstr " (foreldet)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (direktiv)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (rolle)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "direktiv" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "rolle" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "miljøvariabel; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "ordliste" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "grammatikk token" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "referanse-etikett" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "miljøvariabel" #: sphinx/domains/std.py:568 msgid "program option" msgstr "programvalg" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Modulindex" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Søkeside" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "se %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "se også %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:173 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:204 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:218 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:224 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:334 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:336 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:369 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:382 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[kilde]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Todo" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "opprinnelig oppføring" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[dokumentasjon]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Modul kildekode" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Kildekode for %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Oversikt: modulkildekode" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Alla moduler hvor kildekode finnes</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:78 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Obs" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Advarsel" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Fare" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Feil" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Hint" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Viktig" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Obs" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Se også" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Tips" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Advarsel" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "fortsettelse fra forrige side" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Søk" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Gå" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Vis kildekode" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Oversikt" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Index og tabeller" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Komplett Innholdsfortegnelse" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "liste over alle paragrafer og underparagrafer" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "søk i dette dokumentet" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Global Modulindex" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "snarvei til alle moduler" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "alla funksjoner, klasser, vilkår" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Index – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Hele innholdsfortegnelsen på en side" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Innholdsfortegnelse per bokstav" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "kan bli stor" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigering" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Søk blant %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Om disse dokumenter" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Copyright" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Sist oppdatert %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Søk %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Forrige tittel" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "Forrige kapittel" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Neste emne" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "neste kapittel" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Vennligst aktiver JavaScript for å aktivere søk." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "søk" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Søkeresultat" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Hurtigsøk" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Denne siden" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automatisk generert liste over endringer i versjon %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Endringer i biblioteket" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Endringer i C API" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Andre endringer" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Permalink til denne oversikten" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Permalink til denne definisjonen" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Skjul søkeresultat" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Utvid sidepanelet" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Skjul sidepanelet" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Innhold" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Fotnoter" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[bilde]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3291178 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ne/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015505� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4945145 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ne/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017272� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ne/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000014770�00000000000�021152� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "ne", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "\u092f\u0940 \u0921\u0915\u0941\u092e\u0947\u0928\u094d\u091f\u0939\u0930\u0941\u0915\u094b \u092c\u093e\u0930\u0947\u092e\u093e", "Automatically generated list of changes in version %(version)s": "\u092d\u0930\u094d\u0938\u0928 %(version)s \u092e\u093e \u092d\u090f\u0915\u093e \u092b\u0930\u0915 \u0939\u0930\u0941 \u0906\u092b\u0948 \u091c\u0947\u0928\u0947\u0930\u0947\u091f \u092d\u090f ", "C API changes": "C API \u0915\u093e \u092a\u0930\u093f\u0935\u0930\u094d\u0924\u0928\u0939\u0930\u0941 ", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "\u0938\u093e\u0907\u0921\u092c\u0930 \u0938\u093e\u0928\u094b \u092c\u0928\u093e\u0909\u0928\u0941\u0939\u094b\u0938\u094d", "Complete Table of Contents": "\u092a\u0941\u0930\u093e \u0935\u093f\u0937\u092f\u0938\u0942\u091a\u0940", "Contents": "\u0935\u093f\u0937\u092f\u0938\u0942\u091a\u0940", "Copyright": "\u0915\u092a\u093f\u0930\u093e\u0907\u091f ", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "\u0938\u093e\u0907\u0921\u092c\u0930 \u0920\u0941\u0932\u094b \u092c\u0928\u093e\u0909\u0928\u0941\u0939\u094b\u0938\u094d", "Full index on one page": "\u092a\u0941\u0930\u093e \u0905\u0928\u0941\u0938\u0941\u091a\u0940 \u090f\u0915\u0948 \u092a\u093e\u0928\u093e\u092e\u093e", "General Index": "\u0938\u093e\u092e\u093e\u0928\u094d\u092f \u0905\u0928\u0941\u0938\u0941\u091a\u0940", "Global Module Index": "\u0917\u094d\u0932\u094b\u092c\u0932 \u092e\u0921\u0941\u0932 \u0905\u0928\u0941\u0938\u0941\u091a\u0940", "Go": "\u091c\u093e\u0928\u0941\u0939\u094b\u0938\u094d", "Hide Search Matches": "\u0916\u094b\u091c\u0947\u0915\u094b \u0928\u0924\u093f\u091c\u093e\u0939\u0930\u0941 \u0932\u0941\u0915\u093e\u0909\u0928\u0941\u0939\u094b\u0938\u094d", "Index": "\u0905\u0928\u0941\u0938\u0941\u091a\u0940", "Index – %(key)s": "Index – %(key)s", "Index pages by letter": "\u0905\u0915\u094d\u0937\u0930 \u0905\u0928\u0941\u0938\u093e\u0930 \u0905\u0928\u0941\u0938\u0941\u091a\u0940\u0915\u093e \u092a\u093e\u0928\u093e", "Indices and tables:": "\u0907\u0928\u094d\u0921\u0940\u0938\u0940\u0938\u094d\u0938 \u0930 \u0924\u0932\u093f\u0915\u093e", "Last updated on %(last_updated)s.": "\u092f\u094b \u092d\u0928\u094d\u0926\u093e \u0905\u0917\u093e\u0921\u0940 %(last_updated)s \u092e\u093e \u0905\u092a\u0921\u0947\u091f \u092d\u090f\u0915\u094b", "Library changes": "\u0932\u093e\u0908\u092c\u094d\u0930\u0947\u0930\u0940\u0915\u093e \u092a\u0930\u093f\u0935\u0930\u094d\u0924\u0928\u0939\u0930\u0941", "Navigation": "\u0928\u0947\u092d\u093f\u0917\u0947\u0938\u0928 ", "Next topic": "\u092a\u091b\u093f\u0932\u094d\u0932\u094b \u0935\u093f\u0937\u092f", "Other changes": "\u0905\u0930\u0941 \u092a\u0930\u093f\u0935\u0930\u094d\u0924\u0928\u0939\u0930\u0941 ", "Overview": "\u092a\u0941\u0928\u0930\u093e\u0935\u0932\u094b\u0915\u0928 ", "Permalink to this definition": "\u092f\u094b \u0905\u0930\u094d\u0925\u0915\u094b \u0932\u093e\u0917\u093f \u092a\u0930\u094d\u092e\u093e\u0932\u093f\u0928\u094d\u0915", "Permalink to this headline": "\u092f\u094b \u0936\u093f\u0930\u094d\u0937\u0915\u0915\u094b \u0932\u093e\u0917\u093f \u092a\u0930\u094d\u092e\u093e\u0932\u093f\u0928\u094d\u0915 \u0964 ", "Please activate JavaScript to enable the search\n functionality.": "\u0916\u094b\u091c\u094d\u0928\u0947 \u0915\u093e\u0930\u094d\u092f \u0906\u0917\u093e\u0921\u0940 \u092c\u0922\u093e\u0909\u0928\u0915\u094b \u0932\u093e\u0917\u093f \u091c\u093e\u092d\u093e\u0938\u094d\u0915\u0943\u092a\u094d\u091f \u091a\u0932\u093e\u0908\u0926\u093f\u0928\u0941\u0939\u094b\u0938 ", "Preparing search...": "", "Previous topic": "\u0905\u0918\u093f\u0932\u094d\u0932\u094b \u0935\u093f\u0937\u092f ", "Quick search": "\u091b\u093f\u091f\u094d\u091f\u094b \u0916\u094b\u091c\u094d\u0928\u0941\u0939\u094b\u0938\u094d", "Search": "\u0916\u094b\u091c\u094d\u0928\u0941\u0939\u094b\u0938\u094d ", "Search Page": "\u092a\u093e\u0928\u093e\u092e\u093e \u0916\u094b\u091c\u094d\u0928\u0941\u0939\u094b\u0938\u094d", "Search Results": "\u0916\u094b\u091c\u0947\u0915\u094b \u0928\u0924\u093f\u091c\u093e", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "\u0938\u094d\u0930\u094b\u0924 \u0926\u0947\u0916\u093e\u0909\u0928\u0941\u0939\u094b\u0938\u094d ", "Table of Contents": "", "This Page": "\u092f\u094b \u092a\u093e\u0928\u093e", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "\u0938\u092c\u0948 \u092b\u0928\u094d\u0915\u094d\u0938\u0928\u0938\u094d, \u0915\u0915\u094d\u0937\u093e\u0939\u0930\u0942 \u0930 \u091f\u0930\u094d\u092e\u0938\u094d", "can be huge": "\u0927\u0947\u0930\u0948 \u0920\u0941\u0932\u094b \u0939\u0941\u0928 \u0938\u0915\u094d\u091b", "last updated": "", "lists all sections and subsections": "\u0938\u092c\u0948 \u0938\u0947\u0915\u094d\u0938\u0928 \u0930 \u0938\u0935\u0938\u0947\u0915\u094d\u0938\u0928 \u0926\u0947\u0916\u093e\u0909\u0928\u0941\u0939\u094b\u0938\u094d", "next chapter": "\u092a\u091b\u093f\u0932\u094d\u0932\u094b \u0916\u0928\u094d\u0921", "previous chapter": "\u0905\u0918\u093f\u0932\u094d\u0932\u094b \u0916\u0928\u094d\u0921", "quick access to all modules": "\u0938\u092c\u0948 \u092e\u094b\u0926\u0941\u0932\u0947\u0938\u092e\u093e \u091b\u093f\u091f\u0948 \u091c\u093e\u0928\u0941\u0939\u094b\u0938\u094d", "search": "\u0916\u094b\u091c\u094d\u0928\u0941\u0939\u094b\u0938\u094d", "search this documentation": "\u092f\u094b \u0921\u0915\u0941\u092e\u0947\u0928\u094d\u091f \u0916\u094b\u091c\u094d\u0928\u0941\u0939\u094b\u0938\u094d", "the documentation for": "" }, "plural_expr": "(n != 1)" });��������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ne/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000021431�00000000000�021141� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������T���������������� ���������� ����������������������������������� ��� �����/ �� ���A �� ���M �����W �����n ����� ����� �� ��� ����� ��0��� ����� ����� �� ���4 �� ���> �����H ��>���Q ����� �� ��� ����� ����� �� ��� ����� ����� ����� �� ��� ����� �� ��� �����$ �����@ �����F �� ���U �����_ �� ���v ����� ����� ����� ����� �� ��� ����� ����� ����� ����� ��!��� �����& �� ���6 �����C �� ���S �� ���_ �� ���l �����w �� ��� ����� �� ��� ����� ����� �� ��� ����� ����� ��B��� �����L ��$���[ ����� �� ��� ����� ����� �� ��� ����� ����� �� ��� ����� ����� ����� �� ������ ��� ���������������!�� ���&�����0�����8�����?�����G�����P�� ���n�����x�� ���������� ��������������� ��������������� �������� �� ����� ���$�����2�����8��"���@�����c�����i�����p�����w�����~������� ������������������������������������������������ ���������������2�� ���9�� ���E�� ���O�����]�����b����k�� ���0�����=�� ���A�����K�����Q�����c������������ ����� ������������� �������&���5�����\�����s�����������������0�������� ��A���(�� ���j��!���t�� �����l����������0���/�����`��0���w�������>�����%���������&�����?�� ���V�� ���c�����n�� �����>����������?�����,���/��5���\�������M������������� ����������2��K���H��2�����[�����D���#��"���h������� ���������������&�����"��������5��,���K�����x��+����� �����E�����P��������f��#�����$���%�����J��1���^������������ ���������������1�����"��� ��%���0��%���V��2���|�����������������������������������������������V���!�� ���x�������0���������������A��������A�����F�����b�����w������������,����� ������������� ��[���$ �� ��� ����� �� ��� �� ��� ����� ����� ��"��� ����� ����� ��%���!�����;!��"���Q!��4���t!��K���!��+���!�����!"�����4"��>���S"��!���"��,���"�� ���"�����"�����#�����#��� (deprecated)� (in �%b %d, %Y�%s %s�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Caution�Changed in version %s�Code author: �Collapse sidebar�Complete Table of Contents�Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Expand sidebar�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Overview: module code�Parameters�Permalink to this definition�Permalink to this headline�Please activate JavaScript to enable the search functionality.�Previous topic�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Release�Return type�Returns�Search�Search Page�Search Results�Section author: �See also�Show Source�This Page�Throws�Tip�Todo�Variables�Warning�[docs]�[image]�[source]�all functions, classes, terms�attribute�built-in function�can be huge�class�class method�continued from previous page�data�directive�environment variable�environment variable; %s�exception�function�glossary term�grammar token�index�keyword�lists all sections and subsections�macro�member�method�module�modules�next�next chapter�object�operator�original entry�previous�previous chapter�program option�quick access to all modules�reference label�role�search�search this documentation�see %s�see also %s�statement�static method�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: ne Language-Team: Nepali (http://www.transifex.com/sphinx-doc/sphinx-1/language/ne/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �(deprecated)�(in�%b %d, %Y�%s %s�%s (%s attribute)�%s (built-in कक्षा)�%s (built-in चल)�%s (कक्षा in %s)�%s (निर्देशिक)�%s (global variable or constant)�%s (in मडुल %s)�%s (मडुल)�%s (भूमिका)�%s() (%s कक्षा विधी)�%s() (%s विधी)�%s() (%s static विधी)�%s() (built-in function)�%s() (कक्षा)�%s() (in मडुल %s)�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�यी डकुमेन्टहरुको बारेमा�Arguments�ध्यानाकर्षण�लेखक�भर्सन %(version)s मा भएका फरक हरु आफै जेनेरेट भए �बिइल्टिन्स�C API का परिवर्तनहरु �होसियार �भर्सन %s मा बदलिएको�Codeको लेखक �साइडबर सानो बनाउनुहोस्�पुरा विषयसूची�विषयसूची�कपिराइट �खतरा�Deprecated�Deprecated since version %s�गलत�साइडबर ठुलो बनाउनुहोस्�फूट्नोट्स�पुरा अनुसुची एकै पानामा�सामान्य अनुसुची�ग्लोबल मडुल अनुसुची�जानुहोस्�खोजेको नतिजाहरु लुकाउनुहोस्�सङ्केत�जरुरी�अनुसुची�Index – %(key)s�अक्षर अनुसार अनुसुचीका पाना�इन्डीसीस्स र तलिका�यो भन्दा अगाडी %(last_updated)s मा अपडेट भएको�लाईब्रेरीका परिवर्तनहरु�मडुल अनुसुची�मडुलको लेखक�Module code�मडुलको तह�नेभिगेसन �भर्सन %s मा नयाँ�पछिल्लो विषय�टिप्पणी�अरु परिवर्तनहरु �पुनरावलोकन �पुनरावलोकन: module code�Parameters�यो अर्थको लागि पर्मालिन्क�यो शिर्षकको लागि पर्मालिन्क । �खोज्ने कार्य आगाडी बढाउनको लागि जाभास्कृप्ट चलाईदिनुहोस �अघिल्लो विषय �Python Enhancement Proposals; PEP %s�Python Module Index�छिट्टो खोज्नुहोस्�Raises�रीलीज�Return type�Returns�खोज्नुहोस् �पानामा खोज्नुहोस्�खोजेको नतिजा�सेक्सनको लेखक�पनि हेर्नुहोस�स्रोत देखाउनुहोस् �यो पाना�Throws�Tip�Todo�चलहरू�साबधान�[docs]�[चित्र]�[स्रोत]�सबै फन्क्सनस्, कक्षाहरू र टर्मस्�attribute�built-in फन्क्सन�धेरै ठुलो हुन सक्छ�कक्षा�कक्षा विधी�अघिल्लो पानासँग जोडीएको�data�निर्देशिक�environment variable�environment variable; %s�अपबाद�फन्क्सन�शब्द-अर्थमा भएको�grammar token�अनुसुची�मुख्य शब्द�सबै सेक्सन र सवसेक्सन देखाउनुहोस्�बृहत�सदस्य�विधी�मडुल�modules�पछिल्लो�पछिल्लो खन्ड�object�सन्चालक�मौलिक इन्ट्री�अघिल्लो�अघिल्लो खन्ड�कार्यक्रमका बिकल्प�सबै मोदुलेसमा छिटै जानुहोस्�सन्दर्व सामग्री�भूमिका�खोज्नुहोस्�यो डकुमेन्ट खोज्नुहोस्�%s हेर्नुहोस्�%s पनि हेर्नुहोस् �भनाई�static विधी�किसिम�चल����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ne/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000251712�00000000000�021153� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # FIRST AUTHOR <EMAIL@ADDRESS>, 2011 # Komiya Takeshi <i.tkomiya@gmail.com>, 2016 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Nepali (http://www.transifex.com/sphinx-doc/sphinx-1/language/ne/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: ne\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "बिइल्टिन्स" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "मडुलको तह" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "(in" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "सामान्य अनुसुची" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "अनुसुची" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "पछिल्लो" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "अघिल्लो" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "अनुसुची" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "रीलीज" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "सेक्सनको लेखक" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "मडुलको लेखक" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Codeको लेखक " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "लेखक" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parameters" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Returns" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Return type" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "सदस्य" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "चल" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "फन्क्सन" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "बृहत" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "किसिम" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "भर्सन %s मा नयाँ" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "भर्सन %s मा बदलिएको" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Deprecated since version %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Throws" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "कक्षा" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (built-in function)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s विधी)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (कक्षा)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (global variable or constant)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s attribute)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Arguments" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (मडुल)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "विधी" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "data" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "attribute" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "मडुल" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "मुख्य शब्द" #: sphinx/domains/python.py:60 msgid "operator" msgstr "सन्चालक" #: sphinx/domains/python.py:61 msgid "object" msgstr "object" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "अपबाद" #: sphinx/domains/python.py:63 msgid "statement" msgstr "भनाई" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "built-in फन्क्सन" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "चलहरू" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Raises" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (in मडुल %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (in मडुल %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (built-in चल)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (built-in कक्षा)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (कक्षा in %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s कक्षा विधी)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s static विधी)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Python Module Index" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "modules" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Deprecated" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "कक्षा विधी" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "static विधी" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "(deprecated)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (निर्देशिक)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (भूमिका)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "निर्देशिक" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "भूमिका" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "environment variable; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "शब्द-अर्थमा भएको" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "grammar token" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "सन्दर्व सामग्री" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "environment variable" #: sphinx/domains/std.py:568 msgid "program option" msgstr "कार्यक्रमका बिकल्प" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "मडुल अनुसुची" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "पानामा खोज्नुहोस्" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "%s हेर्नुहोस्" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "%s पनि हेर्नुहोस् " #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[स्रोत]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Todo" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "मौलिक इन्ट्री" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[docs]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Module code" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Source code for %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "पुनरावलोकन: module code" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>All modules for which code is available</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "ध्यानाकर्षण" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "होसियार " #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "खतरा" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "गलत" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "सङ्केत" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "जरुरी" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "टिप्पणी" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "पनि हेर्नुहोस" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Tip" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "साबधान" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "अघिल्लो पानासँग जोडीएको" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "खोज्नुहोस् " #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "जानुहोस्" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "स्रोत देखाउनुहोस् " #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "पुनरावलोकन " #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "इन्डीसीस्स र तलिका" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "पुरा विषयसूची" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "सबै सेक्सन र सवसेक्सन देखाउनुहोस्" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "यो डकुमेन्ट खोज्नुहोस्" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "ग्लोबल मडुल अनुसुची" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "सबै मोदुलेसमा छिटै जानुहोस्" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "सबै फन्क्सनस्, कक्षाहरू र टर्मस्" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Index – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "पुरा अनुसुची एकै पानामा" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "अक्षर अनुसार अनुसुचीका पाना" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "धेरै ठुलो हुन सक्छ" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "नेभिगेसन " #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "यी डकुमेन्टहरुको बारेमा" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "कपिराइट " #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "यो भन्दा अगाडी %(last_updated)s मा अपडेट भएको" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "अघिल्लो विषय " #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "अघिल्लो खन्ड" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "पछिल्लो विषय" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "पछिल्लो खन्ड" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "खोज्ने कार्य आगाडी बढाउनको लागि जाभास्कृप्ट चलाईदिनुहोस " #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "खोज्नुहोस्" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "खोजेको नतिजा" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "छिट्टो खोज्नुहोस्" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "यो पाना" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "भर्सन %(version)s मा भएका फरक हरु आफै जेनेरेट भए " #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "लाईब्रेरीका परिवर्तनहरु" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API का परिवर्तनहरु " #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "अरु परिवर्तनहरु " #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "यो शिर्षकको लागि पर्मालिन्क । " #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "यो अर्थको लागि पर्मालिन्क" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "खोजेको नतिजाहरु लुकाउनुहोस्" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "साइडबर ठुलो बनाउनुहोस्" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "साइडबर सानो बनाउनुहोस्" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "विषयसूची" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "फूट्नोट्स" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[चित्र]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3292956 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/nl/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015514� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4956584 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/nl/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017301� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/nl/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000007404�00000000000�021155� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "nl", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.", "© Copyright %(copyright)s.": "© Copyright %(copyright)s.", ", in ": ", in", "About these documents": "Over deze documenten", "Automatically generated list of changes in version %(version)s": "Automatisch gegenereerde lijst van veranderingen in versie %(version)s", "C API changes": "Veranderingen in de C-API", "Changes in Version %(version)s — %(docstitle)s": "Wijzigingen in Versie %(version)s — %(docstitle)s", "Collapse sidebar": "Zijpaneel inklappen", "Complete Table of Contents": "Volledige inhoudsopgave", "Contents": "Inhoudsopgave", "Copyright": "Copyright", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Zijpaneel uitklappen", "Full index on one page": "Volledige index op \u00e9\u00e9n pagina", "General Index": "Algemene index", "Global Module Index": "Globale Module-index", "Go": "Zoek", "Hide Search Matches": "Zoekresultaten verbergen", "Index": "Index", "Index – %(key)s": "Index – %(key)s", "Index pages by letter": "Index pagineerd per letter", "Indices and tables:": "Indices en tabellen:", "Last updated on %(last_updated)s.": "Laatste aanpassing op %(last_updated)s.", "Library changes": "Veranderingen in de bibliotheek", "Navigation": "Navigatie", "Next topic": "Volgend onderwerp", "Other changes": "Andere veranderingen", "Overview": "Overzicht", "Permalink to this definition": "Permalink naar deze definitie", "Permalink to this headline": "Permalink naar deze titel", "Please activate JavaScript to enable the search\n functionality.": "Activeer JavaSscript om de zoekfunctionaliteit in te schakelen.", "Preparing search...": "Zoeken aan het voorbereiden...", "Previous topic": "Vorig onderwerp", "Quick search": "Snel zoeken", "Search": "Zoeken", "Search Page": "Zoekpagina", "Search Results": "Zoekresultaten", "Search finished, found %s page(s) matching the search query.": "Zoekopdracht voltooid, %s pagaina(s) gevonden die overeenkomen met de zoekterm.", "Search within %(docstitle)s": "Zoeken in %(docstitle)s", "Searching": "Bezig met zoeken", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Broncode weergeven", "Table of Contents": "", "This Page": "Deze pagina", "Welcome! This is": "Welkom! Dit is", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Uw zoekopdracht leverde geen resultaten op. Zorg ervoor dat alle woorden juist zijn gespeld en dat u voldoende categorie\u00ebn hebt geselecteerd.", "all functions, classes, terms": "alle functies, klasses en begrippen", "can be huge": "kan heel groot zijn", "last updated": "laatst bijgewerkt", "lists all sections and subsections": "geeft alle secties en subsecties weer", "next chapter": "volgend hoofdstuk", "previous chapter": "vorig hoofdstuk", "quick access to all modules": "sneltoegang naar alle modules", "search": "zoeken", "search this documentation": "zoeken in deze documentatie", "the documentation for": "de documentatie voor" }, "plural_expr": "(n != 1)" });������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/nl/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000046274�00000000000�021164� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������L��������������|�� ���}�������"����� ��������������������������������������&�� ���5�����V�� ���h�� ���t�����~���������������������� ����������6��������F�����f��$����������3���a�� ��������������������0��������������� ���%�� ���/�����9�����H��>���Q�� �����(�����(����������?��� �����K�� ���T��!���b��8�����%���������������4����� ���6�����D�����U�����p������� ��������������� ����������`��������P��K���V������������8����������:��� �� ���F�����P�� ���g�����u�������C���������������.����� �����.���"�����Q�����W�����m�����������������!����������2����� ���"�� ���-�����:�� ���J�� ���V��-���c�� ���������� �����(���������������,���������-�� ���B�����P�����Y�� ���o�����z��������������������������������B���.�����q������� ���������������$���������� ���������� ���������� ���!�����-�����5�����H�����O�� ���d�����p��<���������� ����� ��������������� �����>�����#���R�����v�����~�������p�����=��� �� ���J��W���T��v��������# �����* �����. �����3 �� ���J �����T �����\ �����m ����� �� ��� ����� !�� ���!�����!�����'!�����0!�� ���N!�����X!�� ���n!�����x!�� ���!��A���!��Z���!�����3"�����P"�� ���V"�����c"��4���k"�����"�����"�����"�� ���"�����"�����"�����"�����#�����+#�����H#��Y���M#��4���#�����#�� ���#�����#�����$�� ���$��M���$$��u���r$�� ���$��I���$��A���=%�����%�����%�����%�� ���%�� ���%��=���%�����&��/���&�����J&�� ���R&��"���_&�����&�����&�����&�����&�����&�����&��"���&�����'����� '��D���'�����X'�� ���]'��-���j'��(���'�����'�����'�����'�����'�����'�����'�����(��%���(�����>(�����M(�����i(�����y(�����(�����(�����(�����(�� ���(��:���(������)�����)��*���0)�� ���[)�� ���e)�� ���s)��%���})�����)�����;*�����*��\���*�����F+��'���b+��%���+�����+��-���+�����+����+�� ���-�����-��"���-�� ���-�����-�����-����� .�����.�����6.�����T.�����f.��#���u.�����.�� ���.�����.�����.�����.�����.�����.�����/�� ���4/�����B/��6���V/�����/�����/��$���/�����/��6���0�� ���0�����1�����1�����1��9���(1�����b1�����|1�� ���1�����1�� ���1�����1��F���1�����1��&���2��+���52��#���a2��A���2�����2�����2�����2��E���3��9���M3�����3�����3��7���3�����3�����3����� 4��*���#4�� ���N4�� ���\4�����f4�����4�� ���4�����4��y���4�����+5��K���05�����|5�����5��@���5�����5��6���5�� ���.6�����86�����X6�����g6�����|6��M���6�����6�����6��3���6�� ���!7��;���,7�����h7�����n7�����7�����7�����7�����7��'���7����� 8��6���-8�����d8�� ���t8�����8�����8�� ���8��<���8�� ���8�����8�����9��E���"9�� ���h9�����9��9���9�����9�����9�� ���9�����:�� ��� :�����+:�����H:�����f:�����:�����:�����:�����:��?���:�����2;�����Q;�����a;�����v;�����;��$���;�����;�� ���;�� ���;�� ���;�����<�� ��� <�����<�����<�����3<�����:<�� ���P<�����[<��O���j<�����<�����<�� ���<�����<�����=�����=��*���!=��-���L=�����z=�����=�����=�����=��=���7>�� ���u>��\���>��t���>�����S?�����Y?�����]?�����e?�� ���?�� ���?�����?�����?�����9@�� ���H@�����T@�����\@�� ���m@�� ���z@��#���@�� ���@�����@�� ���@�����@�����@��c���A�����eA�� ���A�����B�� ���B�����#B��/���+B�����[B�����vB�����B�� ���B�����B�� ���B�����B��!���B�� ���B�����C��p���C��+���C�����C�� ���C�����C�����C�����C��Z���C��z���VD�� ���D��\���D��C���:E��'���~E�����E�����E�����E�����E��;���E�����"F��=���(F�� ���fF�����pF��%���F�����F�����F�����F�����F�����F�����G��%��� G�����2G�����9G��J���AG�����G�����G��9���G��0���G�����H�����H�����"H�����1H�����8H�����IH�����PH��,���`H�����H�����H�����H�����H�����H�����H�����H�����I����� I��D���I�����YI��"���nI��,���I�� ���I�����I�����I��"���I�����J�����J�����|K��_���K��$���K��(���L��&���?L�����fL��F���kL�� ���L��� (deprecated)� (in �%(filename)s — %(docstitle)s�%b %d, %Y�%s %s�%s %s documentation�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not import extension %s�Danger�Deprecated�Deprecated since version %s�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Error�Error: the master file %s has already been found in the selected root path.�Event %r already present�Expand sidebar�External Graphviz file %r not found or reading it failed�Fig. %s�Finished: An initial directory structure has been created.�Footnotes�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Hide Search Matches�Hint�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Invalid caption: %s�Keyword Arguments�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Note�Object named %r not found in include file %r�Original exception: �Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Please activate JavaScript to enable the search functionality.�Preparing search...�Previous topic�Project name�Project release�Project version�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�References�Release�Return type�Returns�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section %s�Section author: �See also�Show Source�Source directory and destination directory cannot be identical�Source parser for %s not registered�Symbols�Table %s�Template Parameters�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�There is a programmable error in your configuration file: %s�This Page�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Unknown event name: %s�Variables�Warning�Welcome! This is�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�all functions, classes, terms�attribute�build %s, %s warning.�build %s.�built-in function�can be huge�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�caption not inside a figure.�class�class method�concept�config directory doesn't contain a conf.py file (%s)�continued from previous page�continues on next page�data�directive�document�document language�doing serial %s�domain %s already registered�domain %s not yet registered�done�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�duplicate label of equation %s, other instance in %s�enum�enumerator�environment variable�environment variable; %s�exception�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�failed: %s�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�finished with problems�function�glossary term�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�index�invalid number %r for config value %r, ignoring�keyword�last updated�lists all sections and subsections�loading translations [%s]... �macro�making output directory�master document name�member�method�missing '+' or '-' in '%s' option.�module�modules�more than one target found for 'any' cross-reference %r: could be %s�next�next chapter�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�object�operator�original entry�page�path to output directory�previous�previous chapter�primary_domain %r not found, ignored.�program option�quick access to all modules�reference label�release of project�role�search�search this documentation�see %s�see also %s�setting %s.%s occurs in none of the searched theme configs�source directory has changed�source file suffix�source_parser for %r is already registered�statement�static method�succeeded�template directory for template files�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�type�unknown config value %r in override, ignoring�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: nl Language-Team: Dutch (http://www.transifex.com/sphinx-doc/sphinx-1/language/nl/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (verouderd)� (in �%(filename)s — %(docstitle)s�%b %d, %Y�%s %s�%s %s documentatie�%s (%s attribuut)�%s (geïntegreerde klasse)�%s (geïntegreerde variabele)�%s (klasse in %s)�%s (directive)�%s (globale variabele of constante)�%s (in module %s)�%s (module)�%s (rol)�%s is geen map.�%s() (%s klassemethode)�%s() (%s methode)�%s() (statische methode van %s)�%s() (ingebouwde functie)�%s() (klasse)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is geen geldige optie.�'%s' is geen geldige pyversion optie�'setup' gedefinieerd in conf.py is niet aanroepbaar (geen Python-callable). Pas a.u.b. de definitie aan zodat het een oproepbare functie wordt. Dit is nodig voor conf.py om zich als een Sphinx extensie te gedragen.�(Het <<originele item>> bevindt zich in %s, regel %d.)�(in %s v%s)�(in %s)�, in�<<origineel item>>�<h1>Alle modules waarvoor de broncode beschikbaar is</h1>�<h1>Broncode voor %s</h1>�Over deze documenten�Argumenten�Let op�Auteur(s)�Auteur: �Automatisch gegenereerde lijst van veranderingen in versie %(version)s�Basisklassen: %s�Bouwer %r bestaat reeds (in module %s)�Bouwerklasse %s heeft geen "name"-attribuut�Bouwernaam %s is niet geregistreerd�Bouwernaam %s is niet geregistreerd of beschikbaar via entrypoint�Builtins�Veranderingen in de C-API�Kan bronmap niet vinden (%s)�"lineno-match" kan niet gebruikt worden met een disjuncte set "lines"�Gebruik van zowel "%s" als "%s" opties is niet toegestaan�Pas op�Veranderd in versie %s�Wijzigingen in Versie %(version)s — %(docstitle)s�Auteur van deze broncode:�Zijpaneel inklappen�Volledige inhoudsopgave�Configuratiewaarde %r was reeds aangevoerd�Inhoudsopgave�Copyright�Kon extensie %s niet importeren�Gevaar�Verouderd�Verouderd sinds versie %s�Encodering %r gebruikt voor het lezen van include-bestand %r lijkt verkeerd, probeer een :encoding: optie te specificeren�Fout�Fout: hoofddocumentbestandsnaam %s is reeds aanwezig op het aangewezen pad.�Gebeurtenis %r bestaat reeds�Zijpaneel uitklappen�Extern Graphviz bestand %r niet gevonden of het lezen is mislukt�Fig. %s�Afgerond: een beginstructuur van mappen is aangemaakt.�Voetnoten�Volledige index op één pagina�Algemene index�Globale Module-index�Zoek�Graphviz directive mag niet zowel inhoud als een bestandsnaam argument hebben�Zoekresultaten verbergen�Hint�"graphviz" directive zonder inhoud wordt genegeerd.�Belangrijk�Include bestand %r is niet gevonden of het lezen is mislukt�Index�Index – %(key)s�Index pagineerd per letter�Indices en tabellen:�Ongeldig onderschrift: %s�Sleutelwoordargumenten�Laatste aanpassing op %(last_updated)s.�Veranderingen in de bibliotheek�Regels %r: geen regels gebruikt uit include-bestand %r�Codefragment %s�Module-index�Auteur van deze module: �Modulebroncode�Moduleniveau�Bestandsnaam van het hoofddocument (zonder bestandsextensie)�Navigatie�Nieuw in versie %s�Volgend onderwerp�Geen bouwer geselecteerd, dus de standaardbouwer wordt gebruikt: html�Ongeldige configuratiewaarde: %s�Notitie�Object met naam %r is niet gevonden in include bestand %r�Oorspronkelijke exceptie: �Andere veranderingen�Overzicht�Overzicht: module broncode�Parameters�Permalink naar deze broncode�Permalink naar deze definitie�Permalink naar deze formule�Permalink naar deze titel�Permallink naar deze afbeelding�Permalink naar deze tabel�Permalink naar deze toctree�Activeer JavaSscript om de zoekfunctionaliteit in te schakelen.�Zoeken aan het voorbereiden...�Vorig onderwerp�Naam van het project�Release van het project�Versie van het project�Python Enhancement Proposals; PEP %s�Python-moduleïndex�Snel zoeken�Veroorzaakt�Verwijzingen�Release�Return type�Returns�Sphinx v%s start op�Zoeken�Zoek in %(docstitle)s�Zoekpagina�Zoekresultaten�Zoekopdracht voltooid, %s pagaina(s) gevonden die overeenkomen met de zoekterm.�Zoeken in %(docstitle)s�Bezig met zoeken�Sectie %s�Auteur van deze sectie: �Zie ook�Broncode weergeven�Bron- en doelmap kunnen niet identiek zijn�Broncode-parser voor %s is niet geregistreerd�Symbolen�Tabel %s�Sjabloonparameters�Dit project gebruikt extensie %s, maar die extensie heeft Sphinx-versie v%s of hoger nodig; het project kan daarom niet worden gebouwd met deze versie.�Een fout heeft zich voorgedaan in uw configuratiebestand: %s�Deze pagina�Dit project vereist tenminste Sphinx v%s, en kan daarom niet worden gebouwd met deze versie.�Dit project vereist extensie %s met versie %s of hoger, en kan daarom niet met de geladen versie (%s) worden gebouwd�Werpt�Tip�Te doen�Onbekende gebeurtenisnaam: %s�Variabelen�Waarschuwing�Welkom! Dit is�Uw zoekopdracht leverde geen resultaten op. Zorg ervoor dat alle woorden juist zijn gespeld en dat u voldoende categorieën hebt geselecteerd.�[documentatie]�[graaf: %s]�[graaf]�[afbeelding: %s]�[afbeelding]�[broncode]�alle functies, klasses en begrippen�attribuut�bouwen %s, %s waarschuwing.�bouwen %s.�ingebouwde functie�kan heel groot zijn�kan instelling %r niet overschrijven met zo'n waarde van een niet-ondersteund type; wordt genegeerd�kan dictionary-instelling %r niet overschrijven in configuratie, wordt genegeerd (gebruik %r om individuele elementen te overschrijven)�onderschrift niet binnen figuur.�klasse�klassemethode�concept�configuratiemap bevat geen conf.py bestand (%s)�Vervolgd van vorige pagina�Vervolgt op volgende pagina�data�directive�document�documenttaal�seriële verwerking van %s�domein %s was reeds geregistreerd�domein %s nog niet geregistreerd�klaar�dot commando %r kan niet worden uitgevoerd (vereist voor graphviz output), controleer de instelling graphviz_dot�duplicaatlabel van formule %s, andere in %s�enum�enumerator�omgevingsvariabele�omgevingsvariabele; %s�exceptie�extensie %r heeft geen setup() functie; weet u zeker dat het een Sphinx-extensiemodule is?�de setup() functie van extensie %r retourneerde een niet-ondersteund object; dit moet None of een metadata dictionary zijn�mislukt: %s�bestand %r zoals gegeven op de opdrachtregel is niet aanwezig in de bronmap, wordt genegeerd�bestand %r in thema pad is geen geldige zipfile of bevat geen thema�bestandsextensie (standaardwaarde: rst)�afgerond met problemen�functie�woordenlijstterm�grammaticatoken�graphviz_output_format moet 'png' of 'svg' zijn, maar is %r�index�ongeldig getal %r voor configuratiewaarde %r, wordt genegeerd�trefwoord�laatst bijgewerkt�geeft alle secties en subsecties weer�laden van vertalingen [%s]... �macro�aanmaken doelmap�bestandsnaam van hoofddocument�member�methode�ontbrekende '+' of '-' in optie '%s'.�module�modules�meer dan één doel gevonden voor 'any' kruisverwijzing %r: is mogelijk %s�volgende�volgend hoofdstuk�thema met naam %r niet gevonden (ontbrekende theme.conf?)�thema met naam %r niet gevonden, geërfd door %r�object�operator�originele item�pagina�pad naar doelmap�vorige�vorig hoofdstuk�primary_domain %r onbekend, wordt genegeerd.�programmaoptie�sneltoegang naar alle modules�verwijzingslabel�release van project�rol�zoeken�zoeken in deze documentatie�zie %s�zie %s�instelling %s.%s komt niet voor in de doorzochte thema configuraties�bronmap is gewijzigd�bestandsextensie van bronbestanden�source_parser voor %r is reeds geregistreerd�statement�statische methode�gelukt�sjabloonmap voor sjabloonbestanden�de %s extensie geeft niet aan of deze veilig is voor parallel lezen, er wordt aangenomen dat dit niet zo is - vraag de auteur van de extensie om dit te controleren en expliciet te maken�de %s extensie geeft niet aan of deze veilig is voor parallel schrijven, er wordt aangenomen dat dit niet zo is - vraag de auteur van de extensie om dit te controleren en expliciet te maken�de documentatie voor�extensie %r is reeds in Sphinx ingevoegd sinds Sphinx-versie %s; deze extensie wordt genegeerd.�onderschrift ontbreekt voor link: %s�thema %r heeft geen "inherit" instelling�thema %r heeft geen "theme" instelling�type�onbekende configuratiewaarde %r tijdens overschrijven, wordt genegeerd�variabele�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/nl/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000260706�00000000000�021165� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Bram Geron, 2017 # brechtm, 2016 # brechtm, 2018 # FIRST AUTHOR <EMAIL@ADDRESS>, 2008 # Gert van Dijk <gertvdijk@gmail.com>, 2019 # Jesse Tan, 2017 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Dutch (http://www.transifex.com/sphinx-doc/sphinx-1/language/nl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: nl\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Kan bronmap niet vinden (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Bron- en doelmap kunnen niet identiek zijn" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx v%s start op" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Dit project vereist tenminste Sphinx v%s, en kan daarom niet worden gebouwd met deze versie." #: sphinx/application.py:243 msgid "making output directory" msgstr "aanmaken doelmap" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' gedefinieerd in conf.py is niet aanroepbaar (geen Python-callable). Pas a.u.b. de definitie aan zodat het een oproepbare functie wordt. Dit is nodig voor conf.py om zich als een Sphinx extensie te gedragen." #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "laden van vertalingen [%s]... " #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "klaar" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "mislukt: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "Geen bouwer geselecteerd, dus de standaardbouwer wordt gebruikt: html" #: sphinx/application.py:348 msgid "succeeded" msgstr "gelukt" #: sphinx/application.py:349 msgid "finished with problems" msgstr "afgerond met problemen" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "bouwen %s, %s waarschuwing." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "bouwen %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "de %s extensie geeft niet aan of deze veilig is voor parallel lezen, er wordt aangenomen dat dit niet zo is - vraag de auteur van de extensie om dit te controleren en expliciet te maken" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "de %s extensie geeft niet aan of deze veilig is voor parallel schrijven, er wordt aangenomen dat dit niet zo is - vraag de auteur van de extensie om dit te controleren en expliciet te maken" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "seriële verwerking van %s" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "configuratiemap bevat geen conf.py bestand (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "kan dictionary-instelling %r niet overschrijven in configuratie, wordt genegeerd (gebruik %r om individuele elementen te overschrijven)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "ongeldig getal %r voor configuratiewaarde %r, wordt genegeerd" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "kan instelling %r niet overschrijven met zo'n waarde van een niet-ondersteund type; wordt genegeerd" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "onbekende configuratiewaarde %r tijdens overschrijven, wordt genegeerd" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "Ongeldige configuratiewaarde: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "Configuratiewaarde %r was reeds aangevoerd" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "Een fout heeft zich voorgedaan in uw configuratiebestand:\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Sectie %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Fig. %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tabel %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Codefragment %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r onbekend, wordt genegeerd." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "Gebeurtenis %r bestaat reeds" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Onbekende gebeurtenisnaam: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "Dit project vereist extensie %s met versie %s of hoger, en kan daarom niet met de geladen versie (%s) worden gebouwd" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "Bouwerklasse %s heeft geen \"name\"-attribuut" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Bouwer %r bestaat reeds (in module %s)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Bouwernaam %s is niet geregistreerd of beschikbaar via entrypoint" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "Bouwernaam %s is niet geregistreerd" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "domein %s was reeds geregistreerd" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "domein %s nog niet geregistreerd" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "source_parser voor %r is reeds geregistreerd" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "Broncode-parser voor %s is niet geregistreerd" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "extensie %r is reeds in Sphinx ingevoegd sinds Sphinx-versie %s; deze extensie wordt genegeerd." #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "Oorspronkelijke exceptie:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "Kon extensie %s niet importeren" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "extensie %r heeft geen setup() functie; weet u zeker dat het een Sphinx-extensiemodule is?" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "Dit project gebruikt extensie %s, maar die extensie heeft Sphinx-versie v%s of hoger nodig; het project kan daarom niet worden gebouwd met deze versie." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "de setup() functie van extensie %r retourneerde een niet-ondersteund object; dit moet None of een metadata dictionary zijn" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "thema %r heeft geen \"theme\" instelling" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "thema %r heeft geen \"inherit\" instelling" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "thema met naam %r niet gevonden, geërfd door %r" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "instelling %s.%s komt niet voor in de doorzochte thema configuraties" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "bestand %r in thema pad is geen geldige zipfile of bevat geen thema" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "thema met naam %r niet gevonden (ontbrekende theme.conf?)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "bestand %r zoals gegeven op de opdrachtregel is niet aanwezig in de bronmap, wordt genegeerd" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Builtins" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Moduleniveau" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (in " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Algemene index" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "index" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "volgende" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "vorige" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s documentatie" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Index" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Release" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "pad naar doelmap" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "Naam van het project" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "Auteur(s)" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "Versie van het project" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "Release van het project" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "Bestandsnaam van het hoofddocument (zonder bestandsextensie)" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "Fout: hoofddocumentbestandsnaam %s is reeds aanwezig op het aangewezen pad." #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "Afgerond: een beginstructuur van mappen is aangemaakt." #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "release van project" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "documenttaal" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "bestandsextensie van bronbestanden" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "bestandsnaam van hoofddocument" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "sjabloonmap voor sjabloonbestanden" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "Ongeldig onderschrift: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "Gebruik van zowel \"%s\" als \"%s\" opties is niet toegestaan" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "Include bestand %r is niet gevonden of het lezen is mislukt" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "Encodering %r gebruikt voor het lezen van include-bestand %r lijkt verkeerd, probeer een :encoding: optie te specificeren" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "Object met naam %r is niet gevonden in include bestand %r" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "\"lineno-match\" kan niet gebruikt worden met een disjuncte set \"lines\"" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "Regels %r: geen regels gebruikt uit include-bestand %r" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Auteur van deze sectie: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Auteur van deze module: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Auteur van deze broncode:" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Auteur: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parameters" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Returns" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Return type" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "member" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "variabele" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "functie" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "macro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "enum" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "enumerator" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "type" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Nieuw in versie %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Veranderd in versie %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Verouderd sinds versie %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Sjabloonparameters" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Werpt" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "klasse" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "concept" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (ingebouwde functie)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s methode)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (klasse)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (globale variabele of constante)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s attribuut)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumenten" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (module)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "methode" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "data" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "attribuut" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "module" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "duplicaatlabel van formule %s, andere in %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "trefwoord" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operator" #: sphinx/domains/python.py:61 msgid "object" msgstr "object" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "exceptie" #: sphinx/domains/python.py:63 msgid "statement" msgstr "statement" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "ingebouwde functie" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Variabelen" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Veroorzaakt" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (in module %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (in module %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (geïntegreerde variabele)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (geïntegreerde klasse)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (klasse in %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s klassemethode)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (statische methode van %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Python-moduleïndex" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "modules" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Verouderd" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "klassemethode" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "statische methode" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (verouderd)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (directive)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (rol)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "directive" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "rol" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "omgevingsvariabele; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "woordenlijstterm" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "grammaticatoken" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "verwijzingslabel" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "omgevingsvariabele" #: sphinx/domains/std.py:568 msgid "program option" msgstr "programmaoptie" #: sphinx/domains/std.py:569 msgid "document" msgstr "document" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Module-index" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Zoekpagina" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "onderschrift ontbreekt voor link: %s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "bronmap is gewijzigd" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "zie %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "zie %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Symbolen" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "bestandsextensie (standaardwaarde: rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s is geen map." #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "ontbrekende '+' of '-' in optie '%s'." #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "'%s' is geen geldige optie." #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "'%s' is geen geldige pyversion optie" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "Graphviz directive mag niet zowel inhoud als een bestandsnaam argument hebben" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "Extern Graphviz bestand %r niet gevonden of het lezen is mislukt" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "\"graphviz\" directive zonder inhoud wordt genegeerd." #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "dot commando %r kan niet worden uitgevoerd (vereist voor graphviz output), controleer de instelling graphviz_dot" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "graphviz_output_format moet 'png' of 'svg' zijn, maar is %r" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[graaf: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[graaf]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Permalink naar deze formule" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(in %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(in %s)" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[broncode]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Te doen" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<origineel item>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(Het <<originele item>> bevindt zich in %s, regel %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "originele item" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[documentatie]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Modulebroncode" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Broncode voor %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Overzicht: module broncode" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Alle modules waarvoor de broncode beschikbaar is</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "Basisklassen: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "Sleutelwoordargumenten" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "Verwijzingen" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Let op" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Pas op" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Gevaar" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Fout" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Hint" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Belangrijk" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Notitie" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Zie ook" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Tip" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Waarschuwing" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "Vervolgd van vorige pagina" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "Vervolgt op volgende pagina" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "pagina" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Zoeken" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Zoek" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Broncode weergeven" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Overzicht" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Welkom! Dit is" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "de documentatie voor" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "laatst bijgewerkt" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Indices en tabellen:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Volledige inhoudsopgave" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "geeft alle secties en subsecties weer" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "zoeken in deze documentatie" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Globale Module-index" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "sneltoegang naar alle modules" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "alle functies, klasses en begrippen" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Index – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Volledige index op één pagina" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Index pagineerd per letter" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "kan heel groot zijn" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigatie" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Zoeken in %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Over deze documenten" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Copyright" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Copyright %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Laatste aanpassing op %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Zoek in %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Vorig onderwerp" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "vorig hoofdstuk" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Volgend onderwerp" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "volgend hoofdstuk" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Activeer JavaSscript om de zoekfunctionaliteit in te schakelen." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "zoeken" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Zoekresultaten" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Uw zoekopdracht leverde geen resultaten op. Zorg ervoor dat alle woorden juist zijn gespeld en dat u voldoende categorieën hebt geselecteerd." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Snel zoeken" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Deze pagina" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Wijzigingen in Versie %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automatisch gegenereerde lijst van veranderingen in versie %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Veranderingen in de bibliotheek" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Veranderingen in de C-API" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Andere veranderingen" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Permalink naar deze titel" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Permalink naar deze definitie" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Zoekresultaten verbergen" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Bezig met zoeken" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Zoeken aan het voorbereiden..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Zoekopdracht voltooid, %s pagaina(s) gevonden die overeenkomen met de zoekterm." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", in" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Zijpaneel uitklappen" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Zijpaneel inklappen" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Inhoudsopgave" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "meer dan één doel gevonden voor 'any' kruisverwijzing %r: is mogelijk %s" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Permalink naar deze tabel" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Permalink naar deze broncode" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Permallink naar deze afbeelding" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Permalink naar deze toctree" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Voetnoten" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[afbeelding: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[afbeelding]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "onderschrift niet binnen figuur." #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ����������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3294735 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pl/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015516� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.496503 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pl/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017303� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pl/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000010176�00000000000�021157� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "pl", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.", "© Copyright %(copyright)s.": "© Copyright %(copyright)s.", ", in ": ", w ", "About these documents": "O tych dokumentach", "Automatically generated list of changes in version %(version)s": "Automatycznie wygenerowana lista zmian w wersji %(version)s", "C API changes": "Zmiany w C API", "Changes in Version %(version)s — %(docstitle)s": "Zmiany w wersji %(version)s — %(docstitle)s", "Collapse sidebar": "Zwi\u0144 pasek boczny", "Complete Table of Contents": "Kompletny spis tre\u015bci", "Contents": "Tre\u015b\u0107", "Copyright": "Copyright", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Rozwi\u0144 pasek boczny", "Full index on one page": "Ca\u0142y indeks na jednej stronie", "General Index": "Indeks og\u00f3lny", "Global Module Index": "Globalny indeks modu\u0142\u00f3w", "Go": "Szukaj", "Hide Search Matches": "Ukryj wyniki wyszukiwania", "Index": "Indeks", "Index – %(key)s": "Indeks – %(key)s", "Index pages by letter": "Strony indeksu alfabetycznie", "Indices and tables:": "Indeksy i tablice:", "Last updated on %(last_updated)s.": "Ostatnia modyfikacja %(last_updated)s.", "Library changes": "Zmiany w bibliotekach", "Navigation": "Nawigacja", "Next topic": "Nast\u0119pny temat", "Other changes": "Inne zmiany", "Overview": "Przegl\u0105d", "Permalink to this definition": "Sta\u0142y odno\u015bnik do tej definicji", "Permalink to this headline": "Sta\u0142y odno\u015bnik do tego nag\u0142\u00f3wka", "Please activate JavaScript to enable the search\n functionality.": "Aby umo\u017cliwi\u0107 wyszukiwanie, prosz\u0119 w\u0142\u0105czy\u0107 JavaScript.", "Preparing search...": "Inicjalizacja wyszukiwania...", "Previous topic": "Poprzedni temat", "Quick search": "Szybkie wyszukiwanie", "Search": "Szukaj", "Search Page": "Wyszukiwanie", "Search Results": "Wyniki wyszukiwania", "Search finished, found %s page(s) matching the search query.": "Wyszukiwanie zako\u0144czone. Liczba znalezionych stron pasuj\u0105cych do zapytania: %s.", "Search within %(docstitle)s": "Szukaj po\u015br\u00f3d %(docstitle)s", "Searching": "Wyszukiwanie", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Poka\u017c \u017ar\u00f3d\u0142o", "Table of Contents": "Spis tre\u015bci", "This Page": "Ta strona", "Welcome! This is": "Witaj! To jest", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Twoje wyszukiwanie nie da\u0142o \u017cadnych wynik\u00f3w. Upewnij si\u0119, \u017ce wszystkie s\u0142owa s\u0105 wpisane prawid\u0142owo i \u017ce wybra\u0142e\u015b dostateczn\u0105 ilo\u015b\u0107 kategorii.", "all functions, classes, terms": "wszystkie funkcje, klasy, terminy", "can be huge": "mo\u017ce by\u0107 ogromny", "last updated": "ostatnio aktualizowana", "lists all sections and subsections": "wszystkie rozdzia\u0142y i podrozdzia\u0142y", "next chapter": "nast\u0119pny rozdzia\u0142", "previous chapter": "poprzedni rozdzia\u0142", "quick access to all modules": "szybki dost\u0119p do wszystkich modu\u0142\u00f3w", "search": "szukaj", "search this documentation": "przeszukaj t\u0119 dokumentacj\u0119", "the documentation for": "dokumentacja do" }, "plural_expr": "(n==1 ? 0 : (n%10>=2 && n%10<=4) && (n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3)" });��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pl/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000072351�00000000000�021161� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������w����� ���������������� ����������=�����?�����"����� ���B�����L��%���U�����{�������������������������������� ���������� ���%�� ���1�����;�����R�����i�����z������� ����������6�������������#��$���?�����d��3����� ���R�����^�����f��1���l��1����������0����������b���0�������6���������� ����� ��������� �������>���"�� ���a��(���k��(����������?���������� ���%��!���3��8���U��%���������������4����� ����� ���(�����6�����G�����b������� ������������������������� ������������� ��`���& ����� ����� ��D��� ����� ����� �����!����� !����� !�����/!��8���A!�����z!��!���!��:���!�� ���!�����!�� ����"�����"�����""��C���%"�����i"�����}"��.���"�� ���"��.���"�����"�����"�����#��D���#�����a#�����u#�����#�����#��!���#�����#��2���#�� ���$�� ���)$�����6$�� ���F$�� ���R$��(���_$�� ���$�����$�� ���$��(���$�����$�����$�����%�����%�����%��,���%�����C%�����X%�� ���i%�����w%�����%�� ���%�����%�����%�����%�����%����� &�����#&�����;&��B���U&��2���&��4���&������'����� '�����@'�����T'�����c'�����y'�� ���'�����'�����'��$���'�����'�� ���'�����'�����(�����(�� ���(�����)(�����1(�����Q(�����d(�����k(�� ���(�����(��<���(�����(�� ���(�� ���(����� )�����)��+���#)�� ���O)��>���[)�����)��#���)�����)�����)�����)�����)��*���*��(���3*��p���\*�����*��!���*��"���+��$���2+�� ���W+��T���x+��K���+�����,��'���9,��!���a,��=���,��7���,�� ���,��W���-��v���[-�����-�����-�����-�����-�����-��"���.�� ���8.�����B.��,���J.�����w.�����.�����/�� ���/�����&/�� ���./�����:/�����B/�����K/�����i/�����|/�� ���/�� ���/�����/�����/�� ���/�����/�����/�� ���/�����0�����!0�����<0��A���Q0��Z���0�����0�� ���0�����1��7��� 1�����A1��4���P1�����1�����1�����1�����1�����1�����2�����2�����$2��/���)2��&���Y2�� ���2��9���2�����2�����2�����2�����2�����3�����3�����;3��%���X3�����~3��Y���3��4���3�����4�����&4��%���+4�� ���Q4�����\4�����q4��+���4�����4�� ���4��M���4��u���(5�����5�� ���5�����5��6���5��I���6��A���\6�����6�����6�����6�����6�� ���6�� ���6��=���7��$���C7�����h7�����n7�����7��/���7�����7��&���7�����8�� ���8��"���,8�����O8�����k8�����8�����8�����8��;���8�����8�����8��"���9��!���)9�����K9��#���R9�����v9��D���~9�� ���9�����9�� ���9��E���9��G���&:�����n:��-���:��(���:��D���:�� ���$;��#���/;�����S;�����Z;�����c;��(���r;�����;�����;�� ���;�����;�����;��%���;�����<�� ���)<�����6<�� ���R<�����]<�����s<�����<�����<��4���<��%���<�����<������=�����=�� ���!=��:���-=�����h=�����=��*���=��&���=��>���=��7���)>�� ���a>�� ���k>�� ���y>�����>�����?�����?��\���?��'���&@��%���N@�����t@�����@�����@��-���@��!���@�����@�����@�����A��;���$A��)���`A�����A�����A�����A��V��A�����D�����,D��T���1D��V���D��"���D������E�� ��� E��2���E�����JE�����PE�����eE�����uE�����E�����E�����E�� ���E�����E�� ���E�� ���F�����F�����'F�����>F�����OF�����jF�� ���F�����F��6���F�����F��"���F��,���G�����JG��;���H�� ���LH�����WH�����_H��4���dH��4���H�����H��;���H��#���I��g���BI�����I��<���I�����I�� ���J����� J�����&J�����6J��;���>J�����zJ��&���J��(���J��*���J��M���K�� ���TK�����^K��+���mK��G���K��1���K�� ���L����� L��1���6L�����hL�� ���L�����L�����L��%���L�����L�� ���L��(���L�����M�����9M�����MM�� ���`M�����lM��!���M��h���M�����N�����"N��C���)N�����mN�� ���N�� ���N�����N�����N�����N��Q���N�����)O�����1O��:���QO�����O�����O�����O�����O�����O��O���O�����4P�� ���NP��1���ZP�����P��A���P�����P�����P�����P��L���Q�����]Q�����pQ��$���Q�����Q��&���Q�����Q��J���Q�� ���IR�����TR�����eR�� ���uR�����R��.���R�� ���R�����R�����R��0���R��+���S�����GS�� ���WS�����bS�����hS��5���oS�����S�����S�� ���S�� ���S�����S�� ����T��#��� T��!���.T��"���PT��#���sT�����T�����T��&���T��<���T��9���:U��H���tU��%���U�����U�����U�����V�����(V�����BV�����RV�����aV�����rV��$���V�����V�����V�����V�����V�����V�� ���V�����W����� W�����*W�����DW�����KW�� ���dW�����qW��Q���W�����W�� ���W�� ���X�����X�� ���"X��&���0X�����WX��@���hX�����X��/���X�����X�� ���X�� ���Y�����Y��)���&Y��'���PY�����xY�����Z�����"Z��(���@Z��*���iZ��&���Z��]���Z��]���[��%���w[��"���[�� ���[��<���[��9���\�� ���X\��k���b\�����\�����O]�� ���W]�����b]�����g]�����]��!���]�����]�� ���]��+���]�����^�����^�����^�� ���^�����^�� ���^�����^�� ���^��!���^�����_�����2_�����N_�����V_�����h_�����_�� ���_�����_�����_�����_��*���_��*���`�����3`��Q���S`��y���`�����a�� ���%a�� ���2a��E���<a�����a��4���a�����a��"���a��!���b�����2b��#���Jb�����nb�����b�����b��6���b�����b�� ���b��G���b�����)c�����Dc�����^c�����gc�����xc��"���c��-���c�����c�����c��o���d��:���rd�����d�����d��&���d�� ���d�����d�����e��2���,e�����_e�����ze��X���e��y���e�����Vf�����mf�����f��9���f��V���f��Q���2g��$���g�����g�����g�� ���g�����g�����g��K���g��3���Hh�����|h��(���h��'���h��@���h��+���i��;���Ai�����}i�����i��$���i��#���i�����i����� j�����j�����.j��U���Ij�����j�����j�����j��#���j�����j��.���j�����$k��R���,k�����k�����k�����k��b���k��d���l�����sl��4���l��;���l��C���l�����@m��(���Sm�����|m�����m�����m��*���m�����m�����m��%���m�����n�����n��/���)n�����Yn�����hn��&���wn�� ���n�����n�����n�����n�����n��B���n��$���7o�����\o�����co�� ���o�����o��Q���o��%���o�� ���p��-���4p��)���bp��?���p��3���p�� ����q����� q�� ���q�����(q�����q�����r��p���r��$���"s��"���Gs�����js�����s�����s��<���s��#���s�����s�����s��#��� t��H���0t��1���yt�����t�����t�����t��� (deprecated)� (in �"latex_documents" config value references unknown document %s�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%s %s�%s %s documentation�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �-A option argument must be in the form name=value�-D option argument must be in the form name=value�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�About these documents�An error happened in rendering the page %s. Reason: %r�Anchor '%s' not found�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not import extension %s�Create Makefile? (y/n)�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Encoding error:�Error�Error: an existing conf.py has been found in the selected root path.�Event %r already present�Example�Examples�Exception occurred:�Expand sidebar�Extension options�External Graphviz file %r not found or reading it failed�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnotes�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Hide Search Matches�Hint�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indicate which of the following Sphinx extensions should be enabled:�Indices and tables:�Invalid caption: %s�Invalid math_eqref_format: %r�Keyword Arguments�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Module Index�Module author: �Module code�Module level�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Non-alphabetical�Note�Notes�Numbers�Object named %r not found in include file %r�Original exception: �Other Parameters�Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Please activate JavaScript to enable the search functionality.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter a new root path (or just Enter to exit)�Please enter a valid path name.�Please enter either 'y' or 'n'.�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project version�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Recursion error:�Release�Return type�Returns�Root path for the documentation�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section %s�Section author: �See also�Separate source and build directories (y/n)�Show Source�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Symbols�Table %s�Table of Contents�Template Parameters�The %r crossref_type is already registered�The %r object_type is already registered�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The ePub file is in %(outdir)s.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Unknown event name: %s�Unknown image format: %s...�Unknown math_renderer %r is given.�Variables�Warning�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�all functions, classes, terms�all of %d po files�all source files�attribute�author names�broken link: %s (%s)�build %s, %s warning.�build %s.�building [mo]: �built-in function�can be huge�cannot copy extra file %r�cannot copy static file %r�cannot find files %r�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�class�class method�concept�conditional inclusion of content based on config values�config changed�config directory doesn't contain a conf.py file (%s)�continued from previous page�continues on next page�copying downloadable files... �copying images... �copying source files...�create batchfile�create makefile�data�default suffix for files (default: %(default)s)�dimension unit %s is invalid. Ignored.�directive�directive %r is already registered, it will be overridden�do not create batchfile�do not create makefile�document�document language�doing serial %s�domain %s already registered�domain %s not yet registered�don't create a table of contents file�done�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�duplicate label of equation %s, other instance in %s�enable %s extension�enum�enumerable_node %r already registered�enumerator�environment variable�environment variable; %s�error while formatting arguments for %s: %s�error writing file %s: %s�exception�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extensions changed�failed: %s�favicon file %r does not exist�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�finished with problems�function�general options�glossary term�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�increase verbosity (can be repeated)�index�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid regex %r in %s�invalid regex %r in coverage_c_regexes�keyword�last updated�lists all sections and subsections�loading pickled environment�loading translations [%s]... �macro�making output directory�master document name�maximum depth of submodules to show in the TOC (default: 4)�member�method�missing '+' or '-' in '%s' option.�missing attribute %s in object %s�module�module %s could not be imported: %s�modules�more than one target found for 'any' cross-reference %r: could be %s�new config�next�next chapter�no "latex_documents" config value found; no documents will be written�no "texinfo_documents" config value found; no documents will be written�no changes in version %s.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�none found�not available for built-in messages�object�operator�original entry�override a setting in configuration file�overwrite existing files�page�pass a value into HTML templates�previous�previous chapter�primary_domain %r not found, ignored.�program option�project name�quick access to all modules�quiet mode�reading error: %s, %s�reading templates... �reference label�role�role %r is already registered, it will be overridden�run the script without creating files�search�search this documentation�see %s�see also %s�setting %s.%s occurs in none of the searched theme configs�source directory has changed�source file suffix�source_parser for %r is already registered�source_suffix %r is already registered�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�statement�static method�succeeded�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�turn warnings into errors�type�union�unknown config value %r in override, ignoring�unknown mimetype for %s, ignoring�variable�version of project�while setting up extension %s:�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing %s file...�writing error: %s, %s�writing output... �Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-10-31 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: pl Language-Team: Polish (http://www.transifex.com/sphinx-doc/sphinx-1/language/pl/) Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && (n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (niezalecane)� (w �wartość konfiguracyjna "latex_documents" odwołuje się do nieznanego dokumentu %s�wartość konfiguracyjna "texinfo_documents" odwołuje się do nieznanego dokumentu %s�%(filename)s — %(docstitle)s�%d %b %Y�znaleziono %d�%d plików źródłowych podano w wierszu poleceń�%s %s�%s %s - dokumentacja�%s (%s atrybut)�%s (klasa wbudowana)�%s (zmienna wbudowana)�%s (klasa w module %s)�%s (dyrektywa)�%s (zmienna globalna lub stała)�%s (w module %s)�%s (moduł)�%s (rola)�%s nie jest katalogiem.�%s() (%s metoda klasy)�%s() (%s metoda)�%s() (%s metoda statyczna)�%s() (funkcja wbudowana)�%s() (klasa)�%s() (w module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' nie jest prawidłową opcją.�'%s' nie jest prawidłową opcją pyversion.�'setup' podany w conf.py nie jest wywoływalny. Prosimy zmienić jego definicję tak, aby była wywoływalną funkcją. Jest to potrzebne w conf.py, aby zachowywało się jak rozszerzenie Sphinksa.�(<<Oryginalny wpis>> znajduje się w pliku %s, w linii %d.)�(w %s v%s)� (w %s)�, w �Argument opcji -A musi mieć postać nazwa=wartość�Argument opcji -D musi mieć postać nazwa=wartość�<<oryginalny wpis>>�<h1>Wszystkie moduły, dla których jest dostępny kod</h1>�<h1>Kod źródłowy modułu %s</h1>�Raport o błędzie można zgłosić pod adresem <https://github.com/sphinx-doc/sphinx/issues>. Dzięki!�O tych dokumentach�Wystąpił błąd podczas renderowania strony %s. Powód: %r�Nie znaleziono kotwicy '%s'�Argumenty�Uwaga�Nazwisko autora�Autor: �Automatycznie wygenerowana lista zmian w wersji %(version)s�Klasy bazowe: %s�Builder %r już istnieje (w module %s)�Klasa buildera %s nie ma atrybutu "name"�Builder o nazwie %s jest niezarejestrowany�Builder o nazwie %s jest niezarejestrowany lub dostępny przez punkt wejścia�Wbudowane�Zmiany w C API�Nie odnaleziono katalogu źródłowego (%s)�Nie można użyć „lineno-match” z rozłącznym zbiorem „lines”�Nie można użyć jednocześnie opcji "%s" i "%s"�Ostrzeżenie�Zmienione w wersji %s�Zmiany w wersji %(version)s — %(docstitle)s�Cytat [%s] nie ma odniesienia.�Autor kodu: �Zwiń pasek boczny�Kompletny spis treści�Wartość konfiguracji %r już podana�Treść�Copyright�Nie można zaimportować rozszerzenia %s�Stworzyć Makefile? (y/n)�Tworzenie pliku %s.�Niebezpieczeństwo�Niezalecane�Niezalecane od wersji %s�Domena %r nie jest zarejestrowana�Kodowanie %r użyte do odczytu pliku include %r wydaje się być złe, spróbuj dając opcję :encoding:�Błąd kodowania:�Błąd�Błąd: znaleziono istniejący conf.py na wskazanej ścieżce root.�Zdarzenie %r już obecne�Przykład�Przykłady�Wystąpił wyjątek:�Rozwiń pasek boczny�Opcje rozszerzeń�Nie znaleziono zewnętrznego pliku Graphviz %r lub jego odczyt się nie powiódł�Rys. %s�Plik %s już istnieje, pomijam.�Zakończono: Utworzono początkową strukturę katalogów.�Przypisy�Cały indeks na jednej stronie�Indeks ogólny�Globalny indeks modułów�Szukaj�dyrektywa Graphviz nie może mieć jednocześnie argumentów content i filename�Ukryj wyniki wyszukiwania�Podpowiedź�Ignorujemy dyrektywę „graphviz” bez treści.�Ważne�Plik include %r nie znaleziony lub nie powiódł się jego odczyt�Indeks�Indeks – %(key)s�Strony indeksu alfabetycznie�Wskaż, które z następujących rozszerzeń Sphinx powinny być włączone:�Indeksy i tablice:�Nieprawidłowy podpis: %s�Nieprawidłowy math_eqref_format: %r�Argumenty Nazwane�Ostatnia modyfikacja %(last_updated)s.�Zmiany w bibliotekach�Specyfikacja linii %r: nie wyciągnięto żadnych linii z pliku include %r�Listing %s�Indeks modułów�Autor modułu: �Kod modułu�Poziom modułu�Prefiks nazw dla katalogów templates i static�Nawigacja�Nowe w wersji %s�Następny temat�Nie wybrano buildera, używamy domyślnego: html�Nie ma takiej wartości konfiguracyjnej: %s�Niealfabetyczny�Informacja�Uwagi�Liczby�Nie znaleziono obiektu o nazwie %r w pliku include %r�Pierwotny wyjątek: �Pozostałe parametry�Inne zmiany�Przegląd�Przeglądanie: kod modułu�Parametry�Stały odnośnik do tego bloku kodu�Stały odnośnik do tej definicji�Stały odnośnik do tego równania�Stały odnośnik do tego nagłówka�Stały odnośnik do tego obrazu�Stały odnośnik do tej tabeli�Stały odnośnik do tego spisu treści�Aby umożliwić wyszukiwanie, proszę włączyć JavaScript.�Podaj rozszerzenie pliku, na przykład '.rst' lub '.txt'.�Wprowadź, prosimy, nową ścieżkę root (lub tylko Enter, aby wyjść)�Wprowadź poprawną nazwę ścieżki.�Wprowadź "y" lub "n".�Inicjalizacja wyszukiwania...�Poprzedni temat�Podstawowe opcje projektu�Język projektu�Nazwa projektu�Wydanie projektu�Wersja projektu�Python Enhancement Proposals; PEP %s�Indeks modułów Pythona�Szybkie wyszukiwanie�Wyrzuca�Błąd rekursji:�Wydanie�Typ zwracany�Zwraca�Ścieżka root dla dokumentacji�Uruchamianie Sphinksa v%s�Szukaj�Przeszukaj %(docstitle)s�Wyszukiwanie�Wyniki wyszukiwania�Wyszukiwanie zakończone. Liczba znalezionych stron pasujących do zapytania: %s.�Szukaj pośród %(docstitle)s�Wyszukiwanie�Rozdział %s�Autor rozdziału: �Zobacz także�Rozdziel katalogi source i build (y/n)�Pokaż źródło�Katalog źródłowy i katalog docelowy nie mogą być identyczne�Sufiks pliku źródłowego�Parser źródeł dla %s jest nie zarejestrowany�Symbole�Tabela %s�Spis treści�Parametry szablonu�%r crossref_type jest już zarejestrowany�%r object_type jest już zarejestrowany�Rozszerzenie %s używane przez ten projekt potrzebuje Sphinksa w wersji co najmniej %s; dlatego nie może zostać zbudowane z tą wersją.�Strona HTML jest w %(outdir)s.�Strony HTML są w %(outdir)s.�Pliki LaTeX znajdują się w %(outdir)s.�Pliki Texinfo znajdują się w %(outdir)s.�Pliki XML znajdują się w %(outdir)s.�Wartość konfiguracyjna `{name}` musi być jednym z {candidates}, a podany jest `{current}`.�Plik konfiguracyjny (albo jeden z modułów przez niego zaimportowanych) wywołał sys.exit()�Plik ePub znajduje się w %(outdir)s.�Pliki pseudo-XML są w %(outdir)s.�Pliki tekstowe są w %(outdir)s.�W twoim piku konfiguracyjnym jest błąd programowalny: %s�W twoim piku konfiguracyjnym jest błąd składniowy: %s �Ta strona�Ten projekt potrzebuje Sphinksa w wersji co najmniej %s, dlatego nie może zostać zbudowany z tą wersją.�Ten projekt potrzebuje rozszerzenia %s co najmniej w wersji %s, dlatego nie może zostać zbudowany z załadowaną wersją (%s).�Wyrzuca�Wskazówka�Todo�Nieznana nazwa zdarzenia: %s�Nieznany format obrazka: %s...�Podano nieznany math_renderer %r.�Zmienne�Ostrzeżenie�Witamy w narzędziu quickstart Sphinksa %s.�Witaj! To jest�Twoje wyszukiwanie nie dało żadnych wyników. Upewnij się, że wszystkie słowa są wpisane prawidłowo i że wybrałeś dostateczną ilość kategorii.�[dokumentacja]�[wykres: %s]�[wykres]�[obraz: %s]�[obraz]�[źródło]�wszystkie funkcje, klasy, terminy�wszystkie z %d plików po�wsztstkie pliki źródłowe�atrybut�nazwiska autorów�zepsuty odnośnik: %s (%s)�build %s, %s ostrzeżenie.�build %s.�budowanie [mo]:�funkcja wbudowana�może być ogromny�nie można skopiować dodatkowego pliku %r�nie można skopiować pliku statycznego %r�nie można znaleźć plików %r�nie można nadpisać ustawienia konfiguracji %r nie wspieranym typem, ignorowanie�nie można nadpisać słownikowego ustawienia konfiguracji %r, ignorowanie (użyj %r, by ustawić poszczególne elementy)�klasa�metoda klasy�koncepcja�warunkowe włączenie treści na podstawie wartości konfiguracyjnych�konfiguracja zmieniona�folder konfiguracyjny nie zawiera pliku conf.py (%s)�kontynuacja poprzedniej strony�ciąg dalszy na następnej stronie�kopiowanie plików do pobrania...�kopiowanie obrazków...�kopiowanie plików źródłowych...�twórz plik wsadowy�utwórz plik makefile�dane�domyślny sufiks dla plików (domyślnie: %(default)s)�%s�dyrektywa�dyrektywa %r jest już zarejestrowana, jej wizytorzy zostaną nadpisani�nie twórz pliku wsadowego�nie twórz pliku makefile�dokument�język dokumentu�tworzenie serii %s�domena %s jest już zarejestrowana�domena %s nie została jeszcze zarejestrowana�nie twórz pliku spisu treści�gotowe�komenda dot %r nie może zostać uruchomiona (potrzebna do wyjścia graphviz), sprawdź ustawienia graphviz_dot�zduplikowana etykieta równania %s, inne wystąpienie w %s�włącz rozszerzenie %s�enum�enumerable_node %r już zarejestrowany�enumerator�zmienna środowiskowa�zmienna środowiskowa; %s�błąd podczas formatowania argumentów dla %s: %s�błąd zapisu pliku %s: %s�wyjątek�rozszerzenie %r nie zawiera funkcji setup(); czy to na pewno moduł rozszerzenia Sphinx?�rozszerzenie %r zwróciło nie wspierany obiekt ze swojej funkcji setup(); powinno zwrócić None lub słownik metadanych�rozszerzenie zmienione�nie powiodło się: %s�plik favicon %r nie istnieje�plik %r podany w wierszu poleceń nie istnieje, ignoruję�plik %r podany w wierszu poleceń nie znajduje się w katalogu źródłowym, ignoruję�plik %r na ścieżce motywu nie jest poprawnym plikiem zip lub nie zawiera motywu�rozszerzenie pliku (domyślnie: rst)�zakończono z problemami�funkcja�ogólne opcje�termin glosariusza�symbol gramatyki�graphviz_output_format musi mieć wartość „png” lub „svg” a ma %r�zwiększ szczegółowość (może być powtórzone)�indeks�nieprawidłowy css_file: %r, zignorowano�nieprawidłowy js_file: %r, zignorowano�niepoprawna liczba %r dla wartości konfiguracji %r, ignorowanie�nieprawidłowe wyrażenie regularne %r w %s�nieprawidłowe wyrażenie regularne %r w coverage_c_regexes�słowo kluczowe�ostatnio aktualizowana�wszystkie rozdziały i podrozdziały�ładowanie zapakowanego środowiska�ładowanie tłumaczeń [%s]...�makro�tworzenie katalogu wyjścia�nazwa głównego dokumentu�maksymalna głębokość submodułów wyświetlanych w spisie treści (domyślnie: 4)�pole�metoda�brak '+' lub '-' w opcji '%s'.�brakujący atrybut %s w obiekcie %s�moduł�moduł %s nie mógł zostać zaimportowany: %s�moduły�znaleziono więcej niż jeden cel dla cross-referencji „any” %r: może być %s�nowa konfiguracja�dalej�następny rozdział�nie znaleziono wartości konfiguracyjnej "latex_documents"; żadne dokumenty nie zostaną zapisane�nie znaleziono wartości konfiguracyjnej "texinfo_documents"; żadne dokumenty nie zostaną zapisane�brak zmian w wersji %s.�nie znaleziono motywu o nazwie %r (brak theme.conf?)�nie znaleziono motywu o nazwie %r, z którego dziedziczy %r�klasa %r jest już zarejestrowana, jej wizytorzy zostaną nadpisani�nic nie znaleziono�niedostępne dla wbudowanych wiadomości�obiekt�operator�oryginalny wpis�zastąp ustawienie w pliku konfiguracyjnym�nadpisz istniejące pliki�strona�przekaż wartość do szablonów HTML�wstecz�poprzedni rozdział�Nie odnaleziono primary_domain %r, zignorowano.�opcja programu�nazwa projektu�szybki dostęp do wszystkich modułów�tryb cichy�błąd odczytu: %s, %s�wczytywanie szablonów... �etykieta odsyłacza�rola�rola %r jest już zarejestrowana, jej wizytorzy zostaną nadpisani�wykonaj skrypt bez tworzenia plików�szukaj�przeszukaj tę dokumentację�zobacz %s�zobacz także %s�ustawienie %s.%s nie występuje w żadnej z przeszukiwanych konfiguracji motywów�katalog źródłowy został zmieniony�rozszerzenie pliku źródłowego�source_parser dla %r jest już zarejestrowany�source_suffix %r jest już zarejestrowany�sphinx-quickstart nie nadpisze istniejących projektów Sphinx.�sphinx-quickstart nie nadpisze istniejącego pliku.�instrukcja�statyczna metoda�udało się�rozszerzenie %s nie deklaruje, czy jest bezpieczne do czytania współbieżnego, zakładamy że nie jest – prosimy zapytać autora rozszerzenie o sprawdzenie i zadeklarowania tego wprost�rozszerzenie %s nie deklaruje, czy jest bezpieczne do pisania współbieżnego, zakładamy że nie jest – prosimy zapytać autora rozszerzenia o sprawdzenie i zadeklarowanie tego wprost�dokumentacja do�rozszerzenie %r zostało już włączone do Sphinx'a, począwszy od wersji %s; to rozszerzenie jest zignorowane.�motyw %r nie ma ustawienia "inherit"�motyw %r nie ma ustawienia "theme"�zamień ostrzeżenia na błędy�typ�unia�nieznana wartość konfiguracji %r w nadpisaniu, ignorowanie�nieznany mimetype dla %s, ignoruję�zmienna�wersja projektu�podczas ustawiania rozszerzenia %s:�zapisz wszystkie pliki (domyślnie: zapisz tylko nowe i zmienione pliki)�zapisz ostrzeżenia (i błędy) do podanego pliku�pisanie pliku %s...�błąd zapisu: %s, %s�pisanie wyjścia...����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pl/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000271667�00000000000�021177� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # m_aciek <maciej.olko@gmail.com>, 2017-2020 # Michael Gielda <michal.gielda@gmail.com>, 2014 # Komiya Takeshi <i.tkomiya@gmail.com>, 2018 # Tawez, 2013-2019 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-10-31 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Polish (http://www.transifex.com/sphinx-doc/sphinx-1/language/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: pl\n" "Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && (n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Nie odnaleziono katalogu źródłowego (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Katalog źródłowy i katalog docelowy nie mogą być identyczne" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Uruchamianie Sphinksa v%s" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Ten projekt potrzebuje Sphinksa w wersji co najmniej %s, dlatego nie może zostać zbudowany z tą wersją." #: sphinx/application.py:243 msgid "making output directory" msgstr "tworzenie katalogu wyjścia" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "podczas ustawiania rozszerzenia %s:" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' podany w conf.py nie jest wywoływalny. Prosimy zmienić jego definicję tak, aby była wywoływalną funkcją. Jest to potrzebne w conf.py, aby zachowywało się jak rozszerzenie Sphinksa." #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "ładowanie tłumaczeń [%s]..." #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "gotowe" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "niedostępne dla wbudowanych wiadomości" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "ładowanie zapakowanego środowiska" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "nie powiodło się: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "Nie wybrano buildera, używamy domyślnego: html" #: sphinx/application.py:348 msgid "succeeded" msgstr "udało się" #: sphinx/application.py:349 msgid "finished with problems" msgstr "zakończono z problemami" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "build %s, %s ostrzeżenie." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "build %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "klasa %r jest już zarejestrowana, jej wizytorzy zostaną nadpisani" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "dyrektywa %r jest już zarejestrowana, jej wizytorzy zostaną nadpisani" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "rola %r jest już zarejestrowana, jej wizytorzy zostaną nadpisani" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "rozszerzenie %s nie deklaruje, czy jest bezpieczne do czytania współbieżnego, zakładamy że nie jest – prosimy zapytać autora rozszerzenie o sprawdzenie i zadeklarowania tego wprost" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "rozszerzenie %s nie deklaruje, czy jest bezpieczne do pisania współbieżnego, zakładamy że nie jest – prosimy zapytać autora rozszerzenia o sprawdzenie i zadeklarowanie tego wprost" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "tworzenie serii %s" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "folder konfiguracyjny nie zawiera pliku conf.py (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "nie można nadpisać słownikowego ustawienia konfiguracji %r, ignorowanie (użyj %r, by ustawić poszczególne elementy)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "niepoprawna liczba %r dla wartości konfiguracji %r, ignorowanie" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "nie można nadpisać ustawienia konfiguracji %r nie wspieranym typem, ignorowanie" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "nieznana wartość konfiguracji %r w nadpisaniu, ignorowanie" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "Nie ma takiej wartości konfiguracyjnej: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "Wartość konfiguracji %r już podana" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "W twoim piku konfiguracyjnym jest błąd składniowy: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Plik konfiguracyjny (albo jeden z modułów przez niego zaimportowanych) wywołał sys.exit()" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "W twoim piku konfiguracyjnym jest błąd programowalny: \n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Rozdział %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Rys. %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tabela %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Listing %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "Wartość konfiguracyjna `{name}` musi być jednym z {candidates}, a podany jest `{current}`." #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "Nie odnaleziono primary_domain %r, zignorowano." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "Zdarzenie %r już obecne" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Nieznana nazwa zdarzenia: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "Ten projekt potrzebuje rozszerzenia %s co najmniej w wersji %s, dlatego nie może zostać zbudowany z załadowaną wersją (%s)." #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "Klasa buildera %s nie ma atrybutu \"name\"" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Builder %r już istnieje (w module %s)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Builder o nazwie %s jest niezarejestrowany lub dostępny przez punkt wejścia" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "Builder o nazwie %s jest niezarejestrowany" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "domena %s jest już zarejestrowana" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "domena %s nie została jeszcze zarejestrowana" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "%r object_type jest już zarejestrowany" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "%r crossref_type jest już zarejestrowany" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "source_suffix %r jest już zarejestrowany" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "source_parser dla %r jest już zarejestrowany" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "Parser źródeł dla %s jest nie zarejestrowany" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "enumerable_node %r już zarejestrowany" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "rozszerzenie %r zostało już włączone do Sphinx'a, począwszy od wersji %s; to rozszerzenie jest zignorowane." #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "Pierwotny wyjątek:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "Nie można zaimportować rozszerzenia %s" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "rozszerzenie %r nie zawiera funkcji setup(); czy to na pewno moduł rozszerzenia Sphinx?" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "Rozszerzenie %s używane przez ten projekt potrzebuje Sphinksa w wersji co najmniej %s; dlatego nie może zostać zbudowane z tą wersją." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "rozszerzenie %r zwróciło nie wspierany obiekt ze swojej funkcji setup(); powinno zwrócić None lub słownik metadanych" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "motyw %r nie ma ustawienia \"theme\"" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "motyw %r nie ma ustawienia \"inherit\"" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "nie znaleziono motywu o nazwie %r, z którego dziedziczy %r" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "ustawienie %s.%s nie występuje w żadnej z przeszukiwanych konfiguracji motywów" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "plik %r na ścieżce motywu nie jest poprawnym plikiem zip lub nie zawiera motywu" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "nie znaleziono motywu o nazwie %r (brak theme.conf?)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "budowanie [mo]:" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "pisanie wyjścia..." #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "wszystkie z %d plików po" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "wsztstkie pliki źródłowe" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "plik %r podany w wierszu poleceń nie znajduje się w katalogu źródłowym, ignoruję" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "plik %r podany w wierszu poleceń nie istnieje, ignoruję" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "%d plików źródłowych podano w wierszu poleceń" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "znaleziono %d" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "nic nie znaleziono" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "kopiowanie obrazków..." #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "nieznany mimetype dla %s, ignoruję" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "pisanie pliku %s..." #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "brak zmian w wersji %s." #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Wbudowane" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Poziom modułu" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "kopiowanie plików źródłowych..." #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "Plik ePub znajduje się w %(outdir)s." #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "nieprawidłowy css_file: %r, zignorowano" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "wczytywanie szablonów... " #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "zepsuty odnośnik: %s (%s)" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "Nie znaleziono kotwicy '%s'" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "Strona HTML jest w %(outdir)s." #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "Pliki Texinfo znajdują się w %(outdir)s." #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "nie znaleziono wartości konfiguracyjnej \"texinfo_documents\"; żadne dokumenty nie zostaną zapisane" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "wartość konfiguracyjna \"texinfo_documents\" odwołuje się do nieznanego dokumentu %s" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (w " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "Pliki tekstowe są w %(outdir)s." #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "błąd zapisu pliku %s: %s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "Pliki XML znajdują się w %(outdir)s." #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "Pliki pseudo-XML są w %(outdir)s." #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "Strony HTML są w %(outdir)s." #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d %b %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Indeks ogólny" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "indeks" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "dalej" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "wstecz" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "kopiowanie plików do pobrania..." #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "nie można skopiować pliku statycznego %r" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "nie można skopiować dodatkowego pliku %r" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "Wystąpił błąd podczas renderowania strony %s.\nPowód: %r" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "nieprawidłowy js_file: %r, zignorowano" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "Podano nieznany math_renderer %r." #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "plik favicon %r nie istnieje" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s - dokumentacja" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "Pliki LaTeX znajdują się w %(outdir)s." #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "nie znaleziono wartości konfiguracyjnej \"latex_documents\"; żadne dokumenty nie zostaną zapisane" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "wartość konfiguracyjna \"latex_documents\" odwołuje się do nieznanego dokumentu %s" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Indeks" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Wydanie" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "Błąd kodowania:" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "Błąd rekursji:" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "Wystąpił wyjątek:" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "Raport o błędzie można zgłosić pod adresem <https://github.com/sphinx-doc/sphinx/issues>. Dzięki!" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "ogólne opcje" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "zapisz wszystkie pliki (domyślnie: zapisz tylko nowe i zmienione pliki)" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "zastąp ustawienie w pliku konfiguracyjnym" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "przekaż wartość do szablonów HTML" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "zwiększ szczegółowość (może być powtórzone)" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "zapisz ostrzeżenia (i błędy) do podanego pliku" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "zamień ostrzeżenia na błędy" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "nie można znaleźć plików %r" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "Argument opcji -D musi mieć postać nazwa=wartość" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "Argument opcji -A musi mieć postać nazwa=wartość" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "warunkowe włączenie treści na podstawie wartości konfiguracyjnych" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "Wprowadź poprawną nazwę ścieżki." #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "Wprowadź \"y\" lub \"n\"." #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "Podaj rozszerzenie pliku, na przykład '.rst' lub '.txt'." #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "Witamy w narzędziu quickstart Sphinksa %s." #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "Ścieżka root dla dokumentacji" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "Błąd: znaleziono istniejący conf.py na wskazanej ścieżce root." #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "sphinx-quickstart nie nadpisze istniejących projektów Sphinx." #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "Wprowadź, prosimy, nową ścieżkę root (lub tylko Enter, aby wyjść)" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "Rozdziel katalogi source i build (y/n)" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "Prefiks nazw dla katalogów templates i static" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "Nazwa projektu" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "Nazwisko autora" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "Wersja projektu" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "Wydanie projektu" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "Język projektu" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "Sufiks pliku źródłowego" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "sphinx-quickstart nie nadpisze istniejącego pliku." #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "Wskaż, które z następujących rozszerzeń Sphinx powinny być włączone:" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "Stworzyć Makefile? (y/n)" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "Tworzenie pliku %s." #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "Plik %s już istnieje, pomijam." #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "Zakończono: Utworzono początkową strukturę katalogów." #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "tryb cichy" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "Podstawowe opcje projektu" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "nazwa projektu" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "nazwiska autorów" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "wersja projektu" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "język dokumentu" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "rozszerzenie pliku źródłowego" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "nazwa głównego dokumentu" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "Opcje rozszerzeń" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "włącz rozszerzenie %s" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "utwórz plik makefile" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "nie twórz pliku makefile" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "twórz plik wsadowy" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "nie twórz pliku wsadowego" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "Nieprawidłowy podpis: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "Nie można użyć jednocześnie opcji \"%s\" i \"%s\"" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "Plik include %r nie znaleziony lub nie powiódł się jego odczyt" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "Kodowanie %r użyte do odczytu pliku include %r wydaje się być złe, spróbuj dając opcję :encoding:" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "Nie znaleziono obiektu o nazwie %r w pliku include %r" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "Nie można użyć „lineno-match” z rozłącznym zbiorem „lines”" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "Specyfikacja linii %r: nie wyciągnięto żadnych linii z pliku include %r" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Autor rozdziału: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Autor modułu: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Autor kodu: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autor: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametry" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428 msgid "Returns" msgstr "Zwraca" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:430 msgid "Return type" msgstr "Typ zwracany" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "pole" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "zmienna" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164 msgid "function" msgstr "funkcja" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "makro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "unia" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "enum" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "enumerator" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "typ" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Nowe w wersji %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Zmienione w wersji %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Niezalecane od wersji %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "Cytat [%s] nie ma odniesienia." #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Parametry szablonu" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Wyrzuca" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1166 msgid "class" msgstr "klasa" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "koncepcja" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (funkcja wbudowana)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s metoda)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (klasa)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (zmienna globalna lub stała)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s atrybut)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumenty" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (moduł)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168 msgid "method" msgstr "metoda" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165 msgid "data" msgstr "dane" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171 msgid "attribute" msgstr "atrybut" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1173 msgid "module" msgstr "moduł" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "zduplikowana etykieta równania %s, inne wystąpienie w %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "Nieprawidłowy math_eqref_format: %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "słowo kluczowe" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operator" #: sphinx/domains/python.py:61 msgid "object" msgstr "obiekt" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1167 msgid "exception" msgstr "wyjątek" #: sphinx/domains/python.py:63 msgid "statement" msgstr "instrukcja" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "funkcja wbudowana" #: sphinx/domains/python.py:421 msgid "Variables" msgstr "Zmienne" #: sphinx/domains/python.py:425 msgid "Raises" msgstr "Wyrzuca" #: sphinx/domains/python.py:648 sphinx/domains/python.py:792 #, python-format msgid "%s() (in module %s)" msgstr "%s() (w module %s)" #: sphinx/domains/python.py:708 sphinx/domains/python.py:884 #: sphinx/domains/python.py:935 #, python-format msgid "%s (in module %s)" msgstr "%s (w module %s)" #: sphinx/domains/python.py:710 #, python-format msgid "%s (built-in variable)" msgstr "%s (zmienna wbudowana)" #: sphinx/domains/python.py:735 #, python-format msgid "%s (built-in class)" msgstr "%s (klasa wbudowana)" #: sphinx/domains/python.py:736 #, python-format msgid "%s (class in %s)" msgstr "%s (klasa w module %s)" #: sphinx/domains/python.py:797 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s metoda klasy)" #: sphinx/domains/python.py:799 sphinx/domains/python.py:939 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s metoda statyczna)" #: sphinx/domains/python.py:1093 msgid "Python Module Index" msgstr "Indeks modułów Pythona" #: sphinx/domains/python.py:1094 msgid "modules" msgstr "moduły" #: sphinx/domains/python.py:1143 msgid "Deprecated" msgstr "Niezalecane" #: sphinx/domains/python.py:1169 msgid "class method" msgstr "metoda klasy" #: sphinx/domains/python.py:1170 msgid "static method" msgstr "statyczna metoda" #: sphinx/domains/python.py:1172 msgid "property" msgstr "" #: sphinx/domains/python.py:1230 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1350 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1404 msgid " (deprecated)" msgstr " (niezalecane)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (dyrektywa)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (rola)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "dyrektywa" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "rola" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "zmienna środowiskowa; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "termin glosariusza" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "symbol gramatyki" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "etykieta odsyłacza" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "zmienna środowiskowa" #: sphinx/domains/std.py:568 msgid "program option" msgstr "opcja programu" #: sphinx/domains/std.py:569 msgid "document" msgstr "dokument" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Indeks modułów" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Wyszukiwanie" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "nowa konfiguracja" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "konfiguracja zmieniona" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "rozszerzenie zmienione" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "katalog źródłowy został zmieniony" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "Domena %r nie jest zarejestrowana" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "zobacz %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "zobacz także %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Symbole" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "maksymalna głębokość submodułów wyświetlanych w spisie treści (domyślnie: 4)" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "nadpisz istniejące pliki" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "wykonaj skrypt bez tworzenia plików" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "nie twórz pliku spisu treści" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "rozszerzenie pliku (domyślnie: rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s nie jest katalogiem." #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "nieprawidłowe wyrażenie regularne %r w %s" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "nieprawidłowe wyrażenie regularne %r w coverage_c_regexes" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "moduł %s nie mógł zostać zaimportowany: %s" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "brak '+' lub '-' w opcji '%s'." #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "'%s' nie jest prawidłową opcją." #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "'%s' nie jest prawidłową opcją pyversion." #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "dyrektywa Graphviz nie może mieć jednocześnie argumentów content i filename" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "Nie znaleziono zewnętrznego pliku Graphviz %r lub jego odczyt się nie powiódł" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "Ignorujemy dyrektywę „graphviz” bez treści." #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "komenda dot %r nie może zostać uruchomiona (potrzebna do wyjścia graphviz), sprawdź ustawienia graphviz_dot" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "graphviz_output_format musi mieć wartość „png” lub „svg” a ma %r" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[wykres: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[wykres]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Stały odnośnik do tego równania" #: sphinx/ext/intersphinx.py:173 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:204 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:218 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:224 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:334 #, python-format msgid "(in %s v%s)" msgstr "(w %s v%s)" #: sphinx/ext/intersphinx.py:336 #, python-format msgid "(in %s)" msgstr " (w %s)" #: sphinx/ext/intersphinx.py:369 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:382 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[źródło]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Todo" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<oryginalny wpis>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(<<Oryginalny wpis>> znajduje się w pliku %s, w linii %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "oryginalny wpis" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[dokumentacja]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Kod modułu" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Kod źródłowy modułu %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Przeglądanie: kod modułu" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Wszystkie moduły, dla których jest dostępny kod</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "błąd podczas formatowania argumentów dla %s: %s" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "brakujący atrybut %s w obiekcie %s" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "Klasy bazowe: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:78 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "domyślny sufiks dla plików (domyślnie: %(default)s)" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "Argumenty Nazwane" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "Przykład" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Przykłady" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "Uwagi" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "Pozostałe parametry" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Uwaga" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Ostrzeżenie" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Niebezpieczeństwo" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Błąd" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Podpowiedź" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Ważne" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Informacja" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Zobacz także" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Wskazówka" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Ostrzeżenie" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "kontynuacja poprzedniej strony" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "ciąg dalszy na następnej stronie" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "Niealfabetyczny" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "Liczby" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "strona" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "Spis treści" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Szukaj" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Szukaj" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Pokaż źródło" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Przegląd" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Witaj! To jest" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "dokumentacja do" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "ostatnio aktualizowana" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Indeksy i tablice:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Kompletny spis treści" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "wszystkie rozdziały i podrozdziały" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "przeszukaj tę dokumentację" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Globalny indeks modułów" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "szybki dostęp do wszystkich modułów" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "wszystkie funkcje, klasy, terminy" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Indeks – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Cały indeks na jednej stronie" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Strony indeksu alfabetycznie" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "może być ogromny" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Nawigacja" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Szukaj pośród %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "O tych dokumentach" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Copyright" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Copyright %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Ostatnia modyfikacja %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Przeszukaj %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Poprzedni temat" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "poprzedni rozdział" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Następny temat" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "następny rozdział" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Aby umożliwić wyszukiwanie, proszę włączyć JavaScript." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "szukaj" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Wyniki wyszukiwania" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Twoje wyszukiwanie nie dało żadnych wyników. Upewnij się, że wszystkie słowa są wpisane prawidłowo i że wybrałeś dostateczną ilość kategorii." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Szybkie wyszukiwanie" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Ta strona" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Zmiany w wersji %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automatycznie wygenerowana lista zmian w wersji %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Zmiany w bibliotekach" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Zmiany w C API" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Inne zmiany" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Stały odnośnik do tego nagłówka" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Stały odnośnik do tej definicji" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Ukryj wyniki wyszukiwania" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Wyszukiwanie" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Inicjalizacja wyszukiwania..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Wyszukiwanie zakończone. Liczba znalezionych stron pasujących do zapytania: %s." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", w " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Rozwiń pasek boczny" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Zwiń pasek boczny" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Treść" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "znaleziono więcej niż jeden cel dla cross-referencji „any” %r: może być %s" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "Nieznany format obrazka: %s..." #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "błąd odczytu: %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "błąd zapisu: %s, %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Stały odnośnik do tej tabeli" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Stały odnośnik do tego bloku kodu" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Stały odnośnik do tego obrazu" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Stały odnośnik do tego spisu treści" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Przypisy" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "%s" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[obraz: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[obraz]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3296528 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015526� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4973056 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017313� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000004603�00000000000�021165� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "pt", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n != 1)" });�����������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000000766�00000000000�021172� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$���������������,�����-����Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-10-31 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: pt Language-Team: Portuguese (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �����������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000241430�00000000000�021170� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-10-31 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Portuguese (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: pt\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:430 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1166 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1173 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1167 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:421 msgid "Variables" msgstr "" #: sphinx/domains/python.py:425 msgid "Raises" msgstr "" #: sphinx/domains/python.py:648 sphinx/domains/python.py:792 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:708 sphinx/domains/python.py:884 #: sphinx/domains/python.py:935 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:710 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:735 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:736 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:797 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:799 sphinx/domains/python.py:939 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1093 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1094 msgid "modules" msgstr "" #: sphinx/domains/python.py:1143 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1169 msgid "class method" msgstr "" #: sphinx/domains/python.py:1170 msgid "static method" msgstr "" #: sphinx/domains/python.py:1172 msgid "property" msgstr "" #: sphinx/domains/python.py:1230 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1350 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1404 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:173 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:204 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:218 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:224 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:334 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:336 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:369 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:382 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:78 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3298383 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt_BR/�������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016111� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.4981785 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt_BR/LC_MESSAGES/�������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017676� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.js����������������������������������������������0000644�0000766�0000024�00000010440�00000000000�021544� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "pt_BR", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.", "© Copyright %(copyright)s.": "© Copyright %(copyright)s.", ", in ": ", em ", "About these documents": "Sobre esses documentos", "Automatically generated list of changes in version %(version)s": "Lista de altera\u00e7\u00f5es na vers\u00e3o %(version)s, gerada automaticamente", "C API changes": "Altera\u00e7\u00f5es na API C", "Changes in Version %(version)s — %(docstitle)s": "Modifica\u00e7\u00f5es na vers\u00e3o %(version)s — %(docstitle)s", "Collapse sidebar": "Recolher painel lateral", "Complete Table of Contents": "Tabela Completa dos Conte\u00fados", "Contents": "Conte\u00fados", "Copyright": "Copyright", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "Criada usando <a href=\"https://www.sphinx-doc.org/pt_BR/master\">Sphinx</a> %(sphinx_version)s.", "Expand sidebar": "Expandir painel lateral", "Full index on one page": "\u00cdndice completo em p\u00e1gina \u00fanica", "General Index": "\u00cdndice Geral", "Global Module Index": "\u00cdndice Global de M\u00f3dulos", "Go": "Ir", "Hide Search Matches": "Esconder Resultados da Busca", "Index": "\u00cdndice", "Index – %(key)s": "\u00cdndice – %(key)s", "Index pages by letter": "P\u00e1ginas de \u00edndice por letra", "Indices and tables:": "\u00cdndices e Tabelas:", "Last updated on %(last_updated)s.": "\u00daltima atualiza\u00e7\u00e3o em %(last_updated)s.", "Library changes": "Altera\u00e7\u00f5es na biblioteca", "Navigation": "Navega\u00e7\u00e3o", "Next topic": "Pr\u00f3ximo t\u00f3pico", "Other changes": "Outras altera\u00e7\u00f5es", "Overview": "Vis\u00e3o geral", "Permalink to this definition": "Link permanente para esta defini\u00e7\u00e3o", "Permalink to this headline": "Link permanente para este t\u00edtulo", "Please activate JavaScript to enable the search\n functionality.": "Por favor, ativar JavaScript para habilitar a\nfuncionalidade de busca.", "Preparing search...": "Preparando a busca...", "Previous topic": "T\u00f3pico anterior", "Quick search": "Busca r\u00e1pida", "Search": "Buscar", "Search Page": "P\u00e1gina de Busca", "Search Results": "Resultados da Busca", "Search finished, found %s page(s) matching the search query.": "Busca conclu\u00edda. %s p\u00e1gina(s) que atendem a consulta.", "Search within %(docstitle)s": "Pesquisar dentro de %(docstitle)s", "Searching": "Buscando", "Searching for multiple words only shows matches that contain\n all words.": "Pesquisando por v\u00e1rias palavras s\u00f3 mostra correspond\u00eancias\nque cont\u00eam todas as palavras.", "Show Source": "Exibir Fonte", "Table of Contents": "Tabela de Conte\u00fado", "This Page": "Essa P\u00e1gina", "Welcome! This is": "Bem Vindo! \u00c9 isso a\u00ed.", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Sua busca n\u00e3o encontrou nenhum documento. Por favor, confirme se todas as palavras est\u00e3o grafadas corretamente e se voc\u00ea selecionou categorias suficientes.", "all functions, classes, terms": "todas fun\u00e7\u00f5es, classes, termos", "can be huge": "pode ser enorme", "last updated": "\u00faltima atualiza\u00e7\u00e3o", "lists all sections and subsections": "Listar todas se\u00e7\u00f5es e subse\u00e7\u00f5es", "next chapter": "pr\u00f3ximo cap\u00edtulo", "previous chapter": "cap\u00edtulo anterior", "quick access to all modules": "acesso r\u00e1pido para todos os m\u00f3dulos", "search": "buscar", "search this documentation": "Buscar nessa documenta\u00e7\u00e3o", "the documentation for": "documenta\u00e7\u00e3o para" }, "plural_expr": "(n > 1)" });��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.mo����������������������������������������������0000644�0000766�0000024�00000234544�00000000000�021560� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������\��������������.����.����$0�����2��E��3��r���4��l���[5�� ���5�����5��*���5�����6��=���6��7���6��H��� 7��?���U7��"���7�� ���7�����7��%���7�����7�����8��!���.8�����P8�����V8�����j8�����|8�� ���8�� ���8�����8�����8�����8�����8�� ���8�����9�� ���!9�� ���-9�� ���79��S���X9�����9��A���9�����:�����:�����3:�����D:�����\:�� ���u:�����:��$���:��6���:�����:�����;��$���.;�����S;��3��� <�� ���A<�����M<�����U<��1���[<��1���<��G���<�����=�����=��0���2=�����c=��H���=�����=��b���`>��;���>�����>�����?��6���5?�����l?�� ���?�� ���?�� ���?�����?�����?��>���?�� ���@��(���@��(���A@�����j@��?���@�����@�� ���@��!���@��8���A��%���;A�����aA�����iA��4���A�� ���A�� ���A�����A�����A�����B�����/B�� ���8B��N���BB��%���B��%���B�����B��:���B��7���6C�����nC��"���C��R���C�����C����� D�� ���D�����D�����;D��N���WD��R���D��`���D�����ZE��&���jE�����E��D���E��H���E��K���%F�����qF�����F�����F��5���F�����F�����F�����F��8���G��=���?G��1���}G��D���G��B���G��0���7H��-���hH��+���H��3���H��'���H��"���I��3���AI��"���uI��:���I��#���I�����I��!���I��:���!J�����\J�� ���|J�� ���J��:���J�����J�����K�� ���K�����K�����K��C���K��*���L�����.L�����BL��3��GL��.���{M�� ���M��.���M�����M�����M�����M��D���N�����ZN�����nN�� ���YO��'���fO�����O��[���O�����O�����P�����:P��Y���LP��!���P�����P��2���P�� ��� Q��C���Q�����ZQ��n���zQ��E���Q�� ���/R�����<R�� ���LR�� ���XR��-���eR��(���R�� ���R�����R�� ���R��(���R����� S�����&S�����7S��Z���<S�����S�����S��,���S����S�����T�����T�� ���U��(���U�����FU�����OU�� ���eU�����pU�����U�����U�����U�����U�����U����� V�����!V��&���;V��B���bV��i���V��2���W��I���BW��4���W�����W�����W�����X�����X��y���1X�����X�����X�����X�����X�� ���X�����Y�����Y�����%Y��#���5Y��$���YY�����~Y�� ���Y�����Y�����Y�����Y�� ���Y�����Y�� ���Y�� ���Y�����Y�����Y�����Z�����(Z�����/Z�� ���DZ�����PZ��<���_Z�����Z�� ���Z��K���Z�� ���[�����[�����*[�����3[��+���J[�� ���v[��k���[��>���[�����-\��#���@\��-��d\�����]�����]�����]�����]�����]�����]��Y���]��Z���J^��*���^��3���^��/���_��(���4_��.���]_��P���_��p���_�����N`��!���n`��"���`��$���`�� ���`��e���`��Z���_a��N���a��T��� b��K���^b��%���b�����b�����b��[���xc��#���c��'���c��#��� d��I���Dd��'���d��!���d��=���d��7���e�� ���Ne�����Xe��d���e��W���Xf��v���f�����'g�����.g�����2g�� ���7g��3���Xg�����g�����g��"���g��7���g��<���h��Y���Wh�� ���h�����h�����h��,���h�����h�����i�����i�����$i��Y���i�����Hj��%���j��,���j�����&k�����Bk�� ���Ik�����Uk�� ���]k�����ik�����qk��N���zk�����k��?���Ul��-���l��2���l�� ���l�����m�����m�����5m�����Hm��9���Ym�����m�� ���m�� ���m��X���m��d���n��,���n��2���n��b���n��5���Fo��\���|o�� ���o��M���o��(���Hp��G���qp�����p��7���p�����q��8���q�����Uq�� ���lq��%���vq��`���q�����q�����r�����:r�����Jr�����Zr�� ���lr��&���xr��$���r�����r�����r�����r�����s�����,s��A���Ls��Z���s��-���s�����t�����6t�����St��!���ht��8���t�����t�� ���t�����t�����t��7���t��6���*u��;���au��I���u��;���u��:���#v��H���^v��9���v��G���v��2���)w��2���\w�����w��4���w�����w�����w�����x��C���x��G���bx��2���x�����x�����x�����y�����2y�����Ky�����jy�����~y�����y�����y��(���y��=���y�����%z�����6z��0���Fz�����wz�����|z��/���z�����z��*���z��&��� {�� ���3{��9���={�����w{�����{�� ���{�����{��-���{����� |�����"|��1���9|��*���k|�����|�����|��0���|��&���|����� }�����}��(���?}�����h}�����x}�����}��%���}��e���}�����>~��4���~������������Y���*��;�����.������������������'��.���B��4���q��+�����4���Ҁ��(�����4���0��W���e����������܁�������X��� ��J���e�������%����� ���ۂ������������+�����+���@�����l������� �����8�����M�����u���7���������������҄�����ل�������A��� �� ���N�����Y��6���x��I�����A��������;��0���V�������G�����N��������5�����>�����Q��.���a�������4����� ���؇��,�����3����� ���G��=���U�������r�����'���#��0���K��(���|��1�����/���׉��,�����!���4�����V�����u�������=�����+�����0�����V���G��V�����M�����R���C��$���������������N���Ռ��0���$��)���U�����������������/���Ѝ����������������9��&���P��!���w��+�����)���Ŏ��-�����-�����&���K�����r��E���z�� �����*���͏��7�����"���0��(���S�����|���������������Ԑ��"���������������4���1��4���f�������&�����;���ב������������"���!��!���D��H���f�������#��������ڒ��D�����5���'��D���]�� ���������� �����1�����E�����B���7��G���z��%���”�������#�����#���&��,���J�����w��-�����(�����D�����!���/�� ���Q��#���\��(�����#��������͖�����Ԗ�����ݖ��(�������������.��8���3�� ���l��P�����"���ޗ������������O���5����������������������%���Ș�� ����������,��� �� ���8��(���E��E���n�� �����*����������1�����7���'�����_�� ���{��������������������Ú�����ٚ�������&��������#�����;��4���@�����u��%����������c�������������5�� ���<��'���H��:���p�� �����@���̜����� ����������2��&���E��*���l��&�����W�����>�����7���U��K����� ���ٞ�� ���������� �����,�����*���/��0���Z�������%��������ϟ����������z��1�����1���D�����v��\����������'�����%���-��+���S��^�����2���ޢ��5��������G�����f�������5����������&���ϣ��#�����&�����*���A�����l�������+�����-�����%����������!���*��!���L�����n��!���������������#���ƥ��*������������������1��P���H�������)�����9�����;�����)���X������������&��������ħ�����ݧ���������������(�����E�����^�����x����������������������&������C����}���]��w���۱�� ���S�����_��/���e�������^���;��X�����K�����]���?��"���������� ���ɴ��+���״��$�����'���(��*���P�����{����������������� ����� ���Ƶ�����ҵ������������ �����"��������@�� ���S�� ���`��0���k��u����������G���1�����y��������������������ݷ�� ����������-�����6���F�����}��%�����1���ø�������8����� ��������+�����3��:���9��:���t��T���������������>���/�����n��J��������ػ��s�����@�����$���@�����e��6���|�� �����(���Խ�� ����� �������������'��D���/�����t��(���}��9�����%�����Q��������X�����a��8���w��P�����=��������?�����G��;���^��$��������������������'��� �� ���1�� ���<��Z���F��/�����/�����*�����e���,��M����������-�����^���'����������������������)�����V�����Z���I��q����������,���-�����Z��F���_��S�����I��������D�����[�����c��>���l�����������������D�����=���2��6���p��N�����P�����7���G��5�����4�����;�����*���&��;���Q��2�����&�����G�����@���/�����p��#���x��;�����)�����*��������-��>���>�����}��"���"�� ���E�����S�����n��M���q��6���������������I����0���b�� �����:��������������������F��������^�� ��r�� �����/����������a��������6��!���V�����x��{�����*��������<��I���W�� �����G�����%����������S������������� ����� �����3��)���E��E���o�� ���������������3�����'��������A�����R��Z���W������������?�����)�������+�����@�����S��1���g�� ����� ����� �����!�����%�����#�����!���?�� ���a�� ����������#�����6�����F��������e��=�����Q���+��:���}��"������������������ ����������������������������������� �����"�����4��8���G��#���������� �������������������� �����������������������'��"���/�����R�����h�����o������������7�����!����������\����� ���l�����w�� ����������5����� �����j�����H���a�������+�����;�������+�� ���=��$���G�� ���l�����v�������X�����X�����'���R��5���z��4�����%�����2��� ��]���>��}�����#�����&���>��'���e��)�����%�����|�����s���Z��b�����h���1��R�����*�����#��������<��\�����+���/��0���[��.�����N�����,��� ��'���7��A���_��<����� ����������k�����d��������x������������� ����������@���+�����l��%�����+�����@�����B�����b���b�� ���������������9�������������/�����E�����L��b���#�������&���%��*���L�����w�� ���������� ����� ���������������S��������7��S�����<���&��A���c�� ���������� ���������������D��������`�����z�������Z�����p�����6���`��=�����_�����A���5��^���w��!�����`�����1���Y��J����������<��������*��<���E������������5�����z�����;���`��$�������������������������;�����4���B��,���w��2�����0�����+�����2���4��R���g��x�����9���3��4���m��"����������(�����B��������K�����R�����d�������I�����L�����Q��� ��d���r��Q�����P���)��b���z��O�����a���-��E�����H����������C���6�����z��!����������\�����`���4�3���� ����#����$�������3� ���P����q�������������5����I��� ����W� ���j�:���x����� ����3������� �,���)�1���V�����7��������%����%��������&�9���9����s�����>����)�������� ���"�3���,�2���`�����"����2������������!���,�+���N�a���z�����8������������}����?���j �/��� �%��� �!���� �$���" �1���G �9���y �.��� �6��� �,��� �9���F �Z��� �8��� ���� � ���, �e���M �N��� ���� �!��� � ���) ����4 ����J �'���d �'��� �!��� �'��� � ��� �8����_���A�{�����������3����H����O����n�D���� ���� ����A����[���<�U����"����9�������K�O���d�R���������������'�.���7����f�8���w�����=����?�������C�I���T�!����_����+��� �@���L�,����@����;����>���7�*���v�&����#��������A��� �7���M�8����]����c����P����Y����4���+����`����h�i���~�9����.���"����Q� ���l�����?�������� ��� ����*�(���C�%���l�1����/����;����9���0�/���j� ����L��������A��� �<���M�#����+�������������������3�0���Q���������<����:��������0���8�D���i���������0����!����K�������\�)���d�����P����:����R���# ����v ���� ���� �9��� �`��� �b���A!�b���!�0���"�"���8"�*���["� ���"�3���"� ���"�8���"�1���5#�K���g#�-���#����#�(���#�0���$�)���M$����w$����~$����$�9���$����$����$�B���$�#���=%�R���a%�0���%�(���%�#���&�e���2&����&����&����&����&�,���&����'����"'�6���6'����m'�.���}'�R���'����'�4���(� ���D(�A���P(�F���(�%���(����(����)����()����@)����Q)����c)����u)�(���)����)����)�4���)���� *�#���$*����H*����O*����*����*����*�/���+�P���3+�#���+�O���+����+�!���,����#,�&���<,�*���c,�%���,�T���,�C��� -�<���M-�Z���-����-����-����-� ���.�3���.�2���G.�6���z.�#���.�#���.����.����/����/�6���L0�6���0����0�Z���0����)1�1���H1�/���z1�5���1�]���1�5���>2�7���t2�#���2����2����2�E���2����63�-���P3�(���~3�*���3�/���3�!���4����$4�4���+4�A���`4�0���4�*���4�5���4�)���45����^5�+���{5����5����5�$���5�;���5� ���(6����26����E6�X���_6� ���6�)���6�P���7�P���T7�1���7� ���7����7�.���7����*8����I8�#���h8����8�&���8� ���8�!���8����9����$9����D9�� Generate ReStructuredText using autosummary directives. sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates the reStructuredText files from the autosummary directives contained in the given input files. The format of the autosummary directive is documented in the ``sphinx.ext.autosummary`` Python module and can be read using:: pydoc sphinx.ext.autosummary � Generate documentation from source files. sphinx-build generates documentation from the files in SOURCEDIR and places it in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration settings. The 'sphinx-quickstart' tool may be used to generate template files, including 'conf.py' sphinx-build can create documentation in different formats. A format is selected by specifying the builder name on the command line; it defaults to HTML. Builders can also perform other tasks related to documentation processing. By default, everything that is outdated is built. Output only for selected files can be built by specifying individual filenames. � Generate required files for a Sphinx project. sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build. � Look recursively in <MODULE_PATH> for Python modules and packages and create one reST file with automodule directives per package in the <OUTPUT_PATH>. The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be excluded from generation. Note: By default this script will not overwrite already created files.� Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� Run 'make' in that directory to run these through makeinfo (use 'make info' here to do that automatically).� (deprecated)� (in �"::" in automodule name doesn't make sense�":file:" option for csv-table directive now recognizes an absolute path as a relative path from source directory. Please update your document.�"latex_documents" config value references unknown document %s�"man_pages" config value references unknown document %s�"quiet" is specified, but any of "project" or "author" is not specified.�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%r doesn't have "%s" setting�%r doesn't have "theme" setting�%r reference target not found: %s�%s %s�%s %s documentation�%s (%s attribute)�%s (%s property)�%s (C %s)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command %r cannot be run (needed for math display), check the imgmath_%s setting�%s command line option�%s is already assigned section numbers (nested numbered toctree?)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�%s:%s reference target not found: %s�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �-A option argument must be in the form name=value�-D option argument must be in the form name=value�4 column based index found. It might be a bug of extensions you use: %r�:%s: (directive option)�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�====================== slowest reading durations =======================�A Makefile and a Windows command file can be generated for you so that you only have to run e.g. `make html' instead of invoking sphinx-build directly.�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�A captioned autosummary requires :toctree: option. ignored.�A mocked object is detected: %r�About these documents�An error happened in rendering the page %s. Reason: %r�Anchor '%s' not found�Any IDs not assigned for %s node�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not determine the fallback text for the cross-reference. Might be a bug.�Could not fetch remote image: %s [%d]�Could not fetch remote image: %s [%s]�Could not import extension %s�Could not lex literal_block as "%s". Highlighting skipped.�Could not obtain image size. :scale: option is ignored.�Create Makefile? (y/n)�Create Windows command file? (y/n)�Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> %(sphinx_version)s.�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Duplicate C declaration, also defined at %s:%s. Declaration is '.. c:%s:: %s'.�Duplicate C++ declaration, also defined at %s:%s. Declaration is '.. cpp:%s:: %s'.�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Encoding error:�Enter the root path for documentation.�Error�Error: an existing conf.py has been found in the selected root path.�Error: specified path is not a directory, or sphinx files already exist.�Error: the master file %s has already been found in the selected root path.�Event %r already present�Example�Examples�Exception occurred while building, starting debugger:�Exception occurred:�Expand sidebar�Extension options�External Graphviz file %r not found or reading it failed�Failed to compile regex in linkcheck_allowed_redirects: %r %s�Failed to copy a file in html_static_file: %s: %r�Failed to create a cross reference. A title or caption not found: %s�Failed to create a cross reference. Any number is not assigned: %s�Failed to get a constructor signature for %s: %s�Failed to get a function signature for %s: %s�Failed to get a method signature for %s: %s�Failed to parse a default argument value for %r: %s�Failed to parse type_comment for %r: %s�Failed to read build info file: %r�Failed to read intersphinx_mapping[%s], ignored: %r�Failed to scan documents in %s: %r�Failed to update signature for %r: parameter not found: %s�Failed to write build info file: %r�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnote [#] is not referenced.�Footnote [%s] is not referenced.�Footnotes�For more information, visit <https://www.sphinx-doc.org/>.�For security reasons, parallel mode is disabled on macOS and python3.8 and above. For more details, please read https://github.com/sphinx-doc/sphinx/issues/6803�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Handler %r for event %r threw an exception�Hide Search Matches�Hint�If the documents are to be written in a language other than English, you can select a language here by its language code. Sphinx will then translate text that it generates into that language. For a list of supported codes, see https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indicate which of the following Sphinx extensions should be enabled:�Indices and tables:�Inside the root directory, two more directories will be created; "_templates" for custom HTML templates and "_static" for custom stylesheets and other static files. You can enter another prefix (such as ".") to replace the underscore.�Interrupted!�Invalid __slots__ found on %s. Ignored.�Invalid caption: %s�Invalid date format. Quote the string by single quote if you want to output it directly: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�Keyword Arguments�LaTeX command %r cannot be run (needed for math display), check the imgmath_latex setting�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Look for any errors in the above output or in %(outdir)s/output.txt�Makefile and Batchfile creation�Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Many math_renderers are registered. But no math_renderer is selected.�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Non-alphabetical�Note�Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.�Notes�Numbers�Object named %r not found in include file %r�One document is special in that it is considered the top node of the "contents tree", that is, it is the root of the hierarchical structure of the documents. Normally, this is "index", but if your "index" document is a custom template, you can also set this to another filename.�Original exception: �Other Parameters�Other changes�Output directory (%s) is not a directory�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this term�Permalink to this toctree�Pillow not found - copying image files�Please activate JavaScript to enable the search functionality.�Please also report this if it was a user error, so that a better error message can be provided next time.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter a new file name, or rename the existing file and press Enter�Please enter a new root path (or just Enter to exit)�Please enter a valid path name.�Please enter either 'y' or 'n'.�Please enter one of %s.�Please enter some text.�Please enter values for the following settings (just press Enter to accept a default value, if one is given in brackets).�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project templating�Project version�Pygments lexer name %r is not known�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Receives�Recursion error:�References�Release�Return type�Return values�Returns�Root path for the documentation�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Searching for multiple words only shows matches that contain all words.�Section %s�Section author: �See also�Selected root path: %s�Separate source and build directories (y/n)�Show Source�Since v2.0, Sphinx uses "index" as root_doc by default. Please add "root_doc = 'contents'" to your conf.py.�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Sphinx has the notion of a "version" and a "release" for the software. Each version can have multiple releases. For example, for Python the version is something like 2.5 or 3.0, while the release is something like 2.5.1 or 3.0a1. If you don't need this dual structure, just set both to the same value.�Structure options�Symbols�TODO entry found: %s�Table %s�Table of Contents�Template Parameters�Testing of coverage in the sources finished, look at the results in %(outdir)spython.txt.�Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt.�The %r crossref_type is already registered�The %r directive is already registered to domain %s�The %r index is already registered to domain %s�The %r object_type is already registered�The %r role is already registered to domain %s�The %s extension is required by needs_extensions settings, but it is not loaded.�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.�The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.�The config value `{name}' has type `{current.__name__}'; expected {permitted}.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The dummy builder generates no files.�The ePub file is in %(outdir)s.�The file name suffix for source files. Commonly, this is either ".txt" or ".rst". Only files with this suffix are considered documents.�The full traceback has been saved in %s, if you want to report the issue to the developers.�The manual pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�The overview file is in %(outdir)s.�The project name will occur in several places in the built documentation.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This can happen with very large or deeply nested source files. You can carefully increase the default Python recursion limit of 1000 in conf.py with e.g.:�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Translator for %r already exists�Unknown configure key: latex_elements[%r], ignored.�Unknown event name: %s�Unknown image format: %s...�Unknown math_renderer %r is given.�Unknown theme option: latex_theme_options[%r], ignored.�Use the Makefile to build the docs, like so: make builder�Use the sphinx-build command to build the docs, like so: sphinx-build -b builder %s %s�Variables�Warning�Warns�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�Would create file %s.�Yields�You have two options for placing the build directory for Sphinx output. Either, you use a directory "_build" within the root path, or you separate "source" and "build" directories within the root path.�You should now populate your master file %s and create other documentation source files. �Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[autosummary] failed to import %r: %s�[autosummary] generating autosummary for: %s�[autosummary] writing to %s�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.�a list of specific files to rebuild. Ignored if -a is specified�a suitable image for %s builder not found: %s�a suitable image for %s builder not found: %s (%s)�alias of %s�alias of TypeVar(%s)�all functions, classes, terms�all of %d po files�all source files�append module_path to sys.path, used when --full is given�assembling single document�attribute�author names�autodoc: failed to determine %r to be documented, the following exception was raised: %s�autodoc_member_order now accepts "alphabetical" instead of "alphabetic". Please update your setting.�automatically insert docstrings from modules�automatically test code snippets in doctest blocks�autosummary generats .rst files internally. But your source_suffix does not contain .rst. Skipped.�autosummary references excluded document %r. Ignored.�autosummary: failed to determine %r to be documented, the following exception was raised: %s�autosummary: failed to import %s�autosummary: stub file not found %r. Check your autosummary_generate setting.�autosummary_generate: file not found: %s�both tabularcolumns and :widths: option are given. :widths: is ignored.�broken link: %s (%s)�build %s, %s warning (with warnings treated as errors).�build %s, %s warning.�build %s, %s warnings (with warnings treated as errors).�build %s, %s warnings.�build %s.�build environment version not current�build in parallel with N processes where possible (special value "auto" will set N to cpu-count)�build info file is broken: %r�builder to use (default: html)�building [%s]: �building [mo]: �built-in function�can be huge�cannot combine -a option and filenames�cannot copy downloadable file %r: %s�cannot copy extra file %r�cannot copy image file %r: %s�cannot copy static file %r�cannot find files %r�cannot open warning file %r: %s�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�cannot read image file %r: copying it instead�cannot write image file %r: %s�caption not inside a figure.�checking consistency�checks for documentation coverage�circular toctree references detected, ignoring: %s <- %s�class�class method�command line option�concept�conditional inclusion of content based on config values�conf value "epub_author" should not be empty for EPUB3�conf value "epub_contributor" should not be empty for EPUB3�conf value "epub_copyright" (or "copyright")should not be empty for EPUB3�conf value "epub_description" should not be empty for EPUB3�conf value "epub_identifier" should not be empty for EPUB3�conf value "epub_language" (or "language") should not be empty for EPUB3�conf value "epub_publisher" should not be empty for EPUB3�conf value "epub_title" (or "html_title") should not be empty for EPUB3�conf value "epub_uid" should be XML NAME for EPUB3�conf value "version" should not be empty for EPUB3�config changed�config directory doesn't contain a conf.py file (%s)�console output options�continued from previous page�continues on next page�convert command %r cannot be run, check the image_converter setting�convert command %r cannot be run, check the image_converter setting: %s�convert exited with error: [stderr] %r [stdout] %r�copying TeX support files�copying TeX support files...�copying Texinfo support files�copying additional files�copying downloadable files... �copying extra files�copying images... �copying source files...�copying static files�could not read %r for changelog creation�create .nojekyll file to publish the document on GitHub pages�create batchfile�create makefile�custom template directory (default: %(default)s)�data�default role %s not found�default suffix for files (default: %(default)s)�define a template variable�define tag: include "only" blocks with TAG�dimension unit %s is invalid. Ignored.�directive�directive %r is already registered, it will be overridden�directive-option�directory to place all output�directory to place all output in�display latex %r: %s�do emit colored output (default: auto-detect)�do not create batchfile�do not create makefile�do not emit colored output (default: auto-detect)�do not use make-mode for Makefile/make.bat�docnames to write: %s�document�document imported members (default: %(default)s)�document isn't included in any toctree�document language�document not readable. Ignored.�document title is not a single Text node�doing serial %s�domain %s already registered�domain %s not yet registered�don't create a table of contents file�don't create headings for the module/package packages (e.g. when the docstrings already contain them)�don't know which module to import for autodocumenting %r (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)�don't use a saved environment, always read all files�done�dot code %r: %s�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�dot did not produce an output file: [stderr] %r [stdout] %r�dot exited with error: [stderr] %r [stdout] %r�download file not readable: %s�dumping object inventory�dumping search index in %s�duplicate %s description of %s, other %s in %s�duplicate %s description of %s, other instance in %s�duplicate citation %s, other instance in %s�duplicate description of %s %s, other instance in %s�duplicate label %s, other instance in %s�duplicate label of equation %s, other instance in %s�duplicate object description of %s, other instance in %s, use :noindex: for one of them�duplicated ToC entry found: %s�enable %s extension�enable arbitrary extensions�encountered some issues with some of the inventories, but they had working alternatives:�encountered title node not in section, topic, table, admonition or sidebar�enum�enumerable_node %r already registered�enumerator�environment variable�environment variable; %s�error while formatting arguments for %s: %s�error while formatting signature for %s: %s�error writing file %s: %s�error writing file Makefile: %s�exception�exception while evaluating only directive expression: %s�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extension options�extensions changed�failed�failed to import object %s�failed to parse name %s�failed to reach any of the inventories with the following issues:�failed: %s�favicon file %r does not exist�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�filename of table of contents (default: modules)�finished with problems�fnmatch-style file and/or directory patterns to exclude from generation�follow symbolic links. Powerful when combined with collective.recipe.omelette.�function�function parameter�general options�generate a full project with sphinx-quickstart�generating indices�glossary seems to be misformatted, check indentation�glossary term�glossary term must be preceded by empty line�glossary terms must not be separated by empty lines�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�highlighting module code... �html_add_permalinks has been deprecated since v3.5.0. Please use html_permalinks and html_permalinks_icon instead.�html_extra_path entry %r does not exist�html_extra_path entry %r is placed inside outdir�html_static_path entry %r does not exist�html_static_path entry %r is placed inside outdir�if specified, create build dir under source dir�if specified, separate source and build dirs�ignoring invalid doctest code: %r�image file %s not readable: %s�image file not readable: %s�include "_private" modules�include links to the source code of documented Python objects�include math, rendered as PNG or SVG images�include math, rendered in the browser by MathJax�inconsistent citation references in translated message. original: {0}, translated: {1}�inconsistent footnote references in translated message. original: {0}, translated: {1}�inconsistent references in translated message. original: {0}, translated: {1}�inconsistent term references in translated message. original: {0}, translated: {1}�increase verbosity (can be repeated)�index�inline latex %r: %s�interpret module paths according to PEP-0420 implicit namespaces specification�intersphinx identifier %r is not string. Ignored�intersphinx inventory has moved: %s -> %s�invalid TestCode type�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�invalid regex %r in %s�invalid regex %r in coverage_c_regexes�invalid signature for auto%s (%r)�invalid value for class-doc-from option: %s�invalid value for member-order option: %s�invalid value set (missing closing brace): %s�invalid value set (missing opening brace): %s�job number should be a positive number�keyword�kwargs for add_node() must be a (visit, depart) function tuple: %r=%r�last updated�line number spec is out of range(1-%d): %r�link between Sphinx documentation of different projects�lists all sections and subsections�loading intersphinx inventory from %s...�loading pickled environment�loading translations [%s]... �locale_dir %s does not exists�logo file %r does not exist�looking for now-outdated files... �macro�making output directory�malformed string literal (missing closing quote): %s�malformed string literal (missing opening quote): %s�master document name�math renderer %s is already registered�maximum depth of submodules to show in the TOC (default: 4)�member�method�missing '+' or '-' in '%s' option.�missing attribute %s in object %s�missing attribute mentioned in :members: option: module %s, attribute %s�module�module %s could not be imported: %s�modules�more than one target found for 'any' cross-reference %r: could be %s�more than one target found for cross-reference %r: %s�multiple files found for the document "%s": %r Use %r for the build.�new config�next�next chapter�nit-picky mode, warn about all missing references�no "latex_documents" config value found; no documents will be written�no "man_pages" config value found; no manual pages will be written�no "texinfo_documents" config value found; no documents will be written�no Babel option known for language %r�no changes in version %s.�no code/output in %s block at %s:%s�no output at all, not even warnings�no output on stdout, just warnings on stderr�no targets are out of date.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�non-whitespace stripped by dedent�none found�not available for built-in messages�numfig is disabled. :numref: is ignored.�numfig_format is not defined for %s�object�operator�original entry�override a setting in configuration file�overwrite existing files�page�page %s matches two patterns in html_sidebars: %r and %r�pass a value into HTML templates�path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)�path to documentation source files�path to module to document�path to output directory�path where configuration file (conf.py) is located (default: same as SOURCEDIR)�pickling environment�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�program option�project author(s), used when --full is given�project name�project name (default: root module name)�project release, used when --full is given, defaults to --doc-version�project root�project version, used when --full is given�property�put documentation for each module on its own page�put module documentation before submodule documentation�quick access to all modules�quiet mode�reST markup error:�reading error: %s, %s�reading sources... �reading templates... �reference label�release of project�replacement for dot in _templates etc.�resolving references...�role�role %r is already registered, it will be overridden�run Pdb on exception�run the script without creating files�search�search index couldn't be loaded, but not all documents will be built: the index will be incomplete.�search this documentation�see %s�see also %s�self referenced toctree found. Ignored.�setting %s.%s occurs in none of the searched theme configs�show full traceback on exception�signature arguments or return annotation given for automodule %s�skipped�source directory has changed�source file suffix�source files to generate rST files for�source_parser for %r is already registered�source_suffix %r is already registered�sphinx-quickstart only generate into a empty directory. Please specify a new root path.�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0�statement�static method�struct�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�targets for %d template files�template directory for template files�template parameter�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension is not safe for parallel reading�the %s extension is not safe for parallel writing�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�toctree contains ref to nonexisting file %r�toctree contains reference to document %r that doesn't have a title: no link will be generated�toctree contains reference to excluded document %r�toctree contains reference to nonexisting document %r�too large :maxdepth:, ignored.�turn warnings into errors�type�undecodable source characters, replacing with "?": %r�undefined label: %s�undocumented c api: %s [%s] in file %s�undocumented python class: %s :: %s�undocumented python function: %s :: %s�undocumented python method: %s :: %s :: %s�unimplemented node type: %r�union�unknown %r toplevel_sectioning for class %r�unknown config value %r in override, ignoring�unknown directive or role name: %s:%s�unknown index entry type %r�unknown index entry type %s found�unknown mimetype for %s, ignoring�unknown node type: %r�unsupported theme option %r given�updating environment: �use epub�use make-mode for Makefile/make.bat�use no config file at all, only -D options�variable�version of project�waiting for workers...�where "builder" is one of the supported builders, e.g. html, latex or linkcheck.�while setting up extension %s:�with -W, keep going when getting warnings�write "todo" entries that can be shown or hidden on build�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing�writing %s file...�writing META-INF/container.xml file...�writing additional files�writing additional pages�writing content.opf file...�writing error: %s, %s�writing message catalogs... �writing mimetype file...�writing nav.xhtml file...�writing output... �writing summary file...�writing toc.ncx file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: pt_BR Language-Team: Portuguese (Brazil) (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt_BR/) Plural-Forms: nplurals=2; plural=(n > 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � Gera ReStructuredText usando diretivas de resumo automático. sphinx-autogen é um frontend para sphinx.ext.autosummary.generate. Ele gera os arquivos reStructuredText a partir de diretivas autosummary contidas nos arquivos de entrada fornecidos. O formato da diretiva autosummary está documentado no módulo Python ``sphinx.ext.autosummary`` e pode ser lido usando: pydoc sphinx.ext.autosummary � Gera documentação de arquivos fonte. sphinx-build gera documentação a partir dos arquivos em SOURCEDIR e os coloca em OUTPUTDIR. Ele procura por "conf.py" em SOURCEDIR para a configuração definições. A ferramenta "sphinx-quickstart" pode ser usada para gerar arquivos de modelo, incluindo "conf.py" sphinx-build pode criar documentação em diferentes formatos. Um formato é selecionado especificando o nome do construtor na linha de comandos; o padrão é HTML. Os construtores também podem realizar outras tarefas relacionadas à documentação em processamento. Por padrão, tudo o que está desatualizado é construído. Saída apenas para selecionado os arquivos podem ser construídas especificando nomes de arquivos individuais. � Gera os arquivos necessários para um projeto Sphinx. O sphinx-quickstart é uma ferramenta interativa que faz algumas perguntas sobre o seu projeto e gera um diretório de documentação completo e um Makefile de amostra para ser usado com o sphinx-build. � Procura recursivamente em <MODULE_PATH> módulos e pacotes Python e cria um arquivo reST com diretivas automodule por pacote no <OUTPUT_PATH>. Os <EXCLUDE_PATTERN>s podem ser padrões de arquivo e/ou diretório que serão excluídos da geração. Nota: Por padrão, este script não substituirá os arquivos já criados.� Execute "make" nesse diretório para executá-los com (pdf)latex (use "make latexpdf" aqui para fazer isso automaticamente).� Execute "make" nesse diretório para executá-los com makeinfo (use "make info" aqui para fazer isso automaticamente).� (obsoleto)� (em �“::” no nome de automodule não faz sentido�A opção ":file:" para a diretiva csv-table agora reconhece um caminho absoluto como um caminho relativo do diretório de fontes. Por favor, atualize seu documento.�o valor da configuração “latex_documents” faz referência a um documento desconhecido %s�o valor da configuração “man_pages” faz referência a um documento desconhecido %s�“quiet” está especificada, mas “project” ou “author” não foi.�o valor da configuração “texinfo_documents” faz referência a documento desconhecido %s�%(filename)s — %(docstitle)s�%d %b %Y�%d encontrado�%d arquivos-fonte dados na linha de comando�%r não possui a configuração "%s"�%r não possui a configuração "theme"�alvo de referência %r não encontrado: %s�%s %s�documentação %s %s�%s (atributo %s)�%s (propriedade %s )�%s (C %s)�%s (C++ %s)�%s (classe interna)�%s (variável interna)�%s (classe em %s)�%s (diretiva)�%s (variável global ou constante)�%s (no módulo %s)�%s (módulo)�%s (papel)�%s adicionado(s), %s alterado(s), %s removido(s)�o comando %s %r não pode ser executado (necessário para exibir matemáticas), verifique a configuração imgmath_%s�%s opção de linha de comando�%s já tem números de seção atribuídos (toctree numerada aninhada?)�%s não é um diretório.�%s() (método de classe %s)�%s() (método %s)�%s() (método estático %s)�%s() (função interna)�%s() (classe)�%s() (no módulo %s)�%s:alvo de referência %s não encontrado: %s�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�“%s” não é uma opção válida.�“%s” não é uma opção de pyversion válida�“setup”, conforme definido atualmente em conf.py, não é um invocável do Python. Modifique sua definição para torná-la uma função que pode ser chamada. Isso é necessário para o conf.py se comportar como uma extensão do Sphinx.�(A <<original entry>> está localizada na %s, linha %d.)�(em %s v%s)�(em %s)�, em �o argumento da opção -A deve estar no formato nome=valor�o argumento da opção -D deve estar no formato nome=valor�Um índice de 4 colunas encontrado. Pode ser um erro de extensões que você usa: %r�:%s: (opção diretiva)�<<original entry>>�<h1>Todos os módulos onde este código está disponível</h1>�<h1>Código fonte para %s</h1>�=================== durações de leitura mais lentas ====================�Um Makefile e um arquivo de comando do Windows podem ser gerados para você, para que você só precise executar, p.ex., "make html" em vez de invocar o sphinx-build diretamente.�Um relatório de erro pode ser preenchido no rastreador em <https://github.com/sphinx-doc/sphinx/issues>. Obrigado!�Um autosummary com legenda requer a opção :toctree:. Ignorado.�Um objeto simulado foi detectado: %r�Sobre esses documentos�Ocorreu um erro ao renderizar a página %s. Motivo: %r�Âncora “%s” não encontrada�Quaisquer IDs não atribuídos ao nó %s�Argumentos�Atenção�Nome(s) de autor(es)�Autor: �Lista de alterações na versão %(version)s, gerada automaticamente�Base: %s�Compilador %r já existe (no módulo %s)�Classe de compilador %s possui nenhum atributo “name”�Nome do compilador %s não registrado�Nome do compilador %s não registrado ou disponível através do ponto de entrada�Internos�Alterações na API C�Não foi possível encontrar o diretório de origem (%s)�Não é possível usar “lineo-match” com um conjunto separado de “lines”�Não é possível usar as opções “%s” e “%s” juntas�Cuidado�Alterado na versão %s�Modificações na versão %(version)s — %(docstitle)s�citação [%s] não é referenciada.�Autor do código: �Recolher painel lateral�Tabela Completa dos Conteúdos�Valor da configuração %r já presente�Conteúdos�Copyright�Não foi possível determinar o texto reserva para a referência cruzada. Pode ser um bug.�Não foi possível obter imagem remota: %s [%d]�Não foi possível obter imagem remota: %s [%s]�Não foi possível importar a extensão %s�Não foi possível fazer análise léxica de literal_block como “%s”. Realce de sintaxe ignorado.�Não foi possível obter o tamanho da imagem. A opção :scale: foi ignorada.�Criar um Makefile? (y/n)�Criar um arquivo de comando do Windows? (y/n)�Criada usando <a href="https://www.sphinx-doc.org/pt_BR/master">Sphinx</a> %(sphinx_version)s.�Criando o arquivo %s.�Perigo�Obsoleto�Obsoleto desde a versão %s�O domínio %r ainda não está registrado�Declaração C duplicada, também definida em %s:%s. A declaração é '.. c:%s:: %s'.�Declaração C++ duplicada, também definida em %s:%s. A declaração é '.. cpp:%s:: %s'.�A codificação %r usada para ler o arquivo incluído %r parece estar errada, tente passar uma opção :encoding:�Erro de codificação:�Insira o caminho raiz para a documentação.�Erro�Erro: um conf.py existente foi encontrado no caminho raiz selecionado.�Erro: o caminho especificado não é um diretório, ou arquivos sphinx já existem.�Erro: o arquivo mestre %s já foi encontrado no caminho raiz selecionado.�Evento %r já presente�Exemplo�Exemplos�Ocorreu uma exceção enquanto compilava, iniciando depurador:�Ocorreu uma exceção:�Expandir painel lateral�Opções extensão�Arquivo externo de Graphviz %r não encontrado ou sua leitura falhou�Falha ao compilar regex em linkcheck_allowed_redirects: %r %s�Falha ao copiar um arquivo em html_static_file: %s: %r�Falha ao criar uma referência cruzada. Título ou legenda não encontrado: %s�Falha ao criar uma referência cruzada. Qualquer número não foi atribuído: %s�Falha ao obter uma assinatura de construtor para %s: %s�Falha ao obter uma assinatura de função para %s: %s�Falha ao obter uma assinatura de método para %s: %s�Falha ao analisar um valor de argumento padrão para %r: %s�Falha ao analisar type_comment para %r: %s�Falha ao ler o arquivo de informações de compilação: %r�Falha ao ler intersphinx_mapping[%s], ignorado: %r�Falha ao procurar documentos em %s: %r�Falha ao atualizar a assinatura para %r: parâmetro não encontrado: %s�Falha ao escrever o arquivo de informações de compilação: %r�Fig. %s�O arquivo %s já existe, ignorando.�Finalizado: uma estrutura de diretório inicial foi criada.�Nota de rodapé [#] não é referenciada.�Nota de rodapé [%s] não é referenciada.�Notas de rodapé�Para mais informações, visite <https://www.sphinx-doc.org/>.�Por motivo de segurança, o modo paralelo está desabilitado no macOS e python3.8 e acima. Para mais detalhes, leia https://github.com/sphinx-doc/sphinx/issues/6803�Índice completo em página única�Índice Geral�Índice Global de Módulos�Ir�A diretiva de Graphviz não pode ter conteúdo e argumento de nome de arquivo�O manipulador %r para evento %r levantou uma exceção�Esconder Resultados da Busca�Dica�Se os documentos forem escritos em um idioma diferente do inglês, você pode selecionar um idioma aqui pelo seu código de idioma. O Sphinx, então, traduzirá o texto gerado para esse idioma. Para obter uma lista dos códigos suportados, consulte https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Ignorando diretiva “graphviz” sem conteúdo.�Importante�Arquivo incluído %r não encontrado ou sua leitura falhou�Índice�Índice – %(key)s�Páginas de índice por letra�Indique qual das seguintes extensões do Sphinx devem ser habilitadas:�Índices e Tabelas:�Dentro do diretório raiz, mais dois diretórios serão criados; "_templates" para modelos HTML personalizados e "_static" para folhas de estilo (CSS) personalizadas e outros arquivos estáticos. Você pode inserir outro prefixo (como ".") para substituir o sublinhado.�Interrompido!�__slots__ inválido encontrado em %s. Ignorado.�Legenda inválida: %s�Formato de data inválido. Envolva a string com aspas simples se desejar emiti-la diretamente: %s�math_eqref_format inválido: %r�Variável de modelo inválida: %s�Argumentos de Palavras-chave�o comando LaTeX %r não pode ser executado (necessário para exibir matemáticas), verifique a configuração imgmath_latex�Última atualização em %(last_updated)s.�Alterações na biblioteca�Especificação de linha %r: nenhuma linha obtida do arquivo incluído %r�Listagem %s�Procure por quaisquer erros na saída acima ou em %(outdir)s/output.txt�Criação de Makefile e arquivo Batch�Descrição de opção %r malformada, deve se parecer com “opt”, “-opt args”, “--opt args”, “/opt args” ou “+opt args”�Muitos math_renders estão registrados, mas nenhum math_renderer está selecionado.�Índice do Módulo�Autor do módulo: �Código do módulo�Nível do Módulo�Nome do seu documento mestre (sem sufixo)�Prefixo do nome para o diretório de modelos e de arquivos estáticos�Navegação�Novo na versão %s�Próximo tópico�Nenhum compilador selecionado, usando padrão: html�Valor de configuração inexistente: %s�Não alfabético�Nota�Nota: imgmath e mathjax não podem ser habilitados ao mesmo tempo. imgmath foi desmarcado.�Notas�Números�O objeto chamado %r não foi encontrado no arquivo incluído %r�Um documento é especial por ser considerado o nó superior da "árvore de conteúdo", ou seja, é a raiz da estrutura hierárquica dos documentos. Normalmente, isso é "index", mas se o documento "index" for um modelo personalizado, você também poderá configurá-lo para outro nome de arquivo.�Extensão original: �Outros Parâmetros�Outras alterações�O diretório de saída (%s) não é um diretório�Visão geral�Visão geral: código do módulo�Parâmetros�Link Permanente para esse código�Link permanente para esta definição�Link permanente para essa equação�Link permanente para este título�Link Permanente para essa imagem�Link Permanente para essa tabela�Link permanente para este termo�Link permanente para esse "toctree"�Pillow não encontrado – copiando arquivos de imagem�Por favor, ativar JavaScript para habilitar a funcionalidade de busca.�Por favor, relate isso também se houver um erro do usuário, para que uma mensagem de erro melhor possa ser fornecida na próxima vez.�Insira um sufixo de arquivo, p.ex., “.rst” ou “.txt”.�Insira um novo nome de arquivo, ou renomeie o arquivo existente e pressione Enter�Insira um novo caminho raiz (ou pressione Enter para sair)�Insira um nome de caminho válido.�Insira “y” ou “n”.�Insira um entre %s.�Insira algum texto.�Digite valores para as seguintes configurações (basta pressionar Enter para aceitar um valor padrão, se houver um entre colchetes).�Preparando a busca...�Tópico anterior�Opções básicas do projeto�Idioma do projeto�Nome do projeto�Lançamento do projeto�Modelo de projeto�Versão do projeto�Nome de analisador léxico Pygments %r não é conhecido�Propostas Estendidas Python; PEP %s�Índice de Módulos Python�Busca rápida�Levanta�Recebe�Erro de recursão:�Referências�Release�Tipo de retorno�Valores de retorno�Retorna�Caminho raiz para a documentação�Executando Sphinx v%s�Buscar�Buscar em %(docstitle)s�Página de Busca�Resultados da Busca�Busca concluída. %s página(s) que atendem a consulta.�Pesquisar dentro de %(docstitle)s�Buscando�Pesquisando por várias palavras só mostra correspondências que contêm todas as palavras.�Seção %s�Autor da seção: �Ver também�Caminho raiz selecionado: %s�Separar os diretórios de origem e compilação (y/n)�Exibir Fonte�Desde v2.0, Sphinx usa "index" como root_doc por padrão. Adicione "root_doc = 'contents'" ao seu conf.py.�Diretório de origem e o diretório de destino não podem ser idênticos�Sufixo de arquivos-fonte�Analisador de fonte para %s não registrado�O Sphinx tem a noção de uma "versão" e um "lançamento" para o software. Cada versão pode ter vários lançamentos. Por exemplo, para Python a versão é algo como 2.5 ou 3.0, enquanto o lançamento é algo como 2.5.1 ou 3.0a1. Se você não precisa dessa estrutura dupla, apenas defina ambos com o mesmo valor.�Opção Estrutura�Símbolos�Entrada de “TODO” encontrada: %s�Tabela %s�Tabela de Conteúdo�Parâmetros do Modelo�Teste de cobertura nos fontes finalizada, confira os resultados em %(outdir)spython.txt.�Teste de doctests nos fontes finalizada, confira os resultados em %(outdir)s/output.txt.�O crossref_type %r já está registrado�A diretiva %r já está registrada para o domínio %s�O índice %r já está registrado para o domínio %s�O object_type %r já está registrado�O papel %r já está registrado para o domínio %s�A extensão %s é requerida pelas configurações needs_extensions, mas não está carregada.�A extensão %s usada por este projeto precisa de pelo menos Sphinx v%s e, portanto, não pode ser compilada com esta versão.�A página HTML está em %(outdir)s.�As páginas HTML estão em %(outdir)s.�Os arquivos LaTeX estão em %(outdir)s.�Os arquivos Texinfo estão em %(outdir)s.�Os arquivos XML estão em %(outdir)s.�O valor da configuração “source_suffix” espera uma string, lista de strings ou dicionário. Mas “%r” é fornecido.�O valor da configuração “{name}” possui tipo “{current.__name__}”; o padrão é “{default.__name__}”.�O valor da configuração “{name}” possui tipo “{current.__name__}”; esperava {permitted}.�O valor da configuração “{name}” deve ser um entre {candidates}, mas “{current}” é fornecido.�O arquivo de configuração (ou um dos módulos que ele importa) chamou sys.exit()�O compilador fictício não gera arquivos.�O arquivo ePub está em %(outdir)s.�O sufixo do nome de arquivo para arquivos fonte. Normalmente, isso é ".txt" ou ".rst". Apenas arquivos com este sufixo são considerados documentos.�O rastro completo foi salvo em %s, caso você queira relatar o problema aos desenvolvedores.�As páginas de manual estão em %(outdir)s.�Os catálogos de mensagens estão em %(outdir)s.�O arquivo de visão geral está em %(outdir)s.�O nome do projeto vai aparecer em vários lugares na documentação compilada.�Os arquivos pseudo-XML estão em %(outdir)s.�Os arquivos texto estão em %(outdir)s.�Há um erro de programável em seu arquivo de configuração: %s�Há um erro de sintaxe em seu arquivo de configuração: %s �Essa Página�Isso pode acontecer com arquivos fonte muito grande e profundamente aninhados. Você pode aumentar com cuidado o limite padrão de recursão do Python de 1000 no conf.py com, por exemplo:�Este ambiente é incompatível com o compilador selecionado, por favor escolha outro diretório de doctree.�Este projeto precisa de pelo menos Sphinx v%s e, portanto, não pode ser compilado com esta versão.�Este projeto precisa da extensão %s pelo menos na versão %s e, portanto, não pode ser compilado com a versão carregada (%s).�Lança�Dica�Por fazer�Tradutor para %r já existe�Chave configuração desconhecida: latex_elements[%r], ignorado.�Nome de evento desconhecido: %s�Formato de imagem desconhecido: %s…�math_renderer desconhecido %r é fornecido.�Opção de tema desconhecida: latex_theme_options[%r], ignorada.�Use o Makefile para compilar os documentos, assim: make builder�Use o comando sphinx-build para compilar os documentos, assim: sphinx-build -b compilador %s %s�Variáveis�Aviso�Avisos�Bem-vindo ao utilitário de início rápido do Sphinx %s.�Bem Vindo! É isso aí.�Criaria o arquivo %s.�Yields�Você tem duas opções para definir o diretório de compilação para a saída Sphinx. Você pode usar um diretório "_build" no caminho raiz ou separar os diretórios de "origem" e "compilação" no caminho raiz.�Agora você deve preencher seu arquivo mestre %s e criar outros arquivos-fonte da documentação. �Sua busca não encontrou nenhum documento. Por favor, confirme se todas as palavras estão grafadas corretamente e se você selecionou categorias suficientes.�[autosummary] falha ao importar %r: %s�[autosummary] gerando autosummary para: %s�[autosummary] escrevendo em %s�[documentos]�[gráfico: %s]�[gráfico]�[imagem: %s]�[imagem]�[código fonte]�__all__ deve ser uma lista de strings, não %r (no módulo %s) -- ignorando __all__�ocorreu um erro Unicode ao renderizar a página %s. Verifique se todos os valores de configuração que contêm conteúdo não ASCII são strings Unicode.�uma lista de arquivos específicos para recompilar. Ignorado se -a for especificado�uma imagem adequada para o compilador %s não encontrada: %s�uma imagem adequada para o compilador %s não encontrada: %s (%s)�apelido de %s�apelido de TypeVar(%s)�todas funções, classes, termos�todos os %d arquivos po�todos os arquivos-fonte�acrescenta module_path a sys.path, usando quando --full é fornecido�montando documento único�atributo�nomes de autores�autodoc: falhou em determinar %r a ser documentado, a seguinte exceção foi levantada: %s�autodoc_member_order agora aceita "alphabetical" em vez de "alphabetic". Por favor, atualize sua configuração.�insere docstrings automaticamente a partir de módulos�testa trechos de código automaticamente em blocos de doctest�autosummary gera arquivos .rst internamente. Mas seu source_suffix não contém .rst. Ignorado.�referências de autosummmary excluíram o documento %r. Ignorado.�autosummary: falhou em determinar %r a ser documentado, a seguinte exceção foi levantada: %s�autosummary: falha ao importar %s�autosummary: arquivo stub não encontrado %r. Verifique sua configuração autosummary_generate.�autosummary_generate: arquivo não encontrado: %s�tabularcolumns e opção :widths: foram fornecidas. :widths: foi ignorada.�link quebrado: %s (%s)�compilação %s, %s aviso. (com avisos tratados como erros).�compilação %s, %s aviso.�compilação %s, %s avisos (com avisos tratados como erros).�compilação %s, %s avisos.�compilação %s.�a versão do ambiente de compilação não é a atual�compila em paralelo com N processos onde possível (o valor especial “auto” será definido com N para número de CPUs)�arquivo de informações da compilação está quebrado: %r�compilador para usar (padrão: html)�compilando [%s]: �compilando [mo]: �função interna�pode ser enorme�não é possível combinar a opção -a e nomes de arquivos�não foi possível copiar o arquivo baixável %r: %s�não foi possível copiar o arquivo extra %r�não foi possível copiar arquivo de imagem %r: %s�não foi possível copiar o arquivo estático %r�não foi possível localizar os arquivos %r�não foi possível abrir o arquivo de aviso %r: %s�não é possível sobrescrever a configuração %r com tipo sem suporte, ignorando�não foi possível sobrescrever a configuração do dicionário %r ignorando (use %r para definir elementos individuais)�não foi possível ler o arquivo de imagem %r: copiando-o�não foi possível escrever arquivo de imagem %r: %s�legenda não dentro de uma imagem.�verificando consistência�verifica por cobertura da documentação�referências circulares à toctree detectadas, ignorando: %s <- %s�classe�método de classe�opção de linha de comando�conceito�inclusão condicional de conteúdo com base nos valores de configuração�o valor da configuração “epub_author” não deve estar vazio para EPUB3�o valor da configuração “epub_contributor” não deve estar vazio para EPUB3�o valor da configuração “epub_copyright” (ou “copyright”) não deve estar vazio para EPUB3�o valor da configuração “epub_description” não deve estar vazio para EPUB3�o valor da configuração “epub_identifier” não deve estar vazio para EPUB3�o valor da configuração “epub_language” (ou “language”) não deve estar vazio para EPUB3�o valor da configuração “epub_publisher” não deve estar vazio para EPUB3�o valor da configuração “epub_title” (ou “html_title”) não deve estar vazio para EPUB3�o valor da configuração “epub_uid” deve ser XML NAME para EPUB3�o valor da configuração “version” não deve estar vazio para EPUB3�configuração alterada�o diretório de configuração não contém um arquivo conf.py (%s)�opções de saída do console�continuação da página anterior�continua na próxima página�comando de conversão %r não pode ser executado, verifique a configuração image_converter�comando de conversão %r não pode ser executado, verifique a configuração image_converter: %s�convert encerrado com erro: [stderr] %r [stdout] %r�copiando arquivos de suporte TeX�copiando arquivos de suporte TeX…�copiando arquivos de suporte Texinfo�copiando arquivos adicionais�copiando arquivos baixáveis… �copiando arquivos extras�copiando imagens… �copiando arquivos-fonte…�copiando arquivos estáticos�não foi possível ler %r para criação do changelog�cria um arquivo .nojekyll para publicar o documento em páginas do GitHub�cria arquivo batch�cria makefile�diretório de modelos personalizado (padrão: %(default)s)�dado�papel padrão %s não encontrado�sufixo padrão para arquivos (padrão: %(default)s)�define uma variável modelo�define tag: inclui blocos “only” com TAG�a unidade de dimensão %s é inválida. Ignorada.�diretiva�diretiva %r já está registrada, ela será sobrescrita�opção diretiva�diretório para colocar toda a saída�diretório para colocar toda a saída�exibe latex %r: %s�emite saída colorida (padrão: detectar automaticamente)�não cria arquivo batch�não cria makefile�não emite saída colorida (padrão: detectar automaticamente)�não usa modo make para Makefile/make.bat�docnames para escrever: %s�documento�documenta membros importados (padrão: %(default)s)�o documento não está incluído em nenhum toctree�idioma dos documentos�documento não legível. Ignorado.�título do documento não é um nó único em Text�fazendo serial %s�domínio %s já registrado�domínio %s ainda não registrado�não cria um arquivo de tabela de conteúdo�não cria títulos para os pacotes de módulo/pacote (p.ex., quando as docstrings já os contêm)�não sei qual módulo importar para documentação automática %r (tente colocar uma diretiva “module” ou “currentmodule” no documento ou forneça um nome explícito para o módulo)�não usa um ambiente salvo, sempre lê todos os arquivos�feito�código DOT %r: %s�comando de DOT %r não pode ser executado (necessário para a saída do graphviz), verifique a configuração do graphviz_dot�DOT não produziu um arquivo de saída: [stderr] %r [stdout] %r�DOT encerrado com erro: [stderr] %r [stdout] %r�arquivo de download não legível: %s�despejando inventário de objetos�despejando índice de pesquisa em %s�descrição duplicada de %s de %s, outro %s em %s�descrição duplicada de %s de %s, outra instância em %s�citação duplicada %s, outra instância em %s�descrição duplicada de %s %s, outra instância em %s�rótulo duplicada %s, outra instância em %s�rótulo duplicado da equação %s, outra instância em %s�descrição duplicada de objeto de %s, outra instância em %s, use :noindex: para um deles�entrada de tabela de conteúdos duplicada encontrada: %s�habilita a extensão %s�habilita extensões arbitrárias�encontrados alguns problemas com alguns dos inventários, mas eles tem alternativas em funcionamento:�nó de título encontrado não na section, topic, table, admonition ou sidebar�enum�enumerable_node %r já registrado�enumerador�váriavel de ambiente�váriavel de ambiente; %s�erro ao formatar argumentos para %s: %s�erro ao formatar assinatura para %s: %s�erro ao escrever o arquivo %s: %s�erro ao escrever o arquivo Makefile: %s�exceção�exceção ao avaliar apenas a expressão da diretiva: %s�a extensão %r possui nenhuma função setup(); é realmente um módulo de extensão do Sphinx?�a extensão %r retornou um objeto não suportado de sua função setup(); deve retornar None ou um dicionário de metadados�opções de extensão�extensões alteradas�falhou�falha ao importar o objecto %s�falha ao analisar o nome %s�falha ao alcançar todos os inventários com os seguintes problemas:�falha: %s�o arquivo favicon %r não existe�o arquivo %r fornecido na linha de comando não existe, ignorando�o arquivo %r fornecido na linha de comando não está dentro do diretório fonte, ignorando�o arquivo %r no caminho de tema não é um arquivo zip válido ou contém nenhum tema�sufixo dos arquivos (padrão: rst)�nome de arquivo da tabela de conteúdo (padrão: modules)�finalizada com problemas�padrões de diretório e/ou arquivo no estilo fnmatch para excluir da geração�segue links simbólicos. Poderoso quando combinado com collective.recipe.omelette.�função�parâmetro de função�opções gerais�gera um projeto completo com sphinx-quickstart�gerando índices�o glossário parece estar mal formatado, confira o recuo�Glossário de Termos�um termo de glossário deve ser precedido por uma linha vazia�termos de glossário não devem ser separados por linhas vazias�termo gramatical�graphviz_output_format deve ser um entre “png” e “svg”, mas é %r�realçando código de módulo… �html_add_permalinks foi descontinuado desde v3.5.0. Use html_permalinks e html_permalinks_icon.�a entrada de html_extra_path %r não existe�entrada de html_extra_path %r está posicionada dentro de outdir�a entrada de html_static_path %r não existe�entrada de html_static_path %r está posicionada dento de outdir�se especificado, cria o dir de construção sob o dir fonte�se especificado, separa diretórios de fonte e de compilação�ignorando código de doctest inválido: %r�arquivo de imagem %s não legível: %s�arquivo de imagem não legível: %s�inclui módulos “_private”�inclui links para o código-fonte dos objetos Python documentados�inclui matemática, renderizada como imagens PNG ou SVG�inclui matemática, renderizada no navegador por MathJax�referências de citação inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}�referências de nota de rodapé inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}�referências inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}�referências de termo inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}�aumenta o nível de detalhamento (pode ser repetido)�índice�latex em linha %r: %s�interpreta caminhos de módulos de acordo com a especificação de espaços de nomes implícitos PEP-0420�identificador intersphinx %r não é uma string. Ignorado�o inventário intersphinx foi movido: %s -> %s�Tipo de TestCode inválido�css_file inválido: %r, ignorado�js_file inválido: %r, ignorado�número inválido %r para valor de configuração %r, ignorando�numfig_format inválido: %s�numfig_format inválido: %s (%r)�regex inválida %r em %s�regex inválida %r em coverage_c_regexes�assinatura inválida para auto%s (%r)�valor inválido para a opção class-doc-from: %s�valor inválido para a opção member-order: %s�valor inválido definido (faltando chave de fechamento): %s�valor inválido definido (faltando chave de abertura): %s�número de tarefas deve ser um número positivo�palavra-chave�kwargs para add_node() deve ser uma tupla de função (visit, depart): %r=%r�última atualização�especificação de número de linha está fora da faixa(1-%d): %r�cria link entre documentação Sphinx de diferentes projetos�Listar todas seções e subseções�carregando inventário intersphinx de %s…�carregando ambiente com pickle�carregando traduções [%s]… �locale_dir %s não existe�o arquivo logo %r não existe�procurando por arquivos agora desatualizados… �macro�criando o diretório de saída�string literal malformada (faltando aspas de fechamento): %s�string literal malformada (faltando aspas de abertura): %s�nome do documento mestre�renderizador matemático %s já está registrado�profundidade máxima de submódulos para mostrar no TOC (padrão: 4)�membro�método�faltando “+” ou “-” na opção “%s”.�faltando atributo %s no objeto %s�faltando atributo mencionado na opção :members: : módulo %s, atributo %s�módulo�o módulo %s não pôde ser importado: %s�módulos�mais de um alvo localizado para “any” referência cruzada %r: poderia ser %s�mais de um alvo localizado para referência cruzada %r: %s�vários arquivos encontrados para o documento "%s": %r Use %r para a construção.�nova configuração�próximo�próximo capítulo�modo exigente, avisa sobre todas as referências em falta�nenhuma valor da configuração “latex_documents” encontrado; nenhum documento será escrito�nenhum valor de configuração “man_pages” encontrado; nenhuma página de manual será escrita�nenhuma valor de configuração “texinfo_documents” encontrado; nenhum documento será escrito�nenhuma opção Babel conhecida para o idioma %r�nenhuma alteração na versão %s.�nenhum código/saída no bloco %s em %s:%s�nenhuma saída, nem mesmo avisos�nenhuma saída para stdout, apenas avisos na stderr�nenhum alvo está desatualizado.�nenhum tema chamado %r encontrado (faltando theme.conf?)�nenhum tema chamado %r encontrado, herdado por %r�classe de nodo %r já está registrada, seus visitantes serão sobrescritos�espaços não em branco eliminados por dedent�nenhum encontrado�não disponível para mensagens internas�numfig está desabilitado. :numref: é ignorado.�numfig_format não está definido para %s�objeto�operador�entrada original�sobrescreve a configuração no arquivo de configuração�sobrescreve arquivos existentes�página�a página %s corresponde a dois padrões em html_sidebars: %r e %r�passa um valor para modelos em HTML�caminho para o ambiente em cache e arquivos doctree (padrão: OUTPUTDIR/.doctrees)�caminho para os arquivos-fonte da documentação�caminho para o módulo a ser documentado�caminho para o diretório de saída�caminho no qual o arquivo de configuração (conf.py) está localizado (padrão: mesmo que SOURCEDIR)�tornando um ambiente pickle�preparando documentos�anterior�capítulo anterior�primary_domain %r não encontrado, ignorado.�processando %s�opção do programa�autor(e)s do projeto, usado quando --full é fornecido�nome do projeto�nome do projeto (padrão nome do módulo raiz)�lançamento do projeto, usado quando --full é fornecido, padrão é --doc-version�raiz do projeto�versão do projeto, usado quando --full é fornecido�propriedade�coloca a documentação para cada módulo em sua própria página�coloca documentação de módulo antes da documentação do submódulo�acesso rápido para todos os módulos�modo silencioso�Erro de marcação reST:�erro de leitura: %s, %s�lendo fontes… �lendo modelos… �marca referencial�lançamento do projeto�substituto para ponto em _templates etc.�resolvendo referências…�papel�papel %r já está registrado, ele será sobrescrito�executa Pdb na exceção�escreve o script sem criar arquivos�buscar�não foi possível carregar o índice de pesquisa, mas nem todos os documentos serão compilados: o índice ficará incompleto.�Buscar nessa documentação�veja %s�veja também %s�toctree autorreferenciada encontrada. Ignorado.�a configuração %s.%s ocorre em nenhuma das configurações de tema pesquisadas�mostra rastro completo em exceção�argumentos de assinatura ou anotação de retorno fornecidos para automodule %s�ignorado�diretório de fontes foi alterado�sufixo de arquivos-fonte�arquivos-fonte para gerar arquivos rST�source_parser para %r já está registrado�source_suffix %r já está registrado�sphinx-quickstart só gera em um diretório vazio. Especifique um novo caminho raiz.�sphinx-quickstart não vai sobrescrever projetos Sphinx existentes.�sphinx-quickstart não vai sobrescrever o arquivo existente.�sphinx_rtd_theme (< 0.3.0) encontrado. Ele não estará disponível a partir do Sphinx-6.0�comando�método estático�struct�bem-sucedida�alvos para %d arquivos po que estão desatualizados�alvos para %d arquivos po que estão especificados�alvos para %d arquivos fonte que estão desatualizados�alvos para os %d arquivos de modelo�diretório para arquivos de modelos�parâmetro de modelo�a extensão %s não declara se é segura para leitura em paralelo, supondo que não seja – peça ao autor da extensão para verificar e torná-la explícita�a extensão %s não declara se é segura para escrita em paralelo, supondo que não seja – peça ao autor da extensão para verificar e torná-la explícita�a extensão %s não é segura para leitura em paralelo�a extensão %s não é segura para escrita em paralelo�documentação para�a extensão %r já foi mesclada com Sphinx desde a versão %s; esta extensão é ignorada.�o link não possui legenda: %s�o tema %r não tem a configuração “inherit”�o tema %r não tem a configuração “theme”�toctree contém referência ao arquivo inexistente %r�toctree contém referência ao documento %r que não possui título: nenhum link será gerado�toctree contém referência ao documento excluído %r�toctree contém referência ao documento inexistente %r�:maxdepth: grande demais, ignorado.�transforma avisos em erros�tipo�caracteres de origem não codificáveis, substituindo por “?”: %r�rótulo não definido: %s�api c não documentada: %s [%s] no arquivo %s�classe python não documentada: %s :: %s�função python não documentada: %s :: %s�método python não documentado: %s :: %s :: %s�tipo de nó não implementado: %r�união�toplevel_sectioning %r desconhecido para a classe %r�valor de configuração desconhecido %r na sobrescrita, ignorando�diretiva ou nome de papel desconhecida(o): %s:%s�tipo desconhecido de entrada de índice %r�tipo desconhecido de entrada de índice %s encontrado�tipo mime desconhecido para %s, ignorando�tipo de nó desconhecido: %r�sem suporte à opção de tema %r fornecida�atualizando ambiente: �usa epub�usa modo make para Makefile/make.bat�usa nenhum arquivo de configuração, apenas as opções -D�variável�versão do projeto�aguardando por workers…�sendo “compilador” um dos compiladores com suporte, p.ex., html, latex ou linkcheck.�enquanto definia a extensão %s:�com -W, segue em frente ao receber avisos�escreve entradas “todo” que podem ser mostradas ou ocultadas na compilação�escrever todos os arquivos (padrão: escrever apenas arquivos novos e alterados)�escreve avisos (e erros) para o arquivo fornecido�escrevendo�escrevendo arquivo %s…�escrevendo o arquivo META-INF/container.xml...�escrevendo arquivos adicionais�escrevendo páginas adicionais�escrevendo o arquivo content.opf...�erro de escrita: %s, %s�escrevendo catálogos de mensagens… �escrevendo o arquivo mimetype...�escrevendo o arquivo nav.xhtml...�escrevendo saída… �escrevendo arquivo de resumo…�escrevendo o arquivo toc.ncx...�������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt_BR/LC_MESSAGES/sphinx.po����������������������������������������������0000644�0000766�0000024�00000350360�00000000000�021556� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Claudio Rogerio Carvalho Filho <excriptbrasil@gmail.com>, 2016 # FIRST AUTHOR <roger.demetrescu@gmail.com>, 2008 # gilberto dos santos alves <gsavix@gmail.com>, 2015-2016 # Rafael Fontenelle <rafaelff@gnome.org>, 2019 # Rafael Fontenelle <rffontenelle@gmail.com>, 2019-2021 # Komiya Takeshi <i.tkomiya@gmail.com>, 2016 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Portuguese (Brazil) (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt_BR/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: pt_BR\n" "Plural-Forms: nplurals=2; plural=(n > 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Não foi possível encontrar o diretório de origem (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "O diretório de saída (%s) não é um diretório" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Diretório de origem e o diretório de destino não podem ser idênticos" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Executando Sphinx v%s" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "Por motivo de segurança, o modo paralelo está desabilitado no macOS e python3.8 e acima. Para mais detalhes, leia https://github.com/sphinx-doc/sphinx/issues/6803" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Este projeto precisa de pelo menos Sphinx v%s e, portanto, não pode ser compilado com esta versão." #: sphinx/application.py:243 msgid "making output directory" msgstr "criando o diretório de saída" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "enquanto definia a extensão %s:" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "“setup”, conforme definido atualmente em conf.py, não é um invocável do Python. Modifique sua definição para torná-la uma função que pode ser chamada. Isso é necessário para o conf.py se comportar como uma extensão do Sphinx." #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "carregando traduções [%s]… " #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "feito" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "não disponível para mensagens internas" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "carregando ambiente com pickle" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "falha: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "Nenhum compilador selecionado, usando padrão: html" #: sphinx/application.py:348 msgid "succeeded" msgstr "bem-sucedida" #: sphinx/application.py:349 msgid "finished with problems" msgstr "finalizada com problemas" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "compilação %s, %s aviso. (com avisos tratados como erros)." #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "compilação %s, %s avisos (com avisos tratados como erros)." #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "compilação %s, %s aviso." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "compilação %s, %s avisos." #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "compilação %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "classe de nodo %r já está registrada, seus visitantes serão sobrescritos" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "diretiva %r já está registrada, ela será sobrescrita" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "papel %r já está registrado, ele será sobrescrito" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "a extensão %s não declara se é segura para leitura em paralelo, supondo que não seja – peça ao autor da extensão para verificar e torná-la explícita" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "a extensão %s não é segura para leitura em paralelo" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "a extensão %s não declara se é segura para escrita em paralelo, supondo que não seja – peça ao autor da extensão para verificar e torná-la explícita" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "a extensão %s não é segura para escrita em paralelo" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "fazendo serial %s" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "o diretório de configuração não contém um arquivo conf.py (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "não foi possível sobrescrever a configuração do dicionário %r ignorando (use %r para definir elementos individuais)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "número inválido %r para valor de configuração %r, ignorando" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "não é possível sobrescrever a configuração %r com tipo sem suporte, ignorando" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "valor de configuração desconhecido %r na sobrescrita, ignorando" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "Valor de configuração inexistente: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "Valor da configuração %r já presente" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Há um erro de sintaxe em seu arquivo de configuração: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "O arquivo de configuração (ou um dos módulos que ele importa) chamou sys.exit()" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "Há um erro de programável em seu arquivo de configuração:\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "O valor da configuração “source_suffix” espera uma string, lista de strings ou dicionário. Mas “%r” é fornecido." #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Seção %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Fig. %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tabela %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Listagem %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "O valor da configuração “{name}” deve ser um entre {candidates}, mas “{current}” é fornecido." #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "O valor da configuração “{name}” possui tipo “{current.__name__}”; esperava {permitted}." #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "O valor da configuração “{name}” possui tipo “{current.__name__}”; o padrão é “{default.__name__}”." #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r não encontrado, ignorado." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "Desde v2.0, Sphinx usa \"index\" como root_doc por padrão. Adicione \"root_doc = 'contents'\" ao seu conf.py." #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "Evento %r já presente" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Nome de evento desconhecido: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "O manipulador %r para evento %r levantou uma exceção" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "A extensão %s é requerida pelas configurações needs_extensions, mas não está carregada." #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "Este projeto precisa da extensão %s pelo menos na versão %s e, portanto, não pode ser compilado com a versão carregada (%s)." #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "Nome de analisador léxico Pygments %r não é conhecido" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "Não foi possível fazer análise léxica de literal_block como “%s”. Realce de sintaxe ignorado." #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "vários arquivos encontrados para o documento \"%s\": %r\nUse %r para a construção." #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "documento não legível. Ignorado." #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "Classe de compilador %s possui nenhum atributo “name”" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Compilador %r já existe (no módulo %s)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Nome do compilador %s não registrado ou disponível através do ponto de entrada" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "Nome do compilador %s não registrado" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "domínio %s já registrado" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "domínio %s ainda não registrado" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "A diretiva %r já está registrada para o domínio %s" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "O papel %r já está registrado para o domínio %s" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "O índice %r já está registrado para o domínio %s" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "O object_type %r já está registrado" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "O crossref_type %r já está registrado" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "source_suffix %r já está registrado" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "source_parser para %r já está registrado" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "Analisador de fonte para %s não registrado" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "Tradutor para %r já existe" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "kwargs para add_node() deve ser uma tupla de função (visit, depart): %r=%r" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "enumerable_node %r já registrado" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "renderizador matemático %s já está registrado" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "a extensão %r já foi mesclada com Sphinx desde a versão %s; esta extensão é ignorada." #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "Extensão original:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "Não foi possível importar a extensão %s" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "a extensão %r possui nenhuma função setup(); é realmente um módulo de extensão do Sphinx?" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "A extensão %s usada por este projeto precisa de pelo menos Sphinx v%s e, portanto, não pode ser compilada com esta versão." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "a extensão %r retornou um objeto não suportado de sua função setup(); deve retornar None ou um dicionário de metadados" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Propostas Estendidas Python; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "o tema %r não tem a configuração “theme”" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "o tema %r não tem a configuração “inherit”" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "nenhum tema chamado %r encontrado, herdado por %r" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "a configuração %s.%s ocorre em nenhuma das configurações de tema pesquisadas" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "sem suporte à opção de tema %r fornecida" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "o arquivo %r no caminho de tema não é um arquivo zip válido ou contém nenhum tema" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "sphinx_rtd_theme (< 0.3.0) encontrado. Ele não estará disponível a partir do Sphinx-6.0" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "nenhum tema chamado %r encontrado (faltando theme.conf?)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "uma imagem adequada para o compilador %s não encontrada: %s (%s)" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "uma imagem adequada para o compilador %s não encontrada: %s" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "compilando [mo]: " #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "escrevendo saída… " #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "todos os %d arquivos po" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "alvos para %d arquivos po que estão especificados" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "alvos para %d arquivos po que estão desatualizados" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "todos os arquivos-fonte" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "o arquivo %r fornecido na linha de comando não está dentro do diretório fonte, ignorando" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "o arquivo %r fornecido na linha de comando não existe, ignorando" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "%d arquivos-fonte dados na linha de comando" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "alvos para %d arquivos fonte que estão desatualizados" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "compilando [%s]: " #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "procurando por arquivos agora desatualizados… " #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "%d encontrado" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "nenhum encontrado" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "tornando um ambiente pickle" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "verificando consistência" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "nenhum alvo está desatualizado." #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "atualizando ambiente: " #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "%s adicionado(s), %s alterado(s), %s removido(s)" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "lendo fontes… " #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "aguardando por workers…" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "docnames para escrever: %s" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "preparando documentos" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "entrada de tabela de conteúdos duplicada encontrada: %s" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "copiando imagens… " #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "não foi possível ler o arquivo de imagem %r: copiando-o" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "não foi possível copiar arquivo de imagem %r: %s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "não foi possível escrever arquivo de imagem %r: %s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "Pillow não encontrado – copiando arquivos de imagem" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "escrevendo o arquivo mimetype..." #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "escrevendo o arquivo META-INF/container.xml..." #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "escrevendo o arquivo content.opf..." #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "tipo mime desconhecido para %s, ignorando" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "escrevendo o arquivo toc.ncx..." #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "escrevendo arquivo %s…" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "O arquivo de visão geral está em %(outdir)s." #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "nenhuma alteração na versão %s." #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "escrevendo arquivo de resumo…" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Internos" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Nível do Módulo" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "copiando arquivos-fonte…" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "não foi possível ler %r para criação do changelog" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "O compilador fictício não gera arquivos." #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "O arquivo ePub está em %(outdir)s." #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "escrevendo o arquivo nav.xhtml..." #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "o valor da configuração “epub_language” (ou “language”) não deve estar vazio para EPUB3" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "o valor da configuração “epub_uid” deve ser XML NAME para EPUB3" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "o valor da configuração “epub_title” (ou “html_title”) não deve estar vazio para EPUB3" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "o valor da configuração “epub_author” não deve estar vazio para EPUB3" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "o valor da configuração “epub_contributor” não deve estar vazio para EPUB3" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "o valor da configuração “epub_description” não deve estar vazio para EPUB3" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "o valor da configuração “epub_publisher” não deve estar vazio para EPUB3" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "o valor da configuração “epub_copyright” (ou “copyright”) não deve estar vazio para EPUB3" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "o valor da configuração “epub_identifier” não deve estar vazio para EPUB3" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "o valor da configuração “version” não deve estar vazio para EPUB3" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "css_file inválido: %r, ignorado" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "Os catálogos de mensagens estão em %(outdir)s." #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "alvos para os %d arquivos de modelo" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "lendo modelos… " #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "escrevendo catálogos de mensagens… " #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "Procure por quaisquer erros na saída acima ou em %(outdir)s/output.txt" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "link quebrado: %s (%s)" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "Âncora “%s” não encontrada" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "Falha ao compilar regex em linkcheck_allowed_redirects: %r %s" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "As páginas de manual estão em %(outdir)s." #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "nenhum valor de configuração “man_pages” encontrado; nenhuma página de manual será escrita" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "escrevendo" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "o valor da configuração “man_pages” faz referência a um documento desconhecido %s" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "A página HTML está em %(outdir)s." #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "montando documento único" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "escrevendo arquivos adicionais" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "Os arquivos Texinfo estão em %(outdir)s." #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "\nExecute \"make\" nesse diretório para executá-los com makeinfo\n(use \"make info\" aqui para fazer isso automaticamente)." #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "nenhuma valor de configuração “texinfo_documents” encontrado; nenhum documento será escrito" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "o valor da configuração “texinfo_documents” faz referência a documento desconhecido %s" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "processando %s" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "resolvendo referências…" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (em " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "copiando arquivos de suporte Texinfo" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "erro ao escrever o arquivo Makefile: %s" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "Os arquivos texto estão em %(outdir)s." #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "erro ao escrever o arquivo %s: %s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "Os arquivos XML estão em %(outdir)s." #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "Os arquivos pseudo-XML estão em %(outdir)s." #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "arquivo de informações da compilação está quebrado: %r" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "As páginas HTML estão em %(outdir)s." #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "Falha ao ler o arquivo de informações de compilação: %r" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d %b %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Índice Geral" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "índice" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "próximo" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "anterior" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "gerando índices" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "escrevendo páginas adicionais" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "copiando arquivos baixáveis… " #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "não foi possível copiar o arquivo baixável %r: %s" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "Falha ao copiar um arquivo em html_static_file: %s: %r" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "copiando arquivos estáticos" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "não foi possível copiar o arquivo estático %r" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "copiando arquivos extras" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "não foi possível copiar o arquivo extra %r" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "Falha ao escrever o arquivo de informações de compilação: %r" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "não foi possível carregar o índice de pesquisa, mas nem todos os documentos serão compilados: o índice ficará incompleto." #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "a página %s corresponde a dois padrões em html_sidebars: %r e %r" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "ocorreu um erro Unicode ao renderizar a página %s. Verifique se todos os valores de configuração que contêm conteúdo não ASCII são strings Unicode." #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "Ocorreu um erro ao renderizar a página %s.\nMotivo: %r" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "despejando inventário de objetos" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "despejando índice de pesquisa em %s" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "js_file inválido: %r, ignorado" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "Muitos math_renders estão registrados, mas nenhum math_renderer está selecionado." #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "math_renderer desconhecido %r é fornecido." #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "a entrada de html_extra_path %r não existe" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "entrada de html_extra_path %r está posicionada dentro de outdir" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "a entrada de html_static_path %r não existe" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "entrada de html_static_path %r está posicionada dento de outdir" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "o arquivo logo %r não existe" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "o arquivo favicon %r não existe" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "html_add_permalinks foi descontinuado desde v3.5.0. Use html_permalinks e html_permalinks_icon." #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "documentação %s %s" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "Os arquivos LaTeX estão em %(outdir)s." #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\nExecute \"make\" nesse diretório para executá-los com (pdf)latex\n(use \"make latexpdf\" aqui para fazer isso automaticamente)." #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "nenhuma valor da configuração “latex_documents” encontrado; nenhum documento será escrito" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "o valor da configuração “latex_documents” faz referência a um documento desconhecido %s" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Índice" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Release" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "nenhuma opção Babel conhecida para o idioma %r" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "copiando arquivos de suporte TeX" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "copiando arquivos de suporte TeX…" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "copiando arquivos adicionais" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "Chave configuração desconhecida: latex_elements[%r], ignorado." #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "Opção de tema desconhecida: latex_theme_options[%r], ignorada." #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "%r não possui a configuração \"theme\"" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "%r não possui a configuração \"%s\"" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "Ocorreu uma exceção enquanto compilava, iniciando depurador:" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "Interrompido!" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "Erro de marcação reST:" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "Erro de codificação:" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "O rastro completo foi salvo em %s, caso você queira relatar o problema aos desenvolvedores." #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "Erro de recursão:" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "Isso pode acontecer com arquivos fonte muito grande e profundamente aninhados. Você pode aumentar com cuidado o limite padrão de recursão do Python de 1000 no conf.py com, por exemplo:" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "Ocorreu uma exceção:" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "Por favor, relate isso também se houver um erro do usuário, para que uma mensagem de erro melhor possa ser fornecida na próxima vez." #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "Um relatório de erro pode ser preenchido no rastreador em <https://github.com/sphinx-doc/sphinx/issues>. Obrigado!" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "número de tarefas deve ser um número positivo" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "Para mais informações, visite <https://www.sphinx-doc.org/>." #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "\nGera documentação de arquivos fonte.\n\nsphinx-build gera documentação a partir dos arquivos em SOURCEDIR e os coloca\nem OUTPUTDIR. Ele procura por \"conf.py\" em SOURCEDIR para a configuração\ndefinições. A ferramenta \"sphinx-quickstart\" pode ser usada para gerar\narquivos de modelo, incluindo \"conf.py\"\n\nsphinx-build pode criar documentação em diferentes formatos. Um formato é\nselecionado especificando o nome do construtor na linha de comandos; o padrão\né HTML. Os construtores também podem realizar outras tarefas relacionadas à\ndocumentação em processamento.\n\nPor padrão, tudo o que está desatualizado é construído. Saída apenas para\nselecionado os arquivos podem ser construídas especificando nomes de arquivos\nindividuais.\n" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "caminho para os arquivos-fonte da documentação" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "caminho para o diretório de saída" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "uma lista de arquivos específicos para recompilar. Ignorado se -a for especificado" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "opções gerais" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "compilador para usar (padrão: html)" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "escrever todos os arquivos (padrão: escrever apenas arquivos novos e alterados)" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "não usa um ambiente salvo, sempre lê todos os arquivos" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "caminho para o ambiente em cache e arquivos doctree (padrão: OUTPUTDIR/.doctrees)" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "compila em paralelo com N processos onde possível (o valor especial “auto” será definido com N para número de CPUs)" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "caminho no qual o arquivo de configuração (conf.py) está localizado (padrão: mesmo que SOURCEDIR)" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "usa nenhum arquivo de configuração, apenas as opções -D" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "sobrescreve a configuração no arquivo de configuração" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "passa um valor para modelos em HTML" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "define tag: inclui blocos “only” com TAG" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "modo exigente, avisa sobre todas as referências em falta" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "opções de saída do console" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "aumenta o nível de detalhamento (pode ser repetido)" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "nenhuma saída para stdout, apenas avisos na stderr" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "nenhuma saída, nem mesmo avisos" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "emite saída colorida (padrão: detectar automaticamente)" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "não emite saída colorida (padrão: detectar automaticamente)" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "escreve avisos (e erros) para o arquivo fornecido" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "transforma avisos em erros" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "com -W, segue em frente ao receber avisos" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "mostra rastro completo em exceção" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "executa Pdb na exceção" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "não foi possível localizar os arquivos %r" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "não é possível combinar a opção -a e nomes de arquivos" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "não foi possível abrir o arquivo de aviso %r: %s" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "o argumento da opção -D deve estar no formato nome=valor" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "o argumento da opção -A deve estar no formato nome=valor" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "insere docstrings automaticamente a partir de módulos" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "testa trechos de código automaticamente em blocos de doctest" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "cria link entre documentação Sphinx de diferentes projetos" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "escreve entradas “todo” que podem ser mostradas ou ocultadas na compilação" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "verifica por cobertura da documentação" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "inclui matemática, renderizada como imagens PNG ou SVG" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "inclui matemática, renderizada no navegador por MathJax" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "inclusão condicional de conteúdo com base nos valores de configuração" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "inclui links para o código-fonte dos objetos Python documentados" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "cria um arquivo .nojekyll para publicar o documento em páginas do GitHub" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "Insira um nome de caminho válido." #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "Insira algum texto." #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "Insira um entre %s." #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "Insira “y” ou “n”." #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "Insira um sufixo de arquivo, p.ex., “.rst” ou “.txt”." #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "Bem-vindo ao utilitário de início rápido do Sphinx %s." #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "Digite valores para as seguintes configurações (basta pressionar Enter\npara aceitar um valor padrão, se houver um entre colchetes)." #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "Caminho raiz selecionado: %s" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "Insira o caminho raiz para a documentação." #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "Caminho raiz para a documentação" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "Erro: um conf.py existente foi encontrado no caminho raiz selecionado." #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "sphinx-quickstart não vai sobrescrever projetos Sphinx existentes." #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "Insira um novo caminho raiz (ou pressione Enter para sair)" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "Você tem duas opções para definir o diretório de compilação para a saída\nSphinx. Você pode usar um diretório \"_build\" no caminho raiz ou separar\nos diretórios de \"origem\" e \"compilação\" no caminho raiz." #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "Separar os diretórios de origem e compilação (y/n)" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "Dentro do diretório raiz, mais dois diretórios serão criados; \"_templates\"\npara modelos HTML personalizados e \"_static\" para folhas de estilo (CSS)\npersonalizadas e outros arquivos estáticos. Você pode inserir outro prefixo\n(como \".\") para substituir o sublinhado." #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "Prefixo do nome para o diretório de modelos e de arquivos estáticos" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "O nome do projeto vai aparecer em vários lugares na documentação compilada." #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "Nome do projeto" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "Nome(s) de autor(es)" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "O Sphinx tem a noção de uma \"versão\" e um \"lançamento\" para o software.\nCada versão pode ter vários lançamentos. Por exemplo, para Python a\nversão é algo como 2.5 ou 3.0, enquanto o lançamento é algo como 2.5.1\nou 3.0a1. Se você não precisa dessa estrutura dupla, apenas defina ambos\ncom o mesmo valor." #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "Versão do projeto" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "Lançamento do projeto" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "Se os documentos forem escritos em um idioma diferente do inglês, você\npode selecionar um idioma aqui pelo seu código de idioma. O Sphinx,\nentão, traduzirá o texto gerado para esse idioma.\n\nPara obter uma lista dos códigos suportados, consulte\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "Idioma do projeto" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "O sufixo do nome de arquivo para arquivos fonte. Normalmente, isso é\n\".txt\" ou \".rst\". Apenas arquivos com este sufixo são considerados\ndocumentos." #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "Sufixo de arquivos-fonte" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "Um documento é especial por ser considerado o nó superior da \"árvore de\nconteúdo\", ou seja, é a raiz da estrutura hierárquica dos documentos.\nNormalmente, isso é \"index\", mas se o documento \"index\" for um modelo\npersonalizado, você também poderá configurá-lo para outro nome de arquivo." #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "Nome do seu documento mestre (sem sufixo)" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "Erro: o arquivo mestre %s já foi encontrado no caminho raiz selecionado." #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "sphinx-quickstart não vai sobrescrever o arquivo existente." #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "Insira um novo nome de arquivo, ou renomeie o arquivo existente e pressione Enter" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "Indique qual das seguintes extensões do Sphinx devem ser habilitadas:" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "Nota: imgmath e mathjax não podem ser habilitados ao mesmo tempo. imgmath foi desmarcado." #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "Um Makefile e um arquivo de comando do Windows podem ser gerados para você,\npara que você só precise executar, p.ex., \"make html\" em vez de invocar o\nsphinx-build diretamente." #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "Criar um Makefile? (y/n)" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "Criar um arquivo de comando do Windows? (y/n)" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "Criando o arquivo %s." #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "O arquivo %s já existe, ignorando." #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "Finalizado: uma estrutura de diretório inicial foi criada." #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "Agora você deve preencher seu arquivo mestre %s e criar outros arquivos-fonte\nda documentação. " #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "Use o Makefile para compilar os documentos, assim:\n make builder" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "Use o comando sphinx-build para compilar os documentos, assim:\n sphinx-build -b compilador %s %s" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "sendo “compilador” um dos compiladores com suporte, p.ex., html, latex ou linkcheck." #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "\nGera os arquivos necessários para um projeto Sphinx.\n\nO sphinx-quickstart é uma ferramenta interativa que faz algumas perguntas\nsobre o seu projeto e gera um diretório de documentação completo e um\nMakefile de amostra para ser usado com o sphinx-build.\n" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "modo silencioso" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "raiz do projeto" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "Opção Estrutura" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "se especificado, separa diretórios de fonte e de compilação" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "se especificado, cria o dir de construção sob o dir fonte" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "substituto para ponto em _templates etc." #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "Opções básicas do projeto" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "nome do projeto" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "nomes de autores" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "versão do projeto" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "lançamento do projeto" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "idioma dos documentos" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "sufixo de arquivos-fonte" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "nome do documento mestre" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "usa epub" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "Opções extensão" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "habilita a extensão %s" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "habilita extensões arbitrárias" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "Criação de Makefile e arquivo Batch" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "cria makefile" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "não cria makefile" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "cria arquivo batch" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "não cria arquivo batch" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "usa modo make para Makefile/make.bat" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "não usa modo make para Makefile/make.bat" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "Modelo de projeto" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "diretório para arquivos de modelos" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "define uma variável modelo" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "“quiet” está especificada, mas “project” ou “author” não foi." #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "Erro: o caminho especificado não é um diretório, ou arquivos sphinx já existem." #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "sphinx-quickstart só gera em um diretório vazio. Especifique um novo caminho raiz." #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "Variável de modelo inválida: %s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "espaços não em branco eliminados por dedent" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "Legenda inválida: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "especificação de número de linha está fora da faixa(1-%d): %r" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "Não é possível usar as opções “%s” e “%s” juntas" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "Arquivo incluído %r não encontrado ou sua leitura falhou" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "A codificação %r usada para ler o arquivo incluído %r parece estar errada, tente passar uma opção :encoding:" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "O objeto chamado %r não foi encontrado no arquivo incluído %r" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "Não é possível usar “lineo-match” com um conjunto separado de “lines”" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "Especificação de linha %r: nenhuma linha obtida do arquivo incluído %r" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Autor da seção: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Autor do módulo: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Autor do código: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autor: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "A opção \":file:\" para a diretiva csv-table agora reconhece um caminho absoluto como um caminho relativo do diretório de fontes. Por favor, atualize seu documento." #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "Declaração C duplicada, também definida em %s:%s.\nA declaração é '.. c:%s:: %s'." #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "%s (C %s)" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parâmetros" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "Valores de retorno" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Retorna" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Tipo de retorno" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "membro" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "variável" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "função" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "macro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "struct" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "união" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "enum" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "enumerador" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "tipo" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "parâmetro de função" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Novo na versão %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Alterado na versão %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Obsoleto desde a versão %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "citação duplicada %s, outra instância em %s" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "citação [%s] não é referenciada." #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "Declaração C++ duplicada, também definida em %s:%s.\nA declaração é '.. cpp:%s:: %s'." #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Parâmetros do Modelo" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Lança" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "classe" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "conceito" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "parâmetro de modelo" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (função interna)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (método %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (classe)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (variável global ou constante)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (atributo %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumentos" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (módulo)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "método" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "dado" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atributo" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "módulo" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "descrição duplicada de %s de %s, outro %s em %s" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "rótulo duplicado da equação %s, outra instância em %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "math_eqref_format inválido: %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "palavra-chave" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operador" #: sphinx/domains/python.py:61 msgid "object" msgstr "objeto" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "exceção" #: sphinx/domains/python.py:63 msgid "statement" msgstr "comando" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "função interna" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Variáveis" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Levanta" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (no módulo %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (no módulo %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (variável interna)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (classe interna)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (classe em %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (método de classe %s)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "%s (propriedade %s )" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (método estático %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Índice de Módulos Python" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "módulos" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Obsoleto" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "método de classe" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "método estático" #: sphinx/domains/python.py:1176 msgid "property" msgstr "propriedade" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "descrição duplicada de objeto de %s, outra instância em %s, use :noindex: para um deles" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "mais de um alvo localizado para referência cruzada %r: %s" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (obsoleto)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (diretiva)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr ":%s: (opção diretiva)" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (papel)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "diretiva" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "opção diretiva" #: sphinx/domains/rst.py:210 msgid "role" msgstr "papel" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "descrição duplicada de %s %s, outra instância em %s" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "váriavel de ambiente; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "Descrição de opção %r malformada, deve se parecer com “opt”, “-opt args”, “--opt args”, “/opt args” ou “+opt args”" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "%s opção de linha de comando" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "opção de linha de comando" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "um termo de glossário deve ser precedido por uma linha vazia" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "termos de glossário não devem ser separados por linhas vazias" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "o glossário parece estar mal formatado, confira o recuo" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "Glossário de Termos" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "termo gramatical" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "marca referencial" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "váriavel de ambiente" #: sphinx/domains/std.py:568 msgid "program option" msgstr "opção do programa" #: sphinx/domains/std.py:569 msgid "document" msgstr "documento" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Índice do Módulo" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Página de Busca" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "rótulo duplicada %s, outra instância em %s" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "descrição duplicada de %s de %s, outra instância em %s" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "numfig está desabilitado. :numref: é ignorado." #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "Falha ao criar uma referência cruzada. Qualquer número não foi atribuído: %s" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "o link não possui legenda: %s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "numfig_format inválido: %s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "numfig_format inválido: %s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "rótulo não definido: %s" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "Falha ao criar uma referência cruzada. Título ou legenda não encontrado: %s" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "nova configuração" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "configuração alterada" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "extensões alteradas" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "a versão do ambiente de compilação não é a atual" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "diretório de fontes foi alterado" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "Este ambiente é incompatível com o compilador selecionado, por favor escolha outro diretório de doctree." #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "Falha ao procurar documentos em %s: %r" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "O domínio %r ainda não está registrado" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "toctree autorreferenciada encontrada. Ignorado." #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "o documento não está incluído em nenhum toctree" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "veja %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "veja também %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "tipo desconhecido de entrada de índice %r" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Símbolos" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "referências circulares à toctree detectadas, ignorando: %s <- %s" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "toctree contém referência ao documento %r que não possui título: nenhum link será gerado" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "toctree contém referência ao documento excluído %r" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "toctree contém referência ao documento inexistente %r" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "arquivo de imagem não legível: %s" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "arquivo de imagem %s não legível: %s" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "arquivo de download não legível: %s" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "%s já tem números de seção atribuídos (toctree numerada aninhada?)" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "Criaria o arquivo %s." #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "\nProcura recursivamente em <MODULE_PATH> módulos e pacotes Python e cria um\narquivo reST com diretivas automodule por pacote no <OUTPUT_PATH>.\n\nOs <EXCLUDE_PATTERN>s podem ser padrões de arquivo e/ou diretório que serão\nexcluídos da geração.\n\nNota: Por padrão, este script não substituirá os arquivos já criados." #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "caminho para o módulo a ser documentado" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "padrões de diretório e/ou arquivo no estilo fnmatch para excluir da geração" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "diretório para colocar toda a saída" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "profundidade máxima de submódulos para mostrar no TOC (padrão: 4)" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "sobrescreve arquivos existentes" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "segue links simbólicos. Poderoso quando combinado com collective.recipe.omelette." #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "escreve o script sem criar arquivos" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "coloca a documentação para cada módulo em sua própria página" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "inclui módulos “_private”" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "nome de arquivo da tabela de conteúdo (padrão: modules)" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "não cria um arquivo de tabela de conteúdo" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "não cria títulos para os pacotes de módulo/pacote (p.ex., quando as docstrings já os contêm)" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "coloca documentação de módulo antes da documentação do submódulo" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "interpreta caminhos de módulos de acordo com a especificação de espaços de nomes implícitos PEP-0420" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "sufixo dos arquivos (padrão: rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "gera um projeto completo com sphinx-quickstart" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "acrescenta module_path a sys.path, usando quando --full é fornecido" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "nome do projeto (padrão nome do módulo raiz)" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "autor(e)s do projeto, usado quando --full é fornecido" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "versão do projeto, usado quando --full é fornecido" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "lançamento do projeto, usado quando --full é fornecido, padrão é --doc-version" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "opções de extensão" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s não é um diretório." #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "regex inválida %r em %s" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "Teste de cobertura nos fontes finalizada, confira os resultados em %(outdir)spython.txt." #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "regex inválida %r em coverage_c_regexes" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "api c não documentada: %s [%s] no arquivo %s" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "o módulo %s não pôde ser importado: %s" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "função python não documentada: %s :: %s" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "classe python não documentada: %s :: %s" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "método python não documentado: %s :: %s :: %s" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "faltando “+” ou “-” na opção “%s”." #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "“%s” não é uma opção válida." #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "“%s” não é uma opção de pyversion válida" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "Tipo de TestCode inválido" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "Teste de doctests nos fontes finalizada, confira os resultados em %(outdir)s/output.txt." #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "nenhum código/saída no bloco %s em %s:%s" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "ignorando código de doctest inválido: %r" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "=================== durações de leitura mais lentas ====================" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "A diretiva de Graphviz não pode ter conteúdo e argumento de nome de arquivo" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "Arquivo externo de Graphviz %r não encontrado ou sua leitura falhou" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "Ignorando diretiva “graphviz” sem conteúdo." #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "DOT não produziu um arquivo de saída:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "comando de DOT %r não pode ser executado (necessário para a saída do graphviz), verifique a configuração do graphviz_dot" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "DOT encerrado com erro:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "graphviz_output_format deve ser um entre “png” e “svg”, mas é %r" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "código DOT %r: %s" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[gráfico: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[gráfico]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "comando de conversão %r não pode ser executado, verifique a configuração image_converter: %s" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "convert encerrado com erro:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "comando de conversão %r não pode ser executado, verifique a configuração image_converter" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "o comando LaTeX %r não pode ser executado (necessário para exibir matemáticas), verifique a configuração imgmath_latex" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "o comando %s %r não pode ser executado (necessário para exibir matemáticas), verifique a configuração imgmath_%s" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "exibe latex %r: %s" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "latex em linha %r: %s" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Link permanente para essa equação" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "o inventário intersphinx foi movido: %s -> %s" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "carregando inventário intersphinx de %s…" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "encontrados alguns problemas com alguns dos inventários, mas eles tem alternativas em funcionamento:" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "falha ao alcançar todos os inventários com os seguintes problemas:" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(em %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(em %s)" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "identificador intersphinx %r não é uma string. Ignorado" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "Falha ao ler intersphinx_mapping[%s], ignorado: %r" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[código fonte]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Por fazer" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "Entrada de “TODO” encontrada: %s" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<original entry>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(A <<original entry>> está localizada na %s, linha %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "entrada original" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "realçando código de módulo… " #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[documentos]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Código do módulo" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Código fonte para %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Visão geral: código do módulo" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Todos os módulos onde este código está disponível</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "valor inválido para a opção member-order: %s" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "valor inválido para a opção class-doc-from: %s" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "assinatura inválida para auto%s (%r)" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "erro ao formatar argumentos para %s: %s" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "faltando atributo %s no objeto %s" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "autodoc: falhou em determinar %r a ser documentado, a seguinte exceção foi levantada:\n%s" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "não sei qual módulo importar para documentação automática %r (tente colocar uma diretiva “module” ou “currentmodule” no documento ou forneça um nome explícito para o módulo)" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "Um objeto simulado foi detectado: %r" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "erro ao formatar assinatura para %s: %s" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "“::” no nome de automodule não faz sentido" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "argumentos de assinatura ou anotação de retorno fornecidos para automodule %s" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "__all__ deve ser uma lista de strings, não %r (no módulo %s) -- ignorando __all__" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "faltando atributo mencionado na opção :members: : módulo %s, atributo %s" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "Falha ao obter uma assinatura de função para %s: %s" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "Falha ao obter uma assinatura de construtor para %s: %s" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "Base: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "apelido de %s" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "apelido de TypeVar(%s)" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "Falha ao obter uma assinatura de método para %s: %s" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "__slots__ inválido encontrado em %s. Ignorado." #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "autodoc_member_order agora aceita \"alphabetical\" em vez de \"alphabetic\". Por favor, atualize sua configuração." #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "Falha ao analisar um valor de argumento padrão para %r: %s" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "Falha ao atualizar a assinatura para %r: parâmetro não encontrado: %s" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "Falha ao analisar type_comment para %r: %s" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "referências de autosummmary excluíram o documento %r. Ignorado." #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary: arquivo stub não encontrado %r. Verifique sua configuração autosummary_generate." #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "Um autosummary com legenda requer a opção :toctree:. Ignorado." #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "autosummary: falha ao importar %s" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "falha ao analisar o nome %s" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "falha ao importar o objecto %s" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: arquivo não encontrado: %s" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "autosummary gera arquivos .rst internamente. Mas seu source_suffix não contém .rst. Ignorado." #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "autosummary: falhou em determinar %r a ser documentado, a seguinte exceção foi levantada:\n%s" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[autosummary] gerando autosummary para: %s" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "[autosummary] escrevendo em %s" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "[autosummary] falha ao importar %r: %s" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "\nGera ReStructuredText usando diretivas de resumo automático.\n\nsphinx-autogen é um frontend para sphinx.ext.autosummary.generate.\nEle gera os arquivos reStructuredText a partir de diretivas autosummary\ncontidas nos arquivos de entrada fornecidos.\n\nO formato da diretiva autosummary está documentado no módulo Python\n``sphinx.ext.autosummary`` e pode ser lido usando:\n\n pydoc sphinx.ext.autosummary\n" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "arquivos-fonte para gerar arquivos rST" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "diretório para colocar toda a saída" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "sufixo padrão para arquivos (padrão: %(default)s)" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "diretório de modelos personalizado (padrão: %(default)s)" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "documenta membros importados (padrão: %(default)s)" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "Argumentos de Palavras-chave" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "Exemplo" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Exemplos" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "Notas" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "Outros Parâmetros" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "Recebe" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "Referências" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "Avisos" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "Yields" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "valor inválido definido (faltando chave de fechamento): %s" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "valor inválido definido (faltando chave de abertura): %s" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "string literal malformada (faltando aspas de fechamento): %s" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "string literal malformada (faltando aspas de abertura): %s" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Atenção" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Cuidado" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Perigo" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Erro" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Dica" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Importante" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Nota" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Ver também" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Dica" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Aviso" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "continuação da página anterior" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "continua na próxima página" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "Não alfabético" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "Números" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "página" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "Tabela de Conteúdo" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Buscar" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Ir" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Exibir Fonte" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Visão geral" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Bem Vindo! É isso aí." #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "documentação para" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "última atualização" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Índices e Tabelas:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Tabela Completa dos Conteúdos" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "Listar todas seções e subseções" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "Buscar nessa documentação" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Índice Global de Módulos" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "acesso rápido para todos os módulos" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "todas funções, classes, termos" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Índice – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Índice completo em página única" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Páginas de índice por letra" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "pode ser enorme" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navegação" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Pesquisar dentro de %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Sobre esses documentos" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Copyright" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Copyright %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Última atualização em %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "Criada usando <a href=\"https://www.sphinx-doc.org/pt_BR/master\">Sphinx</a> %(sphinx_version)s." #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Buscar em %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Tópico anterior" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "capítulo anterior" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Próximo tópico" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "próximo capítulo" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Por favor, ativar JavaScript para habilitar a\nfuncionalidade de busca." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "Pesquisando por várias palavras só mostra correspondências\nque contêm todas as palavras." #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "buscar" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Resultados da Busca" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Sua busca não encontrou nenhum documento. Por favor, confirme se todas as palavras estão grafadas corretamente e se você selecionou categorias suficientes." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Busca rápida" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Essa Página" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Modificações na versão %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Lista de alterações na versão %(version)s, gerada automaticamente" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Alterações na biblioteca" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Alterações na API C" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Outras alterações" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Link permanente para este título" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Link permanente para esta definição" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Esconder Resultados da Busca" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Buscando" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Preparando a busca..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Busca concluída. %s página(s) que atendem a consulta." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", em " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Expandir painel lateral" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Recolher painel lateral" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Conteúdos" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "Um índice de 4 colunas encontrado. Pode ser um erro de extensões que você usa: %r" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "Nota de rodapé [%s] não é referenciada." #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "Nota de rodapé [#] não é referenciada." #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "referências de nota de rodapé inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "referências inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "referências de citação inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "referências de termo inconsistentes na mensagem traduzida. original: {0}, traduzida: {1}" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "Não foi possível determinar o texto reserva para a referência cruzada. Pode ser um bug." #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "mais de um alvo localizado para “any” referência cruzada %r: poderia ser %s" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "%s:alvo de referência %s não encontrado: %s" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "alvo de referência %r não encontrado: %s" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "Não foi possível obter imagem remota: %s [%d]" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "Não foi possível obter imagem remota: %s [%s]" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "Formato de imagem desconhecido: %s…" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "caracteres de origem não codificáveis, substituindo por “?”: %r" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "ignorado" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "falhou" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "diretiva ou nome de papel desconhecida(o): %s:%s" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "erro de leitura: %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "erro de escrita: %s, %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "locale_dir %s não existe" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "Formato de data inválido. Envolva a string com aspas simples se desejar emiti-la diretamente: %s" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "toctree contém referência ao arquivo inexistente %r" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "exceção ao avaliar apenas a expressão da diretiva: %s" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "papel padrão %s não encontrado" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "numfig_format não está definido para %s" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "Quaisquer IDs não atribuídos ao nó %s" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "Link permanente para este termo" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Link Permanente para essa tabela" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Link Permanente para esse código" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Link Permanente para essa imagem" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Link permanente para esse \"toctree\"" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "Não foi possível obter o tamanho da imagem. A opção :scale: foi ignorada." #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "toplevel_sectioning %r desconhecido para a classe %r" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr ":maxdepth: grande demais, ignorado." #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "título do documento não é um nó único em Text" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "nó de título encontrado não na section, topic, table, admonition ou sidebar" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Notas de rodapé" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "tabularcolumns e opção :widths: foram fornecidas. :widths: foi ignorada." #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "a unidade de dimensão %s é inválida. Ignorada." #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "tipo desconhecido de entrada de índice %s encontrado" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[imagem: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[imagem]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "legenda não dentro de uma imagem." #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "tipo de nó não implementado: %r" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "tipo de nó desconhecido: %r" ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3300161 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt_PT/�������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016131� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5000331 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt_PT/LC_MESSAGES/�������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017716� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.js����������������������������������������������0000644�0000766�0000024�00000007650�00000000000�021575� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "pt_PT", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": ", em", "About these documents": "Sobre estes documentos", "Automatically generated list of changes in version %(version)s": "Lista de altera\u00e7\u00f5es gerada automaticamente na vers\u00e3o %(version)s", "C API changes": "Altera\u00e7\u00f5es na API C", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "Recolher painel lateral", "Complete Table of Contents": "Tabela de Conte\u00fados Completa", "Contents": "Conte\u00fado", "Copyright": "Copyright", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Expandir painel lateral", "Full index on one page": "\u00cdndice completo numa p\u00e1gina", "General Index": "\u00cdndice Geral", "Global Module Index": "\u00cdndice Global de M\u00f3dulos", "Go": "Ir", "Hide Search Matches": "Esconder Resultados da Pesquisa", "Index": "\u00cdndice", "Index – %(key)s": "\u00cdndice – %(key)s", "Index pages by letter": "Paginas de \u00edndice por letra", "Indices and tables:": "\u00cdndices e tabelas:", "Last updated on %(last_updated)s.": "\u00daltima actualiza\u00e7\u00e3o em %(last_updated)s.", "Library changes": "Altera\u00e7\u00f5es na biblioteca", "Navigation": "Navega\u00e7\u00e3o", "Next topic": "Pr\u00f3ximo t\u00f3pico", "Other changes": "Outras altera\u00e7\u00f5es", "Overview": "Vis\u00e3o geral", "Permalink to this definition": "Link permanente para esta defini\u00e7\u00e3o", "Permalink to this headline": "Link permanente para este t\u00edtulo", "Please activate JavaScript to enable the search\n functionality.": "Por favor ligue o JavaScript para habilitar a\nfuncionalidade de pesquisa.", "Preparing search...": "A preparar a pesquisa...", "Previous topic": "T\u00f3pico anterior", "Quick search": "Pesquisa r\u00e1pida", "Search": "Pesquisar", "Search Page": "P\u00e1gina de Pesquisa", "Search Results": "Resultados da Pesquisa", "Search finished, found %s page(s) matching the search query.": "Pesquisa conclu\u00edda, foram encontrada(s) %s p\u00e1gina(s) que combinam com a consulta feita.", "Search within %(docstitle)s": "Pesquisar dentro de %(docstitle)s", "Searching": "A Pesquisar", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Exibir Fonte", "Table of Contents": "", "This Page": "Esta P\u00e1gina", "Welcome! This is": "Bem Vindo(a)! Esta \u00e9", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "A sua pesquisa n\u00e3o encontrou nenhum documento. Por favor, confirme que todas as palavras est\u00e3o escritas corretamente e que selecionou categorias suficientes.", "all functions, classes, terms": "todas as fun\u00e7\u00f5es, classes, termos", "can be huge": "pode ser enorme", "last updated": "\u00faltima actualiza\u00e7\u00e3o", "lists all sections and subsections": "Listar todas as sec\u00e7\u00f5es e subsec\u00e7\u00f5es", "next chapter": "pr\u00f3ximo cap\u00edtulo", "previous chapter": "cap\u00edtulo anterior", "quick access to all modules": "acesso r\u00e1pido a todos os m\u00f3dulos", "search": "pesquisar", "search this documentation": "Pesquisar esta documenta\u00e7\u00e3o", "the documentation for": "a documenta\u00e7\u00e3o de" }, "plural_expr": "(n != 1)" });����������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.mo����������������������������������������������0000644�0000766�0000024�00000020034�00000000000�021563� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ �� ��� ����� �� ��� ����� ����� ����� ����� ����� ����� ����� �� ���" �����C �� ���U �� ���a �����k ����� ����� ����� �� ��� ����� �� ��� ����� ��0��� �����( �����D �� ���Z �� ���d �����n ��>���w ����� �� ��� ����� ����� �� ��� ����� ����� �����% �� ���. �����8 �� ���? �����J �����f �����l �� ���{ ����� �� ��� ����� ����� ����� ����� �� ��� ����� ����� ������ ����� ��!���* �����L �� ���\ �����i �� ���y �� ��� �� ��� ����� �� ��� ����� �� ��� ����� ����� �� ��� ����� �������B���/�����r�������$���������� ��������������� �������������������� ��������&��<���5�����r�� ��������������� ���������� �������������������� ������������������������� ���������� �������������������� ���������� ��������� �� �������������<�� ���A�����K�����`�� ���y������� ����� ��������������� �����"��������������������������������� �� �������������"�����+�����:�����C�����T�����c��������������������������� ����� ����� ������������������������ ���������� ������������������������&�����:�����Q�����c��"���r������� ����� ����������������������� �� ���"�����0�� ���E�����Q��>���V������������ ����� ����������C��������+�����4�����J�����R�����i�����|������� ����� �������������������������������������� �� ���>�����L�����g�����j������� �������������������������+�������������2�����F�����Y�����l�� ���u���������������������� ����� ����� �����%�����!�����I���@������������$���������������������������������(�� ���0�����:�����R�����f��Y���}��!����� ���������� ����� ���&�� ���3�� ���=�����J�����O�� ���T�� ���^�����i�����o������� ���%�����2�� ���A�� ���L�����Y�����b��#���r���������������������������!���������� �������� �����!�� ���;�����F�����O�����c�����w�� ����������(����������������������������������������������������� �����1�����:�����M��"���a������������ �������������������������������������� �� ��� ��� (deprecated)� (in �%b %d, %Y�%s %s�%s %s documentation�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�(in %s v%s)�, in �<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Caution�Changed in version %s�Code author: �Collapse sidebar�Complete Table of Contents�Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Expand sidebar�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Overview: module code�Parameters�Permalink to this definition�Permalink to this headline�Please activate JavaScript to enable the search functionality.�Preparing search...�Previous topic�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Release�Return type�Returns�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section author: �See also�Show Source�Symbols�This Page�Throws�Tip�Todo�Variables�Warning�Welcome! This is�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�all functions, classes, terms�attribute�built-in function�can be huge�class�class method�continued from previous page�data�directive�environment variable�environment variable; %s�exception�function�glossary term�grammar token�index�keyword�last updated�lists all sections and subsections�macro�member�method�module�modules�next�next chapter�object�operator�original entry�previous�previous chapter�program option�quick access to all modules�reference label�role�search�search this documentation�see %s�see also %s�statement�static method�the documentation for�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: pt_PT Language-Team: Portuguese (Portugal) (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt_PT/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (obsoleto)� (em �%d %b, %Y�%s %s�Documentação %s %s�%s (atributo %s)�%s (classe interna)�%s (variável interna)�%s (classe em %s)�%s (directiva)�%s (variável global ou constante)�%s (no módulo %s)�%s (módulo)�%s (papel)�%s() (método de classe %s)�%s() (método %s)�%s() (método estático %s)�%s() (função interna)�%s() (classe)�%s() (no módulo %s)�(em %s v%s)�, em�<h1>Todos os módulos onde este código está disponível</h1>�<h1>Código fonte de %s</h1>�Sobre estes documentos�Parâmetros�Atenção�Autor: �Lista de alterações gerada automaticamente na versão %(version)s�Internos�Alterações na API C�Cuidado�Alterado na versão %s�Autor do código: �Recolher painel lateral�Tabela de Conteúdos Completa�Conteúdo�Copyright�Perigo�Obsoleto�Obsoleto desde a versão %s�Erro�Expandir painel lateral�Notas de rodapé�Índice completo numa página�Índice Geral�Índice Global de Módulos�Ir�Esconder Resultados da Pesquisa�Dica�Importante�Índice�Índice – %(key)s�Paginas de índice por letra�Índices e tabelas:�Última actualização em %(last_updated)s.�Alterações na biblioteca�Índice de Módulos�Autor do módulo: �Código do módulo�Módulos�Navegação�Novo na versão %s�Próximo tópico�Nota�Outras alterações�Visão geral�Visão geral: código do módulo�Parâmetros�Link permanente para esta definição�Link permanente para este título�Por favor ligue o JavaScript para habilitar a funcionalidade de pesquisa.�A preparar a pesquisa...�Tópico anterior�Python Enhancement Proposals; PEP %s�Índice de Módulos do Python�Pesquisa rápida�Levanta�Versão�Tipo de retorno�Retorno�Pesquisar�Pesquisar %(docstitle)s�Página de Pesquisa�Resultados da Pesquisa�Pesquisa concluída, foram encontrada(s) %s página(s) que combinam com a consulta feita.�Pesquisar dentro de %(docstitle)s�A Pesquisar�Autor da secção: �Veja também�Exibir Fonte�Símbolos�Esta Página�Gera�Dica�Por fazer�Variáveis�Aviso�Bem Vindo(a)! Esta é�A sua pesquisa não encontrou nenhum documento. Por favor, confirme que todas as palavras estão escritas corretamente e que selecionou categorias suficientes.�[documentos]�[gráfico: %s]�[gráfico]�[imagem: %s]�[imagem]�[código fonte]�todas as funções, classes, termos�atributo�função interna�pode ser enorme�classe�método de classe�continuação da página anterior�dados�directiva�variável de ambiente�variável de ambiente; %s�excepção�função�Termo de glossário�token de gramática�índice�palavra-chave�última actualização�Listar todas as secções e subsecções�macro�membro�método�módulo�módulos�próximo�próximo capítulo�objecto�operador�entrada original�anterior�capítulo anterior�opção de programa�acesso rápido a todos os módulos�rótulo de referência�papel�pesquisar�Pesquisar esta documentação�ver %s�ver também %s�comando�método estático�a documentação de�tipo�variável�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/pt_PT/LC_MESSAGES/sphinx.po����������������������������������������������0000644�0000766�0000024�00000247053�00000000000�021602� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Pedro Algarvio <pedro@algarvio.me>, 2013 # Komiya Takeshi <i.tkomiya@gmail.com>, 2016 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Portuguese (Portugal) (http://www.transifex.com/sphinx-doc/sphinx-1/language/pt_PT/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: pt_PT\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Internos" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Módulos" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (em " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d %b, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Índice Geral" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "índice" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "próximo" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "anterior" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "Documentação %s %s" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Índice" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Versão" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Autor da secção: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Autor do módulo: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Autor do código: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autor: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parâmetros" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Retorno" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Tipo de retorno" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "membro" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "variável" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "função" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "macro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "tipo" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Novo na versão %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Alterado na versão %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Obsoleto desde a versão %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Gera" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "classe" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (função interna)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (método %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (classe)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (variável global ou constante)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (atributo %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Parâmetros" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (módulo)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "método" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "dados" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atributo" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "módulo" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "palavra-chave" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operador" #: sphinx/domains/python.py:61 msgid "object" msgstr "objecto" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "excepção" #: sphinx/domains/python.py:63 msgid "statement" msgstr "comando" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "função interna" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Variáveis" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Levanta" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (no módulo %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (no módulo %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (variável interna)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (classe interna)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (classe em %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (método de classe %s)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (método estático %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Índice de Módulos do Python" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "módulos" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Obsoleto" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "método de classe" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "método estático" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (obsoleto)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (directiva)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (papel)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "directiva" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "papel" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "variável de ambiente; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "Termo de glossário" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "token de gramática" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "rótulo de referência" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "variável de ambiente" #: sphinx/domains/std.py:568 msgid "program option" msgstr "opção de programa" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Índice de Módulos" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Página de Pesquisa" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "ver %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "ver também %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Símbolos" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[gráfico: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[gráfico]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(em %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[código fonte]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Por fazer" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "entrada original" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[documentos]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Código do módulo" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Código fonte de %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Visão geral: código do módulo" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Todos os módulos onde este código está disponível</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Atenção" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Cuidado" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Perigo" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Erro" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Dica" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Importante" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Nota" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Veja também" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Dica" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Aviso" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "continuação da página anterior" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Pesquisar" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Ir" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Exibir Fonte" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Visão geral" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Bem Vindo(a)! Esta é" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "a documentação de" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "última actualização" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Índices e tabelas:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Tabela de Conteúdos Completa" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "Listar todas as secções e subsecções" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "Pesquisar esta documentação" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Índice Global de Módulos" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "acesso rápido a todos os módulos" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "todas as funções, classes, termos" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Índice – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Índice completo numa página" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Paginas de índice por letra" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "pode ser enorme" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navegação" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Pesquisar dentro de %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Sobre estes documentos" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Copyright" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Última actualização em %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Pesquisar %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Tópico anterior" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "capítulo anterior" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Próximo tópico" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "próximo capítulo" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Por favor ligue o JavaScript para habilitar a\nfuncionalidade de pesquisa." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "pesquisar" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Resultados da Pesquisa" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "A sua pesquisa não encontrou nenhum documento. Por favor, confirme que todas as palavras estão escritas corretamente e que selecionou categorias suficientes." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Pesquisa rápida" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Esta Página" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Lista de alterações gerada automaticamente na versão %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Alterações na biblioteca" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Alterações na API C" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Outras alterações" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Link permanente para este título" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Link permanente para esta definição" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Esconder Resultados da Pesquisa" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "A Pesquisar" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "A preparar a pesquisa..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Pesquisa concluída, foram encontrada(s) %s página(s) que combinam com a consulta feita." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", em" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Expandir painel lateral" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Recolher painel lateral" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Conteúdo" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Notas de rodapé" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[imagem: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[imagem]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3301938 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ro/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015523� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5008607 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ro/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017310� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ro/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000007646�00000000000�021174� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "ro", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": ", \u00een", "About these documents": "Despre aceste documente", "Automatically generated list of changes in version %(version)s": "Lista de schimb\u0103ri generat\u0103 automat pentru versiunea %(version)s", "C API changes": "Schimb\u0103ri \u00een API C", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "Ascundere bar\u0103 lateral\u0103", "Complete Table of Contents": "Cuprinsul Complet", "Contents": "Cuprins", "Copyright": "Drepturi de autor", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Expandare bar\u0103 lateral\u0103", "Full index on one page": "Index complet", "General Index": "Index General", "Global Module Index": "Index Module Globale", "Go": "Caut\u0103", "Hide Search Matches": "Ascunde Rezultatele C\u0103ut\u0103rii", "Index": "Index", "Index – %(key)s": "Index – %(key)s", "Index pages by letter": "Indexeaz\u0103 paginile dupa liter\u0103", "Indices and tables:": "Indici \u0219i tabele:", "Last updated on %(last_updated)s.": "Ultima actualizare la %(last_updated)s.", "Library changes": "Schimb\u0103ri \u00een bibliotec\u0103", "Navigation": "Navigare", "Next topic": "Subiectul urm\u0103tor", "Other changes": "Alte schimb\u0103ri", "Overview": "Prezentare general\u0103", "Permalink to this definition": "Link permanent la aceast\u0103 defini\u021bie", "Permalink to this headline": "Link permanent la acest titlu", "Please activate JavaScript to enable the search\n functionality.": "Activeaz\u0103 JavaScript pentru a permite\nfunc\u021bia de c\u0103utare.", "Preparing search...": "Se preg\u0103te\u0219te c\u0103utarea...", "Previous topic": "Subiectul precedent", "Quick search": "C\u0103utare rapid\u0103", "Search": "C\u0103utare", "Search Page": "Pagin\u0103 de C\u0103utare", "Search Results": "Rezultatele C\u0103ut\u0103rii", "Search finished, found %s page(s) matching the search query.": "C\u0103utare finalizat\u0103, au fost g\u0103site %s pagini care au corespuns c\u0103ut\u0103rii.", "Search within %(docstitle)s": "Caut\u0103 \u00een %(docstitle)s", "Searching": "C\u0103utare", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Vezi Sursa", "Table of Contents": "", "This Page": "Aceast\u0103 Pagin\u0103", "Welcome! This is": "Bine ai venit! Acesta este", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "C\u0103utarea nu a identificat nici un document. Te rog s\u0103 te asiguri c\u0103 toate cuvintele sunt scrise corect \u0219i c\u0103 ai selectat suficiente categorii.", "all functions, classes, terms": "toate func\u021biile, clasele, termenii", "can be huge": "poate fi extrem de mare", "last updated": "ultima actualizare", "lists all sections and subsections": "lista tuturor sec\u021biunilor si a subsec\u021biunilor", "next chapter": "capitolul urm\u0103tor", "previous chapter": "capitolul precedent", "quick access to all modules": "acces rapid la toate modulele", "search": "c\u0103utare", "search this documentation": "caut\u0103 \u00een aceast\u0103 documenta\u021bie", "the documentation for": "documenta\u021bia pentru" }, "plural_expr": "(n==1?0:(((n%100>19)||((n%100==0)&&(n!=0)))?2:1))" });������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ro/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000021502�00000000000�021156� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������<��������������\ �� ���] �����k �� ���q �����{ ����� ����� ����� ����� ����� ����� �� ��� ����� �� ���% �� ���1 �����; �����R �����c �����{ �� ��� ����� �� ��� ����� ��0��� ����� ����� �� ���* �� ���4 �����> ��>���G ����� �� ��� ����� ����� �� ��� ����� ����� ����� �� ��� ����� �� ��� ����� �����6 �����< �����K �� ���S �����] �� ���t ����� ����� ����� ����� �� ��� ����� ����� ����� ����� ��!��������$�� ���4�� ���?�����L�� ���\�� ���h�� ���u������� ���������� ��������������� �����������������������)�����A�����Y��B���s������������$���������� �������������&�� ���.�����:�����B�����I�� ���^�����j��<���y������� ��������������� ������������� �� �����W��������u�����|������� �����������������������3�� ���:�����F�� ���N�����Z�����b�����k�� ���������� ���������� ��������������� ���������� ���������������� ���.�� ���8�����C�����Z�� ���c�� ���q������������ �����"����������������������������������� ���������������������������������+�����:�����V�����f�����k�����r������� ����� ����� ����� ������������������������ ���������� ������������������ ����������1�����L�����^��'���n������� ������������������������������ ��������*�� ���@�����M��@���S������������ ���������������B����� ���)�����3�� ���H�����T�����n��������������������������� �����$�����������������������%�� ���4�� ���B�����P�����e�����l������� ��������������� ����������'�������������1�����8�����K�����^�� ���n�����|���������������������������%����� �������� ��%���%�����K��"���i������������<�������������$��,���8�����e�����~�� ���������� ����� �������������������������M��������R�����k�����t������� ����� ����� ����������]����� ��� �����+�� ���0�� ���:�� ���D�����Q�����l������ �� ��� ����� �� ���& �� ���3 �����= ��#���F �����j �����r ����� ����� �� ��� ��!��� ����� �� ��� �� ��� �� ��� ����� �����!�� ���'!�� ���1!�����<!�����Y!�����b!�����s!�����!�� ���!�����!��/���!�����!�����!�����!�����!�����!�����"����� "�����"�����%"�����."�� ���H"�����R"�����f"�����}"�����"�����"�����"��!���"�����"�� ���"�� ���"�����#�� ���#�����#�����3#�� ���7#��� (deprecated)� (in �%b %d, %Y�%s %s�%s %s documentation�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�(in %s v%s)�, in �<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Caution�Changed in version %s�Code author: �Collapse sidebar�Complete Table of Contents�Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Expand sidebar�Fig. %s�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Listing %s�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Please activate JavaScript to enable the search functionality.�Preparing search...�Previous topic�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Release�Return type�Returns�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section author: �See also�Show Source�Symbols�Table %s�This Page�This project needs at least Sphinx v%s and therefore cannot be built with this version.�Throws�Tip�Todo�Variables�Warning�Welcome! This is�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�all functions, classes, terms�attribute�built-in function�can be huge�class�class method�continued from previous page�data�directive�enum�enumerator�environment variable�environment variable; %s�exception�failed: %s�finished with problems�function�glossary term�grammar token�index�keyword�last updated�lists all sections and subsections�macro�member�method�module�modules�next�next chapter�object�operator�original entry�previous�previous chapter�program option�quick access to all modules�reference label�role�search�search this documentation�see %s�see also %s�statement�static method�succeeded�the documentation for�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: ro Language-Team: Romanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/ro/) Plural-Forms: nplurals=3; plural=(n==1?0:(((n%100>19)||((n%100==0)&&(n!=0)))?2:1)) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �(învechit)�(în�%b %d, %Y�%s %s�%s %s documentație�%s (atribut %s)�%s (clasă integrată)�%s (variabilă integrată)�%s (clasa în %s)�%s (directivă)�%s (variabilă globală sau constantă)�%s (în modulul %s)�%s (modul)�%s (rol)�%s() (metoda clasei %s)�%s() (metoda %s)�%s() (metoda statică %s)�%s() (funcție integrată)�%s() (clasă)�%s() (în modulul %s)�(în %s v%s)�, în�<h1>Toate modulele pentru care este disponibil codul sursă</h1>�<h1>Codul sursă pentru %s</h1>�Despre aceste documente�Argumente�Atenție�Autor:�Lista de schimbări generată automat pentru versiunea %(version)s�Integrate�Schimbări în API C�Avertisment�Schimbat în versiunea %s�Autorul codului:�Ascundere bară laterală�Cuprinsul Complet�Cuprins�Drepturi de autor�Pericol�Învechit�Învechit începând cu versiunea %s�Eroare�Expandare bară laterală�Fig. %s�Note de subsol�Index complet�Index General�Index Module Globale�Caută�Ascunde Rezultatele Căutării�Sugestie�Important�Index�Index – %(key)s�Indexează paginile dupa literă�Indici și tabele:�Ultima actualizare la %(last_updated)s.�Schimbări în bibliotecă�Cod %s�Index al modulelor�Autorul modulului:�Codul modulului�Nivelul modul�Navigare�Nou în versiunea %s�Subiectul următor�Notă�Alte schimbări�Prezentare generală�Prezentare generală: codul modulului�Parametrii�Link permanent la acest cod�Link permanent la această definiție�Link permanent la acest titlu�Link permanent la această imagine�Link permanent la acest tabel�Link permanent la acest cuprins�Activează JavaScript pentru a permite funcția de căutare.�Se pregătește căutarea...�Subiectul precedent�Propuneri de Îmbunătățire Python; PEP %s�Indexul de Module Python�Căutare rapidă�Generează�Versiune�Tipul întors�Întoarce�Căutare�Caută %(docstitle)s�Pagină de Căutare�Rezultatele Căutării�Căutare finalizată, au fost găsite %s pagini care au corespuns căutării.�Caută în %(docstitle)s�Căutare�Autorul secțiunii:�Vezi și�Vezi Sursa�Simboluri�Tabelul %s�Această Pagină�Proiectul necesită minim Sphinx v%s și de aceea nu poate fi construit cu această versiune.�Generează�Sfat�De făcut�Variabile�Atenționare�Bine ai venit! Acesta este�Căutarea nu a identificat nici un document. Te rog să te asiguri că toate cuvintele sunt scrise corect și că ai selectat suficiente categorii.�[documentație]�[grafic: %s]�[grafic]�[figura: %s]�[figură]�[sursă]�toate funcțiile, clasele, termenii�atribut�funcție integrată�poate fi extrem de mare�clasă�metoda clasei�continuare din pagina precedentă�data�directivă�enumerator�enumerator�variabilă de mediu�variabilă de mediu; %s�excepție�eșuat: %s�a fost finalizat cu probleme�funcție�termen de glosar�element de gramatică�index�cuvânt cheie�ultima actualizare�lista tuturor secțiunilor si a subsecțiunilor�macro�membru�metodă�modul�module�următor�capitolul următor�obiect�operator�înregistrarea inițială�precedent�capitolul precedent�opțiune a programului�acces rapid la toate modulele�etichetă de referință�rol�căutare�caută în această documentație�vezi %s�vezi și %s�declarație�metodă statică�a reușit�documentația pentru�tip�variabilă�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ro/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000247565�00000000000�021204� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Razvan Stefanescu <razvan.stefanescu@gmail.com>, 2015-2017 # Komiya Takeshi <i.tkomiya@gmail.com>, 2016 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Romanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/ro/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: ro\n" "Plural-Forms: nplurals=3; plural=(n==1?0:(((n%100>19)||((n%100==0)&&(n!=0)))?2:1));\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Proiectul necesită minim Sphinx v%s și de aceea nu poate fi construit cu această versiune." #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "eșuat: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "a reușit" #: sphinx/application.py:349 msgid "finished with problems" msgstr "a fost finalizat cu probleme" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Fig. %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tabelul %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Cod %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Propuneri de Îmbunătățire Python; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Integrate" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Nivelul modul" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "(în" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Index General" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "index" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "următor" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "precedent" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s documentație" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Index" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Versiune" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Autorul secțiunii:" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Autorul modulului:" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Autorul codului:" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autor:" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametrii" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Întoarce" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Tipul întors" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "membru" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "variabilă" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funcție" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "macro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "enumerator" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "enumerator" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "tip" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Nou în versiunea %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Schimbat în versiunea %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Învechit începând cu versiunea %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Generează" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "clasă" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (funcție integrată)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (metoda %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (clasă)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (variabilă globală sau constantă)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (atribut %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumente" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modul)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "metodă" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "data" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atribut" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modul" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "cuvânt cheie" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operator" #: sphinx/domains/python.py:61 msgid "object" msgstr "obiect" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "excepție" #: sphinx/domains/python.py:63 msgid "statement" msgstr "declarație" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "funcție integrată" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Variabile" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Generează" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (în modulul %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (în modulul %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (variabilă integrată)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (clasă integrată)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (clasa în %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (metoda clasei %s)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (metoda statică %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Indexul de Module Python" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "module" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Învechit" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "metoda clasei" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "metodă statică" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "(învechit)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (directivă)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (rol)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "directivă" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "rol" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "variabilă de mediu; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "termen de glosar" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "element de gramatică" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "etichetă de referință" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "variabilă de mediu" #: sphinx/domains/std.py:568 msgid "program option" msgstr "opțiune a programului" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Index al modulelor" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Pagină de Căutare" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "vezi %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "vezi și %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Simboluri" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[grafic: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[grafic]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(în %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[sursă]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "De făcut" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "înregistrarea inițială" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[documentație]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Codul modulului" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Codul sursă pentru %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Prezentare generală: codul modulului" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Toate modulele pentru care este disponibil codul sursă</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Atenție" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Avertisment" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Pericol" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Eroare" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Sugestie" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Important" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Notă" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Vezi și" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Sfat" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Atenționare" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "continuare din pagina precedentă" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Căutare" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Caută" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Vezi Sursa" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Prezentare generală" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Bine ai venit! Acesta este" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "documentația pentru" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "ultima actualizare" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Indici și tabele:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Cuprinsul Complet" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "lista tuturor secțiunilor si a subsecțiunilor" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "caută în această documentație" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Index Module Globale" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "acces rapid la toate modulele" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "toate funcțiile, clasele, termenii" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Index – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Index complet" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Indexează paginile dupa literă" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "poate fi extrem de mare" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigare" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Caută în %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Despre aceste documente" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Drepturi de autor" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Ultima actualizare la %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Caută %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Subiectul precedent" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "capitolul precedent" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Subiectul următor" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "capitolul următor" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Activează JavaScript pentru a permite\nfuncția de căutare." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "căutare" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Rezultatele Căutării" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Căutarea nu a identificat nici un document. Te rog să te asiguri că toate cuvintele sunt scrise corect și că ai selectat suficiente categorii." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Căutare rapidă" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Această Pagină" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Lista de schimbări generată automat pentru versiunea %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Schimbări în bibliotecă" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Schimbări în API C" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Alte schimbări" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Link permanent la acest titlu" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Link permanent la această definiție" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Ascunde Rezultatele Căutării" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Căutare" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Se pregătește căutarea..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Căutare finalizată, au fost găsite %s pagini care au corespuns căutării." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", în" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Expandare bară laterală" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Ascundere bară laterală" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Cuprins" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Link permanent la acest tabel" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Link permanent la acest cod" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Link permanent la această imagine" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Link permanent la acest cuprins" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Note de subsol" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[figura: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[figură]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3303838 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ru/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015531� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5020025 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ru/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017316� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ru/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000021374�00000000000�021174� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "ru", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.", "© Copyright %(copyright)s.": "© Copyright %(copyright)s.", ", in ": ", \u0432", "About these documents": "\u041e\u0431 \u044d\u0442\u0438\u0445 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0445", "Automatically generated list of changes in version %(version)s": "\u0410\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u0441\u043e\u0437\u0434\u0430\u043d\u043d\u044b\u0439 \u0441\u043f\u0438\u0441\u043e\u043a \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0439 \u0432 \u0432\u0435\u0440\u0441\u0438\u0438 %(version)s", "C API changes": "\u0418\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0432 API C", "Changes in Version %(version)s — %(docstitle)s": "\u0418\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0432 \u0432\u0435\u0440\u0441\u0438\u0438 %(version)s — %(docstitle)s", "Collapse sidebar": "\u0421\u0432\u0435\u0440\u043d\u0443\u0442\u044c \u0431\u043e\u043a\u043e\u0432\u0443\u044e \u043f\u0430\u043d\u0435\u043b\u044c", "Complete Table of Contents": "\u041f\u043e\u043b\u043d\u043e\u0435 \u043e\u0433\u043b\u0430\u0432\u043b\u0435\u043d\u0438\u0435", "Contents": "\u0421\u043e\u0434\u0435\u0440\u0436\u0430\u043d\u0438\u0435", "Copyright": "\u0410\u0432\u0442\u043e\u0440\u0441\u043a\u0438\u0435 \u043f\u0440\u0430\u0432\u0430", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "\u0420\u0430\u0437\u0432\u0435\u0440\u043d\u0443\u0442\u044c \u0431\u043e\u043a\u043e\u0432\u0443\u044e \u043f\u0430\u043d\u0435\u043b\u044c", "Full index on one page": "\u041f\u043e\u043b\u043d\u044b\u0439 \u0430\u043b\u0444\u0430\u0432\u0438\u0442\u043d\u044b\u0439 \u0443\u043a\u0430\u0437\u0430\u0442\u0435\u043b\u044c \u043d\u0430 \u043e\u0434\u043d\u043e\u0439 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0435", "General Index": "\u0410\u043b\u0444\u0430\u0432\u0438\u0442\u043d\u044b\u0439 \u0443\u043a\u0430\u0437\u0430\u0442\u0435\u043b\u044c", "Global Module Index": "\u0410\u043b\u0444\u0430\u0432\u0438\u0442\u043d\u044b\u0439 \u0443\u043a\u0430\u0437\u0430\u0442\u0435\u043b\u044c \u043c\u043e\u0434\u0443\u043b\u0435\u0439", "Go": "\u0418\u0441\u043a\u0430\u0442\u044c", "Hide Search Matches": "\u0421\u043d\u044f\u0442\u044c \u0432\u044b\u0434\u0435\u043b\u0435\u043d\u0438\u0435", "Index": "\u0410\u043b\u0444\u0430\u0432\u0438\u0442\u043d\u044b\u0439 \u0443\u043a\u0430\u0437\u0430\u0442\u0435\u043b\u044c", "Index – %(key)s": "\u0410\u043b\u0444\u0430\u0432\u0438\u0442\u043d\u044b\u0439 \u0443\u043a\u0430\u0437\u0430\u0442\u0435\u043b\u044c – %(key)s", "Index pages by letter": "\u0423\u043a\u0430\u0437\u0430\u0442\u0435\u043b\u0438 \u043f\u043e \u0431\u0443\u043a\u0432\u0430\u043c \u0430\u043b\u0444\u0430\u0432\u0438\u0442\u0430", "Indices and tables:": "\u0422\u0430\u0431\u043b\u0438\u0446\u044b \u0438 \u0443\u043a\u0430\u0437\u0430\u0442\u0435\u043b\u0438:", "Last updated on %(last_updated)s.": "\u041e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u043e: %(last_updated)s.", "Library changes": "\u0418\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f \u0432 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0435", "Navigation": "\u041d\u0430\u0432\u0438\u0433\u0430\u0446\u0438\u044f", "Next topic": "\u0421\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0439 \u0440\u0430\u0437\u0434\u0435\u043b", "Other changes": "\u0414\u0440\u0443\u0433\u0438\u0435 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f", "Overview": "\u041e\u0431\u0437\u043e\u0440", "Permalink to this definition": "\u0421\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u044d\u0442\u043e \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u0435\u043d\u0438\u0435", "Permalink to this headline": "\u0421\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u044d\u0442\u043e\u0442 \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043e\u043a", "Please activate JavaScript to enable the search\n functionality.": "\u0414\u043b\u044f \u0440\u0430\u0431\u043e\u0442\u044b \u043f\u043e\u0438\u0441\u043a\u0430 \u0432\u043a\u043b\u044e\u0447\u0438\u0442\u0435 JavaScript \u0432 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0435.", "Preparing search...": "\u041f\u043e\u0434\u0433\u043e\u0442\u043e\u0432\u043a\u0430 \u043f\u043e\u0438\u0441\u043a\u0430\u2026", "Previous topic": "\u041f\u0440\u0435\u0434\u044b\u0434\u0443\u0449\u0438\u0439 \u0440\u0430\u0437\u0434\u0435\u043b", "Quick search": "\u0411\u044b\u0441\u0442\u0440\u044b\u0439 \u043f\u043e\u0438\u0441\u043a", "Search": "\u041f\u043e\u0438\u0441\u043a", "Search Page": "\u041f\u043e\u0438\u0441\u043a", "Search Results": "\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u044b \u043f\u043e\u0438\u0441\u043a\u0430", "Search finished, found %s page(s) matching the search query.": "\u041f\u043e\u0438\u0441\u043a \u0437\u0430\u0432\u0435\u0440\u0448\u0451\u043d, \u043d\u0430\u0439\u0434\u0435\u043d\u043e %s \u0441\u0442\u0440\u0430\u043d\u0438\u0446, \u0443\u0434\u043e\u0432\u043b\u0435\u0442\u0432\u043e\u0440\u044f\u044e\u0449\u0438\u0445 \u0437\u0430\u043f\u0440\u043e\u0441\u0443.", "Search within %(docstitle)s": "\u041f\u043e\u0438\u0441\u043a \u0432 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0435 \u00ab%(docstitle)s\u00bb", "Searching": "\u0418\u0434\u0451\u0442 \u043f\u043e\u0438\u0441\u043a", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "\u0418\u0441\u0445\u043e\u0434\u043d\u044b\u0439 \u0442\u0435\u043a\u0441\u0442", "Table of Contents": "\u041e\u0433\u043b\u0430\u0432\u043b\u0435\u043d\u0438\u0435", "This Page": "\u042d\u0442\u0430 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430", "Welcome! This is": "\u0414\u043e\u0431\u0440\u043e \u043f\u043e\u0436\u0430\u043b\u043e\u0432\u0430\u0442\u044c! \u042d\u0442\u043e", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "\u041f\u043e \u0432\u0430\u0448\u0435\u043c\u0443 \u043f\u043e\u0438\u0441\u043a\u0443 \u043d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d\u043e \u043d\u0438 \u043e\u0434\u043d\u043e\u0433\u043e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430. \u041f\u0440\u043e\u0432\u0435\u0440\u044c\u0442\u0435, \u0447\u0442\u043e \u0432\u0441\u0435 \u0441\u043b\u043e\u0432\u0430 \u043d\u0430\u043f\u0438\u0441\u0430\u043d\u044b \u0431\u0435\u0437 \u043e\u0448\u0438\u0431\u043e\u043a, \u0438 \u0447\u0442\u043e \u0432\u044b \u0432\u044b\u0431\u0440\u0430\u043b\u0438 \u0434\u043e\u0441\u0442\u0430\u0442\u043e\u0447\u043d\u043e \u043a\u0430\u0442\u0435\u0433\u043e\u0440\u0438\u0439.", "all functions, classes, terms": "\u0432\u0441\u0435 \u0444\u0443\u043d\u043a\u0446\u0438\u0438, \u043a\u043b\u0430\u0441\u0441\u044b, \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0435 \u0438 \u043a\u043e\u043d\u0441\u0442\u0430\u043d\u0442\u044b", "can be huge": "\u043c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u043e\u0447\u0435\u043d\u044c \u0431\u043e\u043b\u044c\u0448\u0438\u043c", "last updated": "\u043f\u043e\u0441\u043b\u0435\u0434\u043d\u0435\u0435 \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0435", "lists all sections and subsections": "\u0441\u043f\u0438\u0441\u043e\u043a \u0432\u0441\u0435\u0445 \u0440\u0430\u0437\u0434\u0435\u043b\u043e\u0432 \u0438 \u043f\u043e\u0434\u0440\u0430\u0437\u0434\u0435\u043b\u043e\u0432", "next chapter": "\u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0430\u044f \u0433\u043b\u0430\u0432\u0430", "previous chapter": "\u043f\u0440\u0435\u0434\u044b\u0434\u0443\u0449\u0430\u044f \u0433\u043b\u0430\u0432\u0430", "quick access to all modules": "\u0441\u0432\u043e\u0434\u043d\u044b\u0439 \u0441\u043f\u0438\u0441\u043e\u043a \u0432\u0441\u0435\u0445 \u043c\u043e\u0434\u0443\u043b\u0435\u0439", "search": "\u0438\u0441\u043a\u0430\u0442\u044c", "search this documentation": "\u043f\u043e\u0438\u0441\u043a \u0432 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0438", "the documentation for": "\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u044f" }, "plural_expr": "(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : n%10==0 || (n%10>=5 && n%10<=9) || (n%100>=11 && n%100<=14)? 2 : 3)" });��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ru/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000040506�00000000000�021171� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������� ��������+��"���1�� ���T�����^�����d�����x���������������������� ���������� ����� �������������5�����F�����^�� ���w�������6����������3����� ���#�����/�����5��0���H�����y������� ����� ����������>����� �����(�����(���:�����c��?���������� ���������������4����� ���,�����:�����K�����f������� �������������������� ���������������������������������'�����6��!���>�� ���`�����j�� ������������������������� ���������������������������������#��!���5�����W�� ���g�� ���r������� ����� ����� ���������� �����(����������������������������%�����:�� ���K�����Y�����b�� ���x�������������������������������������B���7�����z����������������������$���������� ��������������� ���#�����/�����7�����>�� ���S�����_��<���n������� ����� ��������������� ������������� ����������%��K���9��=����� �����W��������%�����,�����0�����5�� ���L�����V�����^�����d�����u�������� ���������� ��������'�����/�����8�� ���V�� ���`�� ���m�����w�� �����&��������������������-��������=�����\�� ���b�����o�����w��4��������������� ��������������������4��������<�� ���A�����L�����a�� ���z��M����� ��������������� ����� ��� ������������ ���'��"���4�����W�����]�����d�����k�����r�� ���z������� ���������������������������������������� ������������� ����������0�����5�����<�����V�� ���]�� ���i�� ���s�� �����������������������������������O����<���.!�����k!��"���q!�� ���!�����!�����!�����!��$���!��.���!�����."�����D"��H���\"�����"�����"�� ���"��!���"�����"��+���#��*���@#�����k#�����}#��6���#�����#��N���#�� ���=$�����I$��!���N$��?���p$��#���$��"���$�����$����� %�� ���%��i���(%��"���%��C���%��S���%��6���M&��o���&��#���&�����'�����4'��#���G'��D���k'�����'��,���'��!���'��@���(�����U(�����j(��E���(�����(�� ���(�����(��B���)�� ���^)��-���k)�� ���)�����)��0���)�� ���)��>���)�� ���0*��U���=*��'���*��6���*�� ���*�����*�����+�� ���0+��'���;+��7���c+��5���+��%���+��+���+��)���#,��%���M,��*���s,�����,�����,�����,�����,�� ���,�����-��%���-�����<-��W���\-��;���-�����-�����.�� ���.��-���.�����M.�����m.�� ���.��0���.�����.��-���.��/��� /��+���:/��-���f/��5���/��5���/��;����0��Q���<0��$���0��!���0�����0�����0�����1��?���#1��*���c1�����1�����1�� ���1�����1�����1�� ���1��2���2�� ���72��!���B2��m���d2��2���2�����3�����3�����)3�����E3�����U3�����q3�����3�����3��!���3��~���3��Z���H4�����4�����4��#���I5�� ���m5�����x5��)���5�����5�����5�����5��'���5����� 6�����7�����.7�����K7�����d7�����y7�����7��O���7�����7�����8��#���8�����A8��-���_8��T���8��X���8��2���;9��]���n9��h���9��Q���5:�� ���:�����:�����:��)���:��R���:��?���6;�� ���v;�����;�����;�����;�� ���;��f���;��!���3<�����U<��'���p<��+���<�����<�����<�����o=�����=�����=�����=�����=�����=�����=��%���>��@���6>�� ���w>�����>�� ���>�� ���>�� ���>��#���>�� ���>�����>�� ���?�����?�����?�����??�� ���P?�����[?�����{?�����?��3���?�����?�����?�����@�� ���@��&���+@�����R@�����[@�����o@��!���~@�����@�����@�����@�����@�����@�����A��'���A��� (deprecated)� (in �%(filename)s — %(docstitle)s�%b %d, %Y�%s %s�%s %s documentation�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�, in �<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not import extension %s�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Error�Event %r already present�Example�Examples�Expand sidebar�Fig. %s�File %s already exists, skipping.�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Invalid caption: %s�Keyword Arguments�Last updated on %(last_updated)s.�Library changes�Listing %s�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Note�Notes�Numbers�Original exception: �Other Parameters�Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Please activate JavaScript to enable the search functionality.�Preparing search...�Previous topic�Project language�Project release�Project version�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Release�Return type�Returns�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section %s�Section author: �See also�Show Source�Symbols�Table %s�Table of Contents�Template Parameters�The configuration file (or one of the modules it imports) called sys.exit()�There is a programmable error in your configuration file: %s�This Page�This project needs at least Sphinx v%s and therefore cannot be built with this version.�Throws�Tip�Todo�Unknown event name: %s�Variables�Warning�Warns�Welcome! This is�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�all functions, classes, terms�attribute�author names�build %s.�built-in function�can be huge�cannot combine -a option and filenames�cannot copy image file %r: %s�cannot find files %r�cannot open warning file %r: %s�cannot read image file %r: copying it instead�cannot write image file %r: %s�class�class method�concept�config changed�config directory doesn't contain a conf.py file (%s)�continued from previous page�data�directive�document�document language�done�duplicate label of equation %s, other instance in %s�enum�enumerator�environment variable�environment variable; %s�exception�extension %r has no setup() function; is it really a Sphinx extension module?�failed: %s�finished with problems�function�glossary term�grammar token�index�keyword�last updated�lists all sections and subsections�macro�member�method�module�modules�new config�next�next chapter�object�operator�original entry�page�previous�previous chapter�program option�project name�quick access to all modules�reference label�release of project�role�search�search this documentation�see %s�see also %s�statement�static method�succeeded�the documentation for�type�use epub�variable�version of project�writing %s file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: ru Language-Team: Russian (http://www.transifex.com/sphinx-doc/sphinx-1/language/ru/) Plural-Forms: nplurals=4; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : n%10==0 || (n%10>=5 && n%10<=9) || (n%100>=11 && n%100<=14)? 2 : 3) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �(использование не рекомендуется)� (в �%(filename)s — %(docstitle)s�%b %d, %Y�%s %s�документация %s %s�%s (атрибут %s)�%s (встроенный класс)�%s (встроенная переменная)�%s (класс в %s)�%s (директива)�%s (глобальная переменная или константа)�%s (в модуле %s)�%s (модуль)�%s (роль)�%s() (метод класса %s)�%s() (метод %s)�%s() (статический метод %s)�%s() (встроенная функция)�%s() (класс)�%s() (в модуле %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�(<<Исходная запись>> находится в %s, строка %d.)�(в %s v%s)�, в�<<исходная запись>>�<h1>Все модули, в которых есть код</h1>�<h1>Исходный код %s</h1>�Об этих документах�Аргументы�Внимание�Автор: �Автоматически созданный список изменений в версии %(version)s� Базовые классы: %s�Сборщик %r уже существует (в модуле %s).�Отсутствует аттрибут "name" у класса сборщика %s.�Сборщик %s не зарегистрирован.�Сборщик %s не зарегистрирован явно или через ресурсы пакетов.�Встроенные функции�Изменения в API C�Осторожно�Изменено в версии %s�Изменения в версии %(version)s — %(docstitle)s�Автор кода:�Свернуть боковую панель�Полное оглавление�Ключ конфигурации %r уже существует�Содержание�Авторские права�Не могу загрузить модуль расширения %s�Создание файла %s.�Опасно�Не рекомендуется�Не рекомендуется, начиная с версии %s�Ошибка�Событие %r уже существует�Пример�Примеры�Развернуть боковую панель�Рис. %s�Файл %s уже существует, пропускаем.�Сноски�Полный алфавитный указатель на одной странице�Алфавитный указатель�Алфавитный указатель модулей�Искать�Снять выделение�Подсказка�Важно�Алфавитный указатель�Алфавитный указатель – %(key)s�Указатели по буквам алфавита�Таблицы и указатели:�Некорректная подпись: %s�Именованные аргументы�Обновлено: %(last_updated)s.�Изменения в библиотеке�Список %s�Состав модуля�Автор модуля: �Код модуля�Модуль�Навигация�Добавлено в версии %s�Следующий раздел�Сборщик не указан, по умолчанию используется html�Отсутствует ключ конфигурации %s�Примечание�Заметки�Числа�Изначальное исключение: �Другие параметры�Другие изменения�Обзор�Обзор: исходный код модуля�Параметры�Постоянная ссылка на код�Ссылка на это определение�Ссылка на это уравнение�Ссылка на этот заголовок�Постоянная ссылка на рисунок�Постоянная ссылка на таблицу�Постоянная ссылка на оглавление�Для работы поиска включите JavaScript в браузере.�Подготовка поиска…�Предыдущий раздел�Язык проекта�Релиз проекта�Версия проекта�Предложения об улучшениях Python; PEP %s�Содержание модулей Python�Быстрый поиск�Исключение�Выпуск�Тип результата�Результат�Поиск�Поиск в документе «%(docstitle)s»�Поиск�Результаты поиска�Поиск завершён, найдено %s страниц, удовлетворяющих запросу.�Поиск в документе «%(docstitle)s»�Идёт поиск�Раздел %s�Автор раздела: �См.также�Исходный текст�Символы�Таблица %s�Оглавление�Параметры шаблона�Файл конфигурации (или один из импортированных модулей) вызвал sys.exit()�В вашем файле конфигурации программная ошибка: %s�Эта страница�Проект требует версию Sphinx не ниже v%s и не может быть построен текущей версией.�Бросает исключение�Совет�План�Неизвестное событие: %s�Переменные�Предупреждение�Предупрждения�Добро пожаловать! Это�По вашему поиску не найдено ни одного документа. Проверьте, что все слова написаны без ошибок, и что вы выбрали достаточно категорий.�[документация]�[иллюстрация: %s]�[иллюстрация]�[рисунок: %s]�[рисунок]�[исходный код]�все функции, классы, переменные и константы�атрибут�имена авторов�сборка завершена %s.�базовая функция�может быть очень большим�Невозможно совмещать ключ -a и названия файлов�Не получается скопировать файл изображения %r: %s�Не получается найти файлы %r�Не получается открыть файл с предупреждениями %r:%s �Не получается считать файл изображение %r: скопируйте его�Не получается записать файл изображения %r: %s�класс�метод класса�концепт�конфигурация изменена�в конфигурационной папке нет файла conf.py file (%s)�продолжение с предыдущей страницы�данные�директива�документ�язык проекта�готово�повторяющаяся метка уравнения %s, также используется в %s�перечисляемый тип�перечислитель�переменная окружения�переменная окружения; %s�исключение�расширение %r не определяет функцию setup(); это действительно модуль расширения Sphinx?�ошибка: %s�с ошибками�функция�элемент словаря�токен грамматики�указатель�ключевое слово�последнее изменение�список всех разделов и подразделов�макрос�поле�метод�модуль�модули�новая конфигурация�вперёд�следующая глава�объект�оператор�исходный элемент�страница�назад�предыдущая глава�опция программы�имя проекта�сводный список всех модулей�текст ссылки�релиз проекта�роль�искать�поиск в документации�см. %s�также см. %s�команда�статический метод�успешно�документация�тип�использовать epub�переменная�версия проекта�записывается %s файл...�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ru/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000261745�00000000000�021206� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Alex Salikov <Salikvo57@gmail.com>, 2019 # Dmitry Shachnev <mitya57@gmail.com>, 2013 # ferm32 <ferm32@gmail.com>, 2014,2016,2019 # FIRST AUTHOR <EMAIL@ADDRESS>, 2013 # Konstantin Molchanov <moigagoo@live.com>, 2016 # PyHedgehog <pywebmail@list.ru>, 2015,2017 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Russian (http://www.transifex.com/sphinx-doc/sphinx-1/language/ru/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: ru\n" "Plural-Forms: nplurals=4; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<12 || n%100>14) ? 1 : n%10==0 || (n%10>=5 && n%10<=9) || (n%100>=11 && n%100<=14)? 2 : 3);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Проект требует версию Sphinx не ниже v%s и не может быть построен текущей версией." #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "готово" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "ошибка: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "Сборщик не указан, по умолчанию используется html" #: sphinx/application.py:348 msgid "succeeded" msgstr "успешно" #: sphinx/application.py:349 msgid "finished with problems" msgstr "с ошибками" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "сборка завершена %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "в конфигурационной папке нет файла conf.py file (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "Отсутствует ключ конфигурации %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "Ключ конфигурации %r уже существует" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Файл конфигурации (или один из импортированных модулей) вызвал sys.exit()" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "В вашем файле конфигурации программная ошибка:\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Раздел %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Рис. %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Таблица %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Список %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "Событие %r уже существует" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Неизвестное событие: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "Отсутствует аттрибут \"name\" у класса сборщика %s." #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Сборщик %r уже существует (в модуле %s)." #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Сборщик %s не зарегистрирован явно или через ресурсы пакетов." #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "Сборщик %s не зарегистрирован." #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "Изначальное исключение:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "Не могу загрузить модуль расширения %s" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "расширение %r не определяет функцию setup(); это действительно модуль расширения Sphinx?" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Предложения об улучшениях Python; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "Не получается считать файл изображение %r: скопируйте его" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "Не получается скопировать файл изображения %r: %s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "Не получается записать файл изображения %r: %s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "записывается %s файл..." #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Встроенные функции" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Модуль" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (в " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Алфавитный указатель" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "указатель" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "вперёд" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "назад" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "документация %s %s" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Алфавитный указатель" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Выпуск" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "Не получается найти файлы %r" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "Невозможно совмещать ключ -a и названия файлов" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "Не получается открыть файл с предупреждениями %r:%s " #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "Версия проекта" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "Релиз проекта" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "Язык проекта" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "Создание файла %s." #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "Файл %s уже существует, пропускаем." #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "имя проекта" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "имена авторов" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "версия проекта" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "релиз проекта" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "язык проекта" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "использовать epub" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "Некорректная подпись: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Автор раздела: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Автор модуля: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Автор кода:" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Автор: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Параметры" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Результат" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Тип результата" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "поле" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "переменная" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "функция" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "макрос" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "перечисляемый тип" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "перечислитель" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "тип" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Добавлено в версии %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Изменено в версии %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Не рекомендуется, начиная с версии %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Параметры шаблона" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Бросает исключение" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "класс" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "концепт" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (встроенная функция)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (метод %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (класс)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (глобальная переменная или константа)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (атрибут %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Аргументы" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (модуль)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "метод" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "данные" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "атрибут" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "модуль" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "повторяющаяся метка уравнения %s, также используется в %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "ключевое слово" #: sphinx/domains/python.py:60 msgid "operator" msgstr "оператор" #: sphinx/domains/python.py:61 msgid "object" msgstr "объект" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "исключение" #: sphinx/domains/python.py:63 msgid "statement" msgstr "команда" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "базовая функция" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Переменные" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Исключение" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (в модуле %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (в модуле %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (встроенная переменная)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (встроенный класс)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (класс в %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (метод класса %s)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (статический метод %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Содержание модулей Python" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "модули" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Не рекомендуется" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "метод класса" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "статический метод" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "(использование не рекомендуется)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (директива)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (роль)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "директива" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "роль" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "переменная окружения; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "элемент словаря" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "токен грамматики" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "текст ссылки" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "переменная окружения" #: sphinx/domains/std.py:568 msgid "program option" msgstr "опция программы" #: sphinx/domains/std.py:569 msgid "document" msgstr "документ" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Состав модуля" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Поиск" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "новая конфигурация" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "конфигурация изменена" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "см. %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "также см. %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Символы" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[иллюстрация: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[иллюстрация]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Ссылка на это уравнение" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(в %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[исходный код]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "План" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<исходная запись>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(<<Исходная запись>> находится в %s, строка %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "исходный элемент" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[документация]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Код модуля" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Исходный код %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Обзор: исходный код модуля" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Все модули, в которых есть код</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr " Базовые классы: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "Именованные аргументы" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "Пример" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Примеры" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "Заметки" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "Другие параметры" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "Предупрждения" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Внимание" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Осторожно" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Опасно" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Ошибка" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Подсказка" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Важно" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Примечание" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "См.также" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Совет" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Предупреждение" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "продолжение с предыдущей страницы" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "Числа" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "страница" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "Оглавление" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Поиск" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Искать" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Исходный текст" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Обзор" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Добро пожаловать! Это" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "документация" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "последнее изменение" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Таблицы и указатели:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Полное оглавление" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "список всех разделов и подразделов" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "поиск в документации" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Алфавитный указатель модулей" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "сводный список всех модулей" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "все функции, классы, переменные и константы" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Алфавитный указатель – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Полный алфавитный указатель на одной странице" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Указатели по буквам алфавита" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "может быть очень большим" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Навигация" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Поиск в документе «%(docstitle)s»" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Об этих документах" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Авторские права" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Copyright %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Обновлено: %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Поиск в документе «%(docstitle)s»" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Предыдущий раздел" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "предыдущая глава" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Следующий раздел" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "следующая глава" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Для работы поиска включите JavaScript в браузере." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "искать" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Результаты поиска" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "По вашему поиску не найдено ни одного документа. Проверьте, что все слова написаны без ошибок, и что вы выбрали достаточно категорий." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Быстрый поиск" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Эта страница" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Изменения в версии %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Автоматически созданный список изменений в версии %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Изменения в библиотеке" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Изменения в API C" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Другие изменения" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Ссылка на этот заголовок" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Ссылка на это определение" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Снять выделение" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Идёт поиск" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Подготовка поиска…" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Поиск завершён, найдено %s страниц, удовлетворяющих запросу." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", в" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Развернуть боковую панель" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Свернуть боковую панель" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Содержание" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Постоянная ссылка на таблицу" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Постоянная ссылка на код" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Постоянная ссылка на рисунок" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Постоянная ссылка на оглавление" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Сноски" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[рисунок: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[рисунок]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ���������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3305705 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/si/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015516� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5028026 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/si/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017303� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/si/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000007557�00000000000�021170� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "si", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "\u0db8\u0dd9\u0db8 \u0dbd\u0dda\u0d9b\u0dab \u0d9c\u0dd0\u0db1", "Automatically generated list of changes in version %(version)s": "", "C API changes": "C API \u0dc0\u0dd9\u0db1\u0dc3\u0dca\u0d9a\u0db8\u0dca", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "\u0dc3\u0db8\u0dca\u0db4\u0dd6\u0dbb\u0dca\u0dab \u0db4\u0da7\u0dd4\u0db1", "Contents": "\u0d85\u0db1\u0dca\u0dad\u0dbb\u0dca\u0d9c\u0dad\u0dba", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "\u0dba\u0db1\u0dca\u0db1", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "\u0db4\u0dd4\u0dc3\u0dca\u0dad\u0d9a\u0dcf\u0dbd \u0dc0\u0dd9\u0db1\u0dc3\u0dca\u0d9a\u0db8\u0dca", "Navigation": "\u0d9c\u0db8\u0db1\u0dca \u0d9a\u0dd2\u0dbb\u0dd3\u0db8", "Next topic": "\u0d8a\u0dc5\u0d9f \u0db8\u0dcf\u0dad\u0dd8\u0d9a\u0dcf\u0dc0", "Other changes": "\u0dc0\u0dd9\u0db1\u0dad\u0dca \u0dc0\u0dd9\u0db1\u0dc3\u0dca\u0d9a\u0db8\u0dca", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "\u0dc3\u0dd9\u0dc0\u0dd4\u0db8 \u0dc3\u0dd6\u0daf\u0dcf\u0db1\u0db8\u0dca \u0d9a\u0dbb\u0db8\u0dd2\u0db1\u0dca....", "Previous topic": "\u0db4\u0dd9\u0dbb \u0db8\u0dcf\u0dad\u0dd8\u0d9a\u0dcf\u0dc0", "Quick search": "\u0d89\u0d9a\u0dca\u0db8\u0db1\u0dca \u0dc3\u0dd9\u0dc0\u0dd4\u0db8", "Search": "\u0dc3\u0ddc\u0dba\u0db1\u0dca\u0db1", "Search Page": "\u0dc3\u0dd9\u0dc0\u0dd4\u0db8\u0dca \u0db4\u0dd2\u0da7\u0dd4\u0dc0", "Search Results": "\u0dc3\u0dd9\u0dc0\u0dd4\u0db8\u0dca \u0db4\u0dca\u200d\u0dbb\u0dad\u0dd2\u0db5\u0dbd", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "\u0dc3\u0ddc\u0dba\u0db8\u0dd2\u0db1\u0dca...", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "\u0db8\u0dd6\u0dbd\u0dba \u0db4\u0dd9\u0db1\u0dca\u0dc0\u0db1\u0dca\u0db1", "Table of Contents": "", "This Page": "\u0db8\u0dd9\u0db8 \u0db4\u0dd2\u0da7\u0dd4\u0dc0", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "\u0dc0\u0dd2\u0dc1\u0dcf\u0dbd \u0dc0\u0dd2\u0dba \u0dc4\u0dd0\u0d9a", "last updated": "\u0d85\u0dc0\u0dc3\u0db1\u0dca\u0dc0\u0dbb\u0da7 \u0dba\u0dcf\u0dc0\u0dad\u0dca\u0d9a\u0dcf\u0dbd \u0d9a\u0dbd", "lists all sections and subsections": "", "next chapter": "\u0d8a\u0dc5\u0d9f \u0db4\u0dbb\u0dd2\u0da0\u0dca\u0da1\u0dda\u0daf\u0dba", "previous chapter": "\u0db4\u0dd9\u0dbb \u0db4\u0dbb\u0dd2\u0da0\u0dca\u0da1\u0dda\u0daf\u0dba", "quick access to all modules": "", "search": "\u0dc3\u0ddc\u0dba\u0db1\u0dca\u0db1", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n != 1)" });�������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/si/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000007017�00000000000�021156� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������<���������������������� ��������������� �������� �����#�� ���,�����:�� ���P�����^�����y���������������������� ���������� ���������� ����� ��������������� ��� ���������������%�� ���:�����F�� ���U�����_�� ���h�����t�� ���|������� ��������������� ���������� ��������������� ��������������� ������������������ �� �������������"�����+�����<�����C�� ���J�����V�����[����d�� ���*�����4�����:�� ���P�� ���^�� ����������,����������%�������� �� ���3 �� ���@ �����M ��1���` ����� ��%��� ����� �� ��� ��(��� �����+ ��<���G ����� ��"��� ��"��� ����� �� ��� ��"��� ��+���A �����m ����� ��%��� ����� ����� ��"��� ����� ��"���, �����O �� ���V �����b �� ���j �����v �����~ ��#��� �� ��� ����� ��8��� ����� ����� �� ���6 ��%���@ �����f �� ���y ��%��� ����� ����� ����� ����� ����� ���%b %d, %Y�%s %s�%s %s documentation�(in %s v%s)�About these documents�Author: �C API changes�Changed in version %s�Code author: �Complete Table of Contents�Contents�Error�Go�Hint�Library changes�Navigation�New in version %s�Next topic�Note�Other changes�Parameters�Preparing search...�Previous topic�Quick search�Release�Search�Search %(docstitle)s�Search Page�Search Results�Searching�See also�Show Source�Symbols�This Page�Todo�Variables�Warning�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�can be huge�data�function�last updated�macro�member�next�next chapter�object�previous�previous chapter�search�see %s�see also %s�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: si Language-Team: Sinhala (http://www.transifex.com/sphinx-doc/sphinx-1/language/si/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �%b %d, %Y�%s %s�%s %s ලේඛණය�(%s හි%s)�මෙම ලේඛණ ගැන�ලේඛක:�C API වෙනස්කම්�%s වෙළුමේ වෙනස් කල�කේත ලේඛක:�සම්පූර්ණ පටුන�අන්තර්ගතය�දෝෂය�යන්න�හැඟවීම�පුස්තකාල වෙනස්කම්�ගමන් කිරීම�%s වෙළුමේ අලුත්�ඊළඟ මාතෘකාව�සටහන�වෙනත් වෙනස්කම්�පරාමිතීන්�සෙවුම සූදානම් කරමින්....�පෙර මාතෘකාව�ඉක්මන් සෙවුම�නිකුත් කිරීම�සොයන්න�%(docstitle)s සොයන්න�සෙවුම් පිටුව�සෙවුම් ප්‍රතිඵල�සොයමින්...�මෙයද බලන්න�මූලය පෙන්වන්න�සංකේත�මෙම පිටුව�කිරීමට තිබෙන�විචල්‍ය�අනතුරු ඇඟවීම�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�විශාල විය හැක�දත්ත�ක්‍රියාව�අවසන්වරට යාවත්කාල කල�මැක්‍රෝ�සාමාජික�ඊළඟ�ඊළඟ පරිච්ඡේදය�වස්තුව�පෙර�පෙර පරිච්ඡේදය�සොයන්න�%s බලන්න�%s ද බලන්න�වර්ගය�විචල්‍යය������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/si/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000244350�00000000000�021164� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # callkalpa <callkalpa@gmail.com>, 2013 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Sinhala (http://www.transifex.com/sphinx-doc/sphinx-1/language/si/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: si\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "ඊළඟ" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "පෙර" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s ලේඛණය" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "නිකුත් කිරීම" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "කේත ලේඛක:" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "ලේඛක:" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "පරාමිතීන්" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "සාමාජික" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "විචල්‍යය" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "ක්‍රියාව" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "මැක්‍රෝ" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "වර්ගය" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "%s වෙළුමේ අලුත්" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "%s වෙළුමේ වෙනස් කල" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "දත්ත" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "වස්තුව" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "විචල්‍ය" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "සෙවුම් පිටුව" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "%s බලන්න" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "%s ද බලන්න" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "සංකේත" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[graph: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[graph]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(%s හි%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[source]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "කිරීමට තිබෙන" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[docs]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "දෝෂය" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "හැඟවීම" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "සටහන" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "මෙයද බලන්න" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "අනතුරු ඇඟවීම" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "සොයන්න" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "යන්න" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "මූලය පෙන්වන්න" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "අවසන්වරට යාවත්කාල කල" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "සම්පූර්ණ පටුන" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "විශාල විය හැක" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "ගමන් කිරීම" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "මෙම ලේඛණ ගැන" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "%(docstitle)s සොයන්න" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "පෙර මාතෘකාව" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "පෙර පරිච්ඡේදය" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "ඊළඟ මාතෘකාව" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "ඊළඟ පරිච්ඡේදය" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "සොයන්න" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "සෙවුම් ප්‍රතිඵල" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "ඉක්මන් සෙවුම" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "මෙම පිටුව" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "පුස්තකාල වෙනස්කම්" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API වෙනස්කම්" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "වෙනත් වෙනස්කම්" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "සොයමින්..." #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "සෙවුම සූදානම් කරමින්...." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "අන්තර්ගතය" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[image: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[image]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3307528 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sk/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015520� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.503688 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sk/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017305� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sk/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000010675�00000000000�021165� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "sk", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.", "© Copyright %(copyright)s.": "© Copyright %(copyright)s.", ", in ": ", v ", "About these documents": "O dokument\u00e1cii", "Automatically generated list of changes in version %(version)s": "Automaticky generovan\u00fd zoznam zmien vo verzii %(version)s", "C API changes": "Zmeny API C", "Changes in Version %(version)s — %(docstitle)s": "Zmeny vo verzii %(version)s — %(docstitle)s", "Collapse sidebar": "Zbali\u0165 bo\u010dn\u00fd panel", "Complete Table of Contents": "Celkov\u00fd obsah", "Contents": "Obsah", "Copyright": "Autorsk\u00e9 pr\u00e1vo", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "Vytvoren\u00e9 pomocou <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.", "Expand sidebar": "Rozbali\u0165 bo\u010dn\u00fd panel", "Full index on one page": "Cel\u00fd index na jednej strane", "General Index": "V\u0161eobecn\u00fd index", "Global Module Index": "Celkov\u00fd index modulov", "Go": "OK", "Hide Search Matches": "Skry\u0165 v\u00fdsledky h\u013eadania", "Index": "Index", "Index – %(key)s": "Index – %(key)s", "Index pages by letter": "Indexov\u00e9 str\u00e1nky po p\u00edsmen\u00e1ch", "Indices and tables:": "Indexy a tabu\u013eky", "Last updated on %(last_updated)s.": "Naposledy aktualizovan\u00e9 %(last_updated)s.", "Library changes": "Zmeny kni\u017enice", "Navigation": "Navig\u00e1cia", "Next topic": "\u010eal\u0161ia t\u00e9ma", "Other changes": "Ostatn\u00e9 zmeny", "Overview": "Preh\u013ead", "Permalink to this definition": "Trval\u00fd odkaz na t\u00fato defin\u00edciu", "Permalink to this headline": "Trval\u00fd odkaz na tento nadpis", "Please activate JavaScript to enable the search\n functionality.": "Pros\u00edm, na zapnutie funkcie h\u013eadania,aktivujte\nJavaScript .", "Preparing search...": "Pr\u00edprava h\u013eadania...", "Previous topic": "Predo\u0161l\u00e1 t\u00e9ma", "Quick search": "R\u00fdchle h\u013eadanie", "Search": "H\u013eada\u0165", "Search Page": "Str\u00e1nka h\u013eadania", "Search Results": "V\u00fdsledky h\u013eadania", "Search finished, found %s page(s) matching the search query.": "H\u013eadanie dokon\u010den\u00e9, n\u00e1jden\u00e9 %s strana(y), ktor\u00e9 vyhovuj\u00fa h\u013eadan\u00e9mu v\u00fdrazu.", "Search within %(docstitle)s": "H\u013eada\u0165 v %(docstitle)s", "Searching": "H\u013eadanie", "Searching for multiple words only shows matches that contain\n all words.": "H\u013eadanie viacer\u00fdch slov vracia len zhody, ktor\u00e9 obsahuj\u00fa\n v\u0161etky slov\u00e1.", "Show Source": "Zobrazi\u0165 zdroj", "Table of Contents": "Obsah", "This Page": "T\u00e1to str\u00e1nka", "Welcome! This is": "Vitajte! Toto je", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "V\u00e1\u0161mu h\u013eadaniu nezodpoved\u00e1 \u017eiadny dokument. Pros\u00edm, skontrolujte, \u017ee v\u0161etky zadan\u00e9 slov\u00e1 s\u00fa spr\u00e1vne nap\u00edsan\u00e9 a \u017ee ste zvolili vhodn\u00e9 kateg\u00f3rie.", "all functions, classes, terms": "v\u0161etky funkcie, triedy, term\u00edny", "can be huge": "m\u00f4\u017ee by\u0165 rozsiahle", "last updated": "posledn\u00e1 aktualiz\u00e1cia", "lists all sections and subsections": "zoznam v\u0161etk\u00fdch sekci\u00ed a podsekci\u00ed", "next chapter": "\u010fal\u0161ia kapitola", "previous chapter": "predo\u0161l\u00e1 kapitola", "quick access to all modules": "r\u00fdchly pr\u00edstup ku v\u0161etk\u00fdm modulom", "search": "h\u013eada\u0165", "search this documentation": "h\u013eada\u0165 v tejto dokument\u00e1cii", "the documentation for": "dokument\u00e1cia" }, "plural_expr": "(n % 1 == 0 && n == 1 ? 0 : n % 1 == 0 && n >= 2 && n <= 4 ? 1 : n % 1 != 0 ? 2: 3)" });�������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sk/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000206504�00000000000�021162� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������\��������������*����*�����--��r���.��l���.�� ���.����� /��*���/�����:/��=���/��7���0��H���?0��?���0��"���0�� ���0�����0��%���0�����$1�����A1��!���a1�����1�����1�����1�����1�� ���1�� ���1�����1�����1�����2�����2�� ���!2�����B2�� ���T2�� ���`2�� ���j2�����2��A���2�����2�����2�����3�����#3�����;3�� ���T3�����a3��6���u3�����3�����3��$���3����� 4��3���4�� ���4�����5�����5��1���5��1���G5�����y5�����5��0���5�����5�����5��b���6��;���6�����(7��6���>7�����u7�� ���7�� ���7�� ���7�����7�����7��>���7�� ���8��(���!8��(���J8�����s8��?���8�����8�� ���8��!���8��8��� 9��%���D9�����j9�����r9��4���9�� ���9�� ���9�����9�����9�����:�����8:�� ���A:��%���K:��%���q:�����:��:���:��7���:�����(;��"���?;��R���b;�����;�����;�� ���;�����;�����;��N���<��R���`<��`���<�����=��&���$=�����K=��D���Q=��H���=��K���=�����+>�����D>�����L>��5���U>�����>�����>�����>��8���>��1���>��D���+?��B���p?��3���?��"���?��3��� @��"���>@��#���a@�����@��!���@��:���@�����@�� ��� A�� ���+A�����5A�� ���LA�����ZA�����nA��C���qA��*���A�����A�����A��3��A��.���-C�� ���\C��.���fC�����C�����C�����C��D���C����� D����� D�� ��� E��'���E�����@E��[���TE�����E�����E�����E��Y���E��!���XF�����zF��2���F�� ���F��C���F����� G��n���,G��E���G�� ���G�����G�� ���G�� ��� H��-���H��(���EH�� ���nH�����yH�� ���H��(���H�����H�����H��Z���H�����8I�����>I��,���FI����sI�����J�����J�� ���J��(���J�����J�����J�� ���K�����K�����(K�����EK�����`K�����{K�����K�����K�����K��&���K��B���L��i���FL��2���L��I���L��4���-M�����bM�����M�����M�����M�����M�����M�����M����� N�� ���N�����)N�����9N�����LN��#���\N��$���N�����N�� ���N�����N�����N�����N�� ���N�����N�����N�����O�����-O�����4O�� ���IO�����UO��<���dO�����O�� ���O��K���O�� ���P�����P�����/P�����8P��+���OP�� ���{P��k���P��>���P�����2Q��#���EQ��-��iQ�����R�����R�����R�����R�����R�����R��*���R��3��� S��/���TS��(���S��.���S��P���S��p���-T�����T��!���T��"���T��$���U�� ���(U��e���IU��Z���U��N��� V��T���YV��K���V��%���V����� W�����@W��[���W��#���$X��'���HX��#���pX��I���X��'���X��!���Y��=���(Y��7���fY�� ���Y�����Y��d���CZ��W���Z��v����[�����w[�����~[�����[�� ���[��3���[�����[�����[��"���\��7���2\��<���j\��Y���\�� ���]����� ]�����]��,���]�����F]�����W]��Y���!^�����{^�����_�� ��� _�����_�� ���!_�����-_�����5_��N���>_�����_��?���`��-���Y`��2���`�� ���`�����`�����`�����`����� a��9���a�����Wa�� ���ra�� ���|a��,���a��2���a��b���a��(���Lb��G���ub�����b��7���b����� c��8��� c�����Yc�� ���pc��%���zc��`���c�����d�����d�����>d�����Nd�����^d�� ���pd��&���|d��$���d�����d�����d������e�����e�����0e��A���Pe��Z���e��-���e�����f�����:f�����Wf��8���lf�����f�� ���f�����f�����f��7���f��6��� g��;���Cg��I���g��;���g��:���h��H���@h��9���h��G���h��2��� i��2���>i�����qi��4���i�����i�����i�����i��C����j��G���Dj��2���j�����j�����j�����j�����k�����-k�����Lk�����`k�����sk�����k��(���k��=���k�����l�����l��0���(l�����Yl�����^l��/���xl�����l�� ���l��9���l�����m�� ���%m�����Fm��-���[m�����m�����m��1���m��*���m�����n�����+n��0���4n��&���en�����n�����n��(���n�����n�����n�����o��%���1o��4���Wo�����o�����o��Y���o��;���o��.���7p�����fp�����p�����p��.���p��4���p��+���q��4���Iq��(���~q��4���q��W���q�����4r�����Sr�����gr��X���r�����r��%���r�� ���s�����s�����'s��+���@s�����ls�����s�� ���s��M���s��u���s�����tt�����t�����t�����t�����t��A���t�� ���u����� u��6���?u��I���vu��A���u�����v��0���v�����Nv��N���ev�����v�����v�����v��.���v�����w��4���"w�� ���Ww��,���ew��3���w�� ���w��=���w�����x��r���/x��'���x��0���x��(���x��1���$y��/���Vy��,���y�����y�����y�����y��=��� z��+���Gz��0���sz��$���z�����z�����z��N���z��0���2{��)���c{�����{�����{�����{��/���{�����|�����(|�����G|��&���^|��-���|��-���|��&���|�����}�� ���}��*���}��7���H}��"���}��(���}�����}�����}�����~��"���"~�����E~�����K~��4���c~��4���~�����~��;���~����������%��"���,��!���O��H���q�������#����������D�����5���2��D���h�� ���������� �����1���ʀ��E�����B���B��G�����%���́�������#��� ��,���1�����^��-���z��(�����D���т�� �����#���!��(���E��#���n�����������������(��������ڃ�������8����� ���1��P���R��"��������Ƅ�������O��������J�����_�����s�����|��%����� ����������,���Ѕ�� �����(��� ��E���3�� ���y��*����������1�����7��������$�� ���@�����K�����^�����t�����������������&����������������4��������:��%���O�����u��c���|������������ �����'��� ��:���5�� ���p�����������������*���ɉ��&�����W�����>���s��7�����K����� ���6�� ���@�� ���N��,���X��*�����0�����%��������������������1���J��1���|�������\���č�����!��'���=��%���e��+�����^�����2�����5���I�����������������5����������&�����#���.��&���R��*���y�������-�����%����������!���0�����R��!���h������������#�����*���Α�����������������P���,�����}��)�����9���ƒ��;������)���<�����f�����n��&������������������ړ���������� �����)�����B�����\�����o������������������`�����Y������� ���d�����r��$���u�������L���/��F���|��M���Ü��N�����"���`�� ����� �����1�����#���͝���������������1�����7�����K�����\�� ���o�� ���y��������������������ɞ��)���ٞ������� ����� �����)���)�����S��I���r����������П����������������� ���2�����@��6���S������������(���Ơ�������4����� ���ס������������2�����2���!�����T�����k��5�������������Ӣ��^�����@���ޣ�������8���/�����h��$����� ����� �������������Ф��:���פ�� �����%�����+���D��'���p��F��������ߥ�� �����*�����G���*��0���r�� ����������1���Ŧ��!����� ��������&�����<��&���K�����r�����x��.�����.�����$�����N��� ��D���[�������,�����W��������?�� ���W�� ���d�����o��!�����Q�����U�����o���Q�������*���Ӫ�������=�����H���B��G��������ӫ������� �����;��������;�����M�����e��H���y��7���¬��L�����M���G��8�����-���έ��:�����&���7��)���^�������%�����A�����-�����.���&�����U�����k�����������������D�����(��������"�����=��.��B��1���q�� �����C���������������!�����K���1�����}������� ���~��0����������_���г�����0��!���P�����r��h�����*��������#��2���3�� ���f��O���p������������E���u�� ����� ���ɶ�� ���׶�������'�����+����� ���G�����R�����e��8���t��#����� ���ѷ��O���۷�� ���+�����5��9���=�� ��w�����������������(��������������� ����������!���*�����L�����j���������������Ⱥ��#�����6��� ��=���B��z�����=�����X���9��D��������׼��$�������������:�����Y�����p�������������������������̽�����߽�� �����$��������5�����J�� ���\�����g�����w�������������������������ʾ�����Ӿ������������T��������h�� �����P����� ���ܿ�� ���������������.��������F��~���V��7�������� ��'���+��&��S�����z������������ ���������������%�����/�����*���-��$���X��)���}��U�����u��������s������������!����������x�����^�����W�����Z���C��P�����-�������������<��V�����&���&��"���M��!���p��C�����$�����#�����2�����1���R������������h���Q��[�����y����� ��������������������A���������� �����!���?��<���a��E�����b����� ���G�� ���Q�� ���[��)���e������������c���q������� ���v�� ��������������� ����������N����������L�����3�����8���(�� ���a�����n��!���������������7�����#��������5�� ���>��6���L��G�����a�����,���-��L���Z�������D����������D���&�� ���k�������&�����b�����)���%��)���O�����y�����������������/�����0�����$���*��+���O��(���{�������)�����U�����h���@��E�����)�����!��������;��?���V����������������������B�����G�����L���[��b�����L��� ��K���X��`�����J�����_���P��A�����C��������6��8���M�������!����������M�����R���,��0�����%�����(�����)�����#���)��&���M�����t�������$�����!�����:�����>���,�����k�������4���������� �����6��������%�� ���D��4���O�����������������@�������������/��B���D��,�����"����������>�����2��������R��*���f��'����������!�����'����������B���7�����z�������h�����9�����,���4��*���a��"�����!�����0�����.�����/���1��.���a��.�����4�����Y�����)���N�����x�� �����W�������� ��(����� ���8�����D�����Y��%���r�������"����������N�����u���0���������������������������>��� �� ���L�����X��<���u��N�����H�����"���J��)���m�������S������������� �������4���1�����f��@���z�������5�����;��������>��F���N��(����������2���C��L���v��-�����M�����8���?��7���x��)�����%�����"������C���#��6���g��9�����+������������� ��]��� ��8���~��.����������#�����"���!��>���D������� �����#�����3�����:�����?���S��'���������������8�����7�����&���S��*���z��#���������������"��������$�����*��>���I��C����������Q��������7�����=��5���E�����{��K����������!�������� ��;�����9���P��M��������������������A�����Y���I��_�����\�����(���`�������'�����*�����!�����;�����/���V��M����� �����#�����,�����'���1�����Y�� ���`�����j��-���}������������9�������� ��P���+��)���|������������[��������=�����R�� ���g�����r��+���������������'����������4��� ��@���>�������%����� �����>�����;�����%���;�� ���a�����o���������������������������$�������� �����!��.���&�����U��&���o�������p�������������/�� ���7��8���B��:���{��1����� ��������������)���/�&���Y�]����:����1����J���K��������� ����/����-����8����(���R����{��������<�;����;���)� ���e�Y���s�����'����%��� �-���3�Y���a�6����8����)���+����U����t�:���x�����,����(����)���#�/���M����}�=����*������� �%���% ����K �&���a ���� � ��� �*��� �6��� � ��� ���� ����, �Y���C �!��� �!��� �W��� �N���9 �3��� � ��� ���� �-��� �"��� �"���3 �"���V ����y � ��� ���� � ��� ���� � ��� ����% �� Generate documentation from source files. sphinx-build generates documentation from the files in SOURCEDIR and places it in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration settings. The 'sphinx-quickstart' tool may be used to generate template files, including 'conf.py' sphinx-build can create documentation in different formats. A format is selected by specifying the builder name on the command line; it defaults to HTML. Builders can also perform other tasks related to documentation processing. By default, everything that is outdated is built. Output only for selected files can be built by specifying individual filenames. � Generate required files for a Sphinx project. sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build. � Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� Run 'make' in that directory to run these through makeinfo (use 'make info' here to do that automatically).� (deprecated)� (in �"::" in automodule name doesn't make sense�":file:" option for csv-table directive now recognizes an absolute path as a relative path from source directory. Please update your document.�"latex_documents" config value references unknown document %s�"man_pages" config value references unknown document %s�"quiet" is specified, but any of "project" or "author" is not specified.�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%r doesn't have "%s" setting�%r doesn't have "theme" setting�%r reference target not found: %s�%s %s�%s %s documentation�%s (%s attribute)�%s (%s property)�%s (C %s)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command line option�%s is already assigned section numbers (nested numbered toctree?)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �-A option argument must be in the form name=value�-D option argument must be in the form name=value�:%s: (directive option)�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�A Makefile and a Windows command file can be generated for you so that you only have to run e.g. `make html' instead of invoking sphinx-build directly.�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�A captioned autosummary requires :toctree: option. ignored.�About these documents�An error happened in rendering the page %s. Reason: %r�Anchor '%s' not found�Any IDs not assigned for %s node�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not fetch remote image: %s [%d]�Could not fetch remote image: %s [%s]�Could not import extension %s�Could not lex literal_block as "%s". Highlighting skipped.�Could not obtain image size. :scale: option is ignored.�Create Makefile? (y/n)�Create Windows command file? (y/n)�Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> %(sphinx_version)s.�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Duplicate C declaration, also defined at %s:%s. Declaration is '.. c:%s:: %s'.�Duplicate C++ declaration, also defined at %s:%s. Declaration is '.. cpp:%s:: %s'.�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Encoding error:�Enter the root path for documentation.�Error�Error: an existing conf.py has been found in the selected root path.�Error: specified path is not a directory, or sphinx files already exist.�Error: the master file %s has already been found in the selected root path.�Event %r already present�Example�Examples�Exception occurred while building, starting debugger:�Exception occurred:�Expand sidebar�Extension options�External Graphviz file %r not found or reading it failed�Failed to copy a file in html_static_file: %s: %r�Failed to create a cross reference. A title or caption not found: %s�Failed to create a cross reference. Any number is not assigned: %s�Failed to parse a default argument value for %r: %s�Failed to read build info file: %r�Failed to read intersphinx_mapping[%s], ignored: %r�Failed to scan documents in %s: %r�Failed to write build info file: %r�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnote [#] is not referenced.�Footnote [%s] is not referenced.�Footnotes�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Handler %r for event %r threw an exception�Hide Search Matches�Hint�If the documents are to be written in a language other than English, you can select a language here by its language code. Sphinx will then translate text that it generates into that language. For a list of supported codes, see https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indicate which of the following Sphinx extensions should be enabled:�Indices and tables:�Inside the root directory, two more directories will be created; "_templates" for custom HTML templates and "_static" for custom stylesheets and other static files. You can enter another prefix (such as ".") to replace the underscore.�Interrupted!�Invalid __slots__ found on %s. Ignored.�Invalid caption: %s�Invalid date format. Quote the string by single quote if you want to output it directly: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�Keyword Arguments�LaTeX command %r cannot be run (needed for math display), check the imgmath_latex setting�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Look for any errors in the above output or in %(outdir)s/output.txt�Makefile and Batchfile creation�Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Many math_renderers are registered. But no math_renderer is selected.�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Note�Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.�Notes�Numbers�Object named %r not found in include file %r�One document is special in that it is considered the top node of the "contents tree", that is, it is the root of the hierarchical structure of the documents. Normally, this is "index", but if your "index" document is a custom template, you can also set this to another filename.�Original exception: �Other Parameters�Other changes�Output directory (%s) is not a directory�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this term�Permalink to this toctree�Pillow not found - copying image files�Please activate JavaScript to enable the search functionality.�Please also report this if it was a user error, so that a better error message can be provided next time.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter a new file name, or rename the existing file and press Enter�Please enter a new root path (or just Enter to exit)�Please enter a valid path name.�Please enter either 'y' or 'n'.�Please enter one of %s.�Please enter some text.�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project templating�Project version�Pygments lexer name %r is not known�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Recursion error:�Release�Return type�Returns�Root path for the documentation�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Searching for multiple words only shows matches that contain all words.�Section %s�Section author: �See also�Selected root path: %s�Separate source and build directories (y/n)�Show Source�Since v2.0, Sphinx uses "index" as root_doc by default. Please add "root_doc = 'contents'" to your conf.py.�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Sphinx has the notion of a "version" and a "release" for the software. Each version can have multiple releases. For example, for Python the version is something like 2.5 or 3.0, while the release is something like 2.5.1 or 3.0a1. If you don't need this dual structure, just set both to the same value.�Structure options�Symbols�TODO entry found: %s�Table %s�Table of Contents�Template Parameters�The %r crossref_type is already registered�The %r directive is already registered to domain %s�The %r index is already registered to domain %s�The %r object_type is already registered�The %r role is already registered to domain %s�The %s extension is required by needs_extensions settings, but it is not loaded.�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.�The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.�The config value `{name}' has type `{current.__name__}'; expected {permitted}.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The dummy builder generates no files.�The ePub file is in %(outdir)s.�The file name suffix for source files. Commonly, this is either ".txt" or ".rst". Only files with this suffix are considered documents.�The full traceback has been saved in %s, if you want to report the issue to the developers.�The manual pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�The overview file is in %(outdir)s.�The project name will occur in several places in the built documentation.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This can happen with very large or deeply nested source files. You can carefully increase the default Python recursion limit of 1000 in conf.py with e.g.:�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Translator for %r already exists�Unknown configure key: latex_elements[%r], ignored.�Unknown event name: %s�Unknown image format: %s...�Unknown math_renderer %r is given.�Unknown theme option: latex_theme_options[%r], ignored.�Use the Makefile to build the docs, like so: make builder�Use the sphinx-build command to build the docs, like so: sphinx-build -b builder %s %s�Variables�Warning�Warns�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�You have two options for placing the build directory for Sphinx output. Either, you use a directory "_build" within the root path, or you separate "source" and "build" directories within the root path.�You should now populate your master file %s and create other documentation source files. �Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.�a list of specific files to rebuild. Ignored if -a is specified�a suitable image for %s builder not found: %s�a suitable image for %s builder not found: %s (%s)�alias of %s�alias of TypeVar(%s)�all functions, classes, terms�all of %d po files�all source files�append module_path to sys.path, used when --full is given�assembling single document�attribute�author names�automatically insert docstrings from modules�automatically test code snippets in doctest blocks�autosummary generats .rst files internally. But your source_suffix does not contain .rst. Skipped.�autosummary_generate: file not found: %s�both tabularcolumns and :widths: option are given. :widths: is ignored.�broken link: %s (%s)�build %s, %s warning (with warnings treated as errors).�build %s, %s warning.�build %s, %s warnings (with warnings treated as errors).�build %s, %s warnings.�build %s.�build environment version not current�build in parallel with N processes where possible (special value "auto" will set N to cpu-count)�build info file is broken: %r�builder to use (default: html)�building [%s]: �building [mo]: �built-in function�can be huge�cannot combine -a option and filenames�cannot copy downloadable file %r: %s�cannot copy extra file %r�cannot copy image file %r: %s�cannot copy static file %r�cannot find files %r�cannot open warning file %r: %s�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�cannot read image file %r: copying it instead�cannot write image file %r: %s�caption not inside a figure.�checking consistency�circular toctree references detected, ignoring: %s <- %s�class�class method�command line option�concept�conditional inclusion of content based on config values�conf value "epub_author" should not be empty for EPUB3�conf value "epub_contributor" should not be empty for EPUB3�conf value "epub_copyright" (or "copyright")should not be empty for EPUB3�conf value "epub_description" should not be empty for EPUB3�conf value "epub_identifier" should not be empty for EPUB3�conf value "epub_language" (or "language") should not be empty for EPUB3�conf value "epub_publisher" should not be empty for EPUB3�conf value "epub_title" (or "html_title") should not be empty for EPUB3�conf value "epub_uid" should be XML NAME for EPUB3�conf value "version" should not be empty for EPUB3�config changed�config directory doesn't contain a conf.py file (%s)�console output options�continued from previous page�continues on next page�convert command %r cannot be run, check the image_converter setting�convert command %r cannot be run, check the image_converter setting: %s�convert exited with error: [stderr] %r [stdout] %r�copying TeX support files�copying TeX support files...�copying Texinfo support files�copying additional files�copying downloadable files... �copying extra files�copying images... �copying source files...�copying static files�could not read %r for changelog creation�create .nojekyll file to publish the document on GitHub pages�create batchfile�create makefile�custom template directory (default: %(default)s)�data�default role %s not found�default suffix for files (default: %(default)s)�define a template variable�directive�directive %r is already registered, it will be overridden�directory to place all output�directory to place all output in�display latex %r: %s�do emit colored output (default: auto-detect)�do not create batchfile�do not create makefile�do not emit colored output (default: auto-detect)�do not use make-mode for Makefile/make.bat�docnames to write: %s�document�document imported members (default: %(default)s)�document isn't included in any toctree�document language�document not readable. Ignored.�document title is not a single Text node�doing serial %s�domain %s already registered�domain %s not yet registered�don't create a table of contents file�don't use a saved environment, always read all files�done�dot code %r: %s�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�dot did not produce an output file: [stderr] %r [stdout] %r�dot exited with error: [stderr] %r [stdout] %r�download file not readable: %s�dumping object inventory�dumping search index in %s�duplicate %s description of %s, other %s in %s�duplicate %s description of %s, other instance in %s�duplicate citation %s, other instance in %s�duplicate description of %s %s, other instance in %s�duplicate label %s, other instance in %s�duplicate label of equation %s, other instance in %s�duplicate object description of %s, other instance in %s, use :noindex: for one of them�duplicated ToC entry found: %s�enable %s extension�enable arbitrary extensions�encountered some issues with some of the inventories, but they had working alternatives:�enum�enumerable_node %r already registered�enumerator�environment variable�environment variable; %s�error while formatting arguments for %s: %s�error writing file %s: %s�error writing file Makefile: %s�exception�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extension options�extensions changed�failed�failed to import object %s�failed to parse name %s�failed to reach any of the inventories with the following issues:�failed: %s�favicon file %r does not exist�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�filename of table of contents (default: modules)�finished with problems�follow symbolic links. Powerful when combined with collective.recipe.omelette.�function�function parameter�general options�generate a full project with sphinx-quickstart�generating indices�glossary seems to be misformatted, check indentation�glossary term�glossary term must be preceded by empty line�glossary terms must not be separated by empty lines�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�highlighting module code... �html_add_permalinks has been deprecated since v3.5.0. Please use html_permalinks and html_permalinks_icon instead.�html_extra_path entry %r does not exist�html_extra_path entry %r is placed inside outdir�html_static_path entry %r does not exist�html_static_path entry %r is placed inside outdir�if specified, create build dir under source dir�if specified, separate source and build dirs�image file %s not readable: %s�image file not readable: %s�include "_private" modules�include links to the source code of documented Python objects�include math, rendered as PNG or SVG images�include math, rendered in the browser by MathJax�increase verbosity (can be repeated)�index�inline latex %r: %s�interpret module paths according to PEP-0420 implicit namespaces specification�intersphinx identifier %r is not string. Ignored�intersphinx inventory has moved: %s -> %s�invalid TestCode type�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�invalid regex %r in %s�invalid regex %r in coverage_c_regexes�invalid value set (missing closing brace): %s�invalid value set (missing opening brace): %s�job number should be a positive number�keyword�last updated�line number spec is out of range(1-%d): %r�link between Sphinx documentation of different projects�lists all sections and subsections�loading intersphinx inventory from %s...�loading pickled environment�loading translations [%s]... �logo file %r does not exist�looking for now-outdated files... �macro�making output directory�malformed string literal (missing closing quote): %s�malformed string literal (missing opening quote): %s�master document name�maximum depth of submodules to show in the TOC (default: 4)�member�method�missing '+' or '-' in '%s' option.�missing attribute %s in object %s�missing attribute mentioned in :members: option: module %s, attribute %s�module�module %s could not be imported: %s�modules�more than one target found for 'any' cross-reference %r: could be %s�more than one target found for cross-reference %r: %s�multiple files found for the document "%s": %r Use %r for the build.�new config�next�next chapter�nit-picky mode, warn about all missing references�no "latex_documents" config value found; no documents will be written�no "man_pages" config value found; no manual pages will be written�no "texinfo_documents" config value found; no documents will be written�no Babel option known for language %r�no changes in version %s.�no output at all, not even warnings�no output on stdout, just warnings on stderr�no targets are out of date.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�none found�not available for built-in messages�numfig is disabled. :numref: is ignored.�numfig_format is not defined for %s�object�operator�original entry�override a setting in configuration file�overwrite existing files�page�page %s matches two patterns in html_sidebars: %r and %r�pass a value into HTML templates�path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)�path to documentation source files�path to module to document�path to output directory�path where configuration file (conf.py) is located (default: same as SOURCEDIR)�pickling environment�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�program option�project author(s), used when --full is given�project name�project name (default: root module name)�project release, used when --full is given, defaults to --doc-version�project root�project version, used when --full is given�property�put documentation for each module on its own page�put module documentation before submodule documentation�quick access to all modules�quiet mode�reST markup error:�reading error: %s, %s�reading sources... �reading templates... �reference label�release of project�replacement for dot in _templates etc.�resolving references...�role�role %r is already registered, it will be overridden�run Pdb on exception�run the script without creating files�search�search index couldn't be loaded, but not all documents will be built: the index will be incomplete.�search this documentation�see %s�see also %s�self referenced toctree found. Ignored.�setting %s.%s occurs in none of the searched theme configs�show full traceback on exception�skipped�source directory has changed�source file suffix�source_parser for %r is already registered�source_suffix %r is already registered�sphinx-quickstart only generate into a empty directory. Please specify a new root path.�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0�statement�static method�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�template directory for template files�template parameter�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension is not safe for parallel reading�the %s extension is not safe for parallel writing�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�toctree contains ref to nonexisting file %r�toctree contains reference to document %r that doesn't have a title: no link will be generated�toctree contains reference to excluded document %r�toctree contains reference to nonexisting document %r�too large :maxdepth:, ignored.�turn warnings into errors�type�undecodable source characters, replacing with "?": %r�undefined label: %s�undocumented c api: %s [%s] in file %s�undocumented python class: %s :: %s�undocumented python function: %s :: %s�undocumented python method: %s :: %s :: %s�unimplemented node type: %r�unknown config value %r in override, ignoring�unknown directive or role name: %s:%s�unknown index entry type %r�unknown mimetype for %s, ignoring�unknown node type: %r�unsupported theme option %r given�updating environment: �use epub�use make-mode for Makefile/make.bat�use no config file at all, only -D options�variable�version of project�waiting for workers...�where "builder" is one of the supported builders, e.g. html, latex or linkcheck.�while setting up extension %s:�with -W, keep going when getting warnings�write "todo" entries that can be shown or hidden on build�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing�writing %s file...�writing META-INF/container.xml file...�writing additional files�writing additional pages�writing content.opf file...�writing error: %s, %s�writing message catalogs... �writing mimetype file...�writing nav.xhtml file...�writing output... �writing summary file...�writing toc.ncx file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: sk Language-Team: Slovak (http://www.transifex.com/sphinx-doc/sphinx-1/language/sk/) Plural-Forms: nplurals=4; plural=(n % 1 == 0 && n == 1 ? 0 : n % 1 == 0 && n >= 2 && n <= 4 ? 1 : n % 1 != 0 ? 2: 3) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � Generuje dokumentáciu zo zdrojových súborov. sphinx-build generuje dokumentáciu zo súborov v SOURCEDIR a umiestni ju v OUTPUTDIR. Konfiguračné voľby hľadá v 'conf.py' v SOURCEDIR. Na generovanie súborov šablón, vrátane 'conf.py' možno použiť nástroj 'sphinx-quickstart' sphinx-build dokáže vytvoriť dokumentáciu v rôznych formátoch. Formát je zvolený zadaním mena zostavovača v príkazovom riadku; predvolene HTML. Zostavovače môžu vykonávať aj iné úlohy, ktoré súvisia so spracovaním dokuemntácie. Predvolene je zostavené všetko, čo bolo zmenené. Výstup len zvolených súborov môže byť zostavený zadaním jednotlivých mien súborov. � Genereuje požadované súbory projektu Sphinx. sphinx-quickstart je interaktívny nástroj, ktorý kladie niekoľko otázok o Vašom projekte a potom generuje kompletný adresár dokumentácie a vzorový Makefile, na použitie so sphinx-build. � Spustite v tomto adresári 'make' na ich spustenie pomocou (pdf)latex (použite tu 'make latexpdf' aby to bolo spustené automaticky).� Spustite v tomto adresári 'make' na ich spustenie pomocou makeinfo (použite tu 'make info' aby to bolo spustené automaticky).� (zastarané)�(v�„::” v automodule nedáva zmysel�voľba ":file:" direktívy csv-table teraz rozpoznáva absolútnu cestu ako relatívnu k zdrojovému adresáru. Prosím, aktualizujte svoj dokument.�konfiguračná voľba „latex_documents” odkazuje na neznámy dokument %s�konfiguračná voľba „man_pages” odkazuje na neznámy dokument %s�bolo zadané „quiet”, ale nebol zadaný „project” alebo „author”.�konfiguračná voľba „texinfo_documents” odkazuje na neznámy dokument %s�%(filename)s — %(docstitle)s�%d. %b %Y�%d nájdené�%d zdrojové súbory zadané v príkazovom riadku�téma %r nemá nastavenie „1%s”�%r nemá nastavenia „theme”�%r cieľ odkazu nenájdený: %s�%s %s�Dokumentácia %s %s�%s (atribút %s)�%s (vlastnosť %s)�%s (C %s)�%s (C++ %s)�%s (zabudovaná trieda)�%s (zabudovaná premenná)�%s (trieda v %s)�%s (direktíva)�%s (globálna premenná alebo konštanta)�%s (v module %s)�%s (modul)�%s (rola)�%s pridané, %s zmenené, %s odstránené�%s voľba príkazového riadka�%s už je priradené číslo sekcie (vnorený číslovaný strom obsahu?)�%s nie je adresár.�%s() (metóda triedy %s)�%s() (metóda %s)�%s() (statická metóda %s)�%s() (zabudovaná funkcia)�%s() (trieda)�%s() (v module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' nie je platná voľba.�„%s” nie je platná voľba pyversion�'setup' definovaný v conf.py nie je funkciou. Prosím, upravte jeho definíciu tak, aby to bola funkcia. Je to potrebné, aby sa conf.py mohol správať ako rozšírenie Sphinx.�(<<original entry>> je umiestnená v %s, riadok %d.)�(v %s v%s)�(v %s)�, v �argument voľby -A musí byť v tvare meno=hodnota�argument voľby -D musí byť v tvare meno=hodnota�%s (voľba direktívy)�<<pôvodná položka>>�<h1>Všetky moduly, pre ktoré je dostupný kód</h1>�<h1>Zdrojový kód %s</h1>�Súbory Makefile a príkazový súbor Windows môže byť pre Vás vygenerovaný takže stačí spustiť napr. len `make html' namiesto priameho spúšťania sphinx-build.�Hlásenie o chybe možno vyplniť na <https://github.com/sphinx-doc/sphinx/issues>. Ďakujeme!�Autosummary s popiskom vyžaduje voľbu :toctree: , ignorované.�O dokumentácii�Nastala chyba pri spracovaní stránky %s. Príčina: %r�Kotva „%s” nenájdená�Žiadne ID nie je priradené uzlu %s�Argumenty�Výstraha�Meno(á) autora(ov)�Autor:�Automaticky generovaný zoznam zmien vo verzii %(version)s�Základ: %s�Builder %r už existuje (v module %s)�Trieda builder %s nemá atribút „name”�Builder s menom %s nie je registrovaný�Builder s menom %s nie je registrovaný ani dostupný cez vstupný bod�Zabudované funkcie�Zmeny API C�Nemožno nájsť zdrojový priečinok (%s)�Nemožno použiť „lineno-match” s rozdelenou množinou „lines”�Nemožno použiť obe voľby „%s” a „%s”�Upozornenie�Zmenené vo verzii %s�Zmeny vo verzii %(version)s — %(docstitle)s�Citácia [%s] nie je odkazovaná.�Autor kódu:�Zbaliť bočný panel�Celkový obsah�Konfiguračná hodnota %r už existuje�Obsah�Autorské právo�Nemožno získať vzdialený obrázok: %s [%d]�Nemožno získať vzdialený obrázok: %s [%s]�Nemožno importovať rozšírenie %s�Nemožno spracovať literal_block ako "%s". Zvýraznenie syntaxe preskočené.�Nemožno získať veľkosť obrázku. voľba :scale: je ignorovaná.�Vytvoriť Makefile? (y/n)�Vytvoriť príkazový súbor Windows? (y/n) �Vytvorené pomocou <a href="https://www.sphinx-doc.org/">Sphinx</a> %(sphinx_version)s.�Vytváranie súboru %s.�Nebezpečné�Zastarané�Zastarané od verzie %s�Doména %r nie je zaregistrovaná�Duplicitná deklarácia C, definovaná aj v %s:%s. Deklarácia je '.. c:%s:: %s'.�Duplicitná deklarácia C++, definovaná aj v %s:%s. Deklarácia je '.. cpp:%s:: %s'.�Kódovanie %r použité pri čítaní vloženého súboru %r vyzerá ako zlé, skúste zadať voľbu :encoding:�Chyba kódovania:�Zadajte cestu koreňa tejto dokumentácie.�Chyba�Chyba: nájdený existujúci conf.py v zadanej ceste koreňa.�Chyba: zadaná cesta nie je adresár alebo súbory sphinx už existujú.�Chyba: nájdený existujúci hlavný súbor %s v zadanej ceste koreňa.�Udalosť %r už existuje�Príklad�Príklady�Počas zostavenia sa vyskytla výnimka, spúšťam ladenie:�Nastala výnimka:�Rozbaliť bočný panel�Voľby rozšírenia�Externý súbor Graphviz %r nebol nájdený alebo zlyhalo jeho čítanie�Kopírovanie súboru v html_static_file zlyhalo: %s: %r�Zlyhalo vytvorenie krížového odkazu. nenájdení názov alebo titulok: %s�Zlyhalo vytvorenie krížového odkazu. Nie je priradené žiadne číslo: %s�Zlyhalo spracovanie predvolenej hodnoty argumentu %r: %s�Čítanie súboru zostavenia info zlyhalo: %r�Zlyhalo čítanie intersphinx_mapping[%s], ignorované: %r�Zlyhalo skenovanie dokumentov v %s: %r�Zápis súboru zostavenia info zlyhal: %r�Obr. %s�Súbor %s už existuje, preskočené.�Dokončené: Počiatočná štruktúra adresára bola vytvorená.�Poznámka pod čiarou [#] nie je odkazovaná.�Poznámka pod čiarou [%s] nie je odkazovaná.�Poznámky pod čiarou�Celý index na jednej strane�Všeobecný index�Celkový index modulov�OK�Direktíva graphviz nemôže mať naraz argumenty content a filename�Obsluha %r udalosti %r vyvolala výnimku�Skryť výsledky hľadania�Rada�Ak má byť dokumentácia písaná v inom ako Anglickom jazyku, môžete tu zvoliť jazyk pomocou jeho kódu. Sphinx bude potom prekladať text, ktorý generuje, do tohoto jazyka. Zoznam podporovaných jazykov nájdete na https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Ignorovaná direktíva „graphviz” bez obsahu.�Dôležité�Súbor na vloženie %r nebol nájdený alebo zlyhalo jeho čítanie�Index�Index – %(key)s�Indexové stránky po písmenách�Informuje, ktoré z nasledujúcich rozšírení Sphinx majú byť zapnuté:�Indexy a tabuľky�V koreňovom adresári budú vytvorená dva ďalšie adresáre; "_templates" pre vlastné šablóny HTML a "_static" pre vlastné CSS a iné statické súbory Môžete zadať inú predponu (napr. „.”), ktorá nahradí podčiarkovník.�Prerušené!�Neplatné __slots__ nájdené v %s. Ignorované.�Neplatný popis: %s�Neplatný formát dátumu. Použije jednoduché úvodzovky, ak ho chcete priamo vo výstupe: %s�neplatný math_eqref_format: %r�Neplatná premenná šablóny: %s�Argumenty kľúčových slov�Nemožno spustiť príkaz LaTeX %r (potrebný na zobrazenie math), skontrolujte nastavenia imgmath_latex�Naposledy aktualizované %(last_updated)s.�Zmeny knižnice�Riadok %r: žiadne riadky z vloženého súboru %r�Výpis %s�Hľadajte akékoľvek chyby v predošlom výstupe alebo v %(outdir)s/output.txt�Vytvorenie Makefile a Batchfile�Nesprávny popis voľby %r, má vyzerať ako „opt”, „-opt argumenty”, „--opt argumenty”, „/opt argumenty” alebo „+opt argumenty”�Zaregistrovaných je viac math_renderer, ale žiadny nie je zvolený.�Index modulov�Autor modulu:�Kód modulu�Úroveň modulu�Meno hlavného dokumentu (bez prípony)�Predpona mena adresárov templates a static�Navigácia�Nové vo verzii %s�Ďalšia téma�Nebol zvolený builder, bude použitý predvolený: html�Neznáma konfiguračná hodnota: %s�Poznámka�Pozor: imgmath a mathjax nemožno zapnúť naraz. výber imgmath bol zrušený.�Poznámky�Čísla�Objekt s menom %r nebol nájdený vo vloženom súbore %r�Jeden dokument je špeciálny v tom, že je považovaný za vrcholový uzol „stromu obsahu”, čiže je to koreň hierarchickej štruktúry dokumentov. Bežne to je „index”, ale ak je Váš „index” vlastnou šablónou, môžete použiť aj iné meno súboru.�Pôvodná výnimka: �Ostatné parametre�Ostatné zmeny�Výstupný adresár (%s) nie je adresár�Prehľad�Prehľad: kód modulu�Parametre�Trvalý odkaz na tento kód�Trvalý odkaz na túto definíciu�Trvalý odkaz na tento vzorec�Trvalý odkaz na tento nadpis�Trvalý odkaz na tento obrázok�Trvalý odkaz na túto tabuľku�Trvalý odkaz na tento termín�Trvalý odkaz na tento strom obsahu�Pillow nenájdené – kopírovanie súborov obrázkov�Prosím, na zapnutie funkcie hľadania,aktivujte JavaScript .�Prosím, nahláste to, i keď to bola chyba používateľa, aby mohla byť nabudúce poskytnutá lepšia chybová správa.�Prosím, zadajte príponu súboru, napr. '.rst' alebo '.txt'.�Prosím, zadajte nové meno súboru alebo premenujte existujúci súbor a stlačte Enter�Prosím, zadajte novú cestu koreňa (alebo len Enter na skončenie)�Prosím, zadajte platnú cestu.�Prosím, zadajte buď 'y' alebo 'n'.�Prosím, zadajte jedno z 1%s.�Prosím, zadajte nejaký text.�Príprava hľadania...�Predošlá téma�Základné voľby projektu�Jazyk projektu�Názov projektu�Vydanie projektu�Šablóny projektu�Verzia projektu�Neznáme meno lexera Pygments %r�Python Enhancement Proposals; PEP %s�Index modulov Python�Rýchle hľadanie�Vyzdvihuje�Chyba rekurzie:�Vydanie�Návratový typ�Vracia�Cesta koreňa dokumentácie�Spúšťanie Sphinx v%s�Hľadať�Hľadať v %(docstitle)s�Stránka hľadania�Výsledky hľadania�Hľadanie dokončené, nájdené %s strana(y), ktoré vyhovujú hľadanému výrazu.�Hľadať v %(docstitle)s�Hľadanie�Hľadanie viacerých slov vracia len zhody, ktoré obsahujú všetky slová.�Sekcia %s�Autor sekcie:�Viď aj�Zvolená cesta koreňa: %s�Oddeliť zdrojový a výstupný adresár (y/n)�Zobraziť zdroj�Od v2.0 Sphinx predvolene používa „index” ako root_doc. Prosím, pridajte „root_doc = 'contents'” do svojho conf.py.�Zdrojový a cieľový priečinok nemôžu byť rovnaké�Prípona zdrojových súborov�Analyzátor pre %s nie je registrovaný�Sphinx má predstavu o "version" a "release" softvéru. Každá verzia môže mať viacero vydaní. Napríklad, pre Python je verzia niečo ako 2.5 alebo 3.0, zatiaľčo vydanie je niečo ako 2.5.1 alebo 3.0a1. Ak nepotrebuje dvojitú štruktúru, jednoducho nastavte oboje na rovnakú hodnotu.�Voľby štruktúry�Symboly�Nájdená položka TODO: %s�Tabuľka %s�Obsah�Parametre šablóny�crossref_type %r už je registrovaný�Direktíva %r už je registrovaná v doméne %s�Index %r už je registrovaný v doméne %s� object_type %r už je registrovaný�Rola %r už je registrovaná v doméne %s�Rozšírenie %s je vyžadované nastavením needs_extensions, ale nie je načítané.�Rozšírenie %s použité týmto projektom vyžaduje aspoň Sphinx v%s; takže ho nemožno zostaviť s touto verziou.�Stránky HTML sú v %(outdir)s.�Stránky HTML sú v %(outdir)s.�Súbory LaTeX sú v %(outdir)s.�Súbory Texinfo sú v %(outdir)s.�Súbory XML sú v %(outdir)s.�Konfiguračná hodnota „source_suffix” očakáva reťazec, zoznam reťazcov alebo slovník, ale zadali ste „%r”.�Konfiguračná hodnota `{name}' má typ `{current.__name__}', predvolene `{default.__name__}'.�Konfiguračná hodnota `{name}' má typ `{current.__name__}'; očakávané {permitted}.�Konfiguračná hodnota `{name}` má byť jedno z {candidates}, ale je zadané `{current}`.�Konfiguračný súbor (alebo jeden z modulov, ktoré importuje) volal sys.exit()�Zostavovač dummy negeneruje žiadne súbory.�Súbory ePub sú v %(outdir)s.�Prípona mena zdrojových súborov. Zvyčajne to je buď „.txt” alebo „.rst”. Len súbory s touto príponou sú považované za dokumenty.�Úplný záznam chýb bol zapísaný v %s, ak chcete nahlásiť problém vývojárom.�Manuálové stránky sú v %(outdir)s.�Katalógy správ sú v %(outdir)s.�Súbor prehľadu je v %(outdir)s.�Meno projektu bude na viacerých miestach zostavenej dokumentácie.�Súbory pseudo-XML sú v %(outdir)s.�Textové súbory sú v %(outdir)s.�V konfiguračnom súbore je programová chyba: %s�Vo svojom konfiguračnom súbore máte chybu: %s �Táto stránka�Toto môže nastať s veľmi veľkými alebo príliš hlboko vnáranými zdrojovými súbormi. môžete opatrne zvýšiť predvolenú hodnotu limitu rekurzie Python z 1000 v conf.py, napr.:�Toto prostredie nie je kompatibilné zo zvoleným zostavovačom, prosím, zvoľte iný adresár doctree.�Tento projekt vyžaduje aspoň Sphinx v%s a preto s touto verziou nemôže byť zostavený.�Tento projekt vyžaduje rozšírenie %s s verziou minimálne %s, a teda ho nemožno zostaviť s načítanou verziou (%s).�Vyvoláva�Tip�ToDo�Translator pre %r už existuje�Neznámy konfiguračný kľúč: latex_elements[%r], ignorovaný.�Neznáme meno udalosti %s�Neznámy formát obrázku: %s...�Zdaný neznámy math_renderer %r.�Neznáma voľba témy: latex_theme_options[%r], ignorovaná.�Na zostavenie dokumentácie použite Makefile, napr.: make builder�Na zostavenie dokumentácie použite príkaz sphinx-build, napr.: sphinx-build -b builder %s %s�Premenné�Varovanie�Varovania�Vitajte v nástroji Sphinx %s quickstart.�Vitajte! Toto je�Sú dve možnosti umiestnenia adresára zostavenia s výstupom Sphinx. Môžete použiť buď adresár „_build” v koreni alebo môžete mať oddelené adresáre „source” a „build” v ceste koreňa.�Teraz môže vyplniť svoj hlavný súbor %s a vytvoriť ostatné zdrojové súbory dokumentácie. �Vášmu hľadaniu nezodpovedá žiadny dokument. Prosím, skontrolujte, že všetky zadané slová sú správne napísané a že ste zvolili vhodné kategórie.�[dokumenty]�[graf: %s]�[graf]�[obrázok: %s]�[obrázok]�[zdroj]�__all__ má byť zoznam reťazcov, nie %r (v module %s) -- ignorované __all__�pri spracovaní stránky %s nastala chyba Unicode. Prosím, zaistite, že všetky konfiguračné hodnoty, ktoré obsahujú nieASCII hodnotu sú reťazce Unicode.�zoznam špecifických súborov na zostavenie, ignorovaný ak je použité -a�vhodný obrázok pre zostavovač %s nenájdený: %s�vhodný obrázok pre zostavovač %s nenájdený: %s (%s)�alias pre %s�alias pre TypeVar(%s)�všetky funkcie, triedy, termíny�všetky z %d súborov po�všetky zdrojové súbory�pripojiť module_path do sys.path, použité pri --full�zostavovanie spoločného dokumentu�atribút�mená autorov�automaticky vložiť dokumentačné reťazce z modulov�automaticky testovať kúsky kódu v blokoch dokumentačných reťazcov�autosummary interne generuje súbory .rst. Ale Váš source_suffix neobsahuje .rst. Preskočené.�autosummary_generate: súbor nenájdený: %s�sú zadané obe, tabularcolumns aj voľba :widths:. :widths: je ignorované.�poškodený odkaz: %s (%s)�zostavenie %s, %s upozornenia/a (upozornenia považované za chyby).�zostavenie %s, %s upozornenie.�zostavenie %s, %s upozornenia/a (upozornenia považované za chyby).�zostavenie %s, %s upozornenie/a.�zostavenie %s.�prostredie zostavenia nie je aktuálne�zostaviť paralelne s N procesmi možné (špeciálna hodnota „auto” nastaví N na počet CPU)�súbor info zostavenia je poškodený: %r�použitý zostavovač (predvolený: html)�zostavovanie [%s]: �zostavenie [mo]: �zabudovaná funkcia�môže byť rozsiahle�nemožno kombinovať voľbu -a a mená súborov�nemožno kopírovať súbor na stiahnutie %r: %s�nemožno kopírovať extra súbor %r�nemožno kopírovať súbor obrázka %r: %s�nemožno kopírovať statický súbor %r�nemožno nájsť súbory %r�nemožno otvoriť súbor varovaní %r: %s�nemožno prepísať konfiguračné nastavenie %r s nepodporovaným typom, ignorované�nemožno prepísať slovník nastavenia %r, ignorované (použite %r na nastavenie jednotlivých prvkov)�nemožno čítať súbor obrázku %r: jeho kopírovanie namiesto toho�nemožno zapísať súbor obrázka %r: %s�titulok nie je vo vnútri figure.�kontrolovanie konzistencie�zistený cirkulárny odkaz stromu obsahu, ignorované: %s <- %s�trieda�metóda triedy�voľba príkazového riadka�koncept�podmienečné zahrnutie obsahu na základe konfiguračných volieb�konfiguračná hodnota „epub_author” nesmie byť prázdna pri EPUB3�konfiguračná hodnota „epub_contributor” nesmie byť prázdna pri EPUB3�konfiguračná hodnota „epub_copyright” (alebo „copyright”) nesmie byť prázdna pri EPUB3�konfiguračná hodnota „epub_description” nesmie byť prázdna pri EPUB3�konfiguračná hodnota „epub_identifier” nesmie byť prázdna pri EPUB3�konfiguračná hodnota „epub_language” (alebo „language”) nesmie byť prázdna pri EPUB3�konfiguračná hodnota „epub_publisher” nesmie byť prázdna pri EPUB3�konfiguračná hodnota „epub_title” (alebo „html_title”) nesmie byť prázdna pri EPUB3�konfiguračná hodnota „epub_uid” má byť XML NAME pre EPUB3�konfiguračná hodnota „version” nesmie byť prázdna pri EPUB3�zmenená konfigurácia�konfiguračný priečinok neobsahuje súbor conf.py (%s)�voľby výstupu konzoly�pokračovanie z predošlej strany�pokračuje na ďalšej strane�príkaz convert %r nemožno spustiť, skontrolujte nastavenie image_converter�príkaz convert %r nemožno spustiť, skontrolujte nastavenia image_converter: 1%s�convert skončil chybou: [stderr] %r [stdout] %r�kopírovanie podporných súborov Tex�kopírovanie podporných súborov Tex…�kopírovanie podporných súborov Texinfo�kopírovanie dodatočných súborov�kopírovanie súborov na stiahnutie…�kopírovanie extra súborov�kopírovanie obrázkov…�kopírovanie zdrojových súborov…�kopírovanie statických súborov�nemožno čítať %r na vytvorenie položky záznamu zmien�vytvoriť súbor .nojekyll na publikovanie dokumentu na GitHub�vytvoriť batchfile�vytvoriť makefile�vlastný adresár šablón (predvolene: %(default)s)�dáta�predvolená rola %s nenájdená�predvolená prípona súboru (predvolene: %(default)s)�definovať premennú šablóny�direktíva�direktíva %r už je registrovaná, bude prepísaná�adresár umiestnenia výstupu�adresár umiestnenia výstupu�zobrazený latex %r: %s�generovať farebný výstup (predvolene: automaticky detegovať)�nevytvoriť batchfile�nevytvoriť makefile�negenerovať farebný výstup (predvolene: automaticky detegovať)�nepoužiť režim make pre Makefile/make.bat�mená dokumentov na zapísanie: %s�dokument�dokumentovať importovaných členov (predvolene: %(default)s)�dokument nie je zahrnutý v žiadnom strome obsahu�jazyk dokumentácie�dokument nie je čitateľný. Ignorované.�názov dokumentu nie je jeden uzol Text�sériové spracovanie %s�doména %s už je zaregistrovaná�doména %s ešte nie je zaregistrovaná�nevytvárať súbor obsahu�nepoužívať uložené prostredie, vždy čítať všetky súbory�hotovo�kód dot %r: %s�príkaz dot %r nemožno spustiť (nutný kvôli výstupu graphviz), skontrolujte nastavenie graphviz_dot�dot nevytvoril výstupný súbor: [stderr] %r [stdout] %r�dot skončil chybou: [stderr] %r [stdout] %r�súbor na stiahnutie nemožno čítať: %s�generovanie inventára objektov…�generovanie indexu hľadania v %s�duplicitný %s popis %s, ďalší výskyt%s v %s�duplicitný %s popis %s, ďalší výskyt v %s�duplicitná citácia %s, ďalší výskyt v %s�duplicitný popis %s %s, ďalší výskyt v %s�duplicitná menovka %s, ďalší výskyt v %s�duplicitná menovka vzorca %s, ďalší výskyt v %s�duplicitný popis objektu %s, ďalší výskyt v %s, použite :noindex: pre jeden z nich�nájdená duplicitná položka Obsahu: %s�zapnúť rozšírenie %s�zapnúť konkrétne rozšírenia�nastali problémy s niektorými inventármi, ale boli nájdené funkčné alternatívy:�enum�enumerable_node %r už je registrovaný�enumerátor�premenná prostredia�premenná prostredia; %s�chyba formátovania argumentov %s: %s�chyba zápisu súboru %s: %s�chyba zápisu súboru Makefile: %s�výnimka�rozšírenie %r nemá funkciu setup(); je to naozaj modul rozšírenia Sphinx?�rozšírenie %r vrátilo so svojej funkcie setup() nepodporovaný objekt; musí vrátiť None alebo slovník metadát�voľby rozšírenia�zmenené rozšírenie�zlyhalo�zlyhal import objektu %s�zlyhalo spracovanie mena %s�nemožno získať žiadne inventáre kvôli týmto problémom:�zlyhalo: %s�súbor favicon %r neexistuje�súbor %r zadaný v príkazovom riadku neexistuje, ignorujem�súbor %r zadaný v príkazovom riadku nie je v zdrojovom adresári, ignorujem�súbor %r v ceste témy nie je platný súbor ZIP alebo neobsahuje tému�prípona súboru (predvolene: rst)�meno súboru obsahu (predvolene: modules)�dokončené sproblémami�nasledovať symbolické odkazy. Vhodné v kombinácii s collective.recipe.omelette.�funkcia�parameter funkcie�všeobecné voľby�generovať úplný projekt pomocou sphinx-quickstart�generovanie indexov�glosár vyzerá byť zle naformátovaný, skontrolujte odsadenie�termín glosára�položke glosára musí predchádzať prázdny riadok�položky glosára nesmú byť oddelené prázdnymi riadkami�jazykový token�graphviz_output_format musí byť „png” alebo „svg”, ale je %r�zvýrazňovanie syntaxe kódu modulu... �html_add_permalinks bolo označené za zastarané od v3.5.0. Prosím, použite namiesto toho html_permalinks a html_permalinks_icon.�položka „html_extra_path entry” %r neexistuje�položka html_extra_path %r je umiestnené vo vnútri výstupného adresára�položka „html_static_path” %r neexistuje�položka html_static_path %r je umiestnené vo vnútri výstupného adresára�ak je zadané, vytvoriť výstupný adresár v zdrojovom�ak je zadané, oddeliť zdrojový a výstupný adresár� Súbor obrázku %s nemožno čítať: %s�súbor obrázku nemožno čítať: %s�zahrnúť ”_súkromné” moduly�zahrnúť odkazy na zdrojový kód dokumentovaných objektov Python�zahrnúť math, spracované ako obrázky PNG alebo SVG�zahrnúť math, spracované prehliadačom pomocou MathJax�zvýšiť rozvláčnosť (možno opakovať)�index�vnorený latex %r: %s�interpretovať cesty modulov v zmysle implicitnej špecifikácie menných priestorov PEP-0420�identifikátor intersphinx %rnie je raťzec, ignorované�inventár intersphinx bol presunutý: %s -> %s�neplatný typ TestCode�neplatný css_file: %r, ignorovaný�neplatné js_file: %r, ignorované�neplatný počet %r pre konfiguračnú hodnotu %r, ignorované�neplatný numfig_format: %s�neplatný numfig_format: %s (%r)�neplatný regulárny výraz %r v %s�neplatný regulárny výraz %r v coverage_c_regexes�neplatná hodnota množiny (chýba koncová zátvorka): %s�neplatná hodnota množiny (chýba začiatočná zátvorka): %s�počet úloh musí byť kladné číslo�kľúč. slovo�posledná aktualizácia�špecifikácia čísla riadku je mimo rozsahu (1-%d): %r�prepojenie medzi dokumentáciou Sphinx rôznych modulov�zoznam všetkých sekcií a podsekcií�načítanie inventára intersphinx z %s...�načítanie uloženého prostredia �načítanie prekladov [%s]…�súbor loga %r neexistuje�hľadanie zastaraných súborov…�makro�vytváranie výstupnej zložky�neplatná textová konštanta (chýba koncová úvodzovka): %s�neplatná textová konštanta (chýba začiatočná úvodzovka): %s�meno hlavného dokumentu�maximálna hĺbka submodulov, ktorá má byť zobrazená v obsahu (predvolene: 4)�člen�metóda�chýbajúce „+” alebo „-” vo voľbe „%s”.�chýba atribút %s objektu %s�chýbajúci atribút spomenutý vo voľbe :members: : modul %s, atribút %s�modul�modul %s nemožno importovať: %s�moduly�viac ako jeden cieľ krížového odkazu %r: môže byť %s�nájdený viac ako jeden cieľ krížového odkazu %r: %s�nájdených viacero súborov pre dokument "%s": %r Na zostavenie použite %r.�nová konfigurácia�ďalší�ďalšia kapitola�hnidopichný režim, upozorniť na všetky chýbajúce prepojenia�nebola nájdená konfiguračná voľba „latex_documents”; dokmenty nebudú zapísané�nebola nájdená konfiguračná voľba „man_pages”; manuálové stránky nebudú zapísané�nebola nájdená konfiguračná voľba „texinfo_documents”; dokumenty nebudú zapísané�žiadna známa voľba Babel pre jazyk %r�žiadne zmeny vo verzii %s.�vôbec žiadny výstup, ani upozornenia�žiadny výstup, len upozornenia na stderr�žiadne ciele nie sú zastarané.�nebola nájdená téma smenom %r (chýbajúci theme.conf?)�nebola nájdená téma s menom %r, dedená v %r�trieda uzla %r už je registrovaná, jej metódy (visitors) budú prepísané�nenájdené�nedostupné pre zabudované správy�numfig je vypnutý, :numref: je ignorované.�nie je definovaný numfig_format pre %s�objekt�operátor�pôvodná položka�prepíše nastavenie konfiguračného súboru�prepísať existujúce súbory�strana�stránka %s vyhovuje dvom vzorom v html_sidebars: %r a %r�pošle hodnotu do šablón HTML�cesta uloženého prostredia a súbory doctree (predvolene: OUTPUTDIR/.doctrees)�cesta k zdrojovým súborom dokumentácie�cesta k dokumentovanému modulu�cesta k výstupnej zložke�cesta k adresáru s konfiguračným súborom (conf.py) (predvolene: rovnaké ako SOURCEDIR)�ukladanie prostredia�príprava dokumentov�predošlý�predošlá kapitola�primary_domain %r nenájdená, ignorované.�spracovanie %s�voľba programu�autor(i) projektu, použité pri --full�názov projektu�meno projektu (predvolene: meno koreňového modulu)�vydanie projektu, použité pri --full, predvolene --doc-version�koreň projektu�verzia projektu, použité pri --full�vlastnosť�umiestniť dokumentáciu každého modulu vo vlastnej stránke�vložiť dokumentáciu modulu pred dokumentáciou submodulu�rýchly prístup ku všetkým modulom�tichý režim�Chyba značky reST:�chyba čítania: %s, %s�čítanie zdrojov…�čítanie šablón… �menovka odkazu�vydanie projektu�náhrada za bodku v _templates apod.�riešenie odkazov…�rola�rola %r už je registrovaná, bude prepísaná�pri výnimke spustiť Pdb�spustí skript bez vytvorenia súborov�hľadať�index hľadania nemožno načítať, ale nebudú zostavované všetky dokumenty, takže index nebude kompletný.�hľadať v tejto dokumentácii�viď %s�viď aj %s�nájdený na seba odkazujúci strom obsahu. Ignorované.�nastavenie %s.%s nenájdené v žiadnom z nastavení témy�pri výnimke zobraziť úplné chybové hlásenie�preskočené�zdrojový adresár zmenený�prípona zdrojových súborov�source_parser pre %r už je registrovaný�source_suffix %r už je registrovaný�sphinx-quickstart generuje len do prázdneho adresára. Prosím, zadajte novú cestu koreňa.�sphinx-quickstart neprepíše existujúce projekty Sphinx.�sphinx-quickstart neprepíše existujúci súbor.�nájdená sphinx_rtd_theme (< 0.3.0). Táto nebude dostupná od Sphinx-6.0�príkaz�statická metóda�úspešné�ciele pre %d po súborov, ktoré sú zastarané�ciele pre %d po súborov, ktoré boli zadané�ciele pre %d zdrojových súborov, ktoré sú zastarané�adresár šablóny pre súbory šablóny�parameter šablóny�rozšírenie %s nedeklaruje, či je bezpečné pri paralelnom čítaní, predpokladá sa, že nie - prosím, požiadajte autora aby to skontroloval a explicitne to nastavil�rozšírenie %s nedeklaruje, či je bezpečné pri paralelnom čítaní, predpokladáme, že nie je – prosím, požiadajte autora aby to skontroloval a explicitne to nastavil�rozšírenie %s nie je bezpečné pre paralelné zostavenie�rozšírenie %s nie je bezpečné pre paralelné zostavenie�dokumentácia�rozšírenie %r bolo zlúčené so Sphinx od verzie %s; toto rozšírenie je ignorované.�odkaz nemá popisok: %s�téma %r nemá nastavenie „inherit”�téma %r nemá nastavenie „theme”�strom obsahu obsahuje neexistujúci súbor %r�strom obsahu obsahuje odkaz na dokument %r, ktorý nemá názov, odkaz nebude generovaný�strom obsahu obsahuje odkaz na vylúčený dokument %r�strom obsahu obsahuje odkaz na neexistujúci dokument %r�príliš veľké :maxdepth:, ignorované.�prepnúť upozornenia na chyby�typ�nedekódovateľné zdrojové znaky, nahradené „?”: %r�nedefinovaná menovka: %s�nedokumentované API C: %s [%s] v súbore %s�nedokumentovaná trieda Python: %s :: %s�nedokumentovaná funkcia Python: %s :: %s�nedokumentovaná metóda Python: %s :: %s :: %s�neimplementovaný typ uzla: %r�neznáma konfiguračná hodnota %r v prepísaní, ignorované�neznáma direktíva alebo meno role: %s:%s�neznámy typ položky indexu %r�neznámy typ MIME pre %s, ignorovaný�neznámy typ uzla: %r�zadaná nepodporovaná voľba témy %r�aktualizácia prostredia:�použiť epub�použiť režim make pre Makefile/make.bat�vôbec nepoužiť konfiguračný súbor, len voľby -D�premenná�verzia projektu�čakanie na procesy…�kde „builder” je jeden z podporovaných formátov, napr. html, latex alebo linkcheck.�pri nastavovaní rozšírenia %s:�s -W, pokračovať po upozornení�písať položky „todo”, ktoré môžu byť zobrazené alebo skryté pri zostavení�zapísať všetky súbory (predvolene: zapísať len nové a zmenené súbory)�zapísať varovania (a chyby) do zadaného súboru�zapisovanie�zapisovanie súboru %s…�zapisovanie súboru META-INF/container.xml…�zapisovanie dodatočných súborov�zapisovanie dodatočných stránok�zapisovanie súboru content.opf...�chyba zápisu: %s: %s�zapisovanie katalógov správ…�zapisovanie súboru mimetype…�zapisovanie súboru nav.xhtml...�zápis výstupu…�zapisovanie súboru prehľadu…�zapisovanie súboru toc.ncx...���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sk/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000334042�00000000000�021164� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # FIRST AUTHOR <EMAIL@ADDRESS>, 2008 # Slavko <linux@slavino.sk>, 2013-2019,2021 # Komiya Takeshi <i.tkomiya@gmail.com>, 2016 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Slovak (http://www.transifex.com/sphinx-doc/sphinx-1/language/sk/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: sk\n" "Plural-Forms: nplurals=4; plural=(n % 1 == 0 && n == 1 ? 0 : n % 1 == 0 && n >= 2 && n <= 4 ? 1 : n % 1 != 0 ? 2: 3);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Nemožno nájsť zdrojový priečinok (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "Výstupný adresár (%s) nie je adresár" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Zdrojový a cieľový priečinok nemôžu byť rovnaké" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Spúšťanie Sphinx v%s" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Tento projekt vyžaduje aspoň Sphinx v%s a preto s touto verziou nemôže byť zostavený." #: sphinx/application.py:243 msgid "making output directory" msgstr "vytváranie výstupnej zložky" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "pri nastavovaní rozšírenia %s:" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' definovaný v conf.py nie je funkciou. Prosím, upravte jeho definíciu tak, aby to bola funkcia. Je to potrebné, aby sa conf.py mohol správať ako rozšírenie Sphinx." #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "načítanie prekladov [%s]…" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "hotovo" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "nedostupné pre zabudované správy" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "načítanie uloženého prostredia " #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "zlyhalo: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "Nebol zvolený builder, bude použitý predvolený: html" #: sphinx/application.py:348 msgid "succeeded" msgstr "úspešné" #: sphinx/application.py:349 msgid "finished with problems" msgstr "dokončené sproblémami" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "zostavenie %s, %s upozornenia/a (upozornenia považované za chyby)." #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "zostavenie %s, %s upozornenia/a (upozornenia považované za chyby)." #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "zostavenie %s, %s upozornenie." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "zostavenie %s, %s upozornenie/a." #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "zostavenie %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "trieda uzla %r už je registrovaná, jej metódy (visitors) budú prepísané" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "direktíva %r už je registrovaná, bude prepísaná" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "rola %r už je registrovaná, bude prepísaná" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "rozšírenie %s nedeklaruje, či je bezpečné pri paralelnom čítaní, predpokladá sa, že nie - prosím, požiadajte autora aby to skontroloval a explicitne to nastavil" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "rozšírenie %s nie je bezpečné pre paralelné zostavenie" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "rozšírenie %s nedeklaruje, či je bezpečné pri paralelnom čítaní, predpokladáme, že nie je – prosím, požiadajte autora aby to skontroloval a explicitne to nastavil" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "rozšírenie %s nie je bezpečné pre paralelné zostavenie" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "sériové spracovanie %s" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "konfiguračný priečinok neobsahuje súbor conf.py (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "nemožno prepísať slovník nastavenia %r, ignorované (použite %r na nastavenie jednotlivých prvkov)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "neplatný počet %r pre konfiguračnú hodnotu %r, ignorované" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "nemožno prepísať konfiguračné nastavenie %r s nepodporovaným typom, ignorované" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "neznáma konfiguračná hodnota %r v prepísaní, ignorované" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "Neznáma konfiguračná hodnota: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "Konfiguračná hodnota %r už existuje" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Vo svojom konfiguračnom súbore máte chybu: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Konfiguračný súbor (alebo jeden z modulov, ktoré importuje) volal sys.exit()" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "V konfiguračnom súbore je programová chyba:\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "Konfiguračná hodnota „source_suffix” očakáva reťazec, zoznam reťazcov alebo slovník, ale zadali ste „%r”." #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Sekcia %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Obr. %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tabuľka %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Výpis %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "Konfiguračná hodnota `{name}` má byť jedno z {candidates}, ale je zadané `{current}`." #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "Konfiguračná hodnota `{name}' má typ `{current.__name__}'; očakávané {permitted}." #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "Konfiguračná hodnota `{name}' má typ `{current.__name__}', predvolene `{default.__name__}'." #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r nenájdená, ignorované." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "Od v2.0 Sphinx predvolene používa „index” ako root_doc. Prosím, pridajte „root_doc = 'contents'” do svojho conf.py." #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "Udalosť %r už existuje" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Neznáme meno udalosti %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "Obsluha %r udalosti %r vyvolala výnimku" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "Rozšírenie %s je vyžadované nastavením needs_extensions, ale nie je načítané." #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "Tento projekt vyžaduje rozšírenie %s s verziou minimálne %s, a teda ho nemožno zostaviť s načítanou verziou (%s)." #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "Neznáme meno lexera Pygments %r" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "Nemožno spracovať literal_block ako \"%s\". Zvýraznenie syntaxe preskočené." #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "nájdených viacero súborov pre dokument \"%s\": %r\nNa zostavenie použite %r." #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "dokument nie je čitateľný. Ignorované." #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "Trieda builder %s nemá atribút „name”" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Builder %r už existuje (v module %s)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Builder s menom %s nie je registrovaný ani dostupný cez vstupný bod" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "Builder s menom %s nie je registrovaný" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "doména %s už je zaregistrovaná" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "doména %s ešte nie je zaregistrovaná" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "Direktíva %r už je registrovaná v doméne %s" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "Rola %r už je registrovaná v doméne %s" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "Index %r už je registrovaný v doméne %s" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr " object_type %r už je registrovaný" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "crossref_type %r už je registrovaný" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "source_suffix %r už je registrovaný" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "source_parser pre %r už je registrovaný" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "Analyzátor pre %s nie je registrovaný" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "Translator pre %r už existuje" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "enumerable_node %r už je registrovaný" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "rozšírenie %r bolo zlúčené so Sphinx od verzie %s; toto rozšírenie je ignorované." #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "Pôvodná výnimka:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "Nemožno importovať rozšírenie %s" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "rozšírenie %r nemá funkciu setup(); je to naozaj modul rozšírenia Sphinx?" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "Rozšírenie %s použité týmto projektom vyžaduje aspoň Sphinx v%s; takže ho nemožno zostaviť s touto verziou." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "rozšírenie %r vrátilo so svojej funkcie setup() nepodporovaný objekt; musí vrátiť None alebo slovník metadát" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "téma %r nemá nastavenie „theme”" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "téma %r nemá nastavenie „inherit”" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "nebola nájdená téma s menom %r, dedená v %r" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "nastavenie %s.%s nenájdené v žiadnom z nastavení témy" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "zadaná nepodporovaná voľba témy %r" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "súbor %r v ceste témy nie je platný súbor ZIP alebo neobsahuje tému" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "nájdená sphinx_rtd_theme (< 0.3.0). Táto nebude dostupná od Sphinx-6.0" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "nebola nájdená téma smenom %r (chýbajúci theme.conf?)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "vhodný obrázok pre zostavovač %s nenájdený: %s (%s)" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "vhodný obrázok pre zostavovač %s nenájdený: %s" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "zostavenie [mo]: " #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "zápis výstupu…" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "všetky z %d súborov po" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "ciele pre %d po súborov, ktoré boli zadané" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "ciele pre %d po súborov, ktoré sú zastarané" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "všetky zdrojové súbory" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "súbor %r zadaný v príkazovom riadku nie je v zdrojovom adresári, ignorujem" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "súbor %r zadaný v príkazovom riadku neexistuje, ignorujem" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "%d zdrojové súbory zadané v príkazovom riadku" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "ciele pre %d zdrojových súborov, ktoré sú zastarané" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "zostavovanie [%s]: " #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "hľadanie zastaraných súborov…" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "%d nájdené" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "nenájdené" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "ukladanie prostredia" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "kontrolovanie konzistencie" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "žiadne ciele nie sú zastarané." #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "aktualizácia prostredia:" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "%s pridané, %s zmenené, %s odstránené" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "čítanie zdrojov…" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "čakanie na procesy…" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "mená dokumentov na zapísanie: %s" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "príprava dokumentov" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "nájdená duplicitná položka Obsahu: %s" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "kopírovanie obrázkov…" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "nemožno čítať súbor obrázku %r: jeho kopírovanie namiesto toho" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "nemožno kopírovať súbor obrázka %r: %s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "nemožno zapísať súbor obrázka %r: %s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "Pillow nenájdené – kopírovanie súborov obrázkov" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "zapisovanie súboru mimetype…" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "zapisovanie súboru META-INF/container.xml…" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "zapisovanie súboru content.opf..." #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "neznámy typ MIME pre %s, ignorovaný" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "zapisovanie súboru toc.ncx..." #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "zapisovanie súboru %s…" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "Súbor prehľadu je v %(outdir)s." #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "žiadne zmeny vo verzii %s." #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "zapisovanie súboru prehľadu…" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Zabudované funkcie" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Úroveň modulu" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "kopírovanie zdrojových súborov…" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "nemožno čítať %r na vytvorenie položky záznamu zmien" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "Zostavovač dummy negeneruje žiadne súbory." #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "Súbory ePub sú v %(outdir)s." #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "zapisovanie súboru nav.xhtml..." #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "konfiguračná hodnota „epub_language” (alebo „language”) nesmie byť prázdna pri EPUB3" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "konfiguračná hodnota „epub_uid” má byť XML NAME pre EPUB3" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "konfiguračná hodnota „epub_title” (alebo „html_title”) nesmie byť prázdna pri EPUB3" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "konfiguračná hodnota „epub_author” nesmie byť prázdna pri EPUB3" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "konfiguračná hodnota „epub_contributor” nesmie byť prázdna pri EPUB3" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "konfiguračná hodnota „epub_description” nesmie byť prázdna pri EPUB3" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "konfiguračná hodnota „epub_publisher” nesmie byť prázdna pri EPUB3" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "konfiguračná hodnota „epub_copyright” (alebo „copyright”) nesmie byť prázdna pri EPUB3" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "konfiguračná hodnota „epub_identifier” nesmie byť prázdna pri EPUB3" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "konfiguračná hodnota „version” nesmie byť prázdna pri EPUB3" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "neplatný css_file: %r, ignorovaný" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "Katalógy správ sú v %(outdir)s." #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "čítanie šablón… " #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "zapisovanie katalógov správ…" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "Hľadajte akékoľvek chyby v predošlom výstupe alebo v %(outdir)s/output.txt" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "poškodený odkaz: %s (%s)" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "Kotva „%s” nenájdená" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "Manuálové stránky sú v %(outdir)s." #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "nebola nájdená konfiguračná voľba „man_pages”; manuálové stránky nebudú zapísané" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "zapisovanie" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "konfiguračná voľba „man_pages” odkazuje na neznámy dokument %s" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "Stránky HTML sú v %(outdir)s." #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "zostavovanie spoločného dokumentu" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "zapisovanie dodatočných súborov" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "Súbory Texinfo sú v %(outdir)s." #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "\nSpustite v tomto adresári 'make' na ich spustenie pomocou makeinfo\n(použite tu 'make info' aby to bolo spustené automaticky)." #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "nebola nájdená konfiguračná voľba „texinfo_documents”; dokumenty nebudú zapísané" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "konfiguračná voľba „texinfo_documents” odkazuje na neznámy dokument %s" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "spracovanie %s" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "riešenie odkazov…" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "(v" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "kopírovanie podporných súborov Texinfo" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "chyba zápisu súboru Makefile: %s" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "Textové súbory sú v %(outdir)s." #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "chyba zápisu súboru %s: %s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "Súbory XML sú v %(outdir)s." #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "Súbory pseudo-XML sú v %(outdir)s." #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "súbor info zostavenia je poškodený: %r" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "Stránky HTML sú v %(outdir)s." #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "Čítanie súboru zostavenia info zlyhalo: %r" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d. %b %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Všeobecný index" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "index" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "ďalší" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "predošlý" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "generovanie indexov" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "zapisovanie dodatočných stránok" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "kopírovanie súborov na stiahnutie…" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "nemožno kopírovať súbor na stiahnutie %r: %s" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "Kopírovanie súboru v html_static_file zlyhalo: %s: %r" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "kopírovanie statických súborov" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "nemožno kopírovať statický súbor %r" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "kopírovanie extra súborov" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "nemožno kopírovať extra súbor %r" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "Zápis súboru zostavenia info zlyhal: %r" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "index hľadania nemožno načítať, ale nebudú zostavované všetky dokumenty, takže index nebude kompletný." #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "stránka %s vyhovuje dvom vzorom v html_sidebars: %r a %r" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "pri spracovaní stránky %s nastala chyba Unicode. Prosím, zaistite, že všetky konfiguračné hodnoty, ktoré obsahujú nieASCII hodnotu sú reťazce Unicode." #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "Nastala chyba pri spracovaní stránky %s.\nPríčina: %r" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "generovanie inventára objektov…" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "generovanie indexu hľadania v %s" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "neplatné js_file: %r, ignorované" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "Zaregistrovaných je viac math_renderer, ale žiadny nie je zvolený." #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "Zdaný neznámy math_renderer %r." #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "položka „html_extra_path entry” %r neexistuje" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "položka html_extra_path %r je umiestnené vo vnútri výstupného adresára" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "položka „html_static_path” %r neexistuje" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "položka html_static_path %r je umiestnené vo vnútri výstupného adresára" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "súbor loga %r neexistuje" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "súbor favicon %r neexistuje" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "html_add_permalinks bolo označené za zastarané od v3.5.0. Prosím, použite namiesto toho html_permalinks a html_permalinks_icon." #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "Dokumentácia %s %s" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "Súbory LaTeX sú v %(outdir)s." #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\nSpustite v tomto adresári 'make' na ich spustenie pomocou (pdf)latex\n(použite tu 'make latexpdf' aby to bolo spustené automaticky)." #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "nebola nájdená konfiguračná voľba „latex_documents”; dokmenty nebudú zapísané" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "konfiguračná voľba „latex_documents” odkazuje na neznámy dokument %s" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Index" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Vydanie" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "žiadna známa voľba Babel pre jazyk %r" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "kopírovanie podporných súborov Tex" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "kopírovanie podporných súborov Tex…" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "kopírovanie dodatočných súborov" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "Neznámy konfiguračný kľúč: latex_elements[%r], ignorovaný." #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "Neznáma voľba témy: latex_theme_options[%r], ignorovaná." #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "%r nemá nastavenia „theme”" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "téma %r nemá nastavenie „1%s”" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "Počas zostavenia sa vyskytla výnimka, spúšťam ladenie:" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "Prerušené!" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "Chyba značky reST:" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "Chyba kódovania:" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "Úplný záznam chýb bol zapísaný v %s, ak chcete nahlásiť problém vývojárom." #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "Chyba rekurzie:" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "Toto môže nastať s veľmi veľkými alebo príliš hlboko vnáranými zdrojovými súbormi. môžete opatrne zvýšiť predvolenú hodnotu limitu rekurzie Python z 1000 v conf.py, napr.:" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "Nastala výnimka:" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "Prosím, nahláste to, i keď to bola chyba používateľa, aby mohla byť nabudúce poskytnutá lepšia chybová správa." #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "Hlásenie o chybe možno vyplniť na <https://github.com/sphinx-doc/sphinx/issues>. Ďakujeme!" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "počet úloh musí byť kladné číslo" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "\nGeneruje dokumentáciu zo zdrojových súborov.\n\nsphinx-build generuje dokumentáciu zo súborov v SOURCEDIR a umiestni ju\nv OUTPUTDIR. Konfiguračné voľby hľadá v 'conf.py' v SOURCEDIR.\nNa generovanie súborov šablón, vrátane 'conf.py' možno použiť nástroj\n'sphinx-quickstart'\n\nsphinx-build dokáže vytvoriť dokumentáciu v rôznych formátoch. Formát je\nzvolený zadaním mena zostavovača v príkazovom riadku; predvolene\nHTML. Zostavovače môžu vykonávať aj iné úlohy, ktoré súvisia so spracovaním\ndokuemntácie.\n\nPredvolene je zostavené všetko, čo bolo zmenené. Výstup len zvolených súborov\nmôže byť zostavený zadaním jednotlivých mien súborov.\n" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "cesta k zdrojovým súborom dokumentácie" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "cesta k výstupnej zložke" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "zoznam špecifických súborov na zostavenie, ignorovaný ak je použité -a" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "všeobecné voľby" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "použitý zostavovač (predvolený: html)" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "zapísať všetky súbory (predvolene: zapísať len nové a zmenené súbory)" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "nepoužívať uložené prostredie, vždy čítať všetky súbory" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "cesta uloženého prostredia a súbory doctree (predvolene: OUTPUTDIR/.doctrees)" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "zostaviť paralelne s N procesmi možné (špeciálna hodnota „auto” nastaví N na počet CPU)" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "cesta k adresáru s konfiguračným súborom (conf.py) (predvolene: rovnaké ako SOURCEDIR)" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "vôbec nepoužiť konfiguračný súbor, len voľby -D" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "prepíše nastavenie konfiguračného súboru" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "pošle hodnotu do šablón HTML" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "hnidopichný režim, upozorniť na všetky chýbajúce prepojenia" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "voľby výstupu konzoly" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "zvýšiť rozvláčnosť (možno opakovať)" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "žiadny výstup, len upozornenia na stderr" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "vôbec žiadny výstup, ani upozornenia" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "generovať farebný výstup (predvolene: automaticky detegovať)" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "negenerovať farebný výstup (predvolene: automaticky detegovať)" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "zapísať varovania (a chyby) do zadaného súboru" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "prepnúť upozornenia na chyby" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "s -W, pokračovať po upozornení" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "pri výnimke zobraziť úplné chybové hlásenie" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "pri výnimke spustiť Pdb" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "nemožno nájsť súbory %r" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "nemožno kombinovať voľbu -a a mená súborov" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "nemožno otvoriť súbor varovaní %r: %s" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "argument voľby -D musí byť v tvare meno=hodnota" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "argument voľby -A musí byť v tvare meno=hodnota" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "automaticky vložiť dokumentačné reťazce z modulov" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "automaticky testovať kúsky kódu v blokoch dokumentačných reťazcov" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "prepojenie medzi dokumentáciou Sphinx rôznych modulov" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "písať položky „todo”, ktoré môžu byť zobrazené alebo skryté pri zostavení" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "zahrnúť math, spracované ako obrázky PNG alebo SVG" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "zahrnúť math, spracované prehliadačom pomocou MathJax" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "podmienečné zahrnutie obsahu na základe konfiguračných volieb" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "zahrnúť odkazy na zdrojový kód dokumentovaných objektov Python" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "vytvoriť súbor .nojekyll na publikovanie dokumentu na GitHub" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "Prosím, zadajte platnú cestu." #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "Prosím, zadajte nejaký text." #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "Prosím, zadajte jedno z 1%s." #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "Prosím, zadajte buď 'y' alebo 'n'." #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "Prosím, zadajte príponu súboru, napr. '.rst' alebo '.txt'." #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "Vitajte v nástroji Sphinx %s quickstart." #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "Zvolená cesta koreňa: %s" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "Zadajte cestu koreňa tejto dokumentácie." #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "Cesta koreňa dokumentácie" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "Chyba: nájdený existujúci conf.py v zadanej ceste koreňa." #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "sphinx-quickstart neprepíše existujúce projekty Sphinx." #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "Prosím, zadajte novú cestu koreňa (alebo len Enter na skončenie)" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "Sú dve možnosti umiestnenia adresára zostavenia s výstupom Sphinx.\nMôžete použiť buď adresár „_build” v koreni alebo môžete mať oddelené\nadresáre „source” a „build” v ceste koreňa." #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "Oddeliť zdrojový a výstupný adresár (y/n)" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "V koreňovom adresári budú vytvorená dva ďalšie adresáre; \"_templates\"\npre vlastné šablóny HTML a \"_static\" pre vlastné CSS a iné statické súbory\nMôžete zadať inú predponu (napr. „.”), ktorá nahradí podčiarkovník." #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "Predpona mena adresárov templates a static" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "Meno projektu bude na viacerých miestach zostavenej dokumentácie." #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "Názov projektu" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "Meno(á) autora(ov)" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "Sphinx má predstavu o \"version\" a \"release\" softvéru. Každá\nverzia môže mať viacero vydaní. Napríklad, pre Python je verzia\nniečo ako 2.5 alebo 3.0, zatiaľčo vydanie je niečo ako 2.5.1\nalebo 3.0a1. Ak nepotrebuje dvojitú štruktúru, jednoducho nastavte\noboje na rovnakú hodnotu." #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "Verzia projektu" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "Vydanie projektu" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "Ak má byť dokumentácia písaná v inom ako Anglickom jazyku,\nmôžete tu zvoliť jazyk pomocou jeho kódu. Sphinx bude potom\nprekladať text, ktorý generuje, do tohoto jazyka.\n\nZoznam podporovaných jazykov nájdete na\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "Jazyk projektu" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "Prípona mena zdrojových súborov. Zvyčajne to je buď „.txt”\nalebo „.rst”. Len súbory s touto príponou sú považované za dokumenty." #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "Prípona zdrojových súborov" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "Jeden dokument je špeciálny v tom, že je považovaný za vrcholový uzol\n„stromu obsahu”, čiže je to koreň hierarchickej štruktúry dokumentov.\nBežne to je „index”, ale ak je Váš „index” vlastnou šablónou, môžete\npoužiť aj iné meno súboru." #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "Meno hlavného dokumentu (bez prípony)" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "Chyba: nájdený existujúci hlavný súbor %s v zadanej ceste koreňa." #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "sphinx-quickstart neprepíše existujúci súbor." #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "Prosím, zadajte nové meno súboru alebo premenujte existujúci súbor a stlačte Enter" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "Informuje, ktoré z nasledujúcich rozšírení Sphinx majú byť zapnuté:" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "Pozor: imgmath a mathjax nemožno zapnúť naraz. výber imgmath bol zrušený." #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "Súbory Makefile a príkazový súbor Windows môže byť pre Vás vygenerovaný\ntakže stačí spustiť napr. len `make html' namiesto priameho spúšťania sphinx-build." #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "Vytvoriť Makefile? (y/n)" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "Vytvoriť príkazový súbor Windows? (y/n) " #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "Vytváranie súboru %s." #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "Súbor %s už existuje, preskočené." #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "Dokončené: Počiatočná štruktúra adresára bola vytvorená." #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "Teraz môže vyplniť svoj hlavný súbor %s a vytvoriť ostatné zdrojové súbory\ndokumentácie. " #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "Na zostavenie dokumentácie použite Makefile, napr.:\n make builder" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "Na zostavenie dokumentácie použite príkaz sphinx-build, napr.:\n sphinx-build -b builder %s %s" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "kde „builder” je jeden z podporovaných formátov, napr. html, latex alebo linkcheck." #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "\nGenereuje požadované súbory projektu Sphinx.\n\nsphinx-quickstart je interaktívny nástroj, ktorý kladie niekoľko otázok o Vašom\nprojekte a potom generuje kompletný adresár dokumentácie a vzorový\nMakefile, na použitie so sphinx-build.\n" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "tichý režim" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "koreň projektu" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "Voľby štruktúry" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "ak je zadané, oddeliť zdrojový a výstupný adresár" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "ak je zadané, vytvoriť výstupný adresár v zdrojovom" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "náhrada za bodku v _templates apod." #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "Základné voľby projektu" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "názov projektu" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "mená autorov" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "verzia projektu" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "vydanie projektu" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "jazyk dokumentácie" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "prípona zdrojových súborov" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "meno hlavného dokumentu" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "použiť epub" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "Voľby rozšírenia" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "zapnúť rozšírenie %s" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "zapnúť konkrétne rozšírenia" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "Vytvorenie Makefile a Batchfile" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "vytvoriť makefile" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "nevytvoriť makefile" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "vytvoriť batchfile" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "nevytvoriť batchfile" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "použiť režim make pre Makefile/make.bat" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "nepoužiť režim make pre Makefile/make.bat" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "Šablóny projektu" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "adresár šablóny pre súbory šablóny" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "definovať premennú šablóny" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "bolo zadané „quiet”, ale nebol zadaný „project” alebo „author”." #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "Chyba: zadaná cesta nie je adresár alebo súbory sphinx už existujú." #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "sphinx-quickstart generuje len do prázdneho adresára. Prosím, zadajte novú cestu koreňa." #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "Neplatná premenná šablóny: %s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "Neplatný popis: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "špecifikácia čísla riadku je mimo rozsahu (1-%d): %r" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "Nemožno použiť obe voľby „%s” a „%s”" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "Súbor na vloženie %r nebol nájdený alebo zlyhalo jeho čítanie" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "Kódovanie %r použité pri čítaní vloženého súboru %r vyzerá ako zlé, skúste zadať voľbu :encoding:" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "Objekt s menom %r nebol nájdený vo vloženom súbore %r" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "Nemožno použiť „lineno-match” s rozdelenou množinou „lines”" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "Riadok %r: žiadne riadky z vloženého súboru %r" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Autor sekcie:" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Autor modulu:" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Autor kódu:" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autor:" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "voľba \":file:\" direktívy csv-table teraz rozpoznáva absolútnu cestu ako relatívnu k zdrojovému adresáru. Prosím, aktualizujte svoj dokument." #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "Duplicitná deklarácia C, definovaná aj v %s:%s.\nDeklarácia je '.. c:%s:: %s'." #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "%s (C %s)" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametre" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Vracia" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Návratový typ" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "člen" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "premenná" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funkcia" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "makro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "enum" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "enumerátor" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "typ" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "parameter funkcie" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Nové vo verzii %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Zmenené vo verzii %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Zastarané od verzie %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "duplicitná citácia %s, ďalší výskyt v %s" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "Citácia [%s] nie je odkazovaná." #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "Duplicitná deklarácia C++, definovaná aj v %s:%s.\nDeklarácia je '.. cpp:%s:: %s'." #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Parametre šablóny" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Vyvoláva" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "trieda" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "koncept" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "parameter šablóny" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (zabudovaná funkcia)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (metóda %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (trieda)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (globálna premenná alebo konštanta)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (atribút %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumenty" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modul)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "metóda" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "dáta" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atribút" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modul" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "duplicitný %s popis %s, ďalší výskyt%s v %s" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "duplicitná menovka vzorca %s, ďalší výskyt v %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "neplatný math_eqref_format: %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "kľúč. slovo" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operátor" #: sphinx/domains/python.py:61 msgid "object" msgstr "objekt" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "výnimka" #: sphinx/domains/python.py:63 msgid "statement" msgstr "príkaz" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "zabudovaná funkcia" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Premenné" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Vyzdvihuje" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (v module %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (v module %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (zabudovaná premenná)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (zabudovaná trieda)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (trieda v %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (metóda triedy %s)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "%s (vlastnosť %s)" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (statická metóda %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Index modulov Python" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "moduly" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Zastarané" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "metóda triedy" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "statická metóda" #: sphinx/domains/python.py:1176 msgid "property" msgstr "vlastnosť" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "duplicitný popis objektu %s, ďalší výskyt v %s, použite :noindex: pre jeden z nich" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "nájdený viac ako jeden cieľ krížového odkazu %r: %s" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (zastarané)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (direktíva)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "%s (voľba direktívy)" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (rola)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "direktíva" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "rola" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "duplicitný popis %s %s, ďalší výskyt v %s" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "premenná prostredia; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "Nesprávny popis voľby %r, má vyzerať ako „opt”, „-opt argumenty”, „--opt argumenty”, „/opt argumenty” alebo „+opt argumenty”" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "%s voľba príkazového riadka" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "voľba príkazového riadka" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "položke glosára musí predchádzať prázdny riadok" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "položky glosára nesmú byť oddelené prázdnymi riadkami" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "glosár vyzerá byť zle naformátovaný, skontrolujte odsadenie" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "termín glosára" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "jazykový token" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "menovka odkazu" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "premenná prostredia" #: sphinx/domains/std.py:568 msgid "program option" msgstr "voľba programu" #: sphinx/domains/std.py:569 msgid "document" msgstr "dokument" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Index modulov" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Stránka hľadania" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "duplicitná menovka %s, ďalší výskyt v %s" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "duplicitný %s popis %s, ďalší výskyt v %s" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "numfig je vypnutý, :numref: je ignorované." #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "Zlyhalo vytvorenie krížového odkazu. Nie je priradené žiadne číslo: %s" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "odkaz nemá popisok: %s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "neplatný numfig_format: %s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "neplatný numfig_format: %s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "nedefinovaná menovka: %s" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "Zlyhalo vytvorenie krížového odkazu. nenájdení názov alebo titulok: %s" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "nová konfigurácia" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "zmenená konfigurácia" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "zmenené rozšírenie" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "prostredie zostavenia nie je aktuálne" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "zdrojový adresár zmenený" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "Toto prostredie nie je kompatibilné zo zvoleným zostavovačom, prosím, zvoľte iný adresár doctree." #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "Zlyhalo skenovanie dokumentov v %s: %r" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "Doména %r nie je zaregistrovaná" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "nájdený na seba odkazujúci strom obsahu. Ignorované." #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "dokument nie je zahrnutý v žiadnom strome obsahu" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "viď %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "viď aj %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "neznámy typ položky indexu %r" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Symboly" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "zistený cirkulárny odkaz stromu obsahu, ignorované: %s <- %s" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "strom obsahu obsahuje odkaz na dokument %r, ktorý nemá názov, odkaz nebude generovaný" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "strom obsahu obsahuje odkaz na vylúčený dokument %r" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "strom obsahu obsahuje odkaz na neexistujúci dokument %r" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "súbor obrázku nemožno čítať: %s" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr " Súbor obrázku %s nemožno čítať: %s" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "súbor na stiahnutie nemožno čítať: %s" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "%s už je priradené číslo sekcie (vnorený číslovaný strom obsahu?)" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "cesta k dokumentovanému modulu" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "adresár umiestnenia výstupu" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "maximálna hĺbka submodulov, ktorá má byť zobrazená v obsahu (predvolene: 4)" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "prepísať existujúce súbory" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "nasledovať symbolické odkazy. Vhodné v kombinácii s collective.recipe.omelette." #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "spustí skript bez vytvorenia súborov" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "umiestniť dokumentáciu každého modulu vo vlastnej stránke" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "zahrnúť ”_súkromné” moduly" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "meno súboru obsahu (predvolene: modules)" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "nevytvárať súbor obsahu" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "vložiť dokumentáciu modulu pred dokumentáciou submodulu" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "interpretovať cesty modulov v zmysle implicitnej špecifikácie menných priestorov PEP-0420" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "prípona súboru (predvolene: rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "generovať úplný projekt pomocou sphinx-quickstart" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "pripojiť module_path do sys.path, použité pri --full" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "meno projektu (predvolene: meno koreňového modulu)" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "autor(i) projektu, použité pri --full" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "verzia projektu, použité pri --full" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "vydanie projektu, použité pri --full, predvolene --doc-version" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "voľby rozšírenia" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s nie je adresár." #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "neplatný regulárny výraz %r v %s" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "neplatný regulárny výraz %r v coverage_c_regexes" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "nedokumentované API C: %s [%s] v súbore %s" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "modul %s nemožno importovať: %s" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "nedokumentovaná funkcia Python: %s :: %s" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "nedokumentovaná trieda Python: %s :: %s" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "nedokumentovaná metóda Python: %s :: %s :: %s" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "chýbajúce „+” alebo „-” vo voľbe „%s”." #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "'%s' nie je platná voľba." #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "„%s” nie je platná voľba pyversion" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "neplatný typ TestCode" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "Direktíva graphviz nemôže mať naraz argumenty content a filename" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "Externý súbor Graphviz %r nebol nájdený alebo zlyhalo jeho čítanie" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "Ignorovaná direktíva „graphviz” bez obsahu." #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot nevytvoril výstupný súbor:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "príkaz dot %r nemožno spustiť (nutný kvôli výstupu graphviz), skontrolujte nastavenie graphviz_dot" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot skončil chybou:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "graphviz_output_format musí byť „png” alebo „svg”, ale je %r" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "kód dot %r: %s" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[graf: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[graf]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "príkaz convert %r nemožno spustiť, skontrolujte nastavenia image_converter: 1%s" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "convert skončil chybou:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "príkaz convert %r nemožno spustiť, skontrolujte nastavenie image_converter" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "Nemožno spustiť príkaz LaTeX %r (potrebný na zobrazenie math), skontrolujte nastavenia imgmath_latex" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "zobrazený latex %r: %s" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "vnorený latex %r: %s" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Trvalý odkaz na tento vzorec" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "inventár intersphinx bol presunutý: %s -> %s" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "načítanie inventára intersphinx z %s..." #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "nastali problémy s niektorými inventármi, ale boli nájdené funkčné alternatívy:" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "nemožno získať žiadne inventáre kvôli týmto problémom:" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(v %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(v %s)" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "identifikátor intersphinx %rnie je raťzec, ignorované" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "Zlyhalo čítanie intersphinx_mapping[%s], ignorované: %r" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[zdroj]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "ToDo" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "Nájdená položka TODO: %s" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<pôvodná položka>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(<<original entry>> je umiestnená v %s, riadok %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "pôvodná položka" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "zvýrazňovanie syntaxe kódu modulu... " #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[dokumenty]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Kód modulu" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Zdrojový kód %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Prehľad: kód modulu" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Všetky moduly, pre ktoré je dostupný kód</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "chyba formátovania argumentov %s: %s" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "chýba atribút %s objektu %s" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "„::” v automodule nedáva zmysel" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "__all__ má byť zoznam reťazcov, nie %r (v module %s) -- ignorované __all__" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "chýbajúci atribút spomenutý vo voľbe :members: : modul %s, atribút %s" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "Základ: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "alias pre %s" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "alias pre TypeVar(%s)" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "Neplatné __slots__ nájdené v %s. Ignorované." #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "Zlyhalo spracovanie predvolenej hodnoty argumentu %r: %s" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "Autosummary s popiskom vyžaduje voľbu :toctree: , ignorované." #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "zlyhalo spracovanie mena %s" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "zlyhal import objektu %s" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: súbor nenájdený: %s" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "autosummary interne generuje súbory .rst. Ale Váš source_suffix neobsahuje .rst. Preskočené." #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "adresár umiestnenia výstupu" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "predvolená prípona súboru (predvolene: %(default)s)" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "vlastný adresár šablón (predvolene: %(default)s)" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "dokumentovať importovaných členov (predvolene: %(default)s)" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "Argumenty kľúčových slov" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "Príklad" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Príklady" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "Poznámky" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "Ostatné parametre" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "Varovania" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "neplatná hodnota množiny (chýba koncová zátvorka): %s" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "neplatná hodnota množiny (chýba začiatočná zátvorka): %s" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "neplatná textová konštanta (chýba koncová úvodzovka): %s" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "neplatná textová konštanta (chýba začiatočná úvodzovka): %s" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Výstraha" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Upozornenie" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Nebezpečné" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Chyba" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Rada" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Dôležité" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Poznámka" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Viď aj" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Tip" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Varovanie" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "pokračovanie z predošlej strany" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "pokračuje na ďalšej strane" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "Čísla" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "strana" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "Obsah" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Hľadať" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "OK" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Zobraziť zdroj" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Prehľad" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Vitajte! Toto je" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "dokumentácia" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "posledná aktualizácia" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Indexy a tabuľky" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Celkový obsah" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "zoznam všetkých sekcií a podsekcií" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "hľadať v tejto dokumentácii" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Celkový index modulov" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "rýchly prístup ku všetkým modulom" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "všetky funkcie, triedy, termíny" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Index – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Celý index na jednej strane" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Indexové stránky po písmenách" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "môže byť rozsiahle" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigácia" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Hľadať v %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "O dokumentácii" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Autorské právo" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Copyright %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Naposledy aktualizované %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "Vytvorené pomocou <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s." #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Hľadať v %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Predošlá téma" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "predošlá kapitola" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Ďalšia téma" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "ďalšia kapitola" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Prosím, na zapnutie funkcie hľadania,aktivujte\nJavaScript ." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "Hľadanie viacerých slov vracia len zhody, ktoré obsahujú\n všetky slová." #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "hľadať" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Výsledky hľadania" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Vášmu hľadaniu nezodpovedá žiadny dokument. Prosím, skontrolujte, že všetky zadané slová sú správne napísané a že ste zvolili vhodné kategórie." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Rýchle hľadanie" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Táto stránka" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Zmeny vo verzii %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automaticky generovaný zoznam zmien vo verzii %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Zmeny knižnice" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Zmeny API C" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Ostatné zmeny" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Trvalý odkaz na tento nadpis" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Trvalý odkaz na túto definíciu" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Skryť výsledky hľadania" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Hľadanie" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Príprava hľadania..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Hľadanie dokončené, nájdené %s strana(y), ktoré vyhovujú hľadanému výrazu." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", v " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Rozbaliť bočný panel" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Zbaliť bočný panel" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Obsah" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "Poznámka pod čiarou [%s] nie je odkazovaná." #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "Poznámka pod čiarou [#] nie je odkazovaná." #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "viac ako jeden cieľ krížového odkazu %r: môže byť %s" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "%r cieľ odkazu nenájdený: %s" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "Nemožno získať vzdialený obrázok: %s [%d]" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "Nemožno získať vzdialený obrázok: %s [%s]" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "Neznámy formát obrázku: %s..." #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "nedekódovateľné zdrojové znaky, nahradené „?”: %r" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "preskočené" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "zlyhalo" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "neznáma direktíva alebo meno role: %s:%s" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "chyba čítania: %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "chyba zápisu: %s: %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "Neplatný formát dátumu. Použije jednoduché úvodzovky, ak ho chcete priamo vo výstupe: %s" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "strom obsahu obsahuje neexistujúci súbor %r" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "predvolená rola %s nenájdená" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "nie je definovaný numfig_format pre %s" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "Žiadne ID nie je priradené uzlu %s" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "Trvalý odkaz na tento termín" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Trvalý odkaz na túto tabuľku" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Trvalý odkaz na tento kód" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Trvalý odkaz na tento obrázok" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Trvalý odkaz na tento strom obsahu" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "Nemožno získať veľkosť obrázku. voľba :scale: je ignorovaná." #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "príliš veľké :maxdepth:, ignorované." #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "názov dokumentu nie je jeden uzol Text" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Poznámky pod čiarou" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "sú zadané obe, tabularcolumns aj voľba :widths:. :widths: je ignorované." #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[obrázok: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[obrázok]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "titulok nie je vo vnútri figure." #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "neimplementovaný typ uzla: %r" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "neznámy typ uzla: %r" ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3309386 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sl/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015521� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5048304 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sl/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017306� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sl/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000006443�00000000000�021164� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "sl", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "O dokumentih", "Automatically generated list of changes in version %(version)s": "Avtomatsko generiran seznam sprememb v verziji %(version)s", "C API changes": "C API spremembe", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "Popoln Seznam Vsebine", "Contents": "", "Copyright": "Vse pravice pridr\u017eane", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "Poln indeks na eni strani", "General Index": "Splo\u0161ni abecedni seznam", "Global Module Index": "Splo\u0161en seznam modulov", "Go": "Potrdi", "Hide Search Matches": "Skrij resultate iskanja", "Index": "Abecedni seznam", "Index – %(key)s": "Seznam – %(key)s", "Index pages by letter": "Indeksiraj strani po \u010drki", "Indices and tables:": "Kazalo in seznami:", "Last updated on %(last_updated)s.": "Zadnji\u010d posodobljeno %(last_updated)s.", "Library changes": "Spremembe knji\u017enice", "Navigation": "Navigacija", "Next topic": "Naslednja tema", "Other changes": "Ostale spremembe", "Overview": "Pregled", "Permalink to this definition": "Povezava na to definicijo", "Permalink to this headline": "Povezava na naslov", "Please activate JavaScript to enable the search\n functionality.": "Za pravilno delovanje Iskanja morete vklopiti\n JavaScript.", "Preparing search...": "", "Previous topic": "Prej\u0161nja tema", "Quick search": "Hitro iskanje", "Search": "I\u0161\u010di", "Search Page": "Iskalnik", "Search Results": "Rezultati Iskanja", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "I\u0161\u010di med %(docstitle)s", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Prika\u017ei izvorno kodo", "Table of Contents": "", "This Page": "Trenutna stran", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "vse funkcije, razredi, izrazi", "can be huge": "lahko je veliko", "last updated": "", "lists all sections and subsections": "prikazi vse sekcije in podsekcije", "next chapter": "naslednje poglavje", "previous chapter": "prej\u0161nje poglavje", "quick access to all modules": "hiter dostop do vseh modulov", "search": "i\u0161\u010di", "search this documentation": "i\u0161\u010di po dokumentaciji", "the documentation for": "" }, "plural_expr": "(n%100==1 ? 0 : n%100==2 ? 1 : n%100==3 || n%100==4 ? 2 : 3)" });�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sl/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000012560�00000000000�021160� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������h������\���������������� ���������� ���������������������������� �� ��������'�����8�����P�� ���i�����v������� ����������>���������� �������� ����������'�� ���B�����L�� ���S�����^�����z�� ���������� ������������������������� ������������������ ����� ��!���/ �����Q �� ���a �����n �� ���~ �� ��� ����� �� ��� ����� �� ��� ����� �� ��� ����� ����� ��B��� �����U ��$���d �� ��� ����� ����� �� ��� ����� ����� ����� �� ��� ����� ����� ����� ����� �� ���& �� ���2 �����< �����@ �����E �����M �����U �� ���s �����} �� ��� ����� ����� ����� ����� �� ��� ����� ����� ����� ��"��� �����0 �����7 �����> �����F �� ���K �����X �����_ �����h �����q ����� ����� ����� �� ��� �� ��� ����� ���� �� ���������� �����������������������4�����E�� ���V�����a�����r������� ���������� ���������������:����� ��������+�����;�����D�����]�����s������� �������������������������������������� ����������,�����3�����<�����L�����c�����~��'�������������������� ����� ������������������$�����+�����<�� ���D�����N�����h��=���{�������$����� ������������� ��������������������&�����;�����D�����V�����o�� ������������������������� ����������������������������������� ��������>�����U�����p�����w������������!����������������������������������������������������������5�����<�����T�����[�����l��� (deprecated)� (in �%b %d, %Y�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (in module %s)�%s (module)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�About these documents�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Caution�Changed in version %s�Complete Table of Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Module Index�Module author: �Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Parameters�Permalink to this definition�Permalink to this headline�Please activate JavaScript to enable the search functionality.�Previous topic�Python Enhancement Proposals; PEP %s�Quick search�Raises�Release�Return type�Returns�Search�Search %(docstitle)s�Search Page�Search Results�Search within %(docstitle)s�Section author: �See also�Show Source�This Page�Tip�Todo�Warning�[image]�all functions, classes, terms�attribute�built-in function�can be huge�class�continued from previous page�environment variable�environment variable; %s�exception�function�index�keyword�lists all sections and subsections�member�module�modules�next�next chapter�object�operator�previous�previous chapter�quick access to all modules�search�search this documentation�statement�static method�type�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: sl Language-Team: Slovenian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sl/) Plural-Forms: nplurals=4; plural=(n%100==1 ? 0 : n%100==2 ? 1 : n%100==3 || n%100==4 ? 2 : 3) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (zastarelo)� (v �%d %b, %Y�%s (%s atribut)�%s (vgrajen razred)�%s (vgrajene spremenljivke)�%s (razred v %s)�%s (v modulu %s)�%s (modul)�%s() (%s metoda)�%s() (%s statična metoda)�%s() (vgrajene funkcije)�%s() (razred)�%s() (v modulu %s)�O dokumentih�Pozor�Avtor: �Avtomatsko generiran seznam sprememb v verziji %(version)s�Vgrajeni deli�C API spremembe�Previdno�Spremenjeno v verziji %s�Popoln Seznam Vsebine�Vse pravice pridržane�Nevarno�Zastarelo�Zastarelo od verzije %s�Napaka�Opombe�Poln indeks na eni strani�Splošni abecedni seznam�Splošen seznam modulov�Potrdi�Skrij resultate iskanja�Nasvet�Pomembno�Abecedni seznam�Seznam – %(key)s�Indeksiraj strani po črki�Kazalo in seznami:�Zadnjič posodobljeno %(last_updated)s.�Spremembe knjižnice�Seznam modulov�Avtor modula: �Nivo modula�Navigacija�Novo v verziji %s�Naslednja tema�Opomba�Ostale spremembe�Pregled�Parametri�Povezava na to definicijo�Povezava na naslov�Za pravilno delovanje Iskanja morete vklopiti JavaScript.�Prejšnja tema�Python Enhancement Proposals; PEP %s�Hitro iskanje�Sproži izjemo�Izdaja�Vrne tip�Vrne�Išči�Išči %(docstitle)s�Iskalnik�Rezultati Iskanja�Išči med %(docstitle)s�Avtor sekcije: �Poglej Tudi�Prikaži izvorno kodo�Trenutna stran�Nasvet�Todo�Opozorilo�[slika]�vse funkcije, razredi, izrazi�atribut�vgrajene funkcije�lahko je veliko�razred�nadaljevanje iz prejšnje strani�okoljska spremenljivka�okoljska spremenljivka; %s�izjema�funkcija�abecedni seznam�ključna beseda�prikazi vse sekcije in podsekcije�član�modul�Moduli�naprej�naslednje poglavje�objekt�operator�nazaj�prejšnje poglavje�hiter dostop do vseh modulov�išči�išči po dokumentaciji�izjava�statična metoda�tip�������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sl/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000244576�00000000000�021201� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Slovenian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: sl\n" "Plural-Forms: nplurals=4; plural=(n%100==1 ? 0 : n%100==2 ? 1 : n%100==3 || n%100==4 ? 2 : 3);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Vgrajeni deli" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Nivo modula" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (v " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d %b, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Splošni abecedni seznam" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "abecedni seznam" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "naprej" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "nazaj" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Abecedni seznam" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Izdaja" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Avtor sekcije: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Avtor modula: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Avtor: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametri" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Vrne" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Vrne tip" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "član" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funkcija" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "tip" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Novo v verziji %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Spremenjeno v verziji %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Zastarelo od verzije %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "razred" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (vgrajene funkcije)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s metoda)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (razred)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s atribut)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modul)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atribut" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modul" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "ključna beseda" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operator" #: sphinx/domains/python.py:61 msgid "object" msgstr "objekt" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "izjema" #: sphinx/domains/python.py:63 msgid "statement" msgstr "izjava" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "vgrajene funkcije" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Sproži izjemo" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (v modulu %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (v modulu %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (vgrajene spremenljivke)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (vgrajen razred)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (razred v %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s statična metoda)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "Moduli" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Zastarelo" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "statična metoda" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (zastarelo)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "okoljska spremenljivka; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "okoljska spremenljivka" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Seznam modulov" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Iskalnik" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Todo" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Pozor" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Previdno" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Nevarno" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Napaka" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Nasvet" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Pomembno" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Opomba" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Poglej Tudi" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Nasvet" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Opozorilo" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "nadaljevanje iz prejšnje strani" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Išči" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Potrdi" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Prikaži izvorno kodo" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Pregled" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Kazalo in seznami:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Popoln Seznam Vsebine" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "prikazi vse sekcije in podsekcije" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "išči po dokumentaciji" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Splošen seznam modulov" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "hiter dostop do vseh modulov" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "vse funkcije, razredi, izrazi" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Seznam – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Poln indeks na eni strani" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Indeksiraj strani po črki" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "lahko je veliko" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigacija" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Išči med %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "O dokumentih" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Vse pravice pridržane" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Zadnjič posodobljeno %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Išči %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Prejšnja tema" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "prejšnje poglavje" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Naslednja tema" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "naslednje poglavje" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Za pravilno delovanje Iskanja morete vklopiti\n JavaScript." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "išči" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Rezultati Iskanja" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Hitro iskanje" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Trenutna stran" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Avtomatsko generiran seznam sprememb v verziji %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Spremembe knjižnice" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API spremembe" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Ostale spremembe" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Povezava na naslov" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Povezava na to definicijo" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Skrij resultate iskanja" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Opombe" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[slika]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ����������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sphinx.pot���������������������������������������������������������������0000644�0000766�0000024�00000241373�00000000000�017152� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # FIRST AUTHOR <EMAIL@ADDRESS>, 2021. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Sphinx 4.3.0\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 " "and above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with" " this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called " "sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but " "`{current}` is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it" " should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since " "Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "" "conf value \"epub_language\" (or \"language\") should not be empty for " "EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "" "conf value \"epub_title\" (or \"html_title\") should not be empty for " "EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "" "conf value \"epub_copyright\" (or \"copyright\")should not be empty for " "EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the" " index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all" " config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue " "to the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and " "places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template " "files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults " "to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for " "selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\"" " will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you " "separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; " "\"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and " "other static\n" "files. You can enter another prefix (such as \".\") to replace the " "underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-" "language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root " "path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has" " been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that " "you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other " "documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about " "your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "" "\"quiet\" is specified, but any of \"project\" or \"author\" is not " "specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a " "new root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try " "giving an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path" " as a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: " "for one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\"," " \"--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose" " another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no " "link will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and " "create\n" "one reST file with automodule directives per package in the " "<OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be" "\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the " "imgmath_%s setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had " "working alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception" " was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of " "\"alphabetic\". Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does " "not contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following " "exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It " "generates\n" "the reStructuredText files from the autosummary directives contained in " "the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words " "are spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated:" " {1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a" " bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to " "output it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3311188 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sq/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015526� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5057237 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sq/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017313� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sq/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000010653�00000000000�021167� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "sq", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">T\u00eb drejta kopjimi</a> %(copyright)s.", "© Copyright %(copyright)s.": "© T\u00eb drejta kopjimi %(copyright)s.", ", in ": ", n\u00eb ", "About these documents": "Mbi k\u00ebto dokumente", "Automatically generated list of changes in version %(version)s": "List\u00eb ndryshime n\u00eb versionin %(version)s e prodhuar automatikisht", "C API changes": "Ndryshime API C", "Changes in Version %(version)s — %(docstitle)s": "Ndryshe n\u00eb Versionin %(version)s — %(docstitle)s", "Collapse sidebar": "Tkurre an\u00ebshtyll\u00ebn", "Complete Table of Contents": "Tryez\u00eb e Plot\u00eb e L\u00ebnd\u00ebs", "Contents": "L\u00ebnd\u00eb", "Copyright": "T\u00eb drejta kopjimi", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "Krijuar duke p\u00ebrdorur <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.", "Expand sidebar": "Zgjeroje an\u00ebshtyll\u00ebn", "Full index on one page": "Tregues i plot\u00eb n\u00eb nj\u00eb faqe", "General Index": "Tregues i P\u00ebrgjithsh\u00ebm", "Global Module Index": "Tregues Global Modulesh", "Go": "Shko", "Hide Search Matches": "Fshih P\u00ebrputhje K\u00ebrkimi", "Index": "Tregues", "Index – %(key)s": "Tregues – %(key)s", "Index pages by letter": "Faqe treguesi sipas shkronjash", "Indices and tables:": "Tregues dhe tabela:", "Last updated on %(last_updated)s.": "P\u00ebrdit\u00ebsuar s\u00eb fundi m\u00eb %(last_updated)s.", "Library changes": "Ndryshime librarie", "Navigation": "L\u00ebvizje", "Next topic": "Subjekti pasues", "Other changes": "Ndryshime t\u00eb tjera", "Overview": "P\u00ebrmbledhje", "Permalink to this definition": "Permalidhje p\u00ebr te ky p\u00ebrkufizim", "Permalink to this headline": "Permalidhje te ky titull", "Please activate JavaScript to enable the search\n functionality.": "Q\u00eb t\u00eb aktivizohet funksioni i k\u00ebrkimit, ju lutemi, aktivizoni\n JavaScript-in.", "Preparing search...": "Po p\u00ebrgatitet k\u00ebrkim...", "Previous topic": "Subjekti i m\u00ebparsh\u00ebm", "Quick search": "K\u00ebrkim i shpejt\u00eb", "Search": "K\u0113rko", "Search Page": "Faqe K\u00ebrkimesh", "Search Results": "P\u00ebrfundime K\u00ebrkimi", "Search finished, found %s page(s) matching the search query.": "K\u00ebrkimi p\u00ebrfundoi, u gjet\u00ebn %s page(s) me p\u00ebrputhje me shprehjen e k\u00ebrkuar.", "Search within %(docstitle)s": "K\u00ebrkoni brenda %(docstitle)s", "Searching": "K\u00ebrkim", "Searching for multiple words only shows matches that contain\n all words.": "K\u00ebrkimi p\u00ebr disa fjal\u00eb nj\u00ebher\u00ebsh shfaq vet\u00ebm p\u00ebrputhje q\u00eb\n p\u00ebrmbajn\u00eb krejt fjal\u00ebt.", "Show Source": "Shfaq Burimin", "Table of Contents": "Tryeza e L\u00ebnd\u00ebs", "This Page": "Kjo Faqe", "Welcome! This is": "Mir\u00eb se vini! Ky \u00ebsht\u00eb", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "K\u00ebrkimi juaj s\u2019gjeti p\u00ebrputhje me ndonj\u00eb dokument. Ju lutemi, sigurohuni se jan\u00eb shkruar sakt\u00eb krejt fjal\u00ebt dhe se keni p\u00ebrzgjedhur aq kategori sa duhen.", "all functions, classes, terms": "krejt funksionet, klasat, termat", "can be huge": "mund t\u00eb jet\u00eb i st\u00ebrmadh", "last updated": "p\u00ebrdit\u00ebsuar s\u00eb fundi m\u00eb", "lists all sections and subsections": "paraqet krejt ndarjet dhe n\u00ebnndarjet", "next chapter": "kapitulli pasues", "previous chapter": "kapitulli i m\u00ebparsh\u00ebm", "quick access to all modules": "hyrje e shpejt\u00eb te krejt modulet", "search": "k\u00ebrko", "search this documentation": "k\u00ebrkoni te ky dokumentim", "the documentation for": "dokumentimi p\u00ebr" }, "plural_expr": "(n != 1)" });�������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sq/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000232072�00000000000�021167� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������t��������������,����,����T.�����0��E��1��r���3��l���3�� ���3�����4��*��� 4�����74��=���4��7���5��H���<5��?���5��"���5�� ���5�����5��%���5�����!6�����>6��!���^6�����6�����6�����6�����6�� ���6�� ���6�����6�����6�����6�����7�� ���7�����?7�� ���Q7�� ���]7�� ���g7��S���7�����7�����7����� 8�����!8�����28�����J8�� ���c8�����p8��$���8��6���8�����8������9��$���9�����A9��3���9�� ���/:�����;:�����C:��1���I:��1���{:��G���:�����:����� ;��0��� ;�����Q;��H���m;�����;��b���N<�����<��6���<�����<�� ���=�� ���5=�� ���?=�����I=�����X=��>���a=�� ���=��(���=��(���=�����=��?���>�����[>�� ���d>��!���r>��%���>�����>�����>��4���>�� ��� ?�� ���.?�����<?�����M?�����h?�����?�� ���?��%���?��%���?�����?��7���@�����=@��"���T@��R���w@�����@�����@�� ���@�����@����� A��N���&A��R���uA��`���A�����)B��&���9B�����`B��D���fB��H���B��K���B�����@C�����YC�����aC��5���jC�����C�����C�����C��8���C��=���D��1���LD��D���~D��B���D��0���E��-���7E��+���eE��3���E��'���E��"���E��3���F��"���DF��:���gF��#���F�����F��!���F��:���F�����+G�� ���KG�� ���lG��:���vG�����G�����RH�� ���iH�����wH�����H��C���H��*���H�����H�����I��3��I��.���JJ�� ���yJ��.���J�����J�����J�����J��D���J�����)K�����=K�� ���(L��'���5L�����]L��[���qL�����L�����L����� M��Y���M��!���uM�����M��C���M�����M��n��� N��E���zN�� ���N�����N�� ���N�� ���N��-���N��(���$O�� ���MO�����XO�� ���jO��(���uO�����O�����O�����O��Z���O�����(P�����.P��,���6P����cP�����zQ�����Q�� ���Q��(���Q�����Q�����Q�� ���Q�����R�����R�����5R�����PR�����kR�����R�����R�����R��&���R��B���R��i���6S��2���S��I���S��4���T�����RT�����rT�����T�����T��y���T�����<U�����PU�����_U�����uU�� ���U�����U�����U�����U��$���U�����U�� ���U����� V�� ���V�����(V�� ���0V�����<V�����DV�����dV�����wV�����~V�� ���V�����V��<���V�����V�� ���W��K���W�� ���]W�����hW�����yW�����W��+���W�� ���W��k���W��>���=X�����|X��#���X��-��X�����Y�����Y�����Y�����Z�����Z�����+Z��Y���?Z��Z���Z��*���Z��3���[��/���S[��(���[��.���[��P���[��p���,\�����\��!���\��"���\��$���]�� ���']��e���H]��Z���]��N��� ^��T���X^��K���^��%���^�����_�����?_��[���_��#���#`��'���G`��#���o`��I���`��'���`��!���a��=���'a��7���ea�� ���a�����a��d���Bb��W���b��v���b�����vc�����zc�� ���c��3���c�����c�����c��"���d��7���*d��<���bd��Y���d�� ���d�����e����� e��,���e�����>e�����Oe�����ee��Y���/f�����f��%���g��,���:g�����gg�����g�� ���g�����g�� ���g�����g�����g��N���g����� h��?���h��-���h��2���i�� ���7i�����Ci�����Xi�����vi�����i��9���i�����i�� ���i�� ���i��X���j��d���_j��,���j��2���j��b���$k��5���k��\���k�� ���l��M���;l��(���l��G���l�����l��7���m�����Gm��8���]m�����m�� ���m��%���m��`���m�����>n�����\n�����{n�����n�����n�� ���n��&���n��$���n�����o�����o�����=o�����Xo�����mo��A���o��Z���o��-���*p�����Xp�����wp�����p��!���p��8���p�����q�� ��� q�����q�����+q��7���3q��6���kq��;���q��I���q��;���(r��:���dr��H���r��9���r��G���"s��2���js��2���s�����s��4���s�����t�����+t�����Ht��C���_t��G���t��2���t�����u�����8u�����Uu�����su�����u�����u�����u�����u�����u��(���u��=���(v�����fv�����wv��0���v�����v�����v��/���v�����w��*���"w��&���Mw�� ���tw��9���~w�����w�� ���w�����w����� x�����$x��*���;x�����fx�����|x��0���x��&���x�����x�����x��(���y�����8y�����Uy��%���ry��e���y�����y��4���z�����z�����z��Y���z��;���D{��.���{�����{�����{��.���{��4���|��+���M|��4���y|��(���|��4���|��W��� }�����d}�����}�����}��X���}��J��� ~��%���W~�����}~�����~��+���~��+���~������������ ���=��8���G��M�����u��������D�����V�����i�����p�������A����� ����������6�����I���F��A��������ҁ��0����������G���5��N���}�����̂�����Ղ�������.��������'��4���:�� ���o��,���}��3�����=���ރ�������r���9��'�����0���Ԅ��(�����1���.��/���`��,�����!��������߅������������=���5��+���s��0�����V���І��V���'��M���~��R���̇����������%��N���9��0�����)��������������������/���4�����d�����~�������&�����!���ۉ��+�����)���)��-���S��-�����&��������֊��E���ފ�� ���$��*���1��7���\��"�����(��������������������"���8�����[�����a��4���y��4����������&�����;��������[�����b��"���i��!�����H����������#��������"��D���*��5���o��D����� ���������� �����1�����E���9��B�����G�����%��� �����0��#���J��#���n��,����������-���ې��(��� ��D���2�� ���w��#�����(�����#���ϑ�����������������(��������;�����T��8���Y�� �����P�����"��������'�����B��O���[���������������ȓ��%���ٓ�� �������� ��,����� ���I��(���V��E����� ���Ŕ��*���Ҕ�������1�����7���8�����p�� �����������������������ԕ������������&��� �����4�����L��4���Q�������%����������c���Ȗ�����,�����F�� ���M��'���Y��:�������������ė�������&�����*�����&���F��W���m��>���Ř��7�����K���<�� ����� ����� �����,�����*���י��0��������3��%���Q�����w����������"��1�����1����������\���4�������'�����%���՜��+�����^���'��2�����5������������������(��5���-�����c��&���w��#�����&���ž��*�������������0��+���6��-���b��%����������!���ҟ��!����������!���,�����N�����e��#���n��*�������������Ơ�����٠��P��������A��)���`��9�����;���ġ��)���������*�����2��&���E�����l��������������������Т��������������� �����3�����K����c����*����֦����ʩ��q��٪�����K�����ڬ�����e�������'����������R���L��J�����W�����R���B��"����� ����� ���¯��+���̯������������$���1�����V�����\�����o�� ����� ����� ������������������հ�������%���������� ���/�����:��-���C��y���q�� �������� �����%�����=�����O�����i�� ����������'�����?���в��(�����%���9��.���_�� ����/����� ���ɴ�����մ�����ݴ��C�����C���(��]���l�����ʵ�������:��������3��R���N�������x���p�������:��������8��5���R�� ����� ���������������C����������+�����*���3��"���^��F����� ���ȹ�����ֹ��#�����M��� �����X�����_��7���z��+����� ���޺�������������(��������E�����M��(���`��)����������>���һ�������-���.��[���\����������м�����׼��+�����)�����X���E��\���������� �����)����������G�����U�����a���\��(���������������A��������:�����S�����j��D���|��U�����B�����R���Z��N�����:�����<���7��8���t��H�����2�����9���)��A���c��,�����L�����:����� ���Z��-���d��;�����/�����0��������/��A���?����������C�����b�����{�������V�����:��������*�����D��M��M��5����������?��������!�����)�����A��D���`����������� �����4���������������#�����#����������~��� ��-����������U�����!�����v���A��N��������������� ���'�����2��1���B��7���t�����������������9�����'����� ���A�����N��q���V������������8�����I�������Z�����s�������3����� ���������� �����������"��������9�����T�����m�����������������/�����S��� �����^��M�����k���6��]�����1���������2�����P�����n����������0�����J�����a�����~������� ���������������$������������������/�� ���C�����M�� ���b�����n�����u���������������������������P��������C�����a��`���i�� ���������� �����!�����.����� ���B�����P��H����������,���5��o��b������������ ����� �������������*��Z���=��_�����.�����=���'��<���e��,�����8�����\�����s���e��"�����"�����&�����(���F��$���o��t�����n��� ��W���x��d�����O���5��$�����#����������^���q��)�����-�����+���(��H���T��+�����&�����C�����9���4�����n�����w��s���I��T�����y���������������$�����=�������� �����$��"���D��@���g��K�����e����� ���Z�� ���d�� ���o��=���{�����������������q��������:��5�����6�����%���J�� ���p�� ���|������� ����� ����������^����������M�����8�����=���7�� ���u������� ���������������E��������+�����G�����O��Y���^��u�����*���.��2���Y��m�����G�����j���B��0�����b�����-���A��g���o�������B��������5��D���K������� �����.�����s�����:���[��1�������������������������<�����/���\��#�����'�����$����������+�����]���D�������A���%��'���g�������!�����!�����B��������4�� ���;�����I�����g��=���o��K�����P�����`���J��P�����O�����^���L��N�����]�����B���X��G����������@�����"���8�����[�����{��U�����Y�����:���E�������"�����#����������(��������,�����G�����^�����{��6�����C�������������"��5���1�� ���g�����r��B�����$�����7�����;���1�� ���m��?���x��+�����+�������������#�����7��,���J�� ���w�������@�����7���������&���+�4���R�$����#����%����`�������W�B�������Y����_�s���n�<����0����%���P�4���v�4����=����0����8���O�3����=����k����!���f���������Q����P��� �(���]���������.����0��������%���.� ���T�;���`�T����������� ���� � ��� �%��� �!��� �<��� � ���A �!���N �E���p �V��� �S��� �(���a �>��� ���� �Z��� �Q���= ���� ���� ���� �3��� ���� �G��� ����Y �B���h �E��� �L��� ����>����Z�%����C����&���X�B����B����@����3���F�%���z�"��������A����B���!�F���d�j����c����U���z�\�������-����5�U���K�;����0��������'���*�&���R�B���y�����$����)����9���+�)���e�7����3����;����9���7�1���q� ����R��������F����6���d�%����-���� �����������+�,���J����w�"���}�;����9��������C���,�E���p���������%����"����K�������[� ���a�����T����?����M�������l����{�����B����V����S���.�V����0���� ��� �)���+�$���U�4���z�����8����4����U���<�����2����=����/�������C����J����S�/���c���������B��������d��� �(���} �%��� �$��� �V��� ����H!� ���a!����n!�.���!����!����!�:���!����"�4���#"�l���X"����"�8���"����#�4���#�D���M#�!���#����#����#����#����#����$����$� ���0$�,���Q$����~$����$�:���$�"���$�&���$���� %�q���'%����%� ���%����%�9���%�K���&� ���R&����`&����}&�5���&�3���&�.���'�p���1'�E���'�?���'�Q���((����z(����(����(�;���(�2���(�>���)� ���P)�%���q)����)����)����j*�3���*+�4���^+����+�Z���+����+�$���,�"���=,�G���`,�d���,�>��� -�>���L-�'���-�#���-����-�?���-����.�,���9.�'���f.�)���.�.���.����.����/�1���/�?���A/�,���/�"���/�*���/�-���/����*0�,���E0����r0� ���0�(���0�=���0� ���1���� 1���� 1�R���:1����1�,���1�@���1�]���2�5���t2� ���2����2�.���2�����3����3�#���53����Y3�#���o3�$���3�!���3����3�$���3����4�� Generate ReStructuredText using autosummary directives. sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates the reStructuredText files from the autosummary directives contained in the given input files. The format of the autosummary directive is documented in the ``sphinx.ext.autosummary`` Python module and can be read using:: pydoc sphinx.ext.autosummary � Generate documentation from source files. sphinx-build generates documentation from the files in SOURCEDIR and places it in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration settings. The 'sphinx-quickstart' tool may be used to generate template files, including 'conf.py' sphinx-build can create documentation in different formats. A format is selected by specifying the builder name on the command line; it defaults to HTML. Builders can also perform other tasks related to documentation processing. By default, everything that is outdated is built. Output only for selected files can be built by specifying individual filenames. � Generate required files for a Sphinx project. sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build. � Look recursively in <MODULE_PATH> for Python modules and packages and create one reST file with automodule directives per package in the <OUTPUT_PATH>. The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be excluded from generation. Note: By default this script will not overwrite already created files.� Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� Run 'make' in that directory to run these through makeinfo (use 'make info' here to do that automatically).� (deprecated)� (in �"::" in automodule name doesn't make sense�":file:" option for csv-table directive now recognizes an absolute path as a relative path from source directory. Please update your document.�"latex_documents" config value references unknown document %s�"man_pages" config value references unknown document %s�"quiet" is specified, but any of "project" or "author" is not specified.�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%r doesn't have "%s" setting�%r doesn't have "theme" setting�%r reference target not found: %s�%s %s�%s %s documentation�%s (%s attribute)�%s (%s property)�%s (C %s)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command %r cannot be run (needed for math display), check the imgmath_%s setting�%s command line option�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�%s:%s reference target not found: %s�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �-A option argument must be in the form name=value�-D option argument must be in the form name=value�4 column based index found. It might be a bug of extensions you use: %r�:%s: (directive option)�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�====================== slowest reading durations =======================�A Makefile and a Windows command file can be generated for you so that you only have to run e.g. `make html' instead of invoking sphinx-build directly.�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�About these documents�An error happened in rendering the page %s. Reason: %r�Anchor '%s' not found�Any IDs not assigned for %s node�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not fetch remote image: %s [%d]�Could not fetch remote image: %s [%s]�Could not import extension %s�Could not obtain image size. :scale: option is ignored.�Create Makefile? (y/n)�Create Windows command file? (y/n)�Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> %(sphinx_version)s.�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Duplicate C declaration, also defined at %s:%s. Declaration is '.. c:%s:: %s'.�Duplicate C++ declaration, also defined at %s:%s. Declaration is '.. cpp:%s:: %s'.�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Encoding error:�Enter the root path for documentation.�Error�Error: an existing conf.py has been found in the selected root path.�Error: specified path is not a directory, or sphinx files already exist.�Error: the master file %s has already been found in the selected root path.�Event %r already present�Example�Examples�Exception occurred while building, starting debugger:�Exception occurred:�Expand sidebar�Extension options�External Graphviz file %r not found or reading it failed�Failed to compile regex in linkcheck_allowed_redirects: %r %s�Failed to copy a file in html_static_file: %s: %r�Failed to create a cross reference. A title or caption not found: %s�Failed to create a cross reference. Any number is not assigned: %s�Failed to get a constructor signature for %s: %s�Failed to get a function signature for %s: %s�Failed to get a method signature for %s: %s�Failed to parse a default argument value for %r: %s�Failed to parse type_comment for %r: %s�Failed to read build info file: %r�Failed to read intersphinx_mapping[%s], ignored: %r�Failed to scan documents in %s: %r�Failed to update signature for %r: parameter not found: %s�Failed to write build info file: %r�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnote [#] is not referenced.�Footnote [%s] is not referenced.�Footnotes�For more information, visit <https://www.sphinx-doc.org/>.�For security reasons, parallel mode is disabled on macOS and python3.8 and above. For more details, please read https://github.com/sphinx-doc/sphinx/issues/6803�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Handler %r for event %r threw an exception�Hide Search Matches�Hint�If the documents are to be written in a language other than English, you can select a language here by its language code. Sphinx will then translate text that it generates into that language. For a list of supported codes, see https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indicate which of the following Sphinx extensions should be enabled:�Indices and tables:�Inside the root directory, two more directories will be created; "_templates" for custom HTML templates and "_static" for custom stylesheets and other static files. You can enter another prefix (such as ".") to replace the underscore.�Interrupted!�Invalid __slots__ found on %s. Ignored.�Invalid caption: %s�Invalid date format. Quote the string by single quote if you want to output it directly: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�Keyword Arguments�LaTeX command %r cannot be run (needed for math display), check the imgmath_latex setting�Last updated on %(last_updated)s.�Library changes�Look for any errors in the above output or in %(outdir)s/output.txt�Makefile and Batchfile creation�Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Many math_renderers are registered. But no math_renderer is selected.�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Non-alphabetical�Note�Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.�Notes�Numbers�Object named %r not found in include file %r�One document is special in that it is considered the top node of the "contents tree", that is, it is the root of the hierarchical structure of the documents. Normally, this is "index", but if your "index" document is a custom template, you can also set this to another filename.�Original exception: �Other Parameters�Other changes�Output directory (%s) is not a directory�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this term�Permalink to this toctree�Pillow not found - copying image files�Please activate JavaScript to enable the search functionality.�Please also report this if it was a user error, so that a better error message can be provided next time.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter a new file name, or rename the existing file and press Enter�Please enter a new root path (or just Enter to exit)�Please enter a valid path name.�Please enter either 'y' or 'n'.�Please enter one of %s.�Please enter some text.�Please enter values for the following settings (just press Enter to accept a default value, if one is given in brackets).�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project templating�Project version�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Recursion error:�References�Release�Return type�Returns�Root path for the documentation�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Searching for multiple words only shows matches that contain all words.�Section %s�Section author: �See also�Selected root path: %s�Separate source and build directories (y/n)�Show Source�Since v2.0, Sphinx uses "index" as root_doc by default. Please add "root_doc = 'contents'" to your conf.py.�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Sphinx has the notion of a "version" and a "release" for the software. Each version can have multiple releases. For example, for Python the version is something like 2.5 or 3.0, while the release is something like 2.5.1 or 3.0a1. If you don't need this dual structure, just set both to the same value.�Structure options�Symbols�TODO entry found: %s�Table %s�Table of Contents�Template Parameters�Testing of coverage in the sources finished, look at the results in %(outdir)spython.txt.�Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt.�The %r crossref_type is already registered�The %r directive is already registered to domain %s�The %r index is already registered to domain %s�The %r object_type is already registered�The %r role is already registered to domain %s�The %s extension is required by needs_extensions settings, but it is not loaded.�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.�The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.�The config value `{name}' has type `{current.__name__}'; expected {permitted}.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The dummy builder generates no files.�The ePub file is in %(outdir)s.�The file name suffix for source files. Commonly, this is either ".txt" or ".rst". Only files with this suffix are considered documents.�The full traceback has been saved in %s, if you want to report the issue to the developers.�The manual pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�The overview file is in %(outdir)s.�The project name will occur in several places in the built documentation.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This can happen with very large or deeply nested source files. You can carefully increase the default Python recursion limit of 1000 in conf.py with e.g.:�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Tip�Todo�Translator for %r already exists�Unknown configure key: latex_elements[%r], ignored.�Unknown event name: %s�Unknown image format: %s...�Unknown math_renderer %r is given.�Unknown theme option: latex_theme_options[%r], ignored.�Use the Makefile to build the docs, like so: make builder�Use the sphinx-build command to build the docs, like so: sphinx-build -b builder %s %s�Variables�Warning�Warns�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�Would create file %s.�You have two options for placing the build directory for Sphinx output. Either, you use a directory "_build" within the root path, or you separate "source" and "build" directories within the root path.�You should now populate your master file %s and create other documentation source files. �Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[autosummary] failed to import %r: %s�[autosummary] generating autosummary for: %s�[autosummary] writing to %s�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.�a list of specific files to rebuild. Ignored if -a is specified�a suitable image for %s builder not found: %s�a suitable image for %s builder not found: %s (%s)�alias of %s�alias of TypeVar(%s)�all functions, classes, terms�all of %d po files�all source files�append module_path to sys.path, used when --full is given�assembling single document�attribute�author names�autodoc: failed to determine %r to be documented, the following exception was raised: %s�autodoc_member_order now accepts "alphabetical" instead of "alphabetic". Please update your setting.�automatically insert docstrings from modules�automatically test code snippets in doctest blocks�autosummary generats .rst files internally. But your source_suffix does not contain .rst. Skipped.�autosummary references excluded document %r. Ignored.�autosummary: failed to determine %r to be documented, the following exception was raised: %s�autosummary: failed to import %s�autosummary: stub file not found %r. Check your autosummary_generate setting.�autosummary_generate: file not found: %s�both tabularcolumns and :widths: option are given. :widths: is ignored.�broken link: %s (%s)�build %s, %s warning (with warnings treated as errors).�build %s, %s warning.�build %s, %s warnings (with warnings treated as errors).�build %s, %s warnings.�build %s.�build environment version not current�build in parallel with N processes where possible (special value "auto" will set N to cpu-count)�build info file is broken: %r�builder to use (default: html)�building [%s]: �building [mo]: �built-in function�can be huge�cannot combine -a option and filenames�cannot copy downloadable file %r: %s�cannot copy extra file %r�cannot copy image file %r: %s�cannot copy static file %r�cannot find files %r�cannot open warning file %r: %s�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�cannot read image file %r: copying it instead�cannot write image file %r: %s�caption not inside a figure.�checking consistency�checks for documentation coverage�circular toctree references detected, ignoring: %s <- %s�class�class method�command line option�concept�conditional inclusion of content based on config values�conf value "epub_author" should not be empty for EPUB3�conf value "epub_contributor" should not be empty for EPUB3�conf value "epub_copyright" (or "copyright")should not be empty for EPUB3�conf value "epub_description" should not be empty for EPUB3�conf value "epub_identifier" should not be empty for EPUB3�conf value "epub_language" (or "language") should not be empty for EPUB3�conf value "epub_publisher" should not be empty for EPUB3�conf value "epub_title" (or "html_title") should not be empty for EPUB3�conf value "epub_uid" should be XML NAME for EPUB3�conf value "version" should not be empty for EPUB3�config changed�config directory doesn't contain a conf.py file (%s)�console output options�continued from previous page�continues on next page�convert command %r cannot be run, check the image_converter setting�convert command %r cannot be run, check the image_converter setting: %s�convert exited with error: [stderr] %r [stdout] %r�copying TeX support files�copying TeX support files...�copying Texinfo support files�copying additional files�copying downloadable files... �copying extra files�copying images... �copying source files...�copying static files�could not read %r for changelog creation�create .nojekyll file to publish the document on GitHub pages�create batchfile�create makefile�custom template directory (default: %(default)s)�data�default role %s not found�default suffix for files (default: %(default)s)�define a template variable�define tag: include "only" blocks with TAG�dimension unit %s is invalid. Ignored.�directive�directive %r is already registered, it will be overridden�directory to place all output�directory to place all output in�display latex %r: %s�do not create batchfile�do not create makefile�do not use make-mode for Makefile/make.bat�docnames to write: %s�document�document imported members (default: %(default)s)�document isn't included in any toctree�document language�document not readable. Ignored.�document title is not a single Text node�domain %s already registered�domain %s not yet registered�don't create a table of contents file�don't create headings for the module/package packages (e.g. when the docstrings already contain them)�don't know which module to import for autodocumenting %r (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)�don't use a saved environment, always read all files�done�dot code %r: %s�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�dot did not produce an output file: [stderr] %r [stdout] %r�dot exited with error: [stderr] %r [stdout] %r�download file not readable: %s�dumping search index in %s�duplicate %s description of %s, other %s in %s�duplicate %s description of %s, other instance in %s�duplicate citation %s, other instance in %s�duplicate description of %s %s, other instance in %s�duplicate label %s, other instance in %s�duplicate label of equation %s, other instance in %s�duplicate object description of %s, other instance in %s, use :noindex: for one of them�duplicated ToC entry found: %s�enable %s extension�enable arbitrary extensions�encountered some issues with some of the inventories, but they had working alternatives:�encountered title node not in section, topic, table, admonition or sidebar�enumerable_node %r already registered�environment variable�environment variable; %s�error while formatting arguments for %s: %s�error while formatting signature for %s: %s�error writing file %s: %s�error writing file Makefile: %s�exception�exception while evaluating only directive expression: %s�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extension options�extensions changed�failed�failed to import object %s�failed to parse name %s�failed to reach any of the inventories with the following issues:�failed: %s�favicon file %r does not exist�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�filename of table of contents (default: modules)�finished with problems�fnmatch-style file and/or directory patterns to exclude from generation�follow symbolic links. Powerful when combined with collective.recipe.omelette.�function�function parameter�general options�generate a full project with sphinx-quickstart�generating indices�glossary seems to be misformatted, check indentation�glossary term�glossary term must be preceded by empty line�glossary terms must not be separated by empty lines�graphviz_output_format must be one of 'png', 'svg', but is %r�highlighting module code... �html_add_permalinks has been deprecated since v3.5.0. Please use html_permalinks and html_permalinks_icon instead.�html_extra_path entry %r does not exist�html_extra_path entry %r is placed inside outdir�html_static_path entry %r does not exist�html_static_path entry %r is placed inside outdir�if specified, create build dir under source dir�if specified, separate source and build dirs�ignoring invalid doctest code: %r�image file %s not readable: %s�image file not readable: %s�include "_private" modules�include links to the source code of documented Python objects�include math, rendered as PNG or SVG images�include math, rendered in the browser by MathJax�inconsistent citation references in translated message. original: {0}, translated: {1}�inconsistent footnote references in translated message. original: {0}, translated: {1}�inconsistent references in translated message. original: {0}, translated: {1}�inconsistent term references in translated message. original: {0}, translated: {1}�index�inline latex %r: %s�interpret module paths according to PEP-0420 implicit namespaces specification�intersphinx identifier %r is not string. Ignored�intersphinx inventory has moved: %s -> %s�invalid TestCode type�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�invalid regex %r in %s�invalid regex %r in coverage_c_regexes�invalid signature for auto%s (%r)�invalid value for class-doc-from option: %s�invalid value for member-order option: %s�invalid value set (missing closing brace): %s�invalid value set (missing opening brace): %s�job number should be a positive number�keyword�kwargs for add_node() must be a (visit, depart) function tuple: %r=%r�last updated�line number spec is out of range(1-%d): %r�link between Sphinx documentation of different projects�lists all sections and subsections�loading intersphinx inventory from %s...�loading translations [%s]... �locale_dir %s does not exists�logo file %r does not exist�looking for now-outdated files... �macro�making output directory�malformed string literal (missing closing quote): %s�malformed string literal (missing opening quote): %s�master document name�math renderer %s is already registered�maximum depth of submodules to show in the TOC (default: 4)�member�method�missing '+' or '-' in '%s' option.�missing attribute %s in object %s�missing attribute mentioned in :members: option: module %s, attribute %s�module�module %s could not be imported: %s�modules�more than one target found for 'any' cross-reference %r: could be %s�more than one target found for cross-reference %r: %s�multiple files found for the document "%s": %r Use %r for the build.�new config�next�next chapter�nit-picky mode, warn about all missing references�no "latex_documents" config value found; no documents will be written�no "man_pages" config value found; no manual pages will be written�no "texinfo_documents" config value found; no documents will be written�no Babel option known for language %r�no changes in version %s.�no code/output in %s block at %s:%s�no output at all, not even warnings�no output on stdout, just warnings on stderr�no targets are out of date.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�none found�not available for built-in messages�numfig is disabled. :numref: is ignored.�numfig_format is not defined for %s�object�operator�original entry�override a setting in configuration file�overwrite existing files�page�page %s matches two patterns in html_sidebars: %r and %r�pass a value into HTML templates�path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)�path to documentation source files�path to module to document�path to output directory�path where configuration file (conf.py) is located (default: same as SOURCEDIR)�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�program option�project author(s), used when --full is given�project name�project name (default: root module name)�project release, used when --full is given, defaults to --doc-version�project root�project version, used when --full is given�property�put documentation for each module on its own page�put module documentation before submodule documentation�quick access to all modules�quiet mode�reST markup error:�reading error: %s, %s�reading sources... �reading templates... �reference label�release of project�replacement for dot in _templates etc.�resolving references...�role�role %r is already registered, it will be overridden�run Pdb on exception�run the script without creating files�search�search index couldn't be loaded, but not all documents will be built: the index will be incomplete.�search this documentation�see %s�see also %s�self referenced toctree found. Ignored.�setting %s.%s occurs in none of the searched theme configs�skipped�source directory has changed�source file suffix�source files to generate rST files for�source_parser for %r is already registered�source_suffix %r is already registered�sphinx-quickstart only generate into a empty directory. Please specify a new root path.�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0�statement�static method�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�targets for %d template files�template directory for template files�template parameter�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension is not safe for parallel reading�the %s extension is not safe for parallel writing�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�toctree contains ref to nonexisting file %r�toctree contains reference to document %r that doesn't have a title: no link will be generated�toctree contains reference to excluded document %r�toctree contains reference to nonexisting document %r�too large :maxdepth:, ignored.�turn warnings into errors�type�undecodable source characters, replacing with "?": %r�undefined label: %s�undocumented c api: %s [%s] in file %s�undocumented python class: %s :: %s�undocumented python function: %s :: %s�undocumented python method: %s :: %s :: %s�unimplemented node type: %r�union�unknown %r toplevel_sectioning for class %r�unknown config value %r in override, ignoring�unknown directive or role name: %s:%s�unknown index entry type %r�unknown index entry type %s found�unknown mimetype for %s, ignoring�unknown node type: %r�unsupported theme option %r given�updating environment: �use epub�use make-mode for Makefile/make.bat�use no config file at all, only -D options�variable�version of project�waiting for workers...�where "builder" is one of the supported builders, e.g. html, latex or linkcheck.�while setting up extension %s:�with -W, keep going when getting warnings�write "todo" entries that can be shown or hidden on build�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing�writing %s file...�writing META-INF/container.xml file...�writing additional files�writing additional pages�writing content.opf file...�writing error: %s, %s�writing message catalogs... �writing mimetype file...�writing nav.xhtml file...�writing output... �writing summary file...�writing toc.ncx file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: sq Language-Team: Albanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sq/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � Prodhoni ReStructuredText duke përdorur direktiva vetëpërmbledhje. sphinx-autogen është një ndërfaqe pamore për sphinx.ext.autosummary.generate. Prodhon kartela reStructuredText nga direktiva vetëpërmbledhjeje që përmbahen te kartelat e dhëna. Formati i direktivës vetëpërmbledhje dokumentohet te moduli Python ``sphinx.ext.autosummary`` dhe mund të lexohet duke përdorur:: pydoc sphinx.ext.autosummary � Prodhoni dokumentim nga kartela burim. sphinx-build prodhon dokumentim prej kartelash te SOURCEDIR dhe e vendos te OUTPUTDIR. Kërkon për 'conf.py' te SOURCEDIR për rregullime formësimi. Mjeti 'sphinx-quickstart' mund të përdoret për të prodhuar kartela gjedhe, përfshi 'conf.py' sphinx-build mund të krijojë dokumentim në formate të ndryshëm. Një format përzgjidhet duke specifikuar te rreshti i urdhrave emrin e montuesit; HTML-ja, si parazgjedhje. Montuesit mund të kryejnë gjithashtu veprime të tjera të lidhura me përpunim dokumentimi. Si parazgjedhje, gjithçka që është e papërditësuar, montohet. Nëse doni montim vetëm për kartela të përzgjedhura, kjo mund të bëhet duke specifikuar emra kartelash individuale. � Prodho kartelat e domosdoshme për një projekt Sphinx. sphinx-quickstart është një mjet ndërveprues që bën disa pyetje rreth projektit tuaj dhe mandej prodhon një drejtori të plotë dokumentimi dhe një shembull Makefile për t’u përdorur me sphinx-build. � Shih në mënyrë rekursive te <MODULE_PATH> për module dhe paketa Python dhe krijo një kartelë reST me direktiva automodulesh për paketë te <OUTPUT_PATH>. <EXCLUDE_PATTERN>s mund të jetë shprehje kartelash dhe/ose drejtorish që mund të përjashtohen nga prodhimi. Shënim: Si parazgjedhje, ky programth s’do të anashkalojë kartela të krijuara tashmë.� Xhironi 'make' te ajo drejtori që të xhirohen këto përmes (pdf)latex (që të bëhet kjo automatikisht, përdorni `make latexpdf' këtu).� Xhironi 'make' te ajo drejtori, që të xhirohen këto përmes makeinfo-s (përdorni këtu 'make info' që kjo të kryhet automatikisht).� (nxjerrë nga përdorimi)� (në �"::" në emër automoduli nuk ka kuptim�Mundësia ":file:" për direktivë csv-table tani njeh një shteg absolut si shteg relativ prej drejtorisë burim. Ju lutemi, përditësoni dokumentin tuaj.�vlera e formësimit "texinfo_documents" i referohet një dokumenti të panjohur %s�vlera e formësimit "man_pages" i referohet një dokumenti të panjohur %s�"quiet" është specifikuar, por s’është specifikuar ndonjë "projekt" ose "autor".�vlera e formësimit "texinfo_documents" i referohet një dokumenti të panjohur %s�%(filename)s — %(docstitle)s�%d %b, %Y�U gjet %d�kartela burim %d dhënë te rresht urdhrash�%r s’ka rregullimin "%s"�%r s’ka rregullimin "theme"�s’u gjet objektiv reference %r: %s�%s %s�Dokumentim i %s %s�%s (atribut %s)�%s (veti %s)�%s (C %s)�%s (C++ %s)�%s (klasë e brendshme)�%s (ndryshore e brendshme)�%s (klasë te %s)�%s (direktivë)�%s ( ndryshore globale ose konstante)�%s (te moduli %s)�%s (modul)�%s (rol)�%s të shtuar, %s të ndryshuar, %s të hequr�Urdhri %s %r s’mund të xhirohet (i nevojshëm për shfaqje formulash matematikore), kontrolloni rregullimin imgmath_%s�Mundësi për rresht urdhrash %s�%s s’është drejtori.�%s() (metodë klase %s)�%s() (metodë %s)�%s() (metodë statike %s)�%s() (funksion i brendshëm)�%s() (klasë)�%s() (te moduli %s)�s’u gjet objektiv reference %s:%s: %s�© <a href="%(path)s">Të drejta kopjimi</a> %(copyright)s.�© Të drejta kopjimi %(copyright)s.�'%s' s’është mundësi e vlefshme.�'%s' s’është mundësi pyversion e vlefshme�'setup' siç është përcaktuar aktualisht te conf.py s’është funksion Python që mund të thirret. Ju lutemi, ndryshojeni përcaktimin e tij që ta bëni një funksion që mund të thirret. Kjo është e nevojshme që conf.py të sillet si një zgjerim Sphinx.�(<<original entry>> gjendet te %s, rreshti %d.)�(te %s v%s)�(te %s)�, në �argumenti i mundësisë -A duhet të jetë në formën emër=vlerë�argumenti i mundësisë -D duhet të jetë në formën emër=vlerë�U gjet tregues me bazë 4 shtylla. Mund të jetë një e metë e zgjerimeve që përdorni: %r�:%s: (mundësi direktive)�<<zëri origjinal>>�<h1>Krejt modulet për të cilët ka kod të gatshëm</h1>�<h1>Kod burim për %s</h1>�=================== kohëzgjatjet më të ngadalta të leximit ===================�Për ju mund të prodhohen një kartelë makefile dhe një urdhrash Windows, që kështu t’ju duhet vetëm të xhironi, për shembull, `make html', në vend se të thirret drejtpërsëdrejti sphinx-build.�Një njoftim të mete mund të depozitohet te gjurmuesi në <https://github.com/sphinx-doc/sphinx/issues>. Faleminderit!�Mbi këto dokumente�Ndodhi një gabim gjatë vizatimit të faqes %s. Arsye: %r�S’u gjet spirancë '%s'�Çfarëdo ID-sh jo të përshoqëruara për nyjën %s�Argumente�Vëmendje�Emër(a) autori(ësh)�Autor: �Listë ndryshime në versionin %(version)s e prodhuar automatikisht�Baza: %s�Montuesi %r ekziston tashmë (te moduli %s)�Klasa %s e montuesit nuk ka atribut "name"�Emër montuesi %s jo i regjistruar�Emër %s montuesi jo i regjistruar ose i passhëm përmes pike hyrjeje�Të brendshme�Ndryshime API C�S’gjendet dot drejtori burim (%s)�S’mund të përdoren në të njëjtën kohë të dyja mundësitë "%s" "%s"�Kujdes�Ndryshuar në versionin %s�Ndryshe në Versionin %(version)s — %(docstitle)s�Përmendja [%s] s’është në referencë.�Autor kodi: �Tkurre anështyllën�Tryezë e Plotë e Lëndës�Vlerë formësimi %r e pranishme tashmë�Lëndë�Të drejta kopjimi�S’u pru dot figurë e largët: %s [%d]�S’u soll dot figurë e largët: %s [%s]�S’u importua dot zgjerimi %s�S’u mor dot madhësi figure. Mundësia :scale: u shpërfill.�Të krijohet Makefile? (y/n)�Të krijohet kartelë urdhrash Windows? (y/n)�Krijuar duke përdorur <a href="https://www.sphinx-doc.org/">Sphinx</a> %(sphinx_version)s.�Po krijohet kartela %s.�Rrezik�Nxjerrë nga përdorimi�Nxjerrë nga përdorimi që me versionin %s�Përkatësia %r s’është e regjistruar�Deklarim C i përsëdytur, përkufizuar edhe te %s:%s. Deklarimi është '.. c:%s:: %s'.�Deklarim C++ i përsëdytur, përkufizuar edhe te %s:%s. Deklarimi është '.. cpp:%s:: %s'.�Kodimi %r i përdorur për lexim të kartelës “include” %r duket të jetë i gabuar, provoni të jepni një mundësi :encoding:�Gabim kodimi:�Jepni shtegun rrënjë për te dokumenti.�Gabim�Gabim: te shtegu rrënjë i përzgjedhur u gjet një conf.py ekzistues.�Gabim:shtegu i dhënë s’është drejtori, ose kartelat sphinx ekzistojnë tashmë.�Gabim: kartela master %s është gjetur tashmë një herë në shtegun rrënjë të përzgjedhur.�Vlerë formësimi %r e pranishme tashmë�Shembull�Shembuj�Ndodhi një përjashtim gjatë montimit, po niset diagnostikuesi:�Ndodhi një përjashtim:�Zgjeroje anështyllën�Mundësi zgjerimi�S’u gjet kartelë e jashtme Graphviz %r, ose dështoi leximi i saj�S’u arrit të përpilohet shprehje e rregullt te linkcheck_allowed_redirects: %r %s�S’u arrit të kopjohet një kartelë te html_static_file: %s: %r�S’u arrit të krijohej një ndërreferencë. S’u gjet titull ose legjendë: %s�S’u arrit të krijohej një ndërreferencë. S’u caktua ndonjë numër: %s�S’u arrit të merrej nënshkrim konstruktori për %s: %s�S’u arrit të merret një nënshkrim funksioni për %s: %s�S’u arrit të merre një nënshkrim metode për %s: %s�S’u arrit të përtypej një vlerë parazgjedhje argumenti për %r: %s�S’u arrit të përtypet type_comment për %r: %s�S’u arrit të lexohet kartelë të dhënash montimi: %r�S’u arrit të lexohej intersphinx_mapping[%s], u shpërfill: %r�S’u arrit të skanohen dokumente te %s: %r�S’u arrit të përditësohet nënshkrim për %r: s’u gjet parametër: %s�S’u arrit të shkruhet kartelë të dhënash montimi: %r�Figura %s�Ka tashmë një kartelë %s, po anashkalohet.�Përfundoi: U krijua një strukturë fillestare drejtorish.�Poshtëshënimi [#] s’është në referencë.�Poshtëshënimi [%s] s’është në referencë.�Poshtëshënime�Për më tepër hollësi, vizitoni <https://www.sphinx-doc.org/>.�Për arsye sigurie, mënyra paralele është e çaktivizuar në macOS dhe python3.8 dhe më sipër. Për më tepër hollësi, ju lutemi, lexoni https://github.com/sphinx-doc/sphinx/issues/6803�Tregues i plotë në një faqe�Tregues i Përgjithshëm�Tregues Global Modulesh�Shko�Një direktivë Graphviz s’mund të ketë edhe lëndë, edhe argument emri kartelash�Trajtuesi %r për aktin %r u përgjigj me një përjashtim�Fshih Përputhje Kërkimi�Ndihmëz�Nëse dokumentet janë shkruan në gjuhë tjetër nga anglishtja, mund të përzgjidhni një gjuhë këtu, përmes kodit të asaj gjuhe. Sphinx-i mandej do të përkthejë në atë gjuhë tekstin që prodhon. Për një listë kodesh të mbuluar, shihni https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Po shpërfillet direktivë “graphviz” pa lëndë.�E rëndësishme�S’u gjet kartelë “include” %r, ose leximi i saj dështoi�Tregues�Tregues – %(key)s�Faqe treguesi sipas shkronjash�Përcaktoni se cilët nga zgjerimet vijuese Sphinx duhen aktivizuar:�Tregues dhe tabela:�Brenda drejtorisë rrënjë do të krijohen dy drejtori të tjera; "_templates" për gjedhe vetjake HTML, dhe "_static" për fletëstile vetjakë dhe kartela të tjera statike. Mund të krijoni një tjetër parashtesë (bie fjala, ".") në vend të nënvijës.�U ndërpre!�U gjet __slots__ i pavlefshëm në %s. U shpërfill.�Titull i pavlefshëm: %s�Format i pavlefshëm datash. Quote the string by single quote Nëse doni të jepet drejtpërsëdrejti, përdorni për vargun thonjëza njëshe: %s�math_eqref_format i pavlefshëm: %r�Ndryshore e pavlefshme gjedheje: %s�Argumente Fjalëkyçi�Urdhri LaTeX %r s’mund të xhirohet (i nevojshëm për shfaqje formulash matematikore), kontrolloni rregullimin imgmath_late�Përditësuar së fundi më %(last_updated)s.�Ndryshime librarie�Shihni për çfarëdo gabimesh te përfundimi më sipër ose te %(outdir)s/output.txt�Krijim makefile-i dhe batchfile-i�Përshkrim i keqformuar mundësie %r, duhet të duket si "opt", "-opt args", "--opt args", "/opt args" ose "+opt args"�Janë të regjistruar plot math_renderers. Por s’u përzgjodh math_renderer.�Tregues Modulesh�Autor moduli: �Kod moduli�Shkallë moduli�Emër i dokumentit tuaj kryesor (pa prapashtesë)�Parashtesë emrash për drejtori gjedhesh dhe statikesh�Lëvizje�Të reja në versionin %s�Subjekti pasues�S’u përzgjodh montues, po përdoret parazgjedhja: html�S’ka vlerë të tillë formësimi: %s�Joalfabetike�Shënim�Shënim: imgmath dhe mathjax s’mund të aktivizohen në të njëjtën kohë. U hoqë përzgjedhja e imgmath-it.�Shënime�Numra�Objekti i emërtuar %r s’u gjet te kartelë include %r�Një dokument është i veçantë, për faktin se konsiderohet si nyja e epërme e "pemës së lëndës", domethënë, është rrënja e strukturës hierarkike të dokumenteve. Zakonisht, ky është "index", por nëse dokumenti juaj "index" është një gjedhe vetjake, si të tillë mund të caktoni një tjetër emër kartele.�Përjashtimi origjinal: �Parametra të Tjerë�Ndryshime të tjera�Drejtoria e përfundimeve (%s) s’është drejtori�Përmbledhje�Përmbledhje: kod moduli�Parametra�Permalidhje te ky kod�Permalidhje për te ky përkufizim�Permalidhje te ky ekuacion�Permalidhje te ky titull�Permalidhje te kjo figurë�Permalidhje te kjo tabelë�Permalidhje për te ky term�Permalidhje te kjo toctree�S’u gjet Pillow - po kopjohen kartela figurë�Që të aktivizohet funksioni i kërkimit, ju lutemi, aktivizoni JavaScript-in.�Ju lutemi, njoftojeni nëse qe një gabim përdoruesi, që kështu herës tjetër të mund të furnizohet një mesazh më i mirë gabimi.�Ju lutemi, jepni një prapashtesë kartele, për shembull, '.rst' ose '.txt'.�Ju lutemi, jepni një emër të ri kartele, ose riemërtojeni kartelën ekzistuese dhe shtypni tastin Enter�Ju lutemi, jepni një shteg të ri rrënjë (ose thjesht shtypni tastin Enter, që të dilet)�Ju lutemi, jepni një emër shtegu të vlefshëm.�Ju lutemi, jepni 'y' ose 'n'.�Ju lutemi, jepni një nga %s.�Ju lutemi, jepni ca tekst.�Ju lutemi, jepni vlera për rregullimet vijuese (thjesht shtypni tastin Enter që të pranohet një vlerë parazgjedhje, nëse është një e tillë brenda kllapave).�Po përgatitet kërkim...�Subjekti i mëparshëm�Mundësi bazë të projektit�Gjuhë projekti�Emër projekti�Hedhje në qarkullim e projektit�Gjedhe projekti�Version projekti�Python Enhancement Proposals; PEP %s�Tregues Modulesh Python�Kërkim i shpejtë�Gabim përsëritje:�Referenca�Hedhje Në Qarkullim�Lloj kthimi�Kthime�Shteg rrënje për te dokumenti�Po xhirohet Sphinx v%s�Kērko�Kërkoni te %(docstitle)s�Faqe Kërkimesh�Përfundime Kërkimi�Kërkimi përfundoi, u gjetën %s page(s) me përputhje me shprehjen e kërkuar.�Kërkoni brenda %(docstitle)s�Kërkim�Kërkimi për disa fjalë njëherësh shfaq vetëm përputhje që përmbajnë krejt fjalët.�Ndarja %s�Autor ndarjeje: �Shihni edhe�Shteg rrënjë i përzgjedhur: %s�Nda veçmas drejtoritë burim dhe montim (y/n)�Shfaq Burimin�Që prej v2.0, Sphinx përdor "index" për root_doc, si parazgjedhje. Ju lutemi, shtoni "root_doc = 'contents'" te conf.py juaj.�Drejtoria burim dhe drejtoria vendmbërritje s’mund të jenë identike�Prapashtesë kartele burim�Përtypës burimesh për %s jo i regjistruar�Sphinx-i përdor nocionet e “versionit” dhe “hedhjes në qarkullim” për software-in. Çdo version mund të ketë hedhje të shumta në qarkullim. Bie fjala, për Python-in versionet ngjajnë me 2.5 ose 3.0, teksa hedhja në qarkullim ngjan me 2.5.1 ose 3.0a1. Nëse kjo strukturë duale s’ju hyn në punë, thjesht vëruni të dyjave të njëjtën vlerë.�Mundësi strukture�Simbole�U gjet zë Për T’u Bërë: %s�Tabela %s�Tryeza e Lëndës�Parametra Gjedhesh�Testimi i mbulimit te burimet përfundoi, shihni te përfundimet në %(outdir)spython.txt.�Testimi i doctests-eve te burimet përfundoi, shihni te përfundimet në %(outdir)s/output.txt.�crossref_type %r është i regjistruar tashmë�Direktiva %r është e regjistruar tashmë te përkatësia %s�Treguesi %r është i regjistruar tashmë te përkatësia %s�object_type %r është i regjistruar tashmë�Roli %r është i regjistruar tashmë te përkatësia %s�Zgjerimi %s është i domosdoshëm për needs_extensions settings, por s’është ngarkuar.�Zgjerimi %s i përdorur nga ky projekt lyp të paktën Sphinx v%s; prandaj s’mund të montohet me këtë version.�Faqja HTML gjenden në %(outdir)s.�Faqet HTML gjenden në %(outdir)s.�Kartelat LaTeX gjenden në %(outdir)s.�Kartelat Texinfo gjenden në %(outdir)s.�Kartelat XML gjenden në %(outdir)s.�Vlera e formësimit `source_suffix' pret një varg, një listë vargjesh, ose një fjalor. Por është dhënë `%r'.�Vlera e formësimit `{name}' është e llojit `{current.__name__}', si parazgjedhje merr `{default.__name__}'.�Vlera e formësimit `{name}' është e llojit `{current.__name__}'; pritej {permitted}.�Vlera e formësimit `{name}` duhet të jetë një nga {candidates}, por është dhënë `{current}`.�Kartela e formësimit (ose një nga modulet që ajo importon) thirri sys.exit()�Montuesi provë nuk prodhon kartela.�Kartela ePub gjendet te %(outdir)s.�Prapashtesa e emrave të kartelave për kartela burim. Zakonisht, kjo është ose ".txt", ose ".rst". Vetëm kartelat me këtë prapashtesë merren si dokumente.�Traceback-u i plotë është ruajtur te %s, nëse doni t’ua raportoni problemin zhvilluesve.�Faqet e doracakut gjenden në %(outdir)s.�Katalogët e mesazheve gjenden te %(outdir)s.�Kartela përmbledhje gjendet te %(outdir)s.�Emri i projektit do të shfaqet në disa vende te dokumentimi i montuar.�Kartelat pseudo-XML gjenden në %(outdir)s.�Kartelat tekst gjenden në %(outdir)s.�Ka një gabim të programueshëm te kartela juaj e formësimit: %s�Ka një gabim sintakse te kartela juaj e formësimit: %s �Kjo Faqe�Kjo mund të ndodhë me kartela burim shumë të mëdha ose të futura thellë brenda njëra-tjetrës. Mund të rrisni me kujdes kufirin parazgjedhje për ripërsëritje Python prej 1000, te conf.py, me p.sh.:�Ky mjedis është i papërputhshëm me montuesin e përzgjedhur, ju lutemi, zgjidhni një tjetër drejtori doctree.�Ky projekt lyp të paktën Sphinx v%s, ndaj s’mund të montohet me këtë version.�Ky projekt lyp zgjerimin %s të paktën nën versionin %s dhe prandaj s’mund të montohet me versionin e ngarkuar (%s).�Ndihmëz�Për T’u Bërë�Përkthyesi për %r ekziston tashmë�Kyç i panjohur formësimi: latex_elements[%r], u shpërfill.�Emër i panjohur akti: %s�Format i panjohur figure: %s…�U dha math_renderer %r i panjohur.�Mundësi e panjohur teme: latex_theme_options[%r], u shpërfill.�Përdorni Makefile-in që të montohen dokumentet, kështu: make builder�Përodrni urdhrin sphinx-build që të montohen dokumentet, kështu: sphinx-build -b montues %s %s�Ndryshore�Sinjalizim�Sinjalizime�Mirë se vini te mjeti për fillim të shpejtë me Sphinx %s.�Mirë se vini! Ky është�Do të krijonte kartelë %s.�Keni dy mundësi për vendosjen e drejtorisë së montimeve për çka prodhon Sphinx-i. Përdorni një drejtori "_build" brenda shtegut rrënjë, ose i ndani drejtoritë "burim" dhe "montim" brenda shtegut rrënjë.�Tani duhet të populloni kartelën tuaj master file %s dhe të krijoni kartela të tjera burim të dokumentimit. �Kërkimi juaj s’gjeti përputhje me ndonjë dokument. Ju lutemi, sigurohuni se janë shkruar saktë krejt fjalët dhe se keni përzgjedhur aq kategori sa duhen.�[vetëpërmbledhje] s’u arrit të importohej %r: %s�[vetëpërmbledhje] prodhim vetëpërmbledhje për: %s�[vetëpërmbledhje] po shkruhet te %s�[dokumente]�[grafik: %s]�[grafik]�[figurë: %s]�[figurë]�[burim]�__all__ should duhet të jetë një listë vargjesh, jo %r (në module %s) -- ignoring __all__�ndodhi një gabim Unikod, kur vizatohej faqja %s. Ju lutemi, siguroni që krejt vlerat e formësimit që përmbajnë lëndë jo-ASCII të jenë vargje Unikod.�një listë kartelash specifike për rimontim. E shpërfillur, nëse jepet -a�s’u gjet figurë e përshtatshme për montuesin %s: %s�s’u gjet figurë e përshtatshme për montuesin %s: %s (%s)�alias për %s�alias për TypeVar(%s)�krejt funksionet, klasat, termat�krejt kartelat po %d�krejt kartelat burim�shto module_path pas sys.path, e përdorur kur është dhënë --full�po montohet dokument njësh�atribut�emra autorësh�autodoc: s’u arrit të përcaktohet %r për dokumentim, u shfaq përjashtimi vijues: %s�autodoc_member_order tani pranon "alphabetical", në vend se "alphabetic". Ju lutemi, përditësoni rregullimin tuaj.�fut automatikisht docstrings prej modulesh�testo automatikisht copëza kodi te blloqe doctest�vetëpërmbledhja prodhon së brendshmi kartela .rst. Por source_suffix juaj s’përmban .rst. U anashkalua.�referenca vetëpërmbledhjeje përjashtuan dokumentin %r. U shpërfill.�vetëpërmbledhje: s’u arrit të përcaktohet %r për t’u dokumentuar, u shfaq përjashtimi vijues: %s�vetëpërmbledhje: s’u arrit të importohej %s�vetëpërmbledhje: s’u gjet kartelë stub %r. Kontrolloni rregullimin tuaj autosummary_generate.�autosummary_generate: s’u gjet kartelë: %s�janë dhënë që të dyja mundësitë, “tabularcolumns” dhe “:widths:”. shpërfillet :widths:.�lidhje e dëmtuar: %s (%s)�montimi %s, % sinjalizim (me sinjalizime të trajtuara si gabime).�build %s, %s warning.�montimi %s, %s sinjalizime (me sinjalizime të trajtuara si gabime).�montimi %s, %s sinjalizime.�montimi %s.�version jo i tanishëm i mjedisit të montimit�montoje në paralel me N procese, kur është e mundur (vlera speciale “auto”" do ta vërë N-në sa cpu-count)�kartela e të dhënave të montimit është e dëmtuar: %r�montues për t’u përdorur (parazgjedhje: html)�po montohet [%s]: �po montohet [mo]: �funksion i brendshëm�mund të jetë i stërmadh�s’mund të ndërthuret një mundësi -a dhe emra kartelash�s’kopjohet dot kartelë e shkarkueshme %r: %s�s’kopjohet dot kartelë ekstra %r�s’kopjohet dot kartelë figure %r: %s�s’kopjohet dot kartelë statike %r�s’gjenden dot kartela %r�s’hapet dot kartelë sinjalizimesh %r: %s�s’mund të anashkalohet rregullim formësimi %r me një lloj të pambuluar, po shpërfillet�s’mund të anashkalohet rregullim formësimi fjalorthi %r, po shpërfillet (për të ujdisur elemente individuale, përdorni %r)�s’lexohet dot kartelë figure %r: në vend të tij, po kopjohet�s’shkruhet dot kartelë figure %r: %s�titull jo brenda një figure.�po kontrollohet njëtrajtshmëria�kontrolle për mbulim dokumentimi�u pikasën referenca rrethore toctree-je, po shpërfllen: %s <- %s�klasë�metodë klase�mundësi për rresht urdhrash�koncept�përfshirje e kushtëzuar lënde, bazuar në vlera formësimi�vlera e formësimit "epub_author" s’duhet të jetë e zbrazët për EPUB3�vlera e formësimit "epub_contributor" s’duhet të jetë e zbrazët për EPUB3�vlera e formësimit "epub_copyright" (ose "copyright") s’duhet të jetë e zbrazët për EPUB3�vlera e formësimit "epub_description" s’duhet të jetë e zbrazët për EPUB3�vlera e formësimit "epub_identifier" s’duhet të jetë e zbrazët për EPUB3�vlera e formësimit "epub_language" (ose "language") s’duhet të jetë e zbrazët për EPUB3�vlera e formësimit "epub_publisher" s’duhet të jetë e zbrazët për EPUB3�vlera e formësimit "epub_title" (ose "html_title") s’duhet të jetë e zbrazët për EPUB3�vlera e formësimit "epub_uid" duhet të jetë XML NAME për EPUB3�vlera e formësimit "version" s’duhet të jetë e zbrazët për EPUB3�formësimi ndryshoi�drejtoria e formësimeve nuk përmban një kartelë conf.py (%s)�mundësi për ç’prodhon konsola�vazhduar nga faqja e mëparshme�vazhdon në faqen pasuese�s’mund të xhirohet urdhër shndërrimi %r, kontrolloni rregullimin image_converter�s’mund të xhirohet urdhër shndërrimi %r, kontrolloni rregullimin image_converter: %s�shndërrimi përfundoi me gabimin: [stderr] %r [stdout] %r�po kopjohen kartela mbulimi TeX�po kopjohen kartela mbulimi TeX…�po kopjohen kartela mbulimi Texinfo�po kopjohen kartela shtesë�po kopjohen kartela të shkarkueshme… �po kopjohen kartela ekstra�po kopjohen figura… �po kopjohen kartela burim…�po kopjohen kartela statike�s’u lexua dot %r për krijim regjistrimi ndryshimesh�krijo kartelë .nojekyll për të botuar dokumentin në faqe GitHub�krijo batchfile�krijo makefile�drejtori gjedhesh vetjake (parazgjedhje: %(default)s)�të dhëna�s’u gjet rol parazgjedhje %s�prapashtesë parazgjedhje për kartela (parazgjedhje: %(default)s)�përkufizoni një ndryshore gjedheje�përcaktoni etiketë: përfshi blloqe “only” me TAG�njësia e përmasave %s është e pavlefshme. U shpërfill.�direktivë�direktiva %r është e regjistruar tashmë, do të anashkalohet�drejtori ku të vendosen krejt përfundimet�drejtori ku të vendosen krejt përfundimet�shfaq latex %r: %s�mos krijo batchfile�mos krijo makefile�mos përdor make-mode për Makefile/make.bat�emra dokumentesh për shkrim: %s�dokument�pjesë të importuara të dokumentit (parazgjedhje: %(default)s)�dokumenti s’është i përfshirë në ndonjë toctree�gjuhë dokumenti�dokument i palexueshëm. U shpërfill.�titulli i dokumentit s’është nyje njëshe Teksti�përkatësi %s e regjistruar tashmë�përkatësi %s ende e paregjistruar�mos krijo një kartelë tryeze lënde�mos krijo krye për paketat modul/paketë (për shembull, kur ato i përmban tashmë docstrings)�s’dihet cili modul të importohet për vetëdokumentim të %r (provoni të vendosni te dokumenti një direktivë "module" ose "currentmodule", ose të jepni shprehimisht një emër moduli)�mos përdor një mjedis të ruajtur, lexo përherë krejt kartelat�u bë�kod dot %r: %s�urdhri dot %r s’mund të xhirohet (i nevojshëm për çka prodhon graphviz), kontrolloni rregullimin graphviz_dot�dot s’prodhoi kartelë përfundim: [stderr] %r [stdout] %r�dot përfundoi me gabim: [stderr] %r [stdout] %r�kartelë shkarkimi jo e lexueshme: %s�po shkruhet lënda e treguesit të kërkimeve në %s�përshkrim %s i përsëdytur i %s, tjetër %s në %s�përshkrim %s i përsëdytur për %s, tjetër instancë te %s�citim i përsëdytur %s, tjetër instancë te %s�përshkrim i përsëdytur %s %s, instancë tjetër te %s�etiketë %s e përsëdytur, tjetër instancë te %s�etiketë e përsëdytur ekuacioni %s, instancë tjetër te %s�përshkrim i përsëdytur objekti për %s, instancë tjetër te %s, përdorni :noindex: për një prej tyre�u gjet zë TeL i përsëdytur: %s�aktivizo zgjerimin %s�aktivizo zgjerime arbitrare�u hasën disa probleme me disa nga inventare, por kishin alternativa funksionale:�u has nyje titulli jo në ndarje, temë, tabelë, paralajmërim ose anështyllë�enumerable_node %r tashmë i regjistruar�ndryshore mjedisi�ndryshore mjedisi; %s�gabim gjatë formatimi argumentesh për %s: %s�gabim gjatë formatimi nënshkrimesh për %s: %s�gabim në shkrim kartele %s: %s�gabim në shkrim kartele Makefile: %s�përjashtim�përjashtim teksa vlerësohej vetëm shprehje direktive: %s�zgjerimi %r s’ka funksion setup(); a është vërtet një modul zgjerimi Sphinx-i?�zgjerimi %r u përgjigj me një objekt të pambuluar prej funksionit të vet setup(); duhet të përgjigjet me Asnjë ose një fjalorth tejtëdhënash�mundësi zgjatimi�zgjerimet u ndryshuan�e dështuar�s’u arrit të importohej objekti %s�s’u arrit të përtypej emri %s�s’u arrit të kapej ndonjë inventar me problemet vijuese:�dështoi: %s�kartela favikonë %r s’ekziston�kartela %r e dhënë te rresht urdhrash s’ekziston, po shpërfillet�kartela %r e dhënë te rresht urdhrash s’gjendet te drejtori burim, po shpërfillet�kartela %r te shteg teme s’është kartelë zip e vlefshme ose nuk përmban temë�prapashtesë kartele (parazgjedhje: rst)�emër kartele për tryezën e lëndës (parazgjedhje: modules)�u përfundua me probleme�kartelë fnmatch-style dhe/ose rregullsi drejtorish për t’u përjashtuar prej prodhimit�ndiq lidhje simbolike. E fuqishme, kur ndërthuret me collective.recipe.omelette.�funksion�parametër funksioni�mundësi të përgjithshme�prodho me sphinx-quickstart një projekt të plotë�po prodhohen tregues�fjalorthi duket të jetë i keformatuar, kontrolloni shmangie kryeradhe�term fjalorthi�termi i fjalorthit duhet të paraprihet nga një rresht i zbrazët�termat e fjalorthit s’duhet të paraprihet nga rreshta të zbrazët�graphviz_output_format duhet të jetë një nga 'png', 'svg', por është %r�po theksohet kod moduli… �html_add_permalinks është nxjerrë nga përdorimi që me v3.5.0. Ju lutemi, në vend të tyre përdorni html_permalinks dhe html_permalinks_icon.�zëri html_extra_path %r s’ekziston�zëri %r i html_extra_path entry është vendosur jashtë outdir-it�zëri html_static_path %r s’ekziston�zëri %r i html_extra_path entry është vendosur brenda outdir-it�në u përcaktoftë, krijo drejtori montimi nën drejtorinë burim�nëse është kërkuar, nda veçmas drejtoritë burim dhe montim�po shpërfillet kod “doctest” i pavlefshëm: %r�kartelë figure %s jo e lexueshme: %s�kartelë figure jo e lexueshme: %s�përfshi modulet "_private"�përfshi lidhje te kodi burim i objekteve Python të dokumentuara�përfshi formula matematikore, të vizatuara si figura PNG ose SVG�përfshi formula matematikore, të vizatuara te shfletuesi nga MathJax�referenca citimi pa njëtrajtësi, te fundfaqe në mesazhin e përkthyer. origjinali: {0}, përkthimi: {1}�referenca pa njëtrajtësi, te fundfaqe në mesazhin e përkthyer. origjinali: {0}, përkthimi: {1}�referenca pa njëtrajtësi, te mesazhi i përkthyer. origjinali: {0}, përkthimi: {1}�referenca citimi pa njëtrajtësi, te mesazhi i përkthyer. origjinali: {0}, përkthimi: {1}�tregues�latex brendazi %r: %s�interpreto shtigje modulesh sipas specifikimeve impicite PEP-0420 për emërhapësira�identifikuesi intersphinx %r s’është varg. U shpërfill�inventari intersphinx është lëvizur: %s -> %s�lloj TestCode i pavlefshëm�css_file e pavlefshme: %r, u shpërfill�js_file e pavlefshme: %r, u shpërfill�numër %r i pavlefshëm për vlerë formësimi %r, po shpërfillet�numfig_format i pavlefshëm: %s�numfig_format i pavlefshëm: %s (%r)�shprehje e rregullt e pavlefshme %r te %s�shprehje e rregullt %r e pavlefshme te coverage_c_regexes�nënshkrim i pavlefshëm për auto%s (%r)�vlerë e pavlefshme për mundësinë class-doc-from: %s�vlerë e pavlefshme mundësie për member-order: %s�u caktua vlerë e pavlefshme (mungon kllapë mbyllëse): %s�u caktua vlerë e pavlefshme (mungon kllapë hapëse): %s�numri i aktit duhet të jetë një numër pozitiv�fjalëkyç�kwargs për add_node() duhet të jetë një çift funksioni (visit, depart): %r=%r�përditësuar së fundi më�numri i specifikuar për rreshtin është jashtë intervali (1-%d): %r�lidhje mes dokumentimi Sphinx projektesh të ndryshëm�paraqet krejt ndarjet dhe nënndarjet�po ngarkohet inventari intersphinx prej %s…�po ngarkohen përkthime [%s]… �locale_dir %s s’ekziston�kartela stemë %r s’ekziston�po shihet për kartela të sapovjetruara… �makro�po krijohet drejtori përfundimesh�shprehje vargu e keqformuar (mungon thonjëz mbyllëse): %s�shprehje vargu e keqformuar (mungon thonjëz hapëse): %s�emër dokumenti bazë�vizatuesi i formulave matematikore %s është i regjistruar tashmë�thellësi maksimum nënmodulesh për shfaqje te TEL (parazgjedhje: 4)�anëtar�metodë�mungon '+' ose '-' te mundësia '%s'.�atribut %s që mungon te objekt %s�u përmend atribut që mungon në :members: mundësi: modul %s, atributi %s�modul�moduli %s s’u importua dot: %s�module�u gjet më shumë se një objektiv për ndërreferencën 'any' %r: mund të ishte %s�për ndërreferencën %r u gjet më shumë se një objektiv: %s�u gjetën shumë kartela për dokumentin "%s": %r Përdorni %r për montimin.�formësim i ri�pasuesi�kapitulli pasues�mënyrë gërricëse, sinjalizo mbi krejt referencat që mungojnë�s’u gjet vlerë formësimi "texinfo_documents"; s’do të shkruhet ndonjë dokument�s’u gjet vlerë formësimi "man_pages"; s’do të shkruhet ndonjë faqe doracaku�s’u gjet vlerë formësimi "texinfo_documents"; s’do të shkruhet ndonjë dokument�s’ka mundësi Babel të njohur për gjuhën %r�s’ka ndryshime në version %s.�s’ka kod/dhënie te blloku %s në %s:%s�pa output fare, madje as sinjalizime�pa output në stdout, thjesht sinjalizime në stderr�s’ka objektiva të vjetruar.�s’u gjet temë e emërtuar %r (mos mungon theme.conf?)�s’u gjet temë e emërtuar %r, u trashëgua nga %r�klasa %r e nyjeve është e regjistruar tashmë, vizitorët e saj do të anashkalohen�s’u gjet gjë�s’është i passhëm për mesazhe të brendshëm�numfig është i çaktivizuar. :numref: është shpërfillur.�numfig_format s’është i përcaktuar për %s�objekt�operator�zëri origjinal�anashkalo një rregullim te kartelë formësimi�mbishkruaj kartela ekzistuese�faqe�faqja %s ka përputhje me dy rregullsi te html_sidebars: %r dhe %r�jep një vlerë te gjedhe HTML�shteg për mjedis të ruajtur në fshehtinë dhe kartela doctree (parazgjedhje: OUTPUTDIR/.doctrees)�shteg për te kartela burimi dokumentimi�shteg për te modul për te dokumenti�shteg për te drejtori përfundimesh�shteg ku gjendet kartelë formësimi (conf.py) (parazgjedhje: i njëjtë me SOURCEDIR)�po përgatiten dokumente�i mëparshmi�kapitulli i mëparshëm�s’u gjet primary_domain %r, po shpërfillet.�po përpunohet %s�mundësi programi�autor(ë) projekti, e përdorur kur është dhënë --full�emër projekti�emër projekti (parazgjedhje: emër moduli rrënjë)�hedhje në qarkullim e projektit, e përdorur kur është dhënë --full, si parazgjedhje merr --doc-version�rrënjë e projektit�version projekti, e përdorur kur është dhënë --full�veti�vendose dokumentim për çdo modul në faqe më vete�vendose dokumentimin e modulit përpara dokumentimit të nënmodulit�hyrje e shpejtë te krejt modulet�mënyra pa zhurmë�Gabim markup-i reST:�gabim leximi: %s, %s�po lexohen burime… �po lexohen gjedhe… �etiketë reference�hedhje në qarkullim e projektit�zëvendësim për pikën te _templates, etj.�po shquhen referencat…�rol�roli %r është e regjistruar tashmë, do të anashkalohet�xhiro Pdb, në rast përjashtimesh�xhiroje programthin pa krijuar kartela�kërko�treguesi i kërkimi s’u ngarkua dot, por jo krejt dokumentet do të montohen: treguesi do të jetë i paplotë.�kërkoni te ky dokumentim�shihni %s�shihni edhe %s�U gjet “toctree” që i referohet vetes. U shpërfill.�rregullimi %s.%s nuk haset në asnjë prej formësimeve temash ku u kërkua�e anashkaluar�drejtoria burim ka ndryshuar�prapashtesë kartele burim�kartela burim për të cilat të krijohen kartela rST�source_parser për %r është i regjistruar tashmë�source_suffix %r është i regjistruar tashmë�sphinx-quickstart prodhon vetëm te një drejtori e zbrazët. Ju lutemi, specifikoni një shteg rrënjë të ri.�sphinx-quickstart s’do të mbishkruajë projekte ekzistuese Sphinx.�sphinx-quickstart s’do të mbishkruajë kartelën ekzistuese.�U gjet sphinx_rtd_theme (< 0.3.0). S’do të jetë e passhme që prej Sphinx-6.0�deklarim�metodë statike�doli me sukses�objektiva për kartela po %d që janë të papërditësuara�objektiva për kartela po %d që janë specifikuar�objektiva për kartela burim %d që janë të papërditësuara�objektiva për kartela gjedhe %d�drejtori gjedhesh për kartela gjedhe�parametër gjedheje�zgjerimi %s nuk deklaron nëse është i parrezik për lexim paralel, po merret se s’është - ju lutemi, kërkojini autorin të zgjerimit ta kontrollojë dhe ta bëjë këtë shprehimisht�zgjerimi %s nuk deklaron nëse është i parrezik për shkrim paralel, po merret se s’është - ju lutemi, kërkojini autorin të zgjerimit ta kontrollojë dhe ta bëjë këtë shprehimisht�zgjerimi %s s’është i sigurt për lexim paralel�zgjerimi %s s’është i sigurt për shkrim paralel�dokumentimi për�zgjerimi %r qe shkrirë me Sphinx-in që me versionin %s; ky zgjerim është shpërfillur.�lidhja s’ka titull: %s�tema %r s’ka rregullimin "inherit"�tema %r s’ka rregullimin "theme"�“toctree” përmban referencë për te një kartelë joekzistuese %r�toctree përmban referencë ndaj dokumenti %r që s’ka titull: s’do të prodhohet ndonjë lidhje�toctree përmban referencë ndaj dokumenti %r të përjashtuar�toctree përmban referencë ndaj dokumenti %r që s’ekziston�:maxdepth: shumë i madh, u shpërfill.�shndërroji sinjalizimet në gabime�lloj�shenja burimi të padeshifrueshme, po zëvendësohen me "?": %r�etiketë e papërcaktuar: %s�API C e padokumentuar: %s [%s] te kartela %s�klasë python e padokumentuar: %s :: %s�funksion python i padokumentuar: %s :: %s�metodë python e padokumentuar: %s :: %s :: %s�lloj nyjeje i pasendërtuar: %r�bashkim�toplevel_sectioning %r i panjohur për klasën %r�vlerë e panjohur formësimi %r te anashkalimi, po shpërfillet�emër direktive ose roli të panjohur: %s:%s�lloj i panjohur zëri treguesi: %r�u gjet lloj i panjohur %s zërash treguesi�lloj MIME i panjohur për %s, po shpërfillet�lloj i panjohur nyjeje: %r�është dhënë mundësi teme %r e pambuluar�po përditësohet mjedisi: �përdor epub�përdor make-mode për Makefile/make.bat�mos përdor fare kartelë formësimesh, vetëm mundësitë -D�ndryshore�version i projektit�po pritet për workers…�ku montues është një nga montuesin e mbuluar, p.sh., html, latex ose linkcheck.�teksa ujdiset zgjerimi %s:�me -W, vazhdo punën, kur merren sinjalizime�shkruaj zëra "todo" që mund të shfaqen ose fshihen te montimi�shkruaj krejt kartelat (parazgjedhje: shkruaj vetëm kartela të reja dhe ato të ndryshuara)�shkruaj sinjalizime (dhe gabime) te kartela e dhënë�po shkruhet�po shkruhet kartelë %s…�po shkruhet kartelë META-INF/container.xml…�po shkruhen kartela shtesë�po shkruhen faqe shtesë�po shkruhet kartelë content.opf…�gabim shkrimi: %s, %s�po shkruhen katalogë mesazhesh… �po shkruhet kartelë llojesh MIME…�po shkruhet kartelë nav.xhtml…�po shkruhet përfundim… �po shkruhet kartelë përmbledhje…�po shkruhet kartelë toc.ncx…�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sq/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000350143�00000000000�021172� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Besnik Bleta <besnik@programeshqip.org>, 2021 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Albanian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sq/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: sq\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "S’gjendet dot drejtori burim (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "Drejtoria e përfundimeve (%s) s’është drejtori" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Drejtoria burim dhe drejtoria vendmbërritje s’mund të jenë identike" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Po xhirohet Sphinx v%s" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "Për arsye sigurie, mënyra paralele është e çaktivizuar në macOS dhe python3.8 dhe më sipër. Për më tepër hollësi, ju lutemi, lexoni https://github.com/sphinx-doc/sphinx/issues/6803" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Ky projekt lyp të paktën Sphinx v%s, ndaj s’mund të montohet me këtë version." #: sphinx/application.py:243 msgid "making output directory" msgstr "po krijohet drejtori përfundimesh" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "teksa ujdiset zgjerimi %s:" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "'setup' siç është përcaktuar aktualisht te conf.py s’është funksion Python që mund të thirret. Ju lutemi, ndryshojeni përcaktimin e tij që ta bëni një funksion që mund të thirret. Kjo është e nevojshme që conf.py të sillet si një zgjerim Sphinx." #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "po ngarkohen përkthime [%s]… " #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "u bë" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "s’është i passhëm për mesazhe të brendshëm" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "dështoi: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "S’u përzgjodh montues, po përdoret parazgjedhja: html" #: sphinx/application.py:348 msgid "succeeded" msgstr "doli me sukses" #: sphinx/application.py:349 msgid "finished with problems" msgstr "u përfundua me probleme" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "montimi %s, % sinjalizim (me sinjalizime të trajtuara si gabime)." #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "montimi %s, %s sinjalizime (me sinjalizime të trajtuara si gabime)." #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "build %s, %s warning." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "montimi %s, %s sinjalizime." #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "montimi %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "klasa %r e nyjeve është e regjistruar tashmë, vizitorët e saj do të anashkalohen" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "direktiva %r është e regjistruar tashmë, do të anashkalohet" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "roli %r është e regjistruar tashmë, do të anashkalohet" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "zgjerimi %s nuk deklaron nëse është i parrezik për lexim paralel, po merret se s’është - ju lutemi, kërkojini autorin të zgjerimit ta kontrollojë dhe ta bëjë këtë shprehimisht" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "zgjerimi %s s’është i sigurt për lexim paralel" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "zgjerimi %s nuk deklaron nëse është i parrezik për shkrim paralel, po merret se s’është - ju lutemi, kërkojini autorin të zgjerimit ta kontrollojë dhe ta bëjë këtë shprehimisht" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "zgjerimi %s s’është i sigurt për shkrim paralel" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "drejtoria e formësimeve nuk përmban një kartelë conf.py (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "s’mund të anashkalohet rregullim formësimi fjalorthi %r, po shpërfillet (për të ujdisur elemente individuale, përdorni %r)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "numër %r i pavlefshëm për vlerë formësimi %r, po shpërfillet" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "s’mund të anashkalohet rregullim formësimi %r me një lloj të pambuluar, po shpërfillet" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "vlerë e panjohur formësimi %r te anashkalimi, po shpërfillet" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "S’ka vlerë të tillë formësimi: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "Vlerë formësimi %r e pranishme tashmë" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Ka një gabim sintakse te kartela juaj e formësimit: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Kartela e formësimit (ose një nga modulet që ajo importon) thirri sys.exit()" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "Ka një gabim të programueshëm te kartela juaj e formësimit:\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "Vlera e formësimit `source_suffix' pret një varg, një listë vargjesh, ose një fjalor. Por është dhënë `%r'." #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Ndarja %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Figura %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tabela %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "Vlera e formësimit `{name}` duhet të jetë një nga {candidates}, por është dhënë `{current}`." #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "Vlera e formësimit `{name}' është e llojit `{current.__name__}'; pritej {permitted}." #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "Vlera e formësimit `{name}' është e llojit `{current.__name__}', si parazgjedhje merr `{default.__name__}'." #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "s’u gjet primary_domain %r, po shpërfillet." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "Që prej v2.0, Sphinx përdor \"index\" për root_doc, si parazgjedhje. Ju lutemi, shtoni \"root_doc = 'contents'\" te conf.py juaj." #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "Vlerë formësimi %r e pranishme tashmë" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Emër i panjohur akti: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "Trajtuesi %r për aktin %r u përgjigj me një përjashtim" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "Zgjerimi %s është i domosdoshëm për needs_extensions settings, por s’është ngarkuar." #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "Ky projekt lyp zgjerimin %s të paktën nën versionin %s dhe prandaj s’mund të montohet me versionin e ngarkuar (%s)." #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "u gjetën shumë kartela për dokumentin \"%s\": %r\nPërdorni %r për montimin." #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "dokument i palexueshëm. U shpërfill." #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "Klasa %s e montuesit nuk ka atribut \"name\"" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Montuesi %r ekziston tashmë (te moduli %s)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Emër %s montuesi jo i regjistruar ose i passhëm përmes pike hyrjeje" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "Emër montuesi %s jo i regjistruar" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "përkatësi %s e regjistruar tashmë" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "përkatësi %s ende e paregjistruar" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "Direktiva %r është e regjistruar tashmë te përkatësia %s" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "Roli %r është i regjistruar tashmë te përkatësia %s" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "Treguesi %r është i regjistruar tashmë te përkatësia %s" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "object_type %r është i regjistruar tashmë" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "crossref_type %r është i regjistruar tashmë" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "source_suffix %r është i regjistruar tashmë" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "source_parser për %r është i regjistruar tashmë" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "Përtypës burimesh për %s jo i regjistruar" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "Përkthyesi për %r ekziston tashmë" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "kwargs për add_node() duhet të jetë një çift funksioni (visit, depart): %r=%r" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "enumerable_node %r tashmë i regjistruar" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "vizatuesi i formulave matematikore %s është i regjistruar tashmë" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "zgjerimi %r qe shkrirë me Sphinx-in që me versionin %s; ky zgjerim është shpërfillur." #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "Përjashtimi origjinal:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "S’u importua dot zgjerimi %s" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "zgjerimi %r s’ka funksion setup(); a është vërtet një modul zgjerimi Sphinx-i?" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "Zgjerimi %s i përdorur nga ky projekt lyp të paktën Sphinx v%s; prandaj s’mund të montohet me këtë version." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "zgjerimi %r u përgjigj me një objekt të pambuluar prej funksionit të vet setup(); duhet të përgjigjet me Asnjë ose një fjalorth tejtëdhënash" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "tema %r s’ka rregullimin \"theme\"" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "tema %r s’ka rregullimin \"inherit\"" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "s’u gjet temë e emërtuar %r, u trashëgua nga %r" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "rregullimi %s.%s nuk haset në asnjë prej formësimeve temash ku u kërkua" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "është dhënë mundësi teme %r e pambuluar" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "kartela %r te shteg teme s’është kartelë zip e vlefshme ose nuk përmban temë" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "U gjet sphinx_rtd_theme (< 0.3.0). S’do të jetë e passhme që prej Sphinx-6.0" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "s’u gjet temë e emërtuar %r (mos mungon theme.conf?)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "s’u gjet figurë e përshtatshme për montuesin %s: %s (%s)" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "s’u gjet figurë e përshtatshme për montuesin %s: %s" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "po montohet [mo]: " #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "po shkruhet përfundim… " #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "krejt kartelat po %d" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "objektiva për kartela po %d që janë specifikuar" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "objektiva për kartela po %d që janë të papërditësuara" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "krejt kartelat burim" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "kartela %r e dhënë te rresht urdhrash s’gjendet te drejtori burim, po shpërfillet" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "kartela %r e dhënë te rresht urdhrash s’ekziston, po shpërfillet" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "kartela burim %d dhënë te rresht urdhrash" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "objektiva për kartela burim %d që janë të papërditësuara" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "po montohet [%s]: " #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "po shihet për kartela të sapovjetruara… " #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "U gjet %d" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "s’u gjet gjë" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "po kontrollohet njëtrajtshmëria" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "s’ka objektiva të vjetruar." #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "po përditësohet mjedisi: " #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "%s të shtuar, %s të ndryshuar, %s të hequr" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "po lexohen burime… " #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "po pritet për workers…" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "emra dokumentesh për shkrim: %s" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "po përgatiten dokumente" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "u gjet zë TeL i përsëdytur: %s" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "po kopjohen figura… " #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "s’lexohet dot kartelë figure %r: në vend të tij, po kopjohet" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "s’kopjohet dot kartelë figure %r: %s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "s’shkruhet dot kartelë figure %r: %s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "S’u gjet Pillow - po kopjohen kartela figurë" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "po shkruhet kartelë llojesh MIME…" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "po shkruhet kartelë META-INF/container.xml…" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "po shkruhet kartelë content.opf…" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "lloj MIME i panjohur për %s, po shpërfillet" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "po shkruhet kartelë toc.ncx…" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "po shkruhet kartelë %s…" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "Kartela përmbledhje gjendet te %(outdir)s." #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "s’ka ndryshime në version %s." #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "po shkruhet kartelë përmbledhje…" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Të brendshme" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Shkallë moduli" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "po kopjohen kartela burim…" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "s’u lexua dot %r për krijim regjistrimi ndryshimesh" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "Montuesi provë nuk prodhon kartela." #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "Kartela ePub gjendet te %(outdir)s." #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "po shkruhet kartelë nav.xhtml…" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "vlera e formësimit \"epub_language\" (ose \"language\") s’duhet të jetë e zbrazët për EPUB3" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "vlera e formësimit \"epub_uid\" duhet të jetë XML NAME për EPUB3" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "vlera e formësimit \"epub_title\" (ose \"html_title\") s’duhet të jetë e zbrazët për EPUB3" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "vlera e formësimit \"epub_author\" s’duhet të jetë e zbrazët për EPUB3" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "vlera e formësimit \"epub_contributor\" s’duhet të jetë e zbrazët për EPUB3" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "vlera e formësimit \"epub_description\" s’duhet të jetë e zbrazët për EPUB3" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "vlera e formësimit \"epub_publisher\" s’duhet të jetë e zbrazët për EPUB3" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "vlera e formësimit \"epub_copyright\" (ose \"copyright\") s’duhet të jetë e zbrazët për EPUB3" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "vlera e formësimit \"epub_identifier\" s’duhet të jetë e zbrazët për EPUB3" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "vlera e formësimit \"version\" s’duhet të jetë e zbrazët për EPUB3" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "css_file e pavlefshme: %r, u shpërfill" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "Katalogët e mesazheve gjenden te %(outdir)s." #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "objektiva për kartela gjedhe %d" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "po lexohen gjedhe… " #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "po shkruhen katalogë mesazhesh… " #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "Shihni për çfarëdo gabimesh te përfundimi më sipër ose te %(outdir)s/output.txt" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "lidhje e dëmtuar: %s (%s)" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "S’u gjet spirancë '%s'" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "S’u arrit të përpilohet shprehje e rregullt te linkcheck_allowed_redirects: %r %s" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "Faqet e doracakut gjenden në %(outdir)s." #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "s’u gjet vlerë formësimi \"man_pages\"; s’do të shkruhet ndonjë faqe doracaku" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "po shkruhet" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "vlera e formësimit \"man_pages\" i referohet një dokumenti të panjohur %s" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "Faqja HTML gjenden në %(outdir)s." #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "po montohet dokument njësh" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "po shkruhen kartela shtesë" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "Kartelat Texinfo gjenden në %(outdir)s." #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "\nXhironi 'make' te ajo drejtori, që të xhirohen këto përmes makeinfo-s\n(përdorni këtu 'make info' që kjo të kryhet automatikisht)." #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "s’u gjet vlerë formësimi \"texinfo_documents\"; s’do të shkruhet ndonjë dokument" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "vlera e formësimit \"texinfo_documents\" i referohet një dokumenti të panjohur %s" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "po përpunohet %s" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "po shquhen referencat…" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (në " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "po kopjohen kartela mbulimi Texinfo" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "gabim në shkrim kartele Makefile: %s" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "Kartelat tekst gjenden në %(outdir)s." #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "gabim në shkrim kartele %s: %s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "Kartelat XML gjenden në %(outdir)s." #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "Kartelat pseudo-XML gjenden në %(outdir)s." #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "kartela e të dhënave të montimit është e dëmtuar: %r" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "Faqet HTML gjenden në %(outdir)s." #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "S’u arrit të lexohet kartelë të dhënash montimi: %r" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d %b, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Tregues i Përgjithshëm" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "tregues" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "pasuesi" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "i mëparshmi" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "po prodhohen tregues" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "po shkruhen faqe shtesë" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "po kopjohen kartela të shkarkueshme… " #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "s’kopjohet dot kartelë e shkarkueshme %r: %s" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "S’u arrit të kopjohet një kartelë te html_static_file: %s: %r" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "po kopjohen kartela statike" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "s’kopjohet dot kartelë statike %r" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "po kopjohen kartela ekstra" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "s’kopjohet dot kartelë ekstra %r" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "S’u arrit të shkruhet kartelë të dhënash montimi: %r" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "treguesi i kërkimi s’u ngarkua dot, por jo krejt dokumentet do të montohen: treguesi do të jetë i paplotë." #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "faqja %s ka përputhje me dy rregullsi te html_sidebars: %r dhe %r" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "ndodhi një gabim Unikod, kur vizatohej faqja %s. Ju lutemi, siguroni që krejt vlerat e formësimit që përmbajnë lëndë jo-ASCII të jenë vargje Unikod." #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "Ndodhi një gabim gjatë vizatimit të faqes %s.\nArsye: %r" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "po shkruhet lënda e treguesit të kërkimeve në %s" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "js_file e pavlefshme: %r, u shpërfill" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "Janë të regjistruar plot math_renderers. Por s’u përzgjodh math_renderer." #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "U dha math_renderer %r i panjohur." #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "zëri html_extra_path %r s’ekziston" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "zëri %r i html_extra_path entry është vendosur jashtë outdir-it" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "zëri html_static_path %r s’ekziston" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "zëri %r i html_extra_path entry është vendosur brenda outdir-it" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "kartela stemë %r s’ekziston" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "kartela favikonë %r s’ekziston" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "html_add_permalinks është nxjerrë nga përdorimi që me v3.5.0. Ju lutemi, në vend të tyre përdorni html_permalinks dhe html_permalinks_icon." #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "Dokumentim i %s %s" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "Kartelat LaTeX gjenden në %(outdir)s." #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\nXhironi 'make' te ajo drejtori që të xhirohen këto përmes (pdf)latex\n(që të bëhet kjo automatikisht, përdorni `make latexpdf' këtu)." #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "s’u gjet vlerë formësimi \"texinfo_documents\"; s’do të shkruhet ndonjë dokument" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "vlera e formësimit \"texinfo_documents\" i referohet një dokumenti të panjohur %s" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Tregues" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Hedhje Në Qarkullim" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "s’ka mundësi Babel të njohur për gjuhën %r" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "po kopjohen kartela mbulimi TeX" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "po kopjohen kartela mbulimi TeX…" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "po kopjohen kartela shtesë" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "Kyç i panjohur formësimi: latex_elements[%r], u shpërfill." #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "Mundësi e panjohur teme: latex_theme_options[%r], u shpërfill." #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "%r s’ka rregullimin \"theme\"" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "%r s’ka rregullimin \"%s\"" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "Ndodhi një përjashtim gjatë montimit, po niset diagnostikuesi:" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "U ndërpre!" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "Gabim markup-i reST:" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "Gabim kodimi:" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "Traceback-u i plotë është ruajtur te %s, nëse doni t’ua raportoni problemin zhvilluesve." #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "Gabim përsëritje:" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "Kjo mund të ndodhë me kartela burim shumë të mëdha ose të futura thellë brenda njëra-tjetrës. Mund të rrisni me kujdes kufirin parazgjedhje për ripërsëritje Python prej 1000, te conf.py, me p.sh.:" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "Ndodhi një përjashtim:" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "Ju lutemi, njoftojeni nëse qe një gabim përdoruesi, që kështu herës tjetër të mund të furnizohet një mesazh më i mirë gabimi." #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "Një njoftim të mete mund të depozitohet te gjurmuesi në <https://github.com/sphinx-doc/sphinx/issues>. Faleminderit!" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "numri i aktit duhet të jetë një numër pozitiv" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "Për më tepër hollësi, vizitoni <https://www.sphinx-doc.org/>." #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "\nProdhoni dokumentim nga kartela burim.\n\nsphinx-build prodhon dokumentim prej kartelash te SOURCEDIR dhe e vendos\nte OUTPUTDIR. Kërkon për 'conf.py' te SOURCEDIR për rregullime formësimi.\nMjeti 'sphinx-quickstart' mund të përdoret për të prodhuar kartela gjedhe,\npërfshi 'conf.py'\n\nsphinx-build mund të krijojë dokumentim në formate të ndryshëm. Një format\npërzgjidhet duke specifikuar te rreshti i urdhrave emrin e montuesit; HTML-ja,\nsi parazgjedhje. Montuesit mund të kryejnë gjithashtu veprime të tjera të lidhura\nme përpunim dokumentimi.\n\nSi parazgjedhje, gjithçka që është e papërditësuar, montohet. Nëse doni\nmontim vetëm për kartela të përzgjedhura, kjo mund të bëhet duke\nspecifikuar emra kartelash individuale.\n" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "shteg për te kartela burimi dokumentimi" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "shteg për te drejtori përfundimesh" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "një listë kartelash specifike për rimontim. E shpërfillur, nëse jepet -a" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "mundësi të përgjithshme" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "montues për t’u përdorur (parazgjedhje: html)" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "shkruaj krejt kartelat (parazgjedhje: shkruaj vetëm kartela të reja dhe ato të ndryshuara)" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "mos përdor një mjedis të ruajtur, lexo përherë krejt kartelat" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "shteg për mjedis të ruajtur në fshehtinë dhe kartela doctree (parazgjedhje: OUTPUTDIR/.doctrees)" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "montoje në paralel me N procese, kur është e mundur (vlera speciale “auto”\" do ta vërë N-në sa cpu-count)" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "shteg ku gjendet kartelë formësimi (conf.py) (parazgjedhje: i njëjtë me SOURCEDIR)" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "mos përdor fare kartelë formësimesh, vetëm mundësitë -D" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "anashkalo një rregullim te kartelë formësimi" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "jep një vlerë te gjedhe HTML" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "përcaktoni etiketë: përfshi blloqe “only” me TAG" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "mënyrë gërricëse, sinjalizo mbi krejt referencat që mungojnë" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "mundësi për ç’prodhon konsola" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "pa output në stdout, thjesht sinjalizime në stderr" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "pa output fare, madje as sinjalizime" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "shkruaj sinjalizime (dhe gabime) te kartela e dhënë" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "shndërroji sinjalizimet në gabime" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "me -W, vazhdo punën, kur merren sinjalizime" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "xhiro Pdb, në rast përjashtimesh" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "s’gjenden dot kartela %r" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "s’mund të ndërthuret një mundësi -a dhe emra kartelash" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "s’hapet dot kartelë sinjalizimesh %r: %s" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "argumenti i mundësisë -D duhet të jetë në formën emër=vlerë" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "argumenti i mundësisë -A duhet të jetë në formën emër=vlerë" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "fut automatikisht docstrings prej modulesh" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "testo automatikisht copëza kodi te blloqe doctest" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "lidhje mes dokumentimi Sphinx projektesh të ndryshëm" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "shkruaj zëra \"todo\" që mund të shfaqen ose fshihen te montimi" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "kontrolle për mbulim dokumentimi" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "përfshi formula matematikore, të vizatuara si figura PNG ose SVG" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "përfshi formula matematikore, të vizatuara te shfletuesi nga MathJax" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "përfshirje e kushtëzuar lënde, bazuar në vlera formësimi" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "përfshi lidhje te kodi burim i objekteve Python të dokumentuara" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "krijo kartelë .nojekyll për të botuar dokumentin në faqe GitHub" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "Ju lutemi, jepni një emër shtegu të vlefshëm." #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "Ju lutemi, jepni ca tekst." #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "Ju lutemi, jepni një nga %s." #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "Ju lutemi, jepni 'y' ose 'n'." #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "Ju lutemi, jepni një prapashtesë kartele, për shembull, '.rst' ose '.txt'." #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "Mirë se vini te mjeti për fillim të shpejtë me Sphinx %s." #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "Ju lutemi, jepni vlera për rregullimet vijuese (thjesht shtypni tastin\nEnter që të pranohet një vlerë parazgjedhje, nëse është një e tillë\nbrenda kllapave)." #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "Shteg rrënjë i përzgjedhur: %s" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "Jepni shtegun rrënjë për te dokumenti." #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "Shteg rrënje për te dokumenti" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "Gabim: te shtegu rrënjë i përzgjedhur u gjet një conf.py ekzistues." #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "sphinx-quickstart s’do të mbishkruajë projekte ekzistuese Sphinx." #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "Ju lutemi, jepni një shteg të ri rrënjë (ose thjesht shtypni tastin Enter, që të dilet)" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "Keni dy mundësi për vendosjen e drejtorisë së montimeve për çka prodhon Sphinx-i.\nPërdorni një drejtori \"_build\" brenda shtegut rrënjë, ose i ndani\ndrejtoritë \"burim\" dhe \"montim\" brenda shtegut rrënjë." #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "Nda veçmas drejtoritë burim dhe montim (y/n)" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "Brenda drejtorisë rrënjë do të krijohen dy drejtori të tjera; \"_templates\" për\ngjedhe vetjake HTML, dhe \"_static\" për fletëstile vetjakë dhe kartela të tjera statike.\nMund të krijoni një tjetër parashtesë (bie fjala, \".\") në vend të nënvijës." #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "Parashtesë emrash për drejtori gjedhesh dhe statikesh" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "Emri i projektit do të shfaqet në disa vende te dokumentimi i montuar." #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "Emër projekti" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "Emër(a) autori(ësh)" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "Sphinx-i përdor nocionet e “versionit” dhe “hedhjes në qarkullim” për\nsoftware-in. Çdo version mund të ketë hedhje të shumta në qarkullim.\nBie fjala, për Python-in versionet ngjajnë me 2.5 ose 3.0, teksa hedhja\nnë qarkullim ngjan me 2.5.1 ose 3.0a1. Nëse kjo strukturë duale s’ju\nhyn në punë, thjesht vëruni të dyjave të njëjtën vlerë." #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "Version projekti" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "Hedhje në qarkullim e projektit" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "Nëse dokumentet janë shkruan në gjuhë tjetër nga anglishtja,\nmund të përzgjidhni një gjuhë këtu, përmes kodit të asaj gjuhe. Sphinx-i mandej\ndo të përkthejë në atë gjuhë tekstin që prodhon.\n\nPër një listë kodesh të mbuluar, shihni\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "Gjuhë projekti" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "Prapashtesa e emrave të kartelave për kartela burim. Zakonisht, kjo\nështë ose \".txt\", ose \".rst\". Vetëm kartelat me këtë prapashtesë\nmerren si dokumente." #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "Prapashtesë kartele burim" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "Një dokument është i veçantë, për faktin se konsiderohet si nyja e epërme\ne \"pemës së lëndës\", domethënë, është rrënja e strukturës hierarkike\ntë dokumenteve. Zakonisht, ky është \"index\", por nëse dokumenti juaj \"index\"\nështë një gjedhe vetjake, si të tillë mund të caktoni një tjetër emër kartele." #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "Emër i dokumentit tuaj kryesor (pa prapashtesë)" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "Gabim: kartela master %s është gjetur tashmë një herë në shtegun rrënjë të përzgjedhur." #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "sphinx-quickstart s’do të mbishkruajë kartelën ekzistuese." #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "Ju lutemi, jepni një emër të ri kartele, ose riemërtojeni kartelën ekzistuese dhe shtypni tastin Enter" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "Përcaktoni se cilët nga zgjerimet vijuese Sphinx duhen aktivizuar:" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "Shënim: imgmath dhe mathjax s’mund të aktivizohen në të njëjtën kohë. U hoqë përzgjedhja e imgmath-it." #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "Për ju mund të prodhohen një kartelë makefile dhe një urdhrash Windows, që\nkështu t’ju duhet vetëm të xhironi, për shembull, `make html', në vend se\ntë thirret drejtpërsëdrejti sphinx-build." #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "Të krijohet Makefile? (y/n)" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "Të krijohet kartelë urdhrash Windows? (y/n)" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "Po krijohet kartela %s." #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "Ka tashmë një kartelë %s, po anashkalohet." #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "Përfundoi: U krijua një strukturë fillestare drejtorish." #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "Tani duhet të populloni kartelën tuaj master file %s dhe të krijoni kartela të tjera\nburim të dokumentimit. " #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "Përdorni Makefile-in që të montohen dokumentet, kështu:\n make builder" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "Përodrni urdhrin sphinx-build që të montohen dokumentet, kështu:\n sphinx-build -b montues %s %s" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "ku montues është një nga montuesin e mbuluar, p.sh., html, latex ose linkcheck." #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "\nProdho kartelat e domosdoshme për një projekt Sphinx.\n\nsphinx-quickstart është një mjet ndërveprues që bën disa pyetje rreth projektit\ntuaj dhe mandej prodhon një drejtori të plotë dokumentimi dhe një shembull\nMakefile për t’u përdorur me sphinx-build.\n" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "mënyra pa zhurmë" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "rrënjë e projektit" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "Mundësi strukture" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "nëse është kërkuar, nda veçmas drejtoritë burim dhe montim" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "në u përcaktoftë, krijo drejtori montimi nën drejtorinë burim" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "zëvendësim për pikën te _templates, etj." #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "Mundësi bazë të projektit" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "emër projekti" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "emra autorësh" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "version i projektit" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "hedhje në qarkullim e projektit" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "gjuhë dokumenti" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "prapashtesë kartele burim" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "emër dokumenti bazë" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "përdor epub" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "Mundësi zgjerimi" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "aktivizo zgjerimin %s" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "aktivizo zgjerime arbitrare" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "Krijim makefile-i dhe batchfile-i" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "krijo makefile" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "mos krijo makefile" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "krijo batchfile" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "mos krijo batchfile" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "përdor make-mode për Makefile/make.bat" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "mos përdor make-mode për Makefile/make.bat" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "Gjedhe projekti" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "drejtori gjedhesh për kartela gjedhe" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "përkufizoni një ndryshore gjedheje" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "\"quiet\" është specifikuar, por s’është specifikuar ndonjë \"projekt\" ose \"autor\"." #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "Gabim:shtegu i dhënë s’është drejtori, ose kartelat sphinx ekzistojnë tashmë." #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "sphinx-quickstart prodhon vetëm te një drejtori e zbrazët. Ju lutemi, specifikoni një shteg rrënjë të ri." #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "Ndryshore e pavlefshme gjedheje: %s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "Titull i pavlefshëm: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "numri i specifikuar për rreshtin është jashtë intervali (1-%d): %r" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "S’mund të përdoren në të njëjtën kohë të dyja mundësitë \"%s\" \"%s\"" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "S’u gjet kartelë “include” %r, ose leximi i saj dështoi" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "Kodimi %r i përdorur për lexim të kartelës “include” %r duket të jetë i gabuar, provoni të jepni një mundësi :encoding:" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "Objekti i emërtuar %r s’u gjet te kartelë include %r" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Autor ndarjeje: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Autor moduli: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Autor kodi: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Autor: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "Mundësia \":file:\" për direktivë csv-table tani njeh një shteg absolut si shteg relativ prej drejtorisë burim. Ju lutemi, përditësoni dokumentin tuaj." #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "Deklarim C i përsëdytur, përkufizuar edhe te %s:%s.\nDeklarimi është '.. c:%s:: %s'." #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "%s (C %s)" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametra" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Kthime" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Lloj kthimi" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "anëtar" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "ndryshore" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funksion" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "makro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "bashkim" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "lloj" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "parametër funksioni" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Të reja në versionin %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Ndryshuar në versionin %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Nxjerrë nga përdorimi që me versionin %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "citim i përsëdytur %s, tjetër instancë te %s" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "Përmendja [%s] s’është në referencë." #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "Deklarim C++ i përsëdytur, përkufizuar edhe te %s:%s.\nDeklarimi është '.. cpp:%s:: %s'." #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Parametra Gjedhesh" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "klasë" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "koncept" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "parametër gjedheje" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (funksion i brendshëm)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (metodë %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (klasë)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s ( ndryshore globale ose konstante)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (atribut %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argumente" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modul)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "metodë" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "të dhëna" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "atribut" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modul" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "përshkrim %s i përsëdytur i %s, tjetër %s në %s" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "etiketë e përsëdytur ekuacioni %s, instancë tjetër te %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "math_eqref_format i pavlefshëm: %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "fjalëkyç" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operator" #: sphinx/domains/python.py:61 msgid "object" msgstr "objekt" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "përjashtim" #: sphinx/domains/python.py:63 msgid "statement" msgstr "deklarim" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "funksion i brendshëm" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Ndryshore" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (te moduli %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (te moduli %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (ndryshore e brendshme)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (klasë e brendshme)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (klasë te %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (metodë klase %s)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "%s (veti %s)" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (metodë statike %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Tregues Modulesh Python" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "module" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Nxjerrë nga përdorimi" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "metodë klase" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "metodë statike" #: sphinx/domains/python.py:1176 msgid "property" msgstr "veti" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "përshkrim i përsëdytur objekti për %s, instancë tjetër te %s, përdorni :noindex: për një prej tyre" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "për ndërreferencën %r u gjet më shumë se një objektiv: %s" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (nxjerrë nga përdorimi)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (direktivë)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr ":%s: (mundësi direktive)" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (rol)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "direktivë" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "rol" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "përshkrim i përsëdytur %s %s, instancë tjetër te %s" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "ndryshore mjedisi; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "Përshkrim i keqformuar mundësie %r, duhet të duket si \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" ose \"+opt args\"" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "Mundësi për rresht urdhrash %s" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "mundësi për rresht urdhrash" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "termi i fjalorthit duhet të paraprihet nga një rresht i zbrazët" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "termat e fjalorthit s’duhet të paraprihet nga rreshta të zbrazët" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "fjalorthi duket të jetë i keformatuar, kontrolloni shmangie kryeradhe" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "term fjalorthi" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "etiketë reference" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "ndryshore mjedisi" #: sphinx/domains/std.py:568 msgid "program option" msgstr "mundësi programi" #: sphinx/domains/std.py:569 msgid "document" msgstr "dokument" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Tregues Modulesh" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Faqe Kërkimesh" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "etiketë %s e përsëdytur, tjetër instancë te %s" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "përshkrim %s i përsëdytur për %s, tjetër instancë te %s" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "numfig është i çaktivizuar. :numref: është shpërfillur." #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "S’u arrit të krijohej një ndërreferencë. S’u caktua ndonjë numër: %s" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "lidhja s’ka titull: %s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "numfig_format i pavlefshëm: %s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "numfig_format i pavlefshëm: %s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "etiketë e papërcaktuar: %s" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "S’u arrit të krijohej një ndërreferencë. S’u gjet titull ose legjendë: %s" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "formësim i ri" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "formësimi ndryshoi" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "zgjerimet u ndryshuan" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "version jo i tanishëm i mjedisit të montimit" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "drejtoria burim ka ndryshuar" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "Ky mjedis është i papërputhshëm me montuesin e përzgjedhur, ju lutemi, zgjidhni një tjetër drejtori doctree." #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "S’u arrit të skanohen dokumente te %s: %r" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "Përkatësia %r s’është e regjistruar" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "U gjet “toctree” që i referohet vetes. U shpërfill." #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "dokumenti s’është i përfshirë në ndonjë toctree" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "shihni %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "shihni edhe %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "lloj i panjohur zëri treguesi: %r" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Simbole" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "u pikasën referenca rrethore toctree-je, po shpërfllen: %s <- %s" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "toctree përmban referencë ndaj dokumenti %r që s’ka titull: s’do të prodhohet ndonjë lidhje" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "toctree përmban referencë ndaj dokumenti %r të përjashtuar" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "toctree përmban referencë ndaj dokumenti %r që s’ekziston" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "kartelë figure jo e lexueshme: %s" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "kartelë figure %s jo e lexueshme: %s" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "kartelë shkarkimi jo e lexueshme: %s" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "Do të krijonte kartelë %s." #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "\nShih në mënyrë rekursive te <MODULE_PATH> për module dhe\npaketa Python dhe krijo një kartelë reST me direktiva\nautomodulesh për paketë te <OUTPUT_PATH>.\n\n<EXCLUDE_PATTERN>s mund të jetë shprehje kartelash dhe/ose\ndrejtorish që mund të përjashtohen nga prodhimi.\n\nShënim: Si parazgjedhje, ky programth s’do të anashkalojë\nkartela të krijuara tashmë." #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "shteg për te modul për te dokumenti" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "kartelë fnmatch-style dhe/ose rregullsi drejtorish për t’u përjashtuar prej prodhimit" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "drejtori ku të vendosen krejt përfundimet" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "thellësi maksimum nënmodulesh për shfaqje te TEL (parazgjedhje: 4)" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "mbishkruaj kartela ekzistuese" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "ndiq lidhje simbolike. E fuqishme, kur ndërthuret me collective.recipe.omelette." #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "xhiroje programthin pa krijuar kartela" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "vendose dokumentim për çdo modul në faqe më vete" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "përfshi modulet \"_private\"" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "emër kartele për tryezën e lëndës (parazgjedhje: modules)" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "mos krijo një kartelë tryeze lënde" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "mos krijo krye për paketat modul/paketë (për shembull, kur ato i përmban tashmë docstrings)" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "vendose dokumentimin e modulit përpara dokumentimit të nënmodulit" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "interpreto shtigje modulesh sipas specifikimeve impicite PEP-0420 për emërhapësira" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "prapashtesë kartele (parazgjedhje: rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "prodho me sphinx-quickstart një projekt të plotë" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "shto module_path pas sys.path, e përdorur kur është dhënë --full" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "emër projekti (parazgjedhje: emër moduli rrënjë)" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "autor(ë) projekti, e përdorur kur është dhënë --full" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "version projekti, e përdorur kur është dhënë --full" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "hedhje në qarkullim e projektit, e përdorur kur është dhënë --full, si parazgjedhje merr --doc-version" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "mundësi zgjatimi" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s s’është drejtori." #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "shprehje e rregullt e pavlefshme %r te %s" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "Testimi i mbulimit te burimet përfundoi, shihni te përfundimet në %(outdir)spython.txt." #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "shprehje e rregullt %r e pavlefshme te coverage_c_regexes" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "API C e padokumentuar: %s [%s] te kartela %s" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "moduli %s s’u importua dot: %s" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "funksion python i padokumentuar: %s :: %s" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "klasë python e padokumentuar: %s :: %s" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "metodë python e padokumentuar: %s :: %s :: %s" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "mungon '+' ose '-' te mundësia '%s'." #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "'%s' s’është mundësi e vlefshme." #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "'%s' s’është mundësi pyversion e vlefshme" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "lloj TestCode i pavlefshëm" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "Testimi i doctests-eve te burimet përfundoi, shihni te përfundimet në %(outdir)s/output.txt." #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "s’ka kod/dhënie te blloku %s në %s:%s" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "po shpërfillet kod “doctest” i pavlefshëm: %r" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "=================== kohëzgjatjet më të ngadalta të leximit ===================" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "Një direktivë Graphviz s’mund të ketë edhe lëndë, edhe argument emri kartelash" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "S’u gjet kartelë e jashtme Graphviz %r, ose dështoi leximi i saj" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "Po shpërfillet direktivë “graphviz” pa lëndë." #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot s’prodhoi kartelë përfundim:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "urdhri dot %r s’mund të xhirohet (i nevojshëm për çka prodhon graphviz), kontrolloni rregullimin graphviz_dot" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot përfundoi me gabim:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "graphviz_output_format duhet të jetë një nga 'png', 'svg', por është %r" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "kod dot %r: %s" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[grafik: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[grafik]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "s’mund të xhirohet urdhër shndërrimi %r, kontrolloni rregullimin image_converter: %s" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "shndërrimi përfundoi me gabimin:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "s’mund të xhirohet urdhër shndërrimi %r, kontrolloni rregullimin image_converter" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "Urdhri LaTeX %r s’mund të xhirohet (i nevojshëm për shfaqje formulash matematikore), kontrolloni rregullimin imgmath_late" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "Urdhri %s %r s’mund të xhirohet (i nevojshëm për shfaqje formulash matematikore), kontrolloni rregullimin imgmath_%s" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "shfaq latex %r: %s" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "latex brendazi %r: %s" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Permalidhje te ky ekuacion" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "inventari intersphinx është lëvizur: %s -> %s" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "po ngarkohet inventari intersphinx prej %s…" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "u hasën disa probleme me disa nga inventare, por kishin alternativa funksionale:" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "s’u arrit të kapej ndonjë inventar me problemet vijuese:" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(te %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(te %s)" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "identifikuesi intersphinx %r s’është varg. U shpërfill" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "S’u arrit të lexohej intersphinx_mapping[%s], u shpërfill: %r" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[burim]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Për T’u Bërë" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "U gjet zë Për T’u Bërë: %s" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<zëri origjinal>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(<<original entry>> gjendet te %s, rreshti %d.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "zëri origjinal" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "po theksohet kod moduli… " #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[dokumente]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Kod moduli" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Kod burim për %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Përmbledhje: kod moduli" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Krejt modulet për të cilët ka kod të gatshëm</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "vlerë e pavlefshme mundësie për member-order: %s" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "vlerë e pavlefshme për mundësinë class-doc-from: %s" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "nënshkrim i pavlefshëm për auto%s (%r)" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "gabim gjatë formatimi argumentesh për %s: %s" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "atribut %s që mungon te objekt %s" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "autodoc: s’u arrit të përcaktohet %r për dokumentim, u shfaq përjashtimi vijues:\n%s" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "s’dihet cili modul të importohet për vetëdokumentim të %r (provoni të vendosni te dokumenti një direktivë \"module\" ose \"currentmodule\", ose të jepni shprehimisht një emër moduli)" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "gabim gjatë formatimi nënshkrimesh për %s: %s" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "\"::\" në emër automoduli nuk ka kuptim" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "__all__ should duhet të jetë një listë vargjesh, jo %r (në module %s) -- ignoring __all__" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "u përmend atribut që mungon në :members: mundësi: modul %s, atributi %s" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "S’u arrit të merret një nënshkrim funksioni për %s: %s" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "S’u arrit të merrej nënshkrim konstruktori për %s: %s" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "Baza: %s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "alias për %s" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "alias për TypeVar(%s)" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "S’u arrit të merre një nënshkrim metode për %s: %s" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "U gjet __slots__ i pavlefshëm në %s. U shpërfill." #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "autodoc_member_order tani pranon \"alphabetical\", në vend se \"alphabetic\". Ju lutemi, përditësoni rregullimin tuaj." #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "S’u arrit të përtypej një vlerë parazgjedhje argumenti për %r: %s" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "S’u arrit të përditësohet nënshkrim për %r: s’u gjet parametër: %s" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "S’u arrit të përtypet type_comment për %r: %s" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "referenca vetëpërmbledhjeje përjashtuan dokumentin %r. U shpërfill." #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "vetëpërmbledhje: s’u gjet kartelë stub %r. Kontrolloni rregullimin tuaj autosummary_generate." #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "vetëpërmbledhje: s’u arrit të importohej %s" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "s’u arrit të përtypej emri %s" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "s’u arrit të importohej objekti %s" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: s’u gjet kartelë: %s" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "vetëpërmbledhja prodhon së brendshmi kartela .rst. Por source_suffix juaj s’përmban .rst. U anashkalua." #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "vetëpërmbledhje: s’u arrit të përcaktohet %r për t’u dokumentuar, u shfaq përjashtimi vijues:\n%s" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[vetëpërmbledhje] prodhim vetëpërmbledhje për: %s" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "[vetëpërmbledhje] po shkruhet te %s" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "[vetëpërmbledhje] s’u arrit të importohej %r: %s" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "\nProdhoni ReStructuredText duke përdorur direktiva vetëpërmbledhje.\n\nsphinx-autogen është një ndërfaqe pamore për sphinx.ext.autosummary.generate. Prodhon\nkartela reStructuredText nga direktiva vetëpërmbledhjeje që përmbahen te\nkartelat e dhëna.\n\nFormati i direktivës vetëpërmbledhje dokumentohet te\nmoduli Python ``sphinx.ext.autosummary`` dhe mund të lexohet duke përdorur::\n\n pydoc sphinx.ext.autosummary\n" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "kartela burim për të cilat të krijohen kartela rST" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "drejtori ku të vendosen krejt përfundimet" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "prapashtesë parazgjedhje për kartela (parazgjedhje: %(default)s)" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "drejtori gjedhesh vetjake (parazgjedhje: %(default)s)" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "pjesë të importuara të dokumentit (parazgjedhje: %(default)s)" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "Argumente Fjalëkyçi" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "Shembull" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Shembuj" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "Shënime" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "Parametra të Tjerë" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "Referenca" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "Sinjalizime" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "u caktua vlerë e pavlefshme (mungon kllapë mbyllëse): %s" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "u caktua vlerë e pavlefshme (mungon kllapë hapëse): %s" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "shprehje vargu e keqformuar (mungon thonjëz mbyllëse): %s" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "shprehje vargu e keqformuar (mungon thonjëz hapëse): %s" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Vëmendje" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Kujdes" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Rrezik" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Gabim" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Ndihmëz" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "E rëndësishme" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Shënim" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Shihni edhe" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Ndihmëz" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Sinjalizim" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "vazhduar nga faqja e mëparshme" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "vazhdon në faqen pasuese" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "Joalfabetike" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "Numra" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "faqe" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "Tryeza e Lëndës" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Kērko" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Shko" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Shfaq Burimin" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Përmbledhje" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Mirë se vini! Ky është" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "dokumentimi për" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "përditësuar së fundi më" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Tregues dhe tabela:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Tryezë e Plotë e Lëndës" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "paraqet krejt ndarjet dhe nënndarjet" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "kërkoni te ky dokumentim" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Tregues Global Modulesh" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "hyrje e shpejtë te krejt modulet" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "krejt funksionet, klasat, termat" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Tregues – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Tregues i plotë në një faqe" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Faqe treguesi sipas shkronjash" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "mund të jetë i stërmadh" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Lëvizje" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Kërkoni brenda %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Mbi këto dokumente" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Të drejta kopjimi" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Të drejta kopjimi</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Të drejta kopjimi %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Përditësuar së fundi më %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "Krijuar duke përdorur <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s." #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Kërkoni te %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Subjekti i mëparshëm" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "kapitulli i mëparshëm" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Subjekti pasues" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "kapitulli pasues" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Që të aktivizohet funksioni i kërkimit, ju lutemi, aktivizoni\n JavaScript-in." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "Kërkimi për disa fjalë njëherësh shfaq vetëm përputhje që\n përmbajnë krejt fjalët." #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "kërko" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Përfundime Kërkimi" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Kërkimi juaj s’gjeti përputhje me ndonjë dokument. Ju lutemi, sigurohuni se janë shkruar saktë krejt fjalët dhe se keni përzgjedhur aq kategori sa duhen." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Kërkim i shpejtë" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Kjo Faqe" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Ndryshe në Versionin %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Listë ndryshime në versionin %(version)s e prodhuar automatikisht" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Ndryshime librarie" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Ndryshime API C" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Ndryshime të tjera" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Permalidhje te ky titull" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Permalidhje për te ky përkufizim" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Fshih Përputhje Kërkimi" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Kërkim" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Po përgatitet kërkim..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Kërkimi përfundoi, u gjetën %s page(s) me përputhje me shprehjen e kërkuar." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", në " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Zgjeroje anështyllën" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Tkurre anështyllën" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Lëndë" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "U gjet tregues me bazë 4 shtylla. Mund të jetë një e metë e zgjerimeve që përdorni: %r" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "Poshtëshënimi [%s] s’është në referencë." #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "Poshtëshënimi [#] s’është në referencë." #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "referenca pa njëtrajtësi, te fundfaqe në mesazhin e përkthyer. origjinali: {0}, përkthimi: {1}" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "referenca pa njëtrajtësi, te mesazhi i përkthyer. origjinali: {0}, përkthimi: {1}" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "referenca citimi pa njëtrajtësi, te fundfaqe në mesazhin e përkthyer. origjinali: {0}, përkthimi: {1}" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "referenca citimi pa njëtrajtësi, te mesazhi i përkthyer. origjinali: {0}, përkthimi: {1}" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "u gjet më shumë se një objektiv për ndërreferencën 'any' %r: mund të ishte %s" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "s’u gjet objektiv reference %s:%s: %s" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "s’u gjet objektiv reference %r: %s" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "S’u pru dot figurë e largët: %s [%d]" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "S’u soll dot figurë e largët: %s [%s]" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "Format i panjohur figure: %s…" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "shenja burimi të padeshifrueshme, po zëvendësohen me \"?\": %r" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "e anashkaluar" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "e dështuar" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "emër direktive ose roli të panjohur: %s:%s" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "gabim leximi: %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "gabim shkrimi: %s, %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "locale_dir %s s’ekziston" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "Format i pavlefshëm datash. Quote the string by single quote Nëse doni të jepet drejtpërsëdrejti, përdorni për vargun thonjëza njëshe: %s" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "“toctree” përmban referencë për te një kartelë joekzistuese %r" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "përjashtim teksa vlerësohej vetëm shprehje direktive: %s" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "s’u gjet rol parazgjedhje %s" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "numfig_format s’është i përcaktuar për %s" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "Çfarëdo ID-sh jo të përshoqëruara për nyjën %s" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "Permalidhje për te ky term" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Permalidhje te kjo tabelë" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Permalidhje te ky kod" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Permalidhje te kjo figurë" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Permalidhje te kjo toctree" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "S’u mor dot madhësi figure. Mundësia :scale: u shpërfill." #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "toplevel_sectioning %r i panjohur për klasën %r" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr ":maxdepth: shumë i madh, u shpërfill." #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "titulli i dokumentit s’është nyje njëshe Teksti" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "u has nyje titulli jo në ndarje, temë, tabelë, paralajmërim ose anështyllë" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Poshtëshënime" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "janë dhënë që të dyja mundësitë, “tabularcolumns” dhe “:widths:”. shpërfillet :widths:." #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "njësia e përmasave %s është e pavlefshme. U shpërfill." #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "u gjet lloj i panjohur %s zërash treguesi" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[figurë: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[figurë]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "titull jo brenda një figure." #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "lloj nyjeje i pasendërtuar: %r" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "lloj i panjohur nyjeje: %r" �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3312986 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015527� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5065742 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017314� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000010213�00000000000�021160� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "sr", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": ", \u0443 ", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "\u0418\u0437\u043c\u0435\u043d\u0435 \u0443 \u0432\u0435\u0440\u0437\u0438\u0458\u0438 %(version)s — %(docstitle)s", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "\u0421\u0430\u0434\u0440\u0436\u0430\u0458", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "\u0422\u0440\u0430\u0436\u0438", "Hide Search Matches": "", "Index": "\u0418\u043d\u0434\u0435\u043a\u0441", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "\u0418\u0437\u043c\u0435\u043d\u0435 \u0443 \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u0446\u0438", "Navigation": "\u041d\u0430\u0432\u0438\u0433\u0430\u0446\u0438\u0458\u0430", "Next topic": "\u0421\u043b\u0435\u0434\u0435\u045b\u0438 \u043e\u0434\u0435\u0459\u0430\u043a", "Other changes": "\u0414\u0440\u0443\u0433\u0435 \u0438\u0437\u043c\u0435\u043d\u0435", "Overview": "\u041f\u0440\u0435\u0433\u043b\u0435\u0434", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "\u041f\u0440\u0438\u043f\u0440\u0435\u043c\u0430 \u043f\u0440\u0435\u0442\u0440\u0430\u0433\u0435...", "Previous topic": "\u041f\u0440\u0435\u0442\u0445\u043e\u0434\u043d\u0438 \u043e\u0434\u0435\u0459\u0430\u043a", "Quick search": "\u0411\u0440\u0437\u0430 \u043f\u0440\u0435\u0442\u0440\u0430\u0433\u0430", "Search": "\u041f\u0440\u0435\u0442\u0440\u0430\u0433\u0430", "Search Page": "", "Search Results": "\u0420\u0435\u0437\u0443\u043b\u0442\u0430\u0442\u0438 \u043f\u0440\u0435\u0442\u0440\u0430\u0433\u0435", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "\u041f\u0440\u0435\u0442\u0440\u0430\u0436\u0443\u0458\u0435 \u0441\u0435", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "\u0418\u0437\u0432\u043e\u0440\u043d\u0438 \u043a\u043e\u0434", "Table of Contents": "\u0421\u0430\u0434\u0440\u0436\u0430\u0458", "This Page": "\u041e\u0432\u0430 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0430", "Welcome! This is": "\u0414\u043e\u0431\u0440\u043e \u0434\u043e\u0448\u043b\u0438! \u041e\u0432\u043e \u0458\u0435", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "\u043f\u043e\u0441\u043b\u0435\u0434\u045a\u0430 \u0438\u0437\u043c\u0435\u043d\u0430", "lists all sections and subsections": "", "next chapter": "\u043d\u0430\u0440\u0435\u0434\u043d\u0430 \u0433\u043b\u0430\u0432\u0430", "previous chapter": "\u043f\u0440\u0435\u0442\u0445\u043e\u0434\u043d\u0430 \u0433\u043b\u0430\u0432\u0430", "quick access to all modules": "", "search": "\u0442\u0440\u0430\u0436\u0438", "search this documentation": "", "the documentation for": "\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0458\u0430" }, "plural_expr": "(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)" });�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000022300�00000000000�021157� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������L ��r���M ����� ��"��� �� ��� ����� ����� ����� �� ��� �����+ �����? �����V �� ���g ����� �� ��� ����� ����� ����� ����� �� ��� ����� �� ��� �����, �����4 �����: �� ���V �� ���` �����j �����y ��!��� ����� ��4��� �� ��� ����� �� ��� ����� �����- �����3 �����L �����T �����] �����e �����h �� ���m �����w �����} �� ��� ����� �� ��� �� ��� ����� �� ��� ����� ����� ����� �� ��� ����� ����� �� ��� �����' �����; �����J �� ���[ �����h �����x �� ��� ����� �� ��� ����� ����� ����� ����� �� ��� �� ��� ����� �� ������>��� �����K�����^�����f�����o��"����� �����W������������� �� ��������0�� ���G�����Q�����Y�����_�����p�� ���w����������������� ����� ��������������� �����4�������������3�����J�����]�� ���u���������������������� ����� ������������������������������ ��������#�����A�����H�����O�����W�� ���\�����i�����p�����y�����~������������ �������������������� ���������� ����� ����� �������������1�����6�����M�����V�����_����r����������i��"���o�� ���������� ���������� ����� �����*��������2��D���H������������!����������'�����(��������?�����Q�� ���k�����w�������!���������� ���������� �����9�����%���&��@���L�����������������8����� �����'��� �� ���3�����@�����O�� ���X�����c�� ���r�� ���}��$�������������������������!��������$�����@�����O�����^�����m�������#����������$������������������,�����D�����b������� �������������������������#��������%�����?�����O�����i��c�����,������������������/��*���>�����i������� ���&�����1��2���:��#���m�����������������"������������� �� ��������*��&���B�����i�����x��!����� ����������f�����9���< ��3���v ��%��� ��;��� ����� !�����!�����0!�� ���L!��)���Y!�����!�����!��?���!�����!�����"�� ���"�����"�����3"��*���Q"�� ���|"�� ���"�� ���"�� ���"�����"�����"�����"�� ���"��)���"�� ���#�����*#�����H#�����`#�� ���~#�����#��$���#��,���#�����#�����$����� $�����/$�����J$��%���Q$�����w$�����$�����$��� Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� (in �%(filename)s — %(docstitle)s�%b %d, %Y�%s %s�%s %s documentation�%s (%s attribute)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�(in %s v%s)�(in %s)�, in �<h1>Source code for %s</h1>�Arguments�Attention�Author name(s)�Author: �Cannot find source directory (%s)�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Code author: �Contents�Deprecated�Deprecated since version %s�Error�Event %r already present�Example�Examples�Fig. %s�Go�Hint�Important�Index�Library changes�Listing %s�Module author: �Module code�Navigation�New in version %s�Next topic�Note�Notes�Numbers�Other changes�Overview�Overview: module code�Parameters�Preparing search...�Previous topic�Project language�Project name�Project release�Project version�Quick search�Release�Return type�Returns�Running Sphinx v%s�Search�Search Results�Searching�Section %s�Section author: �Show Source�Source directory and destination directory cannot be identical�Source file suffix�Symbols�Table %s�Table of Contents�The LaTeX files are in %(outdir)s.�This Page�This project needs at least Sphinx v%s and therefore cannot be built with this version.�Tip�Todo�Translator for %r already exists�Unknown event name: %s�Variables�Warning�Warns�Welcome! This is�[docs]�[image: %s]�[image]�[source]�all source files�attribute�author names�built-in function�class�class method�config directory doesn't contain a conf.py file (%s)�continued from previous page�continues on next page�copying images... �copying source files...�directive�document�document language�done�environment variable; %s�exception�failed: %s�file suffix (default: rst)�finished with problems�function�index�keyword�last updated�loading translations [%s]... �method�module�modules�next�next chapter�object�operator�page�preparing documents�previous�previous chapter�project name�release of project�search�see %s�see also %s�source file suffix�statement�static method�succeeded�the documentation for�type�updating environment: �use epub�variable�version of project�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: sr Language-Team: Serbian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr/) Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � Покрените 'make' у том директоријуму да бисте их пропустили кроз (pdf)latex (или употребите `make latexpdf' овде да се то одради аутоматски).� (у �%(filename)s — %(docstitle)s�%b %d, %Y�%s %s�документација %s %s�%s (атрибут %s)�%s (C++ %s)�%s (уграђена класа)�%s (уграђена променљива)�%s (класа у %s)�%s (глобална променљива или константа)�%s (у модулу %s)�%s (модул)�%s() (метода класе %s)�%s() (%s метода)�%s() (статичка метода %s)�%s() (уграђена функција)�%s() (класа)�%s() (у модулу %s)�(у %s v%s)�(у %s)�, у �<h1>Изворни код %s</h1>�Аргументи�Пажња�Име(на) аутора�Аутор: �Нема изворног директоријума (%s)�Измењено у верзији %s�Измене у верзији %(version)s — %(docstitle)s�Аутор кода: �Садржај�Застарело�Застарело почевши од верзије %s�Грешка�Догађај %r већ постоји�Пример�Примери�Сл. %s�Тражи�Путоказ�Важно�Индекс�Измене у библиотеци�Списак %s�Аутор модула: �Код модула�Навигација�Додато у верзији %s�Следећи одељак�Белешка�Белешке�Бројеви�Друге измене�Преглед�Преглед: код модула�Параметри�Припрема претраге...�Претходни одељак�Језик пројекта�Име пројекта�Издање пројекта�Верзија пројекта�Брза претрага�Издање�Тип резултата�Резултат�Покрећем Sphinx v%s�Претрага�Резултати претраге�Претражује се�Одељак %s�Аутор одељка: �Изворни код�Изворни и одредишни директоријум не могу бити једнаки�Суфикс изворне датотеке�Симболи�Табела %s�Садржај�LaTeX датотеке су у %(outdir)s.�Ова страница�Овај пројекат захтева верзију Sphinx v%s или већу, не може се изградити инсталираном верзијом.�Савет�План�Преводилац за %r већ постоји�Непознат догађај: %s�Променљиве�Упозорење�Упозорења�Добро дошли! Ово је�[документација]�[слика: %s]�[слика]�[изворни код]�све изворне датотеке�атрибут�имена аутора�уграђена функција�класа�метода класе�Конфигурациони директоријум не садржи conf.py датотеку (%s).�настављено са претходне стране�наставак на следећој страни�пребацивање слика... �пребацивање изворних датотека...�директива�документ�језик пројекта�готово�променљива окружења; %s�изузетак�Неуспешно: %s�суфикс датотеке (подразумевани: rst)�са грешкама�функција�индекс�кључна реч�последња измена�учитавање превода [%s]... �метода�модул�модули�напред�наредна глава�објекат�оператор�страна�припремање докумената�назад�претходна глава�име пројекта�издање пројекта�тражи�погледајте %s�такође погледајте %s�суфикс изворне датотеке�наредба�статичка метода�успешно�документација�тип�ажурирање окружења: �користи epub�променљива�верзија пројекта���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000251575�00000000000�021204� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Risto Pejasinovic <risto.pejasinovic@gmail.com>, 2019 # Vladimir Milovanović <vmilovanovic@gmail.com>, 2020 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Serbian (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: sr\n" "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Нема изворног директоријума (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Изворни и одредишни директоријум не могу бити једнаки" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Покрећем Sphinx v%s" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Овај пројекат захтева верзију Sphinx v%s или већу, не може се изградити инсталираном верзијом." #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "учитавање превода [%s]... " #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "готово" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "Неуспешно: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "успешно" #: sphinx/application.py:349 msgid "finished with problems" msgstr "са грешкама" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "Конфигурациони директоријум не садржи conf.py датотеку (%s)." #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Одељак %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Сл. %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Табела %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Списак %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "Догађај %r већ постоји" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Непознат догађај: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "Преводилац за %r већ постоји" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "све изворне датотеке" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "ажурирање окружења: " #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "припремање докумената" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "пребацивање слика... " #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "пребацивање изворних датотека..." #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (у " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "индекс" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "напред" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "назад" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "документација %s %s" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "LaTeX датотеке су у %(outdir)s." #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\nПокрените 'make' у том директоријуму да бисте их пропустили кроз (pdf)latex\n(или употребите `make latexpdf' овде да се то одради аутоматски)." #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Индекс" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Издање" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "Име пројекта" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "Име(на) аутора" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "Верзија пројекта" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "Издање пројекта" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "Језик пројекта" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "Суфикс изворне датотеке" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "име пројекта" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "имена аутора" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "верзија пројекта" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "издање пројекта" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "језик пројекта" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "суфикс изворне датотеке" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "користи epub" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Аутор одељка: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Аутор модула: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Аутор кода: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Аутор: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Параметри" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Резултат" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Тип резултата" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "променљива" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "функција" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "тип" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Додато у верзији %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Измењено у верзији %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Застарело почевши од верзије %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "класа" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (уграђена функција)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s метода)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (класа)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (глобална променљива или константа)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (атрибут %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Аргументи" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (модул)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "метода" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "атрибут" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "модул" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "кључна реч" #: sphinx/domains/python.py:60 msgid "operator" msgstr "оператор" #: sphinx/domains/python.py:61 msgid "object" msgstr "објекат" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "изузетак" #: sphinx/domains/python.py:63 msgid "statement" msgstr "наредба" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "уграђена функција" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Променљиве" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (у модулу %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (у модулу %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (уграђена променљива)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (уграђена класа)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (класа у %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (метода класе %s)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (статичка метода %s)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "модули" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Застарело" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "метода класе" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "статичка метода" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "директива" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "променљива окружења; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "документ" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "погледајте %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "такође погледајте %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Симболи" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "суфикс датотеке (подразумевани: rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(у %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(у %s)" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[изворни код]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "План" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[документација]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Код модула" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Изворни код %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Преглед: код модула" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "Пример" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Примери" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "Белешке" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "Упозорења" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Пажња" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Грешка" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Путоказ" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Важно" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Белешка" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Савет" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Упозорење" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "настављено са претходне стране" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "наставак на следећој страни" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "Бројеви" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "страна" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "Садржај" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Претрага" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Тражи" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Изворни код" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Преглед" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Добро дошли! Ово је" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "документација" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "последња измена" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Навигација" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Претходни одељак" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "претходна глава" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Следећи одељак" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "наредна глава" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "тражи" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Резултати претраге" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Брза претрага" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Ова страница" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Измене у верзији %(version)s — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Измене у библиотеци" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Друге измене" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Претражује се" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Припрема претраге..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", у " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Садржај" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[слика: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[слика]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �����������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3314805 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr@latin/����������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016657� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.507349 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr@latin/LC_MESSAGES/����������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�020444� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.js�������������������������������������������0000644�0000766�0000024�00000004715�00000000000�022322� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "sr", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)" });���������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.mo�������������������������������������������0000644�0000766�0000024�00000001121�00000000000�022305� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$���������������,���#��-����Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: sr@latin Language-Team: Serbian (Latin) (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr@latin/) Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr@latin/LC_MESSAGES/sphinx.po�������������������������������������������0000644�0000766�0000024�00000241564�00000000000�022331� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Serbian (Latin) (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr@latin/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: sr@latin\n" "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ��������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.331674 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr_RS/�������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016133� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.508143 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr_RS/LC_MESSAGES/�������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017720� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.js����������������������������������������������0000644�0000766�0000024�00000004725�00000000000�021577� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "sr_Cyrl_RS", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2)" });�������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.mo����������������������������������������������0000644�0000766�0000024�00000001114�00000000000�021563� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$���������������,�����-����Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: sr_RS Language-Team: Serbian (Serbia) (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr_RS/) Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sr_RS/LC_MESSAGES/sphinx.po����������������������������������������������0000644�0000766�0000024�00000241557�00000000000�021607� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Serbian (Serbia) (http://www.transifex.com/sphinx-doc/sphinx-1/language/sr_RS/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: sr_RS\n" "Plural-Forms: nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3318555 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sv/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015533� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5093224 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sv/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017320� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sv/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000006622�00000000000�021175� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "sv", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "Om dessa dokument", "Automatically generated list of changes in version %(version)s": "Automatiskt genererad lista \u00f6ver f\u00f6r\u00e4ndringar i version %(version)s", "C API changes": "F\u00f6r\u00e4ndringar i C-API", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "D\u00f6lj sidolist", "Complete Table of Contents": "Komplett Inneh\u00e5llsf\u00f6rteckning", "Contents": "Inneh\u00e5ll", "Copyright": "Copyright", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Expandera sidolist", "Full index on one page": "Hela inneh\u00e5llsf\u00f6rteckningen p\u00e5 en sida", "General Index": "Huvudindex", "Global Module Index": "Global Modulindex", "Go": "G\u00e5", "Hide Search Matches": "D\u00f6lj S\u00f6kresultat", "Index": "Index", "Index – %(key)s": "Index – %(key)s", "Index pages by letter": "Inneh\u00e5llsf\u00f6rteckning per inledande bokstav", "Indices and tables:": "Index och tabeller", "Last updated on %(last_updated)s.": "Senast uppdaterad %(last_updated)s.", "Library changes": "F\u00f6r\u00e4ndringar i bibliotek", "Navigation": "Navigation", "Next topic": "N\u00e4sta titel", "Other changes": "\u00d6vriga f\u00f6r\u00e4ndringar", "Overview": "\u00d6versikt", "Permalink to this definition": "Permalink till denna definition", "Permalink to this headline": "Permalink till denna rubrik", "Please activate JavaScript to enable the search\n functionality.": "Var god aktivera JavaScript f\u00f6r s\u00f6kfunktionalitet.", "Preparing search...": "", "Previous topic": "F\u00f6reg\u00e5ende titel", "Quick search": "Snabbs\u00f6k", "Search": "S\u00f6k", "Search Page": "S\u00f6ksida", "Search Results": "S\u00f6kresultat", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "S\u00f6k bland %(docstitle)s", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Visa k\u00e4llfil", "Table of Contents": "", "This Page": "Denna Sida", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "alla funktioner, klasser, villkor", "can be huge": "kan bli stort", "last updated": "", "lists all sections and subsections": "lista \u00f6ver alla paragrafer och underparagrafer", "next chapter": "N\u00e4sta kapitel", "previous chapter": "F\u00f6reg\u00e5ende kapitel", "quick access to all modules": "genv\u00e4g till alla moduler", "search": "s\u00f6k", "search this documentation": "s\u00f6k i det h\u00e4r dokumentet", "the documentation for": "" }, "plural_expr": "(n != 1)" });��������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sv/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000015262�00000000000�021174� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������\��������������������� ��������������������������������� �� ��� �����1 �� ���C �� ���O �����Y �����p ����� ����� �� ��� ����� ��0��� ����� ����� �� ���6 �� ���@ �����J ��>���S ����� �� ��� ����� ����� �� ��� ����� ����� ����� �� ��� ����� �� ��� �����& �����B �����H �� ���W �����a �� ���x ����� ����� ����� ����� �� ��� ����� ����� ����� ����� ��!��� �����( �� ���8 �����E �� ���U �� ���a �� ���n �����y �� ��� ����� �� ��� ����� ����� �� ��� ����� ����� ��B��� �����N ��$���] ����� �� ��� ����� ����� �� ��� ����� ����� ����� �� ��� ����� ����� ����������*�� ���3�� ���?�����I�����P�����T�� ���Y�����c�����k�����r�����z������� ���������� ���������� ��������������� ��������������� ���6�����@�� ���I�� ���W�����e�����k��"���s�������������������������������� �������������������������������������������/�����?�����D�����K�����e�� ���l�� ���x�� ����������������������d�� ���h�����r�����x����������������� �����#���������� ����� �������������.�����>�����V�� ���n�����{��)�������������������� ����� �����F��������M�����V�����m�����u����������������� ����� ����������������������� ����������!��)���*�� ���T�����_�����q�����u����������������������,����������#���������� ���0�����;�� ���L�� ���Z�� ���e�����p�� ����� ���������� ���������� ���������������4��������R��$���e������� �������������������� �������������������� ������������������%�� ���.�� ���<�����G�����N�� ���S�� ���]�����g�����o�����v�����~��!��������������� ���������� �����%�������� ���������������(�����;�����D�����M�����V�����g�� ���m��/���w���������������������������������������������������� �������� �� ��� �����.�����H�����X�����]�����b�����}�� ���������� ���������������� (in �%b %d, %Y�%s %s�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�About these documents�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Caution�Changed in version %s�Code author: �Collapse sidebar�Complete Table of Contents�Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Expand sidebar�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Overview: module code�Parameters�Permalink to this definition�Permalink to this headline�Please activate JavaScript to enable the search functionality.�Previous topic�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Release�Return type�Returns�Search�Search %(docstitle)s�Search Page�Search Results�Search within %(docstitle)s�Section author: �See also�Show Source�This Page�Throws�Tip�Todo�Variables�Warning�[docs]�[image]�[source]�all functions, classes, terms�attribute�built-in function�can be huge�class�class method�continued from previous page�data�directive�environment variable�environment variable; %s�exception�function�glossary term�grammar token�index�keyword�lists all sections and subsections�macro�member�method�module�modules�next�next chapter�object�operator�original entry�previous�previous chapter�program option�quick access to all modules�reference label�role�search�search this documentation�see %s�see also %s�statement�static method�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: sv Language-Team: Swedish (http://www.transifex.com/sphinx-doc/sphinx-1/language/sv/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �(i �%b %d, %Y�%s %s�%s (%s attribut)�%s (inbyggd klass)�%s (inbyggd variabel)�%s (klass i %s)�%s (direktiv)�%s (global variabel eller konstant)�%s (i modul %s)�%s (modul)�%s (roll)�%s() (%s klassmetod)�%s() (%s metod)�%s() (%s statisk metod)�%s() (inbyggd funktion)�%s() (klass)�%s() (i modul %s)�<h1>Alla moduler där källkod finns</h1>�<h1>Källkod för %s</h1>�Om dessa dokument�Argument�Uppmärksamma�Upphovsman:�Automatiskt genererad lista över förändringar i version %(version)s�Inbyggda�Förändringar i C-API�Varning�Förändrat i version %s�Källkodsförfattare�Dölj sidolist�Komplett Innehållsförteckning�Innehåll�Copyright�Risk�Ersatt�Ersatt sedan version %s�Fel�Expandera sidolist�Fotnoter�Hela innehållsförteckningen på en sida�Huvudindex�Global Modulindex�Gå�Dölj Sökresultat�Råd�Viktigt�Index�Index – %(key)s�Innehållsförteckning per inledande bokstav�Index och tabeller�Senast uppdaterad %(last_updated)s.�Förändringar i bibliotek�Modulindex�Modulförfattare�Modulkällkod�Modulnivå�Navigation�Nyheter i version %s�Nästa titel�Observera�Övriga förändringar�Översikt�Översikt: modulkällkod�Parametrar�Permalink till denna definition�Permalink till denna rubrik�Var god aktivera JavaScript för sökfunktionalitet.�Föregående titel�Python Enhancement Proposals; PEP %s�Python Modulindex�Snabbsök�Väcker�Utgåva�Returtyp�Returnerar�Sök�Sök %(docstitle)s�Söksida�Sökresultat�Sök bland %(docstitle)s�Sektionsförfattare�Se även�Visa källfil�Denna Sida�Kastar�Tips�Att göra�Variabler�Varning�[docs]�[image]�[source]�alla funktioner, klasser, villkor�attribut�inbyggda funktioner�kan bli stort�klass�klassmetod�fortsättning från föregående sida�data�direktiv�miljövariabel�miljövariabel; %s�undantag�funktion�ordlista�grammatisk token�index�nyckelord�lista över alla paragrafer och underparagrafer�makro�medlem�metod�modul�moduler�nästa�Nästa kapitel�objekt�operator�ursprungsvärde�föregående�Föregående kapitel�programväxel�genväg till alla moduler�referensetikett�roll�sök�sök i det här dokumentet�se %s�se även %s�uttryck�statisk metod�typ�variabel�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/sv/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000245335�00000000000�021205� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Swedish (http://www.transifex.com/sphinx-doc/sphinx-1/language/sv/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: sv\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Inbyggda" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Modulnivå" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "(i " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Huvudindex" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "index" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "nästa" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "föregående" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Index" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Utgåva" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Sektionsförfattare" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Modulförfattare" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Källkodsförfattare" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Upphovsman:" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametrar" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Returnerar" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Returtyp" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "medlem" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "variabel" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "funktion" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "makro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "typ" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Nyheter i version %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Förändrat i version %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Ersatt sedan version %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Kastar" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "klass" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (inbyggd funktion)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s metod)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (klass)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (global variabel eller konstant)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s attribut)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Argument" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modul)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "metod" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "data" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "attribut" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modul" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "nyckelord" #: sphinx/domains/python.py:60 msgid "operator" msgstr "operator" #: sphinx/domains/python.py:61 msgid "object" msgstr "objekt" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "undantag" #: sphinx/domains/python.py:63 msgid "statement" msgstr "uttryck" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "inbyggda funktioner" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Variabler" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Väcker" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (i modul %s)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (i modul %s)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (inbyggd variabel)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (inbyggd klass)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (klass i %s)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s klassmetod)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s statisk metod)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Python Modulindex" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "moduler" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Ersatt" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "klassmetod" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "statisk metod" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (direktiv)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (roll)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "direktiv" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "roll" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "miljövariabel; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "ordlista" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "grammatisk token" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "referensetikett" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "miljövariabel" #: sphinx/domains/std.py:568 msgid "program option" msgstr "programväxel" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Modulindex" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Söksida" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "se %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "se även %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[source]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Att göra" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "ursprungsvärde" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[docs]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Modulkällkod" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>Källkod för %s</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Översikt: modulkällkod" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Alla moduler där källkod finns</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Uppmärksamma" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Varning" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Risk" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Fel" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Råd" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Viktigt" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Observera" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Se även" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Tips" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Varning" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "fortsättning från föregående sida" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Sök" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Gå" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Visa källfil" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Översikt" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Index och tabeller" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Komplett Innehållsförteckning" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "lista över alla paragrafer och underparagrafer" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "sök i det här dokumentet" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Global Modulindex" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "genväg till alla moduler" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "alla funktioner, klasser, villkor" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Index – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Hela innehållsförteckningen på en sida" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Innehållsförteckning per inledande bokstav" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "kan bli stort" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Navigation" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Sök bland %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Om dessa dokument" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Copyright" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Senast uppdaterad %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Sök %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Föregående titel" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "Föregående kapitel" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Nästa titel" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "Nästa kapitel" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Var god aktivera JavaScript för sökfunktionalitet." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "sök" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Sökresultat" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Snabbsök" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Denna Sida" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Automatiskt genererad lista över förändringar i version %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Förändringar i bibliotek" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "Förändringar i C-API" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Övriga förändringar" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Permalink till denna rubrik" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Permalink till denna definition" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Dölj Sökresultat" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Expandera sidolist" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Dölj sidolist" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Innehåll" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Fotnoter" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[image]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3320343 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ta/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015507� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5101743 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ta/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017274� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ta/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000004603�00000000000�021146� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "ta", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n != 1)" });�����������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ta/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000001167�00000000000�021147� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������4���������������L������M������V�����[���D��������d���%d found�next�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: ta Language-Team: Tamil (http://www.transifex.com/sphinx-doc/sphinx-1/language/ta/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �%d கண்டு ப்பிடித்த விட்டது�அடுத்த����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ta/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000241637�00000000000�021162� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Julien Malard <julien.malard@mail.mcgill.ca>, 2019 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Tamil (http://www.transifex.com/sphinx-doc/sphinx-1/language/ta/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: ta\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "%d கண்டு ப்பிடித்த விட்டது" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "அடுத்த" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3322163 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/te/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015513� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5109608 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/te/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017300� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/te/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000004603�00000000000�021152� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "te", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n != 1)" });�����������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/te/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000000762�00000000000�021153� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$���������������,�����-����Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: te Language-Team: Telugu (http://www.transifex.com/sphinx-doc/sphinx-1/language/te/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 ���������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/te/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000241425�00000000000�021161� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Telugu (http://www.transifex.com/sphinx-doc/sphinx-1/language/te/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: te\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3323948 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/tr/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015530� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.511812 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/tr/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017315� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/tr/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000010405�00000000000�021164� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "tr", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">Telif hakk\u0131</a> %(copyright)s.", "© Copyright %(copyright)s.": "© Telif hakk\u0131 %(copyright)s.", ", in ": ", \u015funun i\u00e7inde:", "About these documents": "Bu belgeler hakk\u0131nda", "Automatically generated list of changes in version %(version)s": "%(version)s s\u00fcr\u00fcm\u00fcndeki de\u011fi\u015fikliklerin otomatik olarak \u00fcretilmi\u015f listesi", "C API changes": "C API'sindeki de\u011fi\u015fiklikler", "Changes in Version %(version)s — %(docstitle)s": "S\u00fcr\u00fcm %(version)s — %(docstitle)s i\u00e7indeki De\u011fi\u015fiklikler", "Collapse sidebar": "Yan \u00e7ubu\u011fu daralt", "Complete Table of Contents": "Tam \u0130\u00e7indekiler", "Contents": "\u0130\u00e7indekiler", "Copyright": "Telif hakk\u0131", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "Yan \u00e7ubu\u011fu geni\u015flet", "Full index on one page": "Tek sayfada tam dizin", "General Index": "Genel Dizin", "Global Module Index": "Genel Mod\u00fcl Dizini", "Go": "Git", "Hide Search Matches": "Arama E\u015fle\u015fmelerini Gizle", "Index": "Dizin", "Index – %(key)s": "Dizin – %(key)s", "Index pages by letter": "Harfe g\u00f6re dizin sayfalar\u0131", "Indices and tables:": "Dizinler ve tablolar:", "Last updated on %(last_updated)s.": "Son g\u00fcncelleme: %(last_updated)s.", "Library changes": "K\u00fct\u00fcphane de\u011fi\u015fiklikleri", "Navigation": "Gezinti", "Next topic": "Sonraki konu", "Other changes": "Di\u011fer de\u011fi\u015fiklikler", "Overview": "Genel Bak\u0131\u015f", "Permalink to this definition": "Bu tan\u0131m i\u00e7in kal\u0131c\u0131 ba\u011flant\u0131", "Permalink to this headline": "Bu ba\u015fl\u0131k i\u00e7in kal\u0131c\u0131 ba\u011flant\u0131", "Please activate JavaScript to enable the search\n functionality.": "Arama i\u015flevini kullanabilmek i\u00e7in l\u00fctfen JavaScript'i\n etkinle\u015ftirin.", "Preparing search...": "Aramaya haz\u0131rlan\u0131yor...", "Previous topic": "\u00d6nceki konu", "Quick search": "H\u0131zl\u0131 Arama", "Search": "Ara", "Search Page": "Arama Sayfas\u0131", "Search Results": "Arama Sonu\u00e7lar\u0131", "Search finished, found %s page(s) matching the search query.": "Arama tamamland\u0131. Sorguyu i\u00e7eren %s sayfa bulundu.", "Search within %(docstitle)s": "%(docstitle)s i\u00e7inde ara", "Searching": "Aran\u0131yor", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Kayna\u011f\u0131 G\u00f6ster", "Table of Contents": "\u0130\u00e7indekiler", "This Page": "Bu Sayfa", "Welcome! This is": "Ho\u015f Geldiniz! Kar\u015f\u0131n\u0131zda", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "Arama sonucunda herhangi bir belge bulunamad\u0131. B\u00fct\u00fcn kelimeleri do\u011fru yazd\u0131\u011f\u0131n\u0131zdan ve gerekli b\u00fct\u00fcn kategorileri se\u00e7ti\u011finizden emin olun.", "all functions, classes, terms": "t\u00fcm i\u015flevler, s\u0131n\u0131flar, terimler", "can be huge": "\u00e7ok b\u00fcy\u00fck olabilir", "last updated": "son g\u00fcncelleme", "lists all sections and subsections": "t\u00fcm b\u00f6l\u00fcmleri ve alt b\u00f6l\u00fcmleri listeler", "next chapter": "sonraki b\u00f6l\u00fcm", "previous chapter": "\u00f6nceki b\u00f6l\u00fcm", "quick access to all modules": "t\u00fcm mod\u00fcllere h\u0131zl\u0131 eri\u015fim", "search": "ara", "search this documentation": "bu belgelendirmeyi ara", "the documentation for": "belgelendirme konusu: " }, "plural_expr": "(n > 1)" });�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/tr/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000162426�00000000000�021176� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������S�������������������L%�����M%��E��;&��r���'��l���'�� ���a(�����o(��=���u(��7���(��H���(��?���4)��"���t)�� ���)�����)��%���)�����)�����)����� *�����*�����'*�� ���9*�����E*�����Y*�����p*�����*�� ���*�����*�� ���*�� ���*�� ���*��S���*�����N+��A���e+�����+�����+�����+�����+�����+�� ���,�����$,��6���8,�����o,�����,��3���I-�� ���}-�����-�����-��1���-��1���-�����-�����.��0���&.�����W.�����s.��b��� /�����n/��6���/�����/�� ���/�� ���/�����/�����/��>���/��(���<0��(���e0�����0��?���0�����0�� ���0��!���1��8���&1��%���_1�����1�����1��4���1�� ���1�� ���1�����2�����2�����32�����S2�� ���\2�����f2��:���2�����2��"���2�����2����� 3�� ���3�����3�����93��`���U3�����3��&���3�����3��D���3��H���84��K���4�����4�����4�����4��5���4�����-5�����A5�����P5��"���b5��"���5��#���5�����5��!���5��:���5�� ���16�����;6�� ���R6�����`6�����t6�����w6�����6��3��6�� ���7��.���7�����7�����8�����8��D���/8�����t8�����8�� ���s9�����9�����9�����9��Y���9��!���*:�����L:��2���\:�� ���:��C���:�����:��n���:��E���m;�� ���;�����;�� ���;�� ���;��-���;��(���<�� ���@<�����K<�� ���]<��(���h<�����<�����<�����<��Z���<�����=�����!=��,���)=����V=�����m>�����>�� ���>�����>�����>�� ���>�����>�����>�����>�����?�����5?�����M?�����e?��&���?��B���?��i���?��2���S@��I���@��4���@�����A�����%A�����EA�����]A��y���uA�����A�����B�����B�����(B�� ���9B�����FB�����VB�����iB��#���yB��$���B�����B�� ���B�����B�����B�� ���B�����C�� ���C�����C�����"C�����BC�����UC�����\C�� ���qC�����}C��<���C�����C�� ���C�� ���C�����C����� D�����D��+���+D�� ���WD��>���cD�����D��#���D�����D�����D�����D�����D�����E��*���"E��3���ME��/���E��(���E��.���E��P��� F��p���ZF�����F��!���F��"��� G��$���0G�� ���UG��e���vG��Z���G��N���7H��T���H��K���H��%���'I�����MI��[���mI��#���I��'���I��#���J��I���9J��'���J��!���J��=���J��7��� K�� ���CK��d���MK��W���K��v��� L�����L�����L�����L�� ���L��3���L�����L�����L��"���M��<���<M��Y���yM�� ���M�����M�����M��,���M�����N�����)N�����?N�����FN��Y���O�����jO�����O�� ���O�����P�� ���P�����P�����$P�����-P��?���P��-���P��2���'Q�����ZQ�����xQ�����Q��9���Q�����Q�� ���Q�� ���Q��,���R��2���5R�����hR��7���}R�����R��8���R�����S�� ���S��%���%S��`���KS�����S�����S�����S�����S����� T�� ���T��&���'T��$���NT�����sT�����T�����T�����T�����T��A���T��Z���=U��-���U�����U�����U��!���U��8���V�����UV�� ���[V�����hV�����|V��7���V��6���V��;���V��I���/W��;���yW��:���W��H���W��9���9X��G���sX��2���X��2���X�����!Y��4���0Y�����eY�����|Y�����Y��C���Y��2���Y�����'Z�����AZ�����^Z�����|Z�����Z�����Z�����Z�����Z��(���Z��=���[�����Z[�����k[�����{[�����[�����[��*���[�� ���[��9���[�����$\�����5\�����S\��-���h\�����\�����\��1���\��*���\�����"]�����8]��&���A]�����h]�����z]�����]�����]�����]��%���]��e��� ^��4���p^�����^�����^�����^�����^�����^��.��� _��4���<_��+���q_��4���_��(���_��4���_��W���0`�����`�����`�����`�����`��%���`�� ���a����� a�����"a�����;a�����Ua�� ���ua��M���a��u���a�����Cb�����Ub�����hb��A���ob�� ���b�����b��6���b��I���c��A���\c�����c��0���c�����c��G���d��N���Id�����d�����d��.���d�����d��4���d�� ���(e��,���6e��3���ce�� ���e��'���e��0���e��(���e��1���'f��,���Yf�����f�����f�����f��=���f��+���g��0���Fg��$���wg�����g�����g��N���g��)���h�����/h�����Mh��/���jh�����h�����h��&���h�����h��E���i�� ���Hi��*���Ui��7���i��"���i��(���i�����j����� j�����>j��"���Zj�����}j�����j�����j��;���j�����j�����j�����j�����k��5��� k�� ���?k�����Jk�� ���Ok��1���\k��E���k��B���k��G���l��%���_l�����l��#���l��,���l�����l��-��� m��(���:m��D���cm�� ���m��#���m��(���m������n�����n�����n��(���n�����Hn�����an��8���fn�� ���n��P���n��"���o�����4o�����Oo��O���ho�����o�����o�����o�����o��%���o�� ���!p�����/p��,���>p�� ���kp��(���xp��E���p�� ���p��*���p��1���q��7���Qq�����q�� ���q�����q�����q�����q�����q�����r�����r��&���&r�����Mr�����er��4���jr�����r��%���r�����r��c���r�����Es�����_s�� ���fs��'���rs��:���s�� ���s�����s�����s�����t��*���.t��&���Yt��W���t��>���t��7���u�� ���Ou�� ���Yu�� ���gu��,���qu��*���u��0���u�����u��%���v�����>v�����v��1���nw��1���w�����w��\���w�����Ex��'���ax��%���x��^���x��2���y��5���Ay�����wy�����y�����y��-���y�����y��!���y��!���z�����*z�����Az��#���Jz��*���nz�����z�����z�����z��P���z�����{��)���<{��9���f{��;���{��)���{�����|�����|�����!|�����:|�����S|�����i|�����|�����|����|�����v~��l��n�����ۀ����������A�� ���V��J���c��D�����T�����L���H��"���������������,���у�������!��������?�����E�����[�� ���p�����|������������ ���DŽ�� ���Մ������� ����������/���$��p���T�����Ņ��K��������.�����C�����^�����q�����������������9���̆��"��������)��7��������W�� ���h�����u��L�����L���Ԉ�����!�����<��*���O��"���z�������s���Q�����Ŋ��1���ۊ����� �����+�����E�����L�� ���d��P���r��,���Ë��9�����$���*��Z���O�� �������������Ռ��>�����0���3�����d�����k��C�����#���ɍ������������������&���&�� ���M�� ���[��"���h��?����� ���ˎ��.�������������7�����?��'���Q�����y����������%��,���6�����c��>���h��H�����B��������3�����H�� ���O��N���Y����������Ñ�����ڑ��5�����1���%��5���W�� �����"�����.����� ���������� ��� ����������)�����-�����I��2��P�������K��������ה�����ݔ�������Z��������k����������f�����w�������!�����v���֖��"���M�����p��K����� ���ٗ��S����� ���:�����[��D����� ���.�����<�� ���S�����_��%���o��-��������Ù�����˙�� �����:�����)���)�����S�����e��U���i������� ���ƚ��7���К��������������3�����G�� ���^�����l�� ����������#�����$���؜��%����� ���#��"���D��1���g��4�����L���Ν��v�����9�����e���̞��V���2��$����������)���Ο����������������� ���Ġ�����Ѡ�� ����� �������������������!��!���1��%���S�����y�� ��������������� ���¡�����̡�����ӡ�� �����#�������������,�����0�����B�����Q��4���c������� ����� ��������Ǣ�����ߢ�������'��������6��(���H�����q��1���������� ���ʣ�����ԣ�� ���ݣ������� �����.���"��*���Q�����|��)�����Y���Ť�������!�����#���ȥ��$�����&�����"���8��k���[��k���Ǧ��Z���3��q�����b������-���c��!�����V�����%��� ��'���0��*���X��H�����)���̩��$�����=�����:���Y�������\�����Q�����|���L�� ���ɫ�����׫�� ���ݫ�������F��� �����R�����k��$�����U�����p����� ���w������� �����F��������ݭ������� ����������j��������`�� ����� ���������� ��������$�����,�����5��Q�����4���=��9���r��$��������ѱ�������E��������H�� ���d�����q��,�����@����������<��� �����J��?���`������� �����(�����s�����'���^��/�������������˴������������1�����*���:��$���e��%�������������ϵ��$�����V�����x���f��9���߶��#��������=��)���W��?����� ��������˷�����ܷ�������H�����D���H��I�����Z���׸��I���2��H���|��X���Ź��G�����W���f��C�����@��������C��2���\���������������ƻ��X���ܻ��?���5��#���u��&�����*����������'��������0�����P�� ���j��:�����J���ƽ����������$�����6�����=�� ���\��4���}�� �����6����������,��������5��<���M������������>�����*�������������<��.���B�� ���q��&���|������������&����������c���"��>���������������&����������&���#��6���J��<�����0�����5�����,���%��8���R��b�����%����������!���2�����T��"���Y�����|������������&�����,����� ��� ��_�����|���w���������� �������O���0�������!�����C�����T�����V���Q�������3����������L�����b���`������������,�������� ��R���"�����u��8�����;����������(�����A���8��)���z��B�����>�����'���&��$���N�����s��G�����=�����8�����-���N�����|�������M�����*�����$�����#���9��C���]������� �����+�������� ��]��������w��;�����A�����,�����2���2��"���e������������,��������������������I���)�����s�����z������� �����8��������������������3�����]���0��a�����_�����/���P��!�����)�����@�������� ��/���+��8���[��O����������&�����1��������N�����T�����\��6���k�� ����������A�����%��� ��W���1��)���������������W��������C�����\�����t�����|��,����� ����������>����� �����*���$��T���O�������5�����5�����8���"�����[�� ���{��������������������������������/��� �����:�����Y��1���_�������-����������g��������J�� ���a�����n��2�����N�����%��������+�����4�����K��&���_�� �����e�����B��� ��8���P�����������������-�����(�����1�����"���8��'���[����������C��1�����1���5�����g��`���~��%�����#�����!���)��c���K��7�����3�����!��������=�����D��G���M��"�����/�����)���������� ���&��(���2��@���[�� ����������!�����Y��������7��%���T��O���z��Q�����.����� ���K�����W�����r������������!���������������� Generate required files for a Sphinx project. sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build. � Look recursively in <MODULE_PATH> for Python modules and packages and create one reST file with automodule directives per package in the <OUTPUT_PATH>. The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be excluded from generation. Note: By default this script will not overwrite already created files.� Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� Run 'make' in that directory to run these through makeinfo (use 'make info' here to do that automatically).� (deprecated)� (in �"latex_documents" config value references unknown document %s�"man_pages" config value references unknown document %s�"quiet" is specified, but any of "project" or "author" is not specified.�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%r doesn't have "%s" setting�%r doesn't have "theme" setting�%s %s�%s %s documentation�%s (%s attribute)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command %r cannot be run (needed for math display), check the imgmath_%s setting�%s command line option�%s is already assigned section numbers (nested numbered toctree?)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �-A option argument must be in the form name=value�-D option argument must be in the form name=value�:%s: (directive option)�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�A Makefile and a Windows command file can be generated for you so that you only have to run e.g. `make html' instead of invoking sphinx-build directly.�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�About these documents�An error happened in rendering the page %s. Reason: %r�Anchor '%s' not found�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not import extension %s�Could not lex literal_block as "%s". Highlighting skipped.�Create Makefile? (y/n)�Create Windows command file? (y/n)�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Encoding error:�Enter the root path for documentation.�Error�Error: an existing conf.py has been found in the selected root path.�Error: specified path is not a directory, or sphinx files already exist.�Error: the master file %s has already been found in the selected root path.�Event %r already present�Example�Examples�Exception occurred while building, starting debugger:�Exception occurred:�Expand sidebar�Extension options�Failed to read build info file: %r�Failed to scan documents in %s: %r�Failed to write build info file: %r�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnotes�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�If the documents are to be written in a language other than English, you can select a language here by its language code. Sphinx will then translate text that it generates into that language. For a list of supported codes, see https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indicate which of the following Sphinx extensions should be enabled:�Indices and tables:�Inside the root directory, two more directories will be created; "_templates" for custom HTML templates and "_static" for custom stylesheets and other static files. You can enter another prefix (such as ".") to replace the underscore.�Interrupted!�Invalid caption: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�LaTeX command %r cannot be run (needed for math display), check the imgmath_latex setting�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Look for any errors in the above output or in %(outdir)s/output.txt�Makefile and Batchfile creation�Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Many math_renderers are registered. But no math_renderer is selected.�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Non-alphabetical�Note�Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.�Notes�Numbers�Object named %r not found in include file %r�One document is special in that it is considered the top node of the "contents tree", that is, it is the root of the hierarchical structure of the documents. Normally, this is "index", but if your "index" document is a custom template, you can also set this to another filename.�Original exception: �Other Parameters�Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Pillow not found - copying image files�Please activate JavaScript to enable the search functionality.�Please also report this if it was a user error, so that a better error message can be provided next time.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter a new file name, or rename the existing file and press Enter�Please enter a new root path (or just Enter to exit)�Please enter a valid path name.�Please enter either 'y' or 'n'.�Please enter one of %s.�Please enter some text.�Please enter values for the following settings (just press Enter to accept a default value, if one is given in brackets).�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project templating�Project version�Pygments lexer name %r is not known�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Recursion error:�References�Release�Return type�Returns�Root path for the documentation�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Section %s�Section author: �See also�Selected root path: %s�Separate source and build directories (y/n)�Show Source�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Structure options�Symbols�Table %s�Table of Contents�Template Parameters�The %r crossref_type is already registered�The %r directive is already registered to domain %s�The %r index is already registered to domain %s�The %r object_type is already registered�The %r role is already registered to domain %s�The %s extension is required by needs_extensions settings, but it is not loaded.�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.�The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.�The config value `{name}' has type `{current.__name__}'; expected {permitted}.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The dummy builder generates no files.�The ePub file is in %(outdir)s.�The full traceback has been saved in %s, if you want to report the issue to the developers.�The manual pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�The overview file is in %(outdir)s.�The project name will occur in several places in the built documentation.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Translator for %r already exists�Unknown configure key: latex_elements[%r], ignored.�Unknown event name: %s�Unknown image format: %s...�Unknown math_renderer %r is given.�Use the Makefile to build the docs, like so: make builder�Use the sphinx-build command to build the docs, like so: sphinx-build -b builder %s %s�Variables�Warning�Warns�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�Would create file %s.�Yields�You have two options for placing the build directory for Sphinx output. Either, you use a directory "_build" within the root path, or you separate "source" and "build" directories within the root path.�You should now populate your master file %s and create other documentation source files. �Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.�a list of specific files to rebuild. Ignored if -a is specified�a suitable image for %s builder not found: %s�a suitable image for %s builder not found: %s (%s)�all functions, classes, terms�all of %d po files�all source files�append module_path to sys.path, used when --full is given�assembling single document�attribute�author names�automatically insert docstrings from modules�automatically test code snippets in doctest blocks�broken link: %s (%s)�build %s, %s warning (with warnings treated as errors).�build %s, %s warning.�build %s, %s warnings (with warnings treated as errors).�build %s, %s warnings.�build %s.�build environment version not current�build in parallel with N processes where possible (special value "auto" will set N to cpu-count)�build info file is broken: %r�builder to use (default: html)�building [%s]: �building [mo]: �built-in function�can be huge�cannot combine -a option and filenames�cannot copy downloadable file %r: %s�cannot copy extra file %r�cannot copy image file %r: %s�cannot copy static file %r�cannot find files %r�cannot open warning file %r: %s�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�cannot read image file %r: copying it instead�cannot write image file %r: %s�checking consistency�checks for documentation coverage�circular toctree references detected, ignoring: %s <- %s�class�class method�command line option�concept�conditional inclusion of content based on config values�conf value "epub_author" should not be empty for EPUB3�conf value "epub_contributor" should not be empty for EPUB3�conf value "epub_copyright" (or "copyright")should not be empty for EPUB3�conf value "epub_description" should not be empty for EPUB3�conf value "epub_identifier" should not be empty for EPUB3�conf value "epub_language" (or "language") should not be empty for EPUB3�conf value "epub_publisher" should not be empty for EPUB3�conf value "epub_title" (or "html_title") should not be empty for EPUB3�conf value "epub_uid" should be XML NAME for EPUB3�conf value "version" should not be empty for EPUB3�config changed�config directory doesn't contain a conf.py file (%s)�console output options�continued from previous page�continues on next page�convert command %r cannot be run, check the image_converter setting�convert exited with error: [stderr] %r [stdout] %r�copying TeX support files�copying TeX support files...�copying Texinfo support files�copying additional files�copying downloadable files... �copying extra files�copying images... �copying source files...�could not read %r for changelog creation�create .nojekyll file to publish the document on GitHub pages�create batchfile�create makefile�data�default role %s not found�define a template variable�define tag: include "only" blocks with TAG�directive�directive %r is already registered, it will be overridden�directive-option�directory to place all output�display latex %r: %s�do emit colored output (default: auto-detect)�do not create batchfile�do not create makefile�do not emit colored output (default: auto-detect)�do not use make-mode for Makefile/make.bat�docnames to write: %s�document�document isn't included in any toctree�document language�document not readable. Ignored.�doing serial %s�domain %s already registered�domain %s not yet registered�don't create a table of contents file�don't create headings for the module/package packages (e.g. when the docstrings already contain them)�don't use a saved environment, always read all files�done�dot code %r: %s�download file not readable: %s�dumping object inventory�dumping search index in %s�duplicate %s description of %s, other %s in %s�duplicate %s description of %s, other instance in %s�duplicate citation %s, other instance in %s�duplicate description of %s %s, other instance in %s�duplicate label %s, other instance in %s�duplicate label of equation %s, other instance in %s�duplicate object description of %s, other instance in %s, use :noindex: for one of them�duplicated ToC entry found: %s�enable %s extension�enable arbitrary extensions�enum�enumerable_node %r already registered�enumerator�environment variable�environment variable; %s�error writing file %s: %s�error writing file Makefile: %s�exception�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extension options�extensions changed�failed�failed to reach any of the inventories with the following issues:�failed: %s�favicon file %r does not exist�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�filename of table of contents (default: modules)�finished with problems�fnmatch-style file and/or directory patterns to exclude from generation�follow symbolic links. Powerful when combined with collective.recipe.omelette.�function�general options�generate a full project with sphinx-quickstart�generating indices�glossary seems to be misformatted, check indentation�glossary term�glossary term must be preceded by empty line�glossary terms must not be separated by empty lines�grammar token�html_extra_path entry %r does not exist�html_extra_path entry %r is placed inside outdir�html_static_path entry %r does not exist�html_static_path entry %r is placed inside outdir�if specified, separate source and build dirs�image file %s not readable: %s�image file not readable: %s�include "_private" modules�include links to the source code of documented Python objects�include math, rendered as PNG or SVG images�include math, rendered in the browser by MathJax�increase verbosity (can be repeated)�index�inline latex %r: %s�interpret module paths according to PEP-0420 implicit namespaces specification�intersphinx inventory has moved: %s -> %s�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�job number should be a positive number�keyword�kwargs for add_node() must be a (visit, depart) function tuple: %r=%r�last updated�line number spec is out of range(1-%d): %r�link between Sphinx documentation of different projects�lists all sections and subsections�loading intersphinx inventory from %s...�loading pickled environment�loading translations [%s]... �logo file %r does not exist�looking for now-outdated files... �macro�making output directory�master document name�maximum depth of submodules to show in the TOC (default: 4)�member�method�module�modules�more than one target found for cross-reference %r: %s�new config�next�next chapter�nit-picky mode, warn about all missing references�no "latex_documents" config value found; no documents will be written�no "man_pages" config value found; no manual pages will be written�no "texinfo_documents" config value found; no documents will be written�no Babel option known for language %r�no changes in version %s.�no output at all, not even warnings�no output on stdout, just warnings on stderr�no targets are out of date.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�none found�not available for built-in messages�numfig is disabled. :numref: is ignored.�object�operator�original entry�override a setting in configuration file�overwrite existing files�page�page %s matches two patterns in html_sidebars: %r and %r�pass a value into HTML templates�path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)�path to documentation source files�path to module to document�path to output directory�path where configuration file (conf.py) is located (default: same as SOURCEDIR)�pickling environment�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�program option�project author(s), used when --full is given�project name�project name (default: root module name)�project release, used when --full is given, defaults to --doc-version�project root�project version, used when --full is given�put documentation for each module on its own page�put module documentation before submodule documentation�quick access to all modules�quiet mode�reST markup error:�reading error: %s, %s�reading sources... �reading templates... �reference label�release of project�replacement for dot in _templates etc.�resolving references...�role�role %r is already registered, it will be overridden�run Pdb on exception�run the script without creating files�search�search index couldn't be loaded, but not all documents will be built: the index will be incomplete.�search this documentation�see %s�see also %s�self referenced toctree found. Ignored.�setting %s.%s occurs in none of the searched theme configs�show full traceback on exception�skipped�source directory has changed�source file suffix�source_parser for %r is already registered�source_suffix %r is already registered�sphinx-quickstart only generate into a empty directory. Please specify a new root path.�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�statement�static method�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�targets for %d template files�template directory for template files�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension is not safe for parallel reading�the %s extension is not safe for parallel writing�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�toctree contains reference to document %r that doesn't have a title: no link will be generated�toctree contains reference to excluded document %r�toctree contains reference to nonexisting document %r�turn warnings into errors�type�union�unknown config value %r in override, ignoring�unknown index entry type %r�unknown mimetype for %s, ignoring�unsupported theme option %r given�updating environment: �use epub�use make-mode for Makefile/make.bat�use no config file at all, only -D options�variable�version of project�waiting for workers...�where "builder" is one of the supported builders, e.g. html, latex or linkcheck.�while setting up extension %s:�with -W, keep going when getting warnings�write "todo" entries that can be shown or hidden on build�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing�writing %s file...�writing additional files�writing additional pages�writing error: %s, %s�writing message catalogs... �writing output... �writing summary file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: tr Language-Team: Turkish (http://www.transifex.com/sphinx-doc/sphinx-1/language/tr/) Plural-Forms: nplurals=2; plural=(n > 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � Bir Sphinx projesi için gerekli dosyaları oluşturun. sphinx-quickstart, projeniz hakkında bazı sorular soran ve ardından tam bir belgelendirme dizini ve örnek oluşturan etkileşimli bir araçtır Makefile, sphinx-build ile kullanılır. � Python modülleri ve paketleri için <MODULE_PATH> içine art arda bakın ve <OUTPUT_PATH> içindeki paket başına otomodül talimatlarını içeren bir reST dosyası oluşturun. <EXCLUDE_PATTERN>'ler, nesilden hariç tutulacak olan dosya ve/veya dizin şekilleri olabilir. Not: Varsayılan olarak bu betik zaten oluşturulmuş dosyaların üzerine yazmayacak.� (pdf)latex aracılığıyla bunları çalıştırmak için bu dizinde 'make' komutunu çalıştırın (bunu otomatik olarak yapmak için burada 'make latexpdf' komutunu kullanın).� Makeinfo aracılığıyla bunları çalıştırmak için bu dizinde 'make' komutunu çalıştırın (bunu otomatik olarak yapmak için burada 'make info' komutunu kullanın).� (kullanım dışı)� (şurada: �"latex_documents" yapılandırma değeri bilinmeyen %s belgesine başvurur�"man_pages" yapılandırma değeri bilinmeyen %s belgesine başvurur�"sessiz" belirtilmiş, ancak herhangi bir "proje" veya "hazırlayan" belirtilmemiş.�"texinfo_documents" yapılandırma değeri bilinmeyen %s belgesine başvurur�%(filename)s — %(docstitle)s�%d %b %Y�%d tane bulundu�komut satırında verilen %d kaynak dosyası�%r, "%s" ayarına sahip değil�%r, "theme" ayarına sahip değil�%s %s�%s %s belgelendirmesi�%s (%s özniteliği)�%s (C++ %s)�%s (yerleşik sınıf)�%s (yerleşik değişken)�%s (%s içindeki sınıf)�%s (yönerge)�%s (genel değişken veya sabit)�%s (%s modülü içinde)�%s (modül)�%s (rol)�%s eklendi, %s değiştirildi, %s kaldırıldı�%s komutu %r çalıştırılamaz (matematik görüntüleme için gerekli), imgmath_%s ayarını gözden geçirin�%s komut satırı seçeneği�%s zaten atanmış bölüm numaralarıdır (iç içe numaralı toctree mi?)�%s bir dizin değil.�%s() (%s sınıf yöntemi)�%s() (%s yöntemi)�%s() (%s sabit yöntemi)�%s() (yerleşik işlev)�%s() (sınıf)�%s() (%s modülü içinde)�© <a href="%(path)s">Telif hakkı</a> %(copyright)s.�© Telif hakkı %(copyright)s.�Şu anda conf.py dosyasında tanımlanan 'kurulum' çağrılabilir bir Python değil. Lütfen tanımını çağrılabilir bir işlev yapmak için değiştirin. Bunun, Sphinx uzantısı gibi davranması için conf.py dosyasına ihtiyacı vardır.�(<<original entry>>, %s içinde, %d. satırda bulunur.)�(%s v%s içinde)�(%s içinde)�, şunun içinde:�-A seçeneği bağımsız değişkeni ad=değer biçiminde olmak zorundadır�-D seçeneği bağımsız değişkeni ad=değer biçiminde olmak zorundadır�:%s: (yönerge seçeneği)�<<original entry>>�<h1>Kodları mevcut bütün modüller</h1>�<h1>%s öğesinin kaynak kodu</h1>�Makefile ve Windows komut dosyası sizin için oluşturulabilir, böylece doğrudan örn. sphinx-build çağırmak yerine sadece `make html' komutu çalıştırılmak zorundadır.�Bir hata raporu <https://github.com/sphinx-doc/sphinx/issues> adresindeki izleyicide dosyalanabilir. Teşekkürler!�Bu belgeler hakkında�%s sayfasını işlerken bir hata oldu. Sebep: %r�Bağlayıcı '%s' bulunamadı�Bağımsız Değişkenler�Dikkat�Hazırlayan ad(ları)ı�Hazırlayan: �%(version)s sürümündeki değişikliklerin otomatik olarak üretilmiş listesi�Oluşturucu %r zaten mevcut (%s modülünde)�Oluşturucu sınıfı %s "ad" özniteliğine sahip değil�Oluşturucu adı %s kayıtlı değil�Oluşturucu adı %s kayıtlı veya giriş noktası aracılığıyla kullanılabilir değil�Yerleşikler�C API'sindeki değişiklikler�Kaynak dizin bulunamıyor (%s)�Ayrık bir "satır" kümesiyle "lineno-match" kullanılamıyor�Hem "%s" hem de "%s" seçeneği kullanılamıyor�Uyarı�%s sürümünde değişti�Sürüm %(version)s — %(docstitle)s içindeki Değişiklikler�Alıntı [%s] kaynak gösterilmedi.�Kodu hazırlayan: �Yan çubuğu daralt�Tam İçindekiler�Yapılandırma değeri %r zaten mevcut�İçindekiler�Telif hakkı� %s uzantısı içe aktarılamadı�"%s" olarak literal_block lex yapılamadı. Vurgulama atlandı.�Makefile oluşturulsun mu? (y/n)�Windows komut satırı oluşturulsun mu? (y/n)�%s dosyası oluşturuluyor.�Tehlike�Kullanım dışı�%s sürümünden beri kullanım dışı�Etki alanı %r kayıtlı değil�%r kodlamasının kullanıldığı, dahil edilen %r dosyasını okuma yanlış gibi görünüyor, bir :encoding: seçeneği vermeyi deneyin�Kodlama hatası:�Belgelendirme için kök dizin yolunu girin.�Hata�Hata: seçilen kök dizin yolunda varolan bir conf.py bulundu.�Hata: belirtilen yol bir dizin değil ya da sphinx dosyaları zaten var.�Hata: %s asıl dosyası zaten seçilen kök dizin yolunda bulundu.�Olay %r zaten mevcut�Örnek�Örnekler�Oluşturulurken meydana gelen özel durum, hata ayıklayıcı başlatılıyor:�Özel durum meydana geldi:�Yan çubuğu genişlet�Uzantı seçenekleri�oluşturma bilgisi dosyasını okuma başarısız: %r�%s içinde belgeleri tarama başarısız oldu: %r�oluşturma bilgisi dosyasını yazma başarısız: %r�Şekil %s�%s dosyası zaten var, atlanıyor.�Tamamlandı: İlk dizin yapısı oluşturuldu.�Dipnotlar�Tek sayfada tam dizin�Genel Dizin�Genel Modül Dizini�Git�Arama Eşleşmelerini Gizle�İpucu�Eğer belgeler İngilizce dışında bir dilde yazıldıysa, bunun dil koduna göre burada bir dil seçebilirsiniz. Sphinx daha sonra, ürettiği metni o dile çevirecektir. Desteklenen kodların listesi için https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language adresine bakın.�Önemli�Dahil edilen %r dosyası bulunamadı ya da dosyayı okuma başarısız oldu�Dizin�Dizin – %(key)s�Harfe göre dizin sayfaları�Aşağıdaki Sphinx uzantılarından hangisinin etkinleştirilmesi gerektiğini gösterir:�Dizinler ve tablolar:�Kök dizinin içinde, iki dizin daha oluşturulacaktır; özel HTML şablonları için "_templates" ve özel stil sayfaları ve diğer sabit dosyalar için "_static". Alt çizgi yerine başka bir önek ("." gibi) girebilirsiniz.�Yarıda kesildi!�Geçersiz resim yazısı: %s�Geçersiz math_eqref_format: %r�Geçersiz şablon değişkeni: %s�LaTeX komutu %r çalıştırılamaz (matematik görüntüleme için gerekli), imgmath_latex ayarını gözden geçirin�Son güncelleme: %(last_updated)s.�Kütüphane değişiklikleri�Satır özelliği %r: dahil edilen %r dosyasından çekilen hiç satır yok�Listeleme %s�Yukarıdaki çıktıda veya %(outdir)s/output.txt içinde herhangi bir hata arayın�Makefile ve Batchfile oluşturma�Hatalı biçimlendirilmiş seçenek açıklaması %r, "opt", "-opt args", "--opt args", "/opt args" veya "+opt args" şeklinde görünmelidir�Birçok math_renderers kayıtlı. Ama hiç math_renderer seçilmedi.�Modül Dizini�Modülü hazırlayan: �Modül kodu�Modül seviyesi�Asıl belgenizin adı (sonek olmadan)�Templates ve static dizinleri için ad öneki�Gezinti�%s sürümünde geldi�Sonraki konu�Seçilen oluşturucu yok, varsayılan kullanılıyor: html�Böyle bir yapılandırma değeri yok: %s�Alfabetik olmayan�Not�Not: imgmath ve mathjax aynı anda etkinleştirilemez. imgmath seçimi kaldırıldı.�Notlar�Numaralar�%r adlı nesne, dahil edilen %r dosyasında bulunamadı�Bir belge, "içindekiler ağacı"nın üst düğümü olarak kabul edilmesi, yani belgelerin hiyerarşik yapısının kökü olması açısından özeldir. Normalde bu "dizin"dir, ancak "dizin" belgeniz özel bir şablonsa, bunu başka bir dosya adına da ayarlayabilirsiniz.�Özgün özel durumu: �Diğer Parametreler�Diğer değişiklikler�Genel Bakış�Genel bakış: modül kodu�Parametreler�Bu kodun kalıcı bağlantısı�Bu tanım için kalıcı bağlantı�Bu denklem için kalıcı bağlantı�Bu başlık için kalıcı bağlantı�Bu resmin kalıcı bağlantısı�Bu tablonun kalıcı bağlantısı�Bu içindekiler tablosunun kalıcı bağlantısı�Yastık bulunamadı - resim dosyaları kopyalanıyor�Arama işlevini kullanabilmek için lütfen JavaScript'i etkinleştirin.�Bir dahaki sefere daha iyi bir hata iletisi sağlanabilmesi için lütfen bunu bir kullanıcı hatasıysa da bildirin.�Lütfen bir dosya soneki girin, örn. '.rst' veya '.txt'.�Lütfen yeni bir dosya adı girin ya da varolan dosyayı yeniden adlandırın ve Enter tuşuna basın�Lütfen yeni bir kök dizin yolu girin (ya da çıkmak için yalnızca Enter'a basın)�Lütfen geçerli bir yol adı girin.�Lütfen ya 'y' ya da 'n' girin.�Lütfen %s seçeneklerinden birini girin.�Lütfen biraz metin girin.�Lütfen aşağıdaki ayarlar için değerleri girin (parantez içinde verilirse varsayılan değeri kabul etmek için yalnızca Enter tuşuna basın).�Aramaya hazırlanıyor...�Önceki konu�Proje temel seçenekleri�Proje dili�Proje adı�Proje yayımı�Proje şablonlama�Proje sürümü�Pygments lexer adı %r bilinmiyor�Python Geliştirme Önerileri; PEP %s�Python Modül Dizini�Hızlı Arama�Harekete geçirir�Tekrarlama hatası:�Kaynaklar�Yayım�Dönüş türü�Dönüşler�Belgelendirme için kök dizin yolu�Sphinx s%s çalışıyor�Ara�%(docstitle)s ara�Arama Sayfası�Arama Sonuçları�Arama tamamlandı. Sorguyu içeren %s sayfa bulundu.�%(docstitle)s içinde ara�Aranıyor�Bölüm %s�Bölümü hazırlayan: �Ayrıca bakınız�Seçilen kök dizin yolu: %s�Source ve build dizinlerini ayır (y/n)�Kaynağı Göster�Kaynak dizin ve hedef dizin aynı olamaz�Kaynak dosya soneki�%s için kaynak ayrıştırıcı kayıtlı değil�Yapı seçenekleri�Semboller�Tablo %s�İçindekiler�Şablon Parametreleri�%r crossref_type zaten kayıtlı�%r yönergesi zaten %s etki alanına kayıtlı�%r dizini zaten %s etki alanına kayıtlı�%r object_type zaten kayıtlı�%r rolü zaten %s etki alanına kayıtlı�%s uzantısı needs_extensions ayarları tarafından gereklidir, ancak yüklü değildir.�Bu proje tarafından kullanılan %s uzantısının en az Sphinx s%s sürümüne ihtiyacı var; bu nedenle bu sürümle oluşturulamaz.�HTML sayfası %(outdir)s içinde.�HTML sayfaları %(outdir)s içinde.�LaTeX dosyaları %(outdir)s içinde.�Texinfo dosyaları %(outdir)s içinde.�XML dosyaları %(outdir)s içinde.�'source_suffix' yapılandırma değeri bir dizgi, dizgiler listesi ya da sözlük bekler. Ama '%r' verilir.�`{name}' yapılandırma değeri `{current.__name__}' türüne sahip, vassayılanları `{default.__name__}'.�`{name}' yapılandırma değeri `{current.__name__}' türüne sahip; beklenen {permitted}.�`{name}` yapılandırma değeri, {candidates} geğerlrinden biri olmak zorundadır, ancak `{current}` değeridir.�Yapılandırma dosyası (veya içe aktarılan modüllerden biri) sys.exit() olarak adlandırılır�Taklit oluşturucu hiçbir dosya oluşturmaz.�ePub dosyası %(outdir)s içinde.�Sorunu geliştiricilere bildirmek istiyorsanız, tam geri izleme %s içine kaydedildi.�Rehber sayfaları %(outdir)s içinde.�İleti katalogları %(outdir)s içinde.�Genel bakış dosyası %(outdir)s içinde.�Proje adı, oluşturulan belgelendirmedeki çeşitli yerlerde oluşacak.�Pseudo-XML dosyaları %(outdir)s içinde.�Metin dosyaları %(outdir)s içinde.�Yapılandırma dosyanızda programlanabilir bir hata var: %s�Yapılandırma dosyanızda bir sözdizimi hatası var: %s �Bu Sayfa�Bu ortam seçilen oluşturucuyla uyumsuzdur, lütfen başka bir belge ağacı dizini seçin.�Bu proje en az Sphinx s%s gerektirir ve bu nedenle bu sürüm ile oluşturulamaz.�Bu projenin %s uzantısına ve en az %s sürümüne ihtiyacı vardır ve bu nedenle yüklenen sürümle oluşturulamaz (%s).�Şunu verir: �Tüyo�Yapılacaklar�%r için çevirmen zaten mevcut�Bilinmeyen yapılandırma anahtarı: latex_elements[%r], yoksayıldı.�Bilinmeyen olay adı: %s�Bilinmeyen resim biçimi: %s...�Bilinmeyen math_renderer %r verildi.�Belgeleri oluşturmak için Makefile'ı kullanın, aşağıdaki gibi: make builder�Belgeleri oluşturmak için sphinx-build komutunu kullanın, aşağıdaki gibi: sphinx-build -b builder %s %s�Değişkenler�Uyarı�Uyarılar�Sphinx %s hızlı başlangıç yardımcı uygulamasına hoş geldiniz.�Hoş Geldiniz! Karşınızda�%s dosyası oluşturur.�Getiriler�Sphinx çıktısının oluşturma dizinini yerleştirmek için iki seçeneğiniz var. Ya, kök dizin yolu içinde bir "_build" dizini kullanın, ya da kök dizin yolu içinde "source" ve "build" dizinlerini ayırın.�Artık %s asıl dosyanızı doldurmalı ve diğer belgelendirme kaynak dosyalarını oluşturmalısınız.�Arama sonucunda herhangi bir belge bulunamadı. Bütün kelimeleri doğru yazdığınızdan ve gerekli bütün kategorileri seçtiğinizden emin olun.�[belgeler]�[grafik: %s]�[grafik]�[resim: %s]�[resim]�[kaynak]�%s sayfasını işlerken bir Evrensel kod hatası meydana geldi. Lütfen ASCII olmayan içerik içeren tüm yapılandırma değerlerinin Evrensel kod dizgiler olduğundan emin olun.�yeniden oluşturmak için belirli dosyaların listesi. Belirtildiyse yoksayıldı�%s oluşturucu için uygun bir resim bulunamadı: %s�%s oluşturucu için uygun bir resim bulunamadı: %s (%s)�tüm işlevler, sınıflar, terimler�%d po dosyasının tümü�tüm kaynak dosyaları�--full yazıldığında, append module_path to sys.path, kullanılır�tek bir belgede toplanıyor�özniteliği�hazırlayan adları�modüllerden otomatik olarak docstrings ekle�doctest bloklarında kod parçacıklarını otomatik olarak dene�bozuk bağlantı: %s (%s)�yapım %s, %s uyarı (hata olarak kabul edilen uyarılarla).�yapım %s, %s uyarı.�yapım %s, %s uyarı (hatalar olarak kabul edilen uyarılarla).�yapım %s, %s uyarı.�yapım %s.�yapım ortamı sürümü şu anki değil�mümkünse N işlem ile paralel olarak oluştur (özel değer "auto" N miktarını cpu-count değerine ayarlayacak)�oluşturma bilgisi dosyası bozuldu: %r�kullanmak için oluşturucu (varsayılan: html)�[%s] oluşturuluyor:�[mo] oluşturuluyor: �yerleşik işlev�çok büyük olabilir�-a seçeneği ve dosya adları birleştirilemiyor�indirilebilir dosya %r kopyalanamıyor: %s�fazladan dosya %r kopyalanamıyor...�resim dosyası %r kopyalanamıyor: %s�sabit dosya %r kopyalanamıyor�%r dosyaları bulunamıyor�uyarı dosyası %r açılamıyor: %s�desteklenmeyen tür ile yapılandırma ayarı %r geçersiz kılınamaz, yoksayılıyor�sözlük yapılandırma ayarı %r geçersiz kılınamaz, yoksayılıyor (tek tek öğeleri ayarlamak için %r kullanın)�resim dosyası %r okunamıyor: bunun yerine kopyalanıyor�resim dosyası %r yazılamıyor: %s�tutarlılık denetleniyor�belgelendirme kapsamı için denetlemeler�dairesel toctree kaynakları algılandı, yoksayılan: %s <- %s�sınıfı�sınıf yöntemi�komut satırı seçeneği�kavramı�yapılandırma değerlerine dayalı içeriğin koşullu olarak eklenmesi�yapılandırma değeri "epub_author", EPUB3 için boş olmamalıdır�yapılandırma değeri "epub_contributor", EPUB3 için boş olmamalıdır�yapılandırma değeri "epub_copyright" (veya "copyright"), EPUB3 için boş olmamalıdır�yapılandırma değeri "epub_description", EPUB3 için boş olmamalıdır�yapılandırma değeri "epub_identifier", EPUB3 için boş olmamalıdır�yapılandırma değeri "epub_language" (veya "language"), EPUB3 için boş olmamalıdır�yapılandırma değeri "epub_publisher", EPUB3 için boş olmamalıdır�yapılandırma değeri "epub_title" (veya "html_title"), EPUB3 için boş olmamalıdır�yapılandırma değeri "epub_uid", EPUB3 için XML NAME olmalıdır�yapılandırma değeri "version", EPUB3 için boş olmamalıdır�yapılandırma değişti�config dizini bir conf.py dosyası içermiyor (%s)�konsol çıktısı seçenekleri�önceki sayfadan devam�sonraki sayfaya devam�dönüştürme komutu %r çalıştırılamaz, image_converter ayarını gözden geçirin�dönüştürmeden hata ile çıkıldı: [stderr] %r [stdout] %r�TeX destek dosyaları kopyalanıyor�TeX destek dosyaları kopyalanıyor...�Texinfo destek dosyaları kopyalanıyor...�ilave dosyalar kopyalanıyor�indirilebilir dosyalar kopyalanıyor...�fazladan dosyalar kopyalanıyor�resimler kopyalanıyor...�kaynak dosyalar kopyalanıyor...�değişiklikler günlüğü oluşturma için %r okunamadı�belgeyi GitHub sayfalarında yayımlamak için .nojekyll dosyası oluştur�batchfile oluştur�makefile oluştur�verisi�varsayılan rol %s bulunamadı�bir şablon değişkeni tanımla�etiketi tanımla: "sadece" TAG'li blokları dahil et�yönergesi�yönerge %r zaten kayıtlı, geçersiz kılınacaktır�yönerge seçeneği�tüm çıktıların yerleştirileceği dizin�görüntü latex %r: %s�renkli çıktı yayımı yap (varsayılan: otomatik algıla)�batchfile oluşturma�makefile oluşturma�renkli çıktı yayımı yapma (varsayılan: otomatik algıla)�Makefile/make.bat için make-mode kullanma�yazmak için belge adları: %s�belge�belge herhangi bir toctree içine dahil değil�belge dili�belge okunabilir değil. Yoksayıldı.�%s seri nosu yapılıyor�etki alanı %s zaten kayıtlı�etki alanı %s henüz kayıtlı değil�içindekiler tablosu oluşturma�modül/paket paketleri için başlıklar oluşturma (örn. docstrings zaten bunları içerdiğinde)�kaydedilmiş bir ortam kullanma, her zaman tüm dosyaları oku�bitti�nokta kodu %r: %s�indirme dosyası okunabilir değil: %s�nesne envanteri dökümleniyor�%s içinde arama dizini dökümleniyor�kopya %s açıklamasına ait %s, diğer %s, %s içinde�kopya %s açıklamasına ait %s, %s içindeki diğer örnek �%s kopya alıntısı, %s içindeki diğer örnek�%s %s kopya açıklaması, %s içindeki diğer örnek�%s kopya etiketi, %s içindeki diğer örnek�%s denkleminin kopya etiketi, %s içindeki diğer örnek�%s kopya nesne açıklaması, %s içindeki diğer örnek, bunlardan biri için :noindex: kullanın�kopyalanmış ToC girişi bulundu: %s�%s uzantısını etkinleştir�rasgele uzantıları etkinleştir�enum�enumerable_node %r zaten kayıtlı�numaralandırıcı�ortam değişkeni�ortam değişkeni; %s�%s dosyası yazılırken hata oldu: %s�Makefile dosyası yazılırken hata oldu: %s�özel durum�%r uzantısı setup() işlevine sahip değil; bu gerçekten bir Sphinx uzantısı modülü mü?�%r uzantısı, setup() işlevinden desteklenmeyen bir nesne döndürdü; Hiçbir şey veya üstveri sözlüğü döndürmeli�uzantı seçenekleri�uzantılar değişti�başarısız oldu�aşağıdaki sorunlardan dolayı envanterlerden herhangi birine ulaşılamadı:�başarısız olan: %s�favicon dosyası %r mevcut değil�komut satırında verilen %r dosyası mevcut değil, yoksayılıyor�komut satırında verilen %r dosyası kaynak dizinin altında değil, yoksayılıyor�tema yolundaki %r dosyası geçerli bir zip dosyası değil ya da hiç tema içermiyor�dosya soneki (varsayılan: rst)�içindekiler dosyası adı (varsayılan: modüller)�sorunlarla tamamlandı�nesilden hariç tutmak için fnmatch-style dosyası ve/veya dizin şekilleri�sembolik bağlantıları takip edin. Collective.recipe.omelette ile birleştirildiğinde güçlü.�işlevi�genel seçenekler�sphinx-quickstart ile tam bir proje oluştur�dizinler oluşturuluyor�sözlük yanlış biçimlendirilmiş gibi görünüyor, girintiyi gözden geçirin�sözlük terimi�sözlük teriminden önce boş satır gelmek zorundadır�sözlük terimleri boş satırlarla ayrılmamak zorundadır�dilbilgisi belirteci�html_extra_path girişi %r mevcut değil�html_extra_path girişi %r, çıktı dizini içine yerleştirildi�html_static_path girişi %r mevcut değil�html_static_path girişi %r, çıktı dizini içine yerleştirildi�eğer belirtildiyse, kaynak ve oluşturma dizinlerini ayırın�%s resim dosyası okunabilir değil: %s�resim dosyası okunabilir değil: %s�"_private" modülleri dahil�belgelenmiş Python nesnelerinin kaynak koduna bağlantıları dahil et�PNG veya SVG resimleri olarak işleneni, matematiği dahil et�MathJax ile tarayıcıda işleneni, matematiği dahil et�ayrıntı seviyesini artır (tekrarlanabilir)�dizin�satır içi latex %r: %s�modül yollarını PEP-0420 kapalı ad alanları özelliklerine göre yorumla�intersphinx envanteri taşındı: %s -> %s�geçersiz css_file: %r, yoksayıldı�geçersiz js_file: %r, yoksayıldı�geçersiz sayı %r; yapılandırma değeri %r için; yoksayılıyor�geçersiz numfig_format: %s�geçersiz numfig_format: %s (%r)�iş numarası pozitif bir sayı olmalıdır�anahtar kelime�add_node() için kwargs bir (visit, depart) tanımlama grubu işlevi olmak zorundadır: %r=%r�son güncelleme�satır numarası özellikleri aralık dışında (1-%d): %r�farklı projelerin Sphinx begelendirmeleri arasında bağlantıla�tüm bölümleri ve alt bölümleri listeler�%s konumundan intersphinx envanteri yükleniyor...�derin temizlenen ortam yükleniyor�çeviriler yükleniyor [%s]... �logo dosyası %r mevcut değil�şimdi güncel olmayan dosyalar aranıyor...�makrosu�çıktı dizini yapılıyor�asıl belge adı�TOC'da gösterilecek alt modüllerin en fazla derinliği (varsayılan: 4)�üyesi�yöntemi�modülü�modülleri�çapraz referans %r için birden fazla hedef bulundu: %s�yeni yapılandırma�sonraki�sonraki bölüm�nit-picky kipi, tüm eksik kaynaklar hakkında uyar�hiçbir "latex_documents" yapılandırma değeri bulunamadı; hiçbir belge yazılmayacaktır�hiçbir "man_pages" yapılandırma değeri bulunamadı; hiçbir rehber sayfası yazılmayacaktır�hiçbir "texinfo_documents" yapılandırma değeri bulunamadı; hiçbir belge yazılmayacaktır�%r dili için bilinen hiç Babel seçeneği yok�%s sürümünde değişiklik yok.�hiç çıktı yok, hatta uyarılarda bile�stdout üzerinde çıktı yok, stderr üzerinde sadece uyarılar�hiçbir hedef güncel değil.�%r adında bulunan tema yok (eksik theme.conf?)�%r adında bulunan tema yok, %r tarafından devralındı�düğüm sınıfı %r zaten kayıtlı, ziyaretçileri geçersiz kılınacaktır�hiç bulunamadı�yerleşik iletiler için kullanılamaz�numfig etkisizleştirildi. :numref: yoksayıldı.�nesne�işleç�özgün giriş�yapılandırma dosyasındaki bir ayarı geçersiz kıl�varolan dosyaların üzerine yaz�sayfa�sayfa %s html_sidebars içinde iki şekille eşleşiyor: %r ve %r�HTML şablonlarına bir değer geçir�önbelleklenen ortam ve doctree dosyaları için yol (varsayılan: OUTPUTDIR/.doctrees)�belgelendirme kaynak dosyaları için yol�belge için modüle giden yol�çıktı dizini için yol�yapılandırma dosyasının (conf.py) bulunduğu yol (varsayılan: SOURCEDIR ile aynı)�ortam derin temizleniyor�belgeler hazırlanıyor�önceki�önceki bölüm�primary_domain %r bulunamadı, yoksayıldı.�%s işleniyor�program seçeneği�--full yazıldığında, proje hazırlayan(lar)ı kullanılır�proje adı�proje adı (varsayılan: kök modül adı)�--full yazıldığında, varsayılanı to --doc-version, proje yayımı kullanılır�proje kök dizini�--full yazıldığında, proje sürümü kullanılır�her modül için belgelendirmeyi kendi sayfasına koy�modül belgelerini alt modül belgelerinin önüne koyun�tüm modüllere hızlı erişim�sessiz kipi�reST biçimlendirme hatası:�okuma hatası: %s, %s�kaynaklar okunuyor...�şablonlar okunuyor...�başvuru etiketi�projenin yayımı�_templates vb. içinde nokta için değiştirme�başvurular çözümleniyor...�rolü�rol %r zaten kayıtlı, geçersiz kılınacaktır�özel durumda Pdb çalıştır�dosyaları oluşturmadan betiği çalıştır�ara�arama dizini yüklenemedi, ancak tüm belgeler oluşturulmayacaktır: dizin tamamlanmamış olacaktır.�bu belgelendirmeyi ara�bakınız %s�ayrıca bakınız %s�kendinden kaynaklı toctree bulundu. Yoksayıldı.�%s.%s ayarı, aranan tema yapılandırmalarının hiçbirinde meydana gelmiyor�özel durumda tam geri izleme göster�atlandı�kaynak dizin değişti�kaynak dosya soneki�%r için source_parser zaten kayıtlı�source_suffix %r zaten kayıtlı�sfenks-quickstart sadece boş bir dizin içine oluşturur. Lütfen yeni bir kök dizin yolu belirtin.�sfenks-quickstart varolan Sphinx projelerinin üzerine yazmayacak.�sfenks-quickstart varolan dosyanın üzerine yazmayacak.�ifade�sabit yöntemi�başarılı oldu�güncel olmayan %d po dosyası için hedefler�belirtilen %d po dosyası için hedefler�güncel olmayan %d kaynak dosyası için hedefler�%d şablon dosyası için hedefler�şablon dosyaları için şablon dizini�%s uzantısı paralel okuma için güvenli olup olmadığını bildirmez, olmadığını varsayarak - lütfen uzantıyı hazırlayandan gözden geçirmesini ve açık hale getirmesini isteyin�%s uzantısı paralel yazma için güvenli olup olmadığını bildirmez, olmadığını varsayarak - lütfen uzantıyı hazırlayandan gözden geçirmesini ve açık hale getirmesini isteyin�%s uzantısı paralel okuma için güvenli değil�%s uzantısı paralel yazma için güvenli değil�belgelendirme konusu: �%r uzantısı zaten %s sürümünden bu yana Sphinx ile birleştirildi; bu uzantı yoksayıldı.�bağlantının resim yazısı yok: %s�%r temasının "inherit" ayarı yok�%r temasının "theme" ayarı yok�toctree, başlığı olmayan %r belgesine başvuru içeriyor: hiç bağlantı oluşturulmayacaktır�toctree, hariç tutulan %r belgesine başvuru içeriyor�toctree, varolmayan %r belgesine başvuru içeriyor�uyarıları hatalara dönüştür�türü�birliği�geçersiz kılmada bilinmeyen yapılandırma değeri %r, yoksayılıyor�bilinmeyen dizin girişi türü %r�%s için bilinmeyen mime türü, yoksayılıyor�desteklenmeyen tema seçeneği %r verildi�güncellenen ortam:�epub kullan�Makefile/make.bat için make-mode kullan�hiç yapılandırma dosyası kullanmadan, sadece -D seçenekleri�değişkeni�projenin sürümü�çalışanlar için bekleniyor...�"builder" burada desteklenen oluşturuculardan biridir, örn. html, latex veya linkcheck.�%s uzantısı ayarlanırken:�-W ile, uyarıları alırken devam et�oluşturmada gösterilebilen veya gizlenebilen "yapılacaklar" girişlerini yaz�tüm dosyaları yaz (varsayılan: sadece yeni ve değiştirilmiş dosyaları yaz)�verilen dosyaya uyarıları (ve hataları) yaz�yazılıyor�%s dosyası yazılıyor...�ilave dosyalar yazılıyor�ilave sayfalar yazılıyor�yazma hatası: %s, %s�ileti katalogları yazılıyor...�çıktı yazılıyor...�özet dosyası yazılıyor...�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/tr/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000324211�00000000000�021171� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # BouRock, 2020 # Fırat Özgül <ozgulfirat@gmail.com>, 2013-2016 # FIRST AUTHOR <EMAIL@ADDRESS>, 2011 # tamerb2050 <tamerb2050@gmail.com>, 2020 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Turkish (http://www.transifex.com/sphinx-doc/sphinx-1/language/tr/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: tr\n" "Plural-Forms: nplurals=2; plural=(n > 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "Kaynak dizin bulunamıyor (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "Kaynak dizin ve hedef dizin aynı olamaz" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "Sphinx s%s çalışıyor" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "Bu proje en az Sphinx s%s gerektirir ve bu nedenle bu sürüm ile oluşturulamaz." #: sphinx/application.py:243 msgid "making output directory" msgstr "çıktı dizini yapılıyor" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "%s uzantısı ayarlanırken:" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "Şu anda conf.py dosyasında tanımlanan 'kurulum' çağrılabilir bir Python değil. Lütfen tanımını çağrılabilir bir işlev yapmak için değiştirin. Bunun, Sphinx uzantısı gibi davranması için conf.py dosyasına ihtiyacı vardır." #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "çeviriler yükleniyor [%s]... " #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "bitti" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "yerleşik iletiler için kullanılamaz" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "derin temizlenen ortam yükleniyor" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "başarısız olan: %s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "Seçilen oluşturucu yok, varsayılan kullanılıyor: html" #: sphinx/application.py:348 msgid "succeeded" msgstr "başarılı oldu" #: sphinx/application.py:349 msgid "finished with problems" msgstr "sorunlarla tamamlandı" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "yapım %s, %s uyarı (hata olarak kabul edilen uyarılarla)." #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "yapım %s, %s uyarı (hatalar olarak kabul edilen uyarılarla)." #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "yapım %s, %s uyarı." #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "yapım %s, %s uyarı." #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "yapım %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "düğüm sınıfı %r zaten kayıtlı, ziyaretçileri geçersiz kılınacaktır" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "yönerge %r zaten kayıtlı, geçersiz kılınacaktır" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "rol %r zaten kayıtlı, geçersiz kılınacaktır" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "%s uzantısı paralel okuma için güvenli olup olmadığını bildirmez, olmadığını varsayarak - lütfen uzantıyı hazırlayandan gözden geçirmesini ve açık hale getirmesini isteyin" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "%s uzantısı paralel okuma için güvenli değil" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "%s uzantısı paralel yazma için güvenli olup olmadığını bildirmez, olmadığını varsayarak - lütfen uzantıyı hazırlayandan gözden geçirmesini ve açık hale getirmesini isteyin" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "%s uzantısı paralel yazma için güvenli değil" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "%s seri nosu yapılıyor" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "config dizini bir conf.py dosyası içermiyor (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "sözlük yapılandırma ayarı %r geçersiz kılınamaz, yoksayılıyor (tek tek öğeleri ayarlamak için %r kullanın)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "geçersiz sayı %r; yapılandırma değeri %r için; yoksayılıyor" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "desteklenmeyen tür ile yapılandırma ayarı %r geçersiz kılınamaz, yoksayılıyor" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "geçersiz kılmada bilinmeyen yapılandırma değeri %r, yoksayılıyor" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "Böyle bir yapılandırma değeri yok: %s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "Yapılandırma değeri %r zaten mevcut" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "Yapılandırma dosyanızda bir sözdizimi hatası var: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "Yapılandırma dosyası (veya içe aktarılan modüllerden biri) sys.exit() olarak adlandırılır" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "Yapılandırma dosyanızda programlanabilir bir hata var:\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "'source_suffix' yapılandırma değeri bir dizgi, dizgiler listesi ya da sözlük bekler. Ama '%r' verilir." #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "Bölüm %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "Şekil %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "Tablo %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "Listeleme %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "`{name}` yapılandırma değeri, {candidates} geğerlrinden biri olmak zorundadır, ancak `{current}` değeridir." #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "`{name}' yapılandırma değeri `{current.__name__}' türüne sahip; beklenen {permitted}." #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "`{name}' yapılandırma değeri `{current.__name__}' türüne sahip, vassayılanları `{default.__name__}'." #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "primary_domain %r bulunamadı, yoksayıldı." #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "Olay %r zaten mevcut" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "Bilinmeyen olay adı: %s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "%s uzantısı needs_extensions ayarları tarafından gereklidir, ancak yüklü değildir." #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "Bu projenin %s uzantısına ve en az %s sürümüne ihtiyacı vardır ve bu nedenle yüklenen sürümle oluşturulamaz (%s)." #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "Pygments lexer adı %r bilinmiyor" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "\"%s\" olarak literal_block lex yapılamadı. Vurgulama atlandı." #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "belge okunabilir değil. Yoksayıldı." #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "Oluşturucu sınıfı %s \"ad\" özniteliğine sahip değil" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Oluşturucu %r zaten mevcut (%s modülünde)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Oluşturucu adı %s kayıtlı veya giriş noktası aracılığıyla kullanılabilir değil" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "Oluşturucu adı %s kayıtlı değil" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "etki alanı %s zaten kayıtlı" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "etki alanı %s henüz kayıtlı değil" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "%r yönergesi zaten %s etki alanına kayıtlı" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "%r rolü zaten %s etki alanına kayıtlı" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "%r dizini zaten %s etki alanına kayıtlı" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "%r object_type zaten kayıtlı" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "%r crossref_type zaten kayıtlı" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "source_suffix %r zaten kayıtlı" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "%r için source_parser zaten kayıtlı" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "%s için kaynak ayrıştırıcı kayıtlı değil" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "%r için çevirmen zaten mevcut" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "add_node() için kwargs bir (visit, depart) tanımlama grubu işlevi olmak zorundadır: %r=%r" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "enumerable_node %r zaten kayıtlı" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "%r uzantısı zaten %s sürümünden bu yana Sphinx ile birleştirildi; bu uzantı yoksayıldı." #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "Özgün özel durumu:\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr " %s uzantısı içe aktarılamadı" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "%r uzantısı setup() işlevine sahip değil; bu gerçekten bir Sphinx uzantısı modülü mü?" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "Bu proje tarafından kullanılan %s uzantısının en az Sphinx s%s sürümüne ihtiyacı var; bu nedenle bu sürümle oluşturulamaz." #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "%r uzantısı, setup() işlevinden desteklenmeyen bir nesne döndürdü; Hiçbir şey veya üstveri sözlüğü döndürmeli" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Geliştirme Önerileri; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "%r temasının \"theme\" ayarı yok" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "%r temasının \"inherit\" ayarı yok" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "%r adında bulunan tema yok, %r tarafından devralındı" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "%s.%s ayarı, aranan tema yapılandırmalarının hiçbirinde meydana gelmiyor" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "desteklenmeyen tema seçeneği %r verildi" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "tema yolundaki %r dosyası geçerli bir zip dosyası değil ya da hiç tema içermiyor" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "%r adında bulunan tema yok (eksik theme.conf?)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "%s oluşturucu için uygun bir resim bulunamadı: %s (%s)" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "%s oluşturucu için uygun bir resim bulunamadı: %s" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "[mo] oluşturuluyor: " #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "çıktı yazılıyor..." #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "%d po dosyasının tümü" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "belirtilen %d po dosyası için hedefler" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "güncel olmayan %d po dosyası için hedefler" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "tüm kaynak dosyaları" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "komut satırında verilen %r dosyası kaynak dizinin altında değil, yoksayılıyor" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "komut satırında verilen %r dosyası mevcut değil, yoksayılıyor" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "komut satırında verilen %d kaynak dosyası" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "güncel olmayan %d kaynak dosyası için hedefler" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "[%s] oluşturuluyor:" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "şimdi güncel olmayan dosyalar aranıyor..." #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "%d tane bulundu" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "hiç bulunamadı" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "ortam derin temizleniyor" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "tutarlılık denetleniyor" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "hiçbir hedef güncel değil." #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "güncellenen ortam:" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "%s eklendi, %s değiştirildi, %s kaldırıldı" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "kaynaklar okunuyor..." #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "çalışanlar için bekleniyor..." #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "yazmak için belge adları: %s" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "belgeler hazırlanıyor" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "kopyalanmış ToC girişi bulundu: %s" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "resimler kopyalanıyor..." #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "resim dosyası %r okunamıyor: bunun yerine kopyalanıyor" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "resim dosyası %r kopyalanamıyor: %s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "resim dosyası %r yazılamıyor: %s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "Yastık bulunamadı - resim dosyaları kopyalanıyor" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "%s için bilinmeyen mime türü, yoksayılıyor" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "%s dosyası yazılıyor..." #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "Genel bakış dosyası %(outdir)s içinde." #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "%s sürümünde değişiklik yok." #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "özet dosyası yazılıyor..." #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Yerleşikler" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Modül seviyesi" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "kaynak dosyalar kopyalanıyor..." #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "değişiklikler günlüğü oluşturma için %r okunamadı" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "Taklit oluşturucu hiçbir dosya oluşturmaz." #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "ePub dosyası %(outdir)s içinde." #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "yapılandırma değeri \"epub_language\" (veya \"language\"), EPUB3 için boş olmamalıdır" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "yapılandırma değeri \"epub_uid\", EPUB3 için XML NAME olmalıdır" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "yapılandırma değeri \"epub_title\" (veya \"html_title\"), EPUB3 için boş olmamalıdır" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "yapılandırma değeri \"epub_author\", EPUB3 için boş olmamalıdır" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "yapılandırma değeri \"epub_contributor\", EPUB3 için boş olmamalıdır" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "yapılandırma değeri \"epub_description\", EPUB3 için boş olmamalıdır" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "yapılandırma değeri \"epub_publisher\", EPUB3 için boş olmamalıdır" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "yapılandırma değeri \"epub_copyright\" (veya \"copyright\"), EPUB3 için boş olmamalıdır" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "yapılandırma değeri \"epub_identifier\", EPUB3 için boş olmamalıdır" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "yapılandırma değeri \"version\", EPUB3 için boş olmamalıdır" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "geçersiz css_file: %r, yoksayıldı" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "İleti katalogları %(outdir)s içinde." #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "%d şablon dosyası için hedefler" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "şablonlar okunuyor..." #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "ileti katalogları yazılıyor..." #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "Yukarıdaki çıktıda veya %(outdir)s/output.txt içinde herhangi bir hata arayın" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "bozuk bağlantı: %s (%s)" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "Bağlayıcı '%s' bulunamadı" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "Rehber sayfaları %(outdir)s içinde." #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "hiçbir \"man_pages\" yapılandırma değeri bulunamadı; hiçbir rehber sayfası yazılmayacaktır" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "yazılıyor" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "\"man_pages\" yapılandırma değeri bilinmeyen %s belgesine başvurur" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "HTML sayfası %(outdir)s içinde." #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "tek bir belgede toplanıyor" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "ilave dosyalar yazılıyor" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "Texinfo dosyaları %(outdir)s içinde." #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "\nMakeinfo aracılığıyla bunları çalıştırmak için bu dizinde 'make' komutunu çalıştırın\n(bunu otomatik olarak yapmak için burada 'make info' komutunu kullanın)." #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "hiçbir \"texinfo_documents\" yapılandırma değeri bulunamadı; hiçbir belge yazılmayacaktır" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "\"texinfo_documents\" yapılandırma değeri bilinmeyen %s belgesine başvurur" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "%s işleniyor" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "başvurular çözümleniyor..." #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (şurada: " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "Texinfo destek dosyaları kopyalanıyor..." #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "Makefile dosyası yazılırken hata oldu: %s" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "Metin dosyaları %(outdir)s içinde." #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "%s dosyası yazılırken hata oldu: %s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "XML dosyaları %(outdir)s içinde." #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "Pseudo-XML dosyaları %(outdir)s içinde." #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "oluşturma bilgisi dosyası bozuldu: %r" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "HTML sayfaları %(outdir)s içinde." #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "oluşturma bilgisi dosyasını okuma başarısız: %r" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d %b %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Genel Dizin" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "dizin" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "sonraki" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "önceki" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "dizinler oluşturuluyor" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "ilave sayfalar yazılıyor" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "indirilebilir dosyalar kopyalanıyor..." #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "indirilebilir dosya %r kopyalanamıyor: %s" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "sabit dosya %r kopyalanamıyor" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "fazladan dosyalar kopyalanıyor" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "fazladan dosya %r kopyalanamıyor..." #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "oluşturma bilgisi dosyasını yazma başarısız: %r" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "arama dizini yüklenemedi, ancak tüm belgeler oluşturulmayacaktır: dizin tamamlanmamış olacaktır." #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "sayfa %s html_sidebars içinde iki şekille eşleşiyor: %r ve %r" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "%s sayfasını işlerken bir Evrensel kod hatası meydana geldi. Lütfen ASCII olmayan içerik içeren tüm yapılandırma değerlerinin Evrensel kod dizgiler olduğundan emin olun." #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "%s sayfasını işlerken bir hata oldu.\nSebep: %r" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "nesne envanteri dökümleniyor" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "%s içinde arama dizini dökümleniyor" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "geçersiz js_file: %r, yoksayıldı" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "Birçok math_renderers kayıtlı. Ama hiç math_renderer seçilmedi." #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "Bilinmeyen math_renderer %r verildi." #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "html_extra_path girişi %r mevcut değil" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "html_extra_path girişi %r, çıktı dizini içine yerleştirildi" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "html_static_path girişi %r mevcut değil" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "html_static_path girişi %r, çıktı dizini içine yerleştirildi" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "logo dosyası %r mevcut değil" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "favicon dosyası %r mevcut değil" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s belgelendirmesi" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "LaTeX dosyaları %(outdir)s içinde." #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\n(pdf)latex aracılığıyla bunları çalıştırmak için bu dizinde 'make' komutunu çalıştırın\n(bunu otomatik olarak yapmak için burada 'make latexpdf' komutunu kullanın)." #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "hiçbir \"latex_documents\" yapılandırma değeri bulunamadı; hiçbir belge yazılmayacaktır" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "\"latex_documents\" yapılandırma değeri bilinmeyen %s belgesine başvurur" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Dizin" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Yayım" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "%r dili için bilinen hiç Babel seçeneği yok" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "TeX destek dosyaları kopyalanıyor" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "TeX destek dosyaları kopyalanıyor..." #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "ilave dosyalar kopyalanıyor" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "Bilinmeyen yapılandırma anahtarı: latex_elements[%r], yoksayıldı." #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "%r, \"theme\" ayarına sahip değil" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "%r, \"%s\" ayarına sahip değil" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "Oluşturulurken meydana gelen özel durum, hata ayıklayıcı başlatılıyor:" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "Yarıda kesildi!" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "reST biçimlendirme hatası:" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "Kodlama hatası:" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "Sorunu geliştiricilere bildirmek istiyorsanız, tam geri izleme %s içine kaydedildi." #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "Tekrarlama hatası:" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "Özel durum meydana geldi:" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "Bir dahaki sefere daha iyi bir hata iletisi sağlanabilmesi için lütfen bunu bir kullanıcı hatasıysa da bildirin." #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "Bir hata raporu <https://github.com/sphinx-doc/sphinx/issues> adresindeki izleyicide dosyalanabilir. Teşekkürler!" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "iş numarası pozitif bir sayı olmalıdır" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "belgelendirme kaynak dosyaları için yol" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "çıktı dizini için yol" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "yeniden oluşturmak için belirli dosyaların listesi. Belirtildiyse yoksayıldı" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "genel seçenekler" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "kullanmak için oluşturucu (varsayılan: html)" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "tüm dosyaları yaz (varsayılan: sadece yeni ve değiştirilmiş dosyaları yaz)" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "kaydedilmiş bir ortam kullanma, her zaman tüm dosyaları oku" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "önbelleklenen ortam ve doctree dosyaları için yol (varsayılan: OUTPUTDIR/.doctrees)" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "mümkünse N işlem ile paralel olarak oluştur (özel değer \"auto\" N miktarını cpu-count değerine ayarlayacak)" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "yapılandırma dosyasının (conf.py) bulunduğu yol (varsayılan: SOURCEDIR ile aynı)" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "hiç yapılandırma dosyası kullanmadan, sadece -D seçenekleri" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "yapılandırma dosyasındaki bir ayarı geçersiz kıl" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "HTML şablonlarına bir değer geçir" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "etiketi tanımla: \"sadece\" TAG'li blokları dahil et" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "nit-picky kipi, tüm eksik kaynaklar hakkında uyar" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "konsol çıktısı seçenekleri" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "ayrıntı seviyesini artır (tekrarlanabilir)" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "stdout üzerinde çıktı yok, stderr üzerinde sadece uyarılar" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "hiç çıktı yok, hatta uyarılarda bile" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "renkli çıktı yayımı yap (varsayılan: otomatik algıla)" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "renkli çıktı yayımı yapma (varsayılan: otomatik algıla)" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "verilen dosyaya uyarıları (ve hataları) yaz" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "uyarıları hatalara dönüştür" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "-W ile, uyarıları alırken devam et" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "özel durumda tam geri izleme göster" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "özel durumda Pdb çalıştır" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "%r dosyaları bulunamıyor" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "-a seçeneği ve dosya adları birleştirilemiyor" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "uyarı dosyası %r açılamıyor: %s" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "-D seçeneği bağımsız değişkeni ad=değer biçiminde olmak zorundadır" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "-A seçeneği bağımsız değişkeni ad=değer biçiminde olmak zorundadır" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "modüllerden otomatik olarak docstrings ekle" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "doctest bloklarında kod parçacıklarını otomatik olarak dene" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "farklı projelerin Sphinx begelendirmeleri arasında bağlantıla" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "oluşturmada gösterilebilen veya gizlenebilen \"yapılacaklar\" girişlerini yaz" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "belgelendirme kapsamı için denetlemeler" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "PNG veya SVG resimleri olarak işleneni, matematiği dahil et" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "MathJax ile tarayıcıda işleneni, matematiği dahil et" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "yapılandırma değerlerine dayalı içeriğin koşullu olarak eklenmesi" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "belgelenmiş Python nesnelerinin kaynak koduna bağlantıları dahil et" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "belgeyi GitHub sayfalarında yayımlamak için .nojekyll dosyası oluştur" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "Lütfen geçerli bir yol adı girin." #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "Lütfen biraz metin girin." #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "Lütfen %s seçeneklerinden birini girin." #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "Lütfen ya 'y' ya da 'n' girin." #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "Lütfen bir dosya soneki girin, örn. '.rst' veya '.txt'." #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "Sphinx %s hızlı başlangıç yardımcı uygulamasına hoş geldiniz." #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "Lütfen aşağıdaki ayarlar için değerleri girin (parantez içinde verilirse\nvarsayılan değeri kabul etmek için yalnızca Enter tuşuna basın)." #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "Seçilen kök dizin yolu: %s" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "Belgelendirme için kök dizin yolunu girin." #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "Belgelendirme için kök dizin yolu" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "Hata: seçilen kök dizin yolunda varolan bir conf.py bulundu." #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "sfenks-quickstart varolan Sphinx projelerinin üzerine yazmayacak." #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "Lütfen yeni bir kök dizin yolu girin (ya da çıkmak için yalnızca Enter'a basın)" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "Sphinx çıktısının oluşturma dizinini yerleştirmek için iki seçeneğiniz var.\nYa, kök dizin yolu içinde bir \"_build\" dizini kullanın, ya da kök dizin yolu\niçinde \"source\" ve \"build\" dizinlerini ayırın." #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "Source ve build dizinlerini ayır (y/n)" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "Kök dizinin içinde, iki dizin daha oluşturulacaktır; özel HTML şablonları için \"_templates\"\nve özel stil sayfaları ve diğer sabit dosyalar için \"_static\".\nAlt çizgi yerine başka bir önek (\".\" gibi) girebilirsiniz." #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "Templates ve static dizinleri için ad öneki" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "Proje adı, oluşturulan belgelendirmedeki çeşitli yerlerde oluşacak." #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "Proje adı" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "Hazırlayan ad(ları)ı" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "Proje sürümü" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "Proje yayımı" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "Eğer belgeler İngilizce dışında bir dilde yazıldıysa, bunun dil koduna\ngöre burada bir dil seçebilirsiniz. Sphinx daha sonra, ürettiği metni o\ndile çevirecektir.\n\nDesteklenen kodların listesi için\nhttps://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language adresine bakın." #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "Proje dili" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "Kaynak dosya soneki" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "Bir belge, \"içindekiler ağacı\"nın üst düğümü olarak kabul edilmesi, yani\nbelgelerin hiyerarşik yapısının kökü olması açısından özeldir.\nNormalde bu \"dizin\"dir, ancak \"dizin\" belgeniz özel bir şablonsa,\nbunu başka bir dosya adına da ayarlayabilirsiniz." #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "Asıl belgenizin adı (sonek olmadan)" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "Hata: %s asıl dosyası zaten seçilen kök dizin yolunda bulundu." #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "sfenks-quickstart varolan dosyanın üzerine yazmayacak." #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "Lütfen yeni bir dosya adı girin ya da varolan dosyayı yeniden adlandırın ve Enter tuşuna basın" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "Aşağıdaki Sphinx uzantılarından hangisinin etkinleştirilmesi gerektiğini gösterir:" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "Not: imgmath ve mathjax aynı anda etkinleştirilemez. imgmath seçimi kaldırıldı." #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "Makefile ve Windows komut dosyası sizin için oluşturulabilir,\nböylece doğrudan örn. sphinx-build çağırmak yerine sadece\n`make html' komutu çalıştırılmak zorundadır." #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "Makefile oluşturulsun mu? (y/n)" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "Windows komut satırı oluşturulsun mu? (y/n)" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "%s dosyası oluşturuluyor." #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "%s dosyası zaten var, atlanıyor." #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "Tamamlandı: İlk dizin yapısı oluşturuldu." #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "Artık %s asıl dosyanızı doldurmalı ve diğer belgelendirme kaynak dosyalarını\noluşturmalısınız." #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "Belgeleri oluşturmak için Makefile'ı kullanın, aşağıdaki gibi:\n make builder" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "Belgeleri oluşturmak için sphinx-build komutunu kullanın, aşağıdaki gibi:\n sphinx-build -b builder %s %s" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "\"builder\" burada desteklenen oluşturuculardan biridir, örn. html, latex veya linkcheck." #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "\nBir Sphinx projesi için gerekli dosyaları oluşturun.\n\nsphinx-quickstart, projeniz hakkında bazı sorular soran ve ardından tam bir\nbelgelendirme dizini ve örnek oluşturan etkileşimli bir araçtır\nMakefile, sphinx-build ile kullanılır.\n" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "sessiz kipi" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "proje kök dizini" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "Yapı seçenekleri" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "eğer belirtildiyse, kaynak ve oluşturma dizinlerini ayırın" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "_templates vb. içinde nokta için değiştirme" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "Proje temel seçenekleri" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "proje adı" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "hazırlayan adları" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "projenin sürümü" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "projenin yayımı" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "belge dili" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "kaynak dosya soneki" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "asıl belge adı" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "epub kullan" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "Uzantı seçenekleri" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "%s uzantısını etkinleştir" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "rasgele uzantıları etkinleştir" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "Makefile ve Batchfile oluşturma" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "makefile oluştur" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "makefile oluşturma" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "batchfile oluştur" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "batchfile oluşturma" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "Makefile/make.bat için make-mode kullan" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "Makefile/make.bat için make-mode kullanma" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "Proje şablonlama" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "şablon dosyaları için şablon dizini" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "bir şablon değişkeni tanımla" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "\"sessiz\" belirtilmiş, ancak herhangi bir \"proje\" veya \"hazırlayan\" belirtilmemiş." #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "Hata: belirtilen yol bir dizin değil ya da sphinx dosyaları zaten var." #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "sfenks-quickstart sadece boş bir dizin içine oluşturur. Lütfen yeni bir kök dizin yolu belirtin." #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "Geçersiz şablon değişkeni: %s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "Geçersiz resim yazısı: %s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "satır numarası özellikleri aralık dışında (1-%d): %r" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "Hem \"%s\" hem de \"%s\" seçeneği kullanılamıyor" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "Dahil edilen %r dosyası bulunamadı ya da dosyayı okuma başarısız oldu" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "%r kodlamasının kullanıldığı, dahil edilen %r dosyasını okuma yanlış gibi görünüyor, bir :encoding: seçeneği vermeyi deneyin" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "%r adlı nesne, dahil edilen %r dosyasında bulunamadı" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "Ayrık bir \"satır\" kümesiyle \"lineno-match\" kullanılamıyor" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "Satır özelliği %r: dahil edilen %r dosyasından çekilen hiç satır yok" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Bölümü hazırlayan: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Modülü hazırlayan: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Kodu hazırlayan: " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Hazırlayan: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Parametreler" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "Dönüşler" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "Dönüş türü" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "üyesi" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "değişkeni" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "işlevi" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "makrosu" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "birliği" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "enum" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "numaralandırıcı" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "türü" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "%s sürümünde geldi" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "%s sürümünde değişti" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "%s sürümünden beri kullanım dışı" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "%s kopya alıntısı, %s içindeki diğer örnek" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "Alıntı [%s] kaynak gösterilmedi." #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "Şablon Parametreleri" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Şunu verir: " #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "sınıfı" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "kavramı" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (yerleşik işlev)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s yöntemi)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (sınıf)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (genel değişken veya sabit)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s özniteliği)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Bağımsız Değişkenler" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (modül)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "yöntemi" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "verisi" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "özniteliği" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "modülü" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "kopya %s açıklamasına ait %s, diğer %s, %s içinde" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "%s denkleminin kopya etiketi, %s içindeki diğer örnek" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "Geçersiz math_eqref_format: %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "anahtar kelime" #: sphinx/domains/python.py:60 msgid "operator" msgstr "işleç" #: sphinx/domains/python.py:61 msgid "object" msgstr "nesne" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "özel durum" #: sphinx/domains/python.py:63 msgid "statement" msgstr "ifade" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "yerleşik işlev" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "Değişkenler" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "Harekete geçirir" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (%s modülü içinde)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (%s modülü içinde)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (yerleşik değişken)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (yerleşik sınıf)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (%s içindeki sınıf)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s sınıf yöntemi)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s sabit yöntemi)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Python Modül Dizini" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "modülleri" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "Kullanım dışı" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "sınıf yöntemi" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "sabit yöntemi" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "%s kopya nesne açıklaması, %s içindeki diğer örnek, bunlardan biri için :noindex: kullanın" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "çapraz referans %r için birden fazla hedef bulundu: %s" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (kullanım dışı)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (yönerge)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr ":%s: (yönerge seçeneği)" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (rol)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "yönergesi" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "yönerge seçeneği" #: sphinx/domains/rst.py:210 msgid "role" msgstr "rolü" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "%s %s kopya açıklaması, %s içindeki diğer örnek" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "ortam değişkeni; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "Hatalı biçimlendirilmiş seçenek açıklaması %r, \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" veya \"+opt args\" şeklinde görünmelidir" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "%s komut satırı seçeneği" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "komut satırı seçeneği" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "sözlük teriminden önce boş satır gelmek zorundadır" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "sözlük terimleri boş satırlarla ayrılmamak zorundadır" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "sözlük yanlış biçimlendirilmiş gibi görünüyor, girintiyi gözden geçirin" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "sözlük terimi" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "dilbilgisi belirteci" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "başvuru etiketi" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "ortam değişkeni" #: sphinx/domains/std.py:568 msgid "program option" msgstr "program seçeneği" #: sphinx/domains/std.py:569 msgid "document" msgstr "belge" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Modül Dizini" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Arama Sayfası" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "%s kopya etiketi, %s içindeki diğer örnek" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "kopya %s açıklamasına ait %s, %s içindeki diğer örnek " #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "numfig etkisizleştirildi. :numref: yoksayıldı." #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "bağlantının resim yazısı yok: %s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "geçersiz numfig_format: %s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "geçersiz numfig_format: %s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "yeni yapılandırma" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "yapılandırma değişti" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "uzantılar değişti" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "yapım ortamı sürümü şu anki değil" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "kaynak dizin değişti" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "Bu ortam seçilen oluşturucuyla uyumsuzdur, lütfen başka bir belge ağacı dizini seçin." #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "%s içinde belgeleri tarama başarısız oldu: %r" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "Etki alanı %r kayıtlı değil" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "kendinden kaynaklı toctree bulundu. Yoksayıldı." #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "belge herhangi bir toctree içine dahil değil" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "bakınız %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "ayrıca bakınız %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "bilinmeyen dizin girişi türü %r" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Semboller" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "dairesel toctree kaynakları algılandı, yoksayılan: %s <- %s" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "toctree, başlığı olmayan %r belgesine başvuru içeriyor: hiç bağlantı oluşturulmayacaktır" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "toctree, hariç tutulan %r belgesine başvuru içeriyor" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "toctree, varolmayan %r belgesine başvuru içeriyor" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "resim dosyası okunabilir değil: %s" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "%s resim dosyası okunabilir değil: %s" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "indirme dosyası okunabilir değil: %s" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "%s zaten atanmış bölüm numaralarıdır (iç içe numaralı toctree mi?)" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "%s dosyası oluşturur." #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "\nPython modülleri ve paketleri için <MODULE_PATH> içine art arda bakın ve <OUTPUT_PATH> içindeki\npaket başına otomodül talimatlarını içeren bir reST dosyası oluşturun.\n\n<EXCLUDE_PATTERN>'ler, nesilden hariç tutulacak olan dosya ve/veya dizin şekilleri olabilir.\n\nNot: Varsayılan olarak bu betik zaten oluşturulmuş dosyaların üzerine yazmayacak." #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "belge için modüle giden yol" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "nesilden hariç tutmak için fnmatch-style dosyası ve/veya dizin şekilleri" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "tüm çıktıların yerleştirileceği dizin" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "TOC'da gösterilecek alt modüllerin en fazla derinliği (varsayılan: 4)" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "varolan dosyaların üzerine yaz" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "sembolik bağlantıları takip edin. Collective.recipe.omelette ile birleştirildiğinde güçlü." #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "dosyaları oluşturmadan betiği çalıştır" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "her modül için belgelendirmeyi kendi sayfasına koy" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "\"_private\" modülleri dahil" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "içindekiler dosyası adı (varsayılan: modüller)" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "içindekiler tablosu oluşturma" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "modül/paket paketleri için başlıklar oluşturma (örn. docstrings zaten bunları içerdiğinde)" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "modül belgelerini alt modül belgelerinin önüne koyun" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "modül yollarını PEP-0420 kapalı ad alanları özelliklerine göre yorumla" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "dosya soneki (varsayılan: rst)" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "sphinx-quickstart ile tam bir proje oluştur" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "--full yazıldığında, append module_path to sys.path, kullanılır" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "proje adı (varsayılan: kök modül adı)" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "--full yazıldığında, proje hazırlayan(lar)ı kullanılır" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "--full yazıldığında, proje sürümü kullanılır" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "--full yazıldığında, varsayılanı to --doc-version, proje yayımı kullanılır" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "uzantı seçenekleri" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s bir dizin değil." #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "nokta kodu %r: %s" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[grafik: %s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[grafik]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dönüştürmeden hata ile çıkıldı:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "dönüştürme komutu %r çalıştırılamaz, image_converter ayarını gözden geçirin" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "LaTeX komutu %r çalıştırılamaz (matematik görüntüleme için gerekli), imgmath_latex ayarını gözden geçirin" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "%s komutu %r çalıştırılamaz (matematik görüntüleme için gerekli), imgmath_%s ayarını gözden geçirin" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "görüntü latex %r: %s" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "satır içi latex %r: %s" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "Bu denklem için kalıcı bağlantı" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "intersphinx envanteri taşındı: %s -> %s" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "%s konumundan intersphinx envanteri yükleniyor..." #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "aşağıdaki sorunlardan dolayı envanterlerden herhangi birine ulaşılamadı:" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(%s v%s içinde)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(%s içinde)" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[kaynak]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Yapılacaklar" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<original entry>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(<<original entry>>, %s içinde, %d. satırda bulunur.)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "özgün giriş" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[belgeler]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "Modül kodu" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>%s öğesinin kaynak kodu</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "Genel bakış: modül kodu" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>Kodları mevcut bütün modüller</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "Örnek" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Örnekler" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "Notlar" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "Diğer Parametreler" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "Kaynaklar" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "Uyarılar" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "Getiriler" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Dikkat" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Uyarı" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Tehlike" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Hata" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "İpucu" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Önemli" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Not" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Ayrıca bakınız" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Tüyo" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Uyarı" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "önceki sayfadan devam" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "sonraki sayfaya devam" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "Alfabetik olmayan" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "Numaralar" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "sayfa" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "İçindekiler" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Ara" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Git" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Kaynağı Göster" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Genel Bakış" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Hoş Geldiniz! Karşınızda" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "belgelendirme konusu: " #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "son güncelleme" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Dizinler ve tablolar:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Tam İçindekiler" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "tüm bölümleri ve alt bölümleri listeler" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "bu belgelendirmeyi ara" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Genel Modül Dizini" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "tüm modüllere hızlı erişim" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "tüm işlevler, sınıflar, terimler" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Dizin – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Tek sayfada tam dizin" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Harfe göre dizin sayfaları" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "çok büyük olabilir" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Gezinti" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "%(docstitle)s içinde ara" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Bu belgeler hakkında" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Telif hakkı" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">Telif hakkı</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© Telif hakkı %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Son güncelleme: %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "%(docstitle)s ara" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Önceki konu" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "önceki bölüm" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Sonraki konu" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "sonraki bölüm" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Arama işlevini kullanabilmek için lütfen JavaScript'i\n etkinleştirin." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "ara" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Arama Sonuçları" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "Arama sonucunda herhangi bir belge bulunamadı. Bütün kelimeleri doğru yazdığınızdan ve gerekli bütün kategorileri seçtiğinizden emin olun." #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Hızlı Arama" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Bu Sayfa" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "Sürüm %(version)s — %(docstitle)s içindeki Değişiklikler" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "%(version)s sürümündeki değişikliklerin otomatik olarak üretilmiş listesi" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Kütüphane değişiklikleri" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API'sindeki değişiklikler" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Diğer değişiklikler" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Bu başlık için kalıcı bağlantı" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Bu tanım için kalıcı bağlantı" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Arama Eşleşmelerini Gizle" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "Aranıyor" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "Aramaya hazırlanıyor..." #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "Arama tamamlandı. Sorguyu içeren %s sayfa bulundu." #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr ", şunun içinde:" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "Yan çubuğu genişlet" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "Yan çubuğu daralt" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "İçindekiler" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "Bilinmeyen resim biçimi: %s..." #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "atlandı" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "başarısız oldu" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "okuma hatası: %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "yazma hatası: %s, %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "varsayılan rol %s bulunamadı" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "Bu tablonun kalıcı bağlantısı" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "Bu kodun kalıcı bağlantısı" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "Bu resmin kalıcı bağlantısı" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "Bu içindekiler tablosunun kalıcı bağlantısı" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "Dipnotlar" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[resim: %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[resim]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3325782 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/uk_UA/�������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016107� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5126436 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/uk_UA/LC_MESSAGES/�������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017674� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.js����������������������������������������������0000644�0000766�0000024�00000015216�00000000000�021550� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "uk_UA", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "\u041f\u0440\u043e \u0446\u0456 \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0438", "Automatically generated list of changes in version %(version)s": "\u0410\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u043d\u043e\u0433\u043e \u0437\u0433\u0435\u043d\u0435\u0440\u043e\u0432\u0430\u043d\u0438\u0439 \u0441\u043f\u0438\u0441\u043e\u043a \u0437\u043c\u0456\u043d \u0432 \u0432\u0435\u0440\u0441\u0456\u0457 %(version)s", "C API changes": "\u0437\u043c\u0456\u043d\u0438 C API", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "\u041f\u043e\u0432\u043d\u0438\u0439 \u0417\u043c\u0456\u0441\u0442", "Contents": "", "Copyright": "\u0410\u0432\u0442\u043e\u0440\u0441\u044c\u043a\u0456 \u043f\u0440\u0430\u0432\u0430", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "\u041f\u043e\u0432\u043d\u0438\u0439 \u0456\u043d\u0434\u0435\u043a\u0441 \u043d\u0430 \u043e\u0434\u043d\u0456\u0439 \u0441\u0442\u043e\u0440\u0456\u043d\u0446\u0456", "General Index": "\u0417\u0430\u0433\u0430\u043b\u044c\u043d\u0438\u0439 \u0456\u043d\u0434\u0435\u043a\u0441", "Global Module Index": "\u0417\u0430\u0433\u0430\u043b\u044c\u043d\u0438\u0439 \u0456\u043d\u0434\u0435\u043a\u0441 \u043c\u043e\u0434\u0443\u043b\u0456\u0432", "Go": "\u0412\u043f\u0435\u0440\u0435\u0434", "Hide Search Matches": "\u041f\u0440\u0438\u0445\u043e\u0432\u0430\u0442\u0438 \u0441\u043f\u0456\u0432\u043f\u0430\u0434\u0456\u043d\u043d\u044f \u043f\u043e\u0448\u0443\u043a\u0443", "Index": "\u0406\u043d\u0434\u0435\u043a\u0441", "Index – %(key)s": "\u0406\u043d\u0434\u0435\u043a\u0441 – %(key)s", "Index pages by letter": "\u0406\u043d\u0434\u0435\u043a\u0441\u043d\u0456 \u0441\u0442\u043e\u0440\u0456\u043d\u043a\u0438 \u043f\u043e \u0441\u0438\u043c\u0432\u043e\u043b\u0430\u043c", "Indices and tables:": "\u0406\u043d\u0434\u0435\u043a\u0441\u0438 \u0442\u0430 \u0442\u0430\u0431\u043b\u0438\u0446\u0456:", "Last updated on %(last_updated)s.": "\u0412\u043e\u0441\u0442\u0430\u043d\u043d\u0454 \u043e\u043d\u043e\u0432\u043b\u0435\u043d\u043e %(last_updated)s.", "Library changes": "\u0417\u043c\u0456\u043d\u0438 \u0432 \u0431\u0456\u0431\u043b\u0456\u043e\u0442\u0435\u0446\u0456", "Navigation": "\u041d\u0430\u0432\u0456\u0433\u0430\u0446\u0456\u044f", "Next topic": "\u041d\u0430\u0441\u0442\u0443\u043f\u043d\u0430 \u0442\u0435\u043c\u0430", "Other changes": "\u0406\u043d\u0448\u0456 \u0437\u043c\u0456\u043d\u0438", "Overview": "\u041e\u0433\u043b\u044f\u0434", "Permalink to this definition": "\u041f\u043e\u0441\u0442\u0456\u0439\u043d\u0435 \u043f\u043e\u0441\u0438\u043b\u0430\u043d\u043d\u044f \u043d\u0430 \u0446\u0435 \u0432\u0438\u0437\u043d\u0430\u0447\u0435\u043d\u043d\u044f", "Permalink to this headline": "\u041f\u043e\u0441\u0442\u0456\u0439\u043d\u0435 \u043f\u043e\u0441\u0438\u043b\u0430\u043d\u043d\u044f \u043d\u0430 \u0446\u0435\u0439 \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043e\u043a", "Please activate JavaScript to enable the search\n functionality.": "\u0411\u0443\u0434\u044c-\u043b\u0430\u0441\u043a\u0430 \u0432\u0456\u043c\u043a\u043d\u0456\u0442\u044c \u043f\u0456\u0434\u0442\u0440\u0438\u043c\u043a\u0443 JavaScript, \u0449\u043e\u0431 \u0432\u0432\u0456\u043a\u043d\u0443\u0442\u0438\n\"\n\" \u043f\u043e\u0448\u0443\u043a.", "Preparing search...": "", "Previous topic": "\u041f\u043e\u043f\u0435\u0440\u0435\u0434\u043d\u0456\u0439 \u0440\u043e\u0437\u0434\u0456\u043b", "Quick search": "\u0428\u0432\u0438\u0434\u043a\u0438\u0439 \u043f\u043e\u0448\u0443\u043a", "Search": "\u041f\u043e\u0448\u0443\u043a", "Search Page": "\u0421\u0442\u043e\u0440\u0456\u043d\u043a\u0430 \u043f\u043e\u0448\u0443\u043a\u0443", "Search Results": "\u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442\u0438 \u043f\u043e\u0448\u0443\u043a\u0443", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "\u0428\u0443\u043a\u0430\u0442\u0438 \u0432 %(docstitle)s", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "\u0412\u0456\u0434\u043e\u0431\u0440\u0430\u0437\u0438\u0442\u0438 \u0432\u0438\u0445\u0456\u0434\u043d\u0438\u0439 \u0442\u0435\u043a\u0441\u0442", "Table of Contents": "", "This Page": "\u0426\u044f \u0441\u0442\u043e\u0440\u0456\u043d\u043a\u0430", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "\u0432\u0441\u0456 \u0444\u0443\u043d\u043a\u0446\u0456\u0457, \u043a\u043b\u0430\u0441\u0438, \u0442\u0435\u0440\u043c\u0456\u043d\u0438", "can be huge": "\u043c\u043e\u0436\u0435 \u0431\u0443\u0442\u0438 \u0432\u0435\u043b\u0438\u0447\u0435\u0437\u043d\u0438\u043c", "last updated": "", "lists all sections and subsections": "\u043f\u0435\u0440\u0435\u043b\u0456\u0447\u0438\u0442\u0438 \u0432\u0441\u0456 \u0441\u0435\u043a\u0446\u0456\u0457 \u0442\u0430 \u043f\u0456\u0434\u0441\u0435\u043a\u0446\u0456\u0457", "next chapter": "\u043d\u0430\u0441\u0442\u0443\u043f\u043d\u0438\u0439 \u0440\u043e\u0437\u0434\u0456\u043b", "previous chapter": "\u041f\u043e\u043f\u0435\u0440\u0435\u0434\u043d\u0456\u0439 \u0440\u043e\u0437\u0434\u0456\u043b", "quick access to all modules": "\u0448\u0432\u0438\u0434\u043a\u0438\u0439 \u0434\u043e\u0441\u0442\u0443\u043f \u0434\u043e \u0432\u0441\u0456\u0445 \u043c\u043e\u0434\u0443\u043b\u0456\u0432", "search": "\u043f\u043e\u0448\u0443\u043a", "search this documentation": "\u0448\u0443\u043a\u0430\u0442\u0438 \u0446\u044e \u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0456\u044e", "the documentation for": "" }, "plural_expr": "(n % 1 == 0 && n % 10 == 1 && n % 100 != 11 ? 0 : n % 1 == 0 && n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14) ? 1 : n % 1 == 0 && (n % 10 ==0 || (n % 10 >=5 && n % 10 <=9) || (n % 100 >=11 && n % 100 <=14 )) ? 2: 3)" });����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.mo����������������������������������������������0000644�0000766�0000024�00000015217�00000000000�021550� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������f������L��������������|�� ���}������� ������������������������������ ������������������0�� ���I�����V�����j�� ����������>���������� �������������������� ���"�����,�� ���3�����>�����Z�����`�� ���w���������������������� �������������������������!��� �����' �� ���7 �����D �� ���T �� ���a �����l �� ���~ ����� �� ��� ����� �� ��� ����� ����� ��B��� �����+ ��$���: �� ���_ �����l �����s �� ���{ ����� ����� ����� �� ��� ����� ����� ����� ����� �� ��� �� ��� ����� ����� ����� �����# �� ���A �����K �� ���] �����i �����o ����� �� ��� ����� ����� ����� ��"��� ����� ����� ����� ����� ����� �� ��� ����� ����� ����� �����( �����9 �����U �����\ �� ���v �� ��� ����� ���� �����I�����a�� ���g�����q��"�����$�������������������������'���#��(���K�����t������������ ����� �����e�����#���;�����_�����p��!�������������������������8��� �����B��:���Q�������.����� �����6�������������0�� ���?�����L��7���i��#�����3�����"�������������8�����R�����l���������������������� ����������B�����B���;��n���~��!�����$��������4�����N�� ���_�����j������� ���������������!������������������3��2���K�����~�� ���������������1����������!��� ��&���.�����U�����^��!���|��#���������� ����������@����� ���9�����F�� ���O�� ���\�����i�����|�� ���������������!�����8����� ���)��*���4�� ���_�����j�������� (deprecated)� (in �%b %d, %Y�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (in module %s)�%s (module)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�About these documents�Attention�Author: �Automatically generated list of changes in version %(version)s�Builtins�C API changes�Caution�Changed in version %s�Complete Table of Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Full index on one page�General Index�Global Module Index�Go�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Library changes�Module Index�Module author: �Module level�Navigation�New in version %s�Next topic�Note�Other changes�Overview�Parameters�Permalink to this definition�Permalink to this headline�Please activate JavaScript to enable the search functionality.�Previous topic�Python Enhancement Proposals; PEP %s�Quick search�Raises�Release�Return type�Returns�Search�Search %(docstitle)s�Search Page�Search Results�Search within %(docstitle)s�Section author: �See also�Show Source�This Page�Tip�Todo�Warning�all functions, classes, terms�attribute�built-in function�can be huge�class�environment variable�environment variable; %s�exception�function�index�keyword�lists all sections and subsections�macro�member�module�modules�next�next chapter�object�operator�previous�previous chapter�quick access to all modules�search�search this documentation�statement�static method�type�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-10-31 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: uk_UA Language-Team: Ukrainian (Ukraine) (http://www.transifex.com/sphinx-doc/sphinx-1/language/uk_UA/) Plural-Forms: nplurals=4; plural=(n % 1 == 0 && n % 10 == 1 && n % 100 != 11 ? 0 : n % 1 == 0 && n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14) ? 1 : n % 1 == 0 && (n % 10 ==0 || (n % 10 >=5 && n % 10 <=9) || (n % 100 >=11 && n % 100 <=14 )) ? 2: 3) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � (застарілий)� (в �%b %d, %Y�%s (%s атрибут)�%s (вбудований клас)�%s (вбудована змінна)�%s (клас в %s)�%s (в модулі %s)�%s (модуль)�%s() (%s метод)�%s() (%s статичний метод)�%s() (вбудована функція)�%s() (клас)�%s() (в модулі %s)�Про ці документи�Увага�Автор: �Автоматичного згенерований список змін в версії %(version)s�Вбудовані елементи�зміни C API�Застереження�Змінено в версії %s�Повний Зміст�Авторські права�Небезпека�Застарілий�Застаріло починаючи з версії %s�Помилка�Повний індекс на одній сторінці�Загальний індекс�Загальний індекс модулів�Вперед�Приховати співпадіння пошуку�Підказка�Важливо�Індекс�Індекс – %(key)s�Індексні сторінки по символам�Індекси та таблиці:�Востаннє оновлено %(last_updated)s.�Зміни в бібліотеці�Індекс модулів�Автор модуля: �Рівень модуля�Навігація�Нове в версії %s�Наступна тема�Примітка�Інші зміни�Огляд�Параметри�Постійне посилання на це визначення�Постійне посилання на цей заголовок�Будь-ласка вімкніть підтримку JavaScript, щоб ввікнути " " пошук.�Попередній розділ�Python Enhancement Proposals; PEP %s�Швидкий пошук�Викликає�Реліз�Тип повернення�Повертає�Пошук�Пошук %(docstitle)s�Сторінка пошуку�Результати пошуку�Шукати в %(docstitle)s�Автор секції: �Дивись також�Відобразити вихідний текст�Ця сторінка�Порада�Доробити�Попередження�всі функції, класи, терміни�атрибут�вбудована функція�може бути величезним�клас�змінна оточення�змінна оточення; %s�виняткова ситуація�функція�індекс�ключове слово�перелічити всі секції та підсекції�макрос�член�модуль�модулі�наступний�наступний розділ�об'єкт�оператор�попередній�Попередній розділ�швидкий доступ до всіх модулів�пошук�шукати цю документацію�вираз�статичний метод�тип����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/uk_UA/LC_MESSAGES/sphinx.po����������������������������������������������0000644�0000766�0000024�00000247423�00000000000�021561� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Petro Sasnyk <petro@sasnyk.name>, 2009 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-10-31 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Ukrainian (Ukraine) (http://www.transifex.com/sphinx-doc/sphinx-1/language/uk_UA/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: uk_UA\n" "Plural-Forms: nplurals=4; plural=(n % 1 == 0 && n % 10 == 1 && n % 100 != 11 ? 0 : n % 1 == 0 && n % 10 >= 2 && n % 10 <= 4 && (n % 100 < 12 || n % 100 > 14) ? 1 : n % 1 == 0 && (n % 10 ==0 || (n % 10 >=5 && n % 10 <=9) || (n % 100 >=11 && n % 100 <=14 )) ? 2: 3);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Вбудовані елементи" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Рівень модуля" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (в " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%b %d, %Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Загальний індекс" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "індекс" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "наступний" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "попередній" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "Індекс" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "Реліз" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Автор секції: " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Автор модуля: " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Автор: " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Параметри" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428 msgid "Returns" msgstr "Повертає" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:430 msgid "Return type" msgstr "Тип повернення" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "член" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164 msgid "function" msgstr "функція" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "макрос" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "тип" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Нове в версії %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Змінено в версії %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Застаріло починаючи з версії %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1166 msgid "class" msgstr "клас" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (вбудована функція)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s метод)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (клас)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s атрибут)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (модуль)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171 msgid "attribute" msgstr "атрибут" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1173 msgid "module" msgstr "модуль" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "ключове слово" #: sphinx/domains/python.py:60 msgid "operator" msgstr "оператор" #: sphinx/domains/python.py:61 msgid "object" msgstr "об'єкт" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1167 msgid "exception" msgstr "виняткова ситуація" #: sphinx/domains/python.py:63 msgid "statement" msgstr "вираз" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "вбудована функція" #: sphinx/domains/python.py:421 msgid "Variables" msgstr "" #: sphinx/domains/python.py:425 msgid "Raises" msgstr "Викликає" #: sphinx/domains/python.py:648 sphinx/domains/python.py:792 #, python-format msgid "%s() (in module %s)" msgstr "%s() (в модулі %s)" #: sphinx/domains/python.py:708 sphinx/domains/python.py:884 #: sphinx/domains/python.py:935 #, python-format msgid "%s (in module %s)" msgstr "%s (в модулі %s)" #: sphinx/domains/python.py:710 #, python-format msgid "%s (built-in variable)" msgstr "%s (вбудована змінна)" #: sphinx/domains/python.py:735 #, python-format msgid "%s (built-in class)" msgstr "%s (вбудований клас)" #: sphinx/domains/python.py:736 #, python-format msgid "%s (class in %s)" msgstr "%s (клас в %s)" #: sphinx/domains/python.py:797 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:799 sphinx/domains/python.py:939 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s статичний метод)" #: sphinx/domains/python.py:1093 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1094 msgid "modules" msgstr "модулі" #: sphinx/domains/python.py:1143 msgid "Deprecated" msgstr "Застарілий" #: sphinx/domains/python.py:1169 msgid "class method" msgstr "" #: sphinx/domains/python.py:1170 msgid "static method" msgstr "статичний метод" #: sphinx/domains/python.py:1172 msgid "property" msgstr "" #: sphinx/domains/python.py:1230 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1350 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1404 msgid " (deprecated)" msgstr " (застарілий)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "змінна оточення; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "змінна оточення" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "Індекс модулів" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "Сторінка пошуку" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:173 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:204 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:218 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:224 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:334 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:336 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:369 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:382 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Доробити" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:78 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Увага" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Застереження" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Небезпека" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Помилка" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Підказка" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Важливо" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Примітка" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Дивись також" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Порада" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Попередження" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Пошук" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Вперед" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Відобразити вихідний текст" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Огляд" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Індекси та таблиці:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Повний Зміст" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "перелічити всі секції та підсекції" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "шукати цю документацію" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Загальний індекс модулів" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "швидкий доступ до всіх модулів" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "всі функції, класи, терміни" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Індекс – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Повний індекс на одній сторінці" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Індексні сторінки по символам" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "може бути величезним" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Навігація" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Шукати в %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Про ці документи" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Авторські права" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Востаннє оновлено %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Пошук %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Попередній розділ" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "Попередній розділ" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Наступна тема" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "наступний розділ" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Будь-ласка вімкніть підтримку JavaScript, щоб ввікнути\n\"\n\" пошук." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "пошук" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "Результати пошуку" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "Швидкий пошук" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "Ця сторінка" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "Автоматичного згенерований список змін в версії %(version)s" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "Зміни в бібліотеці" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "зміни C API" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "Інші зміни" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "Постійне посилання на цей заголовок" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "Постійне посилання на це визначення" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "Приховати співпадіння пошуку" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3327627 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ur/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015531� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5138054 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ur/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017316� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ur/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000004603�00000000000�021170� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "ur", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "(n != 1)" });�����������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ur/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000000760�00000000000�021167� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$���������������,�����-����Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: ur Language-Team: Urdu (http://www.transifex.com/sphinx-doc/sphinx-1/language/ur/) Plural-Forms: nplurals=2; plural=(n != 1) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �����������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/ur/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000241423�00000000000�021175� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Urdu (http://www.transifex.com/sphinx-doc/sphinx-1/language/ur/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: ur\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3329425 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/vi/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015521� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5145864 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/vi/LC_MESSAGES/����������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017306� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/vi/LC_MESSAGES/sphinx.js�������������������������������������������������0000644�0000766�0000024�00000007107�00000000000�021162� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "vi", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "V\u1ec1 c\u00e1c t\u00e0i li\u1ec7u n\u00e0y", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "M\u1ee5c L\u1ee5c \u0110\u1ea7y \u0110\u1ee7", "Contents": "N\u1ed9i dung", "Copyright": "B\u1ea3n quy\u1ec1n", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "To\u00e0n b\u1ed9 ch\u1ec9 m\u1ee5c tr\u00ean m\u1ed9t trang", "General Index": "Ch\u1ec9 m\u1ee5c chung", "Global Module Index": "Ch\u1ec9 M\u1ee5c M\u00f4-\u0111un To\u00e0n C\u1ee5c", "Go": "Th\u1ef1c hi\u1ec7n", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "Ch\u1ec9 m\u1ee5c – %(key)s", "Index pages by letter": "C\u00e1c trang ch\u1ec9 m\u1ee5c theo ch\u1eef c\u00e1i", "Indices and tables:": "C\u00e1c ch\u1ec9 m\u1ee5c v\u00e0 b\u1ea3ng bi\u1ec3u:", "Last updated on %(last_updated)s.": "C\u1eadp nh\u1eadt m\u1edbi nh\u1ea5t v\u00e0o %(last_updated)s.", "Library changes": "", "Navigation": "\u0110i\u1ec1u h\u01b0\u1edbng", "Next topic": "Ch\u1ee7 \u0111\u1ec1 ti\u1ebfp", "Other changes": "", "Overview": "T\u1ed5ng quan", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "H\u00e3y b\u1eadt JavaScript \u0111\u1ec3 d\u00f9ng t\u00ednh n\u0103ng\nt\u00ecm ki\u1ebfm.", "Preparing search...": "", "Previous topic": "Ch\u1ee7 \u0111\u1ec1 tr\u01b0\u1edbc", "Quick search": "", "Search": "T\u00ecm Ki\u1ebfm", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "T\u00ecm ki\u1ebfm trong %(docstitle)s", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "Hi\u1ec3n th\u1ecb m\u00e3 ngu\u1ed3n", "Table of Contents": "", "This Page": "", "Welcome! This is": "Ch\u00e0o m\u1eebng! \u0110\u00e2y l\u00e0", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "t\u1ea5t c\u1ea3 c\u00e1c h\u00e0m, l\u1edbp, thu\u1eadt ng\u1eef", "can be huge": "c\u00f3 th\u1ec3 r\u1ea5t nhi\u1ec1u", "last updated": "c\u1eadp nh\u1eadt m\u1edbi nh\u1ea5t", "lists all sections and subsections": "li\u1ec7t k\u00ea t\u1ea5t c\u1ea3 c\u00e1c m\u1ee5c v\u00e0 m\u1ee5c con", "next chapter": "ch\u01b0\u01a1ng ti\u1ebfp", "previous chapter": "ch\u01b0\u01a1ng tr\u01b0\u1edbc ", "quick access to all modules": "truy c\u1eadp nhanh t\u1ea5t c\u1ea3 c\u00e1c m\u00f4-\u0111un", "search": "", "search this documentation": "t\u00ecm ki\u1ebfm trong t\u00e0i li\u1ec7u n\u00e0y", "the documentation for": "t\u00e0i li\u1ec7u cho" }, "plural_expr": "0" });���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/vi/LC_MESSAGES/sphinx.mo�������������������������������������������������0000644�0000766�0000024�00000013516�00000000000�021162� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������o�������������������� �� ��� ������� ���!�����+�����1�����E�����W�����k������������ ���������� ����� �����������������������+�� ���D�����Q�����e�� ���{�� ������������������������� ��������������� ���������� ��� ����� �����) �����/ �����8 �� ���O �����] �����q �����t �� ���y ����� ����� ����� ��!��� ����� �� ��� �� ��� ����� �� ��� �����* �����/ �� ���8 ��B���C ����� ��$��� ����� ����� �� ��� ����� ����� ����� ����� �����! �����2 �� ���; �����G �����O �����V �� ���Z �����d �����l �����} �� ��� ����� �� ��� ����� �� ��� ����� �� ��� ����� �� ��� ����� �� ��� ����� �����% �� ���- ��"���: �����] �����c �����j �����q �����x ����� �� ��� ����� ����� ����� ����� ����� ����� ����� ����� �� ��� �� ��� �� ��� �����" �����8 �����= ����F ���������������#�����,�����2�����D�����Z�����r������������*���������� ����� ��������������.�����H�����h�� ��������������� ���������� ����� ����� �����!�������������4�� ���M�� ���X�� ���f�����r��&���������� �����(���������� ����� ��������)�� ���2�����?��&���[��#�����0����������������������� �����'�����:�� ���C�� ���O��:���Y�������*�������������������� ��� �� ��������"�����5�����U�� ���g�����q����������������� ����� ����������*����� �������������� �����8�����>�� ���T�� ���`�����l�� ��������������� ����� ����������.���������� ��������+�����;�� ���D�� ���R�����]�����m�� ���}�� ����������)����������"���������� ����� �������������0�����@�����G��� (deprecated)� (in �%b %d, %Y�%s %s�%s %s documentation�%s (%s attribute)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�About these documents�Arguments�Attention�Author: �Builtins�Caution�Changed in version %s�Code author: �Complete Table of Contents�Contents�Copyright�Danger�Deprecated�Deprecated since version %s�Error�Examples�Full index on one page�General Index�Global Module Index�Go�Hint�Important�Index – %(key)s�Index pages by letter�Indices and tables:�Last updated on %(last_updated)s.�Module author: �Module level�Navigation�New in version %s�Next topic�Note�Overview�Parameters�Please activate JavaScript to enable the search functionality.�Previous topic�Python Enhancement Proposals; PEP %s�Python Module Index�Raises�Return type�Returns�Search�Search %(docstitle)s�Search within %(docstitle)s�Section author: �See also�Show Source�Symbols�Throws�Tip�Variables�Warning�Welcome! This is�all functions, classes, terms�attribute�built-in function�can be huge�class�class method�data�directive�environment variable; %s�exception�function�glossary term�index�keyword�last updated�lists all sections and subsections�macro�member�method�module�modules�next�next chapter�object�operator�previous�previous chapter�quick access to all modules�role�search this documentation�see %s�see also %s�statement�static method�the documentation for�type�variable�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-10-31 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: vi Language-Team: Vietnamese (http://www.transifex.com/sphinx-doc/sphinx-1/language/vi/) Plural-Forms: nplurals=1; plural=0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �(sắp loại bỏ)�(trong�%d/%m/%Y�%s %s�Tài liệu %s %s�%s (thuộc tính %s)�%s (lớp dựng sẵn)�%s (biến dựng sẵn)�%s (lớp trong %s)�%s (chỉ thị)�%s (biến toàn cục hoặc hằng số)�%s (trong mô-đun %s)�%s (mô-đun)�%s (vai trò)�%s() (phương thức lớp %s)�%s() (phương thức %s)�%s() (phương thức tĩnh %s)�%s() (hàm dựng sẵn)�%s() (lớp)�%s() (trong mô-đun %s)�Về các tài liệu này�Đối số�Chú ý�Tác giả:�Dựng sẵn�Cảnh báo�Thay đổi trong phiên bản %s�Tác giả mã lệnh:�Mục Lục Đầy Đủ�Nội dung�Bản quyền�Nguy hiểm�Sắp loại bỏ�Sắp loại bỏ từ phiên bản %s�Lỗi�Các ví dụ�Toàn bộ chỉ mục trên một trang�Chỉ mục chung�Chỉ Mục Mô-đun Toàn Cục�Thực hiện�Gợi ý�Quan trọng�Chỉ mục – %(key)s�Các trang chỉ mục theo chữ cái�Các chỉ mục và bảng biểu:�Cập nhật mới nhất vào %(last_updated)s.�Tác giả mô-đun:�Mức mô-đun�Điều hướng�Mới từ phiên bản %s�Chủ đề tiếp�Ghi chú�Tổng quan�Tham số�Hãy bật JavaScript để dùng tính năng tìm kiếm.�Chủ đề trước�Các đề nghị nâng cao Python; PEP %s�Chỉ Mục Mô-đun Python�Đưa ra�Kiểu trả về�Trả về�Tìm Kiếm�Tìm %(docstitle)s�Tìm kiếm trong %(docstitle)s�Tác giả mục:�Xem thêm�Hiển thị mã nguồn�Biểu tượng�Ném�Mẹo�Các biến�Cảnh báo�Chào mừng! Đây là�tất cả các hàm, lớp, thuật ngữ�thuộc tính�hàm dựng sẵn�có thể rất nhiều�lớp�phương thức lớp�dữ liệu�chỉ thị�các biến môi trường; %s�ngoại lệ�hàm�chú giải thuật ngữ�chỉ mục�từ khoá�cập nhật mới nhất�liệt kê tất cả các mục và mục con�macro�thuộc tính�phương thức�mô-đun�các mô-đun�xem tiếp�chương tiếp�đối tượng�toán tử�xem lại�chương trước �truy cập nhanh tất cả các mô-đun�vai trò�tìm kiếm trong tài liệu này�xem %s�nên xem %s�câu lệnh�phương thức tĩnh�tài liệu cho�kiểu�biến�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/vi/LC_MESSAGES/sphinx.po�������������������������������������������������0000644�0000766�0000024�00000245424�00000000000�021172� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Hoat Le Van <hoatlevan@gmail.com>, 2014 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-10-31 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Vietnamese (http://www.transifex.com/sphinx-doc/sphinx-1/language/vi/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: vi\n" "Plural-Forms: nplurals=1; plural=0;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Các đề nghị nâng cao Python; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "Dựng sẵn" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "Mức mô-đun" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "(trong" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%d/%m/%Y" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "Chỉ mục chung" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "chỉ mục" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "xem tiếp" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "xem lại" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "Tài liệu %s %s" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "Tác giả mục:" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "Tác giả mô-đun:" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "Tác giả mã lệnh:" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "Tác giả:" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "Tham số" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428 msgid "Returns" msgstr "Trả về" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:430 msgid "Return type" msgstr "Kiểu trả về" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "thuộc tính" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "biến" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164 msgid "function" msgstr "hàm" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "macro" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "kiểu" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "Mới từ phiên bản %s" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "Thay đổi trong phiên bản %s" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "Sắp loại bỏ từ phiên bản %s" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "Ném" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1166 msgid "class" msgstr "lớp" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (hàm dựng sẵn)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803 #, python-format msgid "%s() (%s method)" msgstr "%s() (phương thức %s)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (lớp)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (biến toàn cục hoặc hằng số)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888 #, python-format msgid "%s (%s attribute)" msgstr "%s (thuộc tính %s)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "Đối số" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (mô-đun)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168 msgid "method" msgstr "phương thức" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165 msgid "data" msgstr "dữ liệu" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171 msgid "attribute" msgstr "thuộc tính" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1173 msgid "module" msgstr "mô-đun" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "từ khoá" #: sphinx/domains/python.py:60 msgid "operator" msgstr "toán tử" #: sphinx/domains/python.py:61 msgid "object" msgstr "đối tượng" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1167 msgid "exception" msgstr "ngoại lệ" #: sphinx/domains/python.py:63 msgid "statement" msgstr "câu lệnh" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "hàm dựng sẵn" #: sphinx/domains/python.py:421 msgid "Variables" msgstr "Các biến" #: sphinx/domains/python.py:425 msgid "Raises" msgstr "Đưa ra" #: sphinx/domains/python.py:648 sphinx/domains/python.py:792 #, python-format msgid "%s() (in module %s)" msgstr "%s() (trong mô-đun %s)" #: sphinx/domains/python.py:708 sphinx/domains/python.py:884 #: sphinx/domains/python.py:935 #, python-format msgid "%s (in module %s)" msgstr "%s (trong mô-đun %s)" #: sphinx/domains/python.py:710 #, python-format msgid "%s (built-in variable)" msgstr "%s (biến dựng sẵn)" #: sphinx/domains/python.py:735 #, python-format msgid "%s (built-in class)" msgstr "%s (lớp dựng sẵn)" #: sphinx/domains/python.py:736 #, python-format msgid "%s (class in %s)" msgstr "%s (lớp trong %s)" #: sphinx/domains/python.py:797 #, python-format msgid "%s() (%s class method)" msgstr "%s() (phương thức lớp %s)" #: sphinx/domains/python.py:799 sphinx/domains/python.py:939 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s static method)" msgstr "%s() (phương thức tĩnh %s)" #: sphinx/domains/python.py:1093 msgid "Python Module Index" msgstr "Chỉ Mục Mô-đun Python" #: sphinx/domains/python.py:1094 msgid "modules" msgstr "các mô-đun" #: sphinx/domains/python.py:1143 msgid "Deprecated" msgstr "Sắp loại bỏ" #: sphinx/domains/python.py:1169 msgid "class method" msgstr "phương thức lớp" #: sphinx/domains/python.py:1170 msgid "static method" msgstr "phương thức tĩnh" #: sphinx/domains/python.py:1172 msgid "property" msgstr "" #: sphinx/domains/python.py:1230 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1350 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1404 msgid " (deprecated)" msgstr "(sắp loại bỏ)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (chỉ thị)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (vai trò)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "chỉ thị" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "vai trò" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "các biến môi trường; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "chú giải thuật ngữ" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "xem %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "nên xem %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "Biểu tượng" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:173 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:204 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:218 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:224 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:334 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:336 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:369 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:382 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:78 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "Các ví dụ" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "Chú ý" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "Cảnh báo" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "Nguy hiểm" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "Lỗi" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "Gợi ý" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "Quan trọng" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "Ghi chú" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "Xem thêm" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "Mẹo" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "Cảnh báo" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "Tìm Kiếm" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "Thực hiện" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "Hiển thị mã nguồn" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "Tổng quan" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "Chào mừng! Đây là" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "tài liệu cho" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "cập nhật mới nhất" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "Các chỉ mục và bảng biểu:" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "Mục Lục Đầy Đủ" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "liệt kê tất cả các mục và mục con" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "tìm kiếm trong tài liệu này" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "Chỉ Mục Mô-đun Toàn Cục" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "truy cập nhanh tất cả các mô-đun" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "tất cả các hàm, lớp, thuật ngữ" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "Chỉ mục – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "Toàn bộ chỉ mục trên một trang" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "Các trang chỉ mục theo chữ cái" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "có thể rất nhiều" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "Điều hướng" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "Tìm kiếm trong %(docstitle)s" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "Về các tài liệu này" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "Bản quyền" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "Cập nhật mới nhất vào %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "Tìm %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "Chủ đề trước" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "chương trước " #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "Chủ đề tiếp" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "chương tiếp" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "Hãy bật JavaScript để dùng tính năng\ntìm kiếm." #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "Nội dung" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3331332 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/yue/���������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015705� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5153697 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/yue/LC_MESSAGES/���������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017472� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/yue/LC_MESSAGES/sphinx.js������������������������������������������������0000644�0000766�0000024�00000004575�00000000000�021354� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "yue", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "0" });�����������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/yue/LC_MESSAGES/sphinx.mo������������������������������������������������0000644�0000766�0000024�00000000760�00000000000�021343� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$���������������,�����-����Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-10-31 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: yue Language-Team: Cantonese (http://www.transifex.com/sphinx-doc/sphinx-1/language/yue/) Plural-Forms: nplurals=1; plural=0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 �����������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/yue/LC_MESSAGES/sphinx.po������������������������������������������������0000644�0000766�0000024�00000241422�00000000000�021350� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-10-31 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Cantonese (http://www.transifex.com/sphinx-doc/sphinx-1/language/yue/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: yue\n" "Plural-Forms: nplurals=1; plural=0;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:430 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1166 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1173 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1167 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:421 msgid "Variables" msgstr "" #: sphinx/domains/python.py:425 msgid "Raises" msgstr "" #: sphinx/domains/python.py:648 sphinx/domains/python.py:792 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:708 sphinx/domains/python.py:884 #: sphinx/domains/python.py:935 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:710 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:735 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:736 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:797 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:799 sphinx/domains/python.py:939 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1093 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1094 msgid "modules" msgstr "" #: sphinx/domains/python.py:1143 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1169 msgid "class method" msgstr "" #: sphinx/domains/python.py:1170 msgid "static method" msgstr "" #: sphinx/domains/python.py:1172 msgid "property" msgstr "" #: sphinx/domains/python.py:1230 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1350 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1404 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:173 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:204 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:218 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:224 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:334 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:336 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:369 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:382 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:78 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3333154 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_CN/�������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016104� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.516224 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_CN/LC_MESSAGES/�������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017671� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.js����������������������������������������������0000644�0000766�0000024�00000010773�00000000000�021550� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "zh_Hans_CN", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\"> \u7248\u6743\u6240\u6709</a> %(copyright)s.", "© Copyright %(copyright)s.": "© \u7248\u6743\u6240\u6709 %(copyright)s.", ", in ": "\uff0c \u5728 ", "About these documents": "\u5173\u4e8e\u8fd9\u4e9b\u6587\u6863", "Automatically generated list of changes in version %(version)s": "\u81ea\u52a8\u751f\u6210\u7684 %(version)s \u7248\u672c\u4e2d\u7684\u66f4\u6539\u5217\u8868", "C API changes": "C API \u66f4\u6539", "Changes in Version %(version)s — %(docstitle)s": "\u66f4\u6539\u53d1\u751f\u5728\u7248\u672c %(version)s— %(docstitle)s", "Collapse sidebar": "\u6298\u53e0\u8fb9\u680f", "Complete Table of Contents": "\u5b8c\u6574\u7684\u5185\u5bb9\u8868", "Contents": "\u76ee\u5f55", "Copyright": "\u7248\u6743\u6240\u6709", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "\u5c55\u5f00\u8fb9\u680f", "Full index on one page": "\u4e00\u9875\u7684\u5168\u90e8\u7d22\u5f15", "General Index": "\u603b\u76ee\u5f55", "Global Module Index": "\u5168\u5c40\u6a21\u5757\u7d22\u5f15", "Go": "\u8f6c\u5411", "Hide Search Matches": "\u9690\u85cf\u641c\u7d22\u7ed3\u679c", "Index": "\u7d22\u5f15", "Index – %(key)s": "\u7d22\u5f15 – %(key)s", "Index pages by letter": "\u6309\u7167\u5b57\u6bcd\u7684\u7d22\u5f15\u9875", "Indices and tables:": "\u7d22\u5f15\u548c\u8868\u683c\uff1a", "Last updated on %(last_updated)s.": "\u6700\u540e\u66f4\u65b0\u4e8e %(last_updated)s.", "Library changes": "\u5e93\u66f4\u6539", "Navigation": "\u5bfc\u822a", "Next topic": "\u4e0b\u4e00\u4e2a\u4e3b\u9898", "Other changes": "\u5176\u4ed6\u66f4\u6539", "Overview": "\u6982\u8ff0", "Permalink to this definition": "\u6c38\u4e45\u94fe\u63a5\u81f3\u76ee\u6807", "Permalink to this headline": "\u6c38\u4e45\u94fe\u63a5\u81f3\u6807\u9898", "Please activate JavaScript to enable the search\n functionality.": "\u8bf7\u6fc0\u6d3b JavaScript \u4ee5\u5f00\u542f\u641c\u7d22\u529f\u80fd\u3002", "Preparing search...": "\u51c6\u5907\u641c\u7d22\u2026\u2026", "Previous topic": "\u4e0a\u4e00\u4e2a\u4e3b\u9898", "Quick search": "\u5feb\u901f\u641c\u7d22", "Search": "\u641c\u7d22", "Search Page": "\u641c\u7d22\u9875\u9762", "Search Results": "\u641c\u7d22\u7ed3\u679c", "Search finished, found %s page(s) matching the search query.": "\u641c\u7d22\u5b8c\u6210\uff0c\u6709 %s \u4e2a\u9875\u9762\u5339\u914d\u3002", "Search within %(docstitle)s": "\u5728 %(docstitle)s \u4e2d\u641c\u7d22", "Searching": "\u641c\u7d22\u4e2d", "Searching for multiple words only shows matches that contain\n all words.": "\u641c\u5bfb\u5305\u542b\u591a\u4e2a\u5b57\u7684\u8bcd\u6c47\u65f6\uff0c\n \u53ea\u6709\u6240\u542b\u6240\u6709\u5185\u5bb9\u90fd\u5339\u914d\u65f6\u624d\u4f1a\u51fa\u73b0\u3002", "Show Source": "\u663e\u793a\u6e90\u4ee3\u7801", "Table of Contents": "\u76ee\u5f55", "This Page": "\u672c\u9875", "Welcome! This is": "\u6b22\u8fce\uff01\u8fd9\u662f", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "\u6ca1\u6709\u4efb\u4f55\u6587\u6863\u5339\u914d\u60a8\u7684\u641c\u7d22\u3002\u8bf7\u786e\u4fdd\u4f60\u8f93\u5165\u7684\u8bcd\u62fc\u5199\u6b63\u786e\u5e76\u9009\u62e9\u4e86\u5408\u9002\u7684\u5206\u7c7b\u3002", "all functions, classes, terms": "\u6240\u7684\u51fd\u6570\uff0c\u7c7b\uff0c\u672f\u8bed", "can be huge": "\u53ef\u80fd\u4f1a\u5f88\u591a", "last updated": "\u6700\u540e\u66f4\u65b0\u4e8e", "lists all sections and subsections": "\u5217\u51fa\u6240\u6709\u7684\u7ae0\u8282\u548c\u90e8\u5206", "next chapter": "\u4e0b\u4e00\u7ae0", "previous chapter": "\u4e0a\u4e00\u7ae0", "quick access to all modules": "\u5feb\u901f\u67e5\u770b\u6240\u6709\u7684\u6a21\u5757", "search": "\u641c\u7d22", "search this documentation": "\u641c\u7d22\u6587\u6863", "the documentation for": "\u8fd9\u4efd\u6587\u6863\u662f" }, "plural_expr": "0" });�����././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.mo����������������������������������������������0000644�0000766�0000024�00000173761�00000000000�021556� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$��������������,*����-*�����+��E��,��r���-��l���[.�� ���.�����.��*���.��=���/��7���E/��H���}/��?���/��"���0�� ���)0�����30��%���<0�����b0�����0�����0�����0�����0�� ���0�����0�����0�����1�����1�� ���"1�����C1�� ���U1�� ���a1�� ���k1��S���1�����1��A���1�����92�����P2�����g2�����x2�����2�� ���2�����2��6���2�����3�����!3��$���=3�����b3��3���4�� ���P4�����\4�����d4��1���j4��1���4��G���4�����5�����.5��0���A5�����r5��H���5�����5��b���o6�����6��6���6�����7�� ���57�� ���V7�� ���`7�����j7�����y7��>���7�� ���7��(���7��(���7�����8��?���<8�����|8�� ���8��!���8��8���8��%���8�����9�����9��4���29�� ���g9�� ���9�����9�����9�����9�����9�� ���9��%���9��%���:�����A:��:���_:��7���:�����:��"���:����� ;�����;�� ���%;�����0;�����L;��`���h;�����;��&���;������<��D���<��H���K<��K���<�����<�����<�����=��5��� =�����@=�����T=�����c=��8���u=��"���=��3���=��"���>��#���(>�����L>��!���T>��:���v>�����>�� ���>�� ���>�����>�� ���?�����!?�����5?��C���8?�����|?�����?��3��?��.���@�� ���@��.���A�����1A�����7A�����MA��D���cA�����A�����A�� ���B�����B��[���B�����$C�����BC�����`C��Y���rC��!���C�����C��2���C�� ���1D��C���<D�����D��n���D��E���E�� ���UE�����bE�� ���rE�� ���~E��-���E��(���E�� ���E�����E�� ���E��(��� F�����3F�����LF�����]F��Z���bF�����F�����F��,���F����F�����H�����$H�� ���5H�����CH�����LH�� ���bH�����mH�����H�����H�����H�����H�����H�����I��&���!I��B���HI��i���I��2���I��I���(J��4���rJ�����J�����J�����J�����J��y���K�����K�����K�����K�����K�� ���K�����K�����K����� L��#���L��$���?L�����dL�� ���xL�����L�����L�� ���L�����L�� ���L�����L�����L�����L�����L�����L�� ���M�����M��<���.M�����kM�� ���M��K���M�� ���M�����M�����M�����N��+���N�� ���EN��>���QN�����N��#���N�����N�����N�����N�����N�����N�����O��Y���%O��Z���O��*���O��3���P��/���9P��(���iP��.���P��P���P��p���Q�����Q��!���Q��"���Q��$���Q�� ��� R��e���.R��Z���R��N���R��T���>S��K���S��%���S�����T��[���%T��#���T��'���T��#���T��I���T��'���;U��!���cU��=���U��7���U�� ���U��d���V��W���jV��v���V�����9W�����@W�����DW�� ���IW��3���jW�����W�����W��"���W��<���W��Y���1X�� ���X�����X�����X��,���X�����X�����X�����X�����X��Y���Y�����"Z��%���Z��,���Z������[�����[�� ���#[�����/[�� ���7[�����C[�����K[��N���T[�����[��?���/\��-���o\��2���\�����\�����\�����]��9���]�����L]�� ���g]�� ���q]��X���~]��,���]��2���^��b���7^��5���^��\���^��M���-_��(���{_��G���_�����_��7���`�����9`��8���O`�����`�� ���`��%���`��`���`�����0a�����Na�����ma�����}a�����a�� ���a��&���a��$���a�����a�����b�����/b�����Jb�����_b��A���b��Z���b��-���c�����Jc�����ic�����c��!���c��8���c�����c�� ���c����� d�����d��7���%d��6���]d��;���d��I���d��;���e��:���Ve��H���e��9���e��G���f��2���\f��2���f�����f��4���f�����g�����g�����:g��C���Qg��2���g�����g�����g�����g�����h�����6h�����Uh�����ih�����|h��(���h��=���h�����h����� i��0���i�����Mi�����Ri��/���li�����i��*���i��&���i�� ��� j��9���j�����Mj�����^j�� ���|j�����j��-���j�����j�����j��1���k��*���Ak�����lk�����k��0���k��&���k�����k�����k��(���l�����>l�����Nl�����kl��%���l��e���l�����m��4���m�����m�����m��Y����n��;���Zn��.���n�����n�����n�����n��.���o��4���Go��+���|o��4���o��(���o��4���p��W���;p�����p�����p�����p��X���p��J���;q�����q��%���q�� ���q�����q�����q��+���q�����r�����0r�� ���Pr��8���Zr��M���r��u���r�����Ws�����is�����|s�����s�����s��A���s�� ���s�����t��6���"t��I���Yt��A���t�����t��0����u�����1u��G���Hu��N���u�����u�����u��.���u�����'v��4���:v�� ���ov��,���}v��3���v�� ���v��=���v�����*w��'���Gw��0���ow��(���w��1���w��,���w��!���(x�����Jx�����ix�����x��=���x��+���x��0��� y��V���;y��V���y��M���y��R���7z��$���z�����z�����z��N���z��0���{��)���I{�����s{�����{�����{��/���{�����{�����|�����-|��&���D|��!���k|��&���|�����|��E���|�� ���}��*���}��7���:}��"���r}��(���}�����}�����}�����}��"���~�����7~�����=~�����U~��;���j~�����~�����~��"���~��!���~�����~��#���������$��D���,��5���q�� ���������� �����1�����E�����B���<��G�����%���ǀ�������#�����#���+��,���O�����|��-�����(���Ɓ��D����� ���4��#���?��(���c��#��������������������(���ς������������8����� ���O��P���p��"���������������O��������h�����}������������%����� ���ф�����߄��,����� �����(���(��E���Q�� �����*�����1���υ��7��������9�� ���U�����`�����s��������������������Æ��&���ֆ������������4��������O��%���d�������c��������������� �����'���"��:���J�� �����@������������������ ��&�����*���F��&���q��W�����>�����7���/�� ���g�� ���q�� �����,�����*�����0����������%���0�����V�������1�����1����������\���������]��'���y��%�����+���Ǎ��^�����2���R��5�������������ڎ�������5��������/�����K��+���Q��-���}�������!���Ǐ��!�������� ��!���!�����C�����Z��#���c��*������������������ΐ��P��������6��)���U��9�����;�����)�������������'�����:�����S�����l�������������������ʒ��e����������������ޗ�����h�� �����������%�����6���-��)���d��H�����8���י��"��������3�� ���H��"���V�����y������������ ���������� ���К�����ܚ������������ �������������6�� ���N�� ���Z��*���f��V����������F��������A�����Z�����n������������ ����������:���͜��"����� ���+��+���L�����x��+���$�� ���P�����]�����f��-���o��-�����W���˞�����#�����5��$���H�����m��A��������ş��c���J�������1������������� �����(�����/�� ���6�� ���C��4���N�� �����(�����*����������1��������/�� ���6�����C��@���a��&��������ɢ�����Т��6�����!��������:�� ���K�����X�����k������� �����"�����"��������ܣ��J�����6���=�����t��*�������������Τ�� ���դ�����ߤ�������U��������\�����l�������9�����M���ɥ��<��������T�����h�� ���o��*���|������� ��������Ħ��2���צ��#��� ��1���.��!���`��#���������������'���ͧ�� �����!��������8�����?�� ���U�����_�����r��9���y����������ƨ�����ͨ��)����������+�������������!�����8�����Q�����i�����|�� ���g�����t��V����� ���������������\���)��!����� �����4����� �����8�����"���*��y���M��G���ǭ�� ���������� ���-�� ���:��$���G��*���l�����������������+���������� ����������L��������c�����j��)���q������������ ����� ��������ð�����ʰ�������������������������)�����?�����U�����k��$�����-�����~���ױ��>���V��?�����0���ղ����������%�����C�����Z��y���m��������������� �� ����� ���*�����7�� ���J�� ���W��%���d������������ ��������Ǵ�����δ�����޴������� ������������������������+�����2�� ���G�� ���T��(���a������� �����\�������� �� ��������"�����)��*���A�����l��3���|�������(����������������������������%�� ���,��V���9��S������������������ �����<�����V��6���r��[�����)�����)���/��*���Y��,�����(�����U���ڹ��X���0�������U���/��D��������ʻ��!�����d��� ��'���p��*�����+���ü��3�����%���#��*���I��+���t��&��������ǽ��N���ν��T�����_���r�����Ҿ�� ���پ�� ����������3���������4�� ���L��&���m��3�����Q���ȿ����������!�����(��,���/�����\�����l�� ����������M���G��i�����&�����%���&�����L�����d�� ���m�����{������������ �����d�����w��� ��O�����-�����2��������6�����R�����i��?���y������������ �����M�����"���.��0���Q��]�����6�����Q�����T���i��,�����B��������.��3���G�����{��3���������� �����'�����f��������z����������������� ����������'�����#��������>�� ���Z�����{�������&�����1�����O�����*���V�� �����'���������������;��������,�� ���0�����:�����J��9���Q��<�����A�����W��� ��A���b��@�����U�����?���;��T���{��>�����8��������H��)���X������� ����� �����E�����.��������$�����<�����Z�����v����������������������$�����C��������L�����b��/���r������������2����������K�����'���[�������"����� ���������� ����������'�������������.��*���A��1���l������������/�����'����� �����!�����*���>�����i�����y������������f����������6���������������R�����4���Y��(��������������������1�����2���@��-���s��/�����-�����3�����`���3�����������������?�����K��������a�����h�� ����� ����������!�����$�����!����������.�����P���I��v����� �������������.�����5�����K�����a�� ����� �����4�����C�����R���&�����y�� ����������0�����L���������M�� ���T��(���a�������0�������������������� ��� ��F��������a��&���~��/�����'�����0�����K���.��$���z�� ���������������5�����1���/��6���a��Q�����Q�����K���<��Q�����0�������� �������:���'��0���b��'����������#�����"�����1��������N��!���k��"�����4��������������� �����T���(�����}��*�����#����������#�������������4�����P��"���h������������ �����=���������������#�����&��������F�����M�����h��K���o��*����� ����� ����� �����'�����<���,��9���i��>����� �����!�����4���%��'���Z��3����������*�����%������1���&�� ���X�����e��%��������������� ����� �����!���������������@��������^��F���t�����������������N��� �����X�� ���g�� ���t�� ���~��*����� ����� �����/����� �����'�����V���/�������/����������!���������� ��� �����-�����B�� ���b�����p�� ����������,���������������"�������� ��!���%�����G��K���N�� ���������� �����'�����=�����'�����>���F�����������������#���������������W�����8���p��0���������� ����������(�����)�����'���H��!���p��!�������������:��%�����%�������� ��K��������g��$�����"�����%�����=�����+���+��%���W��$���}������������H���������� ���&��0���0��.���a�������$�����'������������������0�����?��.���R��4���������� ����������U��������9��.���S��@�����H�����6��� �����C�����J�����g�����z����������������������� Generate ReStructuredText using autosummary directives. sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates the reStructuredText files from the autosummary directives contained in the given input files. The format of the autosummary directive is documented in the ``sphinx.ext.autosummary`` Python module and can be read using:: pydoc sphinx.ext.autosummary � Generate required files for a Sphinx project. sphinx-quickstart is an interactive tool that asks some questions about your project and then generates a complete documentation directory and sample Makefile to be used with sphinx-build. � Look recursively in <MODULE_PATH> for Python modules and packages and create one reST file with automodule directives per package in the <OUTPUT_PATH>. The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be excluded from generation. Note: By default this script will not overwrite already created files.� Run 'make' in that directory to run these through (pdf)latex (use `make latexpdf' here to do that automatically).� Run 'make' in that directory to run these through makeinfo (use 'make info' here to do that automatically).� (deprecated)� (in �"::" in automodule name doesn't make sense�"latex_documents" config value references unknown document %s�"man_pages" config value references unknown document %s�"quiet" is specified, but any of "project" or "author" is not specified.�"texinfo_documents" config value references unknown document %s�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%r doesn't have "%s" setting�%r doesn't have "theme" setting�%s %s�%s %s documentation�%s (%s attribute)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command %r cannot be run (needed for math display), check the imgmath_%s setting�%s command line option�%s is already assigned section numbers (nested numbered toctree?)�%s is not a directory.�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'%s' is not a valid option.�'%s' is not a valid pyversion option�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�(in %s)�, in �-A option argument must be in the form name=value�-D option argument must be in the form name=value�4 column based index found. It might be a bug of extensions you use: %r�:%s: (directive option)�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�====================== slowest reading durations =======================�A Makefile and a Windows command file can be generated for you so that you only have to run e.g. `make html' instead of invoking sphinx-build directly.�A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!�About these documents�An error happened in rendering the page %s. Reason: %r�Anchor '%s' not found�Any IDs not assigned for %s node�Arguments�Attention�Author name(s)�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Cannot use "lineno-match" with a disjoint set of "lines"�Cannot use both "%s" and "%s" options�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not fetch remote image: %s [%d]�Could not fetch remote image: %s [%s]�Could not import extension %s�Could not lex literal_block as "%s". Highlighting skipped.�Could not obtain image size. :scale: option is ignored.�Create Makefile? (y/n)�Create Windows command file? (y/n)�Creating file %s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Encoding %r used for reading included file %r seems to be wrong, try giving an :encoding: option�Encoding error:�Enter the root path for documentation.�Error�Error: an existing conf.py has been found in the selected root path.�Error: specified path is not a directory, or sphinx files already exist.�Error: the master file %s has already been found in the selected root path.�Event %r already present�Example�Examples�Exception occurred while building, starting debugger:�Exception occurred:�Expand sidebar�Extension options�External Graphviz file %r not found or reading it failed�Failed to read build info file: %r�Failed to read intersphinx_mapping[%s], ignored: %r�Failed to scan documents in %s: %r�Failed to write build info file: %r�Fig. %s�File %s already exists, skipping.�Finished: An initial directory structure has been created.�Footnote [#] is not referenced.�Footnote [%s] is not referenced.�Footnotes�Full index on one page�General Index�Global Module Index�Go�Graphviz directive cannot have both content and a filename argument�Hide Search Matches�Hint�If the documents are to be written in a language other than English, you can select a language here by its language code. Sphinx will then translate text that it generates into that language. For a list of supported codes, see https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language.�Ignoring "graphviz" directive without content.�Important�Include file %r not found or reading it failed�Index�Index – %(key)s�Index pages by letter�Indicate which of the following Sphinx extensions should be enabled:�Indices and tables:�Inside the root directory, two more directories will be created; "_templates" for custom HTML templates and "_static" for custom stylesheets and other static files. You can enter another prefix (such as ".") to replace the underscore.�Interrupted!�Invalid caption: %s�Invalid date format. Quote the string by single quote if you want to output it directly: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�Keyword Arguments�LaTeX command %r cannot be run (needed for math display), check the imgmath_latex setting�Last updated on %(last_updated)s.�Library changes�Line spec %r: no lines pulled from include file %r�Listing %s�Look for any errors in the above output or in %(outdir)s/output.txt�Makefile and Batchfile creation�Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Many math_renderers are registered. But no math_renderer is selected.�Module Index�Module author: �Module code�Module level�Name of your master document (without suffix)�Name prefix for templates and static dir�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Non-alphabetical�Note�Note: imgmath and mathjax cannot be enabled at the same time. imgmath has been deselected.�Notes�Numbers�Object named %r not found in include file %r�One document is special in that it is considered the top node of the "contents tree", that is, it is the root of the hierarchical structure of the documents. Normally, this is "index", but if your "index" document is a custom template, you can also set this to another filename.�Original exception: �Other Parameters�Other changes�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this toctree�Pillow not found - copying image files�Please activate JavaScript to enable the search functionality.�Please also report this if it was a user error, so that a better error message can be provided next time.�Please enter a file suffix, e.g. '.rst' or '.txt'.�Please enter a new file name, or rename the existing file and press Enter�Please enter a new root path (or just Enter to exit)�Please enter a valid path name.�Please enter either 'y' or 'n'.�Please enter one of %s.�Please enter some text.�Please enter values for the following settings (just press Enter to accept a default value, if one is given in brackets).�Preparing search...�Previous topic�Project basic options�Project language�Project name�Project release�Project templating�Project version�Pygments lexer name %r is not known�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Recursion error:�References�Release�Return type�Returns�Root path for the documentation�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Searching for multiple words only shows matches that contain all words.�Section %s�Section author: �See also�Selected root path: %s�Separate source and build directories (y/n)�Show Source�Source directory and destination directory cannot be identical�Source file suffix�Source parser for %s not registered�Structure options�Symbols�TODO entry found: %s�Table %s�Table of Contents�Template Parameters�Testing of coverage in the sources finished, look at the results in %(outdir)spython.txt.�Testing of doctests in the sources finished, look at the results in %(outdir)s/output.txt.�The %r crossref_type is already registered�The %r directive is already registered to domain %s�The %r index is already registered to domain %s�The %r object_type is already registered�The %r role is already registered to domain %s�The %s extension is required by needs_extensions settings, but it is not loaded.�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The HTML page is in %(outdir)s.�The HTML pages are in %(outdir)s.�The LaTeX files are in %(outdir)s.�The Texinfo files are in %(outdir)s.�The XML files are in %(outdir)s.�The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.�The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.�The config value `{name}' has type `{current.__name__}'; expected {permitted}.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The dummy builder generates no files.�The ePub file is in %(outdir)s.�The full traceback has been saved in %s, if you want to report the issue to the developers.�The manual pages are in %(outdir)s.�The message catalogs are in %(outdir)s.�The overview file is in %(outdir)s.�The project name will occur in several places in the built documentation.�The pseudo-XML files are in %(outdir)s.�The text files are in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Translator for %r already exists�Unknown configure key: latex_elements[%r], ignored.�Unknown event name: %s�Unknown image format: %s...�Unknown math_renderer %r is given.�Use the Makefile to build the docs, like so: make builder�Use the sphinx-build command to build the docs, like so: sphinx-build -b builder %s %s�Variables�Warning�Warns�Welcome to the Sphinx %s quickstart utility.�Welcome! This is�Would create file %s.�Yields�You have two options for placing the build directory for Sphinx output. Either, you use a directory "_build" within the root path, or you separate "source" and "build" directories within the root path.�You should now populate your master file %s and create other documentation source files. �Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[autosummary] failed to import %r: %s�[autosummary] generating autosummary for: %s�[autosummary] writing to %s�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__�a Unicode error occurred when rendering the page %s. Please make sure all config values that contain non-ASCII content are Unicode strings.�a list of specific files to rebuild. Ignored if -a is specified�a suitable image for %s builder not found: %s�a suitable image for %s builder not found: %s (%s)�all functions, classes, terms�all of %d po files�all source files�append module_path to sys.path, used when --full is given�assembling single document�attribute�author names�autodoc: failed to determine %r to be documented, the following exception was raised: %s�automatically insert docstrings from modules�automatically test code snippets in doctest blocks�autosummary generats .rst files internally. But your source_suffix does not contain .rst. Skipped.�autosummary references excluded document %r. Ignored.�autosummary: failed to determine %r to be documented, the following exception was raised: %s�autosummary: stub file not found %r. Check your autosummary_generate setting.�autosummary_generate: file not found: %s�both tabularcolumns and :widths: option are given. :widths: is ignored.�broken link: %s (%s)�build %s, %s warning (with warnings treated as errors).�build %s, %s warning.�build %s, %s warnings (with warnings treated as errors).�build %s, %s warnings.�build %s.�build environment version not current�build in parallel with N processes where possible (special value "auto" will set N to cpu-count)�build info file is broken: %r�builder to use (default: html)�building [%s]: �building [mo]: �built-in function�can be huge�cannot combine -a option and filenames�cannot copy downloadable file %r: %s�cannot copy extra file %r�cannot copy image file %r: %s�cannot copy static file %r�cannot find files %r�cannot open warning file %r: %s�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�cannot read image file %r: copying it instead�cannot write image file %r: %s�caption not inside a figure.�checking consistency�checks for documentation coverage�circular toctree references detected, ignoring: %s <- %s�class�class method�command line option�concept�conditional inclusion of content based on config values�conf value "epub_author" should not be empty for EPUB3�conf value "epub_contributor" should not be empty for EPUB3�conf value "epub_copyright" (or "copyright")should not be empty for EPUB3�conf value "epub_description" should not be empty for EPUB3�conf value "epub_identifier" should not be empty for EPUB3�conf value "epub_language" (or "language") should not be empty for EPUB3�conf value "epub_publisher" should not be empty for EPUB3�conf value "epub_title" (or "html_title") should not be empty for EPUB3�conf value "epub_uid" should be XML NAME for EPUB3�conf value "version" should not be empty for EPUB3�config changed�config directory doesn't contain a conf.py file (%s)�console output options�continued from previous page�continues on next page�convert command %r cannot be run, check the image_converter setting�convert exited with error: [stderr] %r [stdout] %r�copying TeX support files�copying TeX support files...�copying Texinfo support files�copying additional files�copying downloadable files... �copying extra files�copying images... �copying source files...�could not read %r for changelog creation�create .nojekyll file to publish the document on GitHub pages�create batchfile�create makefile�custom template directory (default: %(default)s)�data�default role %s not found�default suffix for files (default: %(default)s)�define a template variable�define tag: include "only" blocks with TAG�dimension unit %s is invalid. Ignored.�directive�directive %r is already registered, it will be overridden�directive-option�directory to place all output�directory to place all output in�display latex %r: %s�do emit colored output (default: auto-detect)�do not create batchfile�do not create makefile�do not emit colored output (default: auto-detect)�do not use make-mode for Makefile/make.bat�docnames to write: %s�document�document imported members (default: %(default)s)�document isn't included in any toctree�document language�document not readable. Ignored.�document title is not a single Text node�doing serial %s�domain %s already registered�domain %s not yet registered�don't create a table of contents file�don't create headings for the module/package packages (e.g. when the docstrings already contain them)�don't know which module to import for autodocumenting %r (try placing a "module" or "currentmodule" directive in the document, or giving an explicit module name)�don't use a saved environment, always read all files�done�dot code %r: %s�dot command %r cannot be run (needed for graphviz output), check the graphviz_dot setting�dot did not produce an output file: [stderr] %r [stdout] %r�dot exited with error: [stderr] %r [stdout] %r�download file not readable: %s�dumping object inventory�dumping search index in %s�duplicate %s description of %s, other %s in %s�duplicate %s description of %s, other instance in %s�duplicate citation %s, other instance in %s�duplicate description of %s %s, other instance in %s�duplicate label %s, other instance in %s�duplicate label of equation %s, other instance in %s�duplicate object description of %s, other instance in %s, use :noindex: for one of them�duplicated ToC entry found: %s�enable %s extension�enable arbitrary extensions�encountered some issues with some of the inventories, but they had working alternatives:�encountered title node not in section, topic, table, admonition or sidebar�enum�enumerable_node %r already registered�enumerator�environment variable�environment variable; %s�error while formatting arguments for %s: %s�error writing file %s: %s�error writing file Makefile: %s�exception�exception while evaluating only directive expression: %s�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extension options�extensions changed�failed�failed to import object %s�failed to parse name %s�failed to reach any of the inventories with the following issues:�failed: %s�favicon file %r does not exist�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�file suffix (default: rst)�filename of table of contents (default: modules)�finished with problems�fnmatch-style file and/or directory patterns to exclude from generation�follow symbolic links. Powerful when combined with collective.recipe.omelette.�function�general options�generate a full project with sphinx-quickstart�generating indices�glossary seems to be misformatted, check indentation�glossary term�glossary term must be preceded by empty line�glossary terms must not be separated by empty lines�grammar token�graphviz_output_format must be one of 'png', 'svg', but is %r�highlighting module code... �html_extra_path entry %r does not exist�html_extra_path entry %r is placed inside outdir�html_static_path entry %r does not exist�html_static_path entry %r is placed inside outdir�if specified, separate source and build dirs�ignoring invalid doctest code: %r�image file %s not readable: %s�image file not readable: %s�include "_private" modules�include links to the source code of documented Python objects�include math, rendered as PNG or SVG images�include math, rendered in the browser by MathJax�inconsistent citation references in translated message. original: {0}, translated: {1}�inconsistent footnote references in translated message. original: {0}, translated: {1}�inconsistent references in translated message. original: {0}, translated: {1}�inconsistent term references in translated message. original: {0}, translated: {1}�increase verbosity (can be repeated)�index�inline latex %r: %s�interpret module paths according to PEP-0420 implicit namespaces specification�intersphinx identifier %r is not string. Ignored�intersphinx inventory has moved: %s -> %s�invalid TestCode type�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�invalid regex %r in %s�invalid regex %r in coverage_c_regexes�invalid signature for auto%s (%r)�job number should be a positive number�keyword�kwargs for add_node() must be a (visit, depart) function tuple: %r=%r�last updated�line number spec is out of range(1-%d): %r�link between Sphinx documentation of different projects�lists all sections and subsections�loading intersphinx inventory from %s...�loading pickled environment�loading translations [%s]... �logo file %r does not exist�looking for now-outdated files... �macro�making output directory�master document name�maximum depth of submodules to show in the TOC (default: 4)�member�method�missing '+' or '-' in '%s' option.�missing attribute %s in object %s�module�module %s could not be imported: %s�modules�more than one target found for 'any' cross-reference %r: could be %s�more than one target found for cross-reference %r: %s�new config�next�next chapter�nit-picky mode, warn about all missing references�no "latex_documents" config value found; no documents will be written�no "man_pages" config value found; no manual pages will be written�no "texinfo_documents" config value found; no documents will be written�no Babel option known for language %r�no changes in version %s.�no code/output in %s block at %s:%s�no output at all, not even warnings�no output on stdout, just warnings on stderr�no targets are out of date.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�none found�not available for built-in messages�numfig is disabled. :numref: is ignored.�numfig_format is not defined for %s�object�operator�original entry�override a setting in configuration file�overwrite existing files�page�page %s matches two patterns in html_sidebars: %r and %r�pass a value into HTML templates�path for the cached environment and doctree files (default: OUTPUTDIR/.doctrees)�path to documentation source files�path to module to document�path to output directory�path where configuration file (conf.py) is located (default: same as SOURCEDIR)�pickling environment�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�program option�project author(s), used when --full is given�project name�project name (default: root module name)�project release, used when --full is given, defaults to --doc-version�project root�project version, used when --full is given�put documentation for each module on its own page�put module documentation before submodule documentation�quick access to all modules�quiet mode�reST markup error:�reading error: %s, %s�reading sources... �reading templates... �reference label�release of project�replacement for dot in _templates etc.�resolving references...�role�role %r is already registered, it will be overridden�run Pdb on exception�run the script without creating files�search�search index couldn't be loaded, but not all documents will be built: the index will be incomplete.�search this documentation�see %s�see also %s�self referenced toctree found. Ignored.�setting %s.%s occurs in none of the searched theme configs�show full traceback on exception�signature arguments or return annotation given for automodule %s�skipped�source directory has changed�source file suffix�source files to generate rST files for�source_parser for %r is already registered�source_suffix %r is already registered�sphinx-quickstart only generate into a empty directory. Please specify a new root path.�sphinx-quickstart will not overwrite existing Sphinx projects.�sphinx-quickstart will not overwrite the existing file.�statement�static method�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�targets for %d template files�template directory for template files�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension is not safe for parallel reading�the %s extension is not safe for parallel writing�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�toctree contains ref to nonexisting file %r�toctree contains reference to document %r that doesn't have a title: no link will be generated�toctree contains reference to excluded document %r�toctree contains reference to nonexisting document %r�too large :maxdepth:, ignored.�turn warnings into errors�type�undecodable source characters, replacing with "?": %r�unimplemented node type: %r�union�unknown %r toplevel_sectioning for class %r�unknown config value %r in override, ignoring�unknown index entry type %r�unknown index entry type %s found�unknown mimetype for %s, ignoring�unknown node type: %r�unsupported theme option %r given�updating environment: �use epub�use make-mode for Makefile/make.bat�use no config file at all, only -D options�variable�version of project�waiting for workers...�where "builder" is one of the supported builders, e.g. html, latex or linkcheck.�while setting up extension %s:�with -W, keep going when getting warnings�write "todo" entries that can be shown or hidden on build�write all files (default: only write new and changed files)�write warnings (and errors) to given file�writing�writing %s file...�writing additional files�writing additional pages�writing error: %s, %s�writing message catalogs... �writing output... �writing summary file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: zh_CN Language-Team: Chinese (China) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_CN/) Plural-Forms: nplurals=1; plural=0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � 用 autosummary 指令生成 ReStructuredText sphinx-autogen 是 sphinx.ext.autosummary.generate 的前端，它根据给定 的输入文件中的 autosummary 指令生成 reStructuredText  文件 autosummary 指令的格式见 Python 模块 ``sphinx.ext.autosummary`` 的文 档，并且可以这样调出文档阅读:: pydoc sphinx.ext.autosummary � 生成 Sphinx 项目的必需文件。 sphinx-quickstart 是一个交互式工具，询问一些关于项目的问题，生成 完整的文档目录和用于 sphinx-build 的示例 Makefile。 � 在 <MODULE_PATH> 中递归查找 Python 模块和包，然后在 <OUTPUT_PATH> 中为每个使用了 automodule 指令的包创建一个 reST 文件。 <EXCLUDE_PATTERN> 可以排除生成符合规则的文件/目录的文档。 提示：本脚本默认不会覆盖已有文件。� 在该目录下运行“make”以通过 (pdf)latex 运行这些 LaTex 文件 （在此处用“make latexpdf”即可自动执行）。� 在该目录下运行“make”命令以通过 makeinfo 运行这些 Texinfo文件 （在此处用“make info”即可自动执行）。� (已移除)� (在 �automodule 名中的“::”无意义�配置项“latex_documents”引用了未知文档 %s�"man_pages"配置值引用未知文档 %s�指定了“quiet”，但是没有指定“project”和“author”。�配置项“texinfo_documents”引用了未知文档 %s�%(filename)s — %(docstitle)s�%Y 年 %m 月 %d 日�找到 %d 个�命令行给出了 %d 个源文件�%r 未包含 "%s" 配置�%r 未包含 "theme" 配置�%s %s�%s %s 文档�%s (%s 属性)�%s (C++ %s)�%s (內置类)�%s (內置变量)�%s (%s 中的类)�%s (指令)�%s (全局变量或常量)�%s() (在 %s 模块中)�%s (模块)�%s (角色)�已添加 %s，%s 已更改，%s 已移除�无法运行 %s 命令 %r （数学公式显示必需），请检查 imgmath_%s 设置�%s命令行选项�已经给 %s 分配了章节编号（嵌套的带编号文档树？）�%s 不是一个目录。�%s() (%s 类方法)�%s() (%s 方法)�%s() (%s 静态方法)�%s() (內置函数)�%s() (类)�%s() (在 %s 模块中)�© <a href="%(path)s"> 版权所有</a> %(copyright)s.�© 版权所有 %(copyright)s.�'%s' 不是一个有效选项。�'%s' 不是一个有效的 pyversion 选项�当前 conf.py 中定义的 'setup' 不是一个可调用的 Python 对象。请把其定义改为一个可调用的函数。Sphinx 扩展的 conf.py 必须这样配置。�(<<original entry>> 见 %s，第 %d 行。)�(在 %s v%s)�(在 %s)�， 在 �-A 选项的参数必须是 name=value 形式�-D 选项的参数必须是 name=value 形式�发现使用了 4 列布局的索引页。可能是你所用的扩展出现了 Bug：%r�%s (指令选项)�<<original entry>>�<h1>代码可用的所有模块</h1>�<h1>%s 源代码</h1>�====================== 最长阅读时长 =======================�生成 Makefile 和 Windows 批处理文件，可以直接像“make html”这样 运行，而不需要直接调用 sphinx-build。�请向 Bug 追踪系统 <https://github.com/sphinx-doc/sphinx/issues> 投递 Bug 报告。谢谢！�关于这些文档�渲染页面 %s 时发生了错误。 原因：%r�锚点“%s”未找到�没有给 %s 节点分配 ID�参数�注意�作者名称�作者： �自动生成的 %(version)s 版本中的更改列表�基类：%s�构建程序 %r 已存在 (见模块 %s)�构建程序类 %s 未包含 "name" 属性�构建程序 %s 未注册�构建程序 %s 未注册或在入口点不可用�内置�C API 更改�无法找到源码目录 (%s)�不能在互斥的 "lines" 集合上使用 "lineno-match" 选项�"%s" 和 "%s" 选项不能同时使用�小心�在 %s 版更改�更改发生在版本 %(version)s— %(docstitle)s�引文 [%s] 没有被引用过。�代码作者： �折叠边栏�完整的内容表�配置项 %r 已存在�目录�版权所有�无法获取远程图像：%s [%d]�无法获取远程图像：%s [%s]�无法导入扩展 %s�无法按照“%s”语言的词法解析代码块，跳过语法高亮。�无法获取图像尺寸，已忽略 :scale: 选项。�创建 Makefile？（y/n）�创建 Windows 批处理文件？（y/n）�创建文件 %s。�危险�已移除�%s 版后已移除�没有注册 %r 域�用于读取包含文件 %r 的编码 %r 不正确，请重新给定 encoding: 选项�编码错误：�输入文档的根路径。�错误�错误：选择的根路径中已存在 conf.py 文件。�错误：指定的路径不是一个目录，或是 Sphinx 文件已存在。�错误：选择的根目录下已存在主文档文件 %s。�事件 %r 已存在�示例�实际案例�构建时抛出异常，启动调试器：�抛出异常：�展开边栏�扩展程序选项�外部 Graphviz 文件 %r 不存在或读取失败�读取构建信息文件失败：%r�无法读取intersphinx_mapping[%s]，忽略：%r�在 %s 中扫描文档失败：%r�写入构建信息文件失败：%r�图 %s�文件 %s 已存在，跳过。�完成：已创建初始目录结构。�脚注 [#] 没有被引用过。�脚注 [%s] 没有被引用过。�脚注�一页的全部索引�总目录�全局模块索引�转向�Graphviz 指令不能同时指定内容和文件名参数�隐藏搜索结果�提示�如果用英语以外的语言编写文档， 你可以在此按语言代码选择语种。 Sphinx 会把内置文本翻译成相应语言的版本。 支持的语言代码列表见： http://sphinx-doc.org/config.html#confval-language。�已忽略无内容的 "graphviz 指令。�重要�包含的文件 %r 不存在或读取失败�索引�索引 – %(key)s�按照字母的索引页�启用 Sphinx 扩展：�索引和表格：�这个选项将在根目录中创建两个文件夹：“_templates”用于自定义 HTML 模板文件，“_static”用于自定义样式表及其他静态文件。您可以输入其它的前缀（比如“.”）代替下划线。�已中断！�无效的标题：%s�无效的日期格式。如果你想直接输出日期字符串，请用单引号：%s�无效的 math_eqref_format：%r�无效模板变量：%s�关键字参数�无法运行 LaTeX 命令 %r （数学公式显示必需），请检查 imgmath_latex 设置�最后更新于 %(last_updated)s.�库更改�行规范 %r：未能从包含文件 %r 中拉取行�列表 %s�在上述输出或 %(outdir)s/output.txt 中检查错误�创建 Makefile 和批处理文件�畸形的选项描述 %r，应是“opt”、“-opt args”、“--opt args”、“/opt args”或“+opt args”形式�注册了多个 math_renderers。但没有选择任何 math_renderer。�模块索引�模块作者： �模块代码�模块级别�主文档文件名（不含后缀）�模板目录名和静态目录名的前缀�导航�%s 新版功能�下一个主题�未选择构建程序，默认使用：html�不存在的配置项：%s�非字母�注解�注意：imgmath 和 mathjax 不能同时启用。已取消选择 imgmath。�提示�数值�对象 %r 在包含文件 %r 中不存在�这其中有一种特殊的文档被视作“目录树”的树顶节点，即文档层级 结构的根。通常情况下，这个文档是“index”，但是如果你的“index”文 档使用了自定义模板，你也可以使用其它文件名。�原始异常： �其他参数�其他更改�概述�概览：模块代码�参数�永久链接至代码�永久链接至目标�公式的永久链接�永久链接至标题�永久链接至图片�永久链接至表格�永久链接至目录树�未找到Pillow - 复制图像文件�请激活 JavaScript 以开启搜索功能。�如果此处抛出了用户的错误，也请向我们报告，这样以后可以显示更友好、更详细的错误信息。�请输入文件后缀，例如：“.rst”或者“.txt”。�请输入新文件名，若要重命名现有文件请按回车�请输入新的根路径（或按回车退出）�请输入有效的路径名。�请输入“y”或“n”。�请输入 %s 之一。�请输入文本。�请输入接下来各项设置的值（如果方括号中指定了默认值，直接 按回车即可使用默认值）。�准备搜索……�上一个主题�项目基本参数�项目语种�项目名称�项目发行版本�项目模板�项目版本�未知的 Pygments 词法分析器 %r�Python 提高建议; PEP %s�Python 模块索引�快速搜索�引发�递归错误：�引用�发布�返回类型�返回�文档的根路径�正在运行 Sphinx v%s�搜索�搜索 %(docstitle)s�搜索页面�搜索结果�搜索完成，有 %s 个页面匹配。�在 %(docstitle)s 中搜索�搜索中�搜寻包含多个字的词汇时， 只有所含所有内容都匹配时才会出现。�节 %s�节作者： �参见�已选择根路径：%s�独立的源文件和构建目录（y/n）�显示源代码�源文件目录和目标目录不能是同一目录�源文件后缀�未注册 %s 的源代码语法分析器�文档结构参数�符号�已发现 TODO 条目：%s�表 %s�目录�模板参数�已完成源文件的覆盖率测试，请在 %(outdir)s/python.txt 中查看结果。�已完成源文件的文档测试，请在 %(outdir)s/output.txt 中查看结果。�交叉引用类型 %r 已注册�%r 指令已注册到域 %s�%r 索引已注册到域 %s�对象类型 %r 已注册�%r 角色已注册到域 %s�未能加载 needs_extensions 配置项所需的 %s。�该项目所用扩展 %s 需要 Sphinx 版本 %s 以上；当前版本无法构建文档。�HTML 页面保存在 %(outdir)s 目录。�HTML 页面保存在 %(outdir)s 目录。�LaTex 文件保存在 %(outdir)s 目录。�Texinfo 文件保存在 %(outdir)s 目录。�XML 文件保存在 %(outdir)s 目录。�配置值"source_后缀"需要字符串、字符串列表或字典。但给出"%r"。�配置项 `{name}' 的类型是 `{current.__name__}'，默认为 `{default.__name__}'。�配置值"[name]"的类型为"[当前._name];但"当前"为"当前"。"当前"为"当前"。"当前"为"当前"。=================================预期 [允许]。�配置项 `{name}` 必须设置为 {candidates} 之一，但现在是 `{current}` 。�配置文件（或配置文件导入的模块）调用了 sys.exit()�伪构建器不生成文件。�ePub文件保存在 %(outdir)s。�如果你想向开发者报告问题，可以查阅已经保存在 %s 的完整 Traceback 信息 。�手册页保存在 %(outdir)s 目录。�消息目录保存在 %(outdir)s 目录。�概览文件保存在 %(outdir)s 目录 。�项目名称将会出现在文档的许多地方。�伪 XML 文件保存在 %(outdir)s。�文本文件保存在 %(outdir)s 目录。�配置文件中有程序上的错误： %s�配置文件中存在语法错误: %s �本页�本环境与选择的构建器不兼容，请选择其他的文档树目录。�该项目需要 Sphinx v%s 及以上版本，使用现有版本不能构建文档。�该项目所需扩展 %s 最低要求版本 %s ，当前加载版本 (%s) 无法构建文档。�抛出�小技巧�待处理�翻译已存在 %r�未知配置项：latex_elements[%r]，已忽略。�未知事件名称：%s�未知的图像格式：%s……�给定了未知的 math_renderer %r。�用 Makefile 构建文档，例如： make builder�用 sphinx-build 命令构建文档，像这样： sphinx-build -b builder %s %s�变量�警告�警告�欢迎使用 Sphinx %s 快速配置工具。�欢迎！这是�将会创建文件 %s。�生成器�有两种方式来设置 Sphinx 输出的创建目录： 一是在根路径下创建“_build”目录，二是在根路径下创建“source” 和“build”两个独立的目录。�你现在可以填写主文档文件 %s 并创建其他文档源文件了。 �没有任何文档匹配您的搜索。请确保你输入的词拼写正确并选择了合适的分类。�[autosummary] failed to import %r：%s�[autosummary] 生成 autosummary：%s�[autosummary] 写入 %s�[文档]�[图表：%s]�[图表]�[图片： %s]�[图片]�[源代码]�__all__ 应是一个字符串列表，而不是 %r （出现在模块 %s 中） -- 已忽略__all__�渲染页面 %s 时发生了 Unicode 错误。请确保所有包含非 ASCII 字符的配置项是 Unicode 字符串。�指定重新构建的文件列表。如果指定了 -a 参数，则忽略此项�没有找到适合 %s 构建器的图像：%s�没有找到适合 %s 构建器的图像：%s (%s)�所的函数，类，术语�所有的 %d po 文件�所有源文件�当指定了 --full 选项，把 module_path 附加到 sys.path�组装单一文档�属性�作者名称�autodoc：无法判断是否生成 %r 的文档。出现了下列异常： %s�自动插入模块中的 Docstring�自动测试 doctest 块中的测试代码片段�autosummary 内部生成 .rst 文件，但是 source_suffix 中不包含 .rst，已跳过。�autosummary 引用了排除的文档 %r。已忽略。�autosummary：无法判断是否生成 %r 的文档。出现了下列异常： %s�autosummary：无法找到根文件 %r。检查你的 autosummary_generate 设置。�autosummary_generate：无法找到文件 %s�给出了表格列和 ：width：选项。：宽度：被忽略。�损坏的链接：%s(%s)�构建 %s，%s 警告（将警告视为错误）。�构建 %s, %s 警告。�构建 %s，%s 警告（将警告视为错误）。�构建 %s，%s 警告。�构建 %s.�构建环境版本与当前环境不符�如果可能，用 N 个进程并行构建文档（如果指定为“auto”，则 N 为 CPU 数量）�构建信息文件损坏：%r�构建器（默认：html）�构建 [%s]： �构建 [mo]： �內置函数�可能会很多�-a 选项和文件名不能同时使用�无法复制可下载文件 %r：%s�无法复制额外文件 %r�无法复制图像文件 %r：%s�无法复制静态文件 %r�无法找到文件 %r�无法打开警告信息文件 %r：%s�配置项 %r 覆盖值类型不支持，已忽略�不能覆盖字典配置项 %r，已忽略 (请用 %r 设置单个字典元素)�无法读取图像文件 %r：直接复制�无法写入图像文件 %r：%s�在图示之外发现了图示标题。�检查一致性�检查文档覆盖率�在文档树中检测到循环引用，已忽略：%s <- %s�类�类方法�命令行选项�概念�基于配置值控制是否在构建中包含文档内容�对于 EPUB3 格式，配置项“epub_author”不能为空�对于 EPUB3 格式，配置项“epub_contributor”不能为空�对于 EPUB3 格式，配置项“epub_copyright”（或“copyright”）不能为空�对于 EPUB3 格式，配置项“epub_description”不能为空�对于 EPUB3 格式，配置项“epub_identifier”不能为空�对于 EPUB3 格式，配置项“epub_language”（或“language”）不能为空�对于 EPUB3 格式，配置项“epub_publisher”不能为空�对于 EPUB3 格式，配置项“epub_title”（或“html_title”）不能为空�对于 EPUB3 格式，配置项“epub_uid”应为 XML 名称�对于 EPUB3 格式，配置项“version”不能为空�配置有变化�配置目录中缺少 conf.py 文件 (%s)�控制台输出选项�续上页�下页继续�格式转换命令 %r 不能执行。请检查 image_converter 设置�转换退出时出错: [stderr] %r [stdout] %r�复制 TeX 支持文件�复制 TeX 支持文件……�复制 Texinfo 支持文件�复制其他文件�复制可下载文件... �正在复制额外文件�复制图像... �复制源文件……�创建变更记录时无法读取 %r�创建 .nojekyll 文件，用于在 GitHub Pages 服务发布文档�创建批处理文件�创建 Makefile�自定义模板目录（默认：%(default)s）�数据�默认角色 %s 未找到�默认的文件名后缀（默认：%(default)s）�定义一个模板变量�定义标签，用于把涉及此 TAG 的“only”块的内容包含进来�无效的量纲单位 %s，已忽略。�指令�指令 %r 已注册，将被覆盖�指令-选项�输出的目录�输出目录�显示 LaTeX %r：%s�着色输出（默认：自动检测）�不创建批处理文件�不创建 Makefile�不着色输出（默认：自动检测）�不使用用于 Makefile/make.bat 的 Make 模式�写入文档：%s�文档�文档导入的成员（默认：%(default)s）�文档没有加入到任何目录树中�项目语种�无法读取文档，已忽略。�文档标题不是一个单纯文本节点�执行顺序 %s�域 %s 已注册�域 %s 尚未注册�不创建目录文件�不创建模块/包的标题（比如当 Docstring 中已经有标题时，可以使用这个选项）�无法判断导入哪个模块来自动生成文档 %r（尝试在文档中使用“module”或“currentmodule”指令，或者显式给定模块名）�不使用已保存的环境，始终读取全部文件�完成�点 代码 %r: %s�无法运行 Dot 命令 %r (Graphviz 输出所需)，请检查 graphviz_dot 配置�dot没有生成输出文件: [stderr] %r [stdout] %r�点退出错误: [stderr] %r [stdout] %r�无法读取下载文件：%s�正在导出对象清单�正在导出 %s 的搜索索引�对%s重复的描述 %s，其它的%s出现在 %s�对 %s的重复描述%s，其它实例出现在 %s�重复的引文 %s，已有引文出现在 %s�重复的引文 %s%s，已有引文出现在 %s�重复的标签 %s，已有标签出现在 %s�重复的公式标签 %s，另一实例出现在 %s�重复的对象描述%s ，另一实例出现在使用 noindex 中：对它们其中的一个 %s�找到重复的ToC条目: %s�启用 %s 扩展�启用多个扩展�遇到了一些库存问题，但他们有其他工作方式：�在节、话题、表格、警示或边栏以外的位置发现标题节点�枚举�可数节点 %r 已注册�枚举子�环境变量�环境变量; %s�格式化 %s 参数时报错：%s�写入文件 %s 时发生错误：%s�错误写入文件 Makefile： %s�例外�only 指令表达式求值时抛出异常：%s�扩展 %r 未包含setup() 函数；它确实是一个 Sphinx 扩展模块吗？�扩展 %r 在其 setup() 函数中返回了一个不支持的对象；该函数应返回 None 或一个元数据字典�扩展选项�扩展有变化�失败�无法导入对象 %s�无法解析名称 %s�访问对象清单时报错：�失败：%s�网站图标 文件 %r 不存在�命令行给出的 %r 文件不存在，将被忽略�源文件目录下没有命令行给出的 %r 文件，将被忽略�主题路径指定的文件 %r 是一个无效的或不包含主题的 zip 文件�文件后缀（默认：rst）�目录文件名 (默认: 模块)�完成但存在问题�排除的文件/目录，fnmatch 风格的规则�遵循符号链接。配合 collective.recipe.omelette 使用尤其奏效。�函数�通用选项�用 sphinx-quickstart 生成完整项目�正在生成索引�看起来形式不对的词汇建议检查缩进�术语�词汇必须在空行之前�词汇必须用空行分隔�语法记号�graphviz_output_format 必须是 'png' 或 'svg' 中之一，现为 %r�突出显示模块代码... �html_extra_path 指向的 %r 不存在�html_extra_path 入口 %r 置于输出目录内�html_static_path 指向的 %r 不存在�html_static_path 入口 %r 置于输出目录内�如果指定了此选项，将使用独立的源文件目录和构建目录�y已忽略无效的文档代码：%r�无法读取图像文件 %s：%s�无法读取图像文件：%s�包含“_private”模块�支持链接到文档涉及的 Python 对象的源码�支持数学公式，渲染成 PNG 或 SVG 图像�支持数学公式，用 MathJax 在浏览器中渲染�译文中的引文引用与原文不一致。原始为：{0}，翻译后为：{1}�译文中的脚注引用与原文不一致。原始为：{0}，翻译后为：{1}�译文中的引用与原文不一致。原始为：{0}，翻译后为：{1}�译文中的术语引用与原文不一致。原始为：{0}，翻译后为：{1}�输出更详细的日志（甚至可能重复）�索引�内联 LaTeX %r：%s�根据 PEP-0420 隐式命名空间规范解释模块路径�跨 Sphinx 标识 %r 不是字符串，已忽略�intersphinx库存已被移动: %s -> %s�无效的 TestCode 类型�无效的 css_file：%r，已忽略�无效的 js_file：%r，已忽略�无效的数值 %r 用于配置项 %r，已忽略�无效的 numfig_format：%s�无效的 numfig_format：%s (%r)�无效的正则表达式 %r 在 %s�coverage_c_regexes 中有无效的正则表达式 %r�无效的 auto%s 签名（%r）�工作编号应为正值�关键字�add_node() 的关键字参数必须是 (visit, depart) 形式的函数元组：%r=%r�最后更新于�指定的行号超出范围（1-%d）：%r�链接不同项目的 Sphinx 文档�列出所有的章节和部分�从中加载intersphinx库存 %s...�加载 pickled环境�正在加载翻译 [%s]... �logo文件 %r 不存在�查找当前已过期的文件... �宏�创建输出目录�主文档名�在目录树中显示的子模块最大深度（默认：4）�成员�方法�'%s' 选项中缺少 '+' 或 '-'。�属性 %s 不存在，在对象 %s 上�模块�无法导入模块 %s：%s�模块�找到了多个目标 'any' 交叉引用的目标不唯一 %r: 可能是 %s�交叉引用 %r 找到了多个目标：%s�新配置�下一页�下一章�挑刺模式，在引用失败时报警�未找到“latex_documents”配置项，不会写入文档�未找到“man_pages”配置项，不会写入手册页�未找到“texinfo_documents”配置项，不会写入文档�没有语种 %r 的 Babel 选项�%s 版本中没有做出修改。�块 %s 没有代码或没有输出，出现在 %s:%s�无任何输出，报警也不会输出�不输出到 stdout，只在 stderr 上输出报警�没有过期的目标文件。�主题 %r 未找到 (缺少 theme.conf？)�未找到主题 %r，则从 %r 继承�节点类 %r 已注册，其访问者将被覆盖�没有找到�没有内置信息的翻译�numfig 已禁用，忽略 :numref:。�未定义 %s 的 numfig_format�对象�运算符�原始记录�覆盖配置文件中的配置项�覆盖已有文件�页�页面 %s 匹配了 html_sidebars 中的两条规则：%r 和 %r�向 HTML 模板传值�缓存环境和 doctree 文件路径（默认：OUTPUTDIR/.doctrees）�文档源文件的路径�要生成文档的模块路径�输出目录的路径�配置文件（conf.py）所在目录路径（默认：与 SOURCEDIR 相同）�pickling环境�准备文件�上一页�上一章�未找到 primary_domain %r，已忽略。�处理 %s�程序选项�项目作者，指定了 --full 选项时使用�项目名称�项目名称（默认：根模块名）�项目发行版本，指定了 --full 选项时使用，默认与 --doc-version 等同�项目根目录�项目版本，指定了 --full 选项时使用�模块有各自的文档页�模块文档先于子模块文档�快速查看所有的模块�静默模式�reST 标记错误：�读取时发生错误：%s，%s�阅读源... �读取模板... �引用标签�项目发行版本�用点替代下划线，“ _templates”。�解析引用……�角色�角色 %r 已注册，将被覆盖�发生异常时运行 Pdb�运行脚本，但不创建文件�搜索�无法加载搜索索引，不会构建所有文档：索引将不完整。�搜索文档�见 %s�参见 %s�目录树存在自引用，已忽略。�配置项 %s.%s 在所有已找到主题配置中均未出现�发生异常时显示完整回溯信息�automodule %s 给定了函数签名参数或返回类型标注�跳过�源文件目录已变化�源文件后缀�用于生成 rST 文件的源文件�%r 的 source_parser 已注册�源文件扩展名 %r 已注册�sphinx-quickstart 只会在空目录中生成文件。请指定一个新的根路径。�sphinx-quickstart 不会覆盖已有的 Sphinx 项目。�sphinx-quickstart 不会覆盖已有的文件。�语句�静态方法�成功�%d 个 po 文件的目标文件已过期�指定了 %d 个 po 文件的目标文件�%d 个源文件的目标文件已过期�%d 个模板文件的目标文件�放置模板文件的模板目录�扩展 %s 没有声明是否并行读取安全，默认假定为否 - 请联系扩展作者检查是否支持该特性并显式声明�%s 扩展没有声明是否并行写入安全，默认假定为否 - 请联系扩展作者检查是否支持该特性并显式声明�扩展 %s 不是并行读取安全的�扩展 %s 不是并行写入安全的�这份文档是�扩展 %r 已合并至 Sphinx (自版本 %s 开始)；该扩展被忽略。�链接没有标题：%s�主题 %r 未包含 "inherit" 配置�主题 %r 未包含 "theme" 配置�目录树引用的文件 %r 不存在�目录树引用的文档 %r 缺少标题：不会生成链接�toctree已包含对排除文档的引用 %r�目录树引用的文档 %r 不存在�过大的 :mathdepth:，已忽略。�把警告视为错误�类型�源码中存在编码无法识别的字符，已经替换为“?”：%r�未实现的节点类型：%r�联合体�未知的 %r toplevel_sectioning，用于 %r 类�覆盖中包含未知配置项 %r ，已忽略�未知的索引条目类型 %r�发现未知的索引条目类型 %s�%s 的 MIME 类型未知，将被忽略�未知节点类型：%r�不支持的主题选项 %r�更新环境: �启用 ePub 支持�使用用于 Makefile/make.bat 的 Make 模式�只用 -D 选项时，不会采用任何配置文件�变量�项目版本�等待工作线程……�此处的“builder”是支持的构建器名，比如 html、latex 或 linkcheck。�同时设置扩展名 %s:�与 -W 配合使用，在警告时继续运行�编写在构建时可以选择显示、隐藏的“todo”条目�写入所有文件（默认：只写入新文件和修改过的文件）�把警告（包含错误）信息写入给定的文件�写作�正在写入 %s 文件……�写入其他文件�正在写入附加页面�写入时发生错误：%s，%s�写入消息目录... �写入输出... �写入摘要文件...����������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_CN/LC_MESSAGES/sphinx.po����������������������������������������������0000644�0000766�0000024�00000323267�00000000000�021557� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Yinian Chin <yinian1992@live.com>, 2015,2017-2018 # Hsiaoming Yang <me@lepture.com>, 2018 # Izabel Wang <izabelwang@pku.edu.cn>, 2020 # Izabel Wang <izabelwang@pku.edu.cn>, 2020 # Jian Dai <daijian1@qq.com>, 2020 # Nomaka <nomakacyx@gmail.com>, 2018 # Lenville Leo <lenville@gmail.com>, 2013 # Lenville Leo <lenville@gmail.com>, 2013 # Nomaka <nomakacyx@gmail.com>, 2018 # Ryekee Zhong <ryekee@gmail.com>, 2013 # Komiya Takeshi <i.tkomiya@gmail.com>, 2019,2021 # Tower Joo<zhutao.iscas@gmail.com>, 2009 # wendi cao <651645601@qq.com>, 2020 # Yinian Chin <yinian1992@live.com>, 2013,2018,2020 # Yinian Chin <yinian1992@live.com>, 2013 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Chinese (China) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_CN/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: zh_CN\n" "Plural-Forms: nplurals=1; plural=0;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "无法找到源码目录 (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "源文件目录和目标目录不能是同一目录" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "正在运行 Sphinx v%s" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "该项目需要 Sphinx v%s 及以上版本，使用现有版本不能构建文档。" #: sphinx/application.py:243 msgid "making output directory" msgstr "创建输出目录" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "同时设置扩展名 %s:" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "当前 conf.py 中定义的 'setup' 不是一个可调用的 Python 对象。请把其定义改为一个可调用的函数。Sphinx 扩展的 conf.py 必须这样配置。" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "正在加载翻译 [%s]... " #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "完成" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "没有内置信息的翻译" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "加载 pickled环境" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "失败：%s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "未选择构建程序，默认使用：html" #: sphinx/application.py:348 msgid "succeeded" msgstr "成功" #: sphinx/application.py:349 msgid "finished with problems" msgstr "完成但存在问题" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "构建 %s，%s 警告（将警告视为错误）。" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "构建 %s，%s 警告（将警告视为错误）。" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "构建 %s, %s 警告。" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "构建 %s，%s 警告。" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "构建 %s." #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "节点类 %r 已注册，其访问者将被覆盖" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "指令 %r 已注册，将被覆盖" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "角色 %r 已注册，将被覆盖" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "扩展 %s 没有声明是否并行读取安全，默认假定为否 - 请联系扩展作者检查是否支持该特性并显式声明" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "扩展 %s 不是并行读取安全的" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "%s 扩展没有声明是否并行写入安全，默认假定为否 - 请联系扩展作者检查是否支持该特性并显式声明" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "扩展 %s 不是并行写入安全的" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "执行顺序 %s" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "配置目录中缺少 conf.py 文件 (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "不能覆盖字典配置项 %r，已忽略 (请用 %r 设置单个字典元素)" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "无效的数值 %r 用于配置项 %r，已忽略" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "配置项 %r 覆盖值类型不支持，已忽略" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "覆盖中包含未知配置项 %r ，已忽略" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "不存在的配置项：%s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "配置项 %r 已存在" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "配置文件中存在语法错误: %s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "配置文件（或配置文件导入的模块）调用了 sys.exit()" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "配置文件中有程序上的错误：\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "配置值\"source_后缀\"需要字符串、字符串列表或字典。但给出\"%r\"。" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "节 %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "图 %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "表 %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "列表 %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "配置项 `{name}` 必须设置为 {candidates} 之一，但现在是 `{current}` 。" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "配置值\"[name]\"的类型为\"[当前._name];但\"当前\"为\"当前\"。\"当前\"为\"当前\"。\"当前\"为\"当前\"。=================================预期 [允许]。" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "配置项 `{name}' 的类型是 `{current.__name__}'，默认为 `{default.__name__}'。" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "未找到 primary_domain %r，已忽略。" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "事件 %r 已存在" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "未知事件名称：%s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "未能加载 needs_extensions 配置项所需的 %s。" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "该项目所需扩展 %s 最低要求版本 %s ，当前加载版本 (%s) 无法构建文档。" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "未知的 Pygments 词法分析器 %r" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "无法按照“%s”语言的词法解析代码块，跳过语法高亮。" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "无法读取文档，已忽略。" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "构建程序类 %s 未包含 \"name\" 属性" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "构建程序 %r 已存在 (见模块 %s)" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "构建程序 %s 未注册或在入口点不可用" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "构建程序 %s 未注册" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "域 %s 已注册" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "域 %s 尚未注册" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "%r 指令已注册到域 %s" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "%r 角色已注册到域 %s" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "%r 索引已注册到域 %s" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "对象类型 %r 已注册" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "交叉引用类型 %r 已注册" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "源文件扩展名 %r 已注册" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "%r 的 source_parser 已注册" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "未注册 %s 的源代码语法分析器" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "翻译已存在 %r" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "add_node() 的关键字参数必须是 (visit, depart) 形式的函数元组：%r=%r" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "可数节点 %r 已注册" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "扩展 %r 已合并至 Sphinx (自版本 %s 开始)；该扩展被忽略。" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "原始异常：\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "无法导入扩展 %s" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "扩展 %r 未包含setup() 函数；它确实是一个 Sphinx 扩展模块吗？" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "该项目所用扩展 %s 需要 Sphinx 版本 %s 以上；当前版本无法构建文档。" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "扩展 %r 在其 setup() 函数中返回了一个不支持的对象；该函数应返回 None 或一个元数据字典" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python 提高建议; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "主题 %r 未包含 \"theme\" 配置" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "主题 %r 未包含 \"inherit\" 配置" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "未找到主题 %r，则从 %r 继承" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "配置项 %s.%s 在所有已找到主题配置中均未出现" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "不支持的主题选项 %r" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "主题路径指定的文件 %r 是一个无效的或不包含主题的 zip 文件" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "主题 %r 未找到 (缺少 theme.conf？)" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "没有找到适合 %s 构建器的图像：%s (%s)" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "没有找到适合 %s 构建器的图像：%s" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "构建 [mo]： " #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "写入输出... " #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "所有的 %d po 文件" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "指定了 %d 个 po 文件的目标文件" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "%d 个 po 文件的目标文件已过期" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "所有源文件" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "源文件目录下没有命令行给出的 %r 文件，将被忽略" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "命令行给出的 %r 文件不存在，将被忽略" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "命令行给出了 %d 个源文件" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "%d 个源文件的目标文件已过期" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "构建 [%s]： " #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "查找当前已过期的文件... " #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "找到 %d 个" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "没有找到" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "pickling环境" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "检查一致性" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "没有过期的目标文件。" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "更新环境: " #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "已添加 %s，%s 已更改，%s 已移除" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "阅读源... " #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "等待工作线程……" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "写入文档：%s" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "准备文件" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "找到重复的ToC条目: %s" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "复制图像... " #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "无法读取图像文件 %r：直接复制" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "无法复制图像文件 %r：%s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "无法写入图像文件 %r：%s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "未找到Pillow - 复制图像文件" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "%s 的 MIME 类型未知，将被忽略" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "正在写入 %s 文件……" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "概览文件保存在 %(outdir)s 目录 。" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "%s 版本中没有做出修改。" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "写入摘要文件..." #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "内置" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "模块级别" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "复制源文件……" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "创建变更记录时无法读取 %r" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "伪构建器不生成文件。" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "ePub文件保存在 %(outdir)s。" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "对于 EPUB3 格式，配置项“epub_language”（或“language”）不能为空" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "对于 EPUB3 格式，配置项“epub_uid”应为 XML 名称" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "对于 EPUB3 格式，配置项“epub_title”（或“html_title”）不能为空" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "对于 EPUB3 格式，配置项“epub_author”不能为空" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "对于 EPUB3 格式，配置项“epub_contributor”不能为空" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "对于 EPUB3 格式，配置项“epub_description”不能为空" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "对于 EPUB3 格式，配置项“epub_publisher”不能为空" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "对于 EPUB3 格式，配置项“epub_copyright”（或“copyright”）不能为空" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "对于 EPUB3 格式，配置项“epub_identifier”不能为空" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "对于 EPUB3 格式，配置项“version”不能为空" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "无效的 css_file：%r，已忽略" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "消息目录保存在 %(outdir)s 目录。" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "%d 个模板文件的目标文件" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "读取模板... " #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "写入消息目录... " #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "在上述输出或 %(outdir)s/output.txt 中检查错误" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "损坏的链接：%s(%s)" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "锚点“%s”未找到" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "手册页保存在 %(outdir)s 目录。" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "未找到“man_pages”配置项，不会写入手册页" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "写作" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "\"man_pages\"配置值引用未知文档 %s" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "HTML 页面保存在 %(outdir)s 目录。" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "组装单一文档" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "写入其他文件" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "Texinfo 文件保存在 %(outdir)s 目录。" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "\n在该目录下运行“make”命令以通过 makeinfo 运行这些 Texinfo文件\n（在此处用“make info”即可自动执行）。" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "未找到“texinfo_documents”配置项，不会写入文档" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "配置项“texinfo_documents”引用了未知文档 %s" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "处理 %s" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "解析引用……" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (在 " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "复制 Texinfo 支持文件" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "错误写入文件 Makefile： %s" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "文本文件保存在 %(outdir)s 目录。" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "写入文件 %s 时发生错误：%s" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "XML 文件保存在 %(outdir)s 目录。" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "伪 XML 文件保存在 %(outdir)s。" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "构建信息文件损坏：%r" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "HTML 页面保存在 %(outdir)s 目录。" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "读取构建信息文件失败：%r" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%Y 年 %m 月 %d 日" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "总目录" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "索引" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "下一页" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "上一页" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "正在生成索引" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "正在写入附加页面" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "复制可下载文件... " #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "无法复制可下载文件 %r：%s" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "无法复制静态文件 %r" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "正在复制额外文件" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "无法复制额外文件 %r" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "写入构建信息文件失败：%r" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "无法加载搜索索引，不会构建所有文档：索引将不完整。" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "页面 %s 匹配了 html_sidebars 中的两条规则：%r 和 %r" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "渲染页面 %s 时发生了 Unicode 错误。请确保所有包含非 ASCII 字符的配置项是 Unicode 字符串。" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "渲染页面 %s 时发生了错误。\n原因：%r" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "正在导出对象清单" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "正在导出 %s 的搜索索引" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "无效的 js_file：%r，已忽略" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "注册了多个 math_renderers。但没有选择任何 math_renderer。" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "给定了未知的 math_renderer %r。" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "html_extra_path 指向的 %r 不存在" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "html_extra_path 入口 %r 置于输出目录内" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "html_static_path 指向的 %r 不存在" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "html_static_path 入口 %r 置于输出目录内" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "logo文件 %r 不存在" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "网站图标 文件 %r 不存在" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s 文档" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "LaTex 文件保存在 %(outdir)s 目录。" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "\n在该目录下运行“make”以通过 (pdf)latex 运行这些 LaTex 文件\n（在此处用“make latexpdf”即可自动执行）。" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "未找到“latex_documents”配置项，不会写入文档" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "配置项“latex_documents”引用了未知文档 %s" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "索引" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "发布" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "没有语种 %r 的 Babel 选项" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "复制 TeX 支持文件" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "复制 TeX 支持文件……" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "复制其他文件" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "未知配置项：latex_elements[%r]，已忽略。" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "%r 未包含 \"theme\" 配置" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "%r 未包含 \"%s\" 配置" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "构建时抛出异常，启动调试器：" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "已中断！" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "reST 标记错误：" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "编码错误：" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "如果你想向开发者报告问题，可以查阅已经保存在 %s 的完整 Traceback 信息 。" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "递归错误：" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "抛出异常：" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "如果此处抛出了用户的错误，也请向我们报告，这样以后可以显示更友好、更详细的错误信息。" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "请向 Bug 追踪系统 <https://github.com/sphinx-doc/sphinx/issues> 投递 Bug 报告。谢谢！" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "工作编号应为正值" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "文档源文件的路径" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "输出目录的路径" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "指定重新构建的文件列表。如果指定了 -a 参数，则忽略此项" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "通用选项" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "构建器（默认：html）" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "写入所有文件（默认：只写入新文件和修改过的文件）" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "不使用已保存的环境，始终读取全部文件" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "缓存环境和 doctree 文件路径（默认：OUTPUTDIR/.doctrees）" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "如果可能，用 N 个进程并行构建文档（如果指定为“auto”，则 N 为 CPU 数量）" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "配置文件（conf.py）所在目录路径（默认：与 SOURCEDIR 相同）" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "只用 -D 选项时，不会采用任何配置文件" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "覆盖配置文件中的配置项" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "向 HTML 模板传值" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "定义标签，用于把涉及此 TAG 的“only”块的内容包含进来" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "挑刺模式，在引用失败时报警" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "控制台输出选项" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "输出更详细的日志（甚至可能重复）" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "不输出到 stdout，只在 stderr 上输出报警" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "无任何输出，报警也不会输出" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "着色输出（默认：自动检测）" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "不着色输出（默认：自动检测）" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "把警告（包含错误）信息写入给定的文件" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "把警告视为错误" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "与 -W 配合使用，在警告时继续运行" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "发生异常时显示完整回溯信息" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "发生异常时运行 Pdb" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "无法找到文件 %r" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "-a 选项和文件名不能同时使用" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "无法打开警告信息文件 %r：%s" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "-D 选项的参数必须是 name=value 形式" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "-A 选项的参数必须是 name=value 形式" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "自动插入模块中的 Docstring" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "自动测试 doctest 块中的测试代码片段" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "链接不同项目的 Sphinx 文档" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "编写在构建时可以选择显示、隐藏的“todo”条目" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "检查文档覆盖率" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "支持数学公式，渲染成 PNG 或 SVG 图像" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "支持数学公式，用 MathJax 在浏览器中渲染" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "基于配置值控制是否在构建中包含文档内容" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "支持链接到文档涉及的 Python 对象的源码" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "创建 .nojekyll 文件，用于在 GitHub Pages 服务发布文档" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "请输入有效的路径名。" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "请输入文本。" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "请输入 %s 之一。" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "请输入“y”或“n”。" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "请输入文件后缀，例如：“.rst”或者“.txt”。" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "欢迎使用 Sphinx %s 快速配置工具。" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "请输入接下来各项设置的值（如果方括号中指定了默认值，直接\n按回车即可使用默认值）。" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "已选择根路径：%s" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "输入文档的根路径。" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "文档的根路径" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "错误：选择的根路径中已存在 conf.py 文件。" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "sphinx-quickstart 不会覆盖已有的 Sphinx 项目。" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "请输入新的根路径（或按回车退出）" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "有两种方式来设置 Sphinx 输出的创建目录：\n一是在根路径下创建“_build”目录，二是在根路径下创建“source”\n和“build”两个独立的目录。" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "独立的源文件和构建目录（y/n）" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "这个选项将在根目录中创建两个文件夹：“_templates”用于自定义 HTML 模板文件，“_static”用于自定义样式表及其他静态文件。您可以输入其它的前缀（比如“.”）代替下划线。" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "模板目录名和静态目录名的前缀" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "项目名称将会出现在文档的许多地方。" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "项目名称" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "作者名称" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "项目版本" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "项目发行版本" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "如果用英语以外的语言编写文档，\n你可以在此按语言代码选择语种。\nSphinx 会把内置文本翻译成相应语言的版本。\n\n支持的语言代码列表见：\nhttp://sphinx-doc.org/config.html#confval-language。" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "项目语种" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "源文件后缀" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "这其中有一种特殊的文档被视作“目录树”的树顶节点，即文档层级\n结构的根。通常情况下，这个文档是“index”，但是如果你的“index”文\n档使用了自定义模板，你也可以使用其它文件名。" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "主文档文件名（不含后缀）" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "错误：选择的根目录下已存在主文档文件 %s。" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "sphinx-quickstart 不会覆盖已有的文件。" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "请输入新文件名，若要重命名现有文件请按回车" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "启用 Sphinx 扩展：" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "注意：imgmath 和 mathjax 不能同时启用。已取消选择 imgmath。" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "生成 Makefile 和 Windows 批处理文件，可以直接像“make html”这样\n运行，而不需要直接调用 sphinx-build。" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "创建 Makefile？（y/n）" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "创建 Windows 批处理文件？（y/n）" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "创建文件 %s。" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "文件 %s 已存在，跳过。" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "完成：已创建初始目录结构。" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "你现在可以填写主文档文件 %s 并创建其他文档源文件了。 " #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "用 Makefile 构建文档，例如：\n make builder" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "用 sphinx-build 命令构建文档，像这样：\n sphinx-build -b builder %s %s" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "此处的“builder”是支持的构建器名，比如 html、latex 或 linkcheck。" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "\n生成 Sphinx 项目的必需文件。\n\nsphinx-quickstart 是一个交互式工具，询问一些关于项目的问题，生成\n完整的文档目录和用于 sphinx-build 的示例 Makefile。\n" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "静默模式" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "项目根目录" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "文档结构参数" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "如果指定了此选项，将使用独立的源文件目录和构建目录" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "用点替代下划线，“ _templates”。" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "项目基本参数" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "项目名称" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "作者名称" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "项目版本" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "项目发行版本" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "项目语种" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "源文件后缀" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "主文档名" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "启用 ePub 支持" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "扩展程序选项" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "启用 %s 扩展" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "启用多个扩展" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "创建 Makefile 和批处理文件" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "创建 Makefile" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "不创建 Makefile" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "创建批处理文件" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "不创建批处理文件" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "使用用于 Makefile/make.bat 的 Make 模式" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "不使用用于 Makefile/make.bat 的 Make 模式" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "项目模板" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "放置模板文件的模板目录" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "定义一个模板变量" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "指定了“quiet”，但是没有指定“project”和“author”。" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "错误：指定的路径不是一个目录，或是 Sphinx 文件已存在。" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "sphinx-quickstart 只会在空目录中生成文件。请指定一个新的根路径。" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "无效模板变量：%s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "无效的标题：%s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "指定的行号超出范围（1-%d）：%r" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "\"%s\" 和 \"%s\" 选项不能同时使用" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "包含的文件 %r 不存在或读取失败" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "用于读取包含文件 %r 的编码 %r 不正确，请重新给定 encoding: 选项" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "对象 %r 在包含文件 %r 中不存在" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "不能在互斥的 \"lines\" 集合上使用 \"lineno-match\" 选项" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "行规范 %r：未能从包含文件 %r 中拉取行" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "节作者： " #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "模块作者： " #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "代码作者： " #: sphinx/directives/other.py:181 msgid "Author: " msgstr "作者： " #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "参数" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "返回" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "返回类型" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "成员" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "变量" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "函数" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "宏" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "联合体" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "枚举" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "枚举子" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "类型" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "%s 新版功能" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "在 %s 版更改" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "%s 版后已移除" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "重复的引文 %s，已有引文出现在 %s" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "引文 [%s] 没有被引用过。" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "模板参数" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "抛出" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "类" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "概念" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (內置函数)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s 方法)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (类)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (全局变量或常量)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s 属性)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "参数" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (模块)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "方法" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "数据" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "属性" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "模块" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "对%s重复的描述 %s，其它的%s出现在 %s" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "重复的公式标签 %s，另一实例出现在 %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "无效的 math_eqref_format：%r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "关键字" #: sphinx/domains/python.py:60 msgid "operator" msgstr "运算符" #: sphinx/domains/python.py:61 msgid "object" msgstr "对象" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "例外" #: sphinx/domains/python.py:63 msgid "statement" msgstr "语句" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "內置函数" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "变量" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "引发" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (在 %s 模块中)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s() (在 %s 模块中)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (內置变量)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (內置类)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (%s 中的类)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s 类方法)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s 静态方法)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Python 模块索引" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "模块" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "已移除" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "类方法" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "静态方法" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "重复的对象描述%s ，另一实例出现在使用 noindex 中：对它们其中的一个 %s" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "交叉引用 %r 找到了多个目标：%s" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr " (已移除)" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s (指令)" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "%s (指令选项)" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s (角色)" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "指令" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "指令-选项" #: sphinx/domains/rst.py:210 msgid "role" msgstr "角色" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "重复的引文 %s%s，已有引文出现在 %s" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "环境变量; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "畸形的选项描述 %r，应是“opt”、“-opt args”、“--opt args”、“/opt args”或“+opt args”形式" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "%s命令行选项" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "命令行选项" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "词汇必须在空行之前" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "词汇必须用空行分隔" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "看起来形式不对的词汇建议检查缩进" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "术语" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "语法记号" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "引用标签" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "环境变量" #: sphinx/domains/std.py:568 msgid "program option" msgstr "程序选项" #: sphinx/domains/std.py:569 msgid "document" msgstr "文档" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "模块索引" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "搜索页面" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "重复的标签 %s，已有标签出现在 %s" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "对 %s的重复描述%s，其它实例出现在 %s" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "numfig 已禁用，忽略 :numref:。" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "链接没有标题：%s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "无效的 numfig_format：%s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "无效的 numfig_format：%s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "新配置" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "配置有变化" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "扩展有变化" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "构建环境版本与当前环境不符" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "源文件目录已变化" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "本环境与选择的构建器不兼容，请选择其他的文档树目录。" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "在 %s 中扫描文档失败：%r" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "没有注册 %r 域" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "目录树存在自引用，已忽略。" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "文档没有加入到任何目录树中" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "见 %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "参见 %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "未知的索引条目类型 %r" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "符号" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "在文档树中检测到循环引用，已忽略：%s <- %s" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "目录树引用的文档 %r 缺少标题：不会生成链接" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "toctree已包含对排除文档的引用 %r" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "目录树引用的文档 %r 不存在" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "无法读取图像文件：%s" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "无法读取图像文件 %s：%s" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "无法读取下载文件：%s" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "已经给 %s 分配了章节编号（嵌套的带编号文档树？）" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "将会创建文件 %s。" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "\n在 <MODULE_PATH> 中递归查找 Python 模块和包，然后在 <OUTPUT_PATH> 中为每个使用了\nautomodule 指令的包创建一个 reST 文件。\n\n<EXCLUDE_PATTERN> 可以排除生成符合规则的文件/目录的文档。\n\n提示：本脚本默认不会覆盖已有文件。" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "要生成文档的模块路径" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "排除的文件/目录，fnmatch 风格的规则" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "输出的目录" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "在目录树中显示的子模块最大深度（默认：4）" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "覆盖已有文件" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "遵循符号链接。配合 collective.recipe.omelette 使用尤其奏效。" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "运行脚本，但不创建文件" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "模块有各自的文档页" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "包含“_private”模块" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "目录文件名 (默认: 模块)" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "不创建目录文件" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "不创建模块/包的标题（比如当 Docstring 中已经有标题时，可以使用这个选项）" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "模块文档先于子模块文档" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "根据 PEP-0420 隐式命名空间规范解释模块路径" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "文件后缀（默认：rst）" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "用 sphinx-quickstart 生成完整项目" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "当指定了 --full 选项，把 module_path 附加到 sys.path" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "项目名称（默认：根模块名）" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "项目作者，指定了 --full 选项时使用" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "项目版本，指定了 --full 选项时使用" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "项目发行版本，指定了 --full 选项时使用，默认与 --doc-version 等同" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "扩展选项" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "%s 不是一个目录。" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "无效的正则表达式 %r 在 %s" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "已完成源文件的覆盖率测试，请在 %(outdir)s/python.txt 中查看结果。" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "coverage_c_regexes 中有无效的正则表达式 %r" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "无法导入模块 %s：%s" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "'%s' 选项中缺少 '+' 或 '-'。" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "'%s' 不是一个有效选项。" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "'%s' 不是一个有效的 pyversion 选项" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "无效的 TestCode 类型" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "已完成源文件的文档测试，请在 %(outdir)s/output.txt 中查看结果。" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "块 %s 没有代码或没有输出，出现在 %s:%s" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "y已忽略无效的文档代码：%r" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "====================== 最长阅读时长 =======================" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "Graphviz 指令不能同时指定内容和文件名参数" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "外部 Graphviz 文件 %r 不存在或读取失败" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "已忽略无内容的 \"graphviz 指令。" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "dot没有生成输出文件:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "无法运行 Dot 命令 %r (Graphviz 输出所需)，请检查 graphviz_dot 配置" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "点退出错误:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "graphviz_output_format 必须是 'png' 或 'svg' 中之一，现为 %r" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "点 代码 %r: %s" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[图表：%s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[图表]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "转换退出时出错:\n[stderr]\n%r\n[stdout]\n%r" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "格式转换命令 %r 不能执行。请检查 image_converter 设置" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "无法运行 LaTeX 命令 %r （数学公式显示必需），请检查 imgmath_latex 设置" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "无法运行 %s 命令 %r （数学公式显示必需），请检查 imgmath_%s 设置" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "显示 LaTeX %r：%s" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "内联 LaTeX %r：%s" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "公式的永久链接" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "intersphinx库存已被移动: %s -> %s" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "从中加载intersphinx库存 %s..." #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "遇到了一些库存问题，但他们有其他工作方式：" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "访问对象清单时报错：" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(在 %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "(在 %s)" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "跨 Sphinx 标识 %r 不是字符串，已忽略" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "无法读取intersphinx_mapping[%s]，忽略：%r" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[源代码]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "待处理" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "已发现 TODO 条目：%s" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<original entry>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(<<original entry>> 见 %s，第 %d 行。)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "原始记录" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "突出显示模块代码... " #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[文档]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "模块代码" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>%s 源代码</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "概览：模块代码" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>代码可用的所有模块</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "无效的 auto%s 签名（%r）" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "格式化 %s 参数时报错：%s" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "属性 %s 不存在，在对象 %s 上" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "autodoc：无法判断是否生成 %r 的文档。出现了下列异常：\n%s" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "无法判断导入哪个模块来自动生成文档 %r（尝试在文档中使用“module”或“currentmodule”指令，或者显式给定模块名）" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "automodule 名中的“::”无意义" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "automodule %s 给定了函数签名参数或返回类型标注" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "__all__ 应是一个字符串列表，而不是 %r （出现在模块 %s 中） -- 已忽略__all__" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "基类：%s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "autosummary 引用了排除的文档 %r。已忽略。" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary：无法找到根文件 %r。检查你的 autosummary_generate 设置。" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "无法解析名称 %s" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "无法导入对象 %s" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate：无法找到文件 %s" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "autosummary 内部生成 .rst 文件，但是 source_suffix 中不包含 .rst，已跳过。" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "autosummary：无法判断是否生成 %r 的文档。出现了下列异常：\n%s" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[autosummary] 生成 autosummary：%s" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "[autosummary] 写入 %s" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "[autosummary] failed to import %r：%s" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "\n用 autosummary 指令生成 ReStructuredText\n\nsphinx-autogen 是 sphinx.ext.autosummary.generate 的前端，它根据给定\n的输入文件中的 autosummary 指令生成 reStructuredText  文件\n\nautosummary 指令的格式见 Python 模块 ``sphinx.ext.autosummary`` 的文\n档，并且可以这样调出文档阅读::\n\n pydoc sphinx.ext.autosummary\n" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "用于生成 rST 文件的源文件" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "输出目录" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "默认的文件名后缀（默认：%(default)s）" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "自定义模板目录（默认：%(default)s）" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "文档导入的成员（默认：%(default)s）" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "关键字参数" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "示例" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "实际案例" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "提示" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "其他参数" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "引用" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "警告" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "生成器" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "注意" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "小心" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "危险" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "错误" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "提示" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "重要" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "注解" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "参见" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "小技巧" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "警告" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "续上页" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "下页继续" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "非字母" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "数值" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "页" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "目录" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "搜索" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "转向" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "显示源代码" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "概述" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "欢迎！这是" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "这份文档是" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "最后更新于" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "索引和表格：" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "完整的内容表" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "列出所有的章节和部分" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "搜索文档" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "全局模块索引" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "快速查看所有的模块" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "所的函数，类，术语" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "索引 – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "一页的全部索引" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "按照字母的索引页" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "可能会很多" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "导航" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "在 %(docstitle)s 中搜索" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "关于这些文档" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "版权所有" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\"> 版权所有</a> %(copyright)s." #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© 版权所有 %(copyright)s." #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "最后更新于 %(last_updated)s." #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "搜索 %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "上一个主题" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "上一章" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "下一个主题" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "下一章" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "请激活 JavaScript 以开启搜索功能。" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "搜寻包含多个字的词汇时，\n 只有所含所有内容都匹配时才会出现。" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "搜索" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "搜索结果" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "没有任何文档匹配您的搜索。请确保你输入的词拼写正确并选择了合适的分类。" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "快速搜索" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "本页" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "更改发生在版本 %(version)s— %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "自动生成的 %(version)s 版本中的更改列表" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "库更改" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API 更改" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "其他更改" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "永久链接至标题" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "永久链接至目标" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "隐藏搜索结果" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "搜索中" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "准备搜索……" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "搜索完成，有 %s 个页面匹配。" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "， 在 " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "展开边栏" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "折叠边栏" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "目录" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "发现使用了 4 列布局的索引页。可能是你所用的扩展出现了 Bug：%r" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "脚注 [%s] 没有被引用过。" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "脚注 [#] 没有被引用过。" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "译文中的脚注引用与原文不一致。原始为：{0}，翻译后为：{1}" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "译文中的引用与原文不一致。原始为：{0}，翻译后为：{1}" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "译文中的引文引用与原文不一致。原始为：{0}，翻译后为：{1}" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "译文中的术语引用与原文不一致。原始为：{0}，翻译后为：{1}" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "找到了多个目标 'any' 交叉引用的目标不唯一 %r: 可能是 %s" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "无法获取远程图像：%s [%d]" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "无法获取远程图像：%s [%s]" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "未知的图像格式：%s……" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "源码中存在编码无法识别的字符，已经替换为“?”：%r" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "跳过" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "失败" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "读取时发生错误：%s，%s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "写入时发生错误：%s，%s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "无效的日期格式。如果你想直接输出日期字符串，请用单引号：%s" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "目录树引用的文件 %r 不存在" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "only 指令表达式求值时抛出异常：%s" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "默认角色 %s 未找到" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "未定义 %s 的 numfig_format" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "没有给 %s 节点分配 ID" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "永久链接至表格" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "永久链接至代码" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "永久链接至图片" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "永久链接至目录树" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "无法获取图像尺寸，已忽略 :scale: 选项。" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "未知的 %r toplevel_sectioning，用于 %r 类" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "过大的 :mathdepth:，已忽略。" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "文档标题不是一个单纯文本节点" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "在节、话题、表格、警示或边栏以外的位置发现标题节点" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "脚注" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "给出了表格列和 ：width：选项。：宽度：被忽略。" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "无效的量纲单位 %s，已忽略。" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "发现未知的索引条目类型 %s" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[图片： %s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[图片]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "在图示之外发现了图示标题。" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "未实现的节点类型：%r" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "未知节点类型：%r" �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.333502 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_HK/�������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016106� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5170221 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_HK/LC_MESSAGES/�������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017673� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.js����������������������������������������������0000644�0000766�0000024�00000004604�00000000000�021546� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "zh_Hant_HK", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "0" });����������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.mo����������������������������������������������0000644�0000766�0000024�00000000776�00000000000�021553� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$���������������,�����-����Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: zh_HK Language-Team: Chinese (Hong Kong) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_HK/) Plural-Forms: nplurals=1; plural=0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 ���././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_HK/LC_MESSAGES/sphinx.po����������������������������������������������0000644�0000766�0000024�00000241441�00000000000�021552� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Chinese (Hong Kong) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_HK/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: zh_HK\n" "Plural-Forms: nplurals=1; plural=0;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "" #: sphinx/domains/python.py:1176 msgid "property" msgstr "" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.333883 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_TW/�������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016136� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5187128 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_TW/LC_MESSAGES/�������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017723� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.js����������������������������������������������0000644�0000766�0000024�00000011303�00000000000�021570� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "zh_Hant_TW", "messages": { "%(filename)s — %(docstitle)s": "%(filename)s — %(docstitle)s", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "© <a href=\"%(path)s\">\u7248\u6b0a\u6240\u6709</a> %(copyright)s\u3002", "© Copyright %(copyright)s.": "© \u7248\u6b0a\u6240\u6709 %(copyright)s\u3002", ", in ": "\uff0c\u65bc ", "About these documents": "\u95dc\u65bc\u9019\u4e9b\u6587\u4ef6", "Automatically generated list of changes in version %(version)s": "\u81ea\u52d5\u7522\u751f\u7684 %(version)s \u7248\u672c\u8b8a\u66f4\u5217\u8868", "C API changes": "C API \u7684\u8b8a\u66f4", "Changes in Version %(version)s — %(docstitle)s": "\u65bc %(version)s \u7248\u672c\u4e2d\u7684\u6240\u6709\u8b8a\u66f4 — %(docstitle)s", "Collapse sidebar": "\u6536\u5408\u5074\u908a\u6b04", "Complete Table of Contents": "\u5b8c\u6574\u76ee\u9304", "Contents": "\u5167\u5bb9", "Copyright": "\u7248\u6b0a\u6240\u6709", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "\u4f7f\u7528 <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s \u5efa\u7acb\u3002", "Expand sidebar": "\u5c55\u958b\u5074\u908a\u6b04", "Full index on one page": "\u55ae\u9801\u5b8c\u6574\u7d22\u5f15", "General Index": "\u7e3d\u7d22\u5f15", "Global Module Index": "\u5168\u57df\u6a21\u7d44\u7d22\u5f15", "Go": "\u524d\u5f80", "Hide Search Matches": "\u96b1\u85cf\u7b26\u5408\u641c\u5c0b", "Index": "\u7d22\u5f15", "Index – %(key)s": "\u7d22\u5f15 – %(key)s", "Index pages by letter": "\u6309\u5b57\u6bcd\u7d22\u5f15\u9801\u9762", "Indices and tables:": "\u7d22\u5f15\u8207\u8868\u683c\uff1a", "Last updated on %(last_updated)s.": "\u6700\u5f8c\u66f4\u65b0\u65bc %(last_updated)s\u3002", "Library changes": "\u7a0b\u5f0f\u5eab\u7684\u8b8a\u66f4", "Navigation": "\u700f\u89bd", "Next topic": "\u4e0b\u500b\u4e3b\u984c", "Other changes": "\u5176\u4ed6\u8b8a\u66f4", "Overview": "\u6982\u8981", "Permalink to this definition": "\u672c\u5b9a\u7fa9\u7684\u6c38\u4e45\u9023\u7d50", "Permalink to this headline": "\u672c\u6a19\u984c\u7684\u6c38\u4e45\u9023\u7d50", "Please activate JavaScript to enable the search\n functionality.": "\u8acb\u555f\u7528 Javascript \u4ee5\u958b\u555f\u641c\u5c0b\u529f\u80fd\u3002", "Preparing search...": "\u6e96\u5099\u641c\u5c0b\u4e2d\u2026", "Previous topic": "\u4e0a\u500b\u4e3b\u984c", "Quick search": "\u5feb\u901f\u641c\u5c0b", "Search": "\u641c\u5c0b", "Search Page": "\u641c\u5c0b\u9801\u9762", "Search Results": "\u641c\u5c0b\u7d50\u679c", "Search finished, found %s page(s) matching the search query.": "\u641c\u5c0b\u5b8c\u6210\uff0c\u5171\u627e\u5230 %s \u9801\u9762\u7b26\u5408\u641c\u5c0b\u689d\u4ef6\u3002", "Search within %(docstitle)s": "\u5728 %(docstitle)s \u4e2d\u641c\u5c0b", "Searching": "\u641c\u5c0b\u4e2d", "Searching for multiple words only shows matches that contain\n all words.": "\u641c\u5c0b\u591a\u500b\u95dc\u9375\u5b57\u6642\uff0c\u53ea\u6703\u986f\u793a\u5305\u542b\u6240\u6709\u95dc\u9375\u5b57\u7684\u7d50\u679c\u3002", "Show Source": "\u986f\u793a\u539f\u59cb\u78bc", "Table of Contents": "\u76ee\u9304", "This Page": "\u672c\u9801", "Welcome! This is": "\u6b61\u8fce\uff01\u672c", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "\u60a8\u7684\u641c\u5c0b\u627e\u4e0d\u5230\u4efb\u4f55\u6eff\u8db3\u689d\u4ef6\u7684\u6587\u4ef6\u3002\u8acb\u78ba\u5b9a\u662f\u5426\u6240\u6709\u7684\u641c\u5c0b\u8a5e\u90fd\u6b63\u78ba\u5730\u62fc\u5beb\u4e14\u60a8\u5df2\u9078\u64c7\u8db3\u5920\u7684\u5206\u985e\u3002", "all functions, classes, terms": "\u6240\u6709\u51fd\u5f0f\u3001\u985e\u5225\u3001\u8853\u8a9e", "can be huge": "\u53ef\u80fd\u6703\u5f88\u5927", "last updated": "\u6700\u5f8c\u66f4\u65b0\u65bc", "lists all sections and subsections": "\u5217\u51fa\u6240\u6709\u7ae0\u7bc0\u8207\u5c0f\u7bc0", "next chapter": "\u4e0b\u4e00\u7ae0", "previous chapter": "\u4e0a\u4e00\u7ae0", "quick access to all modules": "\u8fc5\u901f\u627e\u5230\u6240\u6709\u6a21\u7d44", "search": "\u641c\u5c0b", "search this documentation": "\u641c\u5c0b\u9019\u4efd\u8aaa\u660e\u6587\u4ef6", "the documentation for": "\u8aaa\u660e\u6587\u4ef6\u4ecb\u7d39" }, "plural_expr": "0" });�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.mo����������������������������������������������0000644�0000766�0000024�00000122276�00000000000�021603� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������L����M�� ��� ����� ��*��� �����!��H���!��"���!�� ���"�����"��%���!"��!���G"�����i"�����o"�����"�����"�� ���"�� ���"�����"�����"�����"�����"�� ���#�����(#�� ���:#�� ���F#�� ���P#�����q#�����#�����#�����#�����#�� ���#�����#��$���$��6���'$�����^$�����~$��3���8%�� ���l%�����x%��G���~%�����%�����%��0���%�����"&��;���>&�����z&�����&�� ���&�� ���&�� ���&�����&��>���&�� ���-'��(���7'��(���`'�����'��?���'�����'�� ���'��!���'�����!(�����)(��4���?(�� ���t(�� ���(�����(�����(�����(�����(�� ���(��N���)��%���Q)��%���w)�����)��:���)��7���)��R���.*�����*�� ���*�����*�����*��N���*��R���+�����m+�����s+�����+�����+�����+�����+��D���+��B���,��0���F,��-���w,��+���,��3���,��'���-��3���--��"���a-��:���-�����-�����-�� ���-�� ���.�����.�����.�� ���.�����.�����.��*���.�����/�����./�� ���3/�����=/�����C/�����Y/�����o/��'���/�����/��[���/�����0�����90�����W0��!���i0�����0�� ���0�����0��n���0�� ���51�����B1�� ���R1�� ���^1�� ���k1�����v1�� ���1��(���1�����1�����1�����1�����1�����1�����1�����2�� ���2��(���-2�����V2�����_2�� ���u2�����2�����2�����2�����2�����2�����3�����3�����13��&���K3��B���r3�����3�����3�����3�����3��#���4��$���%4�����J4�� ���^4�����k4�����r4�� ���{4�����4�� ���4�� ���4�����4�����4�����4�����4�� ���4�����4��<���4�����75�� ���S5��K���]5�� ���5�����5�����5�� ���5��k���5��>���F6��#���6�����6�����6�����6�����6�����6�����6��*���7��3���27��/���f7��(���7��.���7��P���7��p���?8��e���8��Z���9��N���q9��T���9��K���:��%���a:�����:��#���:��=���:��7��� ;�� ���A;��d���K;��W���;��v���<�����<�����<�����<�� ���<�����<�����<�� ���<�����<�����<�����<����� =�����=��%���=��,���=�����=����� >�� ���>����� >�� ���(>�����4>�����<>��N���E>��-���>��2���>�� ���>�����?�����?�����4?�����G?�� ���X?�� ���b?��d���o?��b���?��5���7@��\���m@�� ���@��M���@��(���9A��G���bA��7���A�����A��8���A�����1B�� ���HB��%���RB�����xB�����B�����B�� ���B�����B��A���B��Z���C��-���qC�����C�����C�����C�����C�� ���C�����D�����D��6���D��;���VD��I���D��;���D��:���E��H���SE��9���E��G���E��2���F��2���QF�����F��4���F�����F�����F�����F�����G��(���'G�����PG�����aG��0���qG�����G�����G��/���G�����G��&��� H�� ���3H��9���=H�����wH�� ���H�����H�����H��*���H�����I�����I��0���"I��&���SI�����zI�����I��(���I�����I�����I�����J�����J��.���$J��4���SJ��+���J��4���J��(���J��4���K��W���GK�����K�����K�����K��J���K�����9L��%���>L�� ���dL�����oL�����L��+���L�� ���L��8���L��M��� M��u���ZM�����M�����M�����M�����N�� ���N��6���(N��I���_N��A���N�����N�����O����� O�����O��4���1O�� ���fO��,���tO��3���O�� ���O�����O��/����P��,���0P��V���]P��V���P��M��� Q��R���YQ�����Q��0���Q�����Q�����R��/���R�����NR�����hR��+���R��)���R��-���R��-��� S�����9S��E���AS�� ���S��"���S�����S�����S�����S��"���T�����2T�����8T��4���PT��4���T�����T��&���T�����T�����T��H���U�����MU�����TU��D���\U��5���U��D���U�� ���V�����'V�� ���,V�����9V�����SV��-���oV��(���V��D���V�� ��� W��#���W��(���:W��#���cW�����W�����W�����W�����W�����W�����W�����W�����W��%���W�� ���X�����"X�� ���1X�� ���>X�����KX�����TX�� ���pX�����{X�����X�����X�����X��&���X�����X�����Y��4��� Y�����AY�����HY�����bY�� ���iY��'���uY��:���Y��@���Y�����Z�����!Z�����>Z��&���QZ��*���xZ��&���Z��K���Z�� ���[�� ��� [�����.[�� ���5[��,���?[��*���l[��0���[��%���[�����[�����\�����\��1���1]��1���c]�����]��\���]�����^��'���$^��%���L^��+���r^�����^�����^��5���^�����^����� _�����(_��+���._��-���Z_��%���_�����_��!���_��!���_�����`��!���$`�����F`�����]`��#���f`�����`�����`�����`�����`��;���`�����a����� a��&���3a�����Za�����va�����a�����a�����a�����a�����a����b��{��c�����Ie�����Ye��,���`e�����e��J���f��"���`f�����f�� ���f��%���f�����f�����f�����f�����g�����g�� ���'g�� ���1g�����=g�����Og�����ag�����vg�����g�����g�� ���g�����g��,���g������h�����h�����-h�����Ah�����[h�� ���oh�����}h��!���h��;���h��$���h�����i��)���i�� ���j�����)j��Z���1j�����j�����j��'���j�����j��F���j��&���?k�����fk��&���yk�����k�����k�� ���k��.���k�����k��'���k��%���!l�����Gl��:���cl�����l�����l�����l�����l�����l��>���l�����-m�����Im�����Ym�� ���im�����vm�����m�� ���m��?���m��#���m��#���n�����,n��B���Hn��6���n��T���n�����o�� ���o�����(o�����Bo��I���Yo��M���o�����o�����o�����p�����p�����p�����-p��?���@p��?���p��/���p��(���p��*���q��+���Dq��&���pq��3���q��"���q��1���q����� r�����'r�����Br�����^r�����er�����s�� ���s�����#s�����6s��4���=s�����rs�����s�����s�����s�����s�����s�����s��/���s����� t��]���t�����zt�����t�����t��#���t�����t�� ���t�� ���u��o���(u�� ���u�����u�����u�� ���u�����u�����u�� ���u��*���u�����(v�����@v�����Sv�����Zv�����av�����hv�� ���|v�� ���v��*���v�����v�����v�����v�����v�����w�����w�����6w�����Ow�����hw�����w�����w��(���w��-���w����� x�� ���x�����*x�����=x��(���Px��$���yx�����x�� ���x�����x�����x�����x�����x�� ���x�� ���x�����x�����x�����y�����y�� ���4y�� ���Ay��7���Ny�����y�� ���y��H���y�� ���y�����y�� ���z�����z��v���)z��0���z��%���z�� ���z�����{����� {�� ���${�����.{�� ���5{�����B{�����]{�����}{�����{�����{��R���{��m���)|��e���|��W���|��K���U}��X���}��F���}��'���A~�� ���i~��!���~��4���~��0���~�������T�����K���n��j��������%�� ���,�����6��"���;�����^�����y����������������� ���������������#���I��0���m������������ ���Ł�����Ё�� ���ց������� �����a�����/���[��4����� ��������͂��������������������)�� ���0��_���:��h�����4�����D���8�����}��T�����+�����K�����3���h�������3���������� �����$��������4�����I�� ���X�����e�����u��<�����U���φ��5���%�����[�����x������������ �������������ˇ��1���҇��5�����E���:��6�����4�����C�����3���0��B���d��1�����,���ى�������0��������G�����W�����g�����}��'�������������Ҋ��1���������������1���5�����g��+����������.����� �����!�������������(��-���>�����l�������.�����#����� ���ߌ��!�����'��������6�����F�����Z�����t��,���{��(�����$���э��-�����$���$��'���I��Z���q��#���̎������������K���#�����o�����t�� ����� ����������1����������6�����T���*��v������������� ����������+�� ���B��1���N��@�����F��������������� ���"�����/��0���B�� ���s��'�����*����� ���Ӓ��#�����@�����=���E��G�����M���˓��G�����M���a�������2�����!�����!��� ��.���-�����\�� ���x��.�����,���ȕ��-�����-���#�� ���Q��Q���[������������ ���ٖ������������'���-�����U�����\��0���u��0��������ח������� ����������B��������[�����b��I���i��1�����>����� ���$�� ���1�� ���;�����E�����_��6���x��,�����;���ܙ����������.��)���J�� ���t������� ����� ������������������̚�� ���ߚ�� �����*���������� ���.�� ���;�� ���H�����R�����Y�� ���r������������ ����� �����*���ƛ������������,��������;�����B�� ���[�� ���e��,���r��9�����/���ٜ�� ��� ����������,��#���<��%���`�������K����� ����� ������������� ��#�����#���6��!���Z��$���|�� �����x�����x���'��0�����0���џ�������T��������j��!����������1���ˠ�� ����������2���%�����X�����q�������0�����'���ǡ��'����������'���6��(���^�������%��������ɢ�� ���ߢ��'���������� ��������'��"���@��B���c�� ����������-���ʣ��"�������������2�� ���R�����s������������� Generate ReStructuredText using autosummary directives. sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates the reStructuredText files from the autosummary directives contained in the given input files. The format of the autosummary directive is documented in the ``sphinx.ext.autosummary`` Python module and can be read using:: pydoc sphinx.ext.autosummary � (deprecated)� (in �"::" in automodule name doesn't make sense�":file:" option for csv-table directive now recognizes an absolute path as a relative path from source directory. Please update your document.�"quiet" is specified, but any of "project" or "author" is not specified.�%(filename)s — %(docstitle)s�%b %d, %Y�%d found�%d source files given on command line�%r reference target not found: %s�%s %s�%s %s documentation�%s (%s attribute)�%s (%s property)�%s (C %s)�%s (C++ %s)�%s (built-in class)�%s (built-in variable)�%s (class in %s)�%s (directive)�%s (global variable or constant)�%s (in module %s)�%s (module)�%s (role)�%s added, %s changed, %s removed�%s command line option�%s() (%s class method)�%s() (%s method)�%s() (%s static method)�%s() (built-in function)�%s() (class)�%s() (in module %s)�%s:%s reference target not found: %s�© <a href="%(path)s">Copyright</a> %(copyright)s.�© Copyright %(copyright)s.�'setup' as currently defined in conf.py isn't a Python callable. Please modify its definition to make it a callable function. This is needed for conf.py to behave as a Sphinx extension.�(The <<original entry>> is located in %s, line %d.)�(in %s v%s)�, in �4 column based index found. It might be a bug of extensions you use: %r�:%s: (directive option)�<<original entry>>�<h1>All modules for which code is available</h1>�<h1>Source code for %s</h1>�A captioned autosummary requires :toctree: option. ignored.�A mocked object is detected: %r�About these documents�Any IDs not assigned for %s node�Arguments�Attention�Author: �Automatically generated list of changes in version %(version)s�Bases: %s�Builder %r already exists (in module %s)�Builder class %s has no "name" attribute�Builder name %s not registered�Builder name %s not registered or available through entry point�Builtins�C API changes�Cannot find source directory (%s)�Caution�Changed in version %s�Changes in Version %(version)s — %(docstitle)s�Citation [%s] is not referenced.�Code author: �Collapse sidebar�Complete Table of Contents�Config value %r already present�Contents�Copyright�Could not determine the fallback text for the cross-reference. Might be a bug.�Could not fetch remote image: %s [%d]�Could not fetch remote image: %s [%s]�Could not import extension %s�Could not lex literal_block as "%s". Highlighting skipped.�Could not obtain image size. :scale: option is ignored.�Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> %(sphinx_version)s.�Danger�Deprecated�Deprecated since version %s�Domain %r is not registered�Duplicate C declaration, also defined at %s:%s. Declaration is '.. c:%s:: %s'.�Duplicate C++ declaration, also defined at %s:%s. Declaration is '.. cpp:%s:: %s'.�Error�Event %r already present�Example�Examples�Expand sidebar�Extension options�Failed to create a cross reference. A title or caption not found: %s�Failed to create a cross reference. Any number is not assigned: %s�Failed to get a constructor signature for %s: %s�Failed to get a function signature for %s: %s�Failed to get a method signature for %s: %s�Failed to parse a default argument value for %r: %s�Failed to parse type_comment for %r: %s�Failed to read intersphinx_mapping[%s], ignored: %r�Failed to scan documents in %s: %r�Failed to update signature for %r: parameter not found: %s�Fig. %s�Footnote [#] is not referenced.�Footnote [%s] is not referenced.�Footnotes�For security reasons, parallel mode is disabled on macOS and python3.8 and above. For more details, please read https://github.com/sphinx-doc/sphinx/issues/6803�Full index on one page�General Index�Global Module Index�Go�Handler %r for event %r threw an exception�Hide Search Matches�Hint�Important�Index�Index – %(key)s�Index pages by letter�Indices and tables:�Invalid __slots__ found on %s. Ignored.�Invalid caption: %s�Invalid date format. Quote the string by single quote if you want to output it directly: %s�Invalid math_eqref_format: %r�Invalid template variable: %s�Keyword Arguments�Last updated on %(last_updated)s.�Library changes�Listing %s�Makefile and Batchfile creation�Malformed option description %r, should look like "opt", "-opt args", "--opt args", "/opt args" or "+opt args"�Module Index�Module author: �Module code�Module level�Navigation�New in version %s�Next topic�No builder selected, using default: html�No such config value: %s�Non-alphabetical�Note�Notes�Numbers�Original exception: �Other Parameters�Other changes�Output directory (%s) is not a directory�Overview�Overview: module code�Parameters�Permalink to this code�Permalink to this definition�Permalink to this equation�Permalink to this headline�Permalink to this image�Permalink to this table�Permalink to this term�Permalink to this toctree�Pillow not found - copying image files�Please activate JavaScript to enable the search functionality.�Preparing search...�Previous topic�Project basic options�Project templating�Pygments lexer name %r is not known�Python Enhancement Proposals; PEP %s�Python Module Index�Quick search�Raises�Receives�References�Release�Return type�Return values�Returns�Running Sphinx v%s�Search�Search %(docstitle)s�Search Page�Search Results�Search finished, found %s page(s) matching the search query.�Search within %(docstitle)s�Searching�Searching for multiple words only shows matches that contain all words.�Section %s�Section author: �See also�Show Source�Since v2.0, Sphinx uses "index" as root_doc by default. Please add "root_doc = 'contents'" to your conf.py.�Source directory and destination directory cannot be identical�Source parser for %s not registered�Structure options�Symbols�TODO entry found: %s�Table %s�Table of Contents�Template Parameters�The %r crossref_type is already registered�The %r directive is already registered to domain %s�The %r index is already registered to domain %s�The %r object_type is already registered�The %r role is already registered to domain %s�The %s extension is required by needs_extensions settings, but it is not loaded.�The %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.�The config value `source_suffix' expects a string, list of strings, or dictionary. But `%r' is given.�The config value `{name}' has type `{current.__name__}', defaults to `{default.__name__}'.�The config value `{name}' has type `{current.__name__}'; expected {permitted}.�The config value `{name}` has to be a one of {candidates}, but `{current}` is given.�The configuration file (or one of the modules it imports) called sys.exit()�The dummy builder generates no files.�The ePub file is in %(outdir)s.�The overview file is in %(outdir)s.�There is a programmable error in your configuration file: %s�There is a syntax error in your configuration file: %s �This Page�This environment is incompatible with the selected builder, please choose another doctree directory.�This project needs at least Sphinx v%s and therefore cannot be built with this version.�This project needs the extension %s at least in version %s and therefore cannot be built with the loaded version (%s).�Throws�Tip�Todo�Translator for %r already exists�Unknown event name: %s�Unknown image format: %s...�Variables�Warning�Warns�Welcome! This is�Yields�Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.�[autosummary] failed to import %r: %s�[autosummary] generating autosummary for: %s�[autosummary] writing to %s�[docs]�[graph: %s]�[graph]�[image: %s]�[image]�[source]�__all__ should be a list of strings, not %r (in module %s) -- ignoring __all__�a suitable image for %s builder not found: %s�a suitable image for %s builder not found: %s (%s)�alias of %s�alias of TypeVar(%s)�all functions, classes, terms�all of %d po files�all source files�attribute�author names�autodoc_member_order now accepts "alphabetical" instead of "alphabetic". Please update your setting.�autosummary generats .rst files internally. But your source_suffix does not contain .rst. Skipped.�autosummary references excluded document %r. Ignored.�autosummary: failed to determine %r to be documented, the following exception was raised: %s�autosummary: failed to import %s�autosummary: stub file not found %r. Check your autosummary_generate setting.�autosummary_generate: file not found: %s�both tabularcolumns and :widths: option are given. :widths: is ignored.�build %s, %s warning (with warnings treated as errors).�build %s, %s warning.�build %s, %s warnings (with warnings treated as errors).�build %s, %s warnings.�build %s.�build environment version not current�building [%s]: �building [mo]: �built-in function�can be huge�cannot copy image file %r: %s�cannot override config setting %r with unsupported type, ignoring�cannot override dictionary config setting %r, ignoring (use %r to set individual elements)�cannot read image file %r: copying it instead�cannot write image file %r: %s�caption not inside a figure.�checking consistency�class�class method�command line option�concept�conf value "epub_author" should not be empty for EPUB3�conf value "epub_contributor" should not be empty for EPUB3�conf value "epub_copyright" (or "copyright")should not be empty for EPUB3�conf value "epub_description" should not be empty for EPUB3�conf value "epub_identifier" should not be empty for EPUB3�conf value "epub_language" (or "language") should not be empty for EPUB3�conf value "epub_publisher" should not be empty for EPUB3�conf value "epub_title" (or "html_title") should not be empty for EPUB3�conf value "epub_uid" should be XML NAME for EPUB3�conf value "version" should not be empty for EPUB3�config changed�config directory doesn't contain a conf.py file (%s)�continued from previous page�continues on next page�copying images... �copying source files...�could not read %r for changelog creation�create batchfile�create makefile�custom template directory (default: %(default)s)�data�default role %s not found�default suffix for files (default: %(default)s)�define a template variable�dimension unit %s is invalid. Ignored.�directive�directive %r is already registered, it will be overridden�directive-option�directory to place all output in�do not create batchfile�do not create makefile�do not use make-mode for Makefile/make.bat�docnames to write: %s�document�document imported members (default: %(default)s)�document isn't included in any toctree�document language�document not readable. Ignored.�document title is not a single Text node�doing serial %s�domain %s already registered�domain %s not yet registered�done�duplicate %s description of %s, other %s in %s�duplicate %s description of %s, other instance in %s�duplicate citation %s, other instance in %s�duplicate description of %s %s, other instance in %s�duplicate label %s, other instance in %s�duplicate label of equation %s, other instance in %s�duplicate object description of %s, other instance in %s, use :noindex: for one of them�duplicated ToC entry found: %s�enable %s extension�enable arbitrary extensions�encountered title node not in section, topic, table, admonition or sidebar�enum�enumerable_node %r already registered�enumerator�environment variable�environment variable; %s�error while formatting signature for %s: %s�exception�exception while evaluating only directive expression: %s�extension %r has no setup() function; is it really a Sphinx extension module?�extension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary�extensions changed�failed�failed to import object %s�failed to parse name %s�failed: %s�file %r given on command line does not exist, ignoring�file %r given on command line is not under the source directory, ignoring�file %r on theme path is not a valid zipfile or contains no theme�finished with problems�function�function parameter�generating indices�glossary seems to be misformatted, check indentation�glossary term�glossary term must be preceded by empty line�glossary terms must not be separated by empty lines�grammar token�highlighting module code... �if specified, create build dir under source dir�if specified, separate source and build dirs�inconsistent citation references in translated message. original: {0}, translated: {1}�inconsistent footnote references in translated message. original: {0}, translated: {1}�inconsistent references in translated message. original: {0}, translated: {1}�inconsistent term references in translated message. original: {0}, translated: {1}�index�intersphinx identifier %r is not string. Ignored�invalid css_file: %r, ignored�invalid js_file: %r, ignored�invalid number %r for config value %r, ignoring�invalid numfig_format: %s�invalid numfig_format: %s (%r)�invalid value for class-doc-from option: %s�invalid value for member-order option: %s�invalid value set (missing closing brace): %s�invalid value set (missing opening brace): %s�keyword�kwargs for add_node() must be a (visit, depart) function tuple: %r=%r�last updated�lists all sections and subsections�loading pickled environment�loading translations [%s]... �locale_dir %s does not exists�looking for now-outdated files... �macro�making output directory�malformed string literal (missing closing quote): %s�malformed string literal (missing opening quote): %s�master document name�math renderer %s is already registered�member�method�missing attribute mentioned in :members: option: module %s, attribute %s�module�modules�more than one target found for 'any' cross-reference %r: could be %s�more than one target found for cross-reference %r: %s�multiple files found for the document "%s": %r Use %r for the build.�new config�next�next chapter�no changes in version %s.�no targets are out of date.�no theme named %r found (missing theme.conf?)�no theme named %r found, inherited by %r�node class %r is already registered, its visitors will be overridden�none found�not available for built-in messages�numfig is disabled. :numref: is ignored.�numfig_format is not defined for %s�object�operator�original entry�page�pickling environment�preparing documents�previous�previous chapter�primary_domain %r not found, ignored.�processing %s�program option�project name�project root�property�quick access to all modules�quiet mode�reading error: %s, %s�reading sources... �reference label�release of project�replacement for dot in _templates etc.�resolving references...�role�role %r is already registered, it will be overridden�search�search this documentation�see %s�see also %s�self referenced toctree found. Ignored.�setting %s.%s occurs in none of the searched theme configs�signature arguments or return annotation given for automodule %s�skipped�source directory has changed�source file suffix�source files to generate rST files for�source_parser for %r is already registered�source_suffix %r is already registered�sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0�statement�static method�struct�succeeded�targets for %d po files that are out of date�targets for %d po files that are specified�targets for %d source files that are out of date�template directory for template files�template parameter�the %s extension does not declare if it is safe for parallel reading, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension does not declare if it is safe for parallel writing, assuming it isn't - please ask the extension author to check and make it explicit�the %s extension is not safe for parallel reading�the %s extension is not safe for parallel writing�the documentation for�the extension %r was already merged with Sphinx since version %s; this extension is ignored.�the link has no caption: %s�theme %r doesn't have "inherit" setting�theme %r doesn't have "theme" setting�toctree contains ref to nonexisting file %r�too large :maxdepth:, ignored.�type�undecodable source characters, replacing with "?": %r�undefined label: %s�unimplemented node type: %r�union�unknown %r toplevel_sectioning for class %r�unknown config value %r in override, ignoring�unknown directive or role name: %s:%s�unknown index entry type %r�unknown index entry type %s found�unknown mimetype for %s, ignoring�unknown node type: %r�unsupported theme option %r given�updating environment: �use epub�use make-mode for Makefile/make.bat�variable�version of project�waiting for workers...�while setting up extension %s:�write all files (default: only write new and changed files)�writing�writing %s file...�writing META-INF/container.xml file...�writing content.opf file...�writing error: %s, %s�writing mimetype file...�writing nav.xhtml file...�writing output... �writing summary file...�writing toc.ncx file...�Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-11-07 00:10+0000 PO-Revision-Date: 2021-11-01 07:44+0000 Last-Translator: Steven Hsu <hsuhaochun@gmail.com> Language: zh_TW Language-Team: Chinese (Taiwan) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_TW/) Plural-Forms: nplurals=1; plural=0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 � 使用 autosummary 指令產生 ReStructuredText。 sphinx-autogen 是 sphinx.ext.autosummary.generate 的一個前端。它會從給定的 輸入檔案中所包含的 autosummary 指令，產生 reStructuredText 檔案。 autosummary 指令的格式被記錄在 ``sphinx.ext.autosummary`` Python 模組中， 它可以使用此方法來讀取:: pydoc sphinx.ext.autosummary �（已棄用）� (於 �"::" 在 automodule 的名稱中並不合理�對 csv-table 指令的 ":file:" 選項現在會將絕對路徑辨識為基於來源資料夾的相對路徑。請更新您的文件。�"quiet" 被指定，但 "project" 或 "author" 的任一項未被指定。�%(filename)s — %(docstitle)s�%Y 年 %m 月 %d 日�已找到 %d�在命令列給了 %d 個原始檔案�%r 參照目標未找到： %s�%s %s�%s %s 說明文件�%s (%s 的屬性)�%s (%s 的特性)�%s (C %s)�%s (C++ %s)�%s (內建類別)�%s (內建變數)�%s (%s 中的類別)�%s （指令）�%s (全域變數或常數)�%s (於 %s 模組中)�%s (模組)�%s （角色）�%s 已新增， %s 已變更， %s 已移除�%s 命令列選項�%s() (%s 的類別方法)�%s() (%s 的方法)�%s() (%s 的靜態方法)�%s() (內建函式)�%s() (類別)�%s() (於 %s 模組中)�%s:%s 參照目標未找到： %s�© <a href="%(path)s">版權所有</a> %(copyright)s。�© 版權所有 %(copyright)s。�目前在 conf.py 裡定義的 'setup' 並非一個 Python 的可呼叫物件。請將其定義修改為一個可呼叫的函式。若要使 conf.py 以 Sphinx 擴充套件的方式運作，這個修改是必須的。�(<<original entry>> 見 %s ，第 %d 行)�(於 %s v%s)�，於 �找到基於 4 欄位的索引。它可能是您使用的擴充套件的一個錯誤： %r�:%s: （指令選項）�<<original entry>>�<h1>所有可得程式碼的模組</h1>�<h1>%s 的原始碼</h1>�一個有標題的 autosummary 需要 :toctree: 選項。已略過。 �一個 mocked 物件被偵測到： %r�關於這些文件�任一個 ID 未被指定給 %s 節點�引數�注意�作者：�自動產生的 %(version)s 版本變更列表�基礎類別：%s�Builder %r 已存在（於 %s 模組）�Builder class %s 沒有 "name" 屬性�Builder 名稱 %s 未註冊�Builder 名稱 %s 未註冊或無法從 entry point 取得�內建�C API 的變更�找不到來源資料夾 (%s)�警示�在 %s 版本變更�於 %(version)s 版本中的所有變更 — %(docstitle)s�引用 [%s] 未被參照。�程式作者：�收合側邊欄�完整目錄�組態值 %r 已經存在�內容�版權所有�無法為交互參照決定備用文字。可能是個錯誤。�無法提取遠端圖片： %s [%d]�無法提取遠端圖片： %s [%s]�無法引入擴充套件 %s�無法將 literal_block 分析為 "%s"。Highlighting 已省略。�無法取得圖片大小。 :scale: 選項已略過。�使用 <a href="https://www.sphinx-doc.org/">Sphinx</a> %(sphinx_version)s 建立。�危險�已棄用�在 %s 版本開始棄用�Domain %r 未被註冊�重複的 C 宣告，亦被定義於 %s:%s。 宣告是 '.. c:%s:: %s'。�重複的 C++ 宣告，亦被定義於 %s:%s。 宣告是 '.. cpp:%s:: %s'。�錯誤�事件 %r 已經存在�範例�範例�展開側邊欄�擴充套件選項�無法建立一個交互參照。未找到標題或題目： %s�無法建立一個交互參照。任一數字未被指定： %s�無法取得一個 constructor 簽名給 %s: %s�無法取得一個函式簽名給 %s: %s�無法取得一個 method 簽名給 %s: %s�無法為 %r 剖析一個預設引數： %s�無法為 %r 剖析 type_comment： %s�無法讀取 intersphinx_mapping[%s], 已略過: %r�無法掃描 %s 中的文件： %r�無法為 %r 更新簽名：未找到參數： %s�圖 %s�註腳 [#] 未被參照。�註腳 [%s] 未被參照。�註腳�基於安全性理由，平行模式在 masOS 及 python3.8 以上版本已被停用。更多細節，請參閱 https://github.com/sphinx-doc/sphinx/issues/6803�單頁完整索引�總索引�全域模組索引�前往�對於事件 %r 的 handler %r 拋出了一個例外�隱藏符合搜尋�提示�重要�索引�索引 – %(key)s�按字母索引頁面�索引與表格：�在 %s 找到無效的 __slots__。已略過。�無效標題：%s�無效的日期格式。如果您要直接將它輸出，則以單引號引用該字串： %s�無效的 math_eqref_format: %r�無效的模板變數： %s�關鍵字引數�最後更新於 %(last_updated)s。�程式庫的變更�列表 %s�Makefile 及 Batchfile 的建立�異常的選項敘述 %r ，應該要看起來像 "opt", "-opt args", "--opt args", "/opt args" 或 "+opt args"�模組索引�模組作者：�模組原始碼�模組層次�瀏覽�在 %s 版本新加入�下個主題�沒有指定 builder，使用預設：html�無此類組態值：%s�非依字母順序�備註�備註�數字�原始的例外： �其他參數�其他變更�輸出資料夾 (%s) 不是一個資料夾�概要�概要：模組原始碼�參數�本原始碼的永久連結�本定義的永久連結�本公式的永久連結�本標題的永久連結�本圖片的永久連結�本表格的永久連結�本術語的永久連結�本目錄的永久連結�未找到 Pillow - 正在複製圖片檔�請啟用 Javascript 以開啟搜尋功能。�準備搜尋中…�上個主題�專案基本選項�專案模板化中�Pygments lexer 名稱 %r 不是已知的�Python Enhancement Proposals; PEP %s�Python 模組索引�快速搜尋�引發�接收�參照�發佈�回傳型別�回傳值�回傳�正在執行 Sphinx v%s 版本�搜尋�搜尋 %(docstitle)s�搜尋頁面�搜尋結果�搜尋完成，共找到 %s 頁面符合搜尋條件。�在 %(docstitle)s 中搜尋�搜尋中�搜尋多個關鍵字時，只會顯示包含所有關鍵字的結果。�章節 %s�章節作者：�也參考�顯示原始碼�從 v2.0 開始，Sphinx 預設使用 "index" 作為 root_doc。請在您的 conf.py 加上 "root_doc = 'contents'"。�來源資料夾與目的資料夾不能為相同�對於 %s 的源碼剖析器未註冊�結構選項�符號�找到 TODO 項目： %s�表格 %s�目錄�模板參數�%r crossref_type 已註冊�%r 指令已註冊給 domain %s�%r 索引已註冊給 domain %s�%r object_type 已註冊�%r 角色已註冊給 domain %s�擴充套件 %s 被 needs_extensions 的設定所要求，但它沒有被載入。�此專案使用的 %s 擴充套件需要 Sphinx v%s 以上的版本；所以它無法以此版本被建立。�組態值 `source_suffix' 預期是一個字串、一組字串，或字典。但是 `%r' 被給予。�組態值 `{name}' 有 `{current.__name__}' 型別；預設為 `{default.__name__}' 。�組態值 `{name}' 有 `{current.__name__}' 型別；預期 {permitted} 。�組態值 `{name}` 必須是 {candidates} 的其中之一，但 `{current}` 被給予。�組態檔（或它 import 的其中一個模組）呼叫了 sys.exit()�虛擬建立器未產生任何檔案。�ePub 檔案是在 %(outdir)s 。�概觀檔案是在 %(outdir)s 。�在您的組態檔中有一個程式化錯誤： %s�在您的組態檔中有一個語法錯誤：%s �本頁�這個環境與所選的 builder 不相容，請選擇另一個 doctree 資料夾。�本專案需要 Sphinx v%s 版本或以上，故無法以現版本編譯。�這個專案需要擴充套件 %s 的最低版本是 %s，所以無法以載入的版本 (%s) 被建立。�拋出�小訣竅�Todo�對於 %r 的翻譯器已經存在�未知的事件名稱：%s�未知的圖片格式： %s...�變數�警告�警告�歡迎！本�產出�您的搜尋找不到任何滿足條件的文件。請確定是否所有的搜尋詞都正確地拼寫且您已選擇足夠的分類。�[autosummary] 無法 import %r: %s �[autosummary] 正在產生 autosummary 給： %s�[autosummary] 正在寫入 %s�[文件]�[圖：%s]�[圖]�[圖片：%s]�[圖片]�[原始碼]�__all__ 應該是一個字串的列表，不是 %r （在 %s 模組中）-- 正在忽略 __all__�未找到對於 %s builder 適用的圖片：%s�未找到對於 %s builder 適用的圖片：%s (%s)�%s 的別名�TypeVar(%s) 的別名�所有函式、類別、術語�所有的 %d po 檔�所有原始檔案�屬性�作者名�autodoc_member_order 現在接受 "alphabetical" 而非 "alphabetic"。請更新您的設定。�autosummary 會在內部產生 .rst 檔案。但是您的 source_suffix 並未包含 .rst。已省略。�autosummary 參照已排除文件 %r 。已略過。�autosummary: 無法決定 %r 被記錄，以下例外被引發： %s�autosummary: 無法 import %s�autosummary: 未找到 stub 檔 %r 。請檢查您的 autosummary_generate 設定。�autosummary_generate: 檔案未找到： %s�同時被給予 tabularcolumns 及 :widths: 選項。 :widths: 已略過。�建立 %s，%s 警告（警告被視為錯誤）。�建立 %s，%s 警告。�建立 %s，%s 警告（警告被視為錯誤）。�建立 %s，%s 警告。�建立 %s。�建立環境的版本不是目前的�正在建立 [%s]：�建立 [mo]：�內建函式�可能會很大�無法複製圖片檔 %r: %s�無法以未支援的型別覆寫組態設定 %r，忽略中�無法覆寫資料夾組態設定 %r，忽略中（使用 %r 來設定個別元素）�無法讀取圖片檔 %r: 正在複製它做為替代�無法寫入圖片檔 %r: %s�標題不在圖之內。�正在檢查一致性�類別�類別方法�命令列選項�概念�conf 值 "epub_author" 在 EPUB3 不應該為空�conf 值 "epub_contributor" 在 EPUB3 不應該為空�conf 值 "epub_copyright" (或 "copyright") 在 EPUB3 不應該為空�conf 值 "epub_description" 在 EPUB3 不應該為空�conf 值 "epub_identifier" 在 EPUB3 不應該為空�conf 值 "epub_language" (或 "language") 在 EPUB3 不應該為空�conf 值 "epub_publisher" 在 EPUB3 不應該為空�conf 值 "epub_title" (或 "html_title") 在 EPUB3 不應該為空�conf 值 "epub_uid" 在 EPUB3 應該是 XML NAME�conf 值 "version" 在 EPUB3 不應該為空�組態已變更�config 資料夾沒有包含 conf.py 檔案 (%s)�繼續上一頁�繼續下一頁�正在複製圖片...�正在複製原始檔案...�在變更日誌建立時無法讀取 %r�建立 batchfile�建立 makefile�自訂模板資料夾（預設： %(default)s ）�資料�預設角色 %s 未找到�檔案的預設後綴（預設： %(default)s ）�定義一個模板變數�維度單位 %s 是無效的。已略過。�指令�指令 %r 已經被註冊，它將會被覆寫�指令選項�資料夾來放置所有輸出在�不要建立 batchfile�不要建立 makefile�不要使用 make 模式於 Makefile/make.bat�待寫入的 docname: %s�文件�文件引入成員（預設： %(default)s ）�文件未被包含於任何 toctree�文件語言�文件無法讀取。已略過。�文件標題不是單一的 Text 節點�執行串列 %s�domain %s 已註冊�domain %s 尚未被註冊�完成�%s 的重複 %s 敘述，其他的 %s 在 %s�重複 %s 的描述 %s，亦出現於 %s�重複的引用 %s，亦出現於 %s�%s %s 的重複敘述，其他的實例在 %s�重複的標籤 %s，亦出現於 %s�重複公式標籤 %s，亦出現於 %s�%s 的重複物件敘述，其他的實例在 %s ，使用 :noindex: 給它們其中之一�找到了重複的 ToC 項目： %s�啟用 %s 擴充套件�啟用任意的擴充套件�遇到的標題節點不是在段落、主題、表格、警告或側邊欄�enum�enumerable_node %r 已註冊�enumerator�環境變數�環境變數; %s�正在為 %s 格式化簽名時發生錯誤： %s�例外�在評估只有指令的運算式時發生例外： %s�擴充套件 %r 沒有 setup() 函式；它真的是 Sphinx 擴充套件模組嗎？�擴充套件 %r 從它的 setup() 函式回傳一個未支援物件；它應該回傳 None 或一個元數據資料夾�擴充套件已變更�失敗�import 物件 %s 失敗�剖析名稱 %s 失敗�失敗：%s�在命令列給的檔案 %r 不存在，忽略中�在命令列給的檔案 %r 不在來源資料夾下，忽略中�主題路徑中的檔案 %r 不是有效的 zipfile 或未包含主題�完成但有問題�函式�函式參數�正在產生索引�術語表似乎有格式錯誤，請檢查縮排�雜項術語�術語表項目必須有空白行在前�術語表項目不可以被空白行分隔�語法單詞�正在 highlight 模組程式碼...�如果有指定，會在來源資料夾下建立 build 資料夾�如果有指定，會分離來源資料夾和 build 資料夾�被翻譯訊息中有不一致的引用。原文： {0}，譯文： {1}�被翻譯訊息中有不一致的註腳參照。原文： {0}，譯文： {1}�被翻譯訊息中有不一致的參照。原文： {0}，譯文： {1}�被翻譯訊息中有不一致的術語參照。原文： {0}，譯文： {1}�索引�intersphinx identifier %r 不是字串。已略過�無效的 css_file: %r, 已略過�無效的 js_file: %r, 已略過�無效的數字 %r 於組態值 %r，忽略中�無效的 numfig_format: %s�無效的 numfig_format: %s (%r)�對於 class-doc-from 選項無效的值： %s�對於 member-order 選項無效的值： %s�無效的值集合（缺少右括號）： %s�無效的值集合（缺少左括號）： %s�關鍵字�對於 add_node() 的 kwargs 必須是一個 (visit, depart) 函式值組：%r=%r�最後更新於�列出所有章節與小節�正在載入已 pickle 的環境�正在載入翻譯 [%s]...�locale_dir %s 不存在�正在尋找目前已過期的檔案...�巨集�正在建立輸出目錄�異常的字串文本（缺少右括號）： %s�異常的字串文本（缺少左括號）： %s�主文件名稱�數學描繪器 %s 已註冊�成員函數�方法�缺少 :members: 選項中所述的屬性：模組 %s ，屬性 %s�模組�模組�為「任一個」交互參照 %r 找到多於一個目標：可能是 %s�為交互參照 %r 找到多於一個目標： %s�為文件 "%s" 找到多個檔案： %r 使用 %r 來建立。�新的組態�下一頁�下一章�在版本 %s 中無變更�沒有過時的目標。�未找到名為 %r 的主題（缺少 theme.conf？）�未找到名為 %r 的主題，被 %r 繼承�node class %r 已經被註冊，它的訪客將會被覆寫�找不到任何結果�不是有效的內建訊息�numfig 已停用。 :numref: 已略過。�numfig_format 未被定義給 %s�物件�運算子�原始記錄�頁�正在 pickle 環境�正在準備文件�上一頁�上一章�找不到 primary_domain %r，已略過。�正在處理 %s�程式選項�專案名稱�專案根�特性�迅速找到所有模組�安靜模式�讀取錯誤： %s, %s�正在讀取來源...�參照標籤�專案發布�在 _templates 等處進行句號的取代�正在解析參照...�角色�role %r 已經被註冊，它將會被覆寫�搜尋�搜尋這份說明文件�參考 %s�也參考 %s�找到自我參照的 toctree。已略過。�設定 %s。%s 不在已被搜尋的主題組態中出現�簽名引數或回傳註釋給予 automodule %s�已省略�來源資料夾已變更�源始檔後綴�原始檔案以產生 rST 檔案給�對於 %r 的 source_parser 已註冊�source_suffix %r 已註冊�找到 sphinx_rtd_theme (< 0.3.0)。從 Sphinx-6.0 之後將無法使用。�陳述式�靜態方法�結構�成功�對於已過期 po 檔 %d 的目標�對於指定的 po 檔 %d 的目標�%d 個過時原始檔案的目標�用於模板檔案的模板資料夾�模板參數�%s 擴充套件並未宣告平行讀取是否安全，假設為否 - 請尋求擴充套件作者以檢查並明確表示�%s 擴充套件並未宣告平行寫入是否安全，假設為否 - 請尋求擴充套件作者以檢查並明確表示�%s 擴充套件對於平行讀取是不安全的�%s 擴充套件對於平行寫入是不安全的�說明文件介紹�擴充套件 %r 已被併入版本 %s 以上的 Sphinx：此擴充套件已略過。�這個連結沒有標題： %s�主題 %r 沒有 "inherit" 設定�主題 %r 沒有 "theme" 設定�toctree 包含了不存在的檔案 %r 的參照 �:maxdepth: 太大，已略過。�型別�無法解碼的原始字元，以 "?" 取代： %r�未定義的標籤： %s�未實作的節點型別： %r�union�未知的 %r toplevel_sectioning 對於 class %r�覆寫未知的組態值 %r，忽略中�未知的指令或角色名稱： %s:%s�未知的索引項目型別 %r�找到了未知的索引條目型別 %s�對於 %s 未知的 mimetype，忽略中�未知的節點型別： %r�未支援的主題選項 %r 被給予�正在更新環境：�使用 epub�使用 make 模式於 Makefile/make.bat�變數�專案版本�正在等待工作者...�正在設置擴充套件 %s 時：�寫入所有檔案（預設：只寫入新增及已變更檔案）�編寫中�正在寫入 %s 檔案...�正在寫入 META-INF/container.xml 檔案...�正在寫入 content.opf 檔案...�寫入錯誤： %s, %s�正在寫入 mimetype 檔案...�正在寫入 nav.xhtml 檔案...�編寫輸出...�正在寫入摘要檔案...�正在寫入 toc.ncx 檔案...�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_TW/LC_MESSAGES/sphinx.po����������������������������������������������0000644�0000766�0000024�00000301671�00000000000�021604� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: # Wey-Han Liaw <adrianliaw2000@gmail.com>, 2018 # Alvin Wong <alvin@alvinhc.com>, 2021 # Fred Lin <gasolin@gmail.com>, 2008 # Game Arming <fleasw@yahoo.com.tw>, 2017 # Hsiaoming Yang <me@lepture.com>, 2018 # Liang-Bo Wang <me@liang2.tw>, 2016 # Liang-Bo Wang <me@liang2.tw>, 2016-2017 # Steven Hsu <hsuhaochun@gmail.com>, 2021 msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-11-07 00:10+0000\n" "PO-Revision-Date: 2021-11-01 07:44+0000\n" "Last-Translator: Steven Hsu <hsuhaochun@gmail.com>\n" "Language-Team: Chinese (Taiwan) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_TW/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: zh_TW\n" "Plural-Forms: nplurals=1; plural=0;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "找不到來源資料夾 (%s)" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "輸出資料夾 (%s) 不是一個資料夾" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "來源資料夾與目的資料夾不能為相同" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "正在執行 Sphinx v%s 版本" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "基於安全性理由，平行模式在 masOS 及 python3.8 以上版本已被停用。更多細節，請參閱 https://github.com/sphinx-doc/sphinx/issues/6803" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "本專案需要 Sphinx v%s 版本或以上，故無法以現版本編譯。" #: sphinx/application.py:243 msgid "making output directory" msgstr "正在建立輸出目錄" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "正在設置擴充套件 %s 時：" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "目前在 conf.py 裡定義的 'setup' 並非一個 Python 的可呼叫物件。請將其定義修改為一個可呼叫的函式。若要使 conf.py 以 Sphinx 擴充套件的方式運作，這個修改是必須的。" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "正在載入翻譯 [%s]..." #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "完成" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "不是有效的內建訊息" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "正在載入已 pickle 的環境" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "失敗：%s" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "沒有指定 builder，使用預設：html" #: sphinx/application.py:348 msgid "succeeded" msgstr "成功" #: sphinx/application.py:349 msgid "finished with problems" msgstr "完成但有問題" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "建立 %s，%s 警告（警告被視為錯誤）。" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "建立 %s，%s 警告（警告被視為錯誤）。" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "建立 %s，%s 警告。" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "建立 %s，%s 警告。" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "建立 %s。" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "node class %r 已經被註冊，它的訪客將會被覆寫" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "指令 %r 已經被註冊，它將會被覆寫" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "role %r 已經被註冊，它將會被覆寫" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "%s 擴充套件並未宣告平行讀取是否安全，假設為否 - 請尋求擴充套件作者以檢查並明確表示" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "%s 擴充套件對於平行讀取是不安全的" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "%s 擴充套件並未宣告平行寫入是否安全，假設為否 - 請尋求擴充套件作者以檢查並明確表示" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "%s 擴充套件對於平行寫入是不安全的" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "執行串列 %s" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "config 資料夾沒有包含 conf.py 檔案 (%s)" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "無法覆寫資料夾組態設定 %r，忽略中（使用 %r 來設定個別元素）" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "無效的數字 %r 於組態值 %r，忽略中" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "無法以未支援的型別覆寫組態設定 %r，忽略中" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "覆寫未知的組態值 %r，忽略中" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "無此類組態值：%s" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "組態值 %r 已經存在" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "在您的組態檔中有一個語法錯誤：%s\n" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "組態檔（或它 import 的其中一個模組）呼叫了 sys.exit()" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "在您的組態檔中有一個程式化錯誤：\n\n%s" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "組態值 `source_suffix' 預期是一個字串、一組字串，或字典。但是 `%r' 被給予。" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "章節 %s" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "圖 %s" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "表格 %s" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "列表 %s" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "組態值 `{name}` 必須是 {candidates} 的其中之一，但 `{current}` 被給予。" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "組態值 `{name}' 有 `{current.__name__}' 型別；預期 {permitted} 。" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "組態值 `{name}' 有 `{current.__name__}' 型別；預設為 `{default.__name__}' 。" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "找不到 primary_domain %r，已略過。" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "從 v2.0 開始，Sphinx 預設使用 \"index\" 作為 root_doc。請在您的 conf.py 加上 \"root_doc = 'contents'\"。" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "事件 %r 已經存在" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "未知的事件名稱：%s" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "對於事件 %r 的 handler %r 拋出了一個例外" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "擴充套件 %s 被 needs_extensions 的設定所要求，但它沒有被載入。" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "這個專案需要擴充套件 %s 的最低版本是 %s，所以無法以載入的版本 (%s) 被建立。" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "Pygments lexer 名稱 %r 不是已知的" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "無法將 literal_block 分析為 \"%s\"。Highlighting 已省略。" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "為文件 \"%s\" 找到多個檔案： %r\n使用 %r 來建立。" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "文件無法讀取。已略過。" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "Builder class %s 沒有 \"name\" 屬性" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "Builder %r 已存在（於 %s 模組）" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "Builder 名稱 %s 未註冊或無法從 entry point 取得" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "Builder 名稱 %s 未註冊" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "domain %s 已註冊" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "domain %s 尚未被註冊" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "%r 指令已註冊給 domain %s" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "%r 角色已註冊給 domain %s" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "%r 索引已註冊給 domain %s" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "%r object_type 已註冊" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "%r crossref_type 已註冊" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "source_suffix %r 已註冊" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "對於 %r 的 source_parser 已註冊" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "對於 %s 的源碼剖析器未註冊" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "對於 %r 的翻譯器已經存在" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "對於 add_node() 的 kwargs 必須是一個 (visit, depart) 函式值組：%r=%r" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "enumerable_node %r 已註冊" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "數學描繪器 %s 已註冊" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "擴充套件 %r 已被併入版本 %s 以上的 Sphinx：此擴充套件已略過。" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "原始的例外：\n" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "無法引入擴充套件 %s" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "擴充套件 %r 沒有 setup() 函式；它真的是 Sphinx 擴充套件模組嗎？" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "此專案使用的 %s 擴充套件需要 Sphinx v%s 以上的版本；所以它無法以此版本被建立。" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "擴充套件 %r 從它的 setup() 函式回傳一個未支援物件；它應該回傳 None 或一個元數據資料夾" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "Python Enhancement Proposals; PEP %s" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "主題 %r 沒有 \"theme\" 設定" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "主題 %r 沒有 \"inherit\" 設定" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "未找到名為 %r 的主題，被 %r 繼承" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "設定 %s。%s 不在已被搜尋的主題組態中出現" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "未支援的主題選項 %r 被給予" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "主題路徑中的檔案 %r 不是有效的 zipfile 或未包含主題" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "找到 sphinx_rtd_theme (< 0.3.0)。從 Sphinx-6.0 之後將無法使用。" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "未找到名為 %r 的主題（缺少 theme.conf？）" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "未找到對於 %s builder 適用的圖片：%s (%s)" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "未找到對於 %s builder 適用的圖片：%s" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "建立 [mo]：" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "編寫輸出..." #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "所有的 %d po 檔" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "對於指定的 po 檔 %d 的目標" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "對於已過期 po 檔 %d 的目標" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "所有原始檔案" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "在命令列給的檔案 %r 不在來源資料夾下，忽略中" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "在命令列給的檔案 %r 不存在，忽略中" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "在命令列給了 %d 個原始檔案" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "%d 個過時原始檔案的目標" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "正在建立 [%s]：" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "正在尋找目前已過期的檔案..." #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "已找到 %d" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "找不到任何結果" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "正在 pickle 環境" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "正在檢查一致性" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "沒有過時的目標。" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "正在更新環境：" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "%s 已新增， %s 已變更， %s 已移除" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "正在讀取來源..." #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "正在等待工作者..." #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "待寫入的 docname: %s" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "正在準備文件" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "找到了重複的 ToC 項目： %s" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "正在複製圖片..." #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "無法讀取圖片檔 %r: 正在複製它做為替代" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "無法複製圖片檔 %r: %s" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "無法寫入圖片檔 %r: %s" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "未找到 Pillow - 正在複製圖片檔" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "正在寫入 mimetype 檔案..." #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "正在寫入 META-INF/container.xml 檔案..." #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "正在寫入 content.opf 檔案..." #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "對於 %s 未知的 mimetype，忽略中" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "正在寫入 toc.ncx 檔案..." #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "正在寫入 %s 檔案..." #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "概觀檔案是在 %(outdir)s 。" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "在版本 %s 中無變更" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "正在寫入摘要檔案..." #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "內建" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "模組層次" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "正在複製原始檔案..." #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "在變更日誌建立時無法讀取 %r" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "虛擬建立器未產生任何檔案。" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "ePub 檔案是在 %(outdir)s 。" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "正在寫入 nav.xhtml 檔案..." #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "conf 值 \"epub_language\" (或 \"language\") 在 EPUB3 不應該為空" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "conf 值 \"epub_uid\" 在 EPUB3 應該是 XML NAME" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "conf 值 \"epub_title\" (或 \"html_title\") 在 EPUB3 不應該為空" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "conf 值 \"epub_author\" 在 EPUB3 不應該為空" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "conf 值 \"epub_contributor\" 在 EPUB3 不應該為空" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "conf 值 \"epub_description\" 在 EPUB3 不應該為空" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "conf 值 \"epub_publisher\" 在 EPUB3 不應該為空" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "conf 值 \"epub_copyright\" (或 \"copyright\") 在 EPUB3 不應該為空" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "conf 值 \"epub_identifier\" 在 EPUB3 不應該為空" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "conf 值 \"version\" 在 EPUB3 不應該為空" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "無效的 css_file: %r, 已略過" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "編寫中" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "正在處理 %s" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "正在解析參照..." #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr " (於 " #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "%Y 年 %m 月 %d 日" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "總索引" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "索引" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "下一頁" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "上一頁" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "正在產生索引" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "無效的 js_file: %r, 已略過" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "%s %s 說明文件" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "索引" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "發佈" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "寫入所有檔案（預設：只寫入新增及已變更檔案）" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "安靜模式" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "專案根" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "結構選項" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "如果有指定，會分離來源資料夾和 build 資料夾" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "如果有指定，會在來源資料夾下建立 build 資料夾" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "在 _templates 等處進行句號的取代" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "專案基本選項" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "專案名稱" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "作者名" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "專案版本" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "專案發布" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "文件語言" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "源始檔後綴" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "主文件名稱" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "使用 epub" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "擴充套件選項" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "啟用 %s 擴充套件" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "啟用任意的擴充套件" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "Makefile 及 Batchfile 的建立" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "建立 makefile" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "不要建立 makefile" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "建立 batchfile" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "不要建立 batchfile" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "使用 make 模式於 Makefile/make.bat" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "不要使用 make 模式於 Makefile/make.bat" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "專案模板化中" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "用於模板檔案的模板資料夾" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "定義一個模板變數" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "\"quiet\" 被指定，但 \"project\" 或 \"author\" 的任一項未被指定。" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "無效的模板變數： %s" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "無效標題：%s" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "章節作者：" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "模組作者：" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "程式作者：" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "作者：" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "對 csv-table 指令的 \":file:\" 選項現在會將絕對路徑辨識為基於來源資料夾的相對路徑。請更新您的文件。" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "%s %s" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "重複的 C 宣告，亦被定義於 %s:%s。\n宣告是 '.. c:%s:: %s'。" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "%s (C %s)" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:420 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "參數" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "回傳值" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:432 msgid "Returns" msgstr "回傳" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:434 msgid "Return type" msgstr "回傳型別" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "成員函數" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "變數" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1168 msgid "function" msgstr "函式" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "巨集" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "結構" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "union" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "enum" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "enumerator" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "型別" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "函式參數" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "在 %s 版本新加入" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "在 %s 版本變更" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "在 %s 版本開始棄用" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "重複的引用 %s，亦出現於 %s" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "引用 [%s] 未被參照。" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "重複的 C++ 宣告，亦被定義於 %s:%s。\n宣告是 '.. cpp:%s:: %s'。" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "模板參數" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "%s (C++ %s)" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "拋出" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1170 msgid "class" msgstr "類別" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "概念" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "模板參數" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "%s() (內建函式)" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:807 #, python-format msgid "%s() (%s method)" msgstr "%s() (%s 的方法)" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "%s() (類別)" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "%s (全域變數或常數)" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:892 #, python-format msgid "%s (%s attribute)" msgstr "%s (%s 的屬性)" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "引數" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "%s (模組)" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1172 msgid "method" msgstr "方法" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1169 msgid "data" msgstr "資料" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1175 msgid "attribute" msgstr "屬性" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1177 msgid "module" msgstr "模組" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "%s 的重複 %s 敘述，其他的 %s 在 %s" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "重複公式標籤 %s，亦出現於 %s" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "無效的 math_eqref_format: %r" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "關鍵字" #: sphinx/domains/python.py:60 msgid "operator" msgstr "運算子" #: sphinx/domains/python.py:61 msgid "object" msgstr "物件" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1171 msgid "exception" msgstr "例外" #: sphinx/domains/python.py:63 msgid "statement" msgstr "陳述式" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "內建函式" #: sphinx/domains/python.py:425 msgid "Variables" msgstr "變數" #: sphinx/domains/python.py:429 msgid "Raises" msgstr "引發" #: sphinx/domains/python.py:652 sphinx/domains/python.py:796 #, python-format msgid "%s() (in module %s)" msgstr "%s() (於 %s 模組中)" #: sphinx/domains/python.py:712 sphinx/domains/python.py:888 #: sphinx/domains/python.py:939 #, python-format msgid "%s (in module %s)" msgstr "%s (於 %s 模組中)" #: sphinx/domains/python.py:714 #, python-format msgid "%s (built-in variable)" msgstr "%s (內建變數)" #: sphinx/domains/python.py:739 #, python-format msgid "%s (built-in class)" msgstr "%s (內建類別)" #: sphinx/domains/python.py:740 #, python-format msgid "%s (class in %s)" msgstr "%s (%s 中的類別)" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s class method)" msgstr "%s() (%s 的類別方法)" #: sphinx/domains/python.py:803 sphinx/domains/python.py:943 #, python-format msgid "%s (%s property)" msgstr "%s (%s 的特性)" #: sphinx/domains/python.py:805 #, python-format msgid "%s() (%s static method)" msgstr "%s() (%s 的靜態方法)" #: sphinx/domains/python.py:1097 msgid "Python Module Index" msgstr "Python 模組索引" #: sphinx/domains/python.py:1098 msgid "modules" msgstr "模組" #: sphinx/domains/python.py:1147 msgid "Deprecated" msgstr "已棄用" #: sphinx/domains/python.py:1173 msgid "class method" msgstr "類別方法" #: sphinx/domains/python.py:1174 msgid "static method" msgstr "靜態方法" #: sphinx/domains/python.py:1176 msgid "property" msgstr "特性" #: sphinx/domains/python.py:1234 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "%s 的重複物件敘述，其他的實例在 %s ，使用 :noindex: 給它們其中之一" #: sphinx/domains/python.py:1354 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "為交互參照 %r 找到多於一個目標： %s" #: sphinx/domains/python.py:1408 msgid " (deprecated)" msgstr "（已棄用）" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "%s （指令）" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr ":%s: （指令選項）" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "%s （角色）" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "指令" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "指令選項" #: sphinx/domains/rst.py:210 msgid "role" msgstr "角色" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "%s %s 的重複敘述，其他的實例在 %s" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "環境變數; %s" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "異常的選項敘述 %r ，應該要看起來像 \"opt\", \"-opt args\", \"--opt args\", \"/opt args\" 或 \"+opt args\"" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "%s 命令列選項" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "命令列選項" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "術語表項目必須有空白行在前" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "術語表項目不可以被空白行分隔" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "術語表似乎有格式錯誤，請檢查縮排" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "雜項術語" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "語法單詞" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "參照標籤" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "環境變數" #: sphinx/domains/std.py:568 msgid "program option" msgstr "程式選項" #: sphinx/domains/std.py:569 msgid "document" msgstr "文件" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "模組索引" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "搜尋頁面" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "重複的標籤 %s，亦出現於 %s" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "重複 %s 的描述 %s，亦出現於 %s" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "numfig 已停用。 :numref: 已略過。" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "無法建立一個交互參照。任一數字未被指定： %s" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "這個連結沒有標題： %s" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "無效的 numfig_format: %s (%r)" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "無效的 numfig_format: %s" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "未定義的標籤： %s" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "無法建立一個交互參照。未找到標題或題目： %s" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "新的組態" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "組態已變更" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "擴充套件已變更" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "建立環境的版本不是目前的" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "來源資料夾已變更" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "這個環境與所選的 builder 不相容，請選擇另一個 doctree 資料夾。" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "無法掃描 %s 中的文件： %r" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "Domain %r 未被註冊" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "找到自我參照的 toctree。已略過。" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "文件未被包含於任何 toctree" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "參考 %s" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "也參考 %s" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "未知的索引項目型別 %r" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "符號" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "[圖：%s]" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "[圖]" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "本公式的永久連結" #: sphinx/ext/intersphinx.py:174 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:205 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:219 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:225 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:270 #, python-format msgid "(in %s v%s)" msgstr "(於 %s v%s)" #: sphinx/ext/intersphinx.py:272 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:476 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "intersphinx identifier %r 不是字串。已略過" #: sphinx/ext/intersphinx.py:489 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "無法讀取 intersphinx_mapping[%s], 已略過: %r" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "[原始碼]" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "Todo" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "找到 TODO 項目： %s" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "<<original entry>>" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "(<<original entry>> 見 %s ，第 %d 行)" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "原始記錄" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "正在 highlight 模組程式碼..." #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "[文件]" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "模組原始碼" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "<h1>%s 的原始碼</h1>" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "概要：模組原始碼" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "<h1>所有可得程式碼的模組</h1>" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "對於 member-order 選項無效的值： %s" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "對於 class-doc-from 選項無效的值： %s" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "一個 mocked 物件被偵測到： %r" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "正在為 %s 格式化簽名時發生錯誤： %s" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "\"::\" 在 automodule 的名稱中並不合理" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "簽名引數或回傳註釋給予 automodule %s" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "__all__ 應該是一個字串的列表，不是 %r （在 %s 模組中）-- 正在忽略 __all__" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "缺少 :members: 選項中所述的屬性：模組 %s ，屬性 %s" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "無法取得一個函式簽名給 %s: %s" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "無法取得一個 constructor 簽名給 %s: %s" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "基礎類別：%s" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "%s 的別名" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "TypeVar(%s) 的別名" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "無法取得一個 method 簽名給 %s: %s" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "在 %s 找到無效的 __slots__。已略過。" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "autodoc_member_order 現在接受 \"alphabetical\" 而非 \"alphabetic\"。請更新您的設定。" #: sphinx/ext/autodoc/preserve_defaults.py:106 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "無法為 %r 剖析一個預設引數： %s" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "無法為 %r 更新簽名：未找到參數： %s" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "無法為 %r 剖析 type_comment： %s" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "autosummary 參照已排除文件 %r 。已略過。" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "autosummary: 未找到 stub 檔 %r 。請檢查您的 autosummary_generate 設定。" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "一個有標題的 autosummary 需要 :toctree: 選項。已略過。 " #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "autosummary: 無法 import %s" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "剖析名稱 %s 失敗" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "import 物件 %s 失敗" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "autosummary_generate: 檔案未找到： %s" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "autosummary 會在內部產生 .rst 檔案。但是您的 source_suffix 並未包含 .rst。已省略。" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "autosummary: 無法決定 %r 被記錄，以下例外被引發：\n%s" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "[autosummary] 正在產生 autosummary 給： %s" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "[autosummary] 正在寫入 %s" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "[autosummary] 無法 import %r: %s " #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "\n使用 autosummary 指令產生 ReStructuredText。\n\nsphinx-autogen 是 sphinx.ext.autosummary.generate 的一個前端。它會從給定的\n輸入檔案中所包含的 autosummary 指令，產生 reStructuredText 檔案。\n\nautosummary 指令的格式被記錄在 ``sphinx.ext.autosummary`` Python 模組中，\n它可以使用此方法來讀取::\n\npydoc sphinx.ext.autosummary\n" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "原始檔案以產生 rST 檔案給" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "資料夾來放置所有輸出在" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "檔案的預設後綴（預設： %(default)s ）" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "自訂模板資料夾（預設： %(default)s ）" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "文件引入成員（預設： %(default)s ）" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "關鍵字引數" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "範例" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "範例" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "備註" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "其他參數" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "接收" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "參照" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "警告" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "產出" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "無效的值集合（缺少右括號）： %s" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "無效的值集合（缺少左括號）： %s" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "異常的字串文本（缺少右括號）： %s" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "異常的字串文本（缺少左括號）： %s" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "注意" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "警示" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "危險" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "錯誤" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "提示" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "重要" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "備註" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "也參考" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "小訣竅" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "警告" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "繼續上一頁" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "繼續下一頁" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "非依字母順序" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "數字" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "頁" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "目錄" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "搜尋" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "前往" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "顯示原始碼" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "概要" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "歡迎！本" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "說明文件介紹" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "最後更新於" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "索引與表格：" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "完整目錄" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "列出所有章節與小節" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "搜尋這份說明文件" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "全域模組索引" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "迅速找到所有模組" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "所有函式、類別、術語" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "索引 – %(key)s" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "單頁完整索引" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "按字母索引頁面" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "可能會很大" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "瀏覽" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "在 %(docstitle)s 中搜尋" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "關於這些文件" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "版權所有" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "© <a href=\"%(path)s\">版權所有</a> %(copyright)s。" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "© 版權所有 %(copyright)s。" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "最後更新於 %(last_updated)s。" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "使用 <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s 建立。" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "搜尋 %(docstitle)s" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "上個主題" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "上一章" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "下個主題" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "下一章" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "請啟用 Javascript 以開啟搜尋功能。" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "搜尋多個關鍵字時，只會顯示包含所有關鍵字的結果。" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "搜尋" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "搜尋結果" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "您的搜尋找不到任何滿足條件的文件。請確定是否所有的搜尋詞都正確地拼寫且您已選擇足夠的分類。" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "快速搜尋" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "本頁" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "於 %(version)s 版本中的所有變更 — %(docstitle)s" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "%(filename)s — %(docstitle)s" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "自動產生的 %(version)s 版本變更列表" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "程式庫的變更" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "C API 的變更" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "其他變更" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "本標題的永久連結" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "本定義的永久連結" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "隱藏符合搜尋" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "搜尋中" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "準備搜尋中…" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "搜尋完成，共找到 %s 頁面符合搜尋條件。" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "，於 " #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "展開側邊欄" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "收合側邊欄" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "內容" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "找到基於 4 欄位的索引。它可能是您使用的擴充套件的一個錯誤： %r" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "註腳 [%s] 未被參照。" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "註腳 [#] 未被參照。" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "被翻譯訊息中有不一致的註腳參照。原文： {0}，譯文： {1}" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "被翻譯訊息中有不一致的參照。原文： {0}，譯文： {1}" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "被翻譯訊息中有不一致的引用。原文： {0}，譯文： {1}" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "被翻譯訊息中有不一致的術語參照。原文： {0}，譯文： {1}" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "無法為交互參照決定備用文字。可能是個錯誤。" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "為「任一個」交互參照 %r 找到多於一個目標：可能是 %s" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "%s:%s 參照目標未找到： %s" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "%r 參照目標未找到： %s" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "無法提取遠端圖片： %s [%d]" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "無法提取遠端圖片： %s [%s]" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "未知的圖片格式： %s..." #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "無法解碼的原始字元，以 \"?\" 取代： %r" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "已省略" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "失敗" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "未知的指令或角色名稱： %s:%s" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "讀取錯誤： %s, %s" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "寫入錯誤： %s, %s" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "locale_dir %s 不存在" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "無效的日期格式。如果您要直接將它輸出，則以單引號引用該字串： %s" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "toctree 包含了不存在的檔案 %r 的參照 " #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "在評估只有指令的運算式時發生例外： %s" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "預設角色 %s 未找到" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "numfig_format 未被定義給 %s" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "任一個 ID 未被指定給 %s 節點" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "本術語的永久連結" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "本表格的永久連結" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "本原始碼的永久連結" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "本圖片的永久連結" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "本目錄的永久連結" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "無法取得圖片大小。 :scale: 選項已略過。" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "未知的 %r toplevel_sectioning 對於 class %r" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr ":maxdepth: 太大，已略過。" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "文件標題不是單一的 Text 節點" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "遇到的標題節點不是在段落、主題、表格、警告或側邊欄" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "註腳" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "同時被給予 tabularcolumns 及 :widths: 選項。 :widths: 已略過。" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "維度單位 %s 是無效的。已略過。" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "找到了未知的索引條目型別 %s" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "[圖片：%s]" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "[圖片]" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "標題不在圖之內。" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "未實作的節點型別： %r" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "未知的節點型別： %r" �����������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.3336937 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_TW.Big5/��������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016723� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.517841 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_TW.Big5/LC_MESSAGES/��������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�020510� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.js�����������������������������������������0000644�0000766�0000024�00000004604�00000000000�022363� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Documentation.addTranslations({ "locale": "zh_Hant_TW", "messages": { "%(filename)s — %(docstitle)s": "", "© <a href=\"%(path)s\">Copyright</a> %(copyright)s.": "", "© Copyright %(copyright)s.": "", ", in ": "", "About these documents": "", "Automatically generated list of changes in version %(version)s": "", "C API changes": "", "Changes in Version %(version)s — %(docstitle)s": "", "Collapse sidebar": "", "Complete Table of Contents": "", "Contents": "", "Copyright": "", "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> %(sphinx_version)s.": "", "Expand sidebar": "", "Full index on one page": "", "General Index": "", "Global Module Index": "", "Go": "", "Hide Search Matches": "", "Index": "", "Index – %(key)s": "", "Index pages by letter": "", "Indices and tables:": "", "Last updated on %(last_updated)s.": "", "Library changes": "", "Navigation": "", "Next topic": "", "Other changes": "", "Overview": "", "Permalink to this definition": "", "Permalink to this headline": "", "Please activate JavaScript to enable the search\n functionality.": "", "Preparing search...": "", "Previous topic": "", "Quick search": "", "Search": "", "Search Page": "", "Search Results": "", "Search finished, found %s page(s) matching the search query.": "", "Search within %(docstitle)s": "", "Searching": "", "Searching for multiple words only shows matches that contain\n all words.": "", "Show Source": "", "Table of Contents": "", "This Page": "", "Welcome! This is": "", "Your search did not match any documents. Please make sure that all words are spelled correctly and that you've selected enough categories.": "", "all functions, classes, terms": "", "can be huge": "", "last updated": "", "lists all sections and subsections": "", "next chapter": "", "previous chapter": "", "quick access to all modules": "", "search": "", "search this documentation": "", "the documentation for": "" }, "plural_expr": "0" });����������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.mo�����������������������������������������0000644�0000766�0000024�00000001015�00000000000�022353� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������$���������������,�����-����Project-Id-Version: Sphinx Report-Msgid-Bugs-To: EMAIL@ADDRESS POT-Creation-Date: 2021-10-31 00:10+0000 PO-Revision-Date: 2021-10-10 00:10+0000 Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com> Language: zh_TW.Big5 Language-Team: Chinese (Taiwan) (Big5) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_TW.Big5/) Plural-Forms: nplurals=1; plural=0 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Generated-By: Babel 2.9.1 ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1639902831.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/locale/zh_TW.Big5/LC_MESSAGES/sphinx.po�����������������������������������������0000644�0000766�0000024�00000241457�00000000000�022376� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������# Translations template for Sphinx. # Copyright (C) 2021 ORGANIZATION # This file is distributed under the same license as the Sphinx project. # # Translators: msgid "" msgstr "" "Project-Id-Version: Sphinx\n" "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n" "POT-Creation-Date: 2021-10-31 00:10+0000\n" "PO-Revision-Date: 2021-10-10 00:10+0000\n" "Last-Translator: Komiya Takeshi <i.tkomiya@gmail.com>\n" "Language-Team: Chinese (Taiwan) (Big5) (http://www.transifex.com/sphinx-doc/sphinx-1/language/zh_TW.Big5/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.9.1\n" "Language: zh_TW.Big5\n" "Plural-Forms: nplurals=1; plural=0;\n" #: sphinx/application.py:157 #, python-format msgid "Cannot find source directory (%s)" msgstr "" #: sphinx/application.py:161 #, python-format msgid "Output directory (%s) is not a directory" msgstr "" #: sphinx/application.py:165 msgid "Source directory and destination directory cannot be identical" msgstr "" #: sphinx/application.py:196 #, python-format msgid "Running Sphinx v%s" msgstr "" #: sphinx/application.py:200 msgid "" "For security reasons, parallel mode is disabled on macOS and python3.8 and " "above. For more details, please read https://github.com/sphinx-" "doc/sphinx/issues/6803" msgstr "" #: sphinx/application.py:228 #, python-format msgid "" "This project needs at least Sphinx v%s and therefore cannot be built with " "this version." msgstr "" #: sphinx/application.py:243 msgid "making output directory" msgstr "" #: sphinx/application.py:248 sphinx/registry.py:426 #, python-format msgid "while setting up extension %s:" msgstr "" #: sphinx/application.py:254 msgid "" "'setup' as currently defined in conf.py isn't a Python callable. Please " "modify its definition to make it a callable function. This is needed for " "conf.py to behave as a Sphinx extension." msgstr "" #: sphinx/application.py:279 #, python-format msgid "loading translations [%s]... " msgstr "" #: sphinx/application.py:296 sphinx/util/__init__.py:539 msgid "done" msgstr "" #: sphinx/application.py:298 msgid "not available for built-in messages" msgstr "" #: sphinx/application.py:307 msgid "loading pickled environment" msgstr "" #: sphinx/application.py:312 #, python-format msgid "failed: %s" msgstr "" #: sphinx/application.py:320 msgid "No builder selected, using default: html" msgstr "" #: sphinx/application.py:348 msgid "succeeded" msgstr "" #: sphinx/application.py:349 msgid "finished with problems" msgstr "" #: sphinx/application.py:353 #, python-format msgid "build %s, %s warning (with warnings treated as errors)." msgstr "" #: sphinx/application.py:355 #, python-format msgid "build %s, %s warnings (with warnings treated as errors)." msgstr "" #: sphinx/application.py:358 #, python-format msgid "build %s, %s warning." msgstr "" #: sphinx/application.py:360 #, python-format msgid "build %s, %s warnings." msgstr "" #: sphinx/application.py:364 #, python-format msgid "build %s." msgstr "" #: sphinx/application.py:594 #, python-format msgid "node class %r is already registered, its visitors will be overridden" msgstr "" #: sphinx/application.py:672 #, python-format msgid "directive %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:693 sphinx/application.py:714 #, python-format msgid "role %r is already registered, it will be overridden" msgstr "" #: sphinx/application.py:1245 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel reading, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1249 #, python-format msgid "the %s extension is not safe for parallel reading" msgstr "" #: sphinx/application.py:1252 #, python-format msgid "" "the %s extension does not declare if it is safe for parallel writing, " "assuming it isn't - please ask the extension author to check and make it " "explicit" msgstr "" #: sphinx/application.py:1256 #, python-format msgid "the %s extension is not safe for parallel writing" msgstr "" #: sphinx/application.py:1264 sphinx/application.py:1268 #, python-format msgid "doing serial %s" msgstr "" #: sphinx/config.py:170 #, python-format msgid "config directory doesn't contain a conf.py file (%s)" msgstr "" #: sphinx/config.py:197 #, python-format msgid "" "cannot override dictionary config setting %r, ignoring (use %r to set " "individual elements)" msgstr "" #: sphinx/config.py:206 #, python-format msgid "invalid number %r for config value %r, ignoring" msgstr "" #: sphinx/config.py:211 #, python-format msgid "cannot override config setting %r with unsupported type, ignoring" msgstr "" #: sphinx/config.py:240 #, python-format msgid "unknown config value %r in override, ignoring" msgstr "" #: sphinx/config.py:257 #, python-format msgid "No such config value: %s" msgstr "" #: sphinx/config.py:281 #, python-format msgid "Config value %r already present" msgstr "" #: sphinx/config.py:330 #, python-format msgid "There is a syntax error in your configuration file: %s\n" msgstr "" #: sphinx/config.py:333 msgid "" "The configuration file (or one of the modules it imports) called sys.exit()" msgstr "" #: sphinx/config.py:340 #, python-format msgid "" "There is a programmable error in your configuration file:\n" "\n" "%s" msgstr "" #: sphinx/config.py:366 #, python-format msgid "" "The config value `source_suffix' expects a string, list of strings, or " "dictionary. But `%r' is given." msgstr "" #: sphinx/config.py:385 #, python-format msgid "Section %s" msgstr "" #: sphinx/config.py:386 #, python-format msgid "Fig. %s" msgstr "" #: sphinx/config.py:387 #, python-format msgid "Table %s" msgstr "" #: sphinx/config.py:388 #, python-format msgid "Listing %s" msgstr "" #: sphinx/config.py:425 msgid "" "The config value `{name}` has to be a one of {candidates}, but `{current}` " "is given." msgstr "" #: sphinx/config.py:443 msgid "" "The config value `{name}' has type `{current.__name__}'; expected " "{permitted}." msgstr "" #: sphinx/config.py:456 msgid "" "The config value `{name}' has type `{current.__name__}', defaults to " "`{default.__name__}'." msgstr "" #: sphinx/config.py:466 #, python-format msgid "primary_domain %r not found, ignored." msgstr "" #: sphinx/config.py:478 msgid "" "Since v2.0, Sphinx uses \"index\" as root_doc by default. Please add " "\"root_doc = 'contents'\" to your conf.py." msgstr "" #: sphinx/events.py:67 #, python-format msgid "Event %r already present" msgstr "" #: sphinx/events.py:73 #, python-format msgid "Unknown event name: %s" msgstr "" #: sphinx/events.py:109 #, python-format msgid "Handler %r for event %r threw an exception" msgstr "" #: sphinx/extension.py:52 #, python-format msgid "" "The %s extension is required by needs_extensions settings, but it is not " "loaded." msgstr "" #: sphinx/extension.py:68 #, python-format msgid "" "This project needs the extension %s at least in version %s and therefore " "cannot be built with the loaded version (%s)." msgstr "" #: sphinx/highlighting.py:135 #, python-format msgid "Pygments lexer name %r is not known" msgstr "" #: sphinx/highlighting.py:161 #, python-format msgid "Could not lex literal_block as \"%s\". Highlighting skipped." msgstr "" #: sphinx/project.py:53 #, python-format msgid "" "multiple files found for the document \"%s\": %r\n" "Use %r for the build." msgstr "" #: sphinx/project.py:59 msgid "document not readable. Ignored." msgstr "" #: sphinx/registry.py:135 #, python-format msgid "Builder class %s has no \"name\" attribute" msgstr "" #: sphinx/registry.py:137 #, python-format msgid "Builder %r already exists (in module %s)" msgstr "" #: sphinx/registry.py:150 #, python-format msgid "Builder name %s not registered or available through entry point" msgstr "" #: sphinx/registry.py:157 #, python-format msgid "Builder name %s not registered" msgstr "" #: sphinx/registry.py:164 #, python-format msgid "domain %s already registered" msgstr "" #: sphinx/registry.py:187 sphinx/registry.py:200 sphinx/registry.py:211 #, python-format msgid "domain %s not yet registered" msgstr "" #: sphinx/registry.py:191 #, python-format msgid "The %r directive is already registered to domain %s" msgstr "" #: sphinx/registry.py:203 #, python-format msgid "The %r role is already registered to domain %s" msgstr "" #: sphinx/registry.py:214 #, python-format msgid "The %r index is already registered to domain %s" msgstr "" #: sphinx/registry.py:238 #, python-format msgid "The %r object_type is already registered" msgstr "" #: sphinx/registry.py:258 #, python-format msgid "The %r crossref_type is already registered" msgstr "" #: sphinx/registry.py:265 #, python-format msgid "source_suffix %r is already registered" msgstr "" #: sphinx/registry.py:275 #, python-format msgid "source_parser for %r is already registered" msgstr "" #: sphinx/registry.py:284 #, python-format msgid "Source parser for %s not registered" msgstr "" #: sphinx/registry.py:313 #, python-format msgid "Translator for %r already exists" msgstr "" #: sphinx/registry.py:326 #, python-format msgid "kwargs for add_node() must be a (visit, depart) function tuple: %r=%r" msgstr "" #: sphinx/registry.py:398 #, python-format msgid "enumerable_node %r already registered" msgstr "" #: sphinx/registry.py:407 #, python-format msgid "math renderer %s is already registered" msgstr "" #: sphinx/registry.py:420 #, python-format msgid "" "the extension %r was already merged with Sphinx since version %s; this " "extension is ignored." msgstr "" #: sphinx/registry.py:431 msgid "Original exception:\n" msgstr "" #: sphinx/registry.py:432 #, python-format msgid "Could not import extension %s" msgstr "" #: sphinx/registry.py:437 #, python-format msgid "" "extension %r has no setup() function; is it really a Sphinx extension " "module?" msgstr "" #: sphinx/registry.py:446 #, python-format msgid "" "The %s extension used by this project needs at least Sphinx v%s; it " "therefore cannot be built with this version." msgstr "" #: sphinx/registry.py:454 #, python-format msgid "" "extension %r returned an unsupported object from its setup() function; it " "should return None or a metadata dictionary" msgstr "" #: sphinx/roles.py:177 #, python-format msgid "Python Enhancement Proposals; PEP %s" msgstr "" #: sphinx/theming.py:77 #, python-format msgid "theme %r doesn't have \"theme\" setting" msgstr "" #: sphinx/theming.py:79 #, python-format msgid "theme %r doesn't have \"inherit\" setting" msgstr "" #: sphinx/theming.py:85 #, python-format msgid "no theme named %r found, inherited by %r" msgstr "" #: sphinx/theming.py:108 #, python-format msgid "setting %s.%s occurs in none of the searched theme configs" msgstr "" #: sphinx/theming.py:127 #, python-format msgid "unsupported theme option %r given" msgstr "" #: sphinx/theming.py:225 #, python-format msgid "file %r on theme path is not a valid zipfile or contains no theme" msgstr "" #: sphinx/theming.py:240 msgid "" "sphinx_rtd_theme (< 0.3.0) found. It will not be available since Sphinx-6.0" msgstr "" #: sphinx/theming.py:245 #, python-format msgid "no theme named %r found (missing theme.conf?)" msgstr "" #: sphinx/builders/__init__.py:192 #, python-format msgid "a suitable image for %s builder not found: %s (%s)" msgstr "" #: sphinx/builders/__init__.py:196 #, python-format msgid "a suitable image for %s builder not found: %s" msgstr "" #: sphinx/builders/__init__.py:216 msgid "building [mo]: " msgstr "" #: sphinx/builders/__init__.py:217 sphinx/builders/__init__.py:535 #: sphinx/builders/__init__.py:561 msgid "writing output... " msgstr "" #: sphinx/builders/__init__.py:225 #, python-format msgid "all of %d po files" msgstr "" #: sphinx/builders/__init__.py:243 #, python-format msgid "targets for %d po files that are specified" msgstr "" #: sphinx/builders/__init__.py:250 #, python-format msgid "targets for %d po files that are out of date" msgstr "" #: sphinx/builders/__init__.py:257 msgid "all source files" msgstr "" #: sphinx/builders/__init__.py:269 #, python-format msgid "" "file %r given on command line is not under the source directory, ignoring" msgstr "" #: sphinx/builders/__init__.py:273 #, python-format msgid "file %r given on command line does not exist, ignoring" msgstr "" #: sphinx/builders/__init__.py:284 #, python-format msgid "%d source files given on command line" msgstr "" #: sphinx/builders/__init__.py:294 #, python-format msgid "targets for %d source files that are out of date" msgstr "" #: sphinx/builders/__init__.py:303 sphinx/builders/gettext.py:240 #, python-format msgid "building [%s]: " msgstr "" #: sphinx/builders/__init__.py:310 msgid "looking for now-outdated files... " msgstr "" #: sphinx/builders/__init__.py:315 #, python-format msgid "%d found" msgstr "" #: sphinx/builders/__init__.py:317 msgid "none found" msgstr "" #: sphinx/builders/__init__.py:322 msgid "pickling environment" msgstr "" #: sphinx/builders/__init__.py:328 msgid "checking consistency" msgstr "" #: sphinx/builders/__init__.py:332 msgid "no targets are out of date." msgstr "" #: sphinx/builders/__init__.py:371 msgid "updating environment: " msgstr "" #: sphinx/builders/__init__.py:392 #, python-format msgid "%s added, %s changed, %s removed" msgstr "" #: sphinx/builders/__init__.py:430 sphinx/builders/__init__.py:457 msgid "reading sources... " msgstr "" #: sphinx/builders/__init__.py:462 sphinx/builders/__init__.py:571 msgid "waiting for workers..." msgstr "" #: sphinx/builders/__init__.py:513 #, python-format msgid "docnames to write: %s" msgstr "" #: sphinx/builders/__init__.py:522 sphinx/builders/singlehtml.py:153 msgid "preparing documents" msgstr "" #: sphinx/builders/_epub_base.py:216 #, python-format msgid "duplicated ToC entry found: %s" msgstr "" #: sphinx/builders/_epub_base.py:405 sphinx/builders/html/__init__.py:730 #: sphinx/builders/latex/__init__.py:421 sphinx/builders/texinfo.py:176 msgid "copying images... " msgstr "" #: sphinx/builders/_epub_base.py:412 #, python-format msgid "cannot read image file %r: copying it instead" msgstr "" #: sphinx/builders/_epub_base.py:418 sphinx/builders/html/__init__.py:738 #: sphinx/builders/latex/__init__.py:429 sphinx/builders/texinfo.py:186 #, python-format msgid "cannot copy image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:435 #, python-format msgid "cannot write image file %r: %s" msgstr "" #: sphinx/builders/_epub_base.py:445 msgid "Pillow not found - copying image files" msgstr "" #: sphinx/builders/_epub_base.py:471 msgid "writing mimetype file..." msgstr "" #: sphinx/builders/_epub_base.py:476 msgid "writing META-INF/container.xml file..." msgstr "" #: sphinx/builders/_epub_base.py:504 msgid "writing content.opf file..." msgstr "" #: sphinx/builders/_epub_base.py:530 #, python-format msgid "unknown mimetype for %s, ignoring" msgstr "" #: sphinx/builders/_epub_base.py:677 msgid "writing toc.ncx file..." msgstr "" #: sphinx/builders/_epub_base.py:702 #, python-format msgid "writing %s file..." msgstr "" #: sphinx/builders/changes.py:34 #, python-format msgid "The overview file is in %(outdir)s." msgstr "" #: sphinx/builders/changes.py:60 #, python-format msgid "no changes in version %s." msgstr "" #: sphinx/builders/changes.py:62 msgid "writing summary file..." msgstr "" #: sphinx/builders/changes.py:78 msgid "Builtins" msgstr "" #: sphinx/builders/changes.py:80 msgid "Module level" msgstr "" #: sphinx/builders/changes.py:124 msgid "copying source files..." msgstr "" #: sphinx/builders/changes.py:131 #, python-format msgid "could not read %r for changelog creation" msgstr "" #: sphinx/builders/dummy.py:22 msgid "The dummy builder generates no files." msgstr "" #: sphinx/builders/epub3.py:67 #, python-format msgid "The ePub file is in %(outdir)s." msgstr "" #: sphinx/builders/epub3.py:165 msgid "writing nav.xhtml file..." msgstr "" #: sphinx/builders/epub3.py:191 msgid "conf value \"epub_language\" (or \"language\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:195 msgid "conf value \"epub_uid\" should be XML NAME for EPUB3" msgstr "" #: sphinx/builders/epub3.py:198 msgid "conf value \"epub_title\" (or \"html_title\") should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:202 msgid "conf value \"epub_author\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:205 msgid "conf value \"epub_contributor\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:208 msgid "conf value \"epub_description\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:211 msgid "conf value \"epub_publisher\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:214 msgid "conf value \"epub_copyright\" (or \"copyright\")should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:218 msgid "conf value \"epub_identifier\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:221 msgid "conf value \"version\" should not be empty for EPUB3" msgstr "" #: sphinx/builders/epub3.py:235 sphinx/builders/html/__init__.py:1121 #, python-format msgid "invalid css_file: %r, ignored" msgstr "" #: sphinx/builders/gettext.py:219 #, python-format msgid "The message catalogs are in %(outdir)s." msgstr "" #: sphinx/builders/gettext.py:241 #, python-format msgid "targets for %d template files" msgstr "" #: sphinx/builders/gettext.py:245 msgid "reading templates... " msgstr "" #: sphinx/builders/gettext.py:273 msgid "writing message catalogs... " msgstr "" #: sphinx/builders/linkcheck.py:119 #, python-format msgid "Look for any errors in the above output or in %(outdir)s/output.txt" msgstr "" #: sphinx/builders/linkcheck.py:257 #, python-format msgid "broken link: %s (%s)" msgstr "" #: sphinx/builders/linkcheck.py:454 #, python-format msgid "Anchor '%s' not found" msgstr "" #: sphinx/builders/linkcheck.py:690 #, python-format msgid "Failed to compile regex in linkcheck_allowed_redirects: %r %s" msgstr "" #: sphinx/builders/manpage.py:38 #, python-format msgid "The manual pages are in %(outdir)s." msgstr "" #: sphinx/builders/manpage.py:45 msgid "no \"man_pages\" config value found; no manual pages will be written" msgstr "" #: sphinx/builders/latex/__init__.py:299 sphinx/builders/manpage.py:56 #: sphinx/builders/singlehtml.py:161 sphinx/builders/texinfo.py:109 msgid "writing" msgstr "" #: sphinx/builders/manpage.py:67 #, python-format msgid "\"man_pages\" config value references unknown document %s" msgstr "" #: sphinx/builders/singlehtml.py:34 #, python-format msgid "The HTML page is in %(outdir)s." msgstr "" #: sphinx/builders/singlehtml.py:156 msgid "assembling single document" msgstr "" #: sphinx/builders/singlehtml.py:174 msgid "writing additional files" msgstr "" #: sphinx/builders/texinfo.py:45 #, python-format msgid "The Texinfo files are in %(outdir)s." msgstr "" #: sphinx/builders/texinfo.py:47 msgid "" "\n" "Run 'make' in that directory to run these through makeinfo\n" "(use 'make info' here to do that automatically)." msgstr "" #: sphinx/builders/texinfo.py:75 msgid "no \"texinfo_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/texinfo.py:83 #, python-format msgid "\"texinfo_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:281 sphinx/builders/texinfo.py:105 #, python-format msgid "processing %s" msgstr "" #: sphinx/builders/latex/__init__.py:352 sphinx/builders/texinfo.py:152 msgid "resolving references..." msgstr "" #: sphinx/builders/latex/__init__.py:362 sphinx/builders/texinfo.py:161 msgid " (in " msgstr "" #: sphinx/builders/texinfo.py:191 msgid "copying Texinfo support files" msgstr "" #: sphinx/builders/texinfo.py:195 #, python-format msgid "error writing file Makefile: %s" msgstr "" #: sphinx/builders/text.py:30 #, python-format msgid "The text files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:1074 sphinx/builders/text.py:77 #: sphinx/builders/xml.py:91 #, python-format msgid "error writing file %s: %s" msgstr "" #: sphinx/builders/xml.py:35 #, python-format msgid "The XML files are in %(outdir)s." msgstr "" #: sphinx/builders/xml.py:103 #, python-format msgid "The pseudo-XML files are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:145 #, python-format msgid "build info file is broken: %r" msgstr "" #: sphinx/builders/html/__init__.py:177 #, python-format msgid "The HTML pages are in %(outdir)s." msgstr "" #: sphinx/builders/html/__init__.py:375 #, python-format msgid "Failed to read build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:469 sphinx/builders/latex/__init__.py:187 #: sphinx/transforms/__init__.py:116 sphinx/writers/manpage.py:102 #: sphinx/writers/texinfo.py:233 #, python-format msgid "%b %d, %Y" msgstr "" #: sphinx/builders/html/__init__.py:488 sphinx/themes/basic/defindex.html:30 msgid "General Index" msgstr "" #: sphinx/builders/html/__init__.py:488 msgid "index" msgstr "" #: sphinx/builders/html/__init__.py:551 msgid "next" msgstr "" #: sphinx/builders/html/__init__.py:560 msgid "previous" msgstr "" #: sphinx/builders/html/__init__.py:654 msgid "generating indices" msgstr "" #: sphinx/builders/html/__init__.py:669 msgid "writing additional pages" msgstr "" #: sphinx/builders/html/__init__.py:748 msgid "copying downloadable files... " msgstr "" #: sphinx/builders/html/__init__.py:756 #, python-format msgid "cannot copy downloadable file %r: %s" msgstr "" #: sphinx/builders/html/__init__.py:788 sphinx/builders/html/__init__.py:800 #, python-format msgid "Failed to copy a file in html_static_file: %s: %r" msgstr "" #: sphinx/builders/html/__init__.py:821 msgid "copying static files" msgstr "" #: sphinx/builders/html/__init__.py:837 #, python-format msgid "cannot copy static file %r" msgstr "" #: sphinx/builders/html/__init__.py:842 msgid "copying extra files" msgstr "" #: sphinx/builders/html/__init__.py:848 #, python-format msgid "cannot copy extra file %r" msgstr "" #: sphinx/builders/html/__init__.py:855 #, python-format msgid "Failed to write build info file: %r" msgstr "" #: sphinx/builders/html/__init__.py:903 msgid "" "search index couldn't be loaded, but not all documents will be built: the " "index will be incomplete." msgstr "" #: sphinx/builders/html/__init__.py:964 #, python-format msgid "page %s matches two patterns in html_sidebars: %r and %r" msgstr "" #: sphinx/builders/html/__init__.py:1057 #, python-format msgid "" "a Unicode error occurred when rendering the page %s. Please make sure all " "config values that contain non-ASCII content are Unicode strings." msgstr "" #: sphinx/builders/html/__init__.py:1062 #, python-format msgid "" "An error happened in rendering the page %s.\n" "Reason: %r" msgstr "" #: sphinx/builders/html/__init__.py:1091 msgid "dumping object inventory" msgstr "" #: sphinx/builders/html/__init__.py:1096 #, python-format msgid "dumping search index in %s" msgstr "" #: sphinx/builders/html/__init__.py:1138 #, python-format msgid "invalid js_file: %r, ignored" msgstr "" #: sphinx/builders/html/__init__.py:1225 msgid "Many math_renderers are registered. But no math_renderer is selected." msgstr "" #: sphinx/builders/html/__init__.py:1228 #, python-format msgid "Unknown math_renderer %r is given." msgstr "" #: sphinx/builders/html/__init__.py:1236 #, python-format msgid "html_extra_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1240 #, python-format msgid "html_extra_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1249 #, python-format msgid "html_static_path entry %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1253 #, python-format msgid "html_static_path entry %r is placed inside outdir" msgstr "" #: sphinx/builders/html/__init__.py:1262 sphinx/builders/latex/__init__.py:433 #, python-format msgid "logo file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1271 #, python-format msgid "favicon file %r does not exist" msgstr "" #: sphinx/builders/html/__init__.py:1291 msgid "" "html_add_permalinks has been deprecated since v3.5.0. Please use " "html_permalinks and html_permalinks_icon instead." msgstr "" #: sphinx/builders/html/__init__.py:1317 #, python-format msgid "%s %s documentation" msgstr "" #: sphinx/builders/latex/__init__.py:114 #, python-format msgid "The LaTeX files are in %(outdir)s." msgstr "" #: sphinx/builders/latex/__init__.py:116 msgid "" "\n" "Run 'make' in that directory to run these through (pdf)latex\n" "(use `make latexpdf' here to do that automatically)." msgstr "" #: sphinx/builders/latex/__init__.py:152 msgid "no \"latex_documents\" config value found; no documents will be written" msgstr "" #: sphinx/builders/latex/__init__.py:160 #, python-format msgid "\"latex_documents\" config value references unknown document %s" msgstr "" #: sphinx/builders/latex/__init__.py:194 sphinx/domains/std.py:604 #: sphinx/templates/latex/latex.tex_t:97 #: sphinx/themes/basic/genindex-single.html:30 #: sphinx/themes/basic/genindex-single.html:55 #: sphinx/themes/basic/genindex-split.html:11 #: sphinx/themes/basic/genindex-split.html:14 #: sphinx/themes/basic/genindex.html:11 sphinx/themes/basic/genindex.html:34 #: sphinx/themes/basic/genindex.html:67 sphinx/themes/basic/layout.html:147 #: sphinx/writers/texinfo.py:498 msgid "Index" msgstr "" #: sphinx/builders/latex/__init__.py:197 sphinx/templates/latex/latex.tex_t:82 msgid "Release" msgstr "" #: sphinx/builders/latex/__init__.py:211 sphinx/writers/latex.py:382 #, python-format msgid "no Babel option known for language %r" msgstr "" #: sphinx/builders/latex/__init__.py:379 msgid "copying TeX support files" msgstr "" #: sphinx/builders/latex/__init__.py:399 msgid "copying TeX support files..." msgstr "" #: sphinx/builders/latex/__init__.py:412 msgid "copying additional files" msgstr "" #: sphinx/builders/latex/__init__.py:468 #, python-format msgid "Unknown configure key: latex_elements[%r], ignored." msgstr "" #: sphinx/builders/latex/__init__.py:476 #, python-format msgid "Unknown theme option: latex_theme_options[%r], ignored." msgstr "" #: sphinx/builders/latex/theming.py:91 #, python-format msgid "%r doesn't have \"theme\" setting" msgstr "" #: sphinx/builders/latex/theming.py:94 #, python-format msgid "%r doesn't have \"%s\" setting" msgstr "" #: sphinx/cmd/build.py:38 msgid "Exception occurred while building, starting debugger:" msgstr "" #: sphinx/cmd/build.py:48 msgid "Interrupted!" msgstr "" #: sphinx/cmd/build.py:50 msgid "reST markup error:" msgstr "" #: sphinx/cmd/build.py:56 msgid "Encoding error:" msgstr "" #: sphinx/cmd/build.py:59 sphinx/cmd/build.py:74 #, python-format msgid "" "The full traceback has been saved in %s, if you want to report the issue to " "the developers." msgstr "" #: sphinx/cmd/build.py:63 msgid "Recursion error:" msgstr "" #: sphinx/cmd/build.py:66 msgid "" "This can happen with very large or deeply nested source files. You can " "carefully increase the default Python recursion limit of 1000 in conf.py " "with e.g.:" msgstr "" #: sphinx/cmd/build.py:71 msgid "Exception occurred:" msgstr "" #: sphinx/cmd/build.py:77 msgid "" "Please also report this if it was a user error, so that a better error " "message can be provided next time." msgstr "" #: sphinx/cmd/build.py:80 msgid "" "A bug report can be filed in the tracker at <https://github.com/sphinx-" "doc/sphinx/issues>. Thanks!" msgstr "" #: sphinx/cmd/build.py:96 msgid "job number should be a positive number" msgstr "" #: sphinx/cmd/build.py:104 sphinx/cmd/quickstart.py:470 #: sphinx/ext/apidoc.py:307 sphinx/ext/autosummary/generate.py:598 msgid "For more information, visit <https://www.sphinx-doc.org/>." msgstr "" #: sphinx/cmd/build.py:105 msgid "" "\n" "Generate documentation from source files.\n" "\n" "sphinx-build generates documentation from the files in SOURCEDIR and places it\n" "in OUTPUTDIR. It looks for 'conf.py' in SOURCEDIR for the configuration\n" "settings. The 'sphinx-quickstart' tool may be used to generate template files,\n" "including 'conf.py'\n" "\n" "sphinx-build can create documentation in different formats. A format is\n" "selected by specifying the builder name on the command line; it defaults to\n" "HTML. Builders can also perform other tasks related to documentation\n" "processing.\n" "\n" "By default, everything that is outdated is built. Output only for selected\n" "files can be built by specifying individual filenames.\n" msgstr "" #: sphinx/cmd/build.py:126 msgid "path to documentation source files" msgstr "" #: sphinx/cmd/build.py:128 msgid "path to output directory" msgstr "" #: sphinx/cmd/build.py:130 msgid "a list of specific files to rebuild. Ignored if -a is specified" msgstr "" #: sphinx/cmd/build.py:133 msgid "general options" msgstr "" #: sphinx/cmd/build.py:136 msgid "builder to use (default: html)" msgstr "" #: sphinx/cmd/build.py:138 msgid "write all files (default: only write new and changed files)" msgstr "" #: sphinx/cmd/build.py:141 msgid "don't use a saved environment, always read all files" msgstr "" #: sphinx/cmd/build.py:144 msgid "" "path for the cached environment and doctree files (default: " "OUTPUTDIR/.doctrees)" msgstr "" #: sphinx/cmd/build.py:147 msgid "" "build in parallel with N processes where possible (special value \"auto\" " "will set N to cpu-count)" msgstr "" #: sphinx/cmd/build.py:151 msgid "" "path where configuration file (conf.py) is located (default: same as " "SOURCEDIR)" msgstr "" #: sphinx/cmd/build.py:154 msgid "use no config file at all, only -D options" msgstr "" #: sphinx/cmd/build.py:157 msgid "override a setting in configuration file" msgstr "" #: sphinx/cmd/build.py:160 msgid "pass a value into HTML templates" msgstr "" #: sphinx/cmd/build.py:163 msgid "define tag: include \"only\" blocks with TAG" msgstr "" #: sphinx/cmd/build.py:165 msgid "nit-picky mode, warn about all missing references" msgstr "" #: sphinx/cmd/build.py:168 msgid "console output options" msgstr "" #: sphinx/cmd/build.py:170 msgid "increase verbosity (can be repeated)" msgstr "" #: sphinx/cmd/build.py:172 sphinx/ext/apidoc.py:330 msgid "no output on stdout, just warnings on stderr" msgstr "" #: sphinx/cmd/build.py:174 msgid "no output at all, not even warnings" msgstr "" #: sphinx/cmd/build.py:177 msgid "do emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:180 msgid "do not emit colored output (default: auto-detect)" msgstr "" #: sphinx/cmd/build.py:183 msgid "write warnings (and errors) to given file" msgstr "" #: sphinx/cmd/build.py:185 msgid "turn warnings into errors" msgstr "" #: sphinx/cmd/build.py:187 msgid "with -W, keep going when getting warnings" msgstr "" #: sphinx/cmd/build.py:189 msgid "show full traceback on exception" msgstr "" #: sphinx/cmd/build.py:191 msgid "run Pdb on exception" msgstr "" #: sphinx/cmd/build.py:223 #, python-format msgid "cannot find files %r" msgstr "" #: sphinx/cmd/build.py:226 msgid "cannot combine -a option and filenames" msgstr "" #: sphinx/cmd/build.py:245 #, python-format msgid "cannot open warning file %r: %s" msgstr "" #: sphinx/cmd/build.py:255 msgid "-D option argument must be in the form name=value" msgstr "" #: sphinx/cmd/build.py:262 msgid "-A option argument must be in the form name=value" msgstr "" #: sphinx/cmd/quickstart.py:43 msgid "automatically insert docstrings from modules" msgstr "" #: sphinx/cmd/quickstart.py:44 msgid "automatically test code snippets in doctest blocks" msgstr "" #: sphinx/cmd/quickstart.py:45 msgid "link between Sphinx documentation of different projects" msgstr "" #: sphinx/cmd/quickstart.py:46 msgid "write \"todo\" entries that can be shown or hidden on build" msgstr "" #: sphinx/cmd/quickstart.py:47 msgid "checks for documentation coverage" msgstr "" #: sphinx/cmd/quickstart.py:48 msgid "include math, rendered as PNG or SVG images" msgstr "" #: sphinx/cmd/quickstart.py:49 msgid "include math, rendered in the browser by MathJax" msgstr "" #: sphinx/cmd/quickstart.py:50 msgid "conditional inclusion of content based on config values" msgstr "" #: sphinx/cmd/quickstart.py:51 msgid "include links to the source code of documented Python objects" msgstr "" #: sphinx/cmd/quickstart.py:52 msgid "create .nojekyll file to publish the document on GitHub pages" msgstr "" #: sphinx/cmd/quickstart.py:94 msgid "Please enter a valid path name." msgstr "" #: sphinx/cmd/quickstart.py:110 msgid "Please enter some text." msgstr "" #: sphinx/cmd/quickstart.py:117 #, python-format msgid "Please enter one of %s." msgstr "" #: sphinx/cmd/quickstart.py:124 msgid "Please enter either 'y' or 'n'." msgstr "" #: sphinx/cmd/quickstart.py:130 msgid "Please enter a file suffix, e.g. '.rst' or '.txt'." msgstr "" #: sphinx/cmd/quickstart.py:211 #, python-format msgid "Welcome to the Sphinx %s quickstart utility." msgstr "" #: sphinx/cmd/quickstart.py:213 msgid "" "Please enter values for the following settings (just press Enter to\n" "accept a default value, if one is given in brackets)." msgstr "" #: sphinx/cmd/quickstart.py:218 #, python-format msgid "Selected root path: %s" msgstr "" #: sphinx/cmd/quickstart.py:221 msgid "Enter the root path for documentation." msgstr "" #: sphinx/cmd/quickstart.py:222 msgid "Root path for the documentation" msgstr "" #: sphinx/cmd/quickstart.py:227 msgid "Error: an existing conf.py has been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:229 msgid "sphinx-quickstart will not overwrite existing Sphinx projects." msgstr "" #: sphinx/cmd/quickstart.py:231 msgid "Please enter a new root path (or just Enter to exit)" msgstr "" #: sphinx/cmd/quickstart.py:238 msgid "" "You have two options for placing the build directory for Sphinx output.\n" "Either, you use a directory \"_build\" within the root path, or you separate\n" "\"source\" and \"build\" directories within the root path." msgstr "" #: sphinx/cmd/quickstart.py:241 msgid "Separate source and build directories (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:245 msgid "" "Inside the root directory, two more directories will be created; \"_templates\"\n" "for custom HTML templates and \"_static\" for custom stylesheets and other static\n" "files. You can enter another prefix (such as \".\") to replace the underscore." msgstr "" #: sphinx/cmd/quickstart.py:248 msgid "Name prefix for templates and static dir" msgstr "" #: sphinx/cmd/quickstart.py:252 msgid "" "The project name will occur in several places in the built documentation." msgstr "" #: sphinx/cmd/quickstart.py:253 msgid "Project name" msgstr "" #: sphinx/cmd/quickstart.py:255 msgid "Author name(s)" msgstr "" #: sphinx/cmd/quickstart.py:259 msgid "" "Sphinx has the notion of a \"version\" and a \"release\" for the\n" "software. Each version can have multiple releases. For example, for\n" "Python the version is something like 2.5 or 3.0, while the release is\n" "something like 2.5.1 or 3.0a1. If you don't need this dual structure,\n" "just set both to the same value." msgstr "" #: sphinx/cmd/quickstart.py:264 msgid "Project version" msgstr "" #: sphinx/cmd/quickstart.py:266 msgid "Project release" msgstr "" #: sphinx/cmd/quickstart.py:270 msgid "" "If the documents are to be written in a language other than English,\n" "you can select a language here by its language code. Sphinx will then\n" "translate text that it generates into that language.\n" "\n" "For a list of supported codes, see\n" "https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-language." msgstr "" #: sphinx/cmd/quickstart.py:276 msgid "Project language" msgstr "" #: sphinx/cmd/quickstart.py:282 msgid "" "The file name suffix for source files. Commonly, this is either \".txt\"\n" "or \".rst\". Only files with this suffix are considered documents." msgstr "" #: sphinx/cmd/quickstart.py:284 msgid "Source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:288 msgid "" "One document is special in that it is considered the top node of the\n" "\"contents tree\", that is, it is the root of the hierarchical structure\n" "of the documents. Normally, this is \"index\", but if your \"index\"\n" "document is a custom template, you can also set this to another filename." msgstr "" #: sphinx/cmd/quickstart.py:292 msgid "Name of your master document (without suffix)" msgstr "" #: sphinx/cmd/quickstart.py:297 #, python-format msgid "" "Error: the master file %s has already been found in the selected root path." msgstr "" #: sphinx/cmd/quickstart.py:299 msgid "sphinx-quickstart will not overwrite the existing file." msgstr "" #: sphinx/cmd/quickstart.py:301 msgid "" "Please enter a new file name, or rename the existing file and press Enter" msgstr "" #: sphinx/cmd/quickstart.py:305 msgid "Indicate which of the following Sphinx extensions should be enabled:" msgstr "" #: sphinx/cmd/quickstart.py:313 msgid "" "Note: imgmath and mathjax cannot be enabled at the same time. imgmath has " "been deselected." msgstr "" #: sphinx/cmd/quickstart.py:319 msgid "" "A Makefile and a Windows command file can be generated for you so that you\n" "only have to run e.g. `make html' instead of invoking sphinx-build\n" "directly." msgstr "" #: sphinx/cmd/quickstart.py:322 msgid "Create Makefile? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:325 msgid "Create Windows command file? (y/n)" msgstr "" #: sphinx/cmd/quickstart.py:368 sphinx/ext/apidoc.py:90 #, python-format msgid "Creating file %s." msgstr "" #: sphinx/cmd/quickstart.py:373 sphinx/ext/apidoc.py:87 #, python-format msgid "File %s already exists, skipping." msgstr "" #: sphinx/cmd/quickstart.py:415 msgid "Finished: An initial directory structure has been created." msgstr "" #: sphinx/cmd/quickstart.py:417 #, python-format msgid "" "You should now populate your master file %s and create other documentation\n" "source files. " msgstr "" #: sphinx/cmd/quickstart.py:420 msgid "" "Use the Makefile to build the docs, like so:\n" " make builder" msgstr "" #: sphinx/cmd/quickstart.py:423 #, python-format msgid "" "Use the sphinx-build command to build the docs, like so:\n" " sphinx-build -b builder %s %s" msgstr "" #: sphinx/cmd/quickstart.py:425 msgid "" "where \"builder\" is one of the supported builders, e.g. html, latex or " "linkcheck." msgstr "" #: sphinx/cmd/quickstart.py:460 msgid "" "\n" "Generate required files for a Sphinx project.\n" "\n" "sphinx-quickstart is an interactive tool that asks some questions about your\n" "project and then generates a complete documentation directory and sample\n" "Makefile to be used with sphinx-build.\n" msgstr "" #: sphinx/cmd/quickstart.py:475 msgid "quiet mode" msgstr "" #: sphinx/cmd/quickstart.py:480 msgid "project root" msgstr "" #: sphinx/cmd/quickstart.py:482 msgid "Structure options" msgstr "" #: sphinx/cmd/quickstart.py:484 msgid "if specified, separate source and build dirs" msgstr "" #: sphinx/cmd/quickstart.py:486 msgid "if specified, create build dir under source dir" msgstr "" #: sphinx/cmd/quickstart.py:488 msgid "replacement for dot in _templates etc." msgstr "" #: sphinx/cmd/quickstart.py:490 msgid "Project basic options" msgstr "" #: sphinx/cmd/quickstart.py:492 msgid "project name" msgstr "" #: sphinx/cmd/quickstart.py:494 msgid "author names" msgstr "" #: sphinx/cmd/quickstart.py:496 msgid "version of project" msgstr "" #: sphinx/cmd/quickstart.py:498 msgid "release of project" msgstr "" #: sphinx/cmd/quickstart.py:500 msgid "document language" msgstr "" #: sphinx/cmd/quickstart.py:502 msgid "source file suffix" msgstr "" #: sphinx/cmd/quickstart.py:504 msgid "master document name" msgstr "" #: sphinx/cmd/quickstart.py:506 msgid "use epub" msgstr "" #: sphinx/cmd/quickstart.py:508 msgid "Extension options" msgstr "" #: sphinx/cmd/quickstart.py:512 sphinx/ext/apidoc.py:390 #, python-format msgid "enable %s extension" msgstr "" #: sphinx/cmd/quickstart.py:514 sphinx/ext/apidoc.py:386 msgid "enable arbitrary extensions" msgstr "" #: sphinx/cmd/quickstart.py:516 msgid "Makefile and Batchfile creation" msgstr "" #: sphinx/cmd/quickstart.py:518 msgid "create makefile" msgstr "" #: sphinx/cmd/quickstart.py:520 msgid "do not create makefile" msgstr "" #: sphinx/cmd/quickstart.py:522 msgid "create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:525 msgid "do not create batchfile" msgstr "" #: sphinx/cmd/quickstart.py:528 msgid "use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:531 msgid "do not use make-mode for Makefile/make.bat" msgstr "" #: sphinx/cmd/quickstart.py:533 sphinx/ext/apidoc.py:392 msgid "Project templating" msgstr "" #: sphinx/cmd/quickstart.py:536 sphinx/ext/apidoc.py:395 msgid "template directory for template files" msgstr "" #: sphinx/cmd/quickstart.py:539 msgid "define a template variable" msgstr "" #: sphinx/cmd/quickstart.py:572 msgid "\"quiet\" is specified, but any of \"project\" or \"author\" is not specified." msgstr "" #: sphinx/cmd/quickstart.py:586 msgid "" "Error: specified path is not a directory, or sphinx files already exist." msgstr "" #: sphinx/cmd/quickstart.py:588 msgid "" "sphinx-quickstart only generate into a empty directory. Please specify a new" " root path." msgstr "" #: sphinx/cmd/quickstart.py:603 #, python-format msgid "Invalid template variable: %s" msgstr "" #: sphinx/directives/code.py:64 msgid "non-whitespace stripped by dedent" msgstr "" #: sphinx/directives/code.py:83 #, python-format msgid "Invalid caption: %s" msgstr "" #: sphinx/directives/code.py:129 sphinx/directives/code.py:274 #: sphinx/directives/code.py:440 #, python-format msgid "line number spec is out of range(1-%d): %r" msgstr "" #: sphinx/directives/code.py:208 #, python-format msgid "Cannot use both \"%s\" and \"%s\" options" msgstr "" #: sphinx/directives/code.py:220 #, python-format msgid "Include file %r not found or reading it failed" msgstr "" #: sphinx/directives/code.py:223 #, python-format msgid "" "Encoding %r used for reading included file %r seems to be wrong, try giving " "an :encoding: option" msgstr "" #: sphinx/directives/code.py:258 #, python-format msgid "Object named %r not found in include file %r" msgstr "" #: sphinx/directives/code.py:283 msgid "Cannot use \"lineno-match\" with a disjoint set of \"lines\"" msgstr "" #: sphinx/directives/code.py:288 #, python-format msgid "Line spec %r: no lines pulled from include file %r" msgstr "" #: sphinx/directives/other.py:175 msgid "Section author: " msgstr "" #: sphinx/directives/other.py:177 msgid "Module author: " msgstr "" #: sphinx/directives/other.py:179 msgid "Code author: " msgstr "" #: sphinx/directives/other.py:181 msgid "Author: " msgstr "" #: sphinx/directives/patches.py:118 msgid "" "\":file:\" option for csv-table directive now recognizes an absolute path as" " a relative path from source directory. Please update your document." msgstr "" #: sphinx/domains/__init__.py:394 #, python-format msgid "%s %s" msgstr "" #: sphinx/domains/c.py:2008 sphinx/domains/c.py:3290 #, python-format msgid "" "Duplicate C declaration, also defined at %s:%s.\n" "Declaration is '.. c:%s:: %s'." msgstr "" #: sphinx/domains/c.py:3215 #, python-format msgid "%s (C %s)" msgstr "" #: sphinx/domains/c.py:3336 sphinx/domains/cpp.py:7177 #: sphinx/domains/python.py:416 sphinx/ext/napoleon/docstring.py:736 msgid "Parameters" msgstr "" #: sphinx/domains/c.py:3339 sphinx/domains/cpp.py:7183 msgid "Return values" msgstr "" #: sphinx/domains/c.py:3342 sphinx/domains/cpp.py:7186 #: sphinx/domains/javascript.py:231 sphinx/domains/python.py:428 msgid "Returns" msgstr "" #: sphinx/domains/c.py:3344 sphinx/domains/javascript.py:233 #: sphinx/domains/python.py:430 msgid "Return type" msgstr "" #: sphinx/domains/c.py:3740 sphinx/domains/cpp.py:7591 msgid "member" msgstr "" #: sphinx/domains/c.py:3741 msgid "variable" msgstr "" #: sphinx/domains/c.py:3742 sphinx/domains/cpp.py:7590 #: sphinx/domains/javascript.py:340 sphinx/domains/python.py:1164 msgid "function" msgstr "" #: sphinx/domains/c.py:3743 msgid "macro" msgstr "" #: sphinx/domains/c.py:3744 msgid "struct" msgstr "" #: sphinx/domains/c.py:3745 sphinx/domains/cpp.py:7589 msgid "union" msgstr "" #: sphinx/domains/c.py:3746 sphinx/domains/cpp.py:7594 msgid "enum" msgstr "" #: sphinx/domains/c.py:3747 sphinx/domains/cpp.py:7595 msgid "enumerator" msgstr "" #: sphinx/domains/c.py:3748 sphinx/domains/cpp.py:7592 msgid "type" msgstr "" #: sphinx/domains/c.py:3750 sphinx/domains/cpp.py:7597 msgid "function parameter" msgstr "" #: sphinx/domains/changeset.py:28 #, python-format msgid "New in version %s" msgstr "" #: sphinx/domains/changeset.py:29 #, python-format msgid "Changed in version %s" msgstr "" #: sphinx/domains/changeset.py:30 #, python-format msgid "Deprecated since version %s" msgstr "" #: sphinx/domains/citation.py:75 #, python-format msgid "duplicate citation %s, other instance in %s" msgstr "" #: sphinx/domains/citation.py:86 #, python-format msgid "Citation [%s] is not referenced." msgstr "" #: sphinx/domains/cpp.py:4754 sphinx/domains/cpp.py:7132 #, python-format msgid "" "Duplicate C++ declaration, also defined at %s:%s.\n" "Declaration is '.. cpp:%s:: %s'." msgstr "" #: sphinx/domains/cpp.py:6938 msgid "Template Parameters" msgstr "" #: sphinx/domains/cpp.py:7055 #, python-format msgid "%s (C++ %s)" msgstr "" #: sphinx/domains/cpp.py:7180 sphinx/domains/javascript.py:228 msgid "Throws" msgstr "" #: sphinx/domains/cpp.py:7588 sphinx/domains/javascript.py:342 #: sphinx/domains/python.py:1166 msgid "class" msgstr "" #: sphinx/domains/cpp.py:7593 msgid "concept" msgstr "" #: sphinx/domains/cpp.py:7598 msgid "template parameter" msgstr "" #: sphinx/domains/javascript.py:146 #, python-format msgid "%s() (built-in function)" msgstr "" #: sphinx/domains/javascript.py:147 sphinx/domains/python.py:803 #, python-format msgid "%s() (%s method)" msgstr "" #: sphinx/domains/javascript.py:149 #, python-format msgid "%s() (class)" msgstr "" #: sphinx/domains/javascript.py:151 #, python-format msgid "%s (global variable or constant)" msgstr "" #: sphinx/domains/javascript.py:153 sphinx/domains/python.py:888 #, python-format msgid "%s (%s attribute)" msgstr "" #: sphinx/domains/javascript.py:225 msgid "Arguments" msgstr "" #: sphinx/domains/javascript.py:300 #, python-format msgid "%s (module)" msgstr "" #: sphinx/domains/javascript.py:341 sphinx/domains/python.py:1168 msgid "method" msgstr "" #: sphinx/domains/javascript.py:343 sphinx/domains/python.py:1165 msgid "data" msgstr "" #: sphinx/domains/javascript.py:344 sphinx/domains/python.py:1171 msgid "attribute" msgstr "" #: sphinx/domains/javascript.py:345 sphinx/domains/python.py:58 #: sphinx/domains/python.py:1173 msgid "module" msgstr "" #: sphinx/domains/javascript.py:376 #, python-format msgid "duplicate %s description of %s, other %s in %s" msgstr "" #: sphinx/domains/math.py:65 #, python-format msgid "duplicate label of equation %s, other instance in %s" msgstr "" #: sphinx/domains/math.py:119 sphinx/writers/latex.py:2073 #, python-format msgid "Invalid math_eqref_format: %r" msgstr "" #: sphinx/domains/python.py:59 msgid "keyword" msgstr "" #: sphinx/domains/python.py:60 msgid "operator" msgstr "" #: sphinx/domains/python.py:61 msgid "object" msgstr "" #: sphinx/domains/python.py:62 sphinx/domains/python.py:1167 msgid "exception" msgstr "" #: sphinx/domains/python.py:63 msgid "statement" msgstr "" #: sphinx/domains/python.py:64 msgid "built-in function" msgstr "" #: sphinx/domains/python.py:421 msgid "Variables" msgstr "" #: sphinx/domains/python.py:425 msgid "Raises" msgstr "" #: sphinx/domains/python.py:648 sphinx/domains/python.py:792 #, python-format msgid "%s() (in module %s)" msgstr "" #: sphinx/domains/python.py:708 sphinx/domains/python.py:884 #: sphinx/domains/python.py:935 #, python-format msgid "%s (in module %s)" msgstr "" #: sphinx/domains/python.py:710 #, python-format msgid "%s (built-in variable)" msgstr "" #: sphinx/domains/python.py:735 #, python-format msgid "%s (built-in class)" msgstr "" #: sphinx/domains/python.py:736 #, python-format msgid "%s (class in %s)" msgstr "" #: sphinx/domains/python.py:797 #, python-format msgid "%s() (%s class method)" msgstr "" #: sphinx/domains/python.py:799 sphinx/domains/python.py:939 #, python-format msgid "%s (%s property)" msgstr "" #: sphinx/domains/python.py:801 #, python-format msgid "%s() (%s static method)" msgstr "" #: sphinx/domains/python.py:1093 msgid "Python Module Index" msgstr "" #: sphinx/domains/python.py:1094 msgid "modules" msgstr "" #: sphinx/domains/python.py:1143 msgid "Deprecated" msgstr "" #: sphinx/domains/python.py:1169 msgid "class method" msgstr "" #: sphinx/domains/python.py:1170 msgid "static method" msgstr "" #: sphinx/domains/python.py:1172 msgid "property" msgstr "" #: sphinx/domains/python.py:1230 #, python-format msgid "" "duplicate object description of %s, other instance in %s, use :noindex: for " "one of them" msgstr "" #: sphinx/domains/python.py:1350 #, python-format msgid "more than one target found for cross-reference %r: %s" msgstr "" #: sphinx/domains/python.py:1404 msgid " (deprecated)" msgstr "" #: sphinx/domains/rst.py:104 sphinx/domains/rst.py:165 #, python-format msgid "%s (directive)" msgstr "" #: sphinx/domains/rst.py:166 sphinx/domains/rst.py:170 #, python-format msgid ":%s: (directive option)" msgstr "" #: sphinx/domains/rst.py:199 #, python-format msgid "%s (role)" msgstr "" #: sphinx/domains/rst.py:208 msgid "directive" msgstr "" #: sphinx/domains/rst.py:209 msgid "directive-option" msgstr "" #: sphinx/domains/rst.py:210 msgid "role" msgstr "" #: sphinx/domains/rst.py:232 #, python-format msgid "duplicate description of %s %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:101 sphinx/domains/std.py:118 #, python-format msgid "environment variable; %s" msgstr "" #: sphinx/domains/std.py:192 #, python-format msgid "" "Malformed option description %r, should look like \"opt\", \"-opt args\", \"" "--opt args\", \"/opt args\" or \"+opt args\"" msgstr "" #: sphinx/domains/std.py:243 #, python-format msgid "%s command line option" msgstr "" #: sphinx/domains/std.py:245 msgid "command line option" msgstr "" #: sphinx/domains/std.py:371 msgid "glossary term must be preceded by empty line" msgstr "" #: sphinx/domains/std.py:379 msgid "glossary terms must not be separated by empty lines" msgstr "" #: sphinx/domains/std.py:385 sphinx/domains/std.py:398 msgid "glossary seems to be misformatted, check indentation" msgstr "" #: sphinx/domains/std.py:563 msgid "glossary term" msgstr "" #: sphinx/domains/std.py:564 msgid "grammar token" msgstr "" #: sphinx/domains/std.py:565 msgid "reference label" msgstr "" #: sphinx/domains/std.py:567 msgid "environment variable" msgstr "" #: sphinx/domains/std.py:568 msgid "program option" msgstr "" #: sphinx/domains/std.py:569 msgid "document" msgstr "" #: sphinx/domains/std.py:605 msgid "Module Index" msgstr "" #: sphinx/domains/std.py:606 sphinx/themes/basic/defindex.html:25 msgid "Search Page" msgstr "" #: sphinx/domains/std.py:655 sphinx/domains/std.py:764 #: sphinx/ext/autosectionlabel.py:51 #, python-format msgid "duplicate label %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:674 #, python-format msgid "duplicate %s description of %s, other instance in %s" msgstr "" #: sphinx/domains/std.py:870 msgid "numfig is disabled. :numref: is ignored." msgstr "" #: sphinx/domains/std.py:878 #, python-format msgid "Failed to create a cross reference. Any number is not assigned: %s" msgstr "" #: sphinx/domains/std.py:890 #, python-format msgid "the link has no caption: %s" msgstr "" #: sphinx/domains/std.py:904 #, python-format msgid "invalid numfig_format: %s (%r)" msgstr "" #: sphinx/domains/std.py:907 #, python-format msgid "invalid numfig_format: %s" msgstr "" #: sphinx/domains/std.py:1120 #, python-format msgid "undefined label: %s" msgstr "" #: sphinx/domains/std.py:1122 #, python-format msgid "Failed to create a cross reference. A title or caption not found: %s" msgstr "" #: sphinx/environment/__init__.py:76 msgid "new config" msgstr "" #: sphinx/environment/__init__.py:77 msgid "config changed" msgstr "" #: sphinx/environment/__init__.py:78 msgid "extensions changed" msgstr "" #: sphinx/environment/__init__.py:205 msgid "build environment version not current" msgstr "" #: sphinx/environment/__init__.py:207 msgid "source directory has changed" msgstr "" #: sphinx/environment/__init__.py:286 msgid "" "This environment is incompatible with the selected builder, please choose " "another doctree directory." msgstr "" #: sphinx/environment/__init__.py:385 #, python-format msgid "Failed to scan documents in %s: %r" msgstr "" #: sphinx/environment/__init__.py:512 #, python-format msgid "Domain %r is not registered" msgstr "" #: sphinx/environment/__init__.py:593 msgid "self referenced toctree found. Ignored." msgstr "" #: sphinx/environment/__init__.py:635 msgid "document isn't included in any toctree" msgstr "" #: sphinx/environment/adapters/indexentries.py:78 #, python-format msgid "see %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:82 #, python-format msgid "see also %s" msgstr "" #: sphinx/environment/adapters/indexentries.py:85 #, python-format msgid "unknown index entry type %r" msgstr "" #: sphinx/environment/adapters/indexentries.py:174 #: sphinx/templates/latex/sphinxmessages.sty_t:11 msgid "Symbols" msgstr "" #: sphinx/environment/adapters/toctree.py:151 #, python-format msgid "circular toctree references detected, ignoring: %s <- %s" msgstr "" #: sphinx/environment/adapters/toctree.py:170 #, python-format msgid "" "toctree contains reference to document %r that doesn't have a title: no link" " will be generated" msgstr "" #: sphinx/environment/adapters/toctree.py:176 #, python-format msgid "toctree contains reference to excluded document %r" msgstr "" #: sphinx/environment/adapters/toctree.py:178 #, python-format msgid "toctree contains reference to nonexisting document %r" msgstr "" #: sphinx/environment/collectors/asset.py:90 #, python-format msgid "image file not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:109 #, python-format msgid "image file %s not readable: %s" msgstr "" #: sphinx/environment/collectors/asset.py:135 #, python-format msgid "download file not readable: %s" msgstr "" #: sphinx/environment/collectors/toctree.py:185 #, python-format msgid "%s is already assigned section numbers (nested numbered toctree?)" msgstr "" #: sphinx/ext/apidoc.py:83 #, python-format msgid "Would create file %s." msgstr "" #: sphinx/ext/apidoc.py:308 msgid "" "\n" "Look recursively in <MODULE_PATH> for Python modules and packages and create\n" "one reST file with automodule directives per package in the <OUTPUT_PATH>.\n" "\n" "The <EXCLUDE_PATTERN>s can be file and/or directory patterns that will be\n" "excluded from generation.\n" "\n" "Note: By default this script will not overwrite already created files." msgstr "" #: sphinx/ext/apidoc.py:321 msgid "path to module to document" msgstr "" #: sphinx/ext/apidoc.py:323 msgid "" "fnmatch-style file and/or directory patterns to exclude from generation" msgstr "" #: sphinx/ext/apidoc.py:328 msgid "directory to place all output" msgstr "" #: sphinx/ext/apidoc.py:333 msgid "maximum depth of submodules to show in the TOC (default: 4)" msgstr "" #: sphinx/ext/apidoc.py:336 msgid "overwrite existing files" msgstr "" #: sphinx/ext/apidoc.py:339 msgid "" "follow symbolic links. Powerful when combined with " "collective.recipe.omelette." msgstr "" #: sphinx/ext/apidoc.py:342 msgid "run the script without creating files" msgstr "" #: sphinx/ext/apidoc.py:345 msgid "put documentation for each module on its own page" msgstr "" #: sphinx/ext/apidoc.py:348 msgid "include \"_private\" modules" msgstr "" #: sphinx/ext/apidoc.py:350 msgid "filename of table of contents (default: modules)" msgstr "" #: sphinx/ext/apidoc.py:352 msgid "don't create a table of contents file" msgstr "" #: sphinx/ext/apidoc.py:355 msgid "" "don't create headings for the module/package packages (e.g. when the " "docstrings already contain them)" msgstr "" #: sphinx/ext/apidoc.py:360 msgid "put module documentation before submodule documentation" msgstr "" #: sphinx/ext/apidoc.py:364 msgid "" "interpret module paths according to PEP-0420 implicit namespaces " "specification" msgstr "" #: sphinx/ext/apidoc.py:368 msgid "file suffix (default: rst)" msgstr "" #: sphinx/ext/apidoc.py:370 msgid "generate a full project with sphinx-quickstart" msgstr "" #: sphinx/ext/apidoc.py:373 msgid "append module_path to sys.path, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:375 msgid "project name (default: root module name)" msgstr "" #: sphinx/ext/apidoc.py:377 msgid "project author(s), used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:379 msgid "project version, used when --full is given" msgstr "" #: sphinx/ext/apidoc.py:381 msgid "project release, used when --full is given, defaults to --doc-version" msgstr "" #: sphinx/ext/apidoc.py:384 msgid "extension options" msgstr "" #: sphinx/ext/apidoc.py:417 #, python-format msgid "%s is not a directory." msgstr "" #: sphinx/ext/coverage.py:43 #, python-format msgid "invalid regex %r in %s" msgstr "" #: sphinx/ext/coverage.py:52 #, python-format msgid "" "Testing of coverage in the sources finished, look at the results in " "%(outdir)spython.txt." msgstr "" #: sphinx/ext/coverage.py:66 #, python-format msgid "invalid regex %r in coverage_c_regexes" msgstr "" #: sphinx/ext/coverage.py:127 #, python-format msgid "undocumented c api: %s [%s] in file %s" msgstr "" #: sphinx/ext/coverage.py:159 #, python-format msgid "module %s could not be imported: %s" msgstr "" #: sphinx/ext/coverage.py:255 #, python-format msgid "undocumented python function: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:271 #, python-format msgid "undocumented python class: %s :: %s" msgstr "" #: sphinx/ext/coverage.py:284 #, python-format msgid "undocumented python method: %s :: %s :: %s" msgstr "" #: sphinx/ext/doctest.py:123 #, python-format msgid "missing '+' or '-' in '%s' option." msgstr "" #: sphinx/ext/doctest.py:128 #, python-format msgid "'%s' is not a valid option." msgstr "" #: sphinx/ext/doctest.py:142 #, python-format msgid "'%s' is not a valid pyversion option" msgstr "" #: sphinx/ext/doctest.py:225 msgid "invalid TestCode type" msgstr "" #: sphinx/ext/doctest.py:283 #, python-format msgid "" "Testing of doctests in the sources finished, look at the results in " "%(outdir)s/output.txt." msgstr "" #: sphinx/ext/doctest.py:433 #, python-format msgid "no code/output in %s block at %s:%s" msgstr "" #: sphinx/ext/doctest.py:519 #, python-format msgid "ignoring invalid doctest code: %r" msgstr "" #: sphinx/ext/duration.py:79 msgid "" "====================== slowest reading durations =======================" msgstr "" #: sphinx/ext/graphviz.py:132 msgid "Graphviz directive cannot have both content and a filename argument" msgstr "" #: sphinx/ext/graphviz.py:142 #, python-format msgid "External Graphviz file %r not found or reading it failed" msgstr "" #: sphinx/ext/graphviz.py:149 msgid "Ignoring \"graphviz\" directive without content." msgstr "" #: sphinx/ext/graphviz.py:257 #, python-format msgid "" "dot did not produce an output file:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:261 #, python-format msgid "" "dot command %r cannot be run (needed for graphviz output), check the " "graphviz_dot setting" msgstr "" #: sphinx/ext/graphviz.py:268 #, python-format msgid "" "dot exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/graphviz.py:278 #, python-format msgid "graphviz_output_format must be one of 'png', 'svg', but is %r" msgstr "" #: sphinx/ext/graphviz.py:282 sphinx/ext/graphviz.py:334 #: sphinx/ext/graphviz.py:371 #, python-format msgid "dot code %r: %s" msgstr "" #: sphinx/ext/graphviz.py:384 sphinx/ext/graphviz.py:392 #, python-format msgid "[graph: %s]" msgstr "" #: sphinx/ext/graphviz.py:386 sphinx/ext/graphviz.py:394 msgid "[graph]" msgstr "" #: sphinx/ext/imgconverter.py:41 #, python-format msgid "" "convert command %r cannot be run, check the image_converter setting: %s" msgstr "" #: sphinx/ext/imgconverter.py:46 sphinx/ext/imgconverter.py:70 #, python-format msgid "" "convert exited with error:\n" "[stderr]\n" "%r\n" "[stdout]\n" "%r" msgstr "" #: sphinx/ext/imgconverter.py:65 #, python-format msgid "convert command %r cannot be run, check the image_converter setting" msgstr "" #: sphinx/ext/imgmath.py:141 #, python-format msgid "" "LaTeX command %r cannot be run (needed for math display), check the " "imgmath_latex setting" msgstr "" #: sphinx/ext/imgmath.py:155 #, python-format msgid "" "%s command %r cannot be run (needed for math display), check the imgmath_%s " "setting" msgstr "" #: sphinx/ext/imgmath.py:300 #, python-format msgid "display latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:326 #, python-format msgid "inline latex %r: %s" msgstr "" #: sphinx/ext/imgmath.py:333 sphinx/ext/mathjax.py:52 msgid "Permalink to this equation" msgstr "" #: sphinx/ext/intersphinx.py:173 #, python-format msgid "intersphinx inventory has moved: %s -> %s" msgstr "" #: sphinx/ext/intersphinx.py:204 #, python-format msgid "loading intersphinx inventory from %s..." msgstr "" #: sphinx/ext/intersphinx.py:218 msgid "" "encountered some issues with some of the inventories, but they had working " "alternatives:" msgstr "" #: sphinx/ext/intersphinx.py:224 msgid "failed to reach any of the inventories with the following issues:" msgstr "" #: sphinx/ext/intersphinx.py:334 #, python-format msgid "(in %s v%s)" msgstr "" #: sphinx/ext/intersphinx.py:336 #, python-format msgid "(in %s)" msgstr "" #: sphinx/ext/intersphinx.py:369 #, python-format msgid "intersphinx identifier %r is not string. Ignored" msgstr "" #: sphinx/ext/intersphinx.py:382 #, python-format msgid "Failed to read intersphinx_mapping[%s], ignored: %r" msgstr "" #: sphinx/ext/linkcode.py:70 sphinx/ext/viewcode.py:188 msgid "[source]" msgstr "" #: sphinx/ext/todo.py:68 msgid "Todo" msgstr "" #: sphinx/ext/todo.py:101 #, python-format msgid "TODO entry found: %s" msgstr "" #: sphinx/ext/todo.py:159 msgid "<<original entry>>" msgstr "" #: sphinx/ext/todo.py:161 #, python-format msgid "(The <<original entry>> is located in %s, line %d.)" msgstr "" #: sphinx/ext/todo.py:171 msgid "original entry" msgstr "" #: sphinx/ext/viewcode.py:257 msgid "highlighting module code... " msgstr "" #: sphinx/ext/viewcode.py:289 msgid "[docs]" msgstr "" #: sphinx/ext/viewcode.py:303 msgid "Module code" msgstr "" #: sphinx/ext/viewcode.py:309 #, python-format msgid "<h1>Source code for %s</h1>" msgstr "" #: sphinx/ext/viewcode.py:336 msgid "Overview: module code" msgstr "" #: sphinx/ext/viewcode.py:337 msgid "<h1>All modules for which code is available</h1>" msgstr "" #: sphinx/ext/autodoc/__init__.py:132 #, python-format msgid "invalid value for member-order option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:140 #, python-format msgid "invalid value for class-doc-from option: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:401 #, python-format msgid "invalid signature for auto%s (%r)" msgstr "" #: sphinx/ext/autodoc/__init__.py:518 #, python-format msgid "error while formatting arguments for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:663 sphinx/ext/autodoc/__init__.py:1683 #, python-format msgid "missing attribute %s in object %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:813 #, python-format msgid "" "autodoc: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autodoc/__init__.py:906 #, python-format msgid "" "don't know which module to import for autodocumenting %r (try placing a " "\"module\" or \"currentmodule\" directive in the document, or giving an " "explicit module name)" msgstr "" #: sphinx/ext/autodoc/__init__.py:950 #, python-format msgid "A mocked object is detected: %r" msgstr "" #: sphinx/ext/autodoc/__init__.py:969 #, python-format msgid "error while formatting signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1019 msgid "\"::\" in automodule name doesn't make sense" msgstr "" #: sphinx/ext/autodoc/__init__.py:1026 #, python-format msgid "signature arguments or return annotation given for automodule %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1039 #, python-format msgid "" "__all__ should be a list of strings, not %r (in module %s) -- ignoring " "__all__" msgstr "" #: sphinx/ext/autodoc/__init__.py:1105 #, python-format msgid "" "missing attribute mentioned in :members: option: module %s, attribute %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1304 sphinx/ext/autodoc/__init__.py:1378 #: sphinx/ext/autodoc/__init__.py:2743 #, python-format msgid "Failed to get a function signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1569 #, python-format msgid "Failed to get a constructor signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1670 #, python-format msgid "Bases: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1756 sphinx/ext/autodoc/__init__.py:1829 #: sphinx/ext/autodoc/__init__.py:1848 #, python-format msgid "alias of %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:1890 #, python-format msgid "alias of TypeVar(%s)" msgstr "" #: sphinx/ext/autodoc/__init__.py:2123 sphinx/ext/autodoc/__init__.py:2217 #, python-format msgid "Failed to get a method signature for %s: %s" msgstr "" #: sphinx/ext/autodoc/__init__.py:2348 #, python-format msgid "Invalid __slots__ found on %s. Ignored." msgstr "" #: sphinx/ext/autodoc/__init__.py:2786 msgid "" "autodoc_member_order now accepts \"alphabetical\" instead of \"alphabetic\"." " Please update your setting." msgstr "" #: sphinx/ext/autodoc/preserve_defaults.py:78 #, python-format msgid "Failed to parse a default argument value for %r: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:130 #, python-format msgid "Failed to update signature for %r: parameter not found: %s" msgstr "" #: sphinx/ext/autodoc/type_comment.py:133 #, python-format msgid "Failed to parse type_comment for %r: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:280 #, python-format msgid "autosummary references excluded document %r. Ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:282 #, python-format msgid "" "autosummary: stub file not found %r. Check your autosummary_generate " "setting." msgstr "" #: sphinx/ext/autosummary/__init__.py:301 msgid "A captioned autosummary requires :toctree: option. ignored." msgstr "" #: sphinx/ext/autosummary/__init__.py:348 #, python-format msgid "autosummary: failed to import %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:362 #, python-format msgid "failed to parse name %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:367 #, python-format msgid "failed to import object %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:782 #, python-format msgid "autosummary_generate: file not found: %s" msgstr "" #: sphinx/ext/autosummary/__init__.py:790 msgid "" "autosummary generats .rst files internally. But your source_suffix does not " "contain .rst. Skipped." msgstr "" #: sphinx/ext/autosummary/generate.py:188 #: sphinx/ext/autosummary/generate.py:237 #, python-format msgid "" "autosummary: failed to determine %r to be documented, the following exception was raised:\n" "%s" msgstr "" #: sphinx/ext/autosummary/generate.py:384 #, python-format msgid "[autosummary] generating autosummary for: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:388 #, python-format msgid "[autosummary] writing to %s" msgstr "" #: sphinx/ext/autosummary/generate.py:425 #, python-format msgid "[autosummary] failed to import %r: %s" msgstr "" #: sphinx/ext/autosummary/generate.py:599 msgid "" "\n" "Generate ReStructuredText using autosummary directives.\n" "\n" "sphinx-autogen is a frontend to sphinx.ext.autosummary.generate. It generates\n" "the reStructuredText files from the autosummary directives contained in the\n" "given input files.\n" "\n" "The format of the autosummary directive is documented in the\n" "``sphinx.ext.autosummary`` Python module and can be read using::\n" "\n" " pydoc sphinx.ext.autosummary\n" msgstr "" #: sphinx/ext/autosummary/generate.py:616 msgid "source files to generate rST files for" msgstr "" #: sphinx/ext/autosummary/generate.py:620 msgid "directory to place all output in" msgstr "" #: sphinx/ext/autosummary/generate.py:623 #, python-format msgid "default suffix for files (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:627 #, python-format msgid "custom template directory (default: %(default)s)" msgstr "" #: sphinx/ext/autosummary/generate.py:631 #, python-format msgid "document imported members (default: %(default)s)" msgstr "" #: sphinx/ext/napoleon/__init__.py:347 sphinx/ext/napoleon/docstring.py:703 msgid "Keyword Arguments" msgstr "" #: sphinx/ext/napoleon/docstring.py:657 msgid "Example" msgstr "" #: sphinx/ext/napoleon/docstring.py:658 msgid "Examples" msgstr "" #: sphinx/ext/napoleon/docstring.py:718 msgid "Notes" msgstr "" #: sphinx/ext/napoleon/docstring.py:727 msgid "Other Parameters" msgstr "" #: sphinx/ext/napoleon/docstring.py:763 msgid "Receives" msgstr "" #: sphinx/ext/napoleon/docstring.py:767 msgid "References" msgstr "" #: sphinx/ext/napoleon/docstring.py:801 msgid "Warns" msgstr "" #: sphinx/ext/napoleon/docstring.py:805 msgid "Yields" msgstr "" #: sphinx/ext/napoleon/docstring.py:973 #, python-format msgid "invalid value set (missing closing brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:980 #, python-format msgid "invalid value set (missing opening brace): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:987 #, python-format msgid "malformed string literal (missing closing quote): %s" msgstr "" #: sphinx/ext/napoleon/docstring.py:994 #, python-format msgid "malformed string literal (missing opening quote): %s" msgstr "" #: sphinx/locale/__init__.py:252 msgid "Attention" msgstr "" #: sphinx/locale/__init__.py:253 msgid "Caution" msgstr "" #: sphinx/locale/__init__.py:254 msgid "Danger" msgstr "" #: sphinx/locale/__init__.py:255 msgid "Error" msgstr "" #: sphinx/locale/__init__.py:256 msgid "Hint" msgstr "" #: sphinx/locale/__init__.py:257 msgid "Important" msgstr "" #: sphinx/locale/__init__.py:258 msgid "Note" msgstr "" #: sphinx/locale/__init__.py:259 msgid "See also" msgstr "" #: sphinx/locale/__init__.py:260 msgid "Tip" msgstr "" #: sphinx/locale/__init__.py:261 msgid "Warning" msgstr "" #: sphinx/templates/latex/longtable.tex_t:23 #: sphinx/templates/latex/sphinxmessages.sty_t:8 msgid "continued from previous page" msgstr "" #: sphinx/templates/latex/longtable.tex_t:29 #: sphinx/templates/latex/sphinxmessages.sty_t:9 msgid "continues on next page" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:10 msgid "Non-alphabetical" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:12 msgid "Numbers" msgstr "" #: sphinx/templates/latex/sphinxmessages.sty_t:13 msgid "page" msgstr "" #: sphinx/themes/agogo/layout.html:38 sphinx/themes/basic/globaltoc.html:10 #: sphinx/themes/basic/localtoc.html:11 sphinx/themes/scrolls/layout.html:41 msgid "Table of Contents" msgstr "" #: sphinx/themes/agogo/layout.html:43 sphinx/themes/basic/layout.html:150 #: sphinx/themes/basic/search.html:11 sphinx/themes/basic/search.html:22 msgid "Search" msgstr "" #: sphinx/themes/agogo/layout.html:46 sphinx/themes/basic/searchbox.html:16 msgid "Go" msgstr "" #: sphinx/themes/agogo/layout.html:90 sphinx/themes/basic/sourcelink.html:15 msgid "Show Source" msgstr "" #: sphinx/themes/basic/defindex.html:11 msgid "Overview" msgstr "" #: sphinx/themes/basic/defindex.html:15 msgid "Welcome! This is" msgstr "" #: sphinx/themes/basic/defindex.html:16 msgid "the documentation for" msgstr "" #: sphinx/themes/basic/defindex.html:17 msgid "last updated" msgstr "" #: sphinx/themes/basic/defindex.html:20 msgid "Indices and tables:" msgstr "" #: sphinx/themes/basic/defindex.html:23 msgid "Complete Table of Contents" msgstr "" #: sphinx/themes/basic/defindex.html:24 msgid "lists all sections and subsections" msgstr "" #: sphinx/themes/basic/defindex.html:26 msgid "search this documentation" msgstr "" #: sphinx/themes/basic/defindex.html:28 msgid "Global Module Index" msgstr "" #: sphinx/themes/basic/defindex.html:29 msgid "quick access to all modules" msgstr "" #: sphinx/themes/basic/defindex.html:31 msgid "all functions, classes, terms" msgstr "" #: sphinx/themes/basic/genindex-single.html:33 #, python-format msgid "Index – %(key)s" msgstr "" #: sphinx/themes/basic/genindex-single.html:61 #: sphinx/themes/basic/genindex-split.html:24 #: sphinx/themes/basic/genindex-split.html:38 #: sphinx/themes/basic/genindex.html:73 msgid "Full index on one page" msgstr "" #: sphinx/themes/basic/genindex-split.html:16 msgid "Index pages by letter" msgstr "" #: sphinx/themes/basic/genindex-split.html:25 msgid "can be huge" msgstr "" #: sphinx/themes/basic/layout.html:29 msgid "Navigation" msgstr "" #: sphinx/themes/basic/layout.html:135 #, python-format msgid "Search within %(docstitle)s" msgstr "" #: sphinx/themes/basic/layout.html:144 msgid "About these documents" msgstr "" #: sphinx/themes/basic/layout.html:153 msgid "Copyright" msgstr "" #: sphinx/themes/basic/layout.html:199 #, python-format msgid "© <a href=\"%(path)s\">Copyright</a> %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:201 #, python-format msgid "© Copyright %(copyright)s." msgstr "" #: sphinx/themes/basic/layout.html:205 #, python-format msgid "Last updated on %(last_updated)s." msgstr "" #: sphinx/themes/basic/layout.html:208 #, python-format msgid "" "Created using <a href=\"https://www.sphinx-doc.org/\">Sphinx</a> " "%(sphinx_version)s." msgstr "" #: sphinx/themes/basic/opensearch.xml:4 #, python-format msgid "Search %(docstitle)s" msgstr "" #: sphinx/themes/basic/relations.html:11 msgid "Previous topic" msgstr "" #: sphinx/themes/basic/relations.html:13 msgid "previous chapter" msgstr "" #: sphinx/themes/basic/relations.html:16 msgid "Next topic" msgstr "" #: sphinx/themes/basic/relations.html:18 msgid "next chapter" msgstr "" #: sphinx/themes/basic/search.html:27 msgid "" "Please activate JavaScript to enable the search\n" " functionality." msgstr "" #: sphinx/themes/basic/search.html:35 msgid "" "Searching for multiple words only shows matches that contain\n" " all words." msgstr "" #: sphinx/themes/basic/search.html:42 msgid "search" msgstr "" #: sphinx/themes/basic/search.html:48 #: sphinx/themes/basic/static/searchtools.js:306 msgid "Search Results" msgstr "" #: sphinx/themes/basic/search.html:50 #: sphinx/themes/basic/static/searchtools.js:308 msgid "" "Your search did not match any documents. Please make sure that all words are" " spelled correctly and that you've selected enough categories." msgstr "" #: sphinx/themes/basic/searchbox.html:12 msgid "Quick search" msgstr "" #: sphinx/themes/basic/sourcelink.html:12 msgid "This Page" msgstr "" #: sphinx/themes/basic/changes/frameset.html:5 #: sphinx/themes/basic/changes/versionchanges.html:12 #, python-format msgid "Changes in Version %(version)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/rstsource.html:5 #, python-format msgid "%(filename)s — %(docstitle)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:17 #, python-format msgid "Automatically generated list of changes in version %(version)s" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:18 msgid "Library changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:23 msgid "C API changes" msgstr "" #: sphinx/themes/basic/changes/versionchanges.html:25 msgid "Other changes" msgstr "" #: sphinx/themes/basic/static/doctools.js:199 sphinx/writers/html.py:437 #: sphinx/writers/html.py:442 sphinx/writers/html5.py:388 #: sphinx/writers/html5.py:393 msgid "Permalink to this headline" msgstr "" #: sphinx/themes/basic/static/doctools.js:205 sphinx/writers/html.py:132 #: sphinx/writers/html.py:141 sphinx/writers/html5.py:103 #: sphinx/writers/html5.py:112 msgid "Permalink to this definition" msgstr "" #: sphinx/themes/basic/static/doctools.js:238 msgid "Hide Search Matches" msgstr "" #: sphinx/themes/basic/static/searchtools.js:136 msgid "Searching" msgstr "" #: sphinx/themes/basic/static/searchtools.js:141 msgid "Preparing search..." msgstr "" #: sphinx/themes/basic/static/searchtools.js:310 #, python-format msgid "Search finished, found %s page(s) matching the search query." msgstr "" #: sphinx/themes/basic/static/searchtools.js:365 msgid ", in " msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:83 msgid "Expand sidebar" msgstr "" #: sphinx/themes/classic/static/sidebar.js_t:96 #: sphinx/themes/classic/static/sidebar.js_t:124 msgid "Collapse sidebar" msgstr "" #: sphinx/themes/haiku/layout.html:24 msgid "Contents" msgstr "" #: sphinx/transforms/__init__.py:224 #, python-format msgid "" "4 column based index found. It might be a bug of extensions you use: %r" msgstr "" #: sphinx/transforms/__init__.py:263 #, python-format msgid "Footnote [%s] is not referenced." msgstr "" #: sphinx/transforms/__init__.py:269 msgid "Footnote [#] is not referenced." msgstr "" #: sphinx/transforms/i18n.py:304 sphinx/transforms/i18n.py:375 msgid "" "inconsistent footnote references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:347 msgid "" "inconsistent references in translated message. original: {0}, translated: " "{1}" msgstr "" #: sphinx/transforms/i18n.py:394 msgid "" "inconsistent citation references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/i18n.py:414 msgid "" "inconsistent term references in translated message. original: {0}, " "translated: {1}" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:118 msgid "" "Could not determine the fallback text for the cross-reference. Might be a " "bug." msgstr "" #: sphinx/transforms/post_transforms/__init__.py:158 #, python-format msgid "more than one target found for 'any' cross-reference %r: could be %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:206 #, python-format msgid "%s:%s reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/__init__.py:209 #, python-format msgid "%r reference target not found: %s" msgstr "" #: sphinx/transforms/post_transforms/images.py:83 #, python-format msgid "Could not fetch remote image: %s [%d]" msgstr "" #: sphinx/transforms/post_transforms/images.py:111 #, python-format msgid "Could not fetch remote image: %s [%s]" msgstr "" #: sphinx/transforms/post_transforms/images.py:129 #, python-format msgid "Unknown image format: %s..." msgstr "" #: sphinx/util/__init__.py:284 #, python-format msgid "undecodable source characters, replacing with \"?\": %r" msgstr "" #: sphinx/util/__init__.py:532 msgid "skipped" msgstr "" #: sphinx/util/__init__.py:537 msgid "failed" msgstr "" #: sphinx/util/docutils.py:213 #, python-format msgid "unknown directive or role name: %s:%s" msgstr "" #: sphinx/util/i18n.py:67 #, python-format msgid "reading error: %s, %s" msgstr "" #: sphinx/util/i18n.py:74 #, python-format msgid "writing error: %s, %s" msgstr "" #: sphinx/util/i18n.py:98 #, python-format msgid "locale_dir %s does not exists" msgstr "" #: sphinx/util/i18n.py:192 #, python-format msgid "" "Invalid date format. Quote the string by single quote if you want to output " "it directly: %s" msgstr "" #: sphinx/util/nodes.py:424 #, python-format msgid "toctree contains ref to nonexisting file %r" msgstr "" #: sphinx/util/nodes.py:610 #, python-format msgid "exception while evaluating only directive expression: %s" msgstr "" #: sphinx/util/rst.py:77 #, python-format msgid "default role %s not found" msgstr "" #: sphinx/writers/html.py:330 sphinx/writers/html5.py:301 #, python-format msgid "numfig_format is not defined for %s" msgstr "" #: sphinx/writers/html.py:340 sphinx/writers/html5.py:311 #, python-format msgid "Any IDs not assigned for %s node" msgstr "" #: sphinx/writers/html.py:414 sphinx/writers/html5.py:365 msgid "Permalink to this term" msgstr "" #: sphinx/writers/html.py:446 sphinx/writers/html5.py:397 msgid "Permalink to this table" msgstr "" #: sphinx/writers/html.py:489 sphinx/writers/html5.py:440 msgid "Permalink to this code" msgstr "" #: sphinx/writers/html.py:491 sphinx/writers/html5.py:442 msgid "Permalink to this image" msgstr "" #: sphinx/writers/html.py:493 sphinx/writers/html5.py:444 msgid "Permalink to this toctree" msgstr "" #: sphinx/writers/html.py:625 sphinx/writers/html5.py:565 msgid "Could not obtain image size. :scale: option is ignored." msgstr "" #: sphinx/writers/latex.py:347 #, python-format msgid "unknown %r toplevel_sectioning for class %r" msgstr "" #: sphinx/writers/latex.py:398 msgid "too large :maxdepth:, ignored." msgstr "" #: sphinx/writers/latex.py:644 msgid "document title is not a single Text node" msgstr "" #: sphinx/writers/latex.py:676 sphinx/writers/texinfo.py:622 msgid "" "encountered title node not in section, topic, table, admonition or sidebar" msgstr "" #: sphinx/writers/latex.py:848 sphinx/writers/manpage.py:247 #: sphinx/writers/texinfo.py:637 msgid "Footnotes" msgstr "" #: sphinx/writers/latex.py:907 msgid "" "both tabularcolumns and :widths: option are given. :widths: is ignored." msgstr "" #: sphinx/writers/latex.py:1238 #, python-format msgid "dimension unit %s is invalid. Ignored." msgstr "" #: sphinx/writers/latex.py:1551 #, python-format msgid "unknown index entry type %s found" msgstr "" #: sphinx/writers/manpage.py:296 sphinx/writers/text.py:803 #, python-format msgid "[image: %s]" msgstr "" #: sphinx/writers/manpage.py:297 sphinx/writers/text.py:804 msgid "[image]" msgstr "" #: sphinx/writers/texinfo.py:1181 msgid "caption not inside a figure." msgstr "" #: sphinx/writers/texinfo.py:1265 #, python-format msgid "unimplemented node type: %r" msgstr "" #: sphinx/writers/texinfo.py:1269 #, python-format msgid "unknown node type: %r" msgstr "" �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/parsers.py����������������������������������������������������������������������0000644�0000766�0000024�00000007473�00000000000�015710� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.parsers ~~~~~~~~~~~~~~ A Base class for additional parsers. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import warnings from typing import TYPE_CHECKING, Any, Dict, List, Type, Union import docutils.parsers import docutils.parsers.rst from docutils import nodes from docutils.parsers.rst import states from docutils.statemachine import StringList from docutils.transforms import Transform from docutils.transforms.universal import SmartQuotes from sphinx.deprecation import RemovedInSphinx50Warning from sphinx.util.rst import append_epilog, prepend_prolog if TYPE_CHECKING: from sphinx.application import Sphinx class Parser(docutils.parsers.Parser): """ A base class of source parsers. The additional parsers should inherit this class instead of ``docutils.parsers.Parser``. Compared with ``docutils.parsers.Parser``, this class improves accessibility to Sphinx APIs. The subclasses can access the following objects and functions: self.app The application object (:class:`sphinx.application.Sphinx`) self.config The config object (:class:`sphinx.config.Config`) self.env The environment object (:class:`sphinx.environment.BuildEnvironment`) self.warn() Emit a warning. (Same as :meth:`sphinx.application.Sphinx.warn()`) self.info() Emit an info message. (Same as :meth:`sphinx.application.Sphinx.info()`) .. deprecated:: 1.6 ``warn()`` and ``info()`` is deprecated. Use :mod:`sphinx.util.logging` instead. .. deprecated:: 3.0 parser.app is deprecated. """ def set_application(self, app: "Sphinx") -> None: """set_application will be called from Sphinx to set app and other instance variables :param sphinx.application.Sphinx app: Sphinx application object """ self._app = app self.config = app.config self.env = app.env @property def app(self) -> "Sphinx": warnings.warn('parser.app is deprecated.', RemovedInSphinx50Warning, stacklevel=2) return self._app class RSTParser(docutils.parsers.rst.Parser, Parser): """A reST parser for Sphinx.""" def get_transforms(self) -> List[Type[Transform]]: """ Sphinx's reST parser replaces a transform class for smart-quotes by its own refs: sphinx.io.SphinxStandaloneReader """ transforms = super().get_transforms() transforms.remove(SmartQuotes) return transforms def parse(self, inputstring: Union[str, StringList], document: nodes.document) -> None: """Parse text and generate a document tree.""" self.setup_parse(inputstring, document) # type: ignore self.statemachine = states.RSTStateMachine( state_classes=self.state_classes, initial_state=self.initial_state, debug=document.reporter.debug_flag) # preprocess inputstring if isinstance(inputstring, str): lines = docutils.statemachine.string2lines( inputstring, tab_width=document.settings.tab_width, convert_whitespace=True) inputlines = StringList(lines, document.current_source) else: inputlines = inputstring self.decorate(inputlines) self.statemachine.run(inputlines, document, inliner=self.inliner) self.finish_parse() def decorate(self, content: StringList) -> None: """Preprocess reST content before parsing.""" prepend_prolog(content, self.config.rst_prolog) append_epilog(content, self.config.rst_epilog) def setup(app: "Sphinx") -> Dict[str, Any]: app.add_source_parser(RSTParser) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/project.py����������������������������������������������������������������������0000644�0000766�0000024�00000006713�00000000000�015673� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.project ~~~~~~~~~~~~~~ Utility function and classes for Sphinx projects. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import os from glob import glob from typing import Dict, List, Optional, Set from sphinx.locale import __ from sphinx.util import get_matching_files, logging, path_stabilize from sphinx.util.matching import compile_matchers from sphinx.util.osutil import SEP, relpath logger = logging.getLogger(__name__) EXCLUDE_PATHS = ['**/_sources', '.#*', '**/.#*', '*.lproj/**'] class Project: """A project is the source code set of the Sphinx document(s).""" def __init__(self, srcdir: str, source_suffix: Dict[str, str]) -> None: #: Source directory. self.srcdir = srcdir #: source_suffix. Same as :confval:`source_suffix`. self.source_suffix = source_suffix #: The name of documents belongs to this project. self.docnames: Set[str] = set() def restore(self, other: "Project") -> None: """Take over a result of last build.""" self.docnames = other.docnames def discover(self, exclude_paths: List[str] = []) -> Set[str]: """Find all document files in the source directory and put them in :attr:`docnames`. """ self.docnames = set() excludes = compile_matchers(exclude_paths + EXCLUDE_PATHS) for filename in get_matching_files(self.srcdir, excludes): # type: ignore docname = self.path2doc(filename) if docname: if docname in self.docnames: pattern = os.path.join(self.srcdir, docname) + '.*' files = [relpath(f, self.srcdir) for f in glob(pattern)] logger.warning(__('multiple files found for the document "%s": %r\n' 'Use %r for the build.'), docname, files, self.doc2path(docname), once=True) elif os.access(os.path.join(self.srcdir, filename), os.R_OK): self.docnames.add(docname) else: logger.warning(__("document not readable. Ignored."), location=docname) return self.docnames def path2doc(self, filename: str) -> Optional[str]: """Return the docname for the filename if the file is a document. *filename* should be absolute or relative to the source directory. """ if filename.startswith(self.srcdir): filename = relpath(filename, self.srcdir) for suffix in self.source_suffix: if filename.endswith(suffix): filename = path_stabilize(filename) return filename[:-len(suffix)] # the file does not have docname return None def doc2path(self, docname: str, basedir: bool = True) -> str: """Return the filename for the document name. If *basedir* is True, return as an absolute path. Else, return as a relative path to the source directory. """ docname = docname.replace(SEP, os.path.sep) basename = os.path.join(self.srcdir, docname) for suffix in self.source_suffix: if os.path.isfile(basename + suffix): break else: # document does not exist suffix = list(self.source_suffix)[0] if basedir: return basename + suffix else: return docname + suffix �����������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163740.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/py.typed������������������������������������������������������������������������0000644�0000766�0000024�00000000000�00000000000�015331� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5194855 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/pycode/�������������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015127� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/pycode/__init__.py��������������������������������������������������������������0000644�0000766�0000024�00000015434�00000000000�017247� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.pycode ~~~~~~~~~~~~~ Utilities parsing and analyzing Python code. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import re import tokenize import warnings from collections import OrderedDict from importlib import import_module from inspect import Signature from io import StringIO from os import path from typing import IO, Any, Dict, List, Optional, Tuple from zipfile import ZipFile from sphinx.deprecation import RemovedInSphinx50Warning from sphinx.errors import PycodeError from sphinx.pycode.parser import Parser class ModuleAnalyzer: annotations: Dict[Tuple[str, str], str] attr_docs: Dict[Tuple[str, str], List[str]] finals: List[str] overloads: Dict[str, List[Signature]] tagorder: Dict[str, int] tags: Dict[str, Tuple[str, int, int]] # cache for analyzer objects -- caches both by module and file name cache: Dict[Tuple[str, str], Any] = {} @staticmethod def get_module_source(modname: str) -> Tuple[Optional[str], Optional[str]]: """Try to find the source code for a module. Returns ('filename', 'source'). One of it can be None if no filename or source found """ try: mod = import_module(modname) except Exception as err: raise PycodeError('error importing %r' % modname, err) from err loader = getattr(mod, '__loader__', None) filename = getattr(mod, '__file__', None) if loader and getattr(loader, 'get_source', None): # prefer Native loader, as it respects #coding directive try: source = loader.get_source(modname) if source: # no exception and not None - it must be module source return filename, source except ImportError: pass # Try other "source-mining" methods if filename is None and loader and getattr(loader, 'get_filename', None): # have loader, but no filename try: filename = loader.get_filename(modname) except ImportError as err: raise PycodeError('error getting filename for %r' % modname, err) from err if filename is None: # all methods for getting filename failed, so raise... raise PycodeError('no source found for module %r' % modname) filename = path.normpath(path.abspath(filename)) if filename.lower().endswith(('.pyo', '.pyc')): filename = filename[:-1] if not path.isfile(filename) and path.isfile(filename + 'w'): filename += 'w' elif not filename.lower().endswith(('.py', '.pyw')): raise PycodeError('source is not a .py file: %r' % filename) elif ('.egg' + path.sep) in filename: pat = '(?<=\\.egg)' + re.escape(path.sep) eggpath, _ = re.split(pat, filename, 1) if path.isfile(eggpath): return filename, None if not path.isfile(filename): raise PycodeError('source file is not present: %r' % filename) return filename, None @classmethod def for_string(cls, string: str, modname: str, srcname: str = '<string>' ) -> "ModuleAnalyzer": return cls(StringIO(string), modname, srcname) @classmethod def for_file(cls, filename: str, modname: str) -> "ModuleAnalyzer": if ('file', filename) in cls.cache: return cls.cache['file', filename] try: with tokenize.open(filename) as f: obj = cls(f, modname, filename) cls.cache['file', filename] = obj except Exception as err: if '.egg' + path.sep in filename: obj = cls.cache['file', filename] = cls.for_egg(filename, modname) else: raise PycodeError('error opening %r' % filename, err) from err return obj @classmethod def for_egg(cls, filename: str, modname: str) -> "ModuleAnalyzer": SEP = re.escape(path.sep) eggpath, relpath = re.split('(?<=\\.egg)' + SEP, filename) try: with ZipFile(eggpath) as egg: code = egg.read(relpath).decode() return cls.for_string(code, modname, filename) except Exception as exc: raise PycodeError('error opening %r' % filename, exc) from exc @classmethod def for_module(cls, modname: str) -> "ModuleAnalyzer": if ('module', modname) in cls.cache: entry = cls.cache['module', modname] if isinstance(entry, PycodeError): raise entry return entry try: filename, source = cls.get_module_source(modname) if source is not None: obj = cls.for_string(source, modname, filename or '<string>') elif filename is not None: obj = cls.for_file(filename, modname) except PycodeError as err: cls.cache['module', modname] = err raise cls.cache['module', modname] = obj return obj def __init__(self, source: IO, modname: str, srcname: str) -> None: self.modname = modname # name of the module self.srcname = srcname # name of the source file # cache the source code as well self.code = source.read() self._analyzed = False def parse(self) -> None: """Parse the source code.""" warnings.warn('ModuleAnalyzer.parse() is deprecated.', RemovedInSphinx50Warning, stacklevel=2) self.analyze() def analyze(self) -> None: """Analyze the source code.""" if self._analyzed: return None try: parser = Parser(self.code) parser.parse() self.attr_docs = OrderedDict() for (scope, comment) in parser.comments.items(): if comment: self.attr_docs[scope] = comment.splitlines() + [''] else: self.attr_docs[scope] = [''] self.annotations = parser.annotations self.finals = parser.finals self.overloads = parser.overloads self.tags = parser.definitions self.tagorder = parser.deforders self._analyzed = True except Exception as exc: raise PycodeError('parsing %r failed: %r' % (self.srcname, exc)) from exc def find_attr_docs(self) -> Dict[Tuple[str, str], List[str]]: """Find class and module-level attributes and their documentation.""" self.analyze() return self.attr_docs def find_tags(self) -> Dict[str, Tuple[str, int, int]]: """Find class, function and method definitions and their location.""" self.analyze() return self.tags ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/pycode/ast.py�������������������������������������������������������������������0000644�0000766�0000024�00000017732�00000000000�016302� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.pycode.ast ~~~~~~~~~~~~~~~~~ Helpers for AST (Abstract Syntax Tree). :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import sys from typing import Dict, List, Optional, Type, overload if sys.version_info > (3, 8): import ast else: try: # use typed_ast module if installed from typed_ast import ast3 as ast except ImportError: import ast # type: ignore OPERATORS: Dict[Type[ast.AST], str] = { ast.Add: "+", ast.And: "and", ast.BitAnd: "&", ast.BitOr: "|", ast.BitXor: "^", ast.Div: "/", ast.FloorDiv: "//", ast.Invert: "~", ast.LShift: "<<", ast.MatMult: "@", ast.Mult: "*", ast.Mod: "%", ast.Not: "not", ast.Pow: "**", ast.Or: "or", ast.RShift: ">>", ast.Sub: "-", ast.UAdd: "+", ast.USub: "-", } def parse(code: str, mode: str = 'exec') -> "ast.AST": """Parse the *code* using the built-in ast or typed_ast libraries. This enables "type_comments" feature if possible. """ try: # type_comments parameter is available on py38+ return ast.parse(code, mode=mode, type_comments=True) # type: ignore except SyntaxError: # Some syntax error found. To ignore invalid type comments, retry parsing without # type_comments parameter (refs: https://github.com/sphinx-doc/sphinx/issues/8652). return ast.parse(code, mode=mode) except TypeError: # fallback to ast module. # typed_ast is used to parse type_comments if installed. return ast.parse(code, mode=mode) @overload def unparse(node: None, code: str = '') -> None: ... @overload def unparse(node: ast.AST, code: str = '') -> str: ... def unparse(node: Optional[ast.AST], code: str = '') -> Optional[str]: """Unparse an AST to string.""" if node is None: return None elif isinstance(node, str): return node return _UnparseVisitor(code).visit(node) # a greatly cut-down version of `ast._Unparser` class _UnparseVisitor(ast.NodeVisitor): def __init__(self, code: str = '') -> None: self.code = code def _visit_op(self, node: ast.AST) -> str: return OPERATORS[node.__class__] for _op in OPERATORS: locals()['visit_{}'.format(_op.__name__)] = _visit_op def visit_arg(self, node: ast.arg) -> str: if node.annotation: return "%s: %s" % (node.arg, self.visit(node.annotation)) else: return node.arg def _visit_arg_with_default(self, arg: ast.arg, default: Optional[ast.AST]) -> str: """Unparse a single argument to a string.""" name = self.visit(arg) if default: if arg.annotation: name += " = %s" % self.visit(default) else: name += "=%s" % self.visit(default) return name def visit_arguments(self, node: ast.arguments) -> str: defaults: List[Optional[ast.expr]] = list(node.defaults) positionals = len(node.args) posonlyargs = 0 if hasattr(node, "posonlyargs"): # for py38+ posonlyargs += len(node.posonlyargs) # type:ignore positionals += posonlyargs for _ in range(len(defaults), positionals): defaults.insert(0, None) kw_defaults: List[Optional[ast.expr]] = list(node.kw_defaults) for _ in range(len(kw_defaults), len(node.kwonlyargs)): kw_defaults.insert(0, None) args: List[str] = [] if hasattr(node, "posonlyargs"): # for py38+ for i, arg in enumerate(node.posonlyargs): # type: ignore args.append(self._visit_arg_with_default(arg, defaults[i])) if node.posonlyargs: # type: ignore args.append('/') for i, arg in enumerate(node.args): args.append(self._visit_arg_with_default(arg, defaults[i + posonlyargs])) if node.vararg: args.append("*" + self.visit(node.vararg)) if node.kwonlyargs and not node.vararg: args.append('*') for i, arg in enumerate(node.kwonlyargs): args.append(self._visit_arg_with_default(arg, kw_defaults[i])) if node.kwarg: args.append("**" + self.visit(node.kwarg)) return ", ".join(args) def visit_Attribute(self, node: ast.Attribute) -> str: return "%s.%s" % (self.visit(node.value), node.attr) def visit_BinOp(self, node: ast.BinOp) -> str: return " ".join(self.visit(e) for e in [node.left, node.op, node.right]) def visit_BoolOp(self, node: ast.BoolOp) -> str: op = " %s " % self.visit(node.op) return op.join(self.visit(e) for e in node.values) def visit_Call(self, node: ast.Call) -> str: args = ([self.visit(e) for e in node.args] + ["%s=%s" % (k.arg, self.visit(k.value)) for k in node.keywords]) return "%s(%s)" % (self.visit(node.func), ", ".join(args)) def visit_Constant(self, node: ast.Constant) -> str: # type: ignore if node.value is Ellipsis: return "..." elif isinstance(node.value, (int, float, complex)): if self.code and sys.version_info > (3, 8): return ast.get_source_segment(self.code, node) # type: ignore else: return repr(node.value) else: return repr(node.value) def visit_Dict(self, node: ast.Dict) -> str: keys = (self.visit(k) for k in node.keys) values = (self.visit(v) for v in node.values) items = (k + ": " + v for k, v in zip(keys, values)) return "{" + ", ".join(items) + "}" def visit_Index(self, node: ast.Index) -> str: return self.visit(node.value) def visit_Lambda(self, node: ast.Lambda) -> str: return "lambda %s: ..." % self.visit(node.args) def visit_List(self, node: ast.List) -> str: return "[" + ", ".join(self.visit(e) for e in node.elts) + "]" def visit_Name(self, node: ast.Name) -> str: return node.id def visit_Set(self, node: ast.Set) -> str: return "{" + ", ".join(self.visit(e) for e in node.elts) + "}" def visit_Subscript(self, node: ast.Subscript) -> str: def is_simple_tuple(value: ast.AST) -> bool: return ( isinstance(value, ast.Tuple) and bool(value.elts) and not any(isinstance(elt, ast.Starred) for elt in value.elts) ) if is_simple_tuple(node.slice): elts = ", ".join(self.visit(e) for e in node.slice.elts) # type: ignore return "%s[%s]" % (self.visit(node.value), elts) elif isinstance(node.slice, ast.Index) and is_simple_tuple(node.slice.value): elts = ", ".join(self.visit(e) for e in node.slice.value.elts) # type: ignore return "%s[%s]" % (self.visit(node.value), elts) else: return "%s[%s]" % (self.visit(node.value), self.visit(node.slice)) def visit_UnaryOp(self, node: ast.UnaryOp) -> str: return "%s %s" % (self.visit(node.op), self.visit(node.operand)) def visit_Tuple(self, node: ast.Tuple) -> str: if len(node.elts) == 0: return "()" elif len(node.elts) == 1: return "(%s,)" % self.visit(node.elts[0]) else: return "(" + ", ".join(self.visit(e) for e in node.elts) + ")" if sys.version_info < (3, 8): # these ast nodes were deprecated in python 3.8 def visit_Bytes(self, node: ast.Bytes) -> str: return repr(node.s) def visit_Ellipsis(self, node: ast.Ellipsis) -> str: return "..." def visit_NameConstant(self, node: ast.NameConstant) -> str: return repr(node.value) def visit_Num(self, node: ast.Num) -> str: return repr(node.n) def visit_Str(self, node: ast.Str) -> str: return repr(node.s) def generic_visit(self, node): raise NotImplementedError('Unable to parse %s object' % type(node).__name__) ��������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/pycode/parser.py����������������������������������������������������������������0000644�0000766�0000024�00000051177�00000000000�017010� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.pycode.parser ~~~~~~~~~~~~~~~~~~~~ Utilities parsing and analyzing Python code. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import inspect import itertools import re import tokenize from collections import OrderedDict from inspect import Signature from token import DEDENT, INDENT, NAME, NEWLINE, NUMBER, OP, STRING from tokenize import COMMENT, NL from typing import Any, Dict, List, Optional, Tuple from sphinx.pycode.ast import ast # for py37 or older from sphinx.pycode.ast import parse, unparse comment_re = re.compile('^\\s*#: ?(.*)\r?\n?$') indent_re = re.compile('^\\s*$') emptyline_re = re.compile('^\\s*(#.*)?$') def filter_whitespace(code: str) -> str: return code.replace('\f', ' ') # replace FF (form feed) with whitespace def get_assign_targets(node: ast.AST) -> List[ast.expr]: """Get list of targets from Assign and AnnAssign node.""" if isinstance(node, ast.Assign): return node.targets else: return [node.target] # type: ignore def get_lvar_names(node: ast.AST, self: ast.arg = None) -> List[str]: """Convert assignment-AST to variable names. This raises `TypeError` if the assignment does not create new variable:: ary[0] = 'foo' dic["bar"] = 'baz' # => TypeError """ if self: self_id = self.arg node_name = node.__class__.__name__ if node_name in ('Index', 'Num', 'Slice', 'Str', 'Subscript'): raise TypeError('%r does not create new variable' % node) elif node_name == 'Name': if self is None or node.id == self_id: # type: ignore return [node.id] # type: ignore else: raise TypeError('The assignment %r is not instance variable' % node) elif node_name in ('Tuple', 'List'): members = [] for elt in node.elts: # type: ignore try: members.extend(get_lvar_names(elt, self)) except TypeError: pass return members elif node_name == 'Attribute': if node.value.__class__.__name__ == 'Name' and self and node.value.id == self_id: # type: ignore # NOQA # instance variable return ["%s" % get_lvar_names(node.attr, self)[0]] # type: ignore else: raise TypeError('The assignment %r is not instance variable' % node) elif node_name == 'str': return [node] # type: ignore elif node_name == 'Starred': return get_lvar_names(node.value, self) # type: ignore else: raise NotImplementedError('Unexpected node name %r' % node_name) def dedent_docstring(s: str) -> str: """Remove common leading indentation from docstring.""" def dummy() -> None: # dummy function to mock `inspect.getdoc`. pass dummy.__doc__ = s docstring = inspect.getdoc(dummy) if docstring: return docstring.lstrip("\r\n").rstrip("\r\n") else: return "" class Token: """Better token wrapper for tokenize module.""" def __init__(self, kind: int, value: Any, start: Tuple[int, int], end: Tuple[int, int], source: str) -> None: self.kind = kind self.value = value self.start = start self.end = end self.source = source def __eq__(self, other: Any) -> bool: if isinstance(other, int): return self.kind == other elif isinstance(other, str): return self.value == other elif isinstance(other, (list, tuple)): return [self.kind, self.value] == list(other) elif other is None: return False else: raise ValueError('Unknown value: %r' % other) def match(self, *conditions: Any) -> bool: return any(self == candidate for candidate in conditions) def __repr__(self) -> str: return '<Token kind=%r value=%r>' % (tokenize.tok_name[self.kind], self.value.strip()) class TokenProcessor: def __init__(self, buffers: List[str]) -> None: lines = iter(buffers) self.buffers = buffers self.tokens = tokenize.generate_tokens(lambda: next(lines)) self.current: Optional[Token] = None self.previous: Optional[Token] = None def get_line(self, lineno: int) -> str: """Returns specified line.""" return self.buffers[lineno - 1] def fetch_token(self) -> Token: """Fetch the next token from source code. Returns ``None`` if sequence finished. """ try: self.previous = self.current self.current = Token(*next(self.tokens)) except StopIteration: self.current = None return self.current def fetch_until(self, condition: Any) -> List[Token]: """Fetch tokens until specified token appeared. .. note:: This also handles parenthesis well. """ tokens = [] while self.fetch_token(): tokens.append(self.current) if self.current == condition: break elif self.current == [OP, '(']: tokens += self.fetch_until([OP, ')']) elif self.current == [OP, '{']: tokens += self.fetch_until([OP, '}']) elif self.current == [OP, '[']: tokens += self.fetch_until([OP, ']']) return tokens class AfterCommentParser(TokenProcessor): """Python source code parser to pick up comments after assignments. This parser takes code which starts with an assignment statement, and returns the comment for the variable if one exists. """ def __init__(self, lines: List[str]) -> None: super().__init__(lines) self.comment: Optional[str] = None def fetch_rvalue(self) -> List[Token]: """Fetch right-hand value of assignment.""" tokens = [] while self.fetch_token(): tokens.append(self.current) if self.current == [OP, '(']: tokens += self.fetch_until([OP, ')']) elif self.current == [OP, '{']: tokens += self.fetch_until([OP, '}']) elif self.current == [OP, '[']: tokens += self.fetch_until([OP, ']']) elif self.current == INDENT: tokens += self.fetch_until(DEDENT) elif self.current == [OP, ';']: break elif self.current.kind not in (OP, NAME, NUMBER, STRING): break return tokens def parse(self) -> None: """Parse the code and obtain comment after assignment.""" # skip lvalue (or whole of AnnAssign) while not self.fetch_token().match([OP, '='], NEWLINE, COMMENT): assert self.current # skip rvalue (if exists) if self.current == [OP, '=']: self.fetch_rvalue() if self.current == COMMENT: self.comment = self.current.value class VariableCommentPicker(ast.NodeVisitor): """Python source code parser to pick up variable comments.""" def __init__(self, buffers: List[str], encoding: str) -> None: self.counter = itertools.count() self.buffers = buffers self.encoding = encoding self.context: List[str] = [] self.current_classes: List[str] = [] self.current_function: Optional[ast.FunctionDef] = None self.comments: Dict[Tuple[str, str], str] = OrderedDict() self.annotations: Dict[Tuple[str, str], str] = {} self.previous: Optional[ast.AST] = None self.deforders: Dict[str, int] = {} self.finals: List[str] = [] self.overloads: Dict[str, List[Signature]] = {} self.typing: Optional[str] = None self.typing_final: Optional[str] = None self.typing_overload: Optional[str] = None super().__init__() def get_qualname_for(self, name: str) -> Optional[List[str]]: """Get qualified name for given object as a list of string(s).""" if self.current_function: if self.current_classes and self.context[-1] == "__init__": # store variable comments inside __init__ method of classes return self.context[:-1] + [name] else: return None else: return self.context + [name] def add_entry(self, name: str) -> None: qualname = self.get_qualname_for(name) if qualname: self.deforders[".".join(qualname)] = next(self.counter) def add_final_entry(self, name: str) -> None: qualname = self.get_qualname_for(name) if qualname: self.finals.append(".".join(qualname)) def add_overload_entry(self, func: ast.FunctionDef) -> None: # avoid circular import problem from sphinx.util.inspect import signature_from_ast qualname = self.get_qualname_for(func.name) if qualname: overloads = self.overloads.setdefault(".".join(qualname), []) overloads.append(signature_from_ast(func)) def add_variable_comment(self, name: str, comment: str) -> None: qualname = self.get_qualname_for(name) if qualname: basename = ".".join(qualname[:-1]) self.comments[(basename, name)] = comment def add_variable_annotation(self, name: str, annotation: ast.AST) -> None: qualname = self.get_qualname_for(name) if qualname: basename = ".".join(qualname[:-1]) self.annotations[(basename, name)] = unparse(annotation) def is_final(self, decorators: List[ast.expr]) -> bool: final = [] if self.typing: final.append('%s.final' % self.typing) if self.typing_final: final.append(self.typing_final) for decorator in decorators: try: if unparse(decorator) in final: return True except NotImplementedError: pass return False def is_overload(self, decorators: List[ast.expr]) -> bool: overload = [] if self.typing: overload.append('%s.overload' % self.typing) if self.typing_overload: overload.append(self.typing_overload) for decorator in decorators: try: if unparse(decorator) in overload: return True except NotImplementedError: pass return False def get_self(self) -> Optional[ast.arg]: """Returns the name of the first argument if in a function.""" if self.current_function and self.current_function.args.args: return self.current_function.args.args[0] else: return None def get_line(self, lineno: int) -> str: """Returns specified line.""" return self.buffers[lineno - 1] def visit(self, node: ast.AST) -> None: """Updates self.previous to the given node.""" super().visit(node) self.previous = node def visit_Import(self, node: ast.Import) -> None: """Handles Import node and record the order of definitions.""" for name in node.names: self.add_entry(name.asname or name.name) if name.name == 'typing': self.typing = name.asname or name.name elif name.name == 'typing.final': self.typing_final = name.asname or name.name elif name.name == 'typing.overload': self.typing_overload = name.asname or name.name def visit_ImportFrom(self, node: ast.ImportFrom) -> None: """Handles Import node and record the order of definitions.""" for name in node.names: self.add_entry(name.asname or name.name) if node.module == 'typing' and name.name == 'final': self.typing_final = name.asname or name.name elif node.module == 'typing' and name.name == 'overload': self.typing_overload = name.asname or name.name def visit_Assign(self, node: ast.Assign) -> None: """Handles Assign node and pick up a variable comment.""" try: targets = get_assign_targets(node) varnames: List[str] = sum([get_lvar_names(t, self=self.get_self()) for t in targets], []) # NOQA current_line = self.get_line(node.lineno) except TypeError: return # this assignment is not new definition! # record annotation if hasattr(node, 'annotation') and node.annotation: # type: ignore for varname in varnames: self.add_variable_annotation(varname, node.annotation) # type: ignore elif hasattr(node, 'type_comment') and node.type_comment: for varname in varnames: self.add_variable_annotation(varname, node.type_comment) # type: ignore # check comments after assignment parser = AfterCommentParser([current_line[node.col_offset:]] + self.buffers[node.lineno:]) parser.parse() if parser.comment and comment_re.match(parser.comment): for varname in varnames: self.add_variable_comment(varname, comment_re.sub('\\1', parser.comment)) self.add_entry(varname) return # check comments before assignment if indent_re.match(current_line[:node.col_offset]): comment_lines = [] for i in range(node.lineno - 1): before_line = self.get_line(node.lineno - 1 - i) if comment_re.match(before_line): comment_lines.append(comment_re.sub('\\1', before_line)) else: break if comment_lines: comment = dedent_docstring('\n'.join(reversed(comment_lines))) for varname in varnames: self.add_variable_comment(varname, comment) self.add_entry(varname) return # not commented (record deforders only) for varname in varnames: self.add_entry(varname) def visit_AnnAssign(self, node: ast.AnnAssign) -> None: """Handles AnnAssign node and pick up a variable comment.""" self.visit_Assign(node) # type: ignore def visit_Expr(self, node: ast.Expr) -> None: """Handles Expr node and pick up a comment if string.""" if (isinstance(self.previous, (ast.Assign, ast.AnnAssign)) and isinstance(node.value, ast.Str)): try: targets = get_assign_targets(self.previous) varnames = get_lvar_names(targets[0], self.get_self()) for varname in varnames: if isinstance(node.value.s, str): docstring = node.value.s else: docstring = node.value.s.decode(self.encoding or 'utf-8') self.add_variable_comment(varname, dedent_docstring(docstring)) self.add_entry(varname) except TypeError: pass # this assignment is not new definition! def visit_Try(self, node: ast.Try) -> None: """Handles Try node and processes body and else-clause. .. note:: pycode parser ignores objects definition in except-clause. """ for subnode in node.body: self.visit(subnode) for subnode in node.orelse: self.visit(subnode) def visit_ClassDef(self, node: ast.ClassDef) -> None: """Handles ClassDef node and set context.""" self.current_classes.append(node.name) self.add_entry(node.name) if self.is_final(node.decorator_list): self.add_final_entry(node.name) self.context.append(node.name) self.previous = node for child in node.body: self.visit(child) self.context.pop() self.current_classes.pop() def visit_FunctionDef(self, node: ast.FunctionDef) -> None: """Handles FunctionDef node and set context.""" if self.current_function is None: self.add_entry(node.name) # should be called before setting self.current_function if self.is_final(node.decorator_list): self.add_final_entry(node.name) if self.is_overload(node.decorator_list): self.add_overload_entry(node) self.context.append(node.name) self.current_function = node for child in node.body: self.visit(child) self.context.pop() self.current_function = None def visit_AsyncFunctionDef(self, node: ast.AsyncFunctionDef) -> None: """Handles AsyncFunctionDef node and set context.""" self.visit_FunctionDef(node) # type: ignore class DefinitionFinder(TokenProcessor): """Python source code parser to detect location of functions, classes and methods. """ def __init__(self, lines: List[str]) -> None: super().__init__(lines) self.decorator: Optional[Token] = None self.context: List[str] = [] self.indents: List = [] self.definitions: Dict[str, Tuple[str, int, int]] = {} def add_definition(self, name: str, entry: Tuple[str, int, int]) -> None: """Add a location of definition.""" if self.indents and self.indents[-1][0] == 'def' and entry[0] == 'def': # ignore definition of inner function pass else: self.definitions[name] = entry def parse(self) -> None: """Parse the code to obtain location of definitions.""" while True: token = self.fetch_token() if token is None: break elif token == COMMENT: pass elif token == [OP, '@'] and (self.previous is None or self.previous.match(NEWLINE, NL, INDENT, DEDENT)): if self.decorator is None: self.decorator = token elif token.match([NAME, 'class']): self.parse_definition('class') elif token.match([NAME, 'def']): self.parse_definition('def') elif token == INDENT: self.indents.append(('other', None, None)) elif token == DEDENT: self.finalize_block() def parse_definition(self, typ: str) -> None: """Parse AST of definition.""" name = self.fetch_token() self.context.append(name.value) funcname = '.'.join(self.context) if self.decorator: start_pos = self.decorator.start[0] self.decorator = None else: start_pos = name.start[0] self.fetch_until([OP, ':']) if self.fetch_token().match(COMMENT, NEWLINE): self.fetch_until(INDENT) self.indents.append((typ, funcname, start_pos)) else: # one-liner self.add_definition(funcname, (typ, start_pos, name.end[0])) self.context.pop() def finalize_block(self) -> None: """Finalize definition block.""" definition = self.indents.pop() if definition[0] != 'other': typ, funcname, start_pos = definition end_pos = self.current.end[0] - 1 while emptyline_re.match(self.get_line(end_pos)): end_pos -= 1 self.add_definition(funcname, (typ, start_pos, end_pos)) self.context.pop() class Parser: """Python source code parser to pick up variable comments. This is a better wrapper for ``VariableCommentPicker``. """ def __init__(self, code: str, encoding: str = 'utf-8') -> None: self.code = filter_whitespace(code) self.encoding = encoding self.annotations: Dict[Tuple[str, str], str] = {} self.comments: Dict[Tuple[str, str], str] = {} self.deforders: Dict[str, int] = {} self.definitions: Dict[str, Tuple[str, int, int]] = {} self.finals: List[str] = [] self.overloads: Dict[str, List[Signature]] = {} def parse(self) -> None: """Parse the source code.""" self.parse_comments() self.parse_definition() def parse_comments(self) -> None: """Parse the code and pick up comments.""" tree = parse(self.code) picker = VariableCommentPicker(self.code.splitlines(True), self.encoding) picker.visit(tree) self.annotations = picker.annotations self.comments = picker.comments self.deforders = picker.deforders self.finals = picker.finals self.overloads = picker.overloads def parse_definition(self) -> None: """Parse the location of definitions from the code.""" parser = DefinitionFinder(self.code.splitlines(True)) parser.parse() self.definitions = parser.definitions �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/pygments_styles.py��������������������������������������������������������������0000644�0000766�0000024�00000005720�00000000000�017473� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.pygments_styles ~~~~~~~~~~~~~~~~~~~~~~ Sphinx theme specific highlighting styles. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from pygments.style import Style from pygments.styles.friendly import FriendlyStyle from pygments.token import (Comment, Error, Generic, Keyword, Name, Number, Operator, String, Whitespace) class NoneStyle(Style): """Style without any styling.""" class SphinxStyle(Style): """ Like friendly, but a bit darker to enhance contrast on the green background. """ background_color = '#eeffcc' default_style = '' styles = FriendlyStyle.styles styles.update({ Generic.Output: '#333', Comment: 'italic #408090', Number: '#208050', }) class PyramidStyle(Style): """ Pylons/pyramid pygments style based on friendly style, by Blaise Laflamme. """ # work in progress... background_color = "#f8f8f8" default_style = "" styles = { Whitespace: "#bbbbbb", Comment: "italic #60a0b0", Comment.Preproc: "noitalic #007020", Comment.Special: "noitalic bg:#fff0f0", Keyword: "bold #007020", Keyword.Pseudo: "nobold", Keyword.Type: "nobold #902000", Operator: "#666666", Operator.Word: "bold #007020", Name.Builtin: "#007020", Name.Function: "#06287e", Name.Class: "bold #0e84b5", Name.Namespace: "bold #0e84b5", Name.Exception: "#007020", Name.Variable: "#bb60d5", Name.Constant: "#60add5", Name.Label: "bold #002070", Name.Entity: "bold #d55537", Name.Attribute: "#0e84b5", Name.Tag: "bold #062873", Name.Decorator: "bold #555555", String: "#4070a0", String.Doc: "italic", String.Interpol: "italic #70a0d0", String.Escape: "bold #4070a0", String.Regex: "#235388", String.Symbol: "#517918", String.Other: "#c65d09", Number: "#40a070", Generic.Heading: "bold #000080", Generic.Subheading: "bold #800080", Generic.Deleted: "#A00000", Generic.Inserted: "#00A000", Generic.Error: "#FF0000", Generic.Emph: "italic", Generic.Strong: "bold", Generic.Prompt: "bold #c65d09", Generic.Output: "#888", Generic.Traceback: "#04D", Error: "#a40000 bg:#fbe3e4" } ������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/registry.py���������������������������������������������������������������������0000644�0000766�0000024�00000053174�00000000000�016100� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.registry ~~~~~~~~~~~~~~~ Sphinx component registry. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import traceback import warnings from importlib import import_module from types import MethodType from typing import (TYPE_CHECKING, Any, Callable, Dict, Iterator, List, Optional, Tuple, Type, Union) from docutils import nodes from docutils.io import Input from docutils.nodes import Element, Node, TextElement from docutils.parsers import Parser from docutils.parsers.rst import Directive from docutils.transforms import Transform from pkg_resources import iter_entry_points from sphinx.builders import Builder from sphinx.config import Config from sphinx.deprecation import RemovedInSphinx60Warning from sphinx.domains import Domain, Index, ObjType from sphinx.domains.std import GenericObject, Target from sphinx.environment import BuildEnvironment from sphinx.errors import ExtensionError, SphinxError, VersionRequirementError from sphinx.extension import Extension from sphinx.locale import __ from sphinx.parsers import Parser as SphinxParser from sphinx.roles import XRefRole from sphinx.util import logging from sphinx.util.logging import prefixed_warnings from sphinx.util.typing import RoleFunction, TitleGetter if TYPE_CHECKING: from sphinx.application import Sphinx from sphinx.ext.autodoc import Documenter logger = logging.getLogger(__name__) # list of deprecated extensions. Keys are extension name. # Values are Sphinx version that merge the extension. EXTENSION_BLACKLIST = { "sphinxjp.themecore": "1.2" } class SphinxComponentRegistry: def __init__(self) -> None: #: special attrgetter for autodoc; class object -> attrgetter self.autodoc_attrgettrs: Dict[Type, Callable[[Any, str, Any], Any]] = {} #: builders; a dict of builder name -> bulider class self.builders: Dict[str, Type[Builder]] = {} #: autodoc documenters; a dict of documenter name -> documenter class self.documenters: Dict[str, Type[Documenter]] = {} #: css_files; a list of tuple of filename and attributes self.css_files: List[Tuple[str, Dict[str, Any]]] = [] #: domains; a dict of domain name -> domain class self.domains: Dict[str, Type[Domain]] = {} #: additional directives for domains #: a dict of domain name -> dict of directive name -> directive self.domain_directives: Dict[str, Dict[str, Any]] = {} #: additional indices for domains #: a dict of domain name -> list of index class self.domain_indices: Dict[str, List[Type[Index]]] = {} #: additional object types for domains #: a dict of domain name -> dict of objtype name -> objtype self.domain_object_types: Dict[str, Dict[str, ObjType]] = {} #: additional roles for domains #: a dict of domain name -> dict of role name -> role impl. self.domain_roles: Dict[str, Dict[str, Union[RoleFunction, XRefRole]]] = {} #: additional enumerable nodes #: a dict of node class -> tuple of figtype and title_getter function self.enumerable_nodes: Dict[Type[Node], Tuple[str, TitleGetter]] = {} #: HTML inline and block math renderers #: a dict of name -> tuple of visit function and depart function self.html_inline_math_renderers: Dict[str, Tuple[Callable, Callable]] = {} self.html_block_math_renderers: Dict[str, Tuple[Callable, Callable]] = {} #: HTML assets self.html_assets_policy: str = 'per_page' #: HTML themes self.html_themes: Dict[str, str] = {} #: js_files; list of JS paths or URLs self.js_files: List[Tuple[str, Dict[str, Any]]] = [] #: LaTeX packages; list of package names and its options self.latex_packages: List[Tuple[str, str]] = [] self.latex_packages_after_hyperref: List[Tuple[str, str]] = [] #: post transforms; list of transforms self.post_transforms: List[Type[Transform]] = [] #: source paresrs; file type -> parser class self.source_parsers: Dict[str, Type[Parser]] = {} #: source inputs; file type -> input class self.source_inputs: Dict[str, Type[Input]] = {} #: source suffix: suffix -> file type self.source_suffix: Dict[str, str] = {} #: custom translators; builder name -> translator class self.translators: Dict[str, Type[nodes.NodeVisitor]] = {} #: custom handlers for translators #: a dict of builder name -> dict of node name -> visitor and departure functions self.translation_handlers: Dict[str, Dict[str, Tuple[Callable, Callable]]] = {} #: additional transforms; list of transforms self.transforms: List[Type[Transform]] = [] def add_builder(self, builder: Type[Builder], override: bool = False) -> None: logger.debug('[app] adding builder: %r', builder) if not hasattr(builder, 'name'): raise ExtensionError(__('Builder class %s has no "name" attribute') % builder) if builder.name in self.builders and not override: raise ExtensionError(__('Builder %r already exists (in module %s)') % (builder.name, self.builders[builder.name].__module__)) self.builders[builder.name] = builder def preload_builder(self, app: "Sphinx", name: str) -> None: if name is None: return if name not in self.builders: entry_points = iter_entry_points('sphinx.builders', name) try: entry_point = next(entry_points) except StopIteration as exc: raise SphinxError(__('Builder name %s not registered or available' ' through entry point') % name) from exc self.load_extension(app, entry_point.module_name) def create_builder(self, app: "Sphinx", name: str) -> Builder: if name not in self.builders: raise SphinxError(__('Builder name %s not registered') % name) return self.builders[name](app) def add_domain(self, domain: Type[Domain], override: bool = False) -> None: logger.debug('[app] adding domain: %r', domain) if domain.name in self.domains and not override: raise ExtensionError(__('domain %s already registered') % domain.name) self.domains[domain.name] = domain def has_domain(self, domain: str) -> bool: return domain in self.domains def create_domains(self, env: BuildEnvironment) -> Iterator[Domain]: for DomainClass in self.domains.values(): domain = DomainClass(env) # transplant components added by extensions domain.directives.update(self.domain_directives.get(domain.name, {})) domain.roles.update(self.domain_roles.get(domain.name, {})) domain.indices.extend(self.domain_indices.get(domain.name, [])) for name, objtype in self.domain_object_types.get(domain.name, {}).items(): domain.add_object_type(name, objtype) yield domain def add_directive_to_domain(self, domain: str, name: str, cls: Type[Directive], override: bool = False) -> None: logger.debug('[app] adding directive to domain: %r', (domain, name, cls)) if domain not in self.domains: raise ExtensionError(__('domain %s not yet registered') % domain) directives = self.domain_directives.setdefault(domain, {}) if name in directives and not override: raise ExtensionError(__('The %r directive is already registered to domain %s') % (name, domain)) directives[name] = cls def add_role_to_domain(self, domain: str, name: str, role: Union[RoleFunction, XRefRole], override: bool = False ) -> None: logger.debug('[app] adding role to domain: %r', (domain, name, role)) if domain not in self.domains: raise ExtensionError(__('domain %s not yet registered') % domain) roles = self.domain_roles.setdefault(domain, {}) if name in roles and not override: raise ExtensionError(__('The %r role is already registered to domain %s') % (name, domain)) roles[name] = role def add_index_to_domain(self, domain: str, index: Type[Index], override: bool = False) -> None: logger.debug('[app] adding index to domain: %r', (domain, index)) if domain not in self.domains: raise ExtensionError(__('domain %s not yet registered') % domain) indices = self.domain_indices.setdefault(domain, []) if index in indices and not override: raise ExtensionError(__('The %r index is already registered to domain %s') % (index.name, domain)) indices.append(index) def add_object_type(self, directivename: str, rolename: str, indextemplate: str = '', parse_node: Callable = None, ref_nodeclass: Type[TextElement] = None, objname: str = '', doc_field_types: List = [], override: bool = False ) -> None: logger.debug('[app] adding object type: %r', (directivename, rolename, indextemplate, parse_node, ref_nodeclass, objname, doc_field_types)) # create a subclass of GenericObject as the new directive directive = type(directivename, (GenericObject, object), {'indextemplate': indextemplate, 'parse_node': staticmethod(parse_node), 'doc_field_types': doc_field_types}) self.add_directive_to_domain('std', directivename, directive) self.add_role_to_domain('std', rolename, XRefRole(innernodeclass=ref_nodeclass)) object_types = self.domain_object_types.setdefault('std', {}) if directivename in object_types and not override: raise ExtensionError(__('The %r object_type is already registered') % directivename) object_types[directivename] = ObjType(objname or directivename, rolename) def add_crossref_type(self, directivename: str, rolename: str, indextemplate: str = '', ref_nodeclass: Type[TextElement] = None, objname: str = '', override: bool = False) -> None: logger.debug('[app] adding crossref type: %r', (directivename, rolename, indextemplate, ref_nodeclass, objname)) # create a subclass of Target as the new directive directive = type(directivename, (Target, object), {'indextemplate': indextemplate}) self.add_directive_to_domain('std', directivename, directive) self.add_role_to_domain('std', rolename, XRefRole(innernodeclass=ref_nodeclass)) object_types = self.domain_object_types.setdefault('std', {}) if directivename in object_types and not override: raise ExtensionError(__('The %r crossref_type is already registered') % directivename) object_types[directivename] = ObjType(objname or directivename, rolename) def add_source_suffix(self, suffix: str, filetype: str, override: bool = False) -> None: logger.debug('[app] adding source_suffix: %r, %r', suffix, filetype) if suffix in self.source_suffix and not override: raise ExtensionError(__('source_suffix %r is already registered') % suffix) else: self.source_suffix[suffix] = filetype def add_source_parser(self, parser: Type[Parser], override: bool = False) -> None: logger.debug('[app] adding search source_parser: %r', parser) # create a map from filetype to parser for filetype in parser.supported: if filetype in self.source_parsers and not override: raise ExtensionError(__('source_parser for %r is already registered') % filetype) else: self.source_parsers[filetype] = parser def get_source_parser(self, filetype: str) -> Type[Parser]: try: return self.source_parsers[filetype] except KeyError as exc: raise SphinxError(__('Source parser for %s not registered') % filetype) from exc def get_source_parsers(self) -> Dict[str, Type[Parser]]: return self.source_parsers def create_source_parser(self, app: "Sphinx", filename: str) -> Parser: parser_class = self.get_source_parser(filename) parser = parser_class() if isinstance(parser, SphinxParser): parser.set_application(app) return parser def get_source_input(self, filetype: str) -> Optional[Type[Input]]: warnings.warn('SphinxComponentRegistry.get_source_input() is deprecated.', RemovedInSphinx60Warning) try: return self.source_inputs[filetype] except KeyError: try: # use special source_input for unknown filetype return self.source_inputs['*'] except KeyError: return None def add_translator(self, name: str, translator: Type[nodes.NodeVisitor], override: bool = False) -> None: logger.debug('[app] Change of translator for the %s builder.', name) if name in self.translators and not override: raise ExtensionError(__('Translator for %r already exists') % name) self.translators[name] = translator def add_translation_handlers(self, node: Type[Element], **kwargs: Tuple[Callable, Callable]) -> None: logger.debug('[app] adding translation_handlers: %r, %r', node, kwargs) for builder_name, handlers in kwargs.items(): translation_handlers = self.translation_handlers.setdefault(builder_name, {}) try: visit, depart = handlers # unpack once for assertion translation_handlers[node.__name__] = (visit, depart) except ValueError as exc: raise ExtensionError( __('kwargs for add_node() must be a (visit, depart) ' 'function tuple: %r=%r') % (builder_name, handlers) ) from exc def get_translator_class(self, builder: Builder) -> Type[nodes.NodeVisitor]: return self.translators.get(builder.name, builder.default_translator_class) def create_translator(self, builder: Builder, *args: Any) -> nodes.NodeVisitor: translator_class = self.get_translator_class(builder) assert translator_class, "translator not found for %s" % builder.name translator = translator_class(*args) # transplant handlers for custom nodes to translator instance handlers = self.translation_handlers.get(builder.name, None) if handlers is None: # retry with builder.format handlers = self.translation_handlers.get(builder.format, {}) for name, (visit, depart) in handlers.items(): setattr(translator, 'visit_' + name, MethodType(visit, translator)) if depart: setattr(translator, 'depart_' + name, MethodType(depart, translator)) return translator def add_transform(self, transform: Type[Transform]) -> None: logger.debug('[app] adding transform: %r', transform) self.transforms.append(transform) def get_transforms(self) -> List[Type[Transform]]: return self.transforms def add_post_transform(self, transform: Type[Transform]) -> None: logger.debug('[app] adding post transform: %r', transform) self.post_transforms.append(transform) def get_post_transforms(self) -> List[Type[Transform]]: return self.post_transforms def add_documenter(self, objtype: str, documenter: Type["Documenter"]) -> None: self.documenters[objtype] = documenter def add_autodoc_attrgetter(self, typ: Type, attrgetter: Callable[[Any, str, Any], Any]) -> None: self.autodoc_attrgettrs[typ] = attrgetter def add_css_files(self, filename: str, **attributes: Any) -> None: self.css_files.append((filename, attributes)) def add_js_file(self, filename: str, **attributes: Any) -> None: logger.debug('[app] adding js_file: %r, %r', filename, attributes) self.js_files.append((filename, attributes)) def has_latex_package(self, name: str) -> bool: packages = self.latex_packages + self.latex_packages_after_hyperref return bool([x for x in packages if x[0] == name]) def add_latex_package(self, name: str, options: str, after_hyperref: bool = False) -> None: if self.has_latex_package(name): logger.warn("latex package '%s' already included" % name) logger.debug('[app] adding latex package: %r', name) if after_hyperref: self.latex_packages_after_hyperref.append((name, options)) else: self.latex_packages.append((name, options)) def add_enumerable_node(self, node: Type[Node], figtype: str, title_getter: TitleGetter = None, override: bool = False) -> None: logger.debug('[app] adding enumerable node: (%r, %r, %r)', node, figtype, title_getter) if node in self.enumerable_nodes and not override: raise ExtensionError(__('enumerable_node %r already registered') % node) self.enumerable_nodes[node] = (figtype, title_getter) def add_html_math_renderer(self, name: str, inline_renderers: Tuple[Callable, Callable], block_renderers: Tuple[Callable, Callable]) -> None: logger.debug('[app] adding html_math_renderer: %s, %r, %r', name, inline_renderers, block_renderers) if name in self.html_inline_math_renderers: raise ExtensionError(__('math renderer %s is already registered') % name) self.html_inline_math_renderers[name] = inline_renderers self.html_block_math_renderers[name] = block_renderers def add_html_theme(self, name: str, theme_path: str) -> None: self.html_themes[name] = theme_path def load_extension(self, app: "Sphinx", extname: str) -> None: """Load a Sphinx extension.""" if extname in app.extensions: # already loaded return if extname in EXTENSION_BLACKLIST: logger.warning(__('the extension %r was already merged with Sphinx since ' 'version %s; this extension is ignored.'), extname, EXTENSION_BLACKLIST[extname]) return # update loading context prefix = __('while setting up extension %s:') % extname with prefixed_warnings(prefix): try: mod = import_module(extname) except ImportError as err: logger.verbose(__('Original exception:\n') + traceback.format_exc()) raise ExtensionError(__('Could not import extension %s') % extname, err) from err setup = getattr(mod, 'setup', None) if setup is None: logger.warning(__('extension %r has no setup() function; is it really ' 'a Sphinx extension module?'), extname) metadata: Dict[str, Any] = {} else: try: metadata = setup(app) except VersionRequirementError as err: # add the extension name to the version required raise VersionRequirementError( __('The %s extension used by this project needs at least ' 'Sphinx v%s; it therefore cannot be built with this ' 'version.') % (extname, err) ) from err if metadata is None: metadata = {} elif not isinstance(metadata, dict): logger.warning(__('extension %r returned an unsupported object from ' 'its setup() function; it should return None or a ' 'metadata dictionary'), extname) metadata = {} app.extensions[extname] = Extension(extname, mod, **metadata) def get_envversion(self, app: "Sphinx") -> Dict[str, str]: from sphinx.environment import ENV_VERSION envversion = {ext.name: ext.metadata['env_version'] for ext in app.extensions.values() if ext.metadata.get('env_version')} envversion['sphinx'] = ENV_VERSION return envversion def merge_source_suffix(app: "Sphinx", config: Config) -> None: """Merge any user-specified source_suffix with any added by extensions.""" for suffix, filetype in app.registry.source_suffix.items(): if suffix not in app.config.source_suffix: app.config.source_suffix[suffix] = filetype elif app.config.source_suffix[suffix] is None: # filetype is not specified (default filetype). # So it overrides default filetype by extensions setting. app.config.source_suffix[suffix] = filetype # copy config.source_suffix to registry app.registry.source_suffix = app.config.source_suffix def setup(app: "Sphinx") -> Dict[str, Any]: app.connect('config-inited', merge_source_suffix, priority=800) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/roles.py������������������������������������������������������������������������0000644�0000766�0000024�00000033026�00000000000�015346� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.roles ~~~~~~~~~~~~ Handlers for additional ReST roles. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import re from typing import TYPE_CHECKING, Any, Dict, List, Tuple, Type from docutils import nodes, utils from docutils.nodes import Element, Node, TextElement, system_message from sphinx import addnodes from sphinx.locale import _ from sphinx.util import ws_re from sphinx.util.docutils import ReferenceRole, SphinxRole from sphinx.util.typing import RoleFunction if TYPE_CHECKING: from sphinx.application import Sphinx from sphinx.environment import BuildEnvironment generic_docroles = { 'command': addnodes.literal_strong, 'dfn': nodes.emphasis, 'kbd': nodes.literal, 'mailheader': addnodes.literal_emphasis, 'makevar': addnodes.literal_strong, 'manpage': addnodes.manpage, 'mimetype': addnodes.literal_emphasis, 'newsgroup': addnodes.literal_emphasis, 'program': addnodes.literal_strong, # XXX should be an x-ref 'regexp': nodes.literal, } # -- generic cross-reference role ---------------------------------------------- class XRefRole(ReferenceRole): """ A generic cross-referencing role. To create a callable that can be used as a role function, create an instance of this class. The general features of this role are: * Automatic creation of a reference and a content node. * Optional separation of title and target with `title <target>`. * The implementation is a class rather than a function to make customization easier. Customization can be done in two ways: * Supplying constructor parameters: * `fix_parens` to normalize parentheses (strip from target, and add to title if configured) * `lowercase` to lowercase the target * `nodeclass` and `innernodeclass` select the node classes for the reference and the content node * Subclassing and overwriting `process_link()` and/or `result_nodes()`. """ nodeclass: Type[Element] = addnodes.pending_xref innernodeclass: Type[TextElement] = nodes.literal def __init__(self, fix_parens: bool = False, lowercase: bool = False, nodeclass: Type[Element] = None, innernodeclass: Type[TextElement] = None, warn_dangling: bool = False) -> None: self.fix_parens = fix_parens self.lowercase = lowercase self.warn_dangling = warn_dangling if nodeclass is not None: self.nodeclass = nodeclass if innernodeclass is not None: self.innernodeclass = innernodeclass super().__init__() def update_title_and_target(self, title: str, target: str) -> Tuple[str, str]: if not self.has_explicit_title: if title.endswith('()'): # remove parentheses title = title[:-2] if self.config.add_function_parentheses: # add them back to all occurrences if configured title += '()' # remove parentheses from the target too if target.endswith('()'): target = target[:-2] return title, target def run(self) -> Tuple[List[Node], List[system_message]]: if ':' not in self.name: self.refdomain, self.reftype = '', self.name self.classes = ['xref', self.reftype] else: self.refdomain, self.reftype = self.name.split(':', 1) self.classes = ['xref', self.refdomain, '%s-%s' % (self.refdomain, self.reftype)] if self.disabled: return self.create_non_xref_node() else: return self.create_xref_node() def create_non_xref_node(self) -> Tuple[List[Node], List[system_message]]: text = utils.unescape(self.text[1:]) if self.fix_parens: self.has_explicit_title = False # treat as implicit text, target = self.update_title_and_target(text, "") node = self.innernodeclass(self.rawtext, text, classes=self.classes) return self.result_nodes(self.inliner.document, self.env, node, is_ref=False) def create_xref_node(self) -> Tuple[List[Node], List[system_message]]: target = self.target title = self.title if self.lowercase: target = target.lower() if self.fix_parens: title, target = self.update_title_and_target(title, target) # create the reference node options = {'refdoc': self.env.docname, 'refdomain': self.refdomain, 'reftype': self.reftype, 'refexplicit': self.has_explicit_title, 'refwarn': self.warn_dangling} refnode = self.nodeclass(self.rawtext, **options) self.set_source_info(refnode) # determine the target and title for the class title, target = self.process_link(self.env, refnode, self.has_explicit_title, title, target) refnode['reftarget'] = target refnode += self.innernodeclass(self.rawtext, title, classes=self.classes) return self.result_nodes(self.inliner.document, self.env, refnode, is_ref=True) # methods that can be overwritten def process_link(self, env: "BuildEnvironment", refnode: Element, has_explicit_title: bool, title: str, target: str) -> Tuple[str, str]: """Called after parsing title and target text, and creating the reference node (given in *refnode*). This method can alter the reference node and must return a new (or the same) ``(title, target)`` tuple. """ return title, ws_re.sub(' ', target) def result_nodes(self, document: nodes.document, env: "BuildEnvironment", node: Element, is_ref: bool) -> Tuple[List[Node], List[system_message]]: """Called before returning the finished nodes. *node* is the reference node if one was created (*is_ref* is then true), else the content node. This method can add other nodes and must return a ``(nodes, messages)`` tuple (the usual return value of a role function). """ return [node], [] class AnyXRefRole(XRefRole): def process_link(self, env: "BuildEnvironment", refnode: Element, has_explicit_title: bool, title: str, target: str) -> Tuple[str, str]: result = super().process_link(env, refnode, has_explicit_title, title, target) # add all possible context info (i.e. std:program, py:module etc.) refnode.attributes.update(env.ref_context) return result class PEP(ReferenceRole): def run(self) -> Tuple[List[Node], List[system_message]]: target_id = 'index-%s' % self.env.new_serialno('index') entries = [('single', _('Python Enhancement Proposals; PEP %s') % self.target, target_id, '', None)] index = addnodes.index(entries=entries) target = nodes.target('', '', ids=[target_id]) self.inliner.document.note_explicit_target(target) try: refuri = self.build_uri() reference = nodes.reference('', '', internal=False, refuri=refuri, classes=['pep']) if self.has_explicit_title: reference += nodes.strong(self.title, self.title) else: title = "PEP " + self.title reference += nodes.strong(title, title) except ValueError: msg = self.inliner.reporter.error('invalid PEP number %s' % self.target, line=self.lineno) prb = self.inliner.problematic(self.rawtext, self.rawtext, msg) return [prb], [msg] return [index, target, reference], [] def build_uri(self) -> str: base_url = self.inliner.document.settings.pep_base_url ret = self.target.split('#', 1) if len(ret) == 2: return base_url + 'pep-%04d#%s' % (int(ret[0]), ret[1]) else: return base_url + 'pep-%04d' % int(ret[0]) class RFC(ReferenceRole): def run(self) -> Tuple[List[Node], List[system_message]]: target_id = 'index-%s' % self.env.new_serialno('index') entries = [('single', 'RFC; RFC %s' % self.target, target_id, '', None)] index = addnodes.index(entries=entries) target = nodes.target('', '', ids=[target_id]) self.inliner.document.note_explicit_target(target) try: refuri = self.build_uri() reference = nodes.reference('', '', internal=False, refuri=refuri, classes=['rfc']) if self.has_explicit_title: reference += nodes.strong(self.title, self.title) else: title = "RFC " + self.title reference += nodes.strong(title, title) except ValueError: msg = self.inliner.reporter.error('invalid RFC number %s' % self.target, line=self.lineno) prb = self.inliner.problematic(self.rawtext, self.rawtext, msg) return [prb], [msg] return [index, target, reference], [] def build_uri(self) -> str: base_url = self.inliner.document.settings.rfc_base_url ret = self.target.split('#', 1) if len(ret) == 2: return base_url + self.inliner.rfc_url % int(ret[0]) + '#' + ret[1] else: return base_url + self.inliner.rfc_url % int(ret[0]) _amp_re = re.compile(r'(?<!&)&(?![&\s])') class GUILabel(SphinxRole): amp_re = re.compile(r'(?<!&)&(?![&\s])') def run(self) -> Tuple[List[Node], List[system_message]]: node = nodes.inline(rawtext=self.rawtext, classes=[self.name]) spans = self.amp_re.split(self.text) node += nodes.Text(spans.pop(0)) for span in spans: span = span.replace('&&', '&') letter = nodes.Text(span[0]) accelerator = nodes.inline('', '', letter, classes=['accelerator']) node += accelerator node += nodes.Text(span[1:]) return [node], [] class MenuSelection(GUILabel): BULLET_CHARACTER = '\N{TRIANGULAR BULLET}' def run(self) -> Tuple[List[Node], List[system_message]]: self.text = self.text.replace('-->', self.BULLET_CHARACTER) return super().run() _litvar_re = re.compile('{([^}]+)}') parens_re = re.compile(r'(\\*{|\\*})') class EmphasizedLiteral(SphinxRole): parens_re = re.compile(r'(\\\\|\\{|\\}|{|})') def run(self) -> Tuple[List[Node], List[system_message]]: children = self.parse(self.text) node = nodes.literal(self.rawtext, '', *children, role=self.name.lower(), classes=[self.name]) return [node], [] def parse(self, text: str) -> List[Node]: result: List[Node] = [] stack = [''] for part in self.parens_re.split(text): if part == '\\\\': # escaped backslash stack[-1] += '\\' elif part == '{': if len(stack) >= 2 and stack[-2] == "{": # nested stack[-1] += "{" else: # start emphasis stack.append('{') stack.append('') elif part == '}': if len(stack) == 3 and stack[1] == "{" and len(stack[2]) > 0: # emphasized word found if stack[0]: result.append(nodes.Text(stack[0], stack[0])) result.append(nodes.emphasis(stack[2], stack[2])) stack = [''] else: # emphasized word not found; the rparen is not a special symbol stack.append('}') stack = [''.join(stack)] elif part == '\\{': # escaped left-brace stack[-1] += '{' elif part == '\\}': # escaped right-brace stack[-1] += '}' else: # others (containing escaped braces) stack[-1] += part if ''.join(stack): # remaining is treated as Text text = ''.join(stack) result.append(nodes.Text(text, text)) return result _abbr_re = re.compile(r'\((.*)\)$', re.S) class Abbreviation(SphinxRole): abbr_re = re.compile(r'\((.*)\)$', re.S) def run(self) -> Tuple[List[Node], List[system_message]]: options = self.options.copy() matched = self.abbr_re.search(self.text) if matched: text = self.text[:matched.start()].strip() options['explanation'] = matched.group(1) else: text = self.text return [nodes.abbreviation(self.rawtext, text, **options)], [] specific_docroles: Dict[str, RoleFunction] = { # links to download references 'download': XRefRole(nodeclass=addnodes.download_reference), # links to anything 'any': AnyXRefRole(warn_dangling=True), 'pep': PEP(), 'rfc': RFC(), 'guilabel': GUILabel(), 'menuselection': MenuSelection(), 'file': EmphasizedLiteral(), 'samp': EmphasizedLiteral(), 'abbr': Abbreviation(), } def setup(app: "Sphinx") -> Dict[str, Any]: from docutils.parsers.rst import roles for rolename, nodeclass in generic_docroles.items(): generic = roles.GenericRole(rolename, nodeclass) role = roles.CustomRole(rolename, generic, {'classes': [rolename]}) roles.register_local_role(rolename, role) for rolename, func in specific_docroles.items(): roles.register_local_role(rolename, func) return { 'version': 'builtin', 'parallel_read_safe': True, 'parallel_write_safe': True, } ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5236235 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/�������������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015111� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/__init__.py��������������������������������������������������������������0000644�0000766�0000024�00000042335�00000000000�017231� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search ~~~~~~~~~~~~~ Create a full-text search index for offline search. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import html import pickle import re from importlib import import_module from os import path from typing import IO, Any, Dict, Iterable, List, Optional, Set, Tuple, Type from docutils import nodes from docutils.nodes import Node from sphinx import addnodes, package_dir from sphinx.environment import BuildEnvironment from sphinx.search.jssplitter import splitter_code from sphinx.util import jsdump class SearchLanguage: """ This class is the base class for search natural language preprocessors. If you want to add support for a new language, you should override the methods of this class. You should override `lang` class property too (e.g. 'en', 'fr' and so on). .. attribute:: stopwords This is a set of stop words of the target language. Default `stopwords` is empty. This word is used for building index and embedded in JS. .. attribute:: js_splitter_code Return splitter function of JavaScript version. The function should be named as ``splitQuery``. And it should take a string and return list of strings. .. versionadded:: 3.0 .. attribute:: js_stemmer_code Return stemmer class of JavaScript version. This class' name should be ``Stemmer`` and this class must have ``stemWord`` method. This string is embedded as-is in searchtools.js. This class is used to preprocess search word which Sphinx HTML readers type, before searching index. Default implementation does nothing. """ lang: str = None language_name: str = None stopwords: Set[str] = set() js_splitter_code: str = None js_stemmer_rawcode: str = None js_stemmer_code = """ /** * Dummy stemmer for languages without stemming rules. */ var Stemmer = function() { this.stemWord = function(w) { return w; } } """ _word_re = re.compile(r'(?u)\w+') def __init__(self, options: Dict) -> None: self.options = options self.init(options) def init(self, options: Dict) -> None: """ Initialize the class with the options the user has given. """ def split(self, input: str) -> List[str]: """ This method splits a sentence into words. Default splitter splits input at white spaces, which should be enough for most languages except CJK languages. """ return self._word_re.findall(input) def stem(self, word: str) -> str: """ This method implements stemming algorithm of the Python version. Default implementation does nothing. You should implement this if the language has any stemming rules. This class is used to preprocess search words before registering them in the search index. The stemming of the Python version and the JS version (given in the js_stemmer_code attribute) must be compatible. """ return word def word_filter(self, word: str) -> bool: """ Return true if the target word should be registered in the search index. This method is called after stemming. """ return ( len(word) == 0 or not ( ((len(word) < 3) and (12353 < ord(word[0]) < 12436)) or (ord(word[0]) < 256 and ( word in self.stopwords )))) # SearchEnglish imported after SearchLanguage is defined due to circular import from sphinx.search.en import SearchEnglish def parse_stop_word(source: str) -> Set[str]: """ Parse snowball style word list like this: * http://snowball.tartarus.org/algorithms/finnish/stop.txt """ result: Set[str] = set() for line in source.splitlines(): line = line.split('|')[0] # remove comment result.update(line.split()) return result # maps language name to module.class or directly a class languages: Dict[str, Any] = { 'da': 'sphinx.search.da.SearchDanish', 'de': 'sphinx.search.de.SearchGerman', 'en': SearchEnglish, 'es': 'sphinx.search.es.SearchSpanish', 'fi': 'sphinx.search.fi.SearchFinnish', 'fr': 'sphinx.search.fr.SearchFrench', 'hu': 'sphinx.search.hu.SearchHungarian', 'it': 'sphinx.search.it.SearchItalian', 'ja': 'sphinx.search.ja.SearchJapanese', 'nl': 'sphinx.search.nl.SearchDutch', 'no': 'sphinx.search.no.SearchNorwegian', 'pt': 'sphinx.search.pt.SearchPortuguese', 'ro': 'sphinx.search.ro.SearchRomanian', 'ru': 'sphinx.search.ru.SearchRussian', 'sv': 'sphinx.search.sv.SearchSwedish', 'tr': 'sphinx.search.tr.SearchTurkish', 'zh': 'sphinx.search.zh.SearchChinese', } class _JavaScriptIndex: """ The search index as JavaScript file that calls a function on the documentation search object to register the index. """ PREFIX = 'Search.setIndex(' SUFFIX = ')' def dumps(self, data: Any) -> str: return self.PREFIX + jsdump.dumps(data) + self.SUFFIX def loads(self, s: str) -> Any: data = s[len(self.PREFIX):-len(self.SUFFIX)] if not data or not s.startswith(self.PREFIX) or not \ s.endswith(self.SUFFIX): raise ValueError('invalid data') return jsdump.loads(data) def dump(self, data: Any, f: IO) -> None: f.write(self.dumps(data)) def load(self, f: IO) -> Any: return self.loads(f.read()) js_index = _JavaScriptIndex() class WordCollector(nodes.NodeVisitor): """ A special visitor that collects words for the `IndexBuilder`. """ def __init__(self, document: nodes.document, lang: SearchLanguage) -> None: super().__init__(document) self.found_words: List[str] = [] self.found_title_words: List[str] = [] self.lang = lang def is_meta_keywords(self, node: addnodes.meta) -> bool: if isinstance(node, addnodes.meta) and node.get('name') == 'keywords': meta_lang = node.get('lang') if meta_lang is None: # lang not specified return True elif meta_lang == self.lang.lang: # matched to html_search_language return True return False def dispatch_visit(self, node: Node) -> None: if isinstance(node, nodes.comment): raise nodes.SkipNode elif isinstance(node, nodes.raw): if 'html' in node.get('format', '').split(): # Some people might put content in raw HTML that should be searched, # so we just amateurishly strip HTML tags and index the remaining # content nodetext = re.sub(r'(?is)<style.*?</style>', '', node.astext()) nodetext = re.sub(r'(?is)<script.*?</script>', '', nodetext) nodetext = re.sub(r'<[^<]+?>', '', nodetext) self.found_words.extend(self.lang.split(nodetext)) raise nodes.SkipNode elif isinstance(node, nodes.Text): self.found_words.extend(self.lang.split(node.astext())) elif isinstance(node, nodes.title): self.found_title_words.extend(self.lang.split(node.astext())) elif isinstance(node, addnodes.meta) and self.is_meta_keywords(node): keywords = node['content'] keywords = [keyword.strip() for keyword in keywords.split(',')] self.found_words.extend(keywords) class IndexBuilder: """ Helper class that creates a search index based on the doctrees passed to the `feed` method. """ formats = { 'jsdump': jsdump, 'pickle': pickle } def __init__(self, env: BuildEnvironment, lang: str, options: Dict, scoring: str) -> None: self.env = env self._titles: Dict[str, str] = {} # docname -> title self._filenames: Dict[str, str] = {} # docname -> filename self._mapping: Dict[str, Set[str]] = {} # stemmed word -> set(docname) # stemmed words in titles -> set(docname) self._title_mapping: Dict[str, Set[str]] = {} self._stem_cache: Dict[str, str] = {} # word -> stemmed word self._objtypes: Dict[Tuple[str, str], int] = {} # objtype -> index # objtype index -> (domain, type, objname (localized)) self._objnames: Dict[int, Tuple[str, str, str]] = {} # add language-specific SearchLanguage instance lang_class: Type[SearchLanguage] = languages.get(lang) # fallback; try again with language-code if lang_class is None and '_' in lang: lang_class = languages.get(lang.split('_')[0]) if lang_class is None: self.lang: SearchLanguage = SearchEnglish(options) elif isinstance(lang_class, str): module, classname = lang_class.rsplit('.', 1) lang_class = getattr(import_module(module), classname) self.lang = lang_class(options) else: # it's directly a class (e.g. added by app.add_search_language) self.lang = lang_class(options) if scoring: with open(scoring, 'rb') as fp: self.js_scorer_code = fp.read().decode() else: self.js_scorer_code = '' self.js_splitter_code = splitter_code def load(self, stream: IO, format: Any) -> None: """Reconstruct from frozen data.""" if isinstance(format, str): format = self.formats[format] frozen = format.load(stream) # if an old index is present, we treat it as not existing. if not isinstance(frozen, dict) or \ frozen.get('envversion') != self.env.version: raise ValueError('old format') index2fn = frozen['docnames'] self._filenames = dict(zip(index2fn, frozen['filenames'])) self._titles = dict(zip(index2fn, frozen['titles'])) def load_terms(mapping: Dict[str, Any]) -> Dict[str, Set[str]]: rv = {} for k, v in mapping.items(): if isinstance(v, int): rv[k] = {index2fn[v]} else: rv[k] = {index2fn[i] for i in v} return rv self._mapping = load_terms(frozen['terms']) self._title_mapping = load_terms(frozen['titleterms']) # no need to load keywords/objtypes def dump(self, stream: IO, format: Any) -> None: """Dump the frozen index to a stream.""" if isinstance(format, str): format = self.formats[format] format.dump(self.freeze(), stream) def get_objects(self, fn2index: Dict[str, int] ) -> Dict[str, List[Tuple[int, int, int, str, str]]]: rv: Dict[str, List[Tuple[int, int, int, str, str]]] = {} otypes = self._objtypes onames = self._objnames for domainname, domain in sorted(self.env.domains.items()): for fullname, dispname, type, docname, anchor, prio in \ sorted(domain.get_objects()): if docname not in fn2index: continue if prio < 0: continue fullname = html.escape(fullname) dispname = html.escape(dispname) prefix, _, name = dispname.rpartition('.') plist = rv.setdefault(prefix, []) try: typeindex = otypes[domainname, type] except KeyError: typeindex = len(otypes) otypes[domainname, type] = typeindex otype = domain.object_types.get(type) if otype: # use str() to fire translation proxies onames[typeindex] = (domainname, type, str(domain.get_type_name(otype))) else: onames[typeindex] = (domainname, type, type) if anchor == fullname: shortanchor = '' elif anchor == type + '-' + fullname: shortanchor = '-' else: shortanchor = anchor plist.append((fn2index[docname], typeindex, prio, shortanchor, name)) return rv def get_terms(self, fn2index: Dict) -> Tuple[Dict[str, List[str]], Dict[str, List[str]]]: rvs: Tuple[Dict[str, List[str]], Dict[str, List[str]]] = ({}, {}) for rv, mapping in zip(rvs, (self._mapping, self._title_mapping)): for k, v in mapping.items(): if len(v) == 1: fn, = v if fn in fn2index: rv[k] = fn2index[fn] else: rv[k] = sorted([fn2index[fn] for fn in v if fn in fn2index]) return rvs def freeze(self) -> Dict[str, Any]: """Create a usable data structure for serializing.""" docnames, titles = zip(*sorted(self._titles.items())) filenames = [self._filenames.get(docname) for docname in docnames] fn2index = {f: i for (i, f) in enumerate(docnames)} terms, title_terms = self.get_terms(fn2index) objects = self.get_objects(fn2index) # populates _objtypes objtypes = {v: k[0] + ':' + k[1] for (k, v) in self._objtypes.items()} objnames = self._objnames return dict(docnames=docnames, filenames=filenames, titles=titles, terms=terms, objects=objects, objtypes=objtypes, objnames=objnames, titleterms=title_terms, envversion=self.env.version) def label(self) -> str: return "%s (code: %s)" % (self.lang.language_name, self.lang.lang) def prune(self, docnames: Iterable[str]) -> None: """Remove data for all docnames not in the list.""" new_titles = {} new_filenames = {} for docname in docnames: if docname in self._titles: new_titles[docname] = self._titles[docname] new_filenames[docname] = self._filenames[docname] self._titles = new_titles self._filenames = new_filenames for wordnames in self._mapping.values(): wordnames.intersection_update(docnames) for wordnames in self._title_mapping.values(): wordnames.intersection_update(docnames) def feed(self, docname: str, filename: str, title: str, doctree: nodes.document) -> None: """Feed a doctree to the index.""" self._titles[docname] = title self._filenames[docname] = filename visitor = WordCollector(doctree, self.lang) doctree.walk(visitor) # memoize self.lang.stem def stem(word: str) -> str: try: return self._stem_cache[word] except KeyError: self._stem_cache[word] = self.lang.stem(word).lower() return self._stem_cache[word] _filter = self.lang.word_filter for word in visitor.found_title_words: stemmed_word = stem(word) if _filter(stemmed_word): self._title_mapping.setdefault(stemmed_word, set()).add(docname) elif _filter(word): # stemmer must not remove words from search index self._title_mapping.setdefault(word, set()).add(docname) for word in visitor.found_words: stemmed_word = stem(word) # again, stemmer must not remove words from search index if not _filter(stemmed_word) and _filter(word): stemmed_word = word already_indexed = docname in self._title_mapping.get(stemmed_word, set()) if _filter(stemmed_word) and not already_indexed: self._mapping.setdefault(stemmed_word, set()).add(docname) def context_for_searchtool(self) -> Dict[str, Any]: if self.lang.js_splitter_code: js_splitter_code = self.lang.js_splitter_code else: js_splitter_code = self.js_splitter_code return { 'search_language_stemming_code': self.get_js_stemmer_code(), 'search_language_stop_words': jsdump.dumps(sorted(self.lang.stopwords)), 'search_scorer_tool': self.js_scorer_code, 'search_word_splitter_code': js_splitter_code, } def get_js_stemmer_rawcodes(self) -> List[str]: """Returns a list of non-minified stemmer JS files to copy.""" if self.lang.js_stemmer_rawcode: return [ path.join(package_dir, 'search', 'non-minified-js', fname) for fname in ('base-stemmer.js', self.lang.js_stemmer_rawcode) ] else: return [] def get_js_stemmer_rawcode(self) -> Optional[str]: return None def get_js_stemmer_code(self) -> str: """Returns JS code that will be inserted into language_data.js.""" if self.lang.js_stemmer_rawcode: js_dir = path.join(package_dir, 'search', 'minified-js') with open(path.join(js_dir, 'base-stemmer.js')) as js_file: base_js = js_file.read() with open(path.join(js_dir, self.lang.js_stemmer_rawcode)) as js_file: language_js = js_file.read() return ('%s\n%s\nStemmer = %sStemmer;' % (base_js, language_js, self.lang.language_name)) else: return self.lang.js_stemmer_code ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/da.py��������������������������������������������������������������������0000644�0000766�0000024�00000007150�00000000000�016052� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.da ~~~~~~~~~~~~~~~~ Danish search language: includes the JS Danish stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict import snowballstemmer from sphinx.search import SearchLanguage, parse_stop_word danish_stopwords = parse_stop_word(''' | source: http://snowball.tartarus.org/algorithms/danish/stop.txt og | and i | in jeg | I det | that (dem. pronoun)/it (pers. pronoun) at | that (in front of a sentence)/to (with infinitive) en | a/an den | it (pers. pronoun)/that (dem. pronoun) til | to/at/for/until/against/by/of/into, more er | present tense of "to be" som | who, as på | on/upon/in/on/at/to/after/of/with/for, on de | they med | with/by/in, along han | he af | of/by/from/off/for/in/with/on, off for | at/for/to/from/by/of/ago, in front/before, because ikke | not der | who/which, there/those var | past tense of "to be" mig | me/myself sig | oneself/himself/herself/itself/themselves men | but et | a/an/one, one (number), someone/somebody/one har | present tense of "to have" om | round/about/for/in/a, about/around/down, if vi | we min | my havde | past tense of "to have" ham | him hun | she nu | now over | over/above/across/by/beyond/past/on/about, over/past da | then, when/as/since fra | from/off/since, off, since du | you ud | out sin | his/her/its/one's dem | them os | us/ourselves op | up man | you/one hans | his hvor | where eller | or hvad | what skal | must/shall etc. selv | myself/yourself/herself/ourselves etc., even her | here alle | all/everyone/everybody etc. vil | will (verb) blev | past tense of "to stay/to remain/to get/to become" kunne | could ind | in når | when være | present tense of "to be" dog | however/yet/after all noget | something ville | would jo | you know/you see (adv), yes deres | their/theirs efter | after/behind/according to/for/by/from, later/afterwards ned | down skulle | should denne | this end | than dette | this mit | my/mine også | also under | under/beneath/below/during, below/underneath have | have dig | you anden | other hende | her mine | my alt | everything meget | much/very, plenty of sit | his, her, its, one's sine | his, her, its, one's vor | our mod | against disse | these hvis | if din | your/yours nogle | some hos | by/at blive | be/become mange | many ad | by/through bliver | present tense of "to be/to become" hendes | her/hers været | be thi | for (conj) jer | you sådan | such, like this/like that ''') class SearchDanish(SearchLanguage): lang = 'da' language_name = 'Danish' js_stemmer_rawcode = 'danish-stemmer.js' stopwords = danish_stopwords def init(self, options: Dict) -> None: self.stemmer = snowballstemmer.stemmer('danish') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/de.py��������������������������������������������������������������������0000644�0000766�0000024�00000011234�00000000000�016054� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.de ~~~~~~~~~~~~~~~~ German search language: includes the JS German stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict import snowballstemmer from sphinx.search import SearchLanguage, parse_stop_word german_stopwords = parse_stop_word(''' |source: http://snowball.tartarus.org/algorithms/german/stop.txt aber | but alle | all allem allen aller alles als | than, as also | so am | an + dem an | at ander | other andere anderem anderen anderer anderes anderm andern anderr anders auch | also auf | on aus | out of bei | by bin | am bis | until bist | art da | there damit | with it dann | then der | the den des dem die das daß | that derselbe | the same derselben denselben desselben demselben dieselbe dieselben dasselbe dazu | to that dein | thy deine deinem deinen deiner deines denn | because derer | of those dessen | of him dich | thee dir | to thee du | thou dies | this diese diesem diesen dieser dieses doch | (several meanings) dort | (over) there durch | through ein | a eine einem einen einer eines einig | some einige einigem einigen einiger einiges einmal | once er | he ihn | him ihm | to him es | it etwas | something euer | your eure eurem euren eurer eures für | for gegen | towards gewesen | p.p. of sein hab | have habe | have haben | have hat | has hatte | had hatten | had hier | here hin | there hinter | behind ich | I mich | me mir | to me ihr | you, to her ihre ihrem ihren ihrer ihres euch | to you im | in + dem in | in indem | while ins | in + das ist | is jede | each, every jedem jeden jeder jedes jene | that jenem jenen jener jenes jetzt | now kann | can kein | no keine keinem keinen keiner keines können | can könnte | could machen | do man | one manche | some, many a manchem manchen mancher manches mein | my meine meinem meinen meiner meines mit | with muss | must musste | had to nach | to(wards) nicht | not nichts | nothing noch | still, yet nun | now nur | only ob | whether oder | or ohne | without sehr | very sein | his seine seinem seinen seiner seines selbst | self sich | herself sie | they, she ihnen | to them sind | are so | so solche | such solchem solchen solcher solches soll | shall sollte | should sondern | but sonst | else über | over um | about, around und | and uns | us unse unsem unsen unser unses unter | under viel | much vom | von + dem von | from vor | before während | while war | was waren | were warst | wast was | what weg | away, off weil | because weiter | further welche | which welchem welchen welcher welches wenn | when werde | will werden | will wie | how wieder | again will | want wir | we wird | will wirst | willst wo | where wollen | want wollte | wanted würde | would würden | would zu | to zum | zu + dem zur | zu + der zwar | indeed zwischen | between ''') class SearchGerman(SearchLanguage): lang = 'de' language_name = 'German' js_stemmer_rawcode = 'german-stemmer.js' stopwords = german_stopwords def init(self, options: Dict) -> None: self.stemmer = snowballstemmer.stemmer('german') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/en.py��������������������������������������������������������������������0000644�0000766�0000024�00000011636�00000000000�016074� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.en ~~~~~~~~~~~~~~~~ English search language: includes the JS porter stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict from sphinx.search import SearchLanguage from sphinx.util.stemmer import get_stemmer english_stopwords = set(""" a and are as at be but by for if in into is it near no not of on or such that the their then there these they this to was will with """.split()) js_porter_stemmer = """ /** * Porter Stemmer */ var Stemmer = function() { var step2list = { ational: 'ate', tional: 'tion', enci: 'ence', anci: 'ance', izer: 'ize', bli: 'ble', alli: 'al', entli: 'ent', eli: 'e', ousli: 'ous', ization: 'ize', ation: 'ate', ator: 'ate', alism: 'al', iveness: 'ive', fulness: 'ful', ousness: 'ous', aliti: 'al', iviti: 'ive', biliti: 'ble', logi: 'log' }; var step3list = { icate: 'ic', ative: '', alize: 'al', iciti: 'ic', ical: 'ic', ful: '', ness: '' }; var c = "[^aeiou]"; // consonant var v = "[aeiouy]"; // vowel var C = c + "[^aeiouy]*"; // consonant sequence var V = v + "[aeiou]*"; // vowel sequence var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 var s_v = "^(" + C + ")?" + v; // vowel in stem this.stemWord = function (w) { var stem; var suffix; var firstch; var origword = w; if (w.length < 3) return w; var re; var re2; var re3; var re4; firstch = w.substr(0,1); if (firstch == "y") w = firstch.toUpperCase() + w.substr(1); // Step 1a re = /^(.+?)(ss|i)es$/; re2 = /^(.+?)([^s])s$/; if (re.test(w)) w = w.replace(re,"$1$2"); else if (re2.test(w)) w = w.replace(re2,"$1$2"); // Step 1b re = /^(.+?)eed$/; re2 = /^(.+?)(ed|ing)$/; if (re.test(w)) { var fp = re.exec(w); re = new RegExp(mgr0); if (re.test(fp[1])) { re = /.$/; w = w.replace(re,""); } } else if (re2.test(w)) { var fp = re2.exec(w); stem = fp[1]; re2 = new RegExp(s_v); if (re2.test(stem)) { w = stem; re2 = /(at|bl|iz)$/; re3 = new RegExp("([^aeiouylsz])\\\\1$"); re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); if (re2.test(w)) w = w + "e"; else if (re3.test(w)) { re = /.$/; w = w.replace(re,""); } else if (re4.test(w)) w = w + "e"; } } // Step 1c re = /^(.+?)y$/; if (re.test(w)) { var fp = re.exec(w); stem = fp[1]; re = new RegExp(s_v); if (re.test(stem)) w = stem + "i"; } // Step 2 re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|\ ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; if (re.test(w)) { var fp = re.exec(w); stem = fp[1]; suffix = fp[2]; re = new RegExp(mgr0); if (re.test(stem)) w = stem + step2list[suffix]; } // Step 3 re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; if (re.test(w)) { var fp = re.exec(w); stem = fp[1]; suffix = fp[2]; re = new RegExp(mgr0); if (re.test(stem)) w = stem + step3list[suffix]; } // Step 4 re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|\ iti|ous|ive|ize)$/; re2 = /^(.+?)(s|t)(ion)$/; if (re.test(w)) { var fp = re.exec(w); stem = fp[1]; re = new RegExp(mgr1); if (re.test(stem)) w = stem; } else if (re2.test(w)) { var fp = re2.exec(w); stem = fp[1] + fp[2]; re2 = new RegExp(mgr1); if (re2.test(stem)) w = stem; } // Step 5 re = /^(.+?)e$/; if (re.test(w)) { var fp = re.exec(w); stem = fp[1]; re = new RegExp(mgr1); re2 = new RegExp(meq1); re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) w = stem; } re = /ll$/; re2 = new RegExp(mgr1); if (re.test(w) && re2.test(w)) { re = /.$/; w = w.replace(re,""); } // and turn initial Y back to y if (firstch == "y") w = firstch.toLowerCase() + w.substr(1); return w; } } """ class SearchEnglish(SearchLanguage): lang = 'en' language_name = 'English' js_stemmer_code = js_porter_stemmer stopwords = english_stopwords def init(self, options: Dict) -> None: self.stemmer = get_stemmer() def stem(self, word: str) -> str: return self.stemmer.stem(word.lower()) ��������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/es.py��������������������������������������������������������������������0000644�0000766�0000024�00000013332�00000000000�016074� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.es ~~~~~~~~~~~~~~~~ Spanish search language: includes the JS Spanish stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict import snowballstemmer from sphinx.search import SearchLanguage, parse_stop_word spanish_stopwords = parse_stop_word(''' |source: http://snowball.tartarus.org/algorithms/spanish/stop.txt de | from, of la | the, her que | who, that el | the en | in y | and a | to los | the, them del | de + el se | himself, from him etc las | the, them por | for, by, etc un | a para | for con | with no | no una | a su | his, her al | a + el | es from SER lo | him como | how más | more pero | pero sus | su plural le | to him, her ya | already o | or | fue from SER este | this | ha from HABER sí | himself etc porque | because esta | this | son from SER entre | between | está from ESTAR cuando | when muy | very sin | without sobre | on | ser from SER | tiene from TENER también | also me | me hasta | until hay | there is/are donde | where | han from HABER quien | whom, that | están from ESTAR | estado from ESTAR desde | from todo | all nos | us durante | during | estados from ESTAR todos | all uno | a les | to them ni | nor contra | against otros | other | fueron from SER ese | that eso | that | había from HABER ante | before ellos | they e | and (variant of y) esto | this mí | me antes | before algunos | some qué | what? unos | a yo | I otro | other otras | other otra | other él | he tanto | so much, many esa | that estos | these mucho | much, many quienes | who nada | nothing muchos | many cual | who | sea from SER poco | few ella | she estar | to be | haber from HABER estas | these | estaba from ESTAR | estamos from ESTAR algunas | some algo | something nosotros | we | other forms mi | me mis | mi plural tú | thou te | thee ti | thee tu | thy tus | tu plural ellas | they nosotras | we vosotros | you vosotras | you os | you mío | mine mía | míos | mías | tuyo | thine tuya | tuyos | tuyas | suyo | his, hers, theirs suya | suyos | suyas | nuestro | ours nuestra | nuestros | nuestras | vuestro | yours vuestra | vuestros | vuestras | esos | those esas | those | forms of estar, to be (not including the infinitive): estoy estás está estamos estáis están esté estés estemos estéis estén estaré estarás estará estaremos estaréis estarán estaría estarías estaríamos estaríais estarían estaba estabas estábamos estabais estaban estuve estuviste estuvo estuvimos estuvisteis estuvieron estuviera estuvieras estuviéramos estuvierais estuvieran estuviese estuvieses estuviésemos estuvieseis estuviesen estando estado estada estados estadas estad | forms of haber, to have (not including the infinitive): he has ha hemos habéis han haya hayas hayamos hayáis hayan habré habrás habrá habremos habréis habrán habría habrías habríamos habríais habrían había habías habíamos habíais habían hube hubiste hubo hubimos hubisteis hubieron hubiera hubieras hubiéramos hubierais hubieran hubiese hubieses hubiésemos hubieseis hubiesen habiendo habido habida habidos habidas | forms of ser, to be (not including the infinitive): soy eres es somos sois son sea seas seamos seáis sean seré serás será seremos seréis serán sería serías seríamos seríais serían era eras éramos erais eran fui fuiste fue fuimos fuisteis fueron fuera fueras fuéramos fuerais fueran fuese fueses fuésemos fueseis fuesen siendo sido | sed also means 'thirst' | forms of tener, to have (not including the infinitive): tengo tienes tiene tenemos tenéis tienen tenga tengas tengamos tengáis tengan tendré tendrás tendrá tendremos tendréis tendrán tendría tendrías tendríamos tendríais tendrían tenía tenías teníamos teníais tenían tuve tuviste tuvo tuvimos tuvisteis tuvieron tuviera tuvieras tuviéramos tuvierais tuvieran tuviese tuvieses tuviésemos tuvieseis tuviesen teniendo tenido tenida tenidos tenidas tened ''') class SearchSpanish(SearchLanguage): lang = 'es' language_name = 'Spanish' js_stemmer_rawcode = 'spanish-stemmer.js' stopwords = spanish_stopwords def init(self, options: Dict) -> None: self.stemmer = snowballstemmer.stemmer('spanish') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/fi.py��������������������������������������������������������������������0000644�0000766�0000024�00000006406�00000000000�016067� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.fi ~~~~~~~~~~~~~~~~ Finnish search language: includes the JS Finnish stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict import snowballstemmer from sphinx.search import SearchLanguage, parse_stop_word finnish_stopwords = parse_stop_word(''' | source: http://snowball.tartarus.org/algorithms/finnish/stop.txt | forms of BE olla olen olet on olemme olette ovat ole | negative form oli olisi olisit olisin olisimme olisitte olisivat olit olin olimme olitte olivat ollut olleet en | negation et ei emme ette eivät |Nom Gen Acc Part Iness Elat Illat Adess Ablat Allat Ess Trans minä minun minut minua minussa minusta minuun minulla minulta minulle | I sinä sinun sinut sinua sinussa sinusta sinuun sinulla sinulta sinulle | you hän hänen hänet häntä hänessä hänestä häneen hänellä häneltä hänelle | he she me meidän meidät meitä meissä meistä meihin meillä meiltä meille | we te teidän teidät teitä teissä teistä teihin teillä teiltä teille | you he heidän heidät heitä heissä heistä heihin heillä heiltä heille | they tämä tämän tätä tässä tästä tähän tällä tältä tälle tänä täksi | this tuo tuon tuota tuossa tuosta tuohon tuolla tuolta tuolle tuona tuoksi | that se sen sitä siinä siitä siihen sillä siltä sille sinä siksi | it nämä näiden näitä näissä näistä näihin näillä näiltä näille näinä näiksi | these nuo noiden noita noissa noista noihin noilla noilta noille noina noiksi | those ne niiden niitä niissä niistä niihin niillä niiltä niille niinä niiksi | they kuka kenen kenet ketä kenessä kenestä keneen kenellä keneltä kenelle kenenä keneksi| who ketkä keiden ketkä keitä keissä keistä keihin keillä keiltä keille keinä keiksi | (pl) mikä minkä minkä mitä missä mistä mihin millä miltä mille minä miksi | which what mitkä | (pl) joka jonka jota jossa josta johon jolla jolta jolle jona joksi | who which jotka joiden joita joissa joista joihin joilla joilta joille joina joiksi | (pl) | conjunctions että | that ja | and jos | if koska | because kuin | than mutta | but niin | so sekä | and sillä | for tai | or vaan | but vai | or vaikka | although | prepositions kanssa | with mukaan | according to noin | about poikki | across yli | over, across | other kun | when niin | so nyt | now itse | self ''') class SearchFinnish(SearchLanguage): lang = 'fi' language_name = 'Finnish' js_stemmer_rawcode = 'finnish-stemmer.js' stopwords = finnish_stopwords def init(self, options: Dict) -> None: self.stemmer = snowballstemmer.stemmer('finnish') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/fr.py��������������������������������������������������������������������0000644�0000766�0000024�00000006755�00000000000�016107� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.fr ~~~~~~~~~~~~~~~~ French search language: includes the JS French stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict import snowballstemmer from sphinx.search import SearchLanguage, parse_stop_word french_stopwords = parse_stop_word(''' | source: http://snowball.tartarus.org/algorithms/french/stop.txt au | a + le aux | a + les avec | with ce | this ces | these dans | with de | of des | de + les du | de + le elle | she en | `of them' etc et | and eux | them il | he je | I la | the le | the leur | their lui | him ma | my (fem) mais | but me | me même | same; as in moi-même (myself) etc mes | me (pl) moi | me mon | my (masc) ne | not nos | our (pl) notre | our nous | we on | one ou | where par | by pas | not pour | for qu | que before vowel que | that qui | who sa | his, her (fem) se | oneself ses | his (pl) son | his, her (masc) sur | on ta | thy (fem) te | thee tes | thy (pl) toi | thee ton | thy (masc) tu | thou un | a une | a vos | your (pl) votre | your vous | you | single letter forms c | c' d | d' j | j' l | l' à | to, at m | m' n | n' s | s' t | t' y | there | forms of être (not including the infinitive): été étée étées étés étant suis es est sommes êtes sont serai seras sera serons serez seront serais serait serions seriez seraient étais était étions étiez étaient fus fut fûmes fûtes furent sois soit soyons soyez soient fusse fusses fût fussions fussiez fussent | forms of avoir (not including the infinitive): ayant eu eue eues eus ai as avons avez ont aurai auras aura aurons aurez auront aurais aurait aurions auriez auraient avais avait avions aviez avaient eut eûmes eûtes eurent aie aies ait ayons ayez aient eusse eusses eût eussions eussiez eussent | Later additions (from Jean-Christophe Deschamps) ceci | this cela | that (added 11 Apr 2012. Omission reported by Adrien Grand) celà | that (incorrect, though common) cet | this cette | this ici | here ils | they les | the (pl) leurs | their (pl) quel | which quels | which quelle | which quelles | which sans | without soi | oneself ''') class SearchFrench(SearchLanguage): lang = 'fr' language_name = 'French' js_stemmer_rawcode = 'french-stemmer.js' stopwords = french_stopwords def init(self, options: Dict) -> None: self.stemmer = snowballstemmer.stemmer('french') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) �������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/hu.py��������������������������������������������������������������������0000644�0000766�0000024�00000004034�00000000000�016100� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.hu ~~~~~~~~~~~~~~~~ Hungarian search language: includes the JS Hungarian stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict import snowballstemmer from sphinx.search import SearchLanguage, parse_stop_word hungarian_stopwords = parse_stop_word(''' | source: http://snowball.tartarus.org/algorithms/hungarian/stop.txt | prepared by Anna Tordai a ahogy ahol aki akik akkor alatt által általában amely amelyek amelyekben amelyeket amelyet amelynek ami amit amolyan amíg amikor át abban ahhoz annak arra arról az azok azon azt azzal azért aztán azután azonban bár be belül benne cikk cikkek cikkeket csak de e eddig egész egy egyes egyetlen egyéb egyik egyre ekkor el elég ellen elő először előtt első én éppen ebben ehhez emilyen ennek erre ez ezt ezek ezen ezzel ezért és fel felé hanem hiszen hogy hogyan igen így illetve ill. ill ilyen ilyenkor ison ismét itt jó jól jobban kell kellett keresztül keressünk ki kívül között közül legalább lehet lehetett legyen lenne lenni lesz lett maga magát majd majd már más másik meg még mellett mert mely melyek mi mit míg miért milyen mikor minden mindent mindenki mindig mint mintha mivel most nagy nagyobb nagyon ne néha nekem neki nem néhány nélkül nincs olyan ott össze ő ők őket pedig persze rá s saját sem semmi sok sokat sokkal számára szemben szerint szinte talán tehát teljes tovább továbbá több úgy ugyanis új újabb újra után utána utolsó vagy vagyis valaki valami valamint való vagyok van vannak volt voltam voltak voltunk vissza vele viszont volna ''') class SearchHungarian(SearchLanguage): lang = 'hu' language_name = 'Hungarian' js_stemmer_rawcode = 'hungarian-stemmer.js' stopwords = hungarian_stopwords def init(self, options: Dict) -> None: self.stemmer = snowballstemmer.stemmer('hungarian') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/it.py��������������������������������������������������������������������0000644�0000766�0000024�00000012140�00000000000�016075� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.it ~~~~~~~~~~~~~~~~ Italian search language: includes the JS Italian stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict import snowballstemmer from sphinx.search import SearchLanguage, parse_stop_word italian_stopwords = parse_stop_word(''' | source: http://snowball.tartarus.org/algorithms/italian/stop.txt ad | a (to) before vowel al | a + il allo | a + lo ai | a + i agli | a + gli all | a + l' agl | a + gl' alla | a + la alle | a + le con | with col | con + il coi | con + i (forms collo, cogli etc are now very rare) da | from dal | da + il dallo | da + lo dai | da + i dagli | da + gli dall | da + l' dagl | da + gll' dalla | da + la dalle | da + le di | of del | di + il dello | di + lo dei | di + i degli | di + gli dell | di + l' degl | di + gl' della | di + la delle | di + le in | in nel | in + el nello | in + lo nei | in + i negli | in + gli nell | in + l' negl | in + gl' nella | in + la nelle | in + le su | on sul | su + il sullo | su + lo sui | su + i sugli | su + gli sull | su + l' sugl | su + gl' sulla | su + la sulle | su + le per | through, by tra | among contro | against io | I tu | thou lui | he lei | she noi | we voi | you loro | they mio | my mia | miei | mie | tuo | tua | tuoi | thy tue | suo | sua | suoi | his, her sue | nostro | our nostra | nostri | nostre | vostro | your vostra | vostri | vostre | mi | me ti | thee ci | us, there vi | you, there lo | him, the la | her, the li | them le | them, the gli | to him, the ne | from there etc il | the un | a uno | a una | a ma | but ed | and se | if perché | why, because anche | also come | how dov | where (as dov') dove | where che | who, that chi | who cui | whom non | not più | more quale | who, that quanto | how much quanti | quanta | quante | quello | that quelli | quella | quelle | questo | this questi | questa | queste | si | yes tutto | all tutti | all | single letter forms: a | at c | as c' for ce or ci e | and i | the l | as l' o | or | forms of avere, to have (not including the infinitive): ho hai ha abbiamo avete hanno abbia abbiate abbiano avrò avrai avrà avremo avrete avranno avrei avresti avrebbe avremmo avreste avrebbero avevo avevi aveva avevamo avevate avevano ebbi avesti ebbe avemmo aveste ebbero avessi avesse avessimo avessero avendo avuto avuta avuti avute | forms of essere, to be (not including the infinitive): sono sei è siamo siete sia siate siano sarò sarai sarà saremo sarete saranno sarei saresti sarebbe saremmo sareste sarebbero ero eri era eravamo eravate erano fui fosti fu fummo foste furono fossi fosse fossimo fossero essendo | forms of fare, to do (not including the infinitive, fa, fat-): faccio fai facciamo fanno faccia facciate facciano farò farai farà faremo farete faranno farei faresti farebbe faremmo fareste farebbero facevo facevi faceva facevamo facevate facevano feci facesti fece facemmo faceste fecero facessi facesse facessimo facessero facendo | forms of stare, to be (not including the infinitive): sto stai sta stiamo stanno stia stiate stiano starò starai starà staremo starete staranno starei staresti starebbe staremmo stareste starebbero stavo stavi stava stavamo stavate stavano stetti stesti stette stemmo steste stettero stessi stesse stessimo stessero ''') class SearchItalian(SearchLanguage): lang = 'it' language_name = 'Italian' js_stemmer_rawcode = 'italian-stemmer.js' stopwords = italian_stopwords def init(self, options: Dict) -> None: self.stemmer = snowballstemmer.stemmer('italian') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/ja.py��������������������������������������������������������������������0000644�0000766�0000024�00000075063�00000000000�016070� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.ja ~~~~~~~~~~~~~~~~ Japanese search language: includes routine to split words. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ # Python Version of TinySegmenter # (http://chasen.org/~taku/software/TinySegmenter/) # TinySegmenter is super compact Japanese tokenizer. # # TinySegmenter was originally developed by Taku Kudo <taku(at)chasen.org>. # Python Version was developed by xnights <programming.magic(at)gmail.com>. # For details, see http://programming-magic.com/?id=170 import os import re import sys from typing import Any, Dict, List try: import MeCab native_module = True except ImportError: native_module = False try: import janome.tokenizer janome_module = True except ImportError: janome_module = False from sphinx.errors import ExtensionError, SphinxError from sphinx.search import SearchLanguage from sphinx.util import import_object class BaseSplitter: def __init__(self, options: Dict) -> None: self.options = options def split(self, input: str) -> List[str]: """ :param str input: :return: :rtype: list[str] """ raise NotImplementedError class MecabSplitter(BaseSplitter): def __init__(self, options: Dict) -> None: super().__init__(options) self.ctypes_libmecab: Any = None self.ctypes_mecab: Any = None if not native_module: self.init_ctypes(options) else: self.init_native(options) self.dict_encode = options.get('dic_enc', 'utf-8') def split(self, input: str) -> List[str]: if native_module: result = self.native.parse(input) else: result = self.ctypes_libmecab.mecab_sparse_tostr( self.ctypes_mecab, input.encode(self.dict_encode)) return result.split(' ') def init_native(self, options: Dict) -> None: param = '-Owakati' dict = options.get('dict') if dict: param += ' -d %s' % dict self.native = MeCab.Tagger(param) def init_ctypes(self, options: Dict) -> None: import ctypes.util lib = options.get('lib') if lib is None: if sys.platform.startswith('win'): libname = 'libmecab.dll' else: libname = 'mecab' libpath = ctypes.util.find_library(libname) elif os.path.basename(lib) == lib: libpath = ctypes.util.find_library(lib) else: libpath = None if os.path.exists(lib): libpath = lib if libpath is None: raise RuntimeError('MeCab dynamic library is not available') param = 'mecab -Owakati' dict = options.get('dict') if dict: param += ' -d %s' % dict fs_enc = sys.getfilesystemencoding() or sys.getdefaultencoding() self.ctypes_libmecab = ctypes.CDLL(libpath) self.ctypes_libmecab.mecab_new2.argtypes = (ctypes.c_char_p,) self.ctypes_libmecab.mecab_new2.restype = ctypes.c_void_p self.ctypes_libmecab.mecab_sparse_tostr.argtypes = (ctypes.c_void_p, ctypes.c_char_p) self.ctypes_libmecab.mecab_sparse_tostr.restype = ctypes.c_char_p self.ctypes_mecab = self.ctypes_libmecab.mecab_new2(param.encode(fs_enc)) if self.ctypes_mecab is None: raise SphinxError('mecab initialization failed') def __del__(self) -> None: if self.ctypes_libmecab: self.ctypes_libmecab.mecab_destroy(self.ctypes_mecab) MeCabBinder = MecabSplitter # keep backward compatibility until Sphinx-1.6 class JanomeSplitter(BaseSplitter): def __init__(self, options: Dict) -> None: super().__init__(options) self.user_dict = options.get('user_dic') self.user_dict_enc = options.get('user_dic_enc', 'utf8') self.init_tokenizer() def init_tokenizer(self) -> None: if not janome_module: raise RuntimeError('Janome is not available') self.tokenizer = janome.tokenizer.Tokenizer(udic=self.user_dict, udic_enc=self.user_dict_enc) def split(self, input: str) -> List[str]: result = ' '.join(token.surface for token in self.tokenizer.tokenize(input)) return result.split(' ') class DefaultSplitter(BaseSplitter): patterns_ = {re.compile(pattern): value for pattern, value in { '[一二三四五六七八九十百千万億兆]': 'M', '[一-龠々〆ヵヶ]': 'H', '[ぁ-ん]': 'I', '[ァ-ヴーｱ-ﾝﾞｰ]': 'K', '[a-zA-Zａ-ｚＡ-Ｚ]': 'A', '[0-9０-９]': 'N', }.items()} BIAS__ = -332 BC1__ = {'HH': 6, 'II': 2461, 'KH': 406, 'OH': -1378} BC2__ = {'AA': -3267, 'AI': 2744, 'AN': -878, 'HH': -4070, 'HM': -1711, 'HN': 4012, 'HO': 3761, 'IA': 1327, 'IH': -1184, 'II': -1332, 'IK': 1721, 'IO': 5492, 'KI': 3831, 'KK': -8741, 'MH': -3132, 'MK': 3334, 'OO': -2920} BC3__ = {'HH': 996, 'HI': 626, 'HK': -721, 'HN': -1307, 'HO': -836, 'IH': -301, 'KK': 2762, 'MK': 1079, 'MM': 4034, 'OA': -1652, 'OH': 266} BP1__ = {'BB': 295, 'OB': 304, 'OO': -125, 'UB': 352} BP2__ = {'BO': 60, 'OO': -1762} BQ1__ = {'BHH': 1150, 'BHM': 1521, 'BII': -1158, 'BIM': 886, 'BMH': 1208, 'BNH': 449, 'BOH': -91, 'BOO': -2597, 'OHI': 451, 'OIH': -296, 'OKA': 1851, 'OKH': -1020, 'OKK': 904, 'OOO': 2965} BQ2__ = {'BHH': 118, 'BHI': -1159, 'BHM': 466, 'BIH': -919, 'BKK': -1720, 'BKO': 864, 'OHH': -1139, 'OHM': -181, 'OIH': 153, 'UHI': -1146} BQ3__ = {'BHH': -792, 'BHI': 2664, 'BII': -299, 'BKI': 419, 'BMH': 937, 'BMM': 8335, 'BNN': 998, 'BOH': 775, 'OHH': 2174, 'OHM': 439, 'OII': 280, 'OKH': 1798, 'OKI': -793, 'OKO': -2242, 'OMH': -2402, 'OOO': 11699} BQ4__ = {'BHH': -3895, 'BIH': 3761, 'BII': -4654, 'BIK': 1348, 'BKK': -1806, 'BMI': -3385, 'BOO': -12396, 'OAH': 926, 'OHH': 266, 'OHK': -2036, 'ONN': -973} BW1__ = {',と': 660, ',同': 727, 'B1あ': 1404, 'B1同': 542, '、と': 660, '、同': 727, '」と': 1682, 'あっ': 1505, 'いう': 1743, 'いっ': -2055, 'いる': 672, 'うし': -4817, 'うん': 665, 'から': 3472, 'がら': 600, 'こう': -790, 'こと': 2083, 'こん': -1262, 'さら': -4143, 'さん': 4573, 'した': 2641, 'して': 1104, 'すで': -3399, 'そこ': 1977, 'それ': -871, 'たち': 1122, 'ため': 601, 'った': 3463, 'つい': -802, 'てい': 805, 'てき': 1249, 'でき': 1127, 'です': 3445, 'では': 844, 'とい': -4915, 'とみ': 1922, 'どこ': 3887, 'ない': 5713, 'なっ': 3015, 'など': 7379, 'なん': -1113, 'にし': 2468, 'には': 1498, 'にも': 1671, 'に対': -912, 'の一': -501, 'の中': 741, 'ませ': 2448, 'まで': 1711, 'まま': 2600, 'まる': -2155, 'やむ': -1947, 'よっ': -2565, 'れた': 2369, 'れで': -913, 'をし': 1860, 'を見': 731, '亡く': -1886, '京都': 2558, '取り': -2784, '大き': -2604, '大阪': 1497, '平方': -2314, '引き': -1336, '日本': -195, '本当': -2423, '毎日': -2113, '目指': -724, 'Ｂ１あ': 1404, 'Ｂ１同': 542, '｣と': 1682} BW2__ = {'..': -11822, '11': -669, '――': -5730, '−−': -13175, 'いう': -1609, 'うか': 2490, 'かし': -1350, 'かも': -602, 'から': -7194, 'かれ': 4612, 'がい': 853, 'がら': -3198, 'きた': 1941, 'くな': -1597, 'こと': -8392, 'この': -4193, 'させ': 4533, 'され': 13168, 'さん': -3977, 'しい': -1819, 'しか': -545, 'した': 5078, 'して': 972, 'しな': 939, 'その': -3744, 'たい': -1253, 'たた': -662, 'ただ': -3857, 'たち': -786, 'たと': 1224, 'たは': -939, 'った': 4589, 'って': 1647, 'っと': -2094, 'てい': 6144, 'てき': 3640, 'てく': 2551, 'ては': -3110, 'ても': -3065, 'でい': 2666, 'でき': -1528, 'でし': -3828, 'です': -4761, 'でも': -4203, 'とい': 1890, 'とこ': -1746, 'とと': -2279, 'との': 720, 'とみ': 5168, 'とも': -3941, 'ない': -2488, 'なが': -1313, 'など': -6509, 'なの': 2614, 'なん': 3099, 'にお': -1615, 'にし': 2748, 'にな': 2454, 'によ': -7236, 'に対': -14943, 'に従': -4688, 'に関': -11388, 'のか': 2093, 'ので': -7059, 'のに': -6041, 'のの': -6125, 'はい': 1073, 'はが': -1033, 'はず': -2532, 'ばれ': 1813, 'まし': -1316, 'まで': -6621, 'まれ': 5409, 'めて': -3153, 'もい': 2230, 'もの': -10713, 'らか': -944, 'らし': -1611, 'らに': -1897, 'りし': 651, 'りま': 1620, 'れた': 4270, 'れて': 849, 'れば': 4114, 'ろう': 6067, 'われ': 7901, 'を通': -11877, 'んだ': 728, 'んな': -4115, '一人': 602, '一方': -1375, '一日': 970, '一部': -1051, '上が': -4479, '会社': -1116, '出て': 2163, '分の': -7758, '同党': 970, '同日': -913, '大阪': -2471, '委員': -1250, '少な': -1050, '年度': -8669, '年間': -1626, '府県': -2363, '手権': -1982, '新聞': -4066, '日新': -722, '日本': -7068, '日米': 3372, '曜日': -601, '朝鮮': -2355, '本人': -2697, '東京': -1543, '然と': -1384, '社会': -1276, '立て': -990, '第に': -1612, '米国': -4268, '１１': -669} BW3__ = {'あた': -2194, 'あり': 719, 'ある': 3846, 'い.': -1185, 'い。': -1185, 'いい': 5308, 'いえ': 2079, 'いく': 3029, 'いた': 2056, 'いっ': 1883, 'いる': 5600, 'いわ': 1527, 'うち': 1117, 'うと': 4798, 'えと': 1454, 'か.': 2857, 'か。': 2857, 'かけ': -743, 'かっ': -4098, 'かに': -669, 'から': 6520, 'かり': -2670, 'が,': 1816, 'が、': 1816, 'がき': -4855, 'がけ': -1127, 'がっ': -913, 'がら': -4977, 'がり': -2064, 'きた': 1645, 'けど': 1374, 'こと': 7397, 'この': 1542, 'ころ': -2757, 'さい': -714, 'さを': 976, 'し,': 1557, 'し、': 1557, 'しい': -3714, 'した': 3562, 'して': 1449, 'しな': 2608, 'しま': 1200, 'す.': -1310, 'す。': -1310, 'する': 6521, 'ず,': 3426, 'ず、': 3426, 'ずに': 841, 'そう': 428, 'た.': 8875, 'た。': 8875, 'たい': -594, 'たの': 812, 'たり': -1183, 'たる': -853, 'だ.': 4098, 'だ。': 4098, 'だっ': 1004, 'った': -4748, 'って': 300, 'てい': 6240, 'てお': 855, 'ても': 302, 'です': 1437, 'でに': -1482, 'では': 2295, 'とう': -1387, 'とし': 2266, 'との': 541, 'とも': -3543, 'どう': 4664, 'ない': 1796, 'なく': -903, 'など': 2135, 'に,': -1021, 'に、': -1021, 'にし': 1771, 'にな': 1906, 'には': 2644, 'の,': -724, 'の、': -724, 'の子': -1000, 'は,': 1337, 'は、': 1337, 'べき': 2181, 'まし': 1113, 'ます': 6943, 'まっ': -1549, 'まで': 6154, 'まれ': -793, 'らし': 1479, 'られ': 6820, 'るる': 3818, 'れ,': 854, 'れ、': 854, 'れた': 1850, 'れて': 1375, 'れば': -3246, 'れる': 1091, 'われ': -605, 'んだ': 606, 'んで': 798, 'カ月': 990, '会議': 860, '入り': 1232, '大会': 2217, '始め': 1681, '市': 965, '新聞': -5055, '日,': 974, '日、': 974, '社会': 2024, 'ｶ月': 990} TC1__ = {'AAA': 1093, 'HHH': 1029, 'HHM': 580, 'HII': 998, 'HOH': -390, 'HOM': -331, 'IHI': 1169, 'IOH': -142, 'IOI': -1015, 'IOM': 467, 'MMH': 187, 'OOI': -1832} TC2__ = {'HHO': 2088, 'HII': -1023, 'HMM': -1154, 'IHI': -1965, 'KKH': 703, 'OII': -2649} TC3__ = {'AAA': -294, 'HHH': 346, 'HHI': -341, 'HII': -1088, 'HIK': 731, 'HOH': -1486, 'IHH': 128, 'IHI': -3041, 'IHO': -1935, 'IIH': -825, 'IIM': -1035, 'IOI': -542, 'KHH': -1216, 'KKA': 491, 'KKH': -1217, 'KOK': -1009, 'MHH': -2694, 'MHM': -457, 'MHO': 123, 'MMH': -471, 'NNH': -1689, 'NNO': 662, 'OHO': -3393} TC4__ = {'HHH': -203, 'HHI': 1344, 'HHK': 365, 'HHM': -122, 'HHN': 182, 'HHO': 669, 'HIH': 804, 'HII': 679, 'HOH': 446, 'IHH': 695, 'IHO': -2324, 'IIH': 321, 'III': 1497, 'IIO': 656, 'IOO': 54, 'KAK': 4845, 'KKA': 3386, 'KKK': 3065, 'MHH': -405, 'MHI': 201, 'MMH': -241, 'MMM': 661, 'MOM': 841} TQ1__ = {'BHHH': -227, 'BHHI': 316, 'BHIH': -132, 'BIHH': 60, 'BIII': 1595, 'BNHH': -744, 'BOHH': 225, 'BOOO': -908, 'OAKK': 482, 'OHHH': 281, 'OHIH': 249, 'OIHI': 200, 'OIIH': -68} TQ2__ = {'BIHH': -1401, 'BIII': -1033, 'BKAK': -543, 'BOOO': -5591} TQ3__ = {'BHHH': 478, 'BHHM': -1073, 'BHIH': 222, 'BHII': -504, 'BIIH': -116, 'BIII': -105, 'BMHI': -863, 'BMHM': -464, 'BOMH': 620, 'OHHH': 346, 'OHHI': 1729, 'OHII': 997, 'OHMH': 481, 'OIHH': 623, 'OIIH': 1344, 'OKAK': 2792, 'OKHH': 587, 'OKKA': 679, 'OOHH': 110, 'OOII': -685} TQ4__ = {'BHHH': -721, 'BHHM': -3604, 'BHII': -966, 'BIIH': -607, 'BIII': -2181, 'OAAA': -2763, 'OAKK': 180, 'OHHH': -294, 'OHHI': 2446, 'OHHO': 480, 'OHIH': -1573, 'OIHH': 1935, 'OIHI': -493, 'OIIH': 626, 'OIII': -4007, 'OKAK': -8156} TW1__ = {'につい': -4681, '東京都': 2026} TW2__ = {'ある程': -2049, 'いった': -1256, 'ころが': -2434, 'しょう': 3873, 'その後': -4430, 'だって': -1049, 'ていた': 1833, 'として': -4657, 'ともに': -4517, 'もので': 1882, '一気に': -792, '初めて': -1512, '同時に': -8097, '大きな': -1255, '対して': -2721, '社会党': -3216} TW3__ = {'いただ': -1734, 'してい': 1314, 'として': -4314, 'につい': -5483, 'にとっ': -5989, 'に当た': -6247, 'ので,': -727, 'ので、': -727, 'のもの': -600, 'れから': -3752, '十二月': -2287} TW4__ = {'いう.': 8576, 'いう。': 8576, 'からな': -2348, 'してい': 2958, 'たが,': 1516, 'たが、': 1516, 'ている': 1538, 'という': 1349, 'ました': 5543, 'ません': 1097, 'ようと': -4258, 'よると': 5865} UC1__ = {'A': 484, 'K': 93, 'M': 645, 'O': -505} UC2__ = {'A': 819, 'H': 1059, 'I': 409, 'M': 3987, 'N': 5775, 'O': 646} UC3__ = {'A': -1370, 'I': 2311} UC4__ = {'A': -2643, 'H': 1809, 'I': -1032, 'K': -3450, 'M': 3565, 'N': 3876, 'O': 6646} UC5__ = {'H': 313, 'I': -1238, 'K': -799, 'M': 539, 'O': -831} UC6__ = {'H': -506, 'I': -253, 'K': 87, 'M': 247, 'O': -387} UP1__ = {'O': -214} UP2__ = {'B': 69, 'O': 935} UP3__ = {'B': 189} UQ1__ = {'BH': 21, 'BI': -12, 'BK': -99, 'BN': 142, 'BO': -56, 'OH': -95, 'OI': 477, 'OK': 410, 'OO': -2422} UQ2__ = {'BH': 216, 'BI': 113, 'OK': 1759} UQ3__ = {'BA': -479, 'BH': 42, 'BI': 1913, 'BK': -7198, 'BM': 3160, 'BN': 6427, 'BO': 14761, 'OI': -827, 'ON': -3212} UW1__ = {',': 156, '、': 156, '「': -463, 'あ': -941, 'う': -127, 'が': -553, 'き': 121, 'こ': 505, 'で': -201, 'と': -547, 'ど': -123, 'に': -789, 'の': -185, 'は': -847, 'も': -466, 'や': -470, 'よ': 182, 'ら': -292, 'り': 208, 'れ': 169, 'を': -446, 'ん': -137, '・': -135, '主': -402, '京': -268, '区': -912, '午': 871, '国': -460, '大': 561, '委': 729, '市': -411, '日': -141, '理': 361, '生': -408, '県': -386, '都': -718, '｢': -463, '･': -135} UW2__ = {',': -829, '、': -829, '〇': 892, '「': -645, '」': 3145, 'あ': -538, 'い': 505, 'う': 134, 'お': -502, 'か': 1454, 'が': -856, 'く': -412, 'こ': 1141, 'さ': 878, 'ざ': 540, 'し': 1529, 'す': -675, 'せ': 300, 'そ': -1011, 'た': 188, 'だ': 1837, 'つ': -949, 'て': -291, 'で': -268, 'と': -981, 'ど': 1273, 'な': 1063, 'に': -1764, 'の': 130, 'は': -409, 'ひ': -1273, 'べ': 1261, 'ま': 600, 'も': -1263, 'や': -402, 'よ': 1639, 'り': -579, 'る': -694, 'れ': 571, 'を': -2516, 'ん': 2095, 'ア': -587, 'カ': 306, 'キ': 568, 'ッ': 831, '三': -758, '不': -2150, '世': -302, '中': -968, '主': -861, '事': 492, '人': -123, '会': 978, '保': 362, '入': 548, '初': -3025, '副': -1566, '北': -3414, '区': -422, '大': -1769, '天': -865, '太': -483, '子': -1519, '学': 760, '実': 1023, '小': -2009, '市': -813, '年': -1060, '強': 1067, '手': -1519, '揺': -1033, '政': 1522, '文': -1355, '新': -1682, '日': -1815, '明': -1462, '最': -630, '朝': -1843, '本': -1650, '東': -931, '果': -665, '次': -2378, '民': -180, '気': -1740, '理': 752, '発': 529, '目': -1584, '相': -242, '県': -1165, '立': -763, '第': 810, '米': 509, '自': -1353, '行': 838, '西': -744, '見': -3874, '調': 1010, '議': 1198, '込': 3041, '開': 1758, '間': -1257, '｢': -645, '｣': 3145, 'ｯ': 831, 'ｱ': -587, 'ｶ': 306, 'ｷ': 568} UW3__ = {',': 4889, '1': -800, '−': -1723, '、': 4889, '々': -2311, '〇': 5827, '」': 2670, '〓': -3573, 'あ': -2696, 'い': 1006, 'う': 2342, 'え': 1983, 'お': -4864, 'か': -1163, 'が': 3271, 'く': 1004, 'け': 388, 'げ': 401, 'こ': -3552, 'ご': -3116, 'さ': -1058, 'し': -395, 'す': 584, 'せ': 3685, 'そ': -5228, 'た': 842, 'ち': -521, 'っ': -1444, 'つ': -1081, 'て': 6167, 'で': 2318, 'と': 1691, 'ど': -899, 'な': -2788, 'に': 2745, 'の': 4056, 'は': 4555, 'ひ': -2171, 'ふ': -1798, 'へ': 1199, 'ほ': -5516, 'ま': -4384, 'み': -120, 'め': 1205, 'も': 2323, 'や': -788, 'よ': -202, 'ら': 727, 'り': 649, 'る': 5905, 'れ': 2773, 'わ': -1207, 'を': 6620, 'ん': -518, 'ア': 551, 'グ': 1319, 'ス': 874, 'ッ': -1350, 'ト': 521, 'ム': 1109, 'ル': 1591, 'ロ': 2201, 'ン': 278, '・': -3794, '一': -1619, '下': -1759, '世': -2087, '両': 3815, '中': 653, '主': -758, '予': -1193, '二': 974, '人': 2742, '今': 792, '他': 1889, '以': -1368, '低': 811, '何': 4265, '作': -361, '保': -2439, '元': 4858, '党': 3593, '全': 1574, '公': -3030, '六': 755, '共': -1880, '円': 5807, '再': 3095, '分': 457, '初': 2475, '別': 1129, '前': 2286, '副': 4437, '力': 365, '動': -949, '務': -1872, '化': 1327, '北': -1038, '区': 4646, '千': -2309, '午': -783, '協': -1006, '口': 483, '右': 1233, '各': 3588, '合': -241, '同': 3906, '和': -837, '員': 4513, '国': 642, '型': 1389, '場': 1219, '外': -241, '妻': 2016, '学': -1356, '安': -423, '実': -1008, '家': 1078, '小': -513, '少': -3102, '州': 1155, '市': 3197, '平': -1804, '年': 2416, '広': -1030, '府': 1605, '度': 1452, '建': -2352, '当': -3885, '得': 1905, '思': -1291, '性': 1822, '戸': -488, '指': -3973, '政': -2013, '教': -1479, '数': 3222, '文': -1489, '新': 1764, '日': 2099, '旧': 5792, '昨': -661, '時': -1248, '曜': -951, '最': -937, '月': 4125, '期': 360, '李': 3094, '村': 364, '東': -805, '核': 5156, '森': 2438, '業': 484, '氏': 2613, '民': -1694, '決': -1073, '法': 1868, '海': -495, '無': 979, '物': 461, '特': -3850, '生': -273, '用': 914, '町': 1215, '的': 7313, '直': -1835, '省': 792, '県': 6293, '知': -1528, '私': 4231, '税': 401, '立': -960, '第': 1201, '米': 7767, '系': 3066, '約': 3663, '級': 1384, '統': -4229, '総': 1163, '線': 1255, '者': 6457, '能': 725, '自': -2869, '英': 785, '見': 1044, '調': -562, '財': -733, '費': 1777, '車': 1835, '軍': 1375, '込': -1504, '通': -1136, '選': -681, '郎': 1026, '郡': 4404, '部': 1200, '金': 2163, '長': 421, '開': -1432, '間': 1302, '関': -1282, '雨': 2009, '電': -1045, '非': 2066, '駅': 1620, '１': -800, '｣': 2670, '･': -3794, 'ｯ': -1350, 'ｱ': 551, 'ｸﾞ': 1319, 'ｽ': 874, 'ﾄ': 521, 'ﾑ': 1109, 'ﾙ': 1591, 'ﾛ': 2201, 'ﾝ': 278} UW4__ = {',': 3930, '.': 3508, '―': -4841, '、': 3930, '。': 3508, '〇': 4999, '「': 1895, '」': 3798, '〓': -5156, 'あ': 4752, 'い': -3435, 'う': -640, 'え': -2514, 'お': 2405, 'か': 530, 'が': 6006, 'き': -4482, 'ぎ': -3821, 'く': -3788, 'け': -4376, 'げ': -4734, 'こ': 2255, 'ご': 1979, 'さ': 2864, 'し': -843, 'じ': -2506, 'す': -731, 'ず': 1251, 'せ': 181, 'そ': 4091, 'た': 5034, 'だ': 5408, 'ち': -3654, 'っ': -5882, 'つ': -1659, 'て': 3994, 'で': 7410, 'と': 4547, 'な': 5433, 'に': 6499, 'ぬ': 1853, 'ね': 1413, 'の': 7396, 'は': 8578, 'ば': 1940, 'ひ': 4249, 'び': -4134, 'ふ': 1345, 'へ': 6665, 'べ': -744, 'ほ': 1464, 'ま': 1051, 'み': -2082, 'む': -882, 'め': -5046, 'も': 4169, 'ゃ': -2666, 'や': 2795, 'ょ': -1544, 'よ': 3351, 'ら': -2922, 'り': -9726, 'る': -14896, 'れ': -2613, 'ろ': -4570, 'わ': -1783, 'を': 13150, 'ん': -2352, 'カ': 2145, 'コ': 1789, 'セ': 1287, 'ッ': -724, 'ト': -403, 'メ': -1635, 'ラ': -881, 'リ': -541, 'ル': -856, 'ン': -3637, '・': -4371, 'ー': -11870, '一': -2069, '中': 2210, '予': 782, '事': -190, '井': -1768, '人': 1036, '以': 544, '会': 950, '体': -1286, '作': 530, '側': 4292, '先': 601, '党': -2006, '共': -1212, '内': 584, '円': 788, '初': 1347, '前': 1623, '副': 3879, '力': -302, '動': -740, '務': -2715, '化': 776, '区': 4517, '協': 1013, '参': 1555, '合': -1834, '和': -681, '員': -910, '器': -851, '回': 1500, '国': -619, '園': -1200, '地': 866, '場': -1410, '塁': -2094, '士': -1413, '多': 1067, '大': 571, '子': -4802, '学': -1397, '定': -1057, '寺': -809, '小': 1910, '屋': -1328, '山': -1500, '島': -2056, '川': -2667, '市': 2771, '年': 374, '庁': -4556, '後': 456, '性': 553, '感': 916, '所': -1566, '支': 856, '改': 787, '政': 2182, '教': 704, '文': 522, '方': -856, '日': 1798, '時': 1829, '最': 845, '月': -9066, '木': -485, '来': -442, '校': -360, '業': -1043, '氏': 5388, '民': -2716, '気': -910, '沢': -939, '済': -543, '物': -735, '率': 672, '球': -1267, '生': -1286, '産': -1101, '田': -2900, '町': 1826, '的': 2586, '目': 922, '省': -3485, '県': 2997, '空': -867, '立': -2112, '第': 788, '米': 2937, '系': 786, '約': 2171, '経': 1146, '統': -1169, '総': 940, '線': -994, '署': 749, '者': 2145, '能': -730, '般': -852, '行': -792, '規': 792, '警': -1184, '議': -244, '谷': -1000, '賞': 730, '車': -1481, '軍': 1158, '輪': -1433, '込': -3370, '近': 929, '道': -1291, '選': 2596, '郎': -4866, '都': 1192, '野': -1100, '銀': -2213, '長': 357, '間': -2344, '院': -2297, '際': -2604, '電': -878, '領': -1659, '題': -792, '館': -1984, '首': 1749, '高': 2120, '｢': 1895, '｣': 3798, '･': -4371, 'ｯ': -724, 'ｰ': -11870, 'ｶ': 2145, 'ｺ': 1789, 'ｾ': 1287, 'ﾄ': -403, 'ﾒ': -1635, 'ﾗ': -881, 'ﾘ': -541, 'ﾙ': -856, 'ﾝ': -3637} UW5__ = {',': 465, '.': -299, '1': -514, 'E2': -32768, ']': -2762, '、': 465, '。': -299, '「': 363, 'あ': 1655, 'い': 331, 'う': -503, 'え': 1199, 'お': 527, 'か': 647, 'が': -421, 'き': 1624, 'ぎ': 1971, 'く': 312, 'げ': -983, 'さ': -1537, 'し': -1371, 'す': -852, 'だ': -1186, 'ち': 1093, 'っ': 52, 'つ': 921, 'て': -18, 'で': -850, 'と': -127, 'ど': 1682, 'な': -787, 'に': -1224, 'の': -635, 'は': -578, 'べ': 1001, 'み': 502, 'め': 865, 'ゃ': 3350, 'ょ': 854, 'り': -208, 'る': 429, 'れ': 504, 'わ': 419, 'を': -1264, 'ん': 327, 'イ': 241, 'ル': 451, 'ン': -343, '中': -871, '京': 722, '会': -1153, '党': -654, '務': 3519, '区': -901, '告': 848, '員': 2104, '大': -1296, '学': -548, '定': 1785, '嵐': -1304, '市': -2991, '席': 921, '年': 1763, '思': 872, '所': -814, '挙': 1618, '新': -1682, '日': 218, '月': -4353, '査': 932, '格': 1356, '機': -1508, '氏': -1347, '田': 240, '町': -3912, '的': -3149, '相': 1319, '省': -1052, '県': -4003, '研': -997, '社': -278, '空': -813, '統': 1955, '者': -2233, '表': 663, '語': -1073, '議': 1219, '選': -1018, '郎': -368, '長': 786, '間': 1191, '題': 2368, '館': -689, '１': -514, 'Ｅ２': -32768, '｢': 363, 'ｲ': 241, 'ﾙ': 451, 'ﾝ': -343} UW6__ = {',': 227, '.': 808, '1': -270, 'E1': 306, '、': 227, '。': 808, 'あ': -307, 'う': 189, 'か': 241, 'が': -73, 'く': -121, 'こ': -200, 'じ': 1782, 'す': 383, 'た': -428, 'っ': 573, 'て': -1014, 'で': 101, 'と': -105, 'な': -253, 'に': -149, 'の': -417, 'は': -236, 'も': -206, 'り': 187, 'る': -135, 'を': 195, 'ル': -673, 'ン': -496, '一': -277, '中': 201, '件': -800, '会': 624, '前': 302, '区': 1792, '員': -1212, '委': 798, '学': -960, '市': 887, '広': -695, '後': 535, '業': -697, '相': 753, '社': -507, '福': 974, '空': -822, '者': 1811, '連': 463, '郎': 1082, '１': -270, 'Ｅ１': 306, 'ﾙ': -673, 'ﾝ': -496} # ctype_ def ctype_(self, char: str) -> str: for pattern, value in self.patterns_.items(): if pattern.match(char): return value return 'O' # ts_ def ts_(self, dict: Dict[str, int], key: str) -> int: if key in dict: return dict[key] return 0 # segment def split(self, input: str) -> List[str]: if not input: return [] result = [] seg = ['B3', 'B2', 'B1'] ctype = ['O', 'O', 'O'] for t in input: seg.append(t) ctype.append(self.ctype_(t)) seg.append('E1') seg.append('E2') seg.append('E3') ctype.append('O') ctype.append('O') ctype.append('O') word = seg[3] p1 = 'U' p2 = 'U' p3 = 'U' for i in range(4, len(seg) - 3): score = self.BIAS__ w1 = seg[i-3] w2 = seg[i-2] w3 = seg[i-1] w4 = seg[i] w5 = seg[i+1] w6 = seg[i+2] c1 = ctype[i-3] c2 = ctype[i-2] c3 = ctype[i-1] c4 = ctype[i] c5 = ctype[i+1] c6 = ctype[i+2] score += self.ts_(self.UP1__, p1) score += self.ts_(self.UP2__, p2) score += self.ts_(self.UP3__, p3) score += self.ts_(self.BP1__, p1 + p2) score += self.ts_(self.BP2__, p2 + p3) score += self.ts_(self.UW1__, w1) score += self.ts_(self.UW2__, w2) score += self.ts_(self.UW3__, w3) score += self.ts_(self.UW4__, w4) score += self.ts_(self.UW5__, w5) score += self.ts_(self.UW6__, w6) score += self.ts_(self.BW1__, w2 + w3) score += self.ts_(self.BW2__, w3 + w4) score += self.ts_(self.BW3__, w4 + w5) score += self.ts_(self.TW1__, w1 + w2 + w3) score += self.ts_(self.TW2__, w2 + w3 + w4) score += self.ts_(self.TW3__, w3 + w4 + w5) score += self.ts_(self.TW4__, w4 + w5 + w6) score += self.ts_(self.UC1__, c1) score += self.ts_(self.UC2__, c2) score += self.ts_(self.UC3__, c3) score += self.ts_(self.UC4__, c4) score += self.ts_(self.UC5__, c5) score += self.ts_(self.UC6__, c6) score += self.ts_(self.BC1__, c2 + c3) score += self.ts_(self.BC2__, c3 + c4) score += self.ts_(self.BC3__, c4 + c5) score += self.ts_(self.TC1__, c1 + c2 + c3) score += self.ts_(self.TC2__, c2 + c3 + c4) score += self.ts_(self.TC3__, c3 + c4 + c5) score += self.ts_(self.TC4__, c4 + c5 + c6) # score += self.ts_(self.TC5__, c4 + c5 + c6) score += self.ts_(self.UQ1__, p1 + c1) score += self.ts_(self.UQ2__, p2 + c2) score += self.ts_(self.UQ1__, p3 + c3) score += self.ts_(self.BQ1__, p2 + c2 + c3) score += self.ts_(self.BQ2__, p2 + c3 + c4) score += self.ts_(self.BQ3__, p3 + c2 + c3) score += self.ts_(self.BQ4__, p3 + c3 + c4) score += self.ts_(self.TQ1__, p2 + c1 + c2 + c3) score += self.ts_(self.TQ2__, p2 + c2 + c3 + c4) score += self.ts_(self.TQ3__, p3 + c1 + c2 + c3) score += self.ts_(self.TQ4__, p3 + c2 + c3 + c4) p = 'O' if score > 0: result.append(word.strip()) word = '' p = 'B' p1 = p2 p2 = p3 p3 = p word += seg[i] result.append(word.strip()) return result TinySegmenter = DefaultSplitter # keep backward compatibility until Sphinx-1.6 class SearchJapanese(SearchLanguage): """ Japanese search implementation: uses no stemmer, but word splitting is quite complicated. """ lang = 'ja' language_name = 'Japanese' def init(self, options: Dict) -> None: dotted_path = options.get('type', 'sphinx.search.ja.DefaultSplitter') try: self.splitter = import_object(dotted_path)(options) except ExtensionError as exc: raise ExtensionError("Splitter module %r can't be imported" % dotted_path) from exc def split(self, input: str) -> List[str]: return self.splitter.split(input) def word_filter(self, stemmed_word: str) -> bool: return len(stemmed_word) > 1 def stem(self, word: str) -> str: return word �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/jssplitter.py������������������������������������������������������������0000644�0000766�0000024�00000014473�00000000000�017677� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.jssplitter ~~~~~~~~~~~~~~~~~~~~~~~~ Provides Python compatible word splitter to JavaScript DO NOT EDIT. This is generated by utils/jssplitter_generator.py :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ splitter_code = """ var splitChars = (function() { var result = {}; var singles = [96, 180, 187, 191, 215, 247, 749, 885, 903, 907, 909, 930, 1014, 1648, 1748, 1809, 2416, 2473, 2481, 2526, 2601, 2609, 2612, 2615, 2653, 2702, 2706, 2729, 2737, 2740, 2857, 2865, 2868, 2910, 2928, 2948, 2961, 2971, 2973, 3085, 3089, 3113, 3124, 3213, 3217, 3241, 3252, 3295, 3341, 3345, 3369, 3506, 3516, 3633, 3715, 3721, 3736, 3744, 3748, 3750, 3756, 3761, 3781, 3912, 4239, 4347, 4681, 4695, 4697, 4745, 4785, 4799, 4801, 4823, 4881, 5760, 5901, 5997, 6313, 7405, 8024, 8026, 8028, 8030, 8117, 8125, 8133, 8181, 8468, 8485, 8487, 8489, 8494, 8527, 11311, 11359, 11687, 11695, 11703, 11711, 11719, 11727, 11735, 12448, 12539, 43010, 43014, 43019, 43587, 43696, 43713, 64286, 64297, 64311, 64317, 64319, 64322, 64325, 65141]; var i, j, start, end; for (i = 0; i < singles.length; i++) { result[singles[i]] = true; } var ranges = [[0, 47], [58, 64], [91, 94], [123, 169], [171, 177], [182, 184], [706, 709], [722, 735], [741, 747], [751, 879], [888, 889], [894, 901], [1154, 1161], [1318, 1328], [1367, 1368], [1370, 1376], [1416, 1487], [1515, 1519], [1523, 1568], [1611, 1631], [1642, 1645], [1750, 1764], [1767, 1773], [1789, 1790], [1792, 1807], [1840, 1868], [1958, 1968], [1970, 1983], [2027, 2035], [2038, 2041], [2043, 2047], [2070, 2073], [2075, 2083], [2085, 2087], [2089, 2307], [2362, 2364], [2366, 2383], [2385, 2391], [2402, 2405], [2419, 2424], [2432, 2436], [2445, 2446], [2449, 2450], [2483, 2485], [2490, 2492], [2494, 2509], [2511, 2523], [2530, 2533], [2546, 2547], [2554, 2564], [2571, 2574], [2577, 2578], [2618, 2648], [2655, 2661], [2672, 2673], [2677, 2692], [2746, 2748], [2750, 2767], [2769, 2783], [2786, 2789], [2800, 2820], [2829, 2830], [2833, 2834], [2874, 2876], [2878, 2907], [2914, 2917], [2930, 2946], [2955, 2957], [2966, 2968], [2976, 2978], [2981, 2983], [2987, 2989], [3002, 3023], [3025, 3045], [3059, 3076], [3130, 3132], [3134, 3159], [3162, 3167], [3170, 3173], [3184, 3191], [3199, 3204], [3258, 3260], [3262, 3293], [3298, 3301], [3312, 3332], [3386, 3388], [3390, 3423], [3426, 3429], [3446, 3449], [3456, 3460], [3479, 3481], [3518, 3519], [3527, 3584], [3636, 3647], [3655, 3663], [3674, 3712], [3717, 3718], [3723, 3724], [3726, 3731], [3752, 3753], [3764, 3772], [3774, 3775], [3783, 3791], [3802, 3803], [3806, 3839], [3841, 3871], [3892, 3903], [3949, 3975], [3980, 4095], [4139, 4158], [4170, 4175], [4182, 4185], [4190, 4192], [4194, 4196], [4199, 4205], [4209, 4212], [4226, 4237], [4250, 4255], [4294, 4303], [4349, 4351], [4686, 4687], [4702, 4703], [4750, 4751], [4790, 4791], [4806, 4807], [4886, 4887], [4955, 4968], [4989, 4991], [5008, 5023], [5109, 5120], [5741, 5742], [5787, 5791], [5867, 5869], [5873, 5887], [5906, 5919], [5938, 5951], [5970, 5983], [6001, 6015], [6068, 6102], [6104, 6107], [6109, 6111], [6122, 6127], [6138, 6159], [6170, 6175], [6264, 6271], [6315, 6319], [6390, 6399], [6429, 6469], [6510, 6511], [6517, 6527], [6572, 6592], [6600, 6607], [6619, 6655], [6679, 6687], [6741, 6783], [6794, 6799], [6810, 6822], [6824, 6916], [6964, 6980], [6988, 6991], [7002, 7042], [7073, 7085], [7098, 7167], [7204, 7231], [7242, 7244], [7294, 7400], [7410, 7423], [7616, 7679], [7958, 7959], [7966, 7967], [8006, 8007], [8014, 8015], [8062, 8063], [8127, 8129], [8141, 8143], [8148, 8149], [8156, 8159], [8173, 8177], [8189, 8303], [8306, 8307], [8314, 8318], [8330, 8335], [8341, 8449], [8451, 8454], [8456, 8457], [8470, 8472], [8478, 8483], [8506, 8507], [8512, 8516], [8522, 8525], [8586, 9311], [9372, 9449], [9472, 10101], [10132, 11263], [11493, 11498], [11503, 11516], [11518, 11519], [11558, 11567], [11622, 11630], [11632, 11647], [11671, 11679], [11743, 11822], [11824, 12292], [12296, 12320], [12330, 12336], [12342, 12343], [12349, 12352], [12439, 12444], [12544, 12548], [12590, 12592], [12687, 12689], [12694, 12703], [12728, 12783], [12800, 12831], [12842, 12880], [12896, 12927], [12938, 12976], [12992, 13311], [19894, 19967], [40908, 40959], [42125, 42191], [42238, 42239], [42509, 42511], [42540, 42559], [42592, 42593], [42607, 42622], [42648, 42655], [42736, 42774], [42784, 42785], [42889, 42890], [42893, 43002], [43043, 43055], [43062, 43071], [43124, 43137], [43188, 43215], [43226, 43249], [43256, 43258], [43260, 43263], [43302, 43311], [43335, 43359], [43389, 43395], [43443, 43470], [43482, 43519], [43561, 43583], [43596, 43599], [43610, 43615], [43639, 43641], [43643, 43647], [43698, 43700], [43703, 43704], [43710, 43711], [43715, 43738], [43742, 43967], [44003, 44015], [44026, 44031], [55204, 55215], [55239, 55242], [55292, 55295], [57344, 63743], [64046, 64047], [64110, 64111], [64218, 64255], [64263, 64274], [64280, 64284], [64434, 64466], [64830, 64847], [64912, 64913], [64968, 65007], [65020, 65135], [65277, 65295], [65306, 65312], [65339, 65344], [65371, 65381], [65471, 65473], [65480, 65481], [65488, 65489], [65496, 65497]]; for (i = 0; i < ranges.length; i++) { start = ranges[i][0]; end = ranges[i][1]; for (j = start; j <= end; j++) { result[j] = true; } } return result; })(); function splitQuery(query) { var result = []; var start = -1; for (var i = 0; i < query.length; i++) { if (splitChars[query.charCodeAt(i)]) { if (start !== -1) { result.push(query.slice(start, i)); start = -1; } } else if (start === -1) { start = i; } } if (start !== -1) { result.push(query.slice(start)); } return result; } """ �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5270965 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/�������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017307� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/base-stemmer.js����������������������������������������������0000644�0000766�0000024�00000007012�00000000000�022231� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������BaseStemmer=function(){this.setCurrent=function(r){this.current=r;this.cursor=0;this.limit=this.current.length;this.limit_backward=0;this.bra=this.cursor;this.ket=this.limit};this.getCurrent=function(){return this.current};this.copy_from=function(r){this.current=r.current;this.cursor=r.cursor;this.limit=r.limit;this.limit_backward=r.limit_backward;this.bra=r.bra;this.ket=r.ket};this.in_grouping=function(r,t,i){if(this.cursor>=this.limit)return false;var s=this.current.charCodeAt(this.cursor);if(s>i||s<t)return false;s-=t;if((r[s>>>3]&1<<(s&7))==0)return false;this.cursor++;return true};this.in_grouping_b=function(r,t,i){if(this.cursor<=this.limit_backward)return false;var s=this.current.charCodeAt(this.cursor-1);if(s>i||s<t)return false;s-=t;if((r[s>>>3]&1<<(s&7))==0)return false;this.cursor--;return true};this.out_grouping=function(r,t,i){if(this.cursor>=this.limit)return false;var s=this.current.charCodeAt(this.cursor);if(s>i||s<t){this.cursor++;return true}s-=t;if((r[s>>>3]&1<<(s&7))==0){this.cursor++;return true}return false};this.out_grouping_b=function(r,t,i){if(this.cursor<=this.limit_backward)return false;var s=this.current.charCodeAt(this.cursor-1);if(s>i||s<t){this.cursor--;return true}s-=t;if((r[s>>>3]&1<<(s&7))==0){this.cursor--;return true}return false};this.eq_s=function(r){if(this.limit-this.cursor<r.length)return false;if(this.current.slice(this.cursor,this.cursor+r.length)!=r){return false}this.cursor+=r.length;return true};this.eq_s_b=function(r){if(this.cursor-this.limit_backward<r.length)return false;if(this.current.slice(this.cursor-r.length,this.cursor)!=r){return false}this.cursor-=r.length;return true};this.find_among=function(r){var t=0;var i=r.length;var s=this.cursor;var e=this.limit;var h=0;var u=0;var n=false;while(true){var c=t+(i-t>>>1);var a=0;var f=h<u?h:u;var l=r[c];var o;for(o=f;o<l[0].length;o++){if(s+f==e){a=-1;break}a=this.current.charCodeAt(s+f)-l[0].charCodeAt(o);if(a!=0)break;f++}if(a<0){i=c;u=f}else{t=c;h=f}if(i-t<=1){if(t>0)break;if(i==t)break;if(n)break;n=true}}do{var l=r[t];if(h>=l[0].length){this.cursor=s+l[0].length;if(l.length<4)return l[2];var v=l[3](this);this.cursor=s+l[0].length;if(v)return l[2]}t=l[1]}while(t>=0);return 0};this.find_among_b=function(r){var t=0;var i=r.length;var s=this.cursor;var e=this.limit_backward;var h=0;var u=0;var n=false;while(true){var c=t+(i-t>>1);var a=0;var f=h<u?h:u;var l=r[c];var o;for(o=l[0].length-1-f;o>=0;o--){if(s-f==e){a=-1;break}a=this.current.charCodeAt(s-1-f)-l[0].charCodeAt(o);if(a!=0)break;f++}if(a<0){i=c;u=f}else{t=c;h=f}if(i-t<=1){if(t>0)break;if(i==t)break;if(n)break;n=true}}do{var l=r[t];if(h>=l[0].length){this.cursor=s-l[0].length;if(l.length<4)return l[2];var v=l[3](this);this.cursor=s-l[0].length;if(v)return l[2]}t=l[1]}while(t>=0);return 0};this.replace_s=function(r,t,i){var s=i.length-(t-r);this.current=this.current.slice(0,r)+i+this.current.slice(t);this.limit+=s;if(this.cursor>=t)this.cursor+=s;else if(this.cursor>r)this.cursor=r;return s};this.slice_check=function(){if(this.bra<0||this.bra>this.ket||this.ket>this.limit||this.limit>this.current.length){return false}return true};this.slice_from=function(r){var t=false;if(this.slice_check()){this.replace_s(this.bra,this.ket,r);t=true}return t};this.slice_del=function(){return this.slice_from("")};this.insert=function(r,t,i){var s=this.replace_s(r,t,i);if(r<=this.bra)this.bra+=s;if(r<=this.ket)this.ket+=s};this.slice_to=function(){var r="";if(this.slice_check()){r=this.current.slice(this.bra,this.ket)}return r};this.assign_to=function(){return this.current.slice(0,this.limit)}};����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/danish-stemmer.js��������������������������������������������0000644�0000766�0000024�00000006063�00000000000�022572� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������DanishStemmer=function(){var r=new BaseStemmer;var e=[["hed",-1,1],["ethed",0,1],["ered",-1,1],["e",-1,1],["erede",3,1],["ende",3,1],["erende",5,1],["ene",3,1],["erne",3,1],["ere",3,1],["en",-1,1],["heden",10,1],["eren",10,1],["er",-1,1],["heder",13,1],["erer",13,1],["s",-1,2],["heds",16,1],["es",16,1],["endes",18,1],["erendes",19,1],["enes",18,1],["ernes",18,1],["eres",18,1],["ens",16,1],["hedens",24,1],["erens",24,1],["ers",16,1],["ets",16,1],["erets",28,1],["et",-1,1],["eret",30,1]];var i=[["gd",-1,-1],["dt",-1,-1],["gt",-1,-1],["kt",-1,-1]];var s=[["ig",-1,1],["lig",0,1],["elig",1,1],["els",-1,1],["løst",-1,2]];var t=[119,223,119,1];var a=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,48,0,128];var u=[239,254,42,3,0,0,0,0,0,0,0,0,0,0,0,0,16];var c=0;var l=0;var n="";function o(){l=r.limit;var e=r.cursor;{var i=r.cursor+3;if(i>r.limit){return false}r.cursor=i}c=r.cursor;r.cursor=e;r:while(true){var s=r.cursor;e:{if(!r.in_grouping(a,97,248)){break e}r.cursor=s;break r}r.cursor=s;if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){e:{if(!r.out_grouping(a,97,248)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}l=r.cursor;r:{if(!(l<c)){break r}l=c}return true}function f(){var i;if(r.cursor<l){return false}var s=r.limit_backward;r.limit_backward=l;r.ket=r.cursor;i=r.find_among_b(e);if(i==0){r.limit_backward=s;return false}r.bra=r.cursor;r.limit_backward=s;switch(i){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.in_grouping_b(u,97,229)){return false}if(!r.slice_del()){return false}break}return true}function m(){var e=r.limit-r.cursor;if(r.cursor<l){return false}var s=r.limit_backward;r.limit_backward=l;r.ket=r.cursor;if(r.find_among_b(i)==0){r.limit_backward=s;return false}r.bra=r.cursor;r.limit_backward=s;r.cursor=r.limit-e;if(r.cursor<=r.limit_backward){return false}r.cursor--;r.bra=r.cursor;if(!r.slice_del()){return false}return true}function _(){var e;var i=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("st")){break r}r.bra=r.cursor;if(!r.eq_s_b("ig")){break r}if(!r.slice_del()){return false}}r.cursor=r.limit-i;if(r.cursor<l){return false}var t=r.limit_backward;r.limit_backward=l;r.ket=r.cursor;e=r.find_among_b(s);if(e==0){r.limit_backward=t;return false}r.bra=r.cursor;r.limit_backward=t;switch(e){case 1:if(!r.slice_del()){return false}var a=r.limit-r.cursor;m();r.cursor=r.limit-a;break;case 2:if(!r.slice_from("løs")){return false}break}return true}function b(){if(r.cursor<l){return false}var e=r.limit_backward;r.limit_backward=l;r.ket=r.cursor;if(!r.in_grouping_b(t,98,122)){r.limit_backward=e;return false}r.bra=r.cursor;n=r.slice_to();if(n==""){return false}r.limit_backward=e;if(!r.eq_s_b(n)){return false}if(!r.slice_del()){return false}return true}this.stem=function(){var e=r.cursor;o();r.cursor=e;r.limit_backward=r.cursor;r.cursor=r.limit;var i=r.limit-r.cursor;f();r.cursor=r.limit-i;var s=r.limit-r.cursor;m();r.cursor=r.limit-s;var t=r.limit-r.cursor;_();r.cursor=r.limit-t;var a=r.limit-r.cursor;b();r.cursor=r.limit-a;r.cursor=r.limit_backward;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}};�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/dutch-stemmer.js���������������������������������������������0000644�0000766�0000024�00000012631�00000000000�022431� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������DutchStemmer=function(){var r=new BaseStemmer;var e=[["",-1,6],["á",0,1],["ä",0,1],["é",0,2],["ë",0,2],["í",0,3],["ï",0,3],["ó",0,4],["ö",0,4],["ú",0,5],["ü",0,5]];var i=[["",-1,3],["I",0,2],["Y",0,1]];var u=[["dd",-1,-1],["kk",-1,-1],["tt",-1,-1]];var s=[["ene",-1,2],["se",-1,3],["en",-1,2],["heden",2,1],["s",-1,3]];var a=[["end",-1,1],["ig",-1,2],["ing",-1,1],["lijk",-1,3],["baar",-1,4],["bar",-1,5]];var t=[["aa",-1,-1],["ee",-1,-1],["oo",-1,-1],["uu",-1,-1]];var c=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128];var o=[1,0,0,17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128];var f=[17,67,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128];var l=0;var n=0;var b=false;function k(){var i;var u=r.cursor;while(true){var s=r.cursor;r:{r.bra=r.cursor;i=r.find_among(e);if(i==0){break r}r.ket=r.cursor;switch(i){case 1:if(!r.slice_from("a")){return false}break;case 2:if(!r.slice_from("e")){return false}break;case 3:if(!r.slice_from("i")){return false}break;case 4:if(!r.slice_from("o")){return false}break;case 5:if(!r.slice_from("u")){return false}break;case 6:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=s;break}r.cursor=u;var a=r.cursor;r:{r.bra=r.cursor;if(!r.eq_s("y")){r.cursor=a;break r}r.ket=r.cursor;if(!r.slice_from("Y")){return false}}while(true){var t=r.cursor;r:{e:while(true){var o=r.cursor;i:{if(!r.in_grouping(c,97,232)){break i}r.bra=r.cursor;u:{var f=r.cursor;s:{if(!r.eq_s("i")){break s}r.ket=r.cursor;if(!r.in_grouping(c,97,232)){break s}if(!r.slice_from("I")){return false}break u}r.cursor=f;if(!r.eq_s("y")){break i}r.ket=r.cursor;if(!r.slice_from("Y")){return false}}r.cursor=o;break e}r.cursor=o;if(r.cursor>=r.limit){break r}r.cursor++}continue}r.cursor=t;break}return true}function _(){n=r.limit;l=r.limit;r:while(true){e:{if(!r.in_grouping(c,97,232)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){e:{if(!r.out_grouping(c,97,232)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}n=r.cursor;r:{if(!(n<3)){break r}n=3}r:while(true){e:{if(!r.in_grouping(c,97,232)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){e:{if(!r.out_grouping(c,97,232)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}l=r.cursor;return true}function m(){var e;while(true){var u=r.cursor;r:{r.bra=r.cursor;e=r.find_among(i);if(e==0){break r}r.ket=r.cursor;switch(e){case 1:if(!r.slice_from("y")){return false}break;case 2:if(!r.slice_from("i")){return false}break;case 3:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=u;break}return true}function v(){if(!(n<=r.cursor)){return false}return true}function g(){if(!(l<=r.cursor)){return false}return true}function d(){var e=r.limit-r.cursor;if(r.find_among_b(u)==0){return false}r.cursor=r.limit-e;r.ket=r.cursor;if(r.cursor<=r.limit_backward){return false}r.cursor--;r.bra=r.cursor;if(!r.slice_del()){return false}return true}function h(){b=false;r.ket=r.cursor;if(!r.eq_s_b("e")){return false}r.bra=r.cursor;if(!v()){return false}var e=r.limit-r.cursor;if(!r.out_grouping_b(c,97,232)){return false}r.cursor=r.limit-e;if(!r.slice_del()){return false}b=true;if(!d()){return false}return true}function w(){if(!v()){return false}var e=r.limit-r.cursor;if(!r.out_grouping_b(c,97,232)){return false}r.cursor=r.limit-e;{var i=r.limit-r.cursor;r:{if(!r.eq_s_b("gem")){break r}return false}r.cursor=r.limit-i}if(!r.slice_del()){return false}if(!d()){return false}return true}function p(){var e;var i=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(s);if(e==0){break r}r.bra=r.cursor;switch(e){case 1:if(!v()){break r}if(!r.slice_from("heid")){return false}break;case 2:if(!w()){break r}break;case 3:if(!v()){break r}if(!r.out_grouping_b(f,97,232)){break r}if(!r.slice_del()){return false}break}}r.cursor=r.limit-i;var u=r.limit-r.cursor;h();r.cursor=r.limit-u;var l=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("heid")){break r}r.bra=r.cursor;if(!g()){break r}{var n=r.limit-r.cursor;e:{if(!r.eq_s_b("c")){break e}break r}r.cursor=r.limit-n}if(!r.slice_del()){return false}r.ket=r.cursor;if(!r.eq_s_b("en")){break r}r.bra=r.cursor;if(!w()){break r}}r.cursor=r.limit-l;var k=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(a);if(e==0){break r}r.bra=r.cursor;switch(e){case 1:if(!g()){break r}if(!r.slice_del()){return false}e:{var _=r.limit-r.cursor;i:{r.ket=r.cursor;if(!r.eq_s_b("ig")){break i}r.bra=r.cursor;if(!g()){break i}{var m=r.limit-r.cursor;u:{if(!r.eq_s_b("e")){break u}break i}r.cursor=r.limit-m}if(!r.slice_del()){return false}break e}r.cursor=r.limit-_;if(!d()){break r}}break;case 2:if(!g()){break r}{var p=r.limit-r.cursor;e:{if(!r.eq_s_b("e")){break e}break r}r.cursor=r.limit-p}if(!r.slice_del()){return false}break;case 3:if(!g()){break r}if(!r.slice_del()){return false}if(!h()){break r}break;case 4:if(!g()){break r}if(!r.slice_del()){return false}break;case 5:if(!g()){break r}if(!b){break r}if(!r.slice_del()){return false}break}}r.cursor=r.limit-k;var q=r.limit-r.cursor;r:{if(!r.out_grouping_b(o,73,232)){break r}var y=r.limit-r.cursor;if(r.find_among_b(t)==0){break r}if(!r.out_grouping_b(c,97,232)){break r}r.cursor=r.limit-y;r.ket=r.cursor;if(r.cursor<=r.limit_backward){break r}r.cursor--;r.bra=r.cursor;if(!r.slice_del()){return false}}r.cursor=r.limit-q;return true}this.stem=function(){var e=r.cursor;k();r.cursor=e;var i=r.cursor;_();r.cursor=i;r.limit_backward=r.cursor;r.cursor=r.limit;p();r.cursor=r.limit_backward;var u=r.cursor;m();r.cursor=u;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}};�������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/finnish-stemmer.js�������������������������������������������0000644�0000766�0000024�00000016551�00000000000�022765� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������FinnishStemmer=function(){var r=new BaseStemmer;var i=[["pa",-1,1],["sti",-1,2],["kaan",-1,1],["han",-1,1],["kin",-1,1],["hän",-1,1],["kään",-1,1],["ko",-1,1],["pä",-1,1],["kö",-1,1]];var e=[["lla",-1,-1],["na",-1,-1],["ssa",-1,-1],["ta",-1,-1],["lta",3,-1],["sta",3,-1]];var a=[["llä",-1,-1],["nä",-1,-1],["ssä",-1,-1],["tä",-1,-1],["ltä",3,-1],["stä",3,-1]];var s=[["lle",-1,-1],["ine",-1,-1]];var t=[["nsa",-1,3],["mme",-1,3],["nne",-1,3],["ni",-1,2],["si",-1,1],["an",-1,4],["en",-1,6],["än",-1,5],["nsä",-1,3]];var u=[["aa",-1,-1],["ee",-1,-1],["ii",-1,-1],["oo",-1,-1],["uu",-1,-1],["ää",-1,-1],["öö",-1,-1]];var l=[["a",-1,8],["lla",0,-1],["na",0,-1],["ssa",0,-1],["ta",0,-1],["lta",4,-1],["sta",4,-1],["tta",4,2],["lle",-1,-1],["ine",-1,-1],["ksi",-1,-1],["n",-1,7],["han",11,1],["den",11,-1,S],["seen",11,-1,C],["hen",11,2],["tten",11,-1,S],["hin",11,3],["siin",11,-1,S],["hon",11,4],["hän",11,5],["hön",11,6],["ä",-1,8],["llä",22,-1],["nä",22,-1],["ssä",22,-1],["tä",22,-1],["ltä",26,-1],["stä",26,-1],["ttä",26,2]];var c=[["eja",-1,-1],["mma",-1,1],["imma",1,-1],["mpa",-1,1],["impa",3,-1],["mmi",-1,1],["immi",5,-1],["mpi",-1,1],["impi",7,-1],["ejä",-1,-1],["mmä",-1,1],["immä",10,-1],["mpä",-1,1],["impä",12,-1]];var n=[["i",-1,-1],["j",-1,-1]];var f=[["mma",-1,1],["imma",0,-1]];var o=[17,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8];var b=[119,223,119,1];var _=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32];var m=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32];var k=[17,97,24,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32];var d=false;var v="";var w=0;var g=0;function p(){g=r.limit;w=r.limit;r:while(true){var i=r.cursor;i:{if(!r.in_grouping(_,97,246)){break i}r.cursor=i;break r}r.cursor=i;if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){i:{if(!r.out_grouping(_,97,246)){break i}break r}if(r.cursor>=r.limit){return false}r.cursor++}g=r.cursor;r:while(true){var e=r.cursor;i:{if(!r.in_grouping(_,97,246)){break i}r.cursor=e;break r}r.cursor=e;if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){i:{if(!r.out_grouping(_,97,246)){break i}break r}if(r.cursor>=r.limit){return false}r.cursor++}w=r.cursor;return true}function h(){if(!(w<=r.cursor)){return false}return true}function q(){var e;if(r.cursor<g){return false}var a=r.limit_backward;r.limit_backward=g;r.ket=r.cursor;e=r.find_among_b(i);if(e==0){r.limit_backward=a;return false}r.bra=r.cursor;r.limit_backward=a;switch(e){case 1:if(!r.in_grouping_b(k,97,246)){return false}break;case 2:if(!h()){return false}break}if(!r.slice_del()){return false}return true}function j(){var i;if(r.cursor<g){return false}var u=r.limit_backward;r.limit_backward=g;r.ket=r.cursor;i=r.find_among_b(t);if(i==0){r.limit_backward=u;return false}r.bra=r.cursor;r.limit_backward=u;switch(i){case 1:{var l=r.limit-r.cursor;r:{if(!r.eq_s_b("k")){break r}return false}r.cursor=r.limit-l}if(!r.slice_del()){return false}break;case 2:if(!r.slice_del()){return false}r.ket=r.cursor;if(!r.eq_s_b("kse")){return false}r.bra=r.cursor;if(!r.slice_from("ksi")){return false}break;case 3:if(!r.slice_del()){return false}break;case 4:if(r.find_among_b(e)==0){return false}if(!r.slice_del()){return false}break;case 5:if(r.find_among_b(a)==0){return false}if(!r.slice_del()){return false}break;case 6:if(r.find_among_b(s)==0){return false}if(!r.slice_del()){return false}break}return true}function C(){if(r.find_among_b(u)==0){return false}return true}function S(){if(!r.eq_s_b("i")){return false}if(!r.in_grouping_b(m,97,246)){return false}return true}function B(){var i;if(r.cursor<g){return false}var e=r.limit_backward;r.limit_backward=g;r.ket=r.cursor;i=r.find_among_b(l);if(i==0){r.limit_backward=e;return false}r.bra=r.cursor;r.limit_backward=e;switch(i){case 1:if(!r.eq_s_b("a")){return false}break;case 2:if(!r.eq_s_b("e")){return false}break;case 3:if(!r.eq_s_b("i")){return false}break;case 4:if(!r.eq_s_b("o")){return false}break;case 5:if(!r.eq_s_b("ä")){return false}break;case 6:if(!r.eq_s_b("ö")){return false}break;case 7:var a=r.limit-r.cursor;r:{var s=r.limit-r.cursor;i:{var t=r.limit-r.cursor;e:{if(!C()){break e}break i}r.cursor=r.limit-t;if(!r.eq_s_b("ie")){r.cursor=r.limit-a;break r}}r.cursor=r.limit-s;if(r.cursor<=r.limit_backward){r.cursor=r.limit-a;break r}r.cursor--;r.bra=r.cursor}break;case 8:if(!r.in_grouping_b(_,97,246)){return false}if(!r.in_grouping_b(b,98,122)){return false}break}if(!r.slice_del()){return false}d=true;return true}function F(){var i;if(r.cursor<w){return false}var e=r.limit_backward;r.limit_backward=w;r.ket=r.cursor;i=r.find_among_b(c);if(i==0){r.limit_backward=e;return false}r.bra=r.cursor;r.limit_backward=e;switch(i){case 1:{var a=r.limit-r.cursor;r:{if(!r.eq_s_b("po")){break r}return false}r.cursor=r.limit-a}break}if(!r.slice_del()){return false}return true}function W(){if(r.cursor<g){return false}var i=r.limit_backward;r.limit_backward=g;r.ket=r.cursor;if(r.find_among_b(n)==0){r.limit_backward=i;return false}r.bra=r.cursor;r.limit_backward=i;if(!r.slice_del()){return false}return true}function x(){var i;if(r.cursor<g){return false}var e=r.limit_backward;r.limit_backward=g;r.ket=r.cursor;if(!r.eq_s_b("t")){r.limit_backward=e;return false}r.bra=r.cursor;var a=r.limit-r.cursor;if(!r.in_grouping_b(_,97,246)){r.limit_backward=e;return false}r.cursor=r.limit-a;if(!r.slice_del()){return false}r.limit_backward=e;if(r.cursor<w){return false}var s=r.limit_backward;r.limit_backward=w;r.ket=r.cursor;i=r.find_among_b(f);if(i==0){r.limit_backward=s;return false}r.bra=r.cursor;r.limit_backward=s;switch(i){case 1:{var t=r.limit-r.cursor;r:{if(!r.eq_s_b("po")){break r}return false}r.cursor=r.limit-t}break}if(!r.slice_del()){return false}return true}function y(){if(r.cursor<g){return false}var i=r.limit_backward;r.limit_backward=g;var e=r.limit-r.cursor;r:{var a=r.limit-r.cursor;if(!C()){break r}r.cursor=r.limit-a;r.ket=r.cursor;if(r.cursor<=r.limit_backward){break r}r.cursor--;r.bra=r.cursor;if(!r.slice_del()){return false}}r.cursor=r.limit-e;var s=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.in_grouping_b(o,97,228)){break r}r.bra=r.cursor;if(!r.in_grouping_b(b,98,122)){break r}if(!r.slice_del()){return false}}r.cursor=r.limit-s;var t=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("j")){break r}r.bra=r.cursor;i:{var u=r.limit-r.cursor;e:{if(!r.eq_s_b("o")){break e}break i}r.cursor=r.limit-u;if(!r.eq_s_b("u")){break r}}if(!r.slice_del()){return false}}r.cursor=r.limit-t;var l=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("o")){break r}r.bra=r.cursor;if(!r.eq_s_b("j")){break r}if(!r.slice_del()){return false}}r.cursor=r.limit-l;r.limit_backward=i;r:while(true){var c=r.limit-r.cursor;i:{if(!r.out_grouping_b(_,97,246)){break i}r.cursor=r.limit-c;break r}r.cursor=r.limit-c;if(r.cursor<=r.limit_backward){return false}r.cursor--}r.ket=r.cursor;if(!r.in_grouping_b(b,98,122)){return false}r.bra=r.cursor;v=r.slice_to();if(v==""){return false}if(!r.eq_s_b(v)){return false}if(!r.slice_del()){return false}return true}this.stem=function(){var i=r.cursor;p();r.cursor=i;d=false;r.limit_backward=r.cursor;r.cursor=r.limit;var e=r.limit-r.cursor;q();r.cursor=r.limit-e;var a=r.limit-r.cursor;j();r.cursor=r.limit-a;var s=r.limit-r.cursor;B();r.cursor=r.limit-s;var t=r.limit-r.cursor;F();r.cursor=r.limit-t;r:{i:{if(!d){break i}var u=r.limit-r.cursor;W();r.cursor=r.limit-u;break r}var l=r.limit-r.cursor;x();r.cursor=r.limit-l}var c=r.limit-r.cursor;y();r.cursor=r.limit-c;r.cursor=r.limit_backward;return true};this["stemWord"]=function(i){r.setCurrent(i);this.stem();return r.getCurrent()}};�������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/french-stemmer.js��������������������������������������������0000644�0000766�0000024�00000026463�00000000000�022577� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������FrenchStemmer=function(){var r=new BaseStemmer;var e=[["col",-1,-1],["par",-1,-1],["tap",-1,-1]];var i=[["",-1,7],["H",0,6],["He",1,4],["Hi",1,5],["I",0,1],["U",0,2],["Y",0,3]];var s=[["iqU",-1,3],["abl",-1,3],["Ièr",-1,4],["ièr",-1,4],["eus",-1,2],["iv",-1,1]];var a=[["ic",-1,2],["abil",-1,1],["iv",-1,3]];var u=[["iqUe",-1,1],["atrice",-1,2],["ance",-1,1],["ence",-1,5],["logie",-1,3],["able",-1,1],["isme",-1,1],["euse",-1,11],["iste",-1,1],["ive",-1,8],["if",-1,8],["usion",-1,4],["ation",-1,2],["ution",-1,4],["ateur",-1,2],["iqUes",-1,1],["atrices",-1,2],["ances",-1,1],["ences",-1,5],["logies",-1,3],["ables",-1,1],["ismes",-1,1],["euses",-1,11],["istes",-1,1],["ives",-1,8],["ifs",-1,8],["usions",-1,4],["ations",-1,2],["utions",-1,4],["ateurs",-1,2],["ments",-1,15],["ements",30,6],["issements",31,12],["ités",-1,7],["ment",-1,15],["ement",34,6],["issement",35,12],["amment",34,13],["emment",34,14],["aux",-1,10],["eaux",39,9],["eux",-1,1],["ité",-1,7]];var t=[["ira",-1,1],["ie",-1,1],["isse",-1,1],["issante",-1,1],["i",-1,1],["irai",4,1],["ir",-1,1],["iras",-1,1],["ies",-1,1],["îmes",-1,1],["isses",-1,1],["issantes",-1,1],["îtes",-1,1],["is",-1,1],["irais",13,1],["issais",13,1],["irions",-1,1],["issions",-1,1],["irons",-1,1],["issons",-1,1],["issants",-1,1],["it",-1,1],["irait",21,1],["issait",21,1],["issant",-1,1],["iraIent",-1,1],["issaIent",-1,1],["irent",-1,1],["issent",-1,1],["iront",-1,1],["ît",-1,1],["iriez",-1,1],["issiez",-1,1],["irez",-1,1],["issez",-1,1]];var c=[["a",-1,3],["era",0,2],["asse",-1,3],["ante",-1,3],["ée",-1,2],["ai",-1,3],["erai",5,2],["er",-1,2],["as",-1,3],["eras",8,2],["âmes",-1,3],["asses",-1,3],["antes",-1,3],["âtes",-1,3],["ées",-1,2],["ais",-1,3],["erais",15,2],["ions",-1,1],["erions",17,2],["assions",17,3],["erons",-1,2],["ants",-1,3],["és",-1,2],["ait",-1,3],["erait",23,2],["ant",-1,3],["aIent",-1,3],["eraIent",26,2],["èrent",-1,2],["assent",-1,3],["eront",-1,2],["ât",-1,3],["ez",-1,2],["iez",32,2],["eriez",33,2],["assiez",33,3],["erez",32,2],["é",-1,2]];var f=[["e",-1,3],["Ière",0,2],["ière",0,2],["ion",-1,1],["Ier",-1,2],["ier",-1,2]];var l=[["ell",-1,-1],["eill",-1,-1],["enn",-1,-1],["onn",-1,-1],["ett",-1,-1]];var o=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,128,130,103,8,5];var n=[1,65,20,0,0,0,0,0,0,0,0,0,0,0,0,0,128];var b=0;var k=0;var m=0;function _(){while(true){var e=r.cursor;r:{e:while(true){var i=r.cursor;i:{s:{var s=r.cursor;a:{if(!r.in_grouping(o,97,251)){break a}r.bra=r.cursor;u:{var a=r.cursor;t:{if(!r.eq_s("u")){break t}r.ket=r.cursor;if(!r.in_grouping(o,97,251)){break t}if(!r.slice_from("U")){return false}break u}r.cursor=a;t:{if(!r.eq_s("i")){break t}r.ket=r.cursor;if(!r.in_grouping(o,97,251)){break t}if(!r.slice_from("I")){return false}break u}r.cursor=a;if(!r.eq_s("y")){break a}r.ket=r.cursor;if(!r.slice_from("Y")){return false}}break s}r.cursor=s;a:{r.bra=r.cursor;if(!r.eq_s("ë")){break a}r.ket=r.cursor;if(!r.slice_from("He")){return false}break s}r.cursor=s;a:{r.bra=r.cursor;if(!r.eq_s("ï")){break a}r.ket=r.cursor;if(!r.slice_from("Hi")){return false}break s}r.cursor=s;a:{r.bra=r.cursor;if(!r.eq_s("y")){break a}r.ket=r.cursor;if(!r.in_grouping(o,97,251)){break a}if(!r.slice_from("Y")){return false}break s}r.cursor=s;if(!r.eq_s("q")){break i}r.bra=r.cursor;if(!r.eq_s("u")){break i}r.ket=r.cursor;if(!r.slice_from("U")){return false}}r.cursor=i;break e}r.cursor=i;if(r.cursor>=r.limit){break r}r.cursor++}continue}r.cursor=e;break}return true}function v(){m=r.limit;k=r.limit;b=r.limit;var i=r.cursor;r:{e:{var s=r.cursor;i:{if(!r.in_grouping(o,97,251)){break i}if(!r.in_grouping(o,97,251)){break i}if(r.cursor>=r.limit){break i}r.cursor++;break e}r.cursor=s;i:{if(r.find_among(e)==0){break i}break e}r.cursor=s;if(r.cursor>=r.limit){break r}r.cursor++;i:while(true){s:{if(!r.in_grouping(o,97,251)){break s}break i}if(r.cursor>=r.limit){break r}r.cursor++}}m=r.cursor}r.cursor=i;var a=r.cursor;r:{e:while(true){i:{if(!r.in_grouping(o,97,251)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(o,97,251)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}k=r.cursor;e:while(true){i:{if(!r.in_grouping(o,97,251)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(o,97,251)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}b=r.cursor}r.cursor=a;return true}function d(){var e;while(true){var s=r.cursor;r:{r.bra=r.cursor;e=r.find_among(i);if(e==0){break r}r.ket=r.cursor;switch(e){case 1:if(!r.slice_from("i")){return false}break;case 2:if(!r.slice_from("u")){return false}break;case 3:if(!r.slice_from("y")){return false}break;case 4:if(!r.slice_from("ë")){return false}break;case 5:if(!r.slice_from("ï")){return false}break;case 6:if(!r.slice_del()){return false}break;case 7:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=s;break}return true}function g(){if(!(m<=r.cursor)){return false}return true}function w(){if(!(k<=r.cursor)){return false}return true}function q(){if(!(b<=r.cursor)){return false}return true}function h(){var e;r.ket=r.cursor;e=r.find_among_b(u);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:if(!q()){return false}if(!r.slice_del()){return false}break;case 2:if(!q()){return false}if(!r.slice_del()){return false}var i=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("ic")){r.cursor=r.limit-i;break r}r.bra=r.cursor;e:{var t=r.limit-r.cursor;i:{if(!q()){break i}if(!r.slice_del()){return false}break e}r.cursor=r.limit-t;if(!r.slice_from("iqU")){return false}}}break;case 3:if(!q()){return false}if(!r.slice_from("log")){return false}break;case 4:if(!q()){return false}if(!r.slice_from("u")){return false}break;case 5:if(!q()){return false}if(!r.slice_from("ent")){return false}break;case 6:if(!g()){return false}if(!r.slice_del()){return false}var c=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(s);if(e==0){r.cursor=r.limit-c;break r}r.bra=r.cursor;switch(e){case 1:if(!q()){r.cursor=r.limit-c;break r}if(!r.slice_del()){return false}r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-c;break r}r.bra=r.cursor;if(!q()){r.cursor=r.limit-c;break r}if(!r.slice_del()){return false}break;case 2:e:{var f=r.limit-r.cursor;i:{if(!q()){break i}if(!r.slice_del()){return false}break e}r.cursor=r.limit-f;if(!w()){r.cursor=r.limit-c;break r}if(!r.slice_from("eux")){return false}}break;case 3:if(!q()){r.cursor=r.limit-c;break r}if(!r.slice_del()){return false}break;case 4:if(!g()){r.cursor=r.limit-c;break r}if(!r.slice_from("i")){return false}break}}break;case 7:if(!q()){return false}if(!r.slice_del()){return false}var l=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(a);if(e==0){r.cursor=r.limit-l;break r}r.bra=r.cursor;switch(e){case 1:e:{var n=r.limit-r.cursor;i:{if(!q()){break i}if(!r.slice_del()){return false}break e}r.cursor=r.limit-n;if(!r.slice_from("abl")){return false}}break;case 2:e:{var b=r.limit-r.cursor;i:{if(!q()){break i}if(!r.slice_del()){return false}break e}r.cursor=r.limit-b;if(!r.slice_from("iqU")){return false}}break;case 3:if(!q()){r.cursor=r.limit-l;break r}if(!r.slice_del()){return false}break}}break;case 8:if(!q()){return false}if(!r.slice_del()){return false}var k=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-k;break r}r.bra=r.cursor;if(!q()){r.cursor=r.limit-k;break r}if(!r.slice_del()){return false}r.ket=r.cursor;if(!r.eq_s_b("ic")){r.cursor=r.limit-k;break r}r.bra=r.cursor;e:{var m=r.limit-r.cursor;i:{if(!q()){break i}if(!r.slice_del()){return false}break e}r.cursor=r.limit-m;if(!r.slice_from("iqU")){return false}}}break;case 9:if(!r.slice_from("eau")){return false}break;case 10:if(!w()){return false}if(!r.slice_from("al")){return false}break;case 11:r:{var _=r.limit-r.cursor;e:{if(!q()){break e}if(!r.slice_del()){return false}break r}r.cursor=r.limit-_;if(!w()){return false}if(!r.slice_from("eux")){return false}}break;case 12:if(!w()){return false}if(!r.out_grouping_b(o,97,251)){return false}if(!r.slice_del()){return false}break;case 13:if(!g()){return false}if(!r.slice_from("ant")){return false}return false;case 14:if(!g()){return false}if(!r.slice_from("ent")){return false}return false;case 15:var v=r.limit-r.cursor;if(!r.in_grouping_b(o,97,251)){return false}if(!g()){return false}r.cursor=r.limit-v;if(!r.slice_del()){return false}return false}return true}function p(){if(r.cursor<m){return false}var e=r.limit_backward;r.limit_backward=m;r.ket=r.cursor;if(r.find_among_b(t)==0){r.limit_backward=e;return false}r.bra=r.cursor;{var i=r.limit-r.cursor;r:{if(!r.eq_s_b("H")){break r}r.limit_backward=e;return false}r.cursor=r.limit-i}if(!r.out_grouping_b(o,97,251)){r.limit_backward=e;return false}if(!r.slice_del()){return false}r.limit_backward=e;return true}function z(){var e;if(r.cursor<m){return false}var i=r.limit_backward;r.limit_backward=m;r.ket=r.cursor;e=r.find_among_b(c);if(e==0){r.limit_backward=i;return false}r.bra=r.cursor;switch(e){case 1:if(!q()){r.limit_backward=i;return false}if(!r.slice_del()){return false}break;case 2:if(!r.slice_del()){return false}break;case 3:if(!r.slice_del()){return false}var s=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("e")){r.cursor=r.limit-s;break r}r.bra=r.cursor;if(!r.slice_del()){return false}}break}r.limit_backward=i;return true}function I(){var e;var i=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("s")){r.cursor=r.limit-i;break r}r.bra=r.cursor;var s=r.limit-r.cursor;e:{var a=r.limit-r.cursor;i:{if(!r.eq_s_b("Hi")){break i}break e}r.cursor=r.limit-a;if(!r.out_grouping_b(n,97,232)){r.cursor=r.limit-i;break r}}r.cursor=r.limit-s;if(!r.slice_del()){return false}}if(r.cursor<m){return false}var u=r.limit_backward;r.limit_backward=m;r.ket=r.cursor;e=r.find_among_b(f);if(e==0){r.limit_backward=u;return false}r.bra=r.cursor;switch(e){case 1:if(!q()){r.limit_backward=u;return false}r:{var t=r.limit-r.cursor;e:{if(!r.eq_s_b("s")){break e}break r}r.cursor=r.limit-t;if(!r.eq_s_b("t")){r.limit_backward=u;return false}}if(!r.slice_del()){return false}break;case 2:if(!r.slice_from("i")){return false}break;case 3:if(!r.slice_del()){return false}break}r.limit_backward=u;return true}function U(){var e=r.limit-r.cursor;if(r.find_among_b(l)==0){return false}r.cursor=r.limit-e;r.ket=r.cursor;if(r.cursor<=r.limit_backward){return false}r.cursor--;r.bra=r.cursor;if(!r.slice_del()){return false}return true}function H(){{var e=1;while(true){r:{if(!r.out_grouping_b(o,97,251)){break r}e--;continue}break}if(e>0){return false}}r.ket=r.cursor;r:{var i=r.limit-r.cursor;e:{if(!r.eq_s_b("é")){break e}break r}r.cursor=r.limit-i;if(!r.eq_s_b("è")){return false}}r.bra=r.cursor;if(!r.slice_from("e")){return false}return true}this.stem=function(){var e=r.cursor;_();r.cursor=e;v();r.limit_backward=r.cursor;r.cursor=r.limit;var i=r.limit-r.cursor;r:{e:{var s=r.limit-r.cursor;i:{var a=r.limit-r.cursor;s:{var u=r.limit-r.cursor;a:{if(!h()){break a}break s}r.cursor=r.limit-u;a:{if(!p()){break a}break s}r.cursor=r.limit-u;if(!z()){break i}}r.cursor=r.limit-a;var t=r.limit-r.cursor;s:{r.ket=r.cursor;a:{var c=r.limit-r.cursor;u:{if(!r.eq_s_b("Y")){break u}r.bra=r.cursor;if(!r.slice_from("i")){return false}break a}r.cursor=r.limit-c;if(!r.eq_s_b("ç")){r.cursor=r.limit-t;break s}r.bra=r.cursor;if(!r.slice_from("c")){return false}}}break e}r.cursor=r.limit-s;if(!I()){break r}}}r.cursor=r.limit-i;var f=r.limit-r.cursor;U();r.cursor=r.limit-f;var l=r.limit-r.cursor;H();r.cursor=r.limit-l;r.cursor=r.limit_backward;var o=r.cursor;d();r.cursor=o;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}};�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/german-stemmer.js��������������������������������������������0000644�0000766�0000024�00000011075�00000000000�022574� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������GermanStemmer=function(){var r=new BaseStemmer;var e=[["",-1,5],["U",0,2],["Y",0,1],["ä",0,3],["ö",0,4],["ü",0,2]];var i=[["e",-1,2],["em",-1,1],["en",-1,2],["ern",-1,1],["er",-1,1],["s",-1,3],["es",5,2]];var s=[["en",-1,1],["er",-1,1],["st",-1,2],["est",2,1]];var u=[["ig",-1,1],["lich",-1,1]];var a=[["end",-1,1],["ig",-1,2],["ung",-1,1],["lich",-1,3],["isch",-1,2],["ik",-1,2],["heit",-1,3],["keit",-1,4]];var c=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32,8];var t=[117,30,5];var o=[117,30,4];var f=0;var l=0;var n=0;function b(){var e=r.cursor;while(true){var i=r.cursor;r:{e:{var s=r.cursor;i:{r.bra=r.cursor;if(!r.eq_s("ß")){break i}r.ket=r.cursor;if(!r.slice_from("ss")){return false}break e}r.cursor=s;if(r.cursor>=r.limit){break r}r.cursor++}continue}r.cursor=i;break}r.cursor=e;while(true){var u=r.cursor;r:{e:while(true){var a=r.cursor;i:{if(!r.in_grouping(c,97,252)){break i}r.bra=r.cursor;s:{var t=r.cursor;u:{if(!r.eq_s("u")){break u}r.ket=r.cursor;if(!r.in_grouping(c,97,252)){break u}if(!r.slice_from("U")){return false}break s}r.cursor=t;if(!r.eq_s("y")){break i}r.ket=r.cursor;if(!r.in_grouping(c,97,252)){break i}if(!r.slice_from("Y")){return false}}r.cursor=a;break e}r.cursor=a;if(r.cursor>=r.limit){break r}r.cursor++}continue}r.cursor=u;break}return true}function k(){n=r.limit;l=r.limit;var e=r.cursor;{var i=r.cursor+3;if(i>r.limit){return false}r.cursor=i}f=r.cursor;r.cursor=e;r:while(true){e:{if(!r.in_grouping(c,97,252)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){e:{if(!r.out_grouping(c,97,252)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}n=r.cursor;r:{if(!(n<f)){break r}n=f}r:while(true){e:{if(!r.in_grouping(c,97,252)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){e:{if(!r.out_grouping(c,97,252)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}l=r.cursor;return true}function m(){var i;while(true){var s=r.cursor;r:{r.bra=r.cursor;i=r.find_among(e);if(i==0){break r}r.ket=r.cursor;switch(i){case 1:if(!r.slice_from("y")){return false}break;case 2:if(!r.slice_from("u")){return false}break;case 3:if(!r.slice_from("a")){return false}break;case 4:if(!r.slice_from("o")){return false}break;case 5:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=s;break}return true}function _(){if(!(n<=r.cursor)){return false}return true}function v(){if(!(l<=r.cursor)){return false}return true}function g(){var e;var c=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(i);if(e==0){break r}r.bra=r.cursor;if(!_()){break r}switch(e){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.slice_del()){return false}var f=r.limit-r.cursor;e:{r.ket=r.cursor;if(!r.eq_s_b("s")){r.cursor=r.limit-f;break e}r.bra=r.cursor;if(!r.eq_s_b("nis")){r.cursor=r.limit-f;break e}if(!r.slice_del()){return false}}break;case 3:if(!r.in_grouping_b(t,98,116)){break r}if(!r.slice_del()){return false}break}}r.cursor=r.limit-c;var l=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(s);if(e==0){break r}r.bra=r.cursor;if(!_()){break r}switch(e){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.in_grouping_b(o,98,116)){break r}{var n=r.cursor-3;if(n<r.limit_backward){break r}r.cursor=n}if(!r.slice_del()){return false}break}}r.cursor=r.limit-l;var b=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(a);if(e==0){break r}r.bra=r.cursor;if(!v()){break r}switch(e){case 1:if(!r.slice_del()){return false}var k=r.limit-r.cursor;e:{r.ket=r.cursor;if(!r.eq_s_b("ig")){r.cursor=r.limit-k;break e}r.bra=r.cursor;{var m=r.limit-r.cursor;i:{if(!r.eq_s_b("e")){break i}r.cursor=r.limit-k;break e}r.cursor=r.limit-m}if(!v()){r.cursor=r.limit-k;break e}if(!r.slice_del()){return false}}break;case 2:{var g=r.limit-r.cursor;e:{if(!r.eq_s_b("e")){break e}break r}r.cursor=r.limit-g}if(!r.slice_del()){return false}break;case 3:if(!r.slice_del()){return false}var d=r.limit-r.cursor;e:{r.ket=r.cursor;i:{var h=r.limit-r.cursor;s:{if(!r.eq_s_b("er")){break s}break i}r.cursor=r.limit-h;if(!r.eq_s_b("en")){r.cursor=r.limit-d;break e}}r.bra=r.cursor;if(!_()){r.cursor=r.limit-d;break e}if(!r.slice_del()){return false}}break;case 4:if(!r.slice_del()){return false}var w=r.limit-r.cursor;e:{r.ket=r.cursor;if(r.find_among_b(u)==0){r.cursor=r.limit-w;break e}r.bra=r.cursor;if(!v()){r.cursor=r.limit-w;break e}if(!r.slice_del()){return false}}break}}r.cursor=r.limit-b;return true}this.stem=function(){var e=r.cursor;b();r.cursor=e;var i=r.cursor;k();r.cursor=i;r.limit_backward=r.cursor;r.cursor=r.limit;g();r.cursor=r.limit_backward;var s=r.cursor;m();r.cursor=s;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}};�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/hungarian-stemmer.js�����������������������������������������0000644�0000766�0000024�00000014726�00000000000�023305� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������HungarianStemmer=function(){var r=new BaseStemmer;var e=[["cs",-1,-1],["dzs",-1,-1],["gy",-1,-1],["ly",-1,-1],["ny",-1,-1],["sz",-1,-1],["ty",-1,-1],["zs",-1,-1]];var i=[["á",-1,1],["é",-1,2]];var a=[["bb",-1,-1],["cc",-1,-1],["dd",-1,-1],["ff",-1,-1],["gg",-1,-1],["jj",-1,-1],["kk",-1,-1],["ll",-1,-1],["mm",-1,-1],["nn",-1,-1],["pp",-1,-1],["rr",-1,-1],["ccs",-1,-1],["ss",-1,-1],["zzs",-1,-1],["tt",-1,-1],["vv",-1,-1],["ggy",-1,-1],["lly",-1,-1],["nny",-1,-1],["tty",-1,-1],["ssz",-1,-1],["zz",-1,-1]];var t=[["al",-1,1],["el",-1,1]];var s=[["ba",-1,-1],["ra",-1,-1],["be",-1,-1],["re",-1,-1],["ig",-1,-1],["nak",-1,-1],["nek",-1,-1],["val",-1,-1],["vel",-1,-1],["ul",-1,-1],["nál",-1,-1],["nél",-1,-1],["ból",-1,-1],["ról",-1,-1],["tól",-1,-1],["ül",-1,-1],["ből",-1,-1],["ről",-1,-1],["től",-1,-1],["n",-1,-1],["an",19,-1],["ban",20,-1],["en",19,-1],["ben",22,-1],["képpen",22,-1],["on",19,-1],["ön",19,-1],["képp",-1,-1],["kor",-1,-1],["t",-1,-1],["at",29,-1],["et",29,-1],["ként",29,-1],["anként",32,-1],["enként",32,-1],["onként",32,-1],["ot",29,-1],["ért",29,-1],["öt",29,-1],["hez",-1,-1],["hoz",-1,-1],["höz",-1,-1],["vá",-1,-1],["vé",-1,-1]];var u=[["án",-1,2],["én",-1,1],["ánként",-1,2]];var n=[["stul",-1,1],["astul",0,1],["ástul",0,2],["stül",-1,1],["estül",3,1],["éstül",3,3]];var f=[["á",-1,1],["é",-1,1]];var c=[["k",-1,3],["ak",0,3],["ek",0,3],["ok",0,3],["ák",0,1],["ék",0,2],["ök",0,3]];var l=[["éi",-1,1],["áéi",0,3],["ééi",0,2],["é",-1,1],["ké",3,1],["aké",4,1],["eké",4,1],["oké",4,1],["áké",4,3],["éké",4,2],["öké",4,1],["éé",3,2]];var o=[["a",-1,1],["ja",0,1],["d",-1,1],["ad",2,1],["ed",2,1],["od",2,1],["ád",2,2],["éd",2,3],["öd",2,1],["e",-1,1],["je",9,1],["nk",-1,1],["unk",11,1],["ánk",11,2],["énk",11,3],["ünk",11,1],["uk",-1,1],["juk",16,1],["ájuk",17,2],["ük",-1,1],["jük",19,1],["éjük",20,3],["m",-1,1],["am",22,1],["em",22,1],["om",22,1],["ám",22,2],["ém",22,3],["o",-1,1],["á",-1,2],["é",-1,3]];var k=[["id",-1,1],["aid",0,1],["jaid",1,1],["eid",0,1],["jeid",3,1],["áid",0,2],["éid",0,3],["i",-1,1],["ai",7,1],["jai",8,1],["ei",7,1],["jei",10,1],["ái",7,2],["éi",7,3],["itek",-1,1],["eitek",14,1],["jeitek",15,1],["éitek",14,3],["ik",-1,1],["aik",18,1],["jaik",19,1],["eik",18,1],["jeik",21,1],["áik",18,2],["éik",18,3],["ink",-1,1],["aink",25,1],["jaink",26,1],["eink",25,1],["jeink",28,1],["áink",25,2],["éink",25,3],["aitok",-1,1],["jaitok",32,1],["áitok",-1,2],["im",-1,1],["aim",35,1],["jaim",36,1],["eim",35,1],["jeim",38,1],["áim",35,2],["éim",35,3]];var m=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,36,10,0,0,0,0,0,0,0,0,0,0,1,0,0,0,1];var b=0;function _(){b=r.limit;r:{var i=r.cursor;e:{if(!r.in_grouping(m,97,369)){break e}i:while(true){var a=r.cursor;a:{if(!r.out_grouping(m,97,369)){break a}r.cursor=a;break i}r.cursor=a;if(r.cursor>=r.limit){break e}r.cursor++}i:{var t=r.cursor;a:{if(r.find_among(e)==0){break a}break i}r.cursor=t;if(r.cursor>=r.limit){break e}r.cursor++}b=r.cursor;break r}r.cursor=i;if(!r.out_grouping(m,97,369)){return false}e:while(true){i:{if(!r.in_grouping(m,97,369)){break i}break e}if(r.cursor>=r.limit){return false}r.cursor++}b=r.cursor}return true}function d(){if(!(b<=r.cursor)){return false}return true}function v(){var e;r.ket=r.cursor;e=r.find_among_b(i);if(e==0){return false}r.bra=r.cursor;if(!d()){return false}switch(e){case 1:if(!r.slice_from("a")){return false}break;case 2:if(!r.slice_from("e")){return false}break}return true}function g(){var e=r.limit-r.cursor;if(r.find_among_b(a)==0){return false}r.cursor=r.limit-e;return true}function j(){if(r.cursor<=r.limit_backward){return false}r.cursor--;r.ket=r.cursor;{var e=r.cursor-1;if(e<r.limit_backward){return false}r.cursor=e}r.bra=r.cursor;if(!r.slice_del()){return false}return true}function h(){r.ket=r.cursor;if(r.find_among_b(t)==0){return false}r.bra=r.cursor;if(!d()){return false}if(!g()){return false}if(!r.slice_del()){return false}if(!j()){return false}return true}function w(){r.ket=r.cursor;if(r.find_among_b(s)==0){return false}r.bra=r.cursor;if(!d()){return false}if(!r.slice_del()){return false}if(!v()){return false}return true}function z(){var e;r.ket=r.cursor;e=r.find_among_b(u);if(e==0){return false}r.bra=r.cursor;if(!d()){return false}switch(e){case 1:if(!r.slice_from("e")){return false}break;case 2:if(!r.slice_from("a")){return false}break}return true}function p(){var e;r.ket=r.cursor;e=r.find_among_b(n);if(e==0){return false}r.bra=r.cursor;if(!d()){return false}switch(e){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.slice_from("a")){return false}break;case 3:if(!r.slice_from("e")){return false}break}return true}function y(){r.ket=r.cursor;if(r.find_among_b(f)==0){return false}r.bra=r.cursor;if(!d()){return false}if(!g()){return false}if(!r.slice_del()){return false}if(!j()){return false}return true}function C(){var e;r.ket=r.cursor;e=r.find_among_b(c);if(e==0){return false}r.bra=r.cursor;if(!d()){return false}switch(e){case 1:if(!r.slice_from("a")){return false}break;case 2:if(!r.slice_from("e")){return false}break;case 3:if(!r.slice_del()){return false}break}return true}function S(){var e;r.ket=r.cursor;e=r.find_among_b(l);if(e==0){return false}r.bra=r.cursor;if(!d()){return false}switch(e){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.slice_from("e")){return false}break;case 3:if(!r.slice_from("a")){return false}break}return true}function B(){var e;r.ket=r.cursor;e=r.find_among_b(o);if(e==0){return false}r.bra=r.cursor;if(!d()){return false}switch(e){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.slice_from("a")){return false}break;case 3:if(!r.slice_from("e")){return false}break}return true}function H(){var e;r.ket=r.cursor;e=r.find_among_b(k);if(e==0){return false}r.bra=r.cursor;if(!d()){return false}switch(e){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.slice_from("a")){return false}break;case 3:if(!r.slice_from("e")){return false}break}return true}this.stem=function(){var e=r.cursor;_();r.cursor=e;r.limit_backward=r.cursor;r.cursor=r.limit;var i=r.limit-r.cursor;h();r.cursor=r.limit-i;var a=r.limit-r.cursor;w();r.cursor=r.limit-a;var t=r.limit-r.cursor;z();r.cursor=r.limit-t;var s=r.limit-r.cursor;p();r.cursor=r.limit-s;var u=r.limit-r.cursor;y();r.cursor=r.limit-u;var n=r.limit-r.cursor;S();r.cursor=r.limit-n;var f=r.limit-r.cursor;B();r.cursor=r.limit-f;var c=r.limit-r.cursor;H();r.cursor=r.limit-c;var l=r.limit-r.cursor;C();r.cursor=r.limit-l;r.cursor=r.limit_backward;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}};������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/italian-stemmer.js�������������������������������������������0000644�0000766�0000024�00000021614�00000000000�022744� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������ItalianStemmer=function(){var r=new BaseStemmer;var e=[["",-1,7],["qu",0,6],["á",0,1],["é",0,2],["í",0,3],["ó",0,4],["ú",0,5]];var i=[["",-1,3],["I",0,1],["U",0,2]];var a=[["la",-1,-1],["cela",0,-1],["gliela",0,-1],["mela",0,-1],["tela",0,-1],["vela",0,-1],["le",-1,-1],["cele",6,-1],["gliele",6,-1],["mele",6,-1],["tele",6,-1],["vele",6,-1],["ne",-1,-1],["cene",12,-1],["gliene",12,-1],["mene",12,-1],["sene",12,-1],["tene",12,-1],["vene",12,-1],["ci",-1,-1],["li",-1,-1],["celi",20,-1],["glieli",20,-1],["meli",20,-1],["teli",20,-1],["veli",20,-1],["gli",20,-1],["mi",-1,-1],["si",-1,-1],["ti",-1,-1],["vi",-1,-1],["lo",-1,-1],["celo",31,-1],["glielo",31,-1],["melo",31,-1],["telo",31,-1],["velo",31,-1]];var s=[["ando",-1,1],["endo",-1,1],["ar",-1,2],["er",-1,2],["ir",-1,2]];var o=[["ic",-1,-1],["abil",-1,-1],["os",-1,-1],["iv",-1,1]];var u=[["ic",-1,1],["abil",-1,1],["iv",-1,1]];var t=[["ica",-1,1],["logia",-1,3],["osa",-1,1],["ista",-1,1],["iva",-1,9],["anza",-1,1],["enza",-1,5],["ice",-1,1],["atrice",7,1],["iche",-1,1],["logie",-1,3],["abile",-1,1],["ibile",-1,1],["usione",-1,4],["azione",-1,2],["uzione",-1,4],["atore",-1,2],["ose",-1,1],["ante",-1,1],["mente",-1,1],["amente",19,7],["iste",-1,1],["ive",-1,9],["anze",-1,1],["enze",-1,5],["ici",-1,1],["atrici",25,1],["ichi",-1,1],["abili",-1,1],["ibili",-1,1],["ismi",-1,1],["usioni",-1,4],["azioni",-1,2],["uzioni",-1,4],["atori",-1,2],["osi",-1,1],["anti",-1,1],["amenti",-1,6],["imenti",-1,6],["isti",-1,1],["ivi",-1,9],["ico",-1,1],["ismo",-1,1],["oso",-1,1],["amento",-1,6],["imento",-1,6],["ivo",-1,9],["ità",-1,8],["istà",-1,1],["istè",-1,1],["istì",-1,1]];var c=[["isca",-1,1],["enda",-1,1],["ata",-1,1],["ita",-1,1],["uta",-1,1],["ava",-1,1],["eva",-1,1],["iva",-1,1],["erebbe",-1,1],["irebbe",-1,1],["isce",-1,1],["ende",-1,1],["are",-1,1],["ere",-1,1],["ire",-1,1],["asse",-1,1],["ate",-1,1],["avate",16,1],["evate",16,1],["ivate",16,1],["ete",-1,1],["erete",20,1],["irete",20,1],["ite",-1,1],["ereste",-1,1],["ireste",-1,1],["ute",-1,1],["erai",-1,1],["irai",-1,1],["isci",-1,1],["endi",-1,1],["erei",-1,1],["irei",-1,1],["assi",-1,1],["ati",-1,1],["iti",-1,1],["eresti",-1,1],["iresti",-1,1],["uti",-1,1],["avi",-1,1],["evi",-1,1],["ivi",-1,1],["isco",-1,1],["ando",-1,1],["endo",-1,1],["Yamo",-1,1],["iamo",-1,1],["avamo",-1,1],["evamo",-1,1],["ivamo",-1,1],["eremo",-1,1],["iremo",-1,1],["assimo",-1,1],["ammo",-1,1],["emmo",-1,1],["eremmo",54,1],["iremmo",54,1],["immo",-1,1],["ano",-1,1],["iscano",58,1],["avano",58,1],["evano",58,1],["ivano",58,1],["eranno",-1,1],["iranno",-1,1],["ono",-1,1],["iscono",65,1],["arono",65,1],["erono",65,1],["irono",65,1],["erebbero",-1,1],["irebbero",-1,1],["assero",-1,1],["essero",-1,1],["issero",-1,1],["ato",-1,1],["ito",-1,1],["uto",-1,1],["avo",-1,1],["evo",-1,1],["ivo",-1,1],["ar",-1,1],["ir",-1,1],["erà",-1,1],["irà",-1,1],["erò",-1,1],["irò",-1,1]];var l=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,128,128,8,2,1];var n=[17,65,0,0,0,0,0,0,0,0,0,0,0,0,0,128,128,8,2];var f=[17];var b=0;var m=0;var k=0;function _(){var i;var a=r.cursor;while(true){var s=r.cursor;r:{r.bra=r.cursor;i=r.find_among(e);if(i==0){break r}r.ket=r.cursor;switch(i){case 1:if(!r.slice_from("à")){return false}break;case 2:if(!r.slice_from("è")){return false}break;case 3:if(!r.slice_from("ì")){return false}break;case 4:if(!r.slice_from("ò")){return false}break;case 5:if(!r.slice_from("ù")){return false}break;case 6:if(!r.slice_from("qU")){return false}break;case 7:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=s;break}r.cursor=a;while(true){var o=r.cursor;r:{e:while(true){var u=r.cursor;i:{if(!r.in_grouping(l,97,249)){break i}r.bra=r.cursor;a:{var t=r.cursor;s:{if(!r.eq_s("u")){break s}r.ket=r.cursor;if(!r.in_grouping(l,97,249)){break s}if(!r.slice_from("U")){return false}break a}r.cursor=t;if(!r.eq_s("i")){break i}r.ket=r.cursor;if(!r.in_grouping(l,97,249)){break i}if(!r.slice_from("I")){return false}}r.cursor=u;break e}r.cursor=u;if(r.cursor>=r.limit){break r}r.cursor++}continue}r.cursor=o;break}return true}function v(){k=r.limit;m=r.limit;b=r.limit;var e=r.cursor;r:{e:{var i=r.cursor;i:{if(!r.in_grouping(l,97,249)){break i}a:{var a=r.cursor;s:{if(!r.out_grouping(l,97,249)){break s}o:while(true){u:{if(!r.in_grouping(l,97,249)){break u}break o}if(r.cursor>=r.limit){break s}r.cursor++}break a}r.cursor=a;if(!r.in_grouping(l,97,249)){break i}s:while(true){o:{if(!r.out_grouping(l,97,249)){break o}break s}if(r.cursor>=r.limit){break i}r.cursor++}}break e}r.cursor=i;if(!r.out_grouping(l,97,249)){break r}i:{var s=r.cursor;a:{if(!r.out_grouping(l,97,249)){break a}s:while(true){o:{if(!r.in_grouping(l,97,249)){break o}break s}if(r.cursor>=r.limit){break a}r.cursor++}break i}r.cursor=s;if(!r.in_grouping(l,97,249)){break r}if(r.cursor>=r.limit){break r}r.cursor++}}k=r.cursor}r.cursor=e;var o=r.cursor;r:{e:while(true){i:{if(!r.in_grouping(l,97,249)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(l,97,249)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}m=r.cursor;e:while(true){i:{if(!r.in_grouping(l,97,249)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(l,97,249)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}b=r.cursor}r.cursor=o;return true}function g(){var e;while(true){var a=r.cursor;r:{r.bra=r.cursor;e=r.find_among(i);if(e==0){break r}r.ket=r.cursor;switch(e){case 1:if(!r.slice_from("i")){return false}break;case 2:if(!r.slice_from("u")){return false}break;case 3:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=a;break}return true}function d(){if(!(k<=r.cursor)){return false}return true}function w(){if(!(m<=r.cursor)){return false}return true}function h(){if(!(b<=r.cursor)){return false}return true}function p(){var e;r.ket=r.cursor;if(r.find_among_b(a)==0){return false}r.bra=r.cursor;e=r.find_among_b(s);if(e==0){return false}if(!d()){return false}switch(e){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.slice_from("e")){return false}break}return true}function q(){var e;r.ket=r.cursor;e=r.find_among_b(t);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:if(!h()){return false}if(!r.slice_del()){return false}break;case 2:if(!h()){return false}if(!r.slice_del()){return false}var i=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("ic")){r.cursor=r.limit-i;break r}r.bra=r.cursor;if(!h()){r.cursor=r.limit-i;break r}if(!r.slice_del()){return false}}break;case 3:if(!h()){return false}if(!r.slice_from("log")){return false}break;case 4:if(!h()){return false}if(!r.slice_from("u")){return false}break;case 5:if(!h()){return false}if(!r.slice_from("ente")){return false}break;case 6:if(!d()){return false}if(!r.slice_del()){return false}break;case 7:if(!w()){return false}if(!r.slice_del()){return false}var a=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(o);if(e==0){r.cursor=r.limit-a;break r}r.bra=r.cursor;if(!h()){r.cursor=r.limit-a;break r}if(!r.slice_del()){return false}switch(e){case 1:r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-a;break r}r.bra=r.cursor;if(!h()){r.cursor=r.limit-a;break r}if(!r.slice_del()){return false}break}}break;case 8:if(!h()){return false}if(!r.slice_del()){return false}var s=r.limit-r.cursor;r:{r.ket=r.cursor;if(r.find_among_b(u)==0){r.cursor=r.limit-s;break r}r.bra=r.cursor;if(!h()){r.cursor=r.limit-s;break r}if(!r.slice_del()){return false}}break;case 9:if(!h()){return false}if(!r.slice_del()){return false}var c=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-c;break r}r.bra=r.cursor;if(!h()){r.cursor=r.limit-c;break r}if(!r.slice_del()){return false}r.ket=r.cursor;if(!r.eq_s_b("ic")){r.cursor=r.limit-c;break r}r.bra=r.cursor;if(!h()){r.cursor=r.limit-c;break r}if(!r.slice_del()){return false}}break}return true}function z(){if(r.cursor<k){return false}var e=r.limit_backward;r.limit_backward=k;r.ket=r.cursor;if(r.find_among_b(c)==0){r.limit_backward=e;return false}r.bra=r.cursor;if(!r.slice_del()){return false}r.limit_backward=e;return true}function I(){var e=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.in_grouping_b(n,97,242)){r.cursor=r.limit-e;break r}r.bra=r.cursor;if(!d()){r.cursor=r.limit-e;break r}if(!r.slice_del()){return false}r.ket=r.cursor;if(!r.eq_s_b("i")){r.cursor=r.limit-e;break r}r.bra=r.cursor;if(!d()){r.cursor=r.limit-e;break r}if(!r.slice_del()){return false}}var i=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("h")){r.cursor=r.limit-i;break r}r.bra=r.cursor;if(!r.in_grouping_b(f,99,103)){r.cursor=r.limit-i;break r}if(!d()){r.cursor=r.limit-i;break r}if(!r.slice_del()){return false}}return true}this.stem=function(){var e=r.cursor;_();r.cursor=e;v();r.limit_backward=r.cursor;r.cursor=r.limit;var i=r.limit-r.cursor;p();r.cursor=r.limit-i;var a=r.limit-r.cursor;r:{e:{var s=r.limit-r.cursor;i:{if(!q()){break i}break e}r.cursor=r.limit-s;if(!z()){break r}}}r.cursor=r.limit-a;var o=r.limit-r.cursor;I();r.cursor=r.limit-o;r.cursor=r.limit_backward;var u=r.cursor;g();r.cursor=u;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}};��������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/norwegian-stemmer.js�����������������������������������������0000644�0000766�0000024�00000005042�00000000000�023311� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������NorwegianStemmer=function(){var r=new BaseStemmer;var e=[["a",-1,1],["e",-1,1],["ede",1,1],["ande",1,1],["ende",1,1],["ane",1,1],["ene",1,1],["hetene",6,1],["erte",1,3],["en",-1,1],["heten",9,1],["ar",-1,1],["er",-1,1],["heter",12,1],["s",-1,2],["as",14,1],["es",14,1],["edes",16,1],["endes",16,1],["enes",16,1],["hetenes",19,1],["ens",14,1],["hetens",21,1],["ers",14,1],["ets",14,1],["et",-1,1],["het",25,1],["ert",-1,3],["ast",-1,1]];var i=[["dt",-1,-1],["vt",-1,-1]];var t=[["leg",-1,1],["eleg",0,1],["ig",-1,1],["eig",2,1],["lig",2,1],["elig",4,1],["els",-1,1],["lov",-1,1],["elov",7,1],["slov",7,1],["hetslov",9,1]];var a=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,48,0,128];var s=[119,125,149,1];var u=0;var c=0;function l(){c=r.limit;var e=r.cursor;{var i=r.cursor+3;if(i>r.limit){return false}r.cursor=i}u=r.cursor;r.cursor=e;r:while(true){var t=r.cursor;e:{if(!r.in_grouping(a,97,248)){break e}r.cursor=t;break r}r.cursor=t;if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){e:{if(!r.out_grouping(a,97,248)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}c=r.cursor;r:{if(!(c<u)){break r}c=u}return true}function n(){var i;if(r.cursor<c){return false}var t=r.limit_backward;r.limit_backward=c;r.ket=r.cursor;i=r.find_among_b(e);if(i==0){r.limit_backward=t;return false}r.bra=r.cursor;r.limit_backward=t;switch(i){case 1:if(!r.slice_del()){return false}break;case 2:r:{var u=r.limit-r.cursor;e:{if(!r.in_grouping_b(s,98,122)){break e}break r}r.cursor=r.limit-u;if(!r.eq_s_b("k")){return false}if(!r.out_grouping_b(a,97,248)){return false}}if(!r.slice_del()){return false}break;case 3:if(!r.slice_from("er")){return false}break}return true}function o(){var e=r.limit-r.cursor;if(r.cursor<c){return false}var t=r.limit_backward;r.limit_backward=c;r.ket=r.cursor;if(r.find_among_b(i)==0){r.limit_backward=t;return false}r.bra=r.cursor;r.limit_backward=t;r.cursor=r.limit-e;if(r.cursor<=r.limit_backward){return false}r.cursor--;r.bra=r.cursor;if(!r.slice_del()){return false}return true}function f(){if(r.cursor<c){return false}var e=r.limit_backward;r.limit_backward=c;r.ket=r.cursor;if(r.find_among_b(t)==0){r.limit_backward=e;return false}r.bra=r.cursor;r.limit_backward=e;if(!r.slice_del()){return false}return true}this.stem=function(){var e=r.cursor;l();r.cursor=e;r.limit_backward=r.cursor;r.cursor=r.limit;var i=r.limit-r.cursor;n();r.cursor=r.limit-i;var t=r.limit-r.cursor;o();r.cursor=r.limit-t;var a=r.limit-r.cursor;f();r.cursor=r.limit-a;r.cursor=r.limit_backward;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}};����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/porter-stemmer.js��������������������������������������������0000644�0000766�0000024�00000014447�00000000000�022644� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������PorterStemmer=function(){var r=new BaseStemmer;var e=[["s",-1,3],["ies",0,2],["sses",0,1],["ss",0,-1]];var i=[["",-1,3],["bb",0,2],["dd",0,2],["ff",0,2],["gg",0,2],["bl",0,1],["mm",0,2],["nn",0,2],["pp",0,2],["rr",0,2],["at",0,1],["tt",0,2],["iz",0,1]];var s=[["ed",-1,2],["eed",0,1],["ing",-1,2]];var a=[["anci",-1,3],["enci",-1,2],["abli",-1,4],["eli",-1,6],["alli",-1,9],["ousli",-1,11],["entli",-1,5],["aliti",-1,9],["biliti",-1,13],["iviti",-1,12],["tional",-1,1],["ational",10,8],["alism",-1,9],["ation",-1,8],["ization",13,7],["izer",-1,7],["ator",-1,8],["iveness",-1,12],["fulness",-1,10],["ousness",-1,11]];var u=[["icate",-1,2],["ative",-1,3],["alize",-1,1],["iciti",-1,2],["ical",-1,2],["ful",-1,3],["ness",-1,3]];var t=[["ic",-1,1],["ance",-1,1],["ence",-1,1],["able",-1,1],["ible",-1,1],["ate",-1,1],["ive",-1,1],["ize",-1,1],["iti",-1,1],["al",-1,1],["ism",-1,1],["ion",-1,2],["er",-1,1],["ous",-1,1],["ant",-1,1],["ent",-1,1],["ment",15,1],["ement",16,1],["ou",-1,1]];var c=[17,65,16,1];var f=[1,17,65,208,1];var l=false;var o=0;var n=0;function b(){if(!r.out_grouping_b(f,89,121)){return false}if(!r.in_grouping_b(c,97,121)){return false}if(!r.out_grouping_b(c,97,121)){return false}return true}function m(){if(!(n<=r.cursor)){return false}return true}function _(){if(!(o<=r.cursor)){return false}return true}function k(){var i;r.ket=r.cursor;i=r.find_among_b(e);if(i==0){return false}r.bra=r.cursor;switch(i){case 1:if(!r.slice_from("ss")){return false}break;case 2:if(!r.slice_from("i")){return false}break;case 3:if(!r.slice_del()){return false}break}return true}function v(){var e;r.ket=r.cursor;e=r.find_among_b(s);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:if(!m()){return false}if(!r.slice_from("ee")){return false}break;case 2:var a=r.limit-r.cursor;r:while(true){e:{if(!r.in_grouping_b(c,97,121)){break e}break r}if(r.cursor<=r.limit_backward){return false}r.cursor--}r.cursor=r.limit-a;if(!r.slice_del()){return false}var u=r.limit-r.cursor;e=r.find_among_b(i);if(e==0){return false}r.cursor=r.limit-u;switch(e){case 1:{var t=r.cursor;r.insert(r.cursor,r.cursor,"e");r.cursor=t}break;case 2:r.ket=r.cursor;if(r.cursor<=r.limit_backward){return false}r.cursor--;r.bra=r.cursor;if(!r.slice_del()){return false}break;case 3:if(r.cursor!=n){return false}var f=r.limit-r.cursor;if(!b()){return false}r.cursor=r.limit-f;{var l=r.cursor;r.insert(r.cursor,r.cursor,"e");r.cursor=l}break}break}return true}function g(){r.ket=r.cursor;r:{var e=r.limit-r.cursor;e:{if(!r.eq_s_b("y")){break e}break r}r.cursor=r.limit-e;if(!r.eq_s_b("Y")){return false}}r.bra=r.cursor;r:while(true){e:{if(!r.in_grouping_b(c,97,121)){break e}break r}if(r.cursor<=r.limit_backward){return false}r.cursor--}if(!r.slice_from("i")){return false}return true}function d(){var e;r.ket=r.cursor;e=r.find_among_b(a);if(e==0){return false}r.bra=r.cursor;if(!m()){return false}switch(e){case 1:if(!r.slice_from("tion")){return false}break;case 2:if(!r.slice_from("ence")){return false}break;case 3:if(!r.slice_from("ance")){return false}break;case 4:if(!r.slice_from("able")){return false}break;case 5:if(!r.slice_from("ent")){return false}break;case 6:if(!r.slice_from("e")){return false}break;case 7:if(!r.slice_from("ize")){return false}break;case 8:if(!r.slice_from("ate")){return false}break;case 9:if(!r.slice_from("al")){return false}break;case 10:if(!r.slice_from("ful")){return false}break;case 11:if(!r.slice_from("ous")){return false}break;case 12:if(!r.slice_from("ive")){return false}break;case 13:if(!r.slice_from("ble")){return false}break}return true}function w(){var e;r.ket=r.cursor;e=r.find_among_b(u);if(e==0){return false}r.bra=r.cursor;if(!m()){return false}switch(e){case 1:if(!r.slice_from("al")){return false}break;case 2:if(!r.slice_from("ic")){return false}break;case 3:if(!r.slice_del()){return false}break}return true}function h(){var e;r.ket=r.cursor;e=r.find_among_b(t);if(e==0){return false}r.bra=r.cursor;if(!_()){return false}switch(e){case 1:if(!r.slice_del()){return false}break;case 2:r:{var i=r.limit-r.cursor;e:{if(!r.eq_s_b("s")){break e}break r}r.cursor=r.limit-i;if(!r.eq_s_b("t")){return false}}if(!r.slice_del()){return false}break}return true}function p(){r.ket=r.cursor;if(!r.eq_s_b("e")){return false}r.bra=r.cursor;r:{var e=r.limit-r.cursor;e:{if(!_()){break e}break r}r.cursor=r.limit-e;if(!m()){return false}{var i=r.limit-r.cursor;e:{if(!b()){break e}return false}r.cursor=r.limit-i}}if(!r.slice_del()){return false}return true}function q(){r.ket=r.cursor;if(!r.eq_s_b("l")){return false}r.bra=r.cursor;if(!_()){return false}if(!r.eq_s_b("l")){return false}if(!r.slice_del()){return false}return true}this.stem=function(){l=false;var e=r.cursor;r:{r.bra=r.cursor;if(!r.eq_s("y")){break r}r.ket=r.cursor;if(!r.slice_from("Y")){return false}l=true}r.cursor=e;var i=r.cursor;r:{while(true){var s=r.cursor;e:{i:while(true){var a=r.cursor;s:{if(!r.in_grouping(c,97,121)){break s}r.bra=r.cursor;if(!r.eq_s("y")){break s}r.ket=r.cursor;r.cursor=a;break i}r.cursor=a;if(r.cursor>=r.limit){break e}r.cursor++}if(!r.slice_from("Y")){return false}l=true;continue}r.cursor=s;break}}r.cursor=i;n=r.limit;o=r.limit;var u=r.cursor;r:{e:while(true){i:{if(!r.in_grouping(c,97,121)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(c,97,121)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}n=r.cursor;e:while(true){i:{if(!r.in_grouping(c,97,121)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(c,97,121)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}o=r.cursor}r.cursor=u;r.limit_backward=r.cursor;r.cursor=r.limit;var t=r.limit-r.cursor;k();r.cursor=r.limit-t;var f=r.limit-r.cursor;v();r.cursor=r.limit-f;var b=r.limit-r.cursor;g();r.cursor=r.limit-b;var m=r.limit-r.cursor;d();r.cursor=r.limit-m;var _=r.limit-r.cursor;w();r.cursor=r.limit-_;var z=r.limit-r.cursor;h();r.cursor=r.limit-z;var y=r.limit-r.cursor;p();r.cursor=r.limit-y;var Y=r.limit-r.cursor;q();r.cursor=r.limit-Y;r.cursor=r.limit_backward;var C=r.cursor;r:{if(!l){break r}while(true){var S=r.cursor;e:{i:while(true){var B=r.cursor;s:{r.bra=r.cursor;if(!r.eq_s("Y")){break s}r.ket=r.cursor;r.cursor=B;break i}r.cursor=B;if(r.cursor>=r.limit){break e}r.cursor++}if(!r.slice_from("y")){return false}continue}r.cursor=S;break}}r.cursor=C;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}};�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/portuguese-stemmer.js����������������������������������������0000644�0000766�0000024�00000020265�00000000000�023526� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������PortugueseStemmer=function(){var r=new BaseStemmer;var e=[["",-1,3],["ã",0,1],["õ",0,2]];var i=[["",-1,3],["a~",0,1],["o~",0,2]];var s=[["ic",-1,-1],["ad",-1,-1],["os",-1,-1],["iv",-1,1]];var a=[["ante",-1,1],["avel",-1,1],["ível",-1,1]];var u=[["ic",-1,1],["abil",-1,1],["iv",-1,1]];var o=[["ica",-1,1],["ância",-1,1],["ência",-1,4],["logia",-1,2],["ira",-1,9],["adora",-1,1],["osa",-1,1],["ista",-1,1],["iva",-1,8],["eza",-1,1],["idade",-1,7],["ante",-1,1],["mente",-1,6],["amente",12,5],["ável",-1,1],["ível",-1,1],["ico",-1,1],["ismo",-1,1],["oso",-1,1],["amento",-1,1],["imento",-1,1],["ivo",-1,8],["aça~o",-1,1],["uça~o",-1,3],["ador",-1,1],["icas",-1,1],["ências",-1,4],["logias",-1,2],["iras",-1,9],["adoras",-1,1],["osas",-1,1],["istas",-1,1],["ivas",-1,8],["ezas",-1,1],["idades",-1,7],["adores",-1,1],["antes",-1,1],["aço~es",-1,1],["uço~es",-1,3],["icos",-1,1],["ismos",-1,1],["osos",-1,1],["amentos",-1,1],["imentos",-1,1],["ivos",-1,8]];var t=[["ada",-1,1],["ida",-1,1],["ia",-1,1],["aria",2,1],["eria",2,1],["iria",2,1],["ara",-1,1],["era",-1,1],["ira",-1,1],["ava",-1,1],["asse",-1,1],["esse",-1,1],["isse",-1,1],["aste",-1,1],["este",-1,1],["iste",-1,1],["ei",-1,1],["arei",16,1],["erei",16,1],["irei",16,1],["am",-1,1],["iam",20,1],["ariam",21,1],["eriam",21,1],["iriam",21,1],["aram",20,1],["eram",20,1],["iram",20,1],["avam",20,1],["em",-1,1],["arem",29,1],["erem",29,1],["irem",29,1],["assem",29,1],["essem",29,1],["issem",29,1],["ado",-1,1],["ido",-1,1],["ando",-1,1],["endo",-1,1],["indo",-1,1],["ara~o",-1,1],["era~o",-1,1],["ira~o",-1,1],["ar",-1,1],["er",-1,1],["ir",-1,1],["as",-1,1],["adas",47,1],["idas",47,1],["ias",47,1],["arias",50,1],["erias",50,1],["irias",50,1],["aras",47,1],["eras",47,1],["iras",47,1],["avas",47,1],["es",-1,1],["ardes",58,1],["erdes",58,1],["irdes",58,1],["ares",58,1],["eres",58,1],["ires",58,1],["asses",58,1],["esses",58,1],["isses",58,1],["astes",58,1],["estes",58,1],["istes",58,1],["is",-1,1],["ais",71,1],["eis",71,1],["areis",73,1],["ereis",73,1],["ireis",73,1],["áreis",73,1],["éreis",73,1],["íreis",73,1],["ásseis",73,1],["ésseis",73,1],["ísseis",73,1],["áveis",73,1],["íeis",73,1],["aríeis",84,1],["eríeis",84,1],["iríeis",84,1],["ados",-1,1],["idos",-1,1],["amos",-1,1],["áramos",90,1],["éramos",90,1],["íramos",90,1],["ávamos",90,1],["íamos",90,1],["aríamos",95,1],["eríamos",95,1],["iríamos",95,1],["emos",-1,1],["aremos",99,1],["eremos",99,1],["iremos",99,1],["ássemos",99,1],["êssemos",99,1],["íssemos",99,1],["imos",-1,1],["armos",-1,1],["ermos",-1,1],["irmos",-1,1],["ámos",-1,1],["arás",-1,1],["erás",-1,1],["irás",-1,1],["eu",-1,1],["iu",-1,1],["ou",-1,1],["ará",-1,1],["erá",-1,1],["irá",-1,1]];var c=[["a",-1,1],["i",-1,1],["o",-1,1],["os",-1,1],["á",-1,1],["í",-1,1],["ó",-1,1]];var f=[["e",-1,1],["ç",-1,2],["é",-1,1],["ê",-1,1]];var l=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,3,19,12,2];var n=0;var m=0;var b=0;function k(){var i;while(true){var s=r.cursor;r:{r.bra=r.cursor;i=r.find_among(e);if(i==0){break r}r.ket=r.cursor;switch(i){case 1:if(!r.slice_from("a~")){return false}break;case 2:if(!r.slice_from("o~")){return false}break;case 3:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=s;break}return true}function _(){b=r.limit;m=r.limit;n=r.limit;var e=r.cursor;r:{e:{var i=r.cursor;i:{if(!r.in_grouping(l,97,250)){break i}s:{var s=r.cursor;a:{if(!r.out_grouping(l,97,250)){break a}u:while(true){o:{if(!r.in_grouping(l,97,250)){break o}break u}if(r.cursor>=r.limit){break a}r.cursor++}break s}r.cursor=s;if(!r.in_grouping(l,97,250)){break i}a:while(true){u:{if(!r.out_grouping(l,97,250)){break u}break a}if(r.cursor>=r.limit){break i}r.cursor++}}break e}r.cursor=i;if(!r.out_grouping(l,97,250)){break r}i:{var a=r.cursor;s:{if(!r.out_grouping(l,97,250)){break s}a:while(true){u:{if(!r.in_grouping(l,97,250)){break u}break a}if(r.cursor>=r.limit){break s}r.cursor++}break i}r.cursor=a;if(!r.in_grouping(l,97,250)){break r}if(r.cursor>=r.limit){break r}r.cursor++}}b=r.cursor}r.cursor=e;var u=r.cursor;r:{e:while(true){i:{if(!r.in_grouping(l,97,250)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(l,97,250)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}m=r.cursor;e:while(true){i:{if(!r.in_grouping(l,97,250)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(l,97,250)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}n=r.cursor}r.cursor=u;return true}function v(){var e;while(true){var s=r.cursor;r:{r.bra=r.cursor;e=r.find_among(i);if(e==0){break r}r.ket=r.cursor;switch(e){case 1:if(!r.slice_from("ã")){return false}break;case 2:if(!r.slice_from("õ")){return false}break;case 3:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=s;break}return true}function d(){if(!(b<=r.cursor)){return false}return true}function g(){if(!(m<=r.cursor)){return false}return true}function w(){if(!(n<=r.cursor)){return false}return true}function h(){var e;r.ket=r.cursor;e=r.find_among_b(o);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:if(!w()){return false}if(!r.slice_del()){return false}break;case 2:if(!w()){return false}if(!r.slice_from("log")){return false}break;case 3:if(!w()){return false}if(!r.slice_from("u")){return false}break;case 4:if(!w()){return false}if(!r.slice_from("ente")){return false}break;case 5:if(!g()){return false}if(!r.slice_del()){return false}var i=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(s);if(e==0){r.cursor=r.limit-i;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-i;break r}if(!r.slice_del()){return false}switch(e){case 1:r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-i;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-i;break r}if(!r.slice_del()){return false}break}}break;case 6:if(!w()){return false}if(!r.slice_del()){return false}var t=r.limit-r.cursor;r:{r.ket=r.cursor;if(r.find_among_b(a)==0){r.cursor=r.limit-t;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-t;break r}if(!r.slice_del()){return false}}break;case 7:if(!w()){return false}if(!r.slice_del()){return false}var c=r.limit-r.cursor;r:{r.ket=r.cursor;if(r.find_among_b(u)==0){r.cursor=r.limit-c;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-c;break r}if(!r.slice_del()){return false}}break;case 8:if(!w()){return false}if(!r.slice_del()){return false}var f=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-f;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-f;break r}if(!r.slice_del()){return false}}break;case 9:if(!d()){return false}if(!r.eq_s_b("e")){return false}if(!r.slice_from("ir")){return false}break}return true}function p(){if(r.cursor<b){return false}var e=r.limit_backward;r.limit_backward=b;r.ket=r.cursor;if(r.find_among_b(t)==0){r.limit_backward=e;return false}r.bra=r.cursor;if(!r.slice_del()){return false}r.limit_backward=e;return true}function q(){r.ket=r.cursor;if(r.find_among_b(c)==0){return false}r.bra=r.cursor;if(!d()){return false}if(!r.slice_del()){return false}return true}function z(){var e;r.ket=r.cursor;e=r.find_among_b(f);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:if(!d()){return false}if(!r.slice_del()){return false}r.ket=r.cursor;r:{var i=r.limit-r.cursor;e:{if(!r.eq_s_b("u")){break e}r.bra=r.cursor;var s=r.limit-r.cursor;if(!r.eq_s_b("g")){break e}r.cursor=r.limit-s;break r}r.cursor=r.limit-i;if(!r.eq_s_b("i")){return false}r.bra=r.cursor;var a=r.limit-r.cursor;if(!r.eq_s_b("c")){return false}r.cursor=r.limit-a}if(!d()){return false}if(!r.slice_del()){return false}break;case 2:if(!r.slice_from("c")){return false}break}return true}this.stem=function(){var e=r.cursor;k();r.cursor=e;_();r.limit_backward=r.cursor;r.cursor=r.limit;var i=r.limit-r.cursor;r:{e:{var s=r.limit-r.cursor;i:{var a=r.limit-r.cursor;s:{var u=r.limit-r.cursor;a:{if(!h()){break a}break s}r.cursor=r.limit-u;if(!p()){break i}}r.cursor=r.limit-a;var o=r.limit-r.cursor;s:{r.ket=r.cursor;if(!r.eq_s_b("i")){break s}r.bra=r.cursor;var t=r.limit-r.cursor;if(!r.eq_s_b("c")){break s}r.cursor=r.limit-t;if(!d()){break s}if(!r.slice_del()){return false}}r.cursor=r.limit-o;break e}r.cursor=r.limit-s;if(!q()){break r}}}r.cursor=r.limit-i;var c=r.limit-r.cursor;z();r.cursor=r.limit-c;r.cursor=r.limit_backward;var f=r.cursor;v();r.cursor=f;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}};�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/romanian-stemmer.js������������������������������������������0000644�0000766�0000024�00000020215�00000000000�023123� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������RomanianStemmer=function(){var r=new BaseStemmer;var i=[["",-1,3],["I",0,1],["U",0,2]];var e=[["ea",-1,3],["aţia",-1,7],["aua",-1,2],["iua",-1,4],["aţie",-1,7],["ele",-1,3],["ile",-1,5],["iile",6,4],["iei",-1,4],["atei",-1,6],["ii",-1,4],["ului",-1,1],["ul",-1,1],["elor",-1,3],["ilor",-1,4],["iilor",14,4]];var a=[["icala",-1,4],["iciva",-1,4],["ativa",-1,5],["itiva",-1,6],["icale",-1,4],["aţiune",-1,5],["iţiune",-1,6],["atoare",-1,5],["itoare",-1,6],["ătoare",-1,5],["icitate",-1,4],["abilitate",-1,1],["ibilitate",-1,2],["ivitate",-1,3],["icive",-1,4],["ative",-1,5],["itive",-1,6],["icali",-1,4],["atori",-1,5],["icatori",18,4],["itori",-1,6],["ători",-1,5],["icitati",-1,4],["abilitati",-1,1],["ivitati",-1,3],["icivi",-1,4],["ativi",-1,5],["itivi",-1,6],["icităi",-1,4],["abilităi",-1,1],["ivităi",-1,3],["icităţi",-1,4],["abilităţi",-1,1],["ivităţi",-1,3],["ical",-1,4],["ator",-1,5],["icator",35,4],["itor",-1,6],["ător",-1,5],["iciv",-1,4],["ativ",-1,5],["itiv",-1,6],["icală",-1,4],["icivă",-1,4],["ativă",-1,5],["itivă",-1,6]];var t=[["ica",-1,1],["abila",-1,1],["ibila",-1,1],["oasa",-1,1],["ata",-1,1],["ita",-1,1],["anta",-1,1],["ista",-1,3],["uta",-1,1],["iva",-1,1],["ic",-1,1],["ice",-1,1],["abile",-1,1],["ibile",-1,1],["isme",-1,3],["iune",-1,2],["oase",-1,1],["ate",-1,1],["itate",17,1],["ite",-1,1],["ante",-1,1],["iste",-1,3],["ute",-1,1],["ive",-1,1],["ici",-1,1],["abili",-1,1],["ibili",-1,1],["iuni",-1,2],["atori",-1,1],["osi",-1,1],["ati",-1,1],["itati",30,1],["iti",-1,1],["anti",-1,1],["isti",-1,3],["uti",-1,1],["işti",-1,3],["ivi",-1,1],["ităi",-1,1],["oşi",-1,1],["ităţi",-1,1],["abil",-1,1],["ibil",-1,1],["ism",-1,3],["ator",-1,1],["os",-1,1],["at",-1,1],["it",-1,1],["ant",-1,1],["ist",-1,3],["ut",-1,1],["iv",-1,1],["ică",-1,1],["abilă",-1,1],["ibilă",-1,1],["oasă",-1,1],["ată",-1,1],["ită",-1,1],["antă",-1,1],["istă",-1,3],["ută",-1,1],["ivă",-1,1]];var s=[["ea",-1,1],["ia",-1,1],["esc",-1,1],["ăsc",-1,1],["ind",-1,1],["ând",-1,1],["are",-1,1],["ere",-1,1],["ire",-1,1],["âre",-1,1],["se",-1,2],["ase",10,1],["sese",10,2],["ise",10,1],["use",10,1],["âse",10,1],["eşte",-1,1],["ăşte",-1,1],["eze",-1,1],["ai",-1,1],["eai",19,1],["iai",19,1],["sei",-1,2],["eşti",-1,1],["ăşti",-1,1],["ui",-1,1],["ezi",-1,1],["âi",-1,1],["aşi",-1,1],["seşi",-1,2],["aseşi",29,1],["seseşi",29,2],["iseşi",29,1],["useşi",29,1],["âseşi",29,1],["işi",-1,1],["uşi",-1,1],["âşi",-1,1],["aţi",-1,2],["eaţi",38,1],["iaţi",38,1],["eţi",-1,2],["iţi",-1,2],["âţi",-1,2],["arăţi",-1,1],["serăţi",-1,2],["aserăţi",45,1],["seserăţi",45,2],["iserăţi",45,1],["userăţi",45,1],["âserăţi",45,1],["irăţi",-1,1],["urăţi",-1,1],["ârăţi",-1,1],["am",-1,1],["eam",54,1],["iam",54,1],["em",-1,2],["asem",57,1],["sesem",57,2],["isem",57,1],["usem",57,1],["âsem",57,1],["im",-1,2],["âm",-1,2],["ăm",-1,2],["arăm",65,1],["serăm",65,2],["aserăm",67,1],["seserăm",67,2],["iserăm",67,1],["userăm",67,1],["âserăm",67,1],["irăm",65,1],["urăm",65,1],["ârăm",65,1],["au",-1,1],["eau",76,1],["iau",76,1],["indu",-1,1],["ându",-1,1],["ez",-1,1],["ească",-1,1],["ară",-1,1],["seră",-1,2],["aseră",84,1],["seseră",84,2],["iseră",84,1],["useră",84,1],["âseră",84,1],["iră",-1,1],["ură",-1,1],["âră",-1,1],["ează",-1,1]];var u=[["a",-1,1],["e",-1,1],["ie",1,1],["i",-1,1],["ă",-1,1]];var c=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,2,32,0,0,4];var o=false;var f=0;var l=0;var n=0;function b(){while(true){var i=r.cursor;r:{i:while(true){var e=r.cursor;e:{if(!r.in_grouping(c,97,259)){break e}r.bra=r.cursor;a:{var a=r.cursor;t:{if(!r.eq_s("u")){break t}r.ket=r.cursor;if(!r.in_grouping(c,97,259)){break t}if(!r.slice_from("U")){return false}break a}r.cursor=a;if(!r.eq_s("i")){break e}r.ket=r.cursor;if(!r.in_grouping(c,97,259)){break e}if(!r.slice_from("I")){return false}}r.cursor=e;break i}r.cursor=e;if(r.cursor>=r.limit){break r}r.cursor++}continue}r.cursor=i;break}return true}function m(){n=r.limit;l=r.limit;f=r.limit;var i=r.cursor;r:{i:{var e=r.cursor;e:{if(!r.in_grouping(c,97,259)){break e}a:{var a=r.cursor;t:{if(!r.out_grouping(c,97,259)){break t}s:while(true){u:{if(!r.in_grouping(c,97,259)){break u}break s}if(r.cursor>=r.limit){break t}r.cursor++}break a}r.cursor=a;if(!r.in_grouping(c,97,259)){break e}t:while(true){s:{if(!r.out_grouping(c,97,259)){break s}break t}if(r.cursor>=r.limit){break e}r.cursor++}}break i}r.cursor=e;if(!r.out_grouping(c,97,259)){break r}e:{var t=r.cursor;a:{if(!r.out_grouping(c,97,259)){break a}t:while(true){s:{if(!r.in_grouping(c,97,259)){break s}break t}if(r.cursor>=r.limit){break a}r.cursor++}break e}r.cursor=t;if(!r.in_grouping(c,97,259)){break r}if(r.cursor>=r.limit){break r}r.cursor++}}n=r.cursor}r.cursor=i;var s=r.cursor;r:{i:while(true){e:{if(!r.in_grouping(c,97,259)){break e}break i}if(r.cursor>=r.limit){break r}r.cursor++}i:while(true){e:{if(!r.out_grouping(c,97,259)){break e}break i}if(r.cursor>=r.limit){break r}r.cursor++}l=r.cursor;i:while(true){e:{if(!r.in_grouping(c,97,259)){break e}break i}if(r.cursor>=r.limit){break r}r.cursor++}i:while(true){e:{if(!r.out_grouping(c,97,259)){break e}break i}if(r.cursor>=r.limit){break r}r.cursor++}f=r.cursor}r.cursor=s;return true}function k(){var e;while(true){var a=r.cursor;r:{r.bra=r.cursor;e=r.find_among(i);if(e==0){break r}r.ket=r.cursor;switch(e){case 1:if(!r.slice_from("i")){return false}break;case 2:if(!r.slice_from("u")){return false}break;case 3:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=a;break}return true}function _(){if(!(n<=r.cursor)){return false}return true}function v(){if(!(l<=r.cursor)){return false}return true}function g(){if(!(f<=r.cursor)){return false}return true}function w(){var i;r.ket=r.cursor;i=r.find_among_b(e);if(i==0){return false}r.bra=r.cursor;if(!v()){return false}switch(i){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.slice_from("a")){return false}break;case 3:if(!r.slice_from("e")){return false}break;case 4:if(!r.slice_from("i")){return false}break;case 5:{var a=r.limit-r.cursor;r:{if(!r.eq_s_b("ab")){break r}return false}r.cursor=r.limit-a}if(!r.slice_from("i")){return false}break;case 6:if(!r.slice_from("at")){return false}break;case 7:if(!r.slice_from("aţi")){return false}break}return true}function d(){var i;var e=r.limit-r.cursor;r.ket=r.cursor;i=r.find_among_b(a);if(i==0){return false}r.bra=r.cursor;if(!v()){return false}switch(i){case 1:if(!r.slice_from("abil")){return false}break;case 2:if(!r.slice_from("ibil")){return false}break;case 3:if(!r.slice_from("iv")){return false}break;case 4:if(!r.slice_from("ic")){return false}break;case 5:if(!r.slice_from("at")){return false}break;case 6:if(!r.slice_from("it")){return false}break}o=true;r.cursor=r.limit-e;return true}function h(){var i;o=false;while(true){var e=r.limit-r.cursor;r:{if(!d()){break r}continue}r.cursor=r.limit-e;break}r.ket=r.cursor;i=r.find_among_b(t);if(i==0){return false}r.bra=r.cursor;if(!g()){return false}switch(i){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.eq_s_b("ţ")){return false}r.bra=r.cursor;if(!r.slice_from("t")){return false}break;case 3:if(!r.slice_from("ist")){return false}break}o=true;return true}function p(){var i;if(r.cursor<n){return false}var e=r.limit_backward;r.limit_backward=n;r.ket=r.cursor;i=r.find_among_b(s);if(i==0){r.limit_backward=e;return false}r.bra=r.cursor;switch(i){case 1:r:{var a=r.limit-r.cursor;i:{if(!r.out_grouping_b(c,97,259)){break i}break r}r.cursor=r.limit-a;if(!r.eq_s_b("u")){r.limit_backward=e;return false}}if(!r.slice_del()){return false}break;case 2:if(!r.slice_del()){return false}break}r.limit_backward=e;return true}function q(){r.ket=r.cursor;if(r.find_among_b(u)==0){return false}r.bra=r.cursor;if(!_()){return false}if(!r.slice_del()){return false}return true}this.stem=function(){var i=r.cursor;b();r.cursor=i;m();r.limit_backward=r.cursor;r.cursor=r.limit;var e=r.limit-r.cursor;w();r.cursor=r.limit-e;var a=r.limit-r.cursor;h();r.cursor=r.limit-a;var t=r.limit-r.cursor;r:{i:{var s=r.limit-r.cursor;e:{if(!o){break e}break i}r.cursor=r.limit-s;if(!p()){break r}}}r.cursor=r.limit-t;var u=r.limit-r.cursor;q();r.cursor=r.limit-u;r.cursor=r.limit_backward;var c=r.cursor;k();r.cursor=c;return true};this["stemWord"]=function(i){r.setCurrent(i);this.stem();return r.getCurrent()}};�����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/russian-stemmer.js�������������������������������������������0000644�0000766�0000024�00000013147�00000000000�023011� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������RussianStemmer=function(){var r=new BaseStemmer;var e=[["в",-1,1],["ив",0,2],["ыв",0,2],["вши",-1,1],["ивши",3,2],["ывши",3,2],["вшись",-1,1],["ившись",6,2],["ывшись",6,2]];var i=[["ее",-1,1],["ие",-1,1],["ое",-1,1],["ые",-1,1],["ими",-1,1],["ыми",-1,1],["ей",-1,1],["ий",-1,1],["ой",-1,1],["ый",-1,1],["ем",-1,1],["им",-1,1],["ом",-1,1],["ым",-1,1],["его",-1,1],["ого",-1,1],["ему",-1,1],["ому",-1,1],["их",-1,1],["ых",-1,1],["ею",-1,1],["ою",-1,1],["ую",-1,1],["юю",-1,1],["ая",-1,1],["яя",-1,1]];var u=[["ем",-1,1],["нн",-1,1],["вш",-1,1],["ивш",2,2],["ывш",2,2],["щ",-1,1],["ющ",5,1],["ующ",6,2]];var s=[["сь",-1,1],["ся",-1,1]];var a=[["ла",-1,1],["ила",0,2],["ыла",0,2],["на",-1,1],["ена",3,2],["ете",-1,1],["ите",-1,2],["йте",-1,1],["ейте",7,2],["уйте",7,2],["ли",-1,1],["или",10,2],["ыли",10,2],["й",-1,1],["ей",13,2],["уй",13,2],["л",-1,1],["ил",16,2],["ыл",16,2],["ем",-1,1],["им",-1,2],["ым",-1,2],["н",-1,1],["ен",22,2],["ло",-1,1],["ило",24,2],["ыло",24,2],["но",-1,1],["ено",27,2],["нно",27,1],["ет",-1,1],["ует",30,2],["ит",-1,2],["ыт",-1,2],["ют",-1,1],["уют",34,2],["ят",-1,2],["ны",-1,1],["ены",37,2],["ть",-1,1],["ить",39,2],["ыть",39,2],["ешь",-1,1],["ишь",-1,2],["ю",-1,2],["ую",44,2]];var t=[["а",-1,1],["ев",-1,1],["ов",-1,1],["е",-1,1],["ие",3,1],["ье",3,1],["и",-1,1],["еи",6,1],["ии",6,1],["ами",6,1],["ями",6,1],["иями",10,1],["й",-1,1],["ей",12,1],["ией",13,1],["ий",12,1],["ой",12,1],["ам",-1,1],["ем",-1,1],["ием",18,1],["ом",-1,1],["ям",-1,1],["иям",21,1],["о",-1,1],["у",-1,1],["ах",-1,1],["ях",-1,1],["иях",26,1],["ы",-1,1],["ь",-1,1],["ю",-1,1],["ию",30,1],["ью",30,1],["я",-1,1],["ия",33,1],["ья",33,1]];var c=[["ост",-1,1],["ость",-1,1]];var f=[["ейше",-1,1],["н",-1,2],["ейш",-1,1],["ь",-1,3]];var l=[33,65,8,232];var o=0;var n=0;function b(){n=r.limit;o=r.limit;var e=r.cursor;r:{e:while(true){i:{if(!r.in_grouping(l,1072,1103)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}n=r.cursor;e:while(true){i:{if(!r.out_grouping(l,1072,1103)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.in_grouping(l,1072,1103)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(l,1072,1103)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}o=r.cursor}r.cursor=e;return true}function _(){if(!(o<=r.cursor)){return false}return true}function k(){var i;r.ket=r.cursor;i=r.find_among_b(e);if(i==0){return false}r.bra=r.cursor;switch(i){case 1:r:{var u=r.limit-r.cursor;e:{if(!r.eq_s_b("а")){break e}break r}r.cursor=r.limit-u;if(!r.eq_s_b("я")){return false}}if(!r.slice_del()){return false}break;case 2:if(!r.slice_del()){return false}break}return true}function m(){r.ket=r.cursor;if(r.find_among_b(i)==0){return false}r.bra=r.cursor;if(!r.slice_del()){return false}return true}function v(){var e;if(!m()){return false}var i=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(u);if(e==0){r.cursor=r.limit-i;break r}r.bra=r.cursor;switch(e){case 1:e:{var s=r.limit-r.cursor;i:{if(!r.eq_s_b("а")){break i}break e}r.cursor=r.limit-s;if(!r.eq_s_b("я")){r.cursor=r.limit-i;break r}}if(!r.slice_del()){return false}break;case 2:if(!r.slice_del()){return false}break}}return true}function d(){r.ket=r.cursor;if(r.find_among_b(s)==0){return false}r.bra=r.cursor;if(!r.slice_del()){return false}return true}function g(){var e;r.ket=r.cursor;e=r.find_among_b(a);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:r:{var i=r.limit-r.cursor;e:{if(!r.eq_s_b("а")){break e}break r}r.cursor=r.limit-i;if(!r.eq_s_b("я")){return false}}if(!r.slice_del()){return false}break;case 2:if(!r.slice_del()){return false}break}return true}function w(){r.ket=r.cursor;if(r.find_among_b(t)==0){return false}r.bra=r.cursor;if(!r.slice_del()){return false}return true}function h(){r.ket=r.cursor;if(r.find_among_b(c)==0){return false}r.bra=r.cursor;if(!_()){return false}if(!r.slice_del()){return false}return true}function q(){var e;r.ket=r.cursor;e=r.find_among_b(f);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:if(!r.slice_del()){return false}r.ket=r.cursor;if(!r.eq_s_b("н")){return false}r.bra=r.cursor;if(!r.eq_s_b("н")){return false}if(!r.slice_del()){return false}break;case 2:if(!r.eq_s_b("н")){return false}if(!r.slice_del()){return false}break;case 3:if(!r.slice_del()){return false}break}return true}this.stem=function(){var e=r.cursor;r:{while(true){var i=r.cursor;e:{i:while(true){var u=r.cursor;u:{r.bra=r.cursor;if(!r.eq_s("ё")){break u}r.ket=r.cursor;r.cursor=u;break i}r.cursor=u;if(r.cursor>=r.limit){break e}r.cursor++}if(!r.slice_from("е")){return false}continue}r.cursor=i;break}}r.cursor=e;b();r.limit_backward=r.cursor;r.cursor=r.limit;if(r.cursor<n){return false}var s=r.limit_backward;r.limit_backward=n;var a=r.limit-r.cursor;r:{e:{var t=r.limit-r.cursor;i:{if(!k()){break i}break e}r.cursor=r.limit-t;var c=r.limit-r.cursor;i:{if(!d()){r.cursor=r.limit-c;break i}}i:{var f=r.limit-r.cursor;u:{if(!v()){break u}break i}r.cursor=r.limit-f;u:{if(!g()){break u}break i}r.cursor=r.limit-f;if(!w()){break r}}}}r.cursor=r.limit-a;var l=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("и")){r.cursor=r.limit-l;break r}r.bra=r.cursor;if(!r.slice_del()){return false}}var o=r.limit-r.cursor;h();r.cursor=r.limit-o;var _=r.limit-r.cursor;q();r.cursor=r.limit-_;r.limit_backward=s;r.cursor=r.limit_backward;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}};�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/spanish-stemmer.js�������������������������������������������0000644�0000766�0000024�00000021641�00000000000�022770� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������SpanishStemmer=function(){var r=new BaseStemmer;var e=[["",-1,6],["á",0,1],["é",0,2],["í",0,3],["ó",0,4],["ú",0,5]];var i=[["la",-1,-1],["sela",0,-1],["le",-1,-1],["me",-1,-1],["se",-1,-1],["lo",-1,-1],["selo",5,-1],["las",-1,-1],["selas",7,-1],["les",-1,-1],["los",-1,-1],["selos",10,-1],["nos",-1,-1]];var a=[["ando",-1,6],["iendo",-1,6],["yendo",-1,7],["ándo",-1,2],["iéndo",-1,1],["ar",-1,6],["er",-1,6],["ir",-1,6],["ár",-1,3],["ér",-1,4],["ír",-1,5]];var s=[["ic",-1,-1],["ad",-1,-1],["os",-1,-1],["iv",-1,1]];var u=[["able",-1,1],["ible",-1,1],["ante",-1,1]];var o=[["ic",-1,1],["abil",-1,1],["iv",-1,1]];var t=[["ica",-1,1],["ancia",-1,2],["encia",-1,5],["adora",-1,2],["osa",-1,1],["ista",-1,1],["iva",-1,9],["anza",-1,1],["logía",-1,3],["idad",-1,8],["able",-1,1],["ible",-1,1],["ante",-1,2],["mente",-1,7],["amente",13,6],["ación",-1,2],["ución",-1,4],["ico",-1,1],["ismo",-1,1],["oso",-1,1],["amiento",-1,1],["imiento",-1,1],["ivo",-1,9],["ador",-1,2],["icas",-1,1],["ancias",-1,2],["encias",-1,5],["adoras",-1,2],["osas",-1,1],["istas",-1,1],["ivas",-1,9],["anzas",-1,1],["logías",-1,3],["idades",-1,8],["ables",-1,1],["ibles",-1,1],["aciones",-1,2],["uciones",-1,4],["adores",-1,2],["antes",-1,2],["icos",-1,1],["ismos",-1,1],["osos",-1,1],["amientos",-1,1],["imientos",-1,1],["ivos",-1,9]];var c=[["ya",-1,1],["ye",-1,1],["yan",-1,1],["yen",-1,1],["yeron",-1,1],["yendo",-1,1],["yo",-1,1],["yas",-1,1],["yes",-1,1],["yais",-1,1],["yamos",-1,1],["yó",-1,1]];var l=[["aba",-1,2],["ada",-1,2],["ida",-1,2],["ara",-1,2],["iera",-1,2],["ía",-1,2],["aría",5,2],["ería",5,2],["iría",5,2],["ad",-1,2],["ed",-1,2],["id",-1,2],["ase",-1,2],["iese",-1,2],["aste",-1,2],["iste",-1,2],["an",-1,2],["aban",16,2],["aran",16,2],["ieran",16,2],["ían",16,2],["arían",20,2],["erían",20,2],["irían",20,2],["en",-1,1],["asen",24,2],["iesen",24,2],["aron",-1,2],["ieron",-1,2],["arán",-1,2],["erán",-1,2],["irán",-1,2],["ado",-1,2],["ido",-1,2],["ando",-1,2],["iendo",-1,2],["ar",-1,2],["er",-1,2],["ir",-1,2],["as",-1,2],["abas",39,2],["adas",39,2],["idas",39,2],["aras",39,2],["ieras",39,2],["ías",39,2],["arías",45,2],["erías",45,2],["irías",45,2],["es",-1,1],["ases",49,2],["ieses",49,2],["abais",-1,2],["arais",-1,2],["ierais",-1,2],["íais",-1,2],["aríais",55,2],["eríais",55,2],["iríais",55,2],["aseis",-1,2],["ieseis",-1,2],["asteis",-1,2],["isteis",-1,2],["áis",-1,2],["éis",-1,1],["aréis",64,2],["eréis",64,2],["iréis",64,2],["ados",-1,2],["idos",-1,2],["amos",-1,2],["ábamos",70,2],["áramos",70,2],["iéramos",70,2],["íamos",70,2],["aríamos",74,2],["eríamos",74,2],["iríamos",74,2],["emos",-1,1],["aremos",78,2],["eremos",78,2],["iremos",78,2],["ásemos",78,2],["iésemos",78,2],["imos",-1,2],["arás",-1,2],["erás",-1,2],["irás",-1,2],["ís",-1,2],["ará",-1,2],["erá",-1,2],["irá",-1,2],["aré",-1,2],["eré",-1,2],["iré",-1,2],["ió",-1,2]];var f=[["a",-1,1],["e",-1,2],["o",-1,1],["os",-1,1],["á",-1,1],["é",-1,2],["í",-1,1],["ó",-1,1]];var n=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,4,10];var b=0;var m=0;var k=0;function _(){k=r.limit;m=r.limit;b=r.limit;var e=r.cursor;r:{e:{var i=r.cursor;i:{if(!r.in_grouping(n,97,252)){break i}a:{var a=r.cursor;s:{if(!r.out_grouping(n,97,252)){break s}u:while(true){o:{if(!r.in_grouping(n,97,252)){break o}break u}if(r.cursor>=r.limit){break s}r.cursor++}break a}r.cursor=a;if(!r.in_grouping(n,97,252)){break i}s:while(true){u:{if(!r.out_grouping(n,97,252)){break u}break s}if(r.cursor>=r.limit){break i}r.cursor++}}break e}r.cursor=i;if(!r.out_grouping(n,97,252)){break r}i:{var s=r.cursor;a:{if(!r.out_grouping(n,97,252)){break a}s:while(true){u:{if(!r.in_grouping(n,97,252)){break u}break s}if(r.cursor>=r.limit){break a}r.cursor++}break i}r.cursor=s;if(!r.in_grouping(n,97,252)){break r}if(r.cursor>=r.limit){break r}r.cursor++}}k=r.cursor}r.cursor=e;var u=r.cursor;r:{e:while(true){i:{if(!r.in_grouping(n,97,252)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(n,97,252)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}m=r.cursor;e:while(true){i:{if(!r.in_grouping(n,97,252)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}e:while(true){i:{if(!r.out_grouping(n,97,252)){break i}break e}if(r.cursor>=r.limit){break r}r.cursor++}b=r.cursor}r.cursor=u;return true}function d(){var i;while(true){var a=r.cursor;r:{r.bra=r.cursor;i=r.find_among(e);if(i==0){break r}r.ket=r.cursor;switch(i){case 1:if(!r.slice_from("a")){return false}break;case 2:if(!r.slice_from("e")){return false}break;case 3:if(!r.slice_from("i")){return false}break;case 4:if(!r.slice_from("o")){return false}break;case 5:if(!r.slice_from("u")){return false}break;case 6:if(r.cursor>=r.limit){break r}r.cursor++;break}continue}r.cursor=a;break}return true}function v(){if(!(k<=r.cursor)){return false}return true}function g(){if(!(m<=r.cursor)){return false}return true}function w(){if(!(b<=r.cursor)){return false}return true}function h(){var e;r.ket=r.cursor;if(r.find_among_b(i)==0){return false}r.bra=r.cursor;e=r.find_among_b(a);if(e==0){return false}if(!v()){return false}switch(e){case 1:r.bra=r.cursor;if(!r.slice_from("iendo")){return false}break;case 2:r.bra=r.cursor;if(!r.slice_from("ando")){return false}break;case 3:r.bra=r.cursor;if(!r.slice_from("ar")){return false}break;case 4:r.bra=r.cursor;if(!r.slice_from("er")){return false}break;case 5:r.bra=r.cursor;if(!r.slice_from("ir")){return false}break;case 6:if(!r.slice_del()){return false}break;case 7:if(!r.eq_s_b("u")){return false}if(!r.slice_del()){return false}break}return true}function p(){var e;r.ket=r.cursor;e=r.find_among_b(t);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:if(!w()){return false}if(!r.slice_del()){return false}break;case 2:if(!w()){return false}if(!r.slice_del()){return false}var i=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("ic")){r.cursor=r.limit-i;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-i;break r}if(!r.slice_del()){return false}}break;case 3:if(!w()){return false}if(!r.slice_from("log")){return false}break;case 4:if(!w()){return false}if(!r.slice_from("u")){return false}break;case 5:if(!w()){return false}if(!r.slice_from("ente")){return false}break;case 6:if(!g()){return false}if(!r.slice_del()){return false}var a=r.limit-r.cursor;r:{r.ket=r.cursor;e=r.find_among_b(s);if(e==0){r.cursor=r.limit-a;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-a;break r}if(!r.slice_del()){return false}switch(e){case 1:r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-a;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-a;break r}if(!r.slice_del()){return false}break}}break;case 7:if(!w()){return false}if(!r.slice_del()){return false}var c=r.limit-r.cursor;r:{r.ket=r.cursor;if(r.find_among_b(u)==0){r.cursor=r.limit-c;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-c;break r}if(!r.slice_del()){return false}}break;case 8:if(!w()){return false}if(!r.slice_del()){return false}var l=r.limit-r.cursor;r:{r.ket=r.cursor;if(r.find_among_b(o)==0){r.cursor=r.limit-l;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-l;break r}if(!r.slice_del()){return false}}break;case 9:if(!w()){return false}if(!r.slice_del()){return false}var f=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("at")){r.cursor=r.limit-f;break r}r.bra=r.cursor;if(!w()){r.cursor=r.limit-f;break r}if(!r.slice_del()){return false}}break}return true}function y(){if(r.cursor<k){return false}var e=r.limit_backward;r.limit_backward=k;r.ket=r.cursor;if(r.find_among_b(c)==0){r.limit_backward=e;return false}r.bra=r.cursor;r.limit_backward=e;if(!r.eq_s_b("u")){return false}if(!r.slice_del()){return false}return true}function q(){var e;if(r.cursor<k){return false}var i=r.limit_backward;r.limit_backward=k;r.ket=r.cursor;e=r.find_among_b(l);if(e==0){r.limit_backward=i;return false}r.bra=r.cursor;r.limit_backward=i;switch(e){case 1:var a=r.limit-r.cursor;r:{if(!r.eq_s_b("u")){r.cursor=r.limit-a;break r}var s=r.limit-r.cursor;if(!r.eq_s_b("g")){r.cursor=r.limit-a;break r}r.cursor=r.limit-s}r.bra=r.cursor;if(!r.slice_del()){return false}break;case 2:if(!r.slice_del()){return false}break}return true}function S(){var e;r.ket=r.cursor;e=r.find_among_b(f);if(e==0){return false}r.bra=r.cursor;switch(e){case 1:if(!v()){return false}if(!r.slice_del()){return false}break;case 2:if(!v()){return false}if(!r.slice_del()){return false}var i=r.limit-r.cursor;r:{r.ket=r.cursor;if(!r.eq_s_b("u")){r.cursor=r.limit-i;break r}r.bra=r.cursor;var a=r.limit-r.cursor;if(!r.eq_s_b("g")){r.cursor=r.limit-i;break r}r.cursor=r.limit-a;if(!v()){r.cursor=r.limit-i;break r}if(!r.slice_del()){return false}}break}return true}this.stem=function(){_();r.limit_backward=r.cursor;r.cursor=r.limit;var e=r.limit-r.cursor;h();r.cursor=r.limit-e;var i=r.limit-r.cursor;r:{e:{var a=r.limit-r.cursor;i:{if(!p()){break i}break e}r.cursor=r.limit-a;i:{if(!y()){break i}break e}r.cursor=r.limit-a;if(!q()){break r}}}r.cursor=r.limit-i;var s=r.limit-r.cursor;S();r.cursor=r.limit-s;r.cursor=r.limit_backward;var u=r.cursor;d();r.cursor=u;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}};�����������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/swedish-stemmer.js�������������������������������������������0000644�0000766�0000024�00000005136�00000000000�022772� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������SwedishStemmer=function(){var r=new BaseStemmer;var e=[["a",-1,1],["arna",0,1],["erna",0,1],["heterna",2,1],["orna",0,1],["ad",-1,1],["e",-1,1],["ade",6,1],["ande",6,1],["arne",6,1],["are",6,1],["aste",6,1],["en",-1,1],["anden",12,1],["aren",12,1],["heten",12,1],["ern",-1,1],["ar",-1,1],["er",-1,1],["heter",18,1],["or",-1,1],["s",-1,2],["as",21,1],["arnas",22,1],["ernas",22,1],["ornas",22,1],["es",21,1],["ades",26,1],["andes",26,1],["ens",21,1],["arens",29,1],["hetens",29,1],["erns",21,1],["at",-1,1],["andet",-1,1],["het",-1,1],["ast",-1,1]];var a=[["dd",-1,-1],["gd",-1,-1],["nn",-1,-1],["dt",-1,-1],["gt",-1,-1],["kt",-1,-1],["tt",-1,-1]];var i=[["ig",-1,1],["lig",0,1],["els",-1,1],["fullt",-1,3],["löst",-1,2]];var t=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,24,0,32];var s=[119,127,149];var u=0;var n=0;function c(){n=r.limit;var e=r.cursor;{var a=r.cursor+3;if(a>r.limit){return false}r.cursor=a}u=r.cursor;r.cursor=e;r:while(true){var i=r.cursor;e:{if(!r.in_grouping(t,97,246)){break e}r.cursor=i;break r}r.cursor=i;if(r.cursor>=r.limit){return false}r.cursor++}r:while(true){e:{if(!r.out_grouping(t,97,246)){break e}break r}if(r.cursor>=r.limit){return false}r.cursor++}n=r.cursor;r:{if(!(n<u)){break r}n=u}return true}function l(){var a;if(r.cursor<n){return false}var i=r.limit_backward;r.limit_backward=n;r.ket=r.cursor;a=r.find_among_b(e);if(a==0){r.limit_backward=i;return false}r.bra=r.cursor;r.limit_backward=i;switch(a){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.in_grouping_b(s,98,121)){return false}if(!r.slice_del()){return false}break}return true}function o(){if(r.cursor<n){return false}var e=r.limit_backward;r.limit_backward=n;var i=r.limit-r.cursor;if(r.find_among_b(a)==0){r.limit_backward=e;return false}r.cursor=r.limit-i;r.ket=r.cursor;if(r.cursor<=r.limit_backward){r.limit_backward=e;return false}r.cursor--;r.bra=r.cursor;if(!r.slice_del()){return false}r.limit_backward=e;return true}function f(){var e;if(r.cursor<n){return false}var a=r.limit_backward;r.limit_backward=n;r.ket=r.cursor;e=r.find_among_b(i);if(e==0){r.limit_backward=a;return false}r.bra=r.cursor;switch(e){case 1:if(!r.slice_del()){return false}break;case 2:if(!r.slice_from("lös")){return false}break;case 3:if(!r.slice_from("full")){return false}break}r.limit_backward=a;return true}this.stem=function(){var e=r.cursor;c();r.cursor=e;r.limit_backward=r.cursor;r.cursor=r.limit;var a=r.limit-r.cursor;l();r.cursor=r.limit-a;var i=r.limit-r.cursor;o();r.cursor=r.limit-i;var t=r.limit-r.cursor;f();r.cursor=r.limit-t;r.cursor=r.limit_backward;return true};this["stemWord"]=function(e){r.setCurrent(e);this.stem();return r.getCurrent()}};����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/minified-js/turkish-stemmer.js�������������������������������������������0000644�0000766�0000024�00000047004�00000000000�023015� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������TurkishStemmer=function(){var r=new BaseStemmer;var i=[["m",-1,-1],["n",-1,-1],["miz",-1,-1],["niz",-1,-1],["muz",-1,-1],["nuz",-1,-1],["müz",-1,-1],["nüz",-1,-1],["mız",-1,-1],["nız",-1,-1]];var e=[["leri",-1,-1],["ları",-1,-1]];var u=[["ni",-1,-1],["nu",-1,-1],["nü",-1,-1],["nı",-1,-1]];var a=[["in",-1,-1],["un",-1,-1],["ün",-1,-1],["ın",-1,-1]];var s=[["a",-1,-1],["e",-1,-1]];var t=[["na",-1,-1],["ne",-1,-1]];var l=[["da",-1,-1],["ta",-1,-1],["de",-1,-1],["te",-1,-1]];var c=[["nda",-1,-1],["nde",-1,-1]];var o=[["dan",-1,-1],["tan",-1,-1],["den",-1,-1],["ten",-1,-1]];var f=[["ndan",-1,-1],["nden",-1,-1]];var n=[["la",-1,-1],["le",-1,-1]];var b=[["ca",-1,-1],["ce",-1,-1]];var m=[["im",-1,-1],["um",-1,-1],["üm",-1,-1],["ım",-1,-1]];var k=[["sin",-1,-1],["sun",-1,-1],["sün",-1,-1],["sın",-1,-1]];var _=[["iz",-1,-1],["uz",-1,-1],["üz",-1,-1],["ız",-1,-1]];var v=[["siniz",-1,-1],["sunuz",-1,-1],["sünüz",-1,-1],["sınız",-1,-1]];var d=[["lar",-1,-1],["ler",-1,-1]];var g=[["niz",-1,-1],["nuz",-1,-1],["nüz",-1,-1],["nız",-1,-1]];var w=[["dir",-1,-1],["tir",-1,-1],["dur",-1,-1],["tur",-1,-1],["dür",-1,-1],["tür",-1,-1],["dır",-1,-1],["tır",-1,-1]];var q=[["casına",-1,-1],["cesine",-1,-1]];var p=[["di",-1,-1],["ti",-1,-1],["dik",-1,-1],["tik",-1,-1],["duk",-1,-1],["tuk",-1,-1],["dük",-1,-1],["tük",-1,-1],["dık",-1,-1],["tık",-1,-1],["dim",-1,-1],["tim",-1,-1],["dum",-1,-1],["tum",-1,-1],["düm",-1,-1],["tüm",-1,-1],["dım",-1,-1],["tım",-1,-1],["din",-1,-1],["tin",-1,-1],["dun",-1,-1],["tun",-1,-1],["dün",-1,-1],["tün",-1,-1],["dın",-1,-1],["tın",-1,-1],["du",-1,-1],["tu",-1,-1],["dü",-1,-1],["tü",-1,-1],["dı",-1,-1],["tı",-1,-1]];var h=[["sa",-1,-1],["se",-1,-1],["sak",-1,-1],["sek",-1,-1],["sam",-1,-1],["sem",-1,-1],["san",-1,-1],["sen",-1,-1]];var z=[["miş",-1,-1],["muş",-1,-1],["müş",-1,-1],["mış",-1,-1]];var y=[["b",-1,1],["c",-1,2],["d",-1,3],["ğ",-1,4]];var C=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,32,8,0,0,0,0,0,0,1];var S=[1,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,0,0,0,0,0,1];var B=[1,64,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1];var T=[17,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,130];var W=[1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1];var j=[17];var x=[65];var A=[65];var D=false;function E(){var i=r.limit-r.cursor;r:while(true){var e=r.limit-r.cursor;i:{if(!r.in_grouping_b(C,97,305)){break i}r.cursor=r.limit-e;break r}r.cursor=r.limit-e;if(r.cursor<=r.limit_backward){return false}r.cursor--}r:{var u=r.limit-r.cursor;i:{if(!r.eq_s_b("a")){break i}e:while(true){var a=r.limit-r.cursor;u:{if(!r.in_grouping_b(B,97,305)){break u}r.cursor=r.limit-a;break e}r.cursor=r.limit-a;if(r.cursor<=r.limit_backward){break i}r.cursor--}break r}r.cursor=r.limit-u;i:{if(!r.eq_s_b("e")){break i}e:while(true){var s=r.limit-r.cursor;u:{if(!r.in_grouping_b(T,101,252)){break u}r.cursor=r.limit-s;break e}r.cursor=r.limit-s;if(r.cursor<=r.limit_backward){break i}r.cursor--}break r}r.cursor=r.limit-u;i:{if(!r.eq_s_b("ı")){break i}e:while(true){var t=r.limit-r.cursor;u:{if(!r.in_grouping_b(W,97,305)){break u}r.cursor=r.limit-t;break e}r.cursor=r.limit-t;if(r.cursor<=r.limit_backward){break i}r.cursor--}break r}r.cursor=r.limit-u;i:{if(!r.eq_s_b("i")){break i}e:while(true){var l=r.limit-r.cursor;u:{if(!r.in_grouping_b(j,101,105)){break u}r.cursor=r.limit-l;break e}r.cursor=r.limit-l;if(r.cursor<=r.limit_backward){break i}r.cursor--}break r}r.cursor=r.limit-u;i:{if(!r.eq_s_b("o")){break i}e:while(true){var c=r.limit-r.cursor;u:{if(!r.in_grouping_b(x,111,117)){break u}r.cursor=r.limit-c;break e}r.cursor=r.limit-c;if(r.cursor<=r.limit_backward){break i}r.cursor--}break r}r.cursor=r.limit-u;i:{if(!r.eq_s_b("ö")){break i}e:while(true){var o=r.limit-r.cursor;u:{if(!r.in_grouping_b(A,246,252)){break u}r.cursor=r.limit-o;break e}r.cursor=r.limit-o;if(r.cursor<=r.limit_backward){break i}r.cursor--}break r}r.cursor=r.limit-u;i:{if(!r.eq_s_b("u")){break i}e:while(true){var f=r.limit-r.cursor;u:{if(!r.in_grouping_b(x,111,117)){break u}r.cursor=r.limit-f;break e}r.cursor=r.limit-f;if(r.cursor<=r.limit_backward){break i}r.cursor--}break r}r.cursor=r.limit-u;if(!r.eq_s_b("ü")){return false}i:while(true){var n=r.limit-r.cursor;e:{if(!r.in_grouping_b(A,246,252)){break e}r.cursor=r.limit-n;break i}r.cursor=r.limit-n;if(r.cursor<=r.limit_backward){return false}r.cursor--}}r.cursor=r.limit-i;return true}function F(){r:{var i=r.limit-r.cursor;i:{if(!r.eq_s_b("n")){break i}var e=r.limit-r.cursor;if(!r.in_grouping_b(C,97,305)){break i}r.cursor=r.limit-e;break r}r.cursor=r.limit-i;{var u=r.limit-r.cursor;i:{var a=r.limit-r.cursor;if(!r.eq_s_b("n")){break i}r.cursor=r.limit-a;return false}r.cursor=r.limit-u}var s=r.limit-r.cursor;if(r.cursor<=r.limit_backward){return false}r.cursor--;if(!r.in_grouping_b(C,97,305)){return false}r.cursor=r.limit-s}return true}function G(){r:{var i=r.limit-r.cursor;i:{if(!r.eq_s_b("s")){break i}var e=r.limit-r.cursor;if(!r.in_grouping_b(C,97,305)){break i}r.cursor=r.limit-e;break r}r.cursor=r.limit-i;{var u=r.limit-r.cursor;i:{var a=r.limit-r.cursor;if(!r.eq_s_b("s")){break i}r.cursor=r.limit-a;return false}r.cursor=r.limit-u}var s=r.limit-r.cursor;if(r.cursor<=r.limit_backward){return false}r.cursor--;if(!r.in_grouping_b(C,97,305)){return false}r.cursor=r.limit-s}return true}function H(){r:{var i=r.limit-r.cursor;i:{if(!r.eq_s_b("y")){break i}var e=r.limit-r.cursor;if(!r.in_grouping_b(C,97,305)){break i}r.cursor=r.limit-e;break r}r.cursor=r.limit-i;{var u=r.limit-r.cursor;i:{var a=r.limit-r.cursor;if(!r.eq_s_b("y")){break i}r.cursor=r.limit-a;return false}r.cursor=r.limit-u}var s=r.limit-r.cursor;if(r.cursor<=r.limit_backward){return false}r.cursor--;if(!r.in_grouping_b(C,97,305)){return false}r.cursor=r.limit-s}return true}function I(){r:{var i=r.limit-r.cursor;i:{if(!r.in_grouping_b(S,105,305)){break i}var e=r.limit-r.cursor;if(!r.out_grouping_b(C,97,305)){break i}r.cursor=r.limit-e;break r}r.cursor=r.limit-i;{var u=r.limit-r.cursor;i:{var a=r.limit-r.cursor;if(!r.in_grouping_b(S,105,305)){break i}r.cursor=r.limit-a;return false}r.cursor=r.limit-u}var s=r.limit-r.cursor;if(r.cursor<=r.limit_backward){return false}r.cursor--;if(!r.out_grouping_b(C,97,305)){return false}r.cursor=r.limit-s}return true}function J(){if(r.find_among_b(i)==0){return false}if(!I()){return false}return true}function K(){if(!E()){return false}if(!r.in_grouping_b(S,105,305)){return false}if(!G()){return false}return true}function L(){if(r.find_among_b(e)==0){return false}return true}function M(){if(!E()){return false}if(!r.in_grouping_b(S,105,305)){return false}if(!H()){return false}return true}function N(){if(!E()){return false}if(r.find_among_b(u)==0){return false}return true}function O(){if(!E()){return false}if(r.find_among_b(a)==0){return false}if(!F()){return false}return true}function P(){if(!E()){return false}if(r.find_among_b(s)==0){return false}if(!H()){return false}return true}function Q(){if(!E()){return false}if(r.find_among_b(t)==0){return false}return true}function R(){if(!E()){return false}if(r.find_among_b(l)==0){return false}return true}function U(){if(!E()){return false}if(r.find_among_b(c)==0){return false}return true}function V(){if(!E()){return false}if(r.find_among_b(o)==0){return false}return true}function X(){if(!E()){return false}if(r.find_among_b(f)==0){return false}return true}function Y(){if(!E()){return false}if(r.find_among_b(n)==0){return false}if(!H()){return false}return true}function Z(){if(!r.eq_s_b("ki")){return false}return true}function $(){if(!E()){return false}if(r.find_among_b(b)==0){return false}if(!F()){return false}return true}function rr(){if(!E()){return false}if(r.find_among_b(m)==0){return false}if(!H()){return false}return true}function ir(){if(!E()){return false}if(r.find_among_b(k)==0){return false}return true}function er(){if(!E()){return false}if(r.find_among_b(_)==0){return false}if(!H()){return false}return true}function ur(){if(r.find_among_b(v)==0){return false}return true}function ar(){if(!E()){return false}if(r.find_among_b(d)==0){return false}return true}function sr(){if(!E()){return false}if(r.find_among_b(g)==0){return false}return true}function tr(){if(!E()){return false}if(r.find_among_b(w)==0){return false}return true}function lr(){if(r.find_among_b(q)==0){return false}return true}function cr(){if(!E()){return false}if(r.find_among_b(p)==0){return false}if(!H()){return false}return true}function or(){if(r.find_among_b(h)==0){return false}if(!H()){return false}return true}function fr(){if(!E()){return false}if(r.find_among_b(z)==0){return false}if(!H()){return false}return true}function nr(){if(!r.eq_s_b("ken")){return false}if(!H()){return false}return true}function br(){r.ket=r.cursor;D=true;r:{var i=r.limit-r.cursor;i:{e:{var e=r.limit-r.cursor;u:{if(!fr()){break u}break e}r.cursor=r.limit-e;u:{if(!cr()){break u}break e}r.cursor=r.limit-e;u:{if(!or()){break u}break e}r.cursor=r.limit-e;if(!nr()){break i}}break r}r.cursor=r.limit-i;i:{if(!lr()){break i}e:{var u=r.limit-r.cursor;u:{if(!ur()){break u}break e}r.cursor=r.limit-u;u:{if(!ar()){break u}break e}r.cursor=r.limit-u;u:{if(!rr()){break u}break e}r.cursor=r.limit-u;u:{if(!ir()){break u}break e}r.cursor=r.limit-u;u:{if(!er()){break u}break e}r.cursor=r.limit-u}if(!fr()){break i}break r}r.cursor=r.limit-i;i:{if(!ar()){break i}r.bra=r.cursor;if(!r.slice_del()){return false}var a=r.limit-r.cursor;e:{r.ket=r.cursor;u:{var s=r.limit-r.cursor;a:{if(!tr()){break a}break u}r.cursor=r.limit-s;a:{if(!cr()){break a}break u}r.cursor=r.limit-s;a:{if(!or()){break a}break u}r.cursor=r.limit-s;if(!fr()){r.cursor=r.limit-a;break e}}}D=false;break r}r.cursor=r.limit-i;i:{if(!sr()){break i}e:{var t=r.limit-r.cursor;u:{if(!cr()){break u}break e}r.cursor=r.limit-t;if(!or()){break i}}break r}r.cursor=r.limit-i;i:{e:{var l=r.limit-r.cursor;u:{if(!ur()){break u}break e}r.cursor=r.limit-l;u:{if(!er()){break u}break e}r.cursor=r.limit-l;u:{if(!ir()){break u}break e}r.cursor=r.limit-l;if(!rr()){break i}}r.bra=r.cursor;if(!r.slice_del()){return false}var c=r.limit-r.cursor;e:{r.ket=r.cursor;if(!fr()){r.cursor=r.limit-c;break e}}break r}r.cursor=r.limit-i;if(!tr()){return false}r.bra=r.cursor;if(!r.slice_del()){return false}var o=r.limit-r.cursor;i:{r.ket=r.cursor;e:{var f=r.limit-r.cursor;u:{if(!ur()){break u}break e}r.cursor=r.limit-f;u:{if(!ar()){break u}break e}r.cursor=r.limit-f;u:{if(!rr()){break u}break e}r.cursor=r.limit-f;u:{if(!ir()){break u}break e}r.cursor=r.limit-f;u:{if(!er()){break u}break e}r.cursor=r.limit-f}if(!fr()){r.cursor=r.limit-o;break i}}}r.bra=r.cursor;if(!r.slice_del()){return false}return true}function mr(){r.ket=r.cursor;if(!Z()){return false}r:{var i=r.limit-r.cursor;i:{if(!R()){break i}r.bra=r.cursor;if(!r.slice_del()){return false}var e=r.limit-r.cursor;e:{r.ket=r.cursor;u:{var u=r.limit-r.cursor;a:{if(!ar()){break a}r.bra=r.cursor;if(!r.slice_del()){return false}var a=r.limit-r.cursor;s:{if(!mr()){r.cursor=r.limit-a;break s}}break u}r.cursor=r.limit-u;if(!J()){r.cursor=r.limit-e;break e}r.bra=r.cursor;if(!r.slice_del()){return false}var s=r.limit-r.cursor;a:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-s;break a}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-s;break a}}}}break r}r.cursor=r.limit-i;i:{if(!O()){break i}r.bra=r.cursor;if(!r.slice_del()){return false}var t=r.limit-r.cursor;e:{r.ket=r.cursor;u:{var l=r.limit-r.cursor;a:{if(!L()){break a}r.bra=r.cursor;if(!r.slice_del()){return false}break u}r.cursor=r.limit-l;a:{r.ket=r.cursor;s:{var c=r.limit-r.cursor;t:{if(!J()){break t}break s}r.cursor=r.limit-c;if(!K()){break a}}r.bra=r.cursor;if(!r.slice_del()){return false}var o=r.limit-r.cursor;s:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-o;break s}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-o;break s}}break u}r.cursor=r.limit-l;if(!mr()){r.cursor=r.limit-t;break e}}}break r}r.cursor=r.limit-i;if(!U()){return false}i:{var f=r.limit-r.cursor;e:{if(!L()){break e}r.bra=r.cursor;if(!r.slice_del()){return false}break i}r.cursor=r.limit-f;e:{if(!K()){break e}r.bra=r.cursor;if(!r.slice_del()){return false}var n=r.limit-r.cursor;u:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-n;break u}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-n;break u}}break i}r.cursor=r.limit-f;if(!mr()){return false}}}return true}function kr(){r:{var i=r.limit-r.cursor;i:{r.ket=r.cursor;if(!ar()){break i}r.bra=r.cursor;if(!r.slice_del()){return false}var e=r.limit-r.cursor;e:{if(!mr()){r.cursor=r.limit-e;break e}}break r}r.cursor=r.limit-i;i:{r.ket=r.cursor;if(!$()){break i}r.bra=r.cursor;if(!r.slice_del()){return false}var u=r.limit-r.cursor;e:{u:{var a=r.limit-r.cursor;a:{r.ket=r.cursor;if(!L()){break a}r.bra=r.cursor;if(!r.slice_del()){return false}break u}r.cursor=r.limit-a;a:{r.ket=r.cursor;s:{var s=r.limit-r.cursor;t:{if(!J()){break t}break s}r.cursor=r.limit-s;if(!K()){break a}}r.bra=r.cursor;if(!r.slice_del()){return false}var t=r.limit-r.cursor;s:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-t;break s}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-t;break s}}break u}r.cursor=r.limit-a;r.ket=r.cursor;if(!ar()){r.cursor=r.limit-u;break e}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-u;break e}}}break r}r.cursor=r.limit-i;i:{r.ket=r.cursor;e:{var l=r.limit-r.cursor;u:{if(!U()){break u}break e}r.cursor=r.limit-l;if(!Q()){break i}}e:{var c=r.limit-r.cursor;u:{if(!L()){break u}r.bra=r.cursor;if(!r.slice_del()){return false}break e}r.cursor=r.limit-c;u:{if(!K()){break u}r.bra=r.cursor;if(!r.slice_del()){return false}var o=r.limit-r.cursor;a:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-o;break a}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-o;break a}}break e}r.cursor=r.limit-c;if(!mr()){break i}}break r}r.cursor=r.limit-i;i:{r.ket=r.cursor;e:{var f=r.limit-r.cursor;u:{if(!X()){break u}break e}r.cursor=r.limit-f;if(!N()){break i}}e:{var n=r.limit-r.cursor;u:{if(!K()){break u}r.bra=r.cursor;if(!r.slice_del()){return false}var b=r.limit-r.cursor;a:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-b;break a}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-b;break a}}break e}r.cursor=r.limit-n;if(!L()){break i}}break r}r.cursor=r.limit-i;i:{r.ket=r.cursor;if(!V()){break i}r.bra=r.cursor;if(!r.slice_del()){return false}var m=r.limit-r.cursor;e:{r.ket=r.cursor;u:{var k=r.limit-r.cursor;a:{if(!J()){break a}r.bra=r.cursor;if(!r.slice_del()){return false}var _=r.limit-r.cursor;s:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-_;break s}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-_;break s}}break u}r.cursor=r.limit-k;a:{if(!ar()){break a}r.bra=r.cursor;if(!r.slice_del()){return false}var v=r.limit-r.cursor;s:{if(!mr()){r.cursor=r.limit-v;break s}}break u}r.cursor=r.limit-k;if(!mr()){r.cursor=r.limit-m;break e}}}break r}r.cursor=r.limit-i;i:{r.ket=r.cursor;e:{var d=r.limit-r.cursor;u:{if(!O()){break u}break e}r.cursor=r.limit-d;if(!Y()){break i}}r.bra=r.cursor;if(!r.slice_del()){return false}var g=r.limit-r.cursor;e:{u:{var w=r.limit-r.cursor;a:{r.ket=r.cursor;if(!ar()){break a}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){break a}break u}r.cursor=r.limit-w;a:{r.ket=r.cursor;s:{var q=r.limit-r.cursor;t:{if(!J()){break t}break s}r.cursor=r.limit-q;if(!K()){break a}}r.bra=r.cursor;if(!r.slice_del()){return false}var p=r.limit-r.cursor;s:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-p;break s}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-p;break s}}break u}r.cursor=r.limit-w;if(!mr()){r.cursor=r.limit-g;break e}}}break r}r.cursor=r.limit-i;i:{r.ket=r.cursor;if(!L()){break i}r.bra=r.cursor;if(!r.slice_del()){return false}break r}r.cursor=r.limit-i;i:{if(!mr()){break i}break r}r.cursor=r.limit-i;i:{r.ket=r.cursor;e:{var h=r.limit-r.cursor;u:{if(!R()){break u}break e}r.cursor=r.limit-h;u:{if(!M()){break u}break e}r.cursor=r.limit-h;if(!P()){break i}}r.bra=r.cursor;if(!r.slice_del()){return false}var z=r.limit-r.cursor;e:{r.ket=r.cursor;u:{var y=r.limit-r.cursor;a:{if(!J()){break a}r.bra=r.cursor;if(!r.slice_del()){return false}var C=r.limit-r.cursor;s:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-C;break s}}break u}r.cursor=r.limit-y;if(!ar()){r.cursor=r.limit-z;break e}}r.bra=r.cursor;if(!r.slice_del()){return false}r.ket=r.cursor;if(!mr()){r.cursor=r.limit-z;break e}}break r}r.cursor=r.limit-i;r.ket=r.cursor;i:{var S=r.limit-r.cursor;e:{if(!J()){break e}break i}r.cursor=r.limit-S;if(!K()){return false}}r.bra=r.cursor;if(!r.slice_del()){return false}var B=r.limit-r.cursor;i:{r.ket=r.cursor;if(!ar()){r.cursor=r.limit-B;break i}r.bra=r.cursor;if(!r.slice_del()){return false}if(!mr()){r.cursor=r.limit-B;break i}}}return true}function _r(){var i;r.ket=r.cursor;i=r.find_among_b(y);if(i==0){return false}r.bra=r.cursor;switch(i){case 1:if(!r.slice_from("p")){return false}break;case 2:if(!r.slice_from("ç")){return false}break;case 3:if(!r.slice_from("t")){return false}break;case 4:if(!r.slice_from("k")){return false}break}return true}function vr(){var i=r.limit-r.cursor;r:{var e=r.limit-r.cursor;i:{if(!r.eq_s_b("d")){break i}break r}r.cursor=r.limit-e;if(!r.eq_s_b("g")){return false}}r.cursor=r.limit-i;r:{var u=r.limit-r.cursor;i:{var a=r.limit-r.cursor;e:while(true){var s=r.limit-r.cursor;u:{if(!r.in_grouping_b(C,97,305)){break u}r.cursor=r.limit-s;break e}r.cursor=r.limit-s;if(r.cursor<=r.limit_backward){break i}r.cursor--}e:{var t=r.limit-r.cursor;u:{if(!r.eq_s_b("a")){break u}break e}r.cursor=r.limit-t;if(!r.eq_s_b("ı")){break i}}r.cursor=r.limit-a;{var l=r.cursor;r.insert(r.cursor,r.cursor,"ı");r.cursor=l}break r}r.cursor=r.limit-u;i:{var c=r.limit-r.cursor;e:while(true){var o=r.limit-r.cursor;u:{if(!r.in_grouping_b(C,97,305)){break u}r.cursor=r.limit-o;break e}r.cursor=r.limit-o;if(r.cursor<=r.limit_backward){break i}r.cursor--}e:{var f=r.limit-r.cursor;u:{if(!r.eq_s_b("e")){break u}break e}r.cursor=r.limit-f;if(!r.eq_s_b("i")){break i}}r.cursor=r.limit-c;{var n=r.cursor;r.insert(r.cursor,r.cursor,"i");r.cursor=n}break r}r.cursor=r.limit-u;i:{var b=r.limit-r.cursor;e:while(true){var m=r.limit-r.cursor;u:{if(!r.in_grouping_b(C,97,305)){break u}r.cursor=r.limit-m;break e}r.cursor=r.limit-m;if(r.cursor<=r.limit_backward){break i}r.cursor--}e:{var k=r.limit-r.cursor;u:{if(!r.eq_s_b("o")){break u}break e}r.cursor=r.limit-k;if(!r.eq_s_b("u")){break i}}r.cursor=r.limit-b;{var _=r.cursor;r.insert(r.cursor,r.cursor,"u");r.cursor=_}break r}r.cursor=r.limit-u;var v=r.limit-r.cursor;i:while(true){var d=r.limit-r.cursor;e:{if(!r.in_grouping_b(C,97,305)){break e}r.cursor=r.limit-d;break i}r.cursor=r.limit-d;if(r.cursor<=r.limit_backward){return false}r.cursor--}i:{var g=r.limit-r.cursor;e:{if(!r.eq_s_b("ö")){break e}break i}r.cursor=r.limit-g;if(!r.eq_s_b("ü")){return false}}r.cursor=r.limit-v;{var w=r.cursor;r.insert(r.cursor,r.cursor,"ü");r.cursor=w}}return true}function dr(){if(!r.eq_s_b("ad")){return false}var i=r.limit-r.cursor;r:{if(!r.eq_s_b("soy")){r.cursor=r.limit-i;break r}}if(r.cursor>r.limit_backward){return false}return true}function gr(){var i=r.cursor;{var e=2;while(true){var u=r.cursor;r:{i:while(true){e:{if(!r.in_grouping(C,97,305)){break e}break i}if(r.cursor>=r.limit){break r}r.cursor++}e--;continue}r.cursor=u;break}if(e>0){return false}}r.cursor=i;return true}function wr(){r.limit_backward=r.cursor;r.cursor=r.limit;{var i=r.limit-r.cursor;r:{if(!dr()){break r}return false}r.cursor=r.limit-i}var e=r.limit-r.cursor;vr();r.cursor=r.limit-e;var u=r.limit-r.cursor;_r();r.cursor=r.limit-u;r.cursor=r.limit_backward;return true}this.stem=function(){if(!gr()){return false}r.limit_backward=r.cursor;r.cursor=r.limit;var i=r.limit-r.cursor;br();r.cursor=r.limit-i;if(!D){return false}var e=r.limit-r.cursor;kr();r.cursor=r.limit-e;r.cursor=r.limit_backward;if(!wr()){return false}return true};this["stemWord"]=function(i){r.setCurrent(i);this.stem();return r.getCurrent()}};����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/nl.py��������������������������������������������������������������������0000644�0000766�0000024�00000011132�00000000000�016072� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.nl ~~~~~~~~~~~~~~~~ Dutch search language: includes the JS porter stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict import snowballstemmer from sphinx.search import SearchLanguage, parse_stop_word dutch_stopwords = parse_stop_word(''' | source: http://snowball.tartarus.org/algorithms/dutch/stop.txt de | the en | and van | of, from ik | I, the ego te | (1) chez, at etc, (2) to, (3) too dat | that, which die | that, those, who, which in | in, inside een | a, an, one hij | he het | the, it niet | not, nothing, naught zijn | (1) to be, being, (2) his, one's, its is | is was | (1) was, past tense of all persons sing. of 'zijn' (to be) (2) wax, (3) the washing, (4) rise of river op | on, upon, at, in, up, used up aan | on, upon, to (as dative) met | with, by als | like, such as, when voor | (1) before, in front of, (2) furrow had | had, past tense all persons sing. of 'hebben' (have) er | there maar | but, only om | round, about, for etc hem | him dan | then zou | should/would, past tense all persons sing. of 'zullen' of | or, whether, if wat | what, something, anything mijn | possessive and noun 'mine' men | people, 'one' dit | this zo | so, thus, in this way door | through by over | over, across ze | she, her, they, them zich | oneself bij | (1) a bee, (2) by, near, at ook | also, too tot | till, until je | you mij | me uit | out of, from der | Old Dutch form of 'van der' still found in surnames daar | (1) there, (2) because haar | (1) her, their, them, (2) hair naar | (1) unpleasant, unwell etc, (2) towards, (3) as heb | present first person sing. of 'to have' hoe | how, why heeft | present third person sing. of 'to have' hebben | 'to have' and various parts thereof deze | this u | you want | (1) for, (2) mitten, (3) rigging nog | yet, still zal | 'shall', first and third person sing. of verb 'zullen' (will) me | me zij | she, they nu | now ge | 'thou', still used in Belgium and south Netherlands geen | none omdat | because iets | something, somewhat worden | to become, grow, get toch | yet, still al | all, every, each waren | (1) 'were' (2) to wander, (3) wares, (3) veel | much, many meer | (1) more, (2) lake doen | to do, to make toen | then, when moet | noun 'spot/mote' and present form of 'to must' ben | (1) am, (2) 'are' in interrogative second person singular of 'to be' zonder | without kan | noun 'can' and present form of 'to be able' hun | their, them dus | so, consequently alles | all, everything, anything onder | under, beneath ja | yes, of course eens | once, one day hier | here wie | who werd | imperfect third person sing. of 'become' altijd | always doch | yet, but etc wordt | present third person sing. of 'become' wezen | (1) to be, (2) 'been' as in 'been fishing', (3) orphans kunnen | to be able ons | us/our zelf | self tegen | against, towards, at na | after, near reeds | already wil | (1) present tense of 'want', (2) 'will', noun, (3) fender kon | could; past tense of 'to be able' niets | nothing uw | your iemand | somebody geweest | been; past participle of 'be' andere | other ''') class SearchDutch(SearchLanguage): lang = 'nl' language_name = 'Dutch' js_stemmer_rawcode = 'dutch-stemmer.js' stopwords = dutch_stopwords def init(self, options: Dict) -> None: self.stemmer = snowballstemmer.stemmer('dutch') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/no.py��������������������������������������������������������������������0000644�0000766�0000024�00000011634�00000000000�016104� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.no ~~~~~~~~~~~~~~~~ Norwegian search language: includes the JS Norwegian stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict import snowballstemmer from sphinx.search import SearchLanguage, parse_stop_word norwegian_stopwords = parse_stop_word(''' | source: http://snowball.tartarus.org/algorithms/norwegian/stop.txt og | and i | in jeg | I det | it/this/that at | to (w. inf.) en | a/an et | a/an den | it/this/that til | to er | is/am/are som | who/that på | on de | they / you(formal) med | with han | he av | of ikke | not ikkje | not * der | there så | so var | was/were meg | me seg | you men | but ett | one har | have om | about vi | we min | my mitt | my ha | have hadde | had hun | she nå | now over | over da | when/as ved | by/know fra | from du | you ut | out sin | your dem | them oss | us opp | up man | you/one kan | can hans | his hvor | where eller | or hva | what skal | shall/must selv | self (reflective) sjøl | self (reflective) her | here alle | all vil | will bli | become ble | became blei | became * blitt | have become kunne | could inn | in når | when være | be kom | come noen | some noe | some ville | would dere | you som | who/which/that deres | their/theirs kun | only/just ja | yes etter | after ned | down skulle | should denne | this for | for/because deg | you si | hers/his sine | hers/his sitt | hers/his mot | against å | to meget | much hvorfor | why dette | this disse | these/those uten | without hvordan | how ingen | none din | your ditt | your blir | become samme | same hvilken | which hvilke | which (plural) sånn | such a inni | inside/within mellom | between vår | our hver | each hvem | who vors | us/ours hvis | whose både | both bare | only/just enn | than fordi | as/because før | before mange | many også | also slik | just vært | been være | to be båe | both * begge | both siden | since dykk | your * dykkar | yours * dei | they * deira | them * deires | theirs * deim | them * di | your (fem.) * då | as/when * eg | I * ein | a/an * eit | a/an * eitt | a/an * elles | or * honom | he * hjå | at * ho | she * hoe | she * henne | her hennar | her/hers hennes | hers hoss | how * hossen | how * ikkje | not * ingi | noone * inkje | noone * korleis | how * korso | how * kva | what/which * kvar | where * kvarhelst | where * kven | who/whom * kvi | why * kvifor | why * me | we * medan | while * mi | my * mine | my * mykje | much * no | now * nokon | some (masc./neut.) * noka | some (fem.) * nokor | some * noko | some * nokre | some * si | his/hers * sia | since * sidan | since * so | so * somt | some * somme | some * um | about* upp | up * vere | be * vore | was * verte | become * vort | become * varte | became * vart | became * ''') class SearchNorwegian(SearchLanguage): lang = 'no' language_name = 'Norwegian' js_stemmer_rawcode = 'norwegian-stemmer.js' stopwords = norwegian_stopwords def init(self, options: Dict) -> None: self.stemmer = snowballstemmer.stemmer('norwegian') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) ����������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.530982 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/���������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�020077� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/base-stemmer.js������������������������������������������0000644�0000766�0000024�00000017705�00000000000�023033� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������/**@constructor*/ BaseStemmer = function() { this.setCurrent = function(value) { this.current = value; this.cursor = 0; this.limit = this.current.length; this.limit_backward = 0; this.bra = this.cursor; this.ket = this.limit; }; this.getCurrent = function() { return this.current; }; this.copy_from = function(other) { this.current = other.current; this.cursor = other.cursor; this.limit = other.limit; this.limit_backward = other.limit_backward; this.bra = other.bra; this.ket = other.ket; }; this.in_grouping = function(s, min, max) { if (this.cursor >= this.limit) return false; var ch = this.current.charCodeAt(this.cursor); if (ch > max || ch < min) return false; ch -= min; if ((s[ch >>> 3] & (0x1 << (ch & 0x7))) == 0) return false; this.cursor++; return true; }; this.in_grouping_b = function(s, min, max) { if (this.cursor <= this.limit_backward) return false; var ch = this.current.charCodeAt(this.cursor - 1); if (ch > max || ch < min) return false; ch -= min; if ((s[ch >>> 3] & (0x1 << (ch & 0x7))) == 0) return false; this.cursor--; return true; }; this.out_grouping = function(s, min, max) { if (this.cursor >= this.limit) return false; var ch = this.current.charCodeAt(this.cursor); if (ch > max || ch < min) { this.cursor++; return true; } ch -= min; if ((s[ch >>> 3] & (0X1 << (ch & 0x7))) == 0) { this.cursor++; return true; } return false; }; this.out_grouping_b = function(s, min, max) { if (this.cursor <= this.limit_backward) return false; var ch = this.current.charCodeAt(this.cursor - 1); if (ch > max || ch < min) { this.cursor--; return true; } ch -= min; if ((s[ch >>> 3] & (0x1 << (ch & 0x7))) == 0) { this.cursor--; return true; } return false; }; this.eq_s = function(s) { if (this.limit - this.cursor < s.length) return false; if (this.current.slice(this.cursor, this.cursor + s.length) != s) { return false; } this.cursor += s.length; return true; }; this.eq_s_b = function(s) { if (this.cursor - this.limit_backward < s.length) return false; if (this.current.slice(this.cursor - s.length, this.cursor) != s) { return false; } this.cursor -= s.length; return true; }; /** @return {number} */ this.find_among = function(v) { var i = 0; var j = v.length; var c = this.cursor; var l = this.limit; var common_i = 0; var common_j = 0; var first_key_inspected = false; while (true) { var k = i + ((j - i) >>> 1); var diff = 0; var common = common_i < common_j ? common_i : common_j; // smaller // w[0]: string, w[1]: substring_i, w[2]: result, w[3]: function (optional) var w = v[k]; var i2; for (i2 = common; i2 < w[0].length; i2++) { if (c + common == l) { diff = -1; break; } diff = this.current.charCodeAt(c + common) - w[0].charCodeAt(i2); if (diff != 0) break; common++; } if (diff < 0) { j = k; common_j = common; } else { i = k; common_i = common; } if (j - i <= 1) { if (i > 0) break; // v->s has been inspected if (j == i) break; // only one item in v // - but now we need to go round once more to get // v->s inspected. This looks messy, but is actually // the optimal approach. if (first_key_inspected) break; first_key_inspected = true; } } do { var w = v[i]; if (common_i >= w[0].length) { this.cursor = c + w[0].length; if (w.length < 4) return w[2]; var res = w[3](this); this.cursor = c + w[0].length; if (res) return w[2]; } i = w[1]; } while (i >= 0); return 0; }; // find_among_b is for backwards processing. Same comments apply this.find_among_b = function(v) { var i = 0; var j = v.length var c = this.cursor; var lb = this.limit_backward; var common_i = 0; var common_j = 0; var first_key_inspected = false; while (true) { var k = i + ((j - i) >> 1); var diff = 0; var common = common_i < common_j ? common_i : common_j; var w = v[k]; var i2; for (i2 = w[0].length - 1 - common; i2 >= 0; i2--) { if (c - common == lb) { diff = -1; break; } diff = this.current.charCodeAt(c - 1 - common) - w[0].charCodeAt(i2); if (diff != 0) break; common++; } if (diff < 0) { j = k; common_j = common; } else { i = k; common_i = common; } if (j - i <= 1) { if (i > 0) break; if (j == i) break; if (first_key_inspected) break; first_key_inspected = true; } } do { var w = v[i]; if (common_i >= w[0].length) { this.cursor = c - w[0].length; if (w.length < 4) return w[2]; var res = w[3](this); this.cursor = c - w[0].length; if (res) return w[2]; } i = w[1]; } while (i >= 0); return 0; }; /* to replace chars between c_bra and c_ket in this.current by the * chars in s. */ this.replace_s = function(c_bra, c_ket, s) { var adjustment = s.length - (c_ket - c_bra); this.current = this.current.slice(0, c_bra) + s + this.current.slice(c_ket); this.limit += adjustment; if (this.cursor >= c_ket) this.cursor += adjustment; else if (this.cursor > c_bra) this.cursor = c_bra; return adjustment; }; this.slice_check = function() { if (this.bra < 0 || this.bra > this.ket || this.ket > this.limit || this.limit > this.current.length) { return false; } return true; }; this.slice_from = function(s) { var result = false; if (this.slice_check()) { this.replace_s(this.bra, this.ket, s); result = true; } return result; }; this.slice_del = function() { return this.slice_from(""); }; this.insert = function(c_bra, c_ket, s) { var adjustment = this.replace_s(c_bra, c_ket, s); if (c_bra <= this.bra) this.bra += adjustment; if (c_bra <= this.ket) this.ket += adjustment; }; this.slice_to = function() { var result = ''; if (this.slice_check()) { result = this.current.slice(this.bra, this.ket); } return result; }; this.assign_to = function() { return this.current.slice(0, this.limit); }; }; �����������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/danish-stemmer.js����������������������������������������0000644�0000766�0000024�00000017706�00000000000�023370� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ DanishStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["hed", -1, 1], ["ethed", 0, 1], ["ered", -1, 1], ["e", -1, 1], ["erede", 3, 1], ["ende", 3, 1], ["erende", 5, 1], ["ene", 3, 1], ["erne", 3, 1], ["ere", 3, 1], ["en", -1, 1], ["heden", 10, 1], ["eren", 10, 1], ["er", -1, 1], ["heder", 13, 1], ["erer", 13, 1], ["s", -1, 2], ["heds", 16, 1], ["es", 16, 1], ["endes", 18, 1], ["erendes", 19, 1], ["enes", 18, 1], ["ernes", 18, 1], ["eres", 18, 1], ["ens", 16, 1], ["hedens", 24, 1], ["erens", 24, 1], ["ers", 16, 1], ["ets", 16, 1], ["erets", 28, 1], ["et", -1, 1], ["eret", 30, 1] ]; /** @const */ var a_1 = [ ["gd", -1, -1], ["dt", -1, -1], ["gt", -1, -1], ["kt", -1, -1] ]; /** @const */ var a_2 = [ ["ig", -1, 1], ["lig", 0, 1], ["elig", 1, 1], ["els", -1, 1], ["l\u00F8st", -1, 2] ]; /** @const */ var /** Array<int> */ g_c = [119, 223, 119, 1]; /** @const */ var /** Array<int> */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 48, 0, 128]; /** @const */ var /** Array<int> */ g_s_ending = [239, 254, 42, 3, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 16]; var /** number */ I_x = 0; var /** number */ I_p1 = 0; var /** string */ S_ch = ''; /** @return {boolean} */ function r_mark_regions() { I_p1 = base.limit; var /** number */ v_1 = base.cursor; { var /** number */ c1 = base.cursor + 3; if (c1 > base.limit) { return false; } base.cursor = c1; } I_x = base.cursor; base.cursor = v_1; golab0: while(true) { var /** number */ v_2 = base.cursor; lab1: { if (!(base.in_grouping(g_v, 97, 248))) { break lab1; } base.cursor = v_2; break golab0; } base.cursor = v_2; if (base.cursor >= base.limit) { return false; } base.cursor++; } golab2: while(true) { lab3: { if (!(base.out_grouping(g_v, 97, 248))) { break lab3; } break golab2; } if (base.cursor >= base.limit) { return false; } base.cursor++; } I_p1 = base.cursor; lab4: { if (!(I_p1 < I_x)) { break lab4; } I_p1 = I_x; } return true; }; /** @return {boolean} */ function r_main_suffix() { var /** number */ among_var; if (base.cursor < I_p1) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; among_var = base.find_among_b(a_0); if (among_var == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; base.limit_backward = v_2; switch (among_var) { case 1: if (!base.slice_del()) { return false; } break; case 2: if (!(base.in_grouping_b(g_s_ending, 97, 229))) { return false; } if (!base.slice_del()) { return false; } break; } return true; }; /** @return {boolean} */ function r_consonant_pair() { var /** number */ v_1 = base.limit - base.cursor; if (base.cursor < I_p1) { return false; } var /** number */ v_3 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; if (base.find_among_b(a_1) == 0) { base.limit_backward = v_3; return false; } base.bra = base.cursor; base.limit_backward = v_3; base.cursor = base.limit - v_1; if (base.cursor <= base.limit_backward) { return false; } base.cursor--; base.bra = base.cursor; if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_other_suffix() { var /** number */ among_var; var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.eq_s_b("st"))) { break lab0; } base.bra = base.cursor; if (!(base.eq_s_b("ig"))) { break lab0; } if (!base.slice_del()) { return false; } } base.cursor = base.limit - v_1; if (base.cursor < I_p1) { return false; } var /** number */ v_3 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; among_var = base.find_among_b(a_2); if (among_var == 0) { base.limit_backward = v_3; return false; } base.bra = base.cursor; base.limit_backward = v_3; switch (among_var) { case 1: if (!base.slice_del()) { return false; } var /** number */ v_4 = base.limit - base.cursor; r_consonant_pair(); base.cursor = base.limit - v_4; break; case 2: if (!base.slice_from("l\u00F8s")) { return false; } break; } return true; }; /** @return {boolean} */ function r_undouble() { if (base.cursor < I_p1) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; if (!(base.in_grouping_b(g_c, 98, 122))) { base.limit_backward = v_2; return false; } base.bra = base.cursor; S_ch = base.slice_to(); if (S_ch == '') { return false; } base.limit_backward = v_2; if (!(base.eq_s_b(S_ch))) { return false; } if (!base.slice_del()) { return false; } return true; }; this.stem = /** @return {boolean} */ function() { var /** number */ v_1 = base.cursor; r_mark_regions(); base.cursor = v_1; base.limit_backward = base.cursor; base.cursor = base.limit; var /** number */ v_2 = base.limit - base.cursor; r_main_suffix(); base.cursor = base.limit - v_2; var /** number */ v_3 = base.limit - base.cursor; r_consonant_pair(); base.cursor = base.limit - v_3; var /** number */ v_4 = base.limit - base.cursor; r_other_suffix(); base.cursor = base.limit - v_4; var /** number */ v_5 = base.limit - base.cursor; r_undouble(); base.cursor = base.limit - v_5; base.cursor = base.limit_backward; return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; ����������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/dutch-stemmer.js�����������������������������������������0000644�0000766�0000024�00000046047�00000000000�023231� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ DutchStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["", -1, 6], ["\u00E1", 0, 1], ["\u00E4", 0, 1], ["\u00E9", 0, 2], ["\u00EB", 0, 2], ["\u00ED", 0, 3], ["\u00EF", 0, 3], ["\u00F3", 0, 4], ["\u00F6", 0, 4], ["\u00FA", 0, 5], ["\u00FC", 0, 5] ]; /** @const */ var a_1 = [ ["", -1, 3], ["I", 0, 2], ["Y", 0, 1] ]; /** @const */ var a_2 = [ ["dd", -1, -1], ["kk", -1, -1], ["tt", -1, -1] ]; /** @const */ var a_3 = [ ["ene", -1, 2], ["se", -1, 3], ["en", -1, 2], ["heden", 2, 1], ["s", -1, 3] ]; /** @const */ var a_4 = [ ["end", -1, 1], ["ig", -1, 2], ["ing", -1, 1], ["lijk", -1, 3], ["baar", -1, 4], ["bar", -1, 5] ]; /** @const */ var a_5 = [ ["aa", -1, -1], ["ee", -1, -1], ["oo", -1, -1], ["uu", -1, -1] ]; /** @const */ var /** Array<int> */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128]; /** @const */ var /** Array<int> */ g_v_I = [1, 0, 0, 17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128]; /** @const */ var /** Array<int> */ g_v_j = [17, 67, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128]; var /** number */ I_p2 = 0; var /** number */ I_p1 = 0; var /** boolean */ B_e_found = false; /** @return {boolean} */ function r_prelude() { var /** number */ among_var; var /** number */ v_1 = base.cursor; while(true) { var /** number */ v_2 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_0); if (among_var == 0) { break lab0; } base.ket = base.cursor; switch (among_var) { case 1: if (!base.slice_from("a")) { return false; } break; case 2: if (!base.slice_from("e")) { return false; } break; case 3: if (!base.slice_from("i")) { return false; } break; case 4: if (!base.slice_from("o")) { return false; } break; case 5: if (!base.slice_from("u")) { return false; } break; case 6: if (base.cursor >= base.limit) { break lab0; } base.cursor++; break; } continue; } base.cursor = v_2; break; } base.cursor = v_1; var /** number */ v_3 = base.cursor; lab1: { base.bra = base.cursor; if (!(base.eq_s("y"))) { base.cursor = v_3; break lab1; } base.ket = base.cursor; if (!base.slice_from("Y")) { return false; } } while(true) { var /** number */ v_4 = base.cursor; lab2: { golab3: while(true) { var /** number */ v_5 = base.cursor; lab4: { if (!(base.in_grouping(g_v, 97, 232))) { break lab4; } base.bra = base.cursor; lab5: { var /** number */ v_6 = base.cursor; lab6: { if (!(base.eq_s("i"))) { break lab6; } base.ket = base.cursor; if (!(base.in_grouping(g_v, 97, 232))) { break lab6; } if (!base.slice_from("I")) { return false; } break lab5; } base.cursor = v_6; if (!(base.eq_s("y"))) { break lab4; } base.ket = base.cursor; if (!base.slice_from("Y")) { return false; } } base.cursor = v_5; break golab3; } base.cursor = v_5; if (base.cursor >= base.limit) { break lab2; } base.cursor++; } continue; } base.cursor = v_4; break; } return true; }; /** @return {boolean} */ function r_mark_regions() { I_p1 = base.limit; I_p2 = base.limit; golab0: while(true) { lab1: { if (!(base.in_grouping(g_v, 97, 232))) { break lab1; } break golab0; } if (base.cursor >= base.limit) { return false; } base.cursor++; } golab2: while(true) { lab3: { if (!(base.out_grouping(g_v, 97, 232))) { break lab3; } break golab2; } if (base.cursor >= base.limit) { return false; } base.cursor++; } I_p1 = base.cursor; lab4: { if (!(I_p1 < 3)) { break lab4; } I_p1 = 3; } golab5: while(true) { lab6: { if (!(base.in_grouping(g_v, 97, 232))) { break lab6; } break golab5; } if (base.cursor >= base.limit) { return false; } base.cursor++; } golab7: while(true) { lab8: { if (!(base.out_grouping(g_v, 97, 232))) { break lab8; } break golab7; } if (base.cursor >= base.limit) { return false; } base.cursor++; } I_p2 = base.cursor; return true; }; /** @return {boolean} */ function r_postlude() { var /** number */ among_var; while(true) { var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_1); if (among_var == 0) { break lab0; } base.ket = base.cursor; switch (among_var) { case 1: if (!base.slice_from("y")) { return false; } break; case 2: if (!base.slice_from("i")) { return false; } break; case 3: if (base.cursor >= base.limit) { break lab0; } base.cursor++; break; } continue; } base.cursor = v_1; break; } return true; }; /** @return {boolean} */ function r_R1() { if (!(I_p1 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_R2() { if (!(I_p2 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_undouble() { var /** number */ v_1 = base.limit - base.cursor; if (base.find_among_b(a_2) == 0) { return false; } base.cursor = base.limit - v_1; base.ket = base.cursor; if (base.cursor <= base.limit_backward) { return false; } base.cursor--; base.bra = base.cursor; if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_e_ending() { B_e_found = false; base.ket = base.cursor; if (!(base.eq_s_b("e"))) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } var /** number */ v_1 = base.limit - base.cursor; if (!(base.out_grouping_b(g_v, 97, 232))) { return false; } base.cursor = base.limit - v_1; if (!base.slice_del()) { return false; } B_e_found = true; if (!r_undouble()) { return false; } return true; }; /** @return {boolean} */ function r_en_ending() { if (!r_R1()) { return false; } var /** number */ v_1 = base.limit - base.cursor; if (!(base.out_grouping_b(g_v, 97, 232))) { return false; } base.cursor = base.limit - v_1; { var /** number */ v_2 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("gem"))) { break lab0; } return false; } base.cursor = base.limit - v_2; } if (!base.slice_del()) { return false; } if (!r_undouble()) { return false; } return true; }; /** @return {boolean} */ function r_standard_suffix() { var /** number */ among_var; var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; among_var = base.find_among_b(a_3); if (among_var == 0) { break lab0; } base.bra = base.cursor; switch (among_var) { case 1: if (!r_R1()) { break lab0; } if (!base.slice_from("heid")) { return false; } break; case 2: if (!r_en_ending()) { break lab0; } break; case 3: if (!r_R1()) { break lab0; } if (!(base.out_grouping_b(g_v_j, 97, 232))) { break lab0; } if (!base.slice_del()) { return false; } break; } } base.cursor = base.limit - v_1; var /** number */ v_2 = base.limit - base.cursor; r_e_ending(); base.cursor = base.limit - v_2; var /** number */ v_3 = base.limit - base.cursor; lab1: { base.ket = base.cursor; if (!(base.eq_s_b("heid"))) { break lab1; } base.bra = base.cursor; if (!r_R2()) { break lab1; } { var /** number */ v_4 = base.limit - base.cursor; lab2: { if (!(base.eq_s_b("c"))) { break lab2; } break lab1; } base.cursor = base.limit - v_4; } if (!base.slice_del()) { return false; } base.ket = base.cursor; if (!(base.eq_s_b("en"))) { break lab1; } base.bra = base.cursor; if (!r_en_ending()) { break lab1; } } base.cursor = base.limit - v_3; var /** number */ v_5 = base.limit - base.cursor; lab3: { base.ket = base.cursor; among_var = base.find_among_b(a_4); if (among_var == 0) { break lab3; } base.bra = base.cursor; switch (among_var) { case 1: if (!r_R2()) { break lab3; } if (!base.slice_del()) { return false; } lab4: { var /** number */ v_6 = base.limit - base.cursor; lab5: { base.ket = base.cursor; if (!(base.eq_s_b("ig"))) { break lab5; } base.bra = base.cursor; if (!r_R2()) { break lab5; } { var /** number */ v_7 = base.limit - base.cursor; lab6: { if (!(base.eq_s_b("e"))) { break lab6; } break lab5; } base.cursor = base.limit - v_7; } if (!base.slice_del()) { return false; } break lab4; } base.cursor = base.limit - v_6; if (!r_undouble()) { break lab3; } } break; case 2: if (!r_R2()) { break lab3; } { var /** number */ v_8 = base.limit - base.cursor; lab7: { if (!(base.eq_s_b("e"))) { break lab7; } break lab3; } base.cursor = base.limit - v_8; } if (!base.slice_del()) { return false; } break; case 3: if (!r_R2()) { break lab3; } if (!base.slice_del()) { return false; } if (!r_e_ending()) { break lab3; } break; case 4: if (!r_R2()) { break lab3; } if (!base.slice_del()) { return false; } break; case 5: if (!r_R2()) { break lab3; } if (!B_e_found) { break lab3; } if (!base.slice_del()) { return false; } break; } } base.cursor = base.limit - v_5; var /** number */ v_9 = base.limit - base.cursor; lab8: { if (!(base.out_grouping_b(g_v_I, 73, 232))) { break lab8; } var /** number */ v_10 = base.limit - base.cursor; if (base.find_among_b(a_5) == 0) { break lab8; } if (!(base.out_grouping_b(g_v, 97, 232))) { break lab8; } base.cursor = base.limit - v_10; base.ket = base.cursor; if (base.cursor <= base.limit_backward) { break lab8; } base.cursor--; base.bra = base.cursor; if (!base.slice_del()) { return false; } } base.cursor = base.limit - v_9; return true; }; this.stem = /** @return {boolean} */ function() { var /** number */ v_1 = base.cursor; r_prelude(); base.cursor = v_1; var /** number */ v_2 = base.cursor; r_mark_regions(); base.cursor = v_2; base.limit_backward = base.cursor; base.cursor = base.limit; r_standard_suffix(); base.cursor = base.limit_backward; var /** number */ v_4 = base.cursor; r_postlude(); base.cursor = v_4; return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/finnish-stemmer.js���������������������������������������0000644�0000766�0000024�00000051446�00000000000�023557� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ FinnishStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["pa", -1, 1], ["sti", -1, 2], ["kaan", -1, 1], ["han", -1, 1], ["kin", -1, 1], ["h\u00E4n", -1, 1], ["k\u00E4\u00E4n", -1, 1], ["ko", -1, 1], ["p\u00E4", -1, 1], ["k\u00F6", -1, 1] ]; /** @const */ var a_1 = [ ["lla", -1, -1], ["na", -1, -1], ["ssa", -1, -1], ["ta", -1, -1], ["lta", 3, -1], ["sta", 3, -1] ]; /** @const */ var a_2 = [ ["ll\u00E4", -1, -1], ["n\u00E4", -1, -1], ["ss\u00E4", -1, -1], ["t\u00E4", -1, -1], ["lt\u00E4", 3, -1], ["st\u00E4", 3, -1] ]; /** @const */ var a_3 = [ ["lle", -1, -1], ["ine", -1, -1] ]; /** @const */ var a_4 = [ ["nsa", -1, 3], ["mme", -1, 3], ["nne", -1, 3], ["ni", -1, 2], ["si", -1, 1], ["an", -1, 4], ["en", -1, 6], ["\u00E4n", -1, 5], ["ns\u00E4", -1, 3] ]; /** @const */ var a_5 = [ ["aa", -1, -1], ["ee", -1, -1], ["ii", -1, -1], ["oo", -1, -1], ["uu", -1, -1], ["\u00E4\u00E4", -1, -1], ["\u00F6\u00F6", -1, -1] ]; /** @const */ var a_6 = [ ["a", -1, 8], ["lla", 0, -1], ["na", 0, -1], ["ssa", 0, -1], ["ta", 0, -1], ["lta", 4, -1], ["sta", 4, -1], ["tta", 4, 2], ["lle", -1, -1], ["ine", -1, -1], ["ksi", -1, -1], ["n", -1, 7], ["han", 11, 1], ["den", 11, -1, r_VI], ["seen", 11, -1, r_LONG], ["hen", 11, 2], ["tten", 11, -1, r_VI], ["hin", 11, 3], ["siin", 11, -1, r_VI], ["hon", 11, 4], ["h\u00E4n", 11, 5], ["h\u00F6n", 11, 6], ["\u00E4", -1, 8], ["ll\u00E4", 22, -1], ["n\u00E4", 22, -1], ["ss\u00E4", 22, -1], ["t\u00E4", 22, -1], ["lt\u00E4", 26, -1], ["st\u00E4", 26, -1], ["tt\u00E4", 26, 2] ]; /** @const */ var a_7 = [ ["eja", -1, -1], ["mma", -1, 1], ["imma", 1, -1], ["mpa", -1, 1], ["impa", 3, -1], ["mmi", -1, 1], ["immi", 5, -1], ["mpi", -1, 1], ["impi", 7, -1], ["ej\u00E4", -1, -1], ["mm\u00E4", -1, 1], ["imm\u00E4", 10, -1], ["mp\u00E4", -1, 1], ["imp\u00E4", 12, -1] ]; /** @const */ var a_8 = [ ["i", -1, -1], ["j", -1, -1] ]; /** @const */ var a_9 = [ ["mma", -1, 1], ["imma", 0, -1] ]; /** @const */ var /** Array<int> */ g_AEI = [17, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 8]; /** @const */ var /** Array<int> */ g_C = [119, 223, 119, 1]; /** @const */ var /** Array<int> */ g_V1 = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 8, 0, 32]; /** @const */ var /** Array<int> */ g_V2 = [17, 65, 16, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 8, 0, 32]; /** @const */ var /** Array<int> */ g_particle_end = [17, 97, 24, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 8, 0, 32]; var /** boolean */ B_ending_removed = false; var /** string */ S_x = ''; var /** number */ I_p2 = 0; var /** number */ I_p1 = 0; /** @return {boolean} */ function r_mark_regions() { I_p1 = base.limit; I_p2 = base.limit; golab0: while(true) { var /** number */ v_1 = base.cursor; lab1: { if (!(base.in_grouping(g_V1, 97, 246))) { break lab1; } base.cursor = v_1; break golab0; } base.cursor = v_1; if (base.cursor >= base.limit) { return false; } base.cursor++; } golab2: while(true) { lab3: { if (!(base.out_grouping(g_V1, 97, 246))) { break lab3; } break golab2; } if (base.cursor >= base.limit) { return false; } base.cursor++; } I_p1 = base.cursor; golab4: while(true) { var /** number */ v_3 = base.cursor; lab5: { if (!(base.in_grouping(g_V1, 97, 246))) { break lab5; } base.cursor = v_3; break golab4; } base.cursor = v_3; if (base.cursor >= base.limit) { return false; } base.cursor++; } golab6: while(true) { lab7: { if (!(base.out_grouping(g_V1, 97, 246))) { break lab7; } break golab6; } if (base.cursor >= base.limit) { return false; } base.cursor++; } I_p2 = base.cursor; return true; }; /** @return {boolean} */ function r_R2() { if (!(I_p2 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_particle_etc() { var /** number */ among_var; if (base.cursor < I_p1) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; among_var = base.find_among_b(a_0); if (among_var == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; base.limit_backward = v_2; switch (among_var) { case 1: if (!(base.in_grouping_b(g_particle_end, 97, 246))) { return false; } break; case 2: if (!r_R2()) { return false; } break; } if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_possessive() { var /** number */ among_var; if (base.cursor < I_p1) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; among_var = base.find_among_b(a_4); if (among_var == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; base.limit_backward = v_2; switch (among_var) { case 1: { var /** number */ v_3 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("k"))) { break lab0; } return false; } base.cursor = base.limit - v_3; } if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_del()) { return false; } base.ket = base.cursor; if (!(base.eq_s_b("kse"))) { return false; } base.bra = base.cursor; if (!base.slice_from("ksi")) { return false; } break; case 3: if (!base.slice_del()) { return false; } break; case 4: if (base.find_among_b(a_1) == 0) { return false; } if (!base.slice_del()) { return false; } break; case 5: if (base.find_among_b(a_2) == 0) { return false; } if (!base.slice_del()) { return false; } break; case 6: if (base.find_among_b(a_3) == 0) { return false; } if (!base.slice_del()) { return false; } break; } return true; }; /** @return {boolean} */ function r_LONG() { if (base.find_among_b(a_5) == 0) { return false; } return true; }; /** @return {boolean} */ function r_VI() { if (!(base.eq_s_b("i"))) { return false; } if (!(base.in_grouping_b(g_V2, 97, 246))) { return false; } return true; }; /** @return {boolean} */ function r_case_ending() { var /** number */ among_var; if (base.cursor < I_p1) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; among_var = base.find_among_b(a_6); if (among_var == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; base.limit_backward = v_2; switch (among_var) { case 1: if (!(base.eq_s_b("a"))) { return false; } break; case 2: if (!(base.eq_s_b("e"))) { return false; } break; case 3: if (!(base.eq_s_b("i"))) { return false; } break; case 4: if (!(base.eq_s_b("o"))) { return false; } break; case 5: if (!(base.eq_s_b("\u00E4"))) { return false; } break; case 6: if (!(base.eq_s_b("\u00F6"))) { return false; } break; case 7: var /** number */ v_3 = base.limit - base.cursor; lab0: { var /** number */ v_4 = base.limit - base.cursor; lab1: { var /** number */ v_5 = base.limit - base.cursor; lab2: { if (!r_LONG()) { break lab2; } break lab1; } base.cursor = base.limit - v_5; if (!(base.eq_s_b("ie"))) { base.cursor = base.limit - v_3; break lab0; } } base.cursor = base.limit - v_4; if (base.cursor <= base.limit_backward) { base.cursor = base.limit - v_3; break lab0; } base.cursor--; base.bra = base.cursor; } break; case 8: if (!(base.in_grouping_b(g_V1, 97, 246))) { return false; } if (!(base.in_grouping_b(g_C, 98, 122))) { return false; } break; } if (!base.slice_del()) { return false; } B_ending_removed = true; return true; }; /** @return {boolean} */ function r_other_endings() { var /** number */ among_var; if (base.cursor < I_p2) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p2; base.ket = base.cursor; among_var = base.find_among_b(a_7); if (among_var == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; base.limit_backward = v_2; switch (among_var) { case 1: { var /** number */ v_3 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("po"))) { break lab0; } return false; } base.cursor = base.limit - v_3; } break; } if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_i_plural() { if (base.cursor < I_p1) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; if (base.find_among_b(a_8) == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; base.limit_backward = v_2; if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_t_plural() { var /** number */ among_var; if (base.cursor < I_p1) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; if (!(base.eq_s_b("t"))) { base.limit_backward = v_2; return false; } base.bra = base.cursor; var /** number */ v_3 = base.limit - base.cursor; if (!(base.in_grouping_b(g_V1, 97, 246))) { base.limit_backward = v_2; return false; } base.cursor = base.limit - v_3; if (!base.slice_del()) { return false; } base.limit_backward = v_2; if (base.cursor < I_p2) { return false; } var /** number */ v_5 = base.limit_backward; base.limit_backward = I_p2; base.ket = base.cursor; among_var = base.find_among_b(a_9); if (among_var == 0) { base.limit_backward = v_5; return false; } base.bra = base.cursor; base.limit_backward = v_5; switch (among_var) { case 1: { var /** number */ v_6 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("po"))) { break lab0; } return false; } base.cursor = base.limit - v_6; } break; } if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_tidy() { if (base.cursor < I_p1) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; var /** number */ v_3 = base.limit - base.cursor; lab0: { var /** number */ v_4 = base.limit - base.cursor; if (!r_LONG()) { break lab0; } base.cursor = base.limit - v_4; base.ket = base.cursor; if (base.cursor <= base.limit_backward) { break lab0; } base.cursor--; base.bra = base.cursor; if (!base.slice_del()) { return false; } } base.cursor = base.limit - v_3; var /** number */ v_5 = base.limit - base.cursor; lab1: { base.ket = base.cursor; if (!(base.in_grouping_b(g_AEI, 97, 228))) { break lab1; } base.bra = base.cursor; if (!(base.in_grouping_b(g_C, 98, 122))) { break lab1; } if (!base.slice_del()) { return false; } } base.cursor = base.limit - v_5; var /** number */ v_6 = base.limit - base.cursor; lab2: { base.ket = base.cursor; if (!(base.eq_s_b("j"))) { break lab2; } base.bra = base.cursor; lab3: { var /** number */ v_7 = base.limit - base.cursor; lab4: { if (!(base.eq_s_b("o"))) { break lab4; } break lab3; } base.cursor = base.limit - v_7; if (!(base.eq_s_b("u"))) { break lab2; } } if (!base.slice_del()) { return false; } } base.cursor = base.limit - v_6; var /** number */ v_8 = base.limit - base.cursor; lab5: { base.ket = base.cursor; if (!(base.eq_s_b("o"))) { break lab5; } base.bra = base.cursor; if (!(base.eq_s_b("j"))) { break lab5; } if (!base.slice_del()) { return false; } } base.cursor = base.limit - v_8; base.limit_backward = v_2; golab6: while(true) { var /** number */ v_9 = base.limit - base.cursor; lab7: { if (!(base.out_grouping_b(g_V1, 97, 246))) { break lab7; } base.cursor = base.limit - v_9; break golab6; } base.cursor = base.limit - v_9; if (base.cursor <= base.limit_backward) { return false; } base.cursor--; } base.ket = base.cursor; if (!(base.in_grouping_b(g_C, 98, 122))) { return false; } base.bra = base.cursor; S_x = base.slice_to(); if (S_x == '') { return false; } if (!(base.eq_s_b(S_x))) { return false; } if (!base.slice_del()) { return false; } return true; }; this.stem = /** @return {boolean} */ function() { var /** number */ v_1 = base.cursor; r_mark_regions(); base.cursor = v_1; B_ending_removed = false; base.limit_backward = base.cursor; base.cursor = base.limit; var /** number */ v_2 = base.limit - base.cursor; r_particle_etc(); base.cursor = base.limit - v_2; var /** number */ v_3 = base.limit - base.cursor; r_possessive(); base.cursor = base.limit - v_3; var /** number */ v_4 = base.limit - base.cursor; r_case_ending(); base.cursor = base.limit - v_4; var /** number */ v_5 = base.limit - base.cursor; r_other_endings(); base.cursor = base.limit - v_5; lab0: { lab1: { if (!B_ending_removed) { break lab1; } var /** number */ v_7 = base.limit - base.cursor; r_i_plural(); base.cursor = base.limit - v_7; break lab0; } var /** number */ v_8 = base.limit - base.cursor; r_t_plural(); base.cursor = base.limit - v_8; } var /** number */ v_9 = base.limit - base.cursor; r_tidy(); base.cursor = base.limit - v_9; base.cursor = base.limit_backward; return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/french-stemmer.js����������������������������������������0000644�0000766�0000024�00000122140�00000000000�023354� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ FrenchStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["col", -1, -1], ["par", -1, -1], ["tap", -1, -1] ]; /** @const */ var a_1 = [ ["", -1, 7], ["H", 0, 6], ["He", 1, 4], ["Hi", 1, 5], ["I", 0, 1], ["U", 0, 2], ["Y", 0, 3] ]; /** @const */ var a_2 = [ ["iqU", -1, 3], ["abl", -1, 3], ["I\u00E8r", -1, 4], ["i\u00E8r", -1, 4], ["eus", -1, 2], ["iv", -1, 1] ]; /** @const */ var a_3 = [ ["ic", -1, 2], ["abil", -1, 1], ["iv", -1, 3] ]; /** @const */ var a_4 = [ ["iqUe", -1, 1], ["atrice", -1, 2], ["ance", -1, 1], ["ence", -1, 5], ["logie", -1, 3], ["able", -1, 1], ["isme", -1, 1], ["euse", -1, 11], ["iste", -1, 1], ["ive", -1, 8], ["if", -1, 8], ["usion", -1, 4], ["ation", -1, 2], ["ution", -1, 4], ["ateur", -1, 2], ["iqUes", -1, 1], ["atrices", -1, 2], ["ances", -1, 1], ["ences", -1, 5], ["logies", -1, 3], ["ables", -1, 1], ["ismes", -1, 1], ["euses", -1, 11], ["istes", -1, 1], ["ives", -1, 8], ["ifs", -1, 8], ["usions", -1, 4], ["ations", -1, 2], ["utions", -1, 4], ["ateurs", -1, 2], ["ments", -1, 15], ["ements", 30, 6], ["issements", 31, 12], ["it\u00E9s", -1, 7], ["ment", -1, 15], ["ement", 34, 6], ["issement", 35, 12], ["amment", 34, 13], ["emment", 34, 14], ["aux", -1, 10], ["eaux", 39, 9], ["eux", -1, 1], ["it\u00E9", -1, 7] ]; /** @const */ var a_5 = [ ["ira", -1, 1], ["ie", -1, 1], ["isse", -1, 1], ["issante", -1, 1], ["i", -1, 1], ["irai", 4, 1], ["ir", -1, 1], ["iras", -1, 1], ["ies", -1, 1], ["\u00EEmes", -1, 1], ["isses", -1, 1], ["issantes", -1, 1], ["\u00EEtes", -1, 1], ["is", -1, 1], ["irais", 13, 1], ["issais", 13, 1], ["irions", -1, 1], ["issions", -1, 1], ["irons", -1, 1], ["issons", -1, 1], ["issants", -1, 1], ["it", -1, 1], ["irait", 21, 1], ["issait", 21, 1], ["issant", -1, 1], ["iraIent", -1, 1], ["issaIent", -1, 1], ["irent", -1, 1], ["issent", -1, 1], ["iront", -1, 1], ["\u00EEt", -1, 1], ["iriez", -1, 1], ["issiez", -1, 1], ["irez", -1, 1], ["issez", -1, 1] ]; /** @const */ var a_6 = [ ["a", -1, 3], ["era", 0, 2], ["asse", -1, 3], ["ante", -1, 3], ["\u00E9e", -1, 2], ["ai", -1, 3], ["erai", 5, 2], ["er", -1, 2], ["as", -1, 3], ["eras", 8, 2], ["\u00E2mes", -1, 3], ["asses", -1, 3], ["antes", -1, 3], ["\u00E2tes", -1, 3], ["\u00E9es", -1, 2], ["ais", -1, 3], ["erais", 15, 2], ["ions", -1, 1], ["erions", 17, 2], ["assions", 17, 3], ["erons", -1, 2], ["ants", -1, 3], ["\u00E9s", -1, 2], ["ait", -1, 3], ["erait", 23, 2], ["ant", -1, 3], ["aIent", -1, 3], ["eraIent", 26, 2], ["\u00E8rent", -1, 2], ["assent", -1, 3], ["eront", -1, 2], ["\u00E2t", -1, 3], ["ez", -1, 2], ["iez", 32, 2], ["eriez", 33, 2], ["assiez", 33, 3], ["erez", 32, 2], ["\u00E9", -1, 2] ]; /** @const */ var a_7 = [ ["e", -1, 3], ["I\u00E8re", 0, 2], ["i\u00E8re", 0, 2], ["ion", -1, 1], ["Ier", -1, 2], ["ier", -1, 2] ]; /** @const */ var a_8 = [ ["ell", -1, -1], ["eill", -1, -1], ["enn", -1, -1], ["onn", -1, -1], ["ett", -1, -1] ]; /** @const */ var /** Array<int> */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128, 130, 103, 8, 5]; /** @const */ var /** Array<int> */ g_keep_with_s = [1, 65, 20, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128]; var /** number */ I_p2 = 0; var /** number */ I_p1 = 0; var /** number */ I_pV = 0; /** @return {boolean} */ function r_prelude() { while(true) { var /** number */ v_1 = base.cursor; lab0: { golab1: while(true) { var /** number */ v_2 = base.cursor; lab2: { lab3: { var /** number */ v_3 = base.cursor; lab4: { if (!(base.in_grouping(g_v, 97, 251))) { break lab4; } base.bra = base.cursor; lab5: { var /** number */ v_4 = base.cursor; lab6: { if (!(base.eq_s("u"))) { break lab6; } base.ket = base.cursor; if (!(base.in_grouping(g_v, 97, 251))) { break lab6; } if (!base.slice_from("U")) { return false; } break lab5; } base.cursor = v_4; lab7: { if (!(base.eq_s("i"))) { break lab7; } base.ket = base.cursor; if (!(base.in_grouping(g_v, 97, 251))) { break lab7; } if (!base.slice_from("I")) { return false; } break lab5; } base.cursor = v_4; if (!(base.eq_s("y"))) { break lab4; } base.ket = base.cursor; if (!base.slice_from("Y")) { return false; } } break lab3; } base.cursor = v_3; lab8: { base.bra = base.cursor; if (!(base.eq_s("\u00EB"))) { break lab8; } base.ket = base.cursor; if (!base.slice_from("He")) { return false; } break lab3; } base.cursor = v_3; lab9: { base.bra = base.cursor; if (!(base.eq_s("\u00EF"))) { break lab9; } base.ket = base.cursor; if (!base.slice_from("Hi")) { return false; } break lab3; } base.cursor = v_3; lab10: { base.bra = base.cursor; if (!(base.eq_s("y"))) { break lab10; } base.ket = base.cursor; if (!(base.in_grouping(g_v, 97, 251))) { break lab10; } if (!base.slice_from("Y")) { return false; } break lab3; } base.cursor = v_3; if (!(base.eq_s("q"))) { break lab2; } base.bra = base.cursor; if (!(base.eq_s("u"))) { break lab2; } base.ket = base.cursor; if (!base.slice_from("U")) { return false; } } base.cursor = v_2; break golab1; } base.cursor = v_2; if (base.cursor >= base.limit) { break lab0; } base.cursor++; } continue; } base.cursor = v_1; break; } return true; }; /** @return {boolean} */ function r_mark_regions() { I_pV = base.limit; I_p1 = base.limit; I_p2 = base.limit; var /** number */ v_1 = base.cursor; lab0: { lab1: { var /** number */ v_2 = base.cursor; lab2: { if (!(base.in_grouping(g_v, 97, 251))) { break lab2; } if (!(base.in_grouping(g_v, 97, 251))) { break lab2; } if (base.cursor >= base.limit) { break lab2; } base.cursor++; break lab1; } base.cursor = v_2; lab3: { if (base.find_among(a_0) == 0) { break lab3; } break lab1; } base.cursor = v_2; if (base.cursor >= base.limit) { break lab0; } base.cursor++; golab4: while(true) { lab5: { if (!(base.in_grouping(g_v, 97, 251))) { break lab5; } break golab4; } if (base.cursor >= base.limit) { break lab0; } base.cursor++; } } I_pV = base.cursor; } base.cursor = v_1; var /** number */ v_4 = base.cursor; lab6: { golab7: while(true) { lab8: { if (!(base.in_grouping(g_v, 97, 251))) { break lab8; } break golab7; } if (base.cursor >= base.limit) { break lab6; } base.cursor++; } golab9: while(true) { lab10: { if (!(base.out_grouping(g_v, 97, 251))) { break lab10; } break golab9; } if (base.cursor >= base.limit) { break lab6; } base.cursor++; } I_p1 = base.cursor; golab11: while(true) { lab12: { if (!(base.in_grouping(g_v, 97, 251))) { break lab12; } break golab11; } if (base.cursor >= base.limit) { break lab6; } base.cursor++; } golab13: while(true) { lab14: { if (!(base.out_grouping(g_v, 97, 251))) { break lab14; } break golab13; } if (base.cursor >= base.limit) { break lab6; } base.cursor++; } I_p2 = base.cursor; } base.cursor = v_4; return true; }; /** @return {boolean} */ function r_postlude() { var /** number */ among_var; while(true) { var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_1); if (among_var == 0) { break lab0; } base.ket = base.cursor; switch (among_var) { case 1: if (!base.slice_from("i")) { return false; } break; case 2: if (!base.slice_from("u")) { return false; } break; case 3: if (!base.slice_from("y")) { return false; } break; case 4: if (!base.slice_from("\u00EB")) { return false; } break; case 5: if (!base.slice_from("\u00EF")) { return false; } break; case 6: if (!base.slice_del()) { return false; } break; case 7: if (base.cursor >= base.limit) { break lab0; } base.cursor++; break; } continue; } base.cursor = v_1; break; } return true; }; /** @return {boolean} */ function r_RV() { if (!(I_pV <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_R1() { if (!(I_p1 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_R2() { if (!(I_p2 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_standard_suffix() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_4); if (among_var == 0) { return false; } base.bra = base.cursor; switch (among_var) { case 1: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } break; case 2: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.eq_s_b("ic"))) { base.cursor = base.limit - v_1; break lab0; } base.bra = base.cursor; lab1: { var /** number */ v_2 = base.limit - base.cursor; lab2: { if (!r_R2()) { break lab2; } if (!base.slice_del()) { return false; } break lab1; } base.cursor = base.limit - v_2; if (!base.slice_from("iqU")) { return false; } } } break; case 3: if (!r_R2()) { return false; } if (!base.slice_from("log")) { return false; } break; case 4: if (!r_R2()) { return false; } if (!base.slice_from("u")) { return false; } break; case 5: if (!r_R2()) { return false; } if (!base.slice_from("ent")) { return false; } break; case 6: if (!r_RV()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_3 = base.limit - base.cursor; lab3: { base.ket = base.cursor; among_var = base.find_among_b(a_2); if (among_var == 0) { base.cursor = base.limit - v_3; break lab3; } base.bra = base.cursor; switch (among_var) { case 1: if (!r_R2()) { base.cursor = base.limit - v_3; break lab3; } if (!base.slice_del()) { return false; } base.ket = base.cursor; if (!(base.eq_s_b("at"))) { base.cursor = base.limit - v_3; break lab3; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_3; break lab3; } if (!base.slice_del()) { return false; } break; case 2: lab4: { var /** number */ v_4 = base.limit - base.cursor; lab5: { if (!r_R2()) { break lab5; } if (!base.slice_del()) { return false; } break lab4; } base.cursor = base.limit - v_4; if (!r_R1()) { base.cursor = base.limit - v_3; break lab3; } if (!base.slice_from("eux")) { return false; } } break; case 3: if (!r_R2()) { base.cursor = base.limit - v_3; break lab3; } if (!base.slice_del()) { return false; } break; case 4: if (!r_RV()) { base.cursor = base.limit - v_3; break lab3; } if (!base.slice_from("i")) { return false; } break; } } break; case 7: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_5 = base.limit - base.cursor; lab6: { base.ket = base.cursor; among_var = base.find_among_b(a_3); if (among_var == 0) { base.cursor = base.limit - v_5; break lab6; } base.bra = base.cursor; switch (among_var) { case 1: lab7: { var /** number */ v_6 = base.limit - base.cursor; lab8: { if (!r_R2()) { break lab8; } if (!base.slice_del()) { return false; } break lab7; } base.cursor = base.limit - v_6; if (!base.slice_from("abl")) { return false; } } break; case 2: lab9: { var /** number */ v_7 = base.limit - base.cursor; lab10: { if (!r_R2()) { break lab10; } if (!base.slice_del()) { return false; } break lab9; } base.cursor = base.limit - v_7; if (!base.slice_from("iqU")) { return false; } } break; case 3: if (!r_R2()) { base.cursor = base.limit - v_5; break lab6; } if (!base.slice_del()) { return false; } break; } } break; case 8: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_8 = base.limit - base.cursor; lab11: { base.ket = base.cursor; if (!(base.eq_s_b("at"))) { base.cursor = base.limit - v_8; break lab11; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_8; break lab11; } if (!base.slice_del()) { return false; } base.ket = base.cursor; if (!(base.eq_s_b("ic"))) { base.cursor = base.limit - v_8; break lab11; } base.bra = base.cursor; lab12: { var /** number */ v_9 = base.limit - base.cursor; lab13: { if (!r_R2()) { break lab13; } if (!base.slice_del()) { return false; } break lab12; } base.cursor = base.limit - v_9; if (!base.slice_from("iqU")) { return false; } } } break; case 9: if (!base.slice_from("eau")) { return false; } break; case 10: if (!r_R1()) { return false; } if (!base.slice_from("al")) { return false; } break; case 11: lab14: { var /** number */ v_10 = base.limit - base.cursor; lab15: { if (!r_R2()) { break lab15; } if (!base.slice_del()) { return false; } break lab14; } base.cursor = base.limit - v_10; if (!r_R1()) { return false; } if (!base.slice_from("eux")) { return false; } } break; case 12: if (!r_R1()) { return false; } if (!(base.out_grouping_b(g_v, 97, 251))) { return false; } if (!base.slice_del()) { return false; } break; case 13: if (!r_RV()) { return false; } if (!base.slice_from("ant")) { return false; } return false; case 14: if (!r_RV()) { return false; } if (!base.slice_from("ent")) { return false; } return false; case 15: var /** number */ v_11 = base.limit - base.cursor; if (!(base.in_grouping_b(g_v, 97, 251))) { return false; } if (!r_RV()) { return false; } base.cursor = base.limit - v_11; if (!base.slice_del()) { return false; } return false; } return true; }; /** @return {boolean} */ function r_i_verb_suffix() { if (base.cursor < I_pV) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; if (base.find_among_b(a_5) == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; { var /** number */ v_3 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("H"))) { break lab0; } base.limit_backward = v_2; return false; } base.cursor = base.limit - v_3; } if (!(base.out_grouping_b(g_v, 97, 251))) { base.limit_backward = v_2; return false; } if (!base.slice_del()) { return false; } base.limit_backward = v_2; return true; }; /** @return {boolean} */ function r_verb_suffix() { var /** number */ among_var; if (base.cursor < I_pV) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; among_var = base.find_among_b(a_6); if (among_var == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; switch (among_var) { case 1: if (!r_R2()) { base.limit_backward = v_2; return false; } if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_del()) { return false; } break; case 3: if (!base.slice_del()) { return false; } var /** number */ v_3 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.eq_s_b("e"))) { base.cursor = base.limit - v_3; break lab0; } base.bra = base.cursor; if (!base.slice_del()) { return false; } } break; } base.limit_backward = v_2; return true; }; /** @return {boolean} */ function r_residual_suffix() { var /** number */ among_var; var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.eq_s_b("s"))) { base.cursor = base.limit - v_1; break lab0; } base.bra = base.cursor; var /** number */ v_2 = base.limit - base.cursor; lab1: { var /** number */ v_3 = base.limit - base.cursor; lab2: { if (!(base.eq_s_b("Hi"))) { break lab2; } break lab1; } base.cursor = base.limit - v_3; if (!(base.out_grouping_b(g_keep_with_s, 97, 232))) { base.cursor = base.limit - v_1; break lab0; } } base.cursor = base.limit - v_2; if (!base.slice_del()) { return false; } } if (base.cursor < I_pV) { return false; } var /** number */ v_5 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; among_var = base.find_among_b(a_7); if (among_var == 0) { base.limit_backward = v_5; return false; } base.bra = base.cursor; switch (among_var) { case 1: if (!r_R2()) { base.limit_backward = v_5; return false; } lab3: { var /** number */ v_6 = base.limit - base.cursor; lab4: { if (!(base.eq_s_b("s"))) { break lab4; } break lab3; } base.cursor = base.limit - v_6; if (!(base.eq_s_b("t"))) { base.limit_backward = v_5; return false; } } if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_from("i")) { return false; } break; case 3: if (!base.slice_del()) { return false; } break; } base.limit_backward = v_5; return true; }; /** @return {boolean} */ function r_un_double() { var /** number */ v_1 = base.limit - base.cursor; if (base.find_among_b(a_8) == 0) { return false; } base.cursor = base.limit - v_1; base.ket = base.cursor; if (base.cursor <= base.limit_backward) { return false; } base.cursor--; base.bra = base.cursor; if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_un_accent() { { var v_1 = 1; while(true) { lab0: { if (!(base.out_grouping_b(g_v, 97, 251))) { break lab0; } v_1--; continue; } break; } if (v_1 > 0) { return false; } } base.ket = base.cursor; lab1: { var /** number */ v_3 = base.limit - base.cursor; lab2: { if (!(base.eq_s_b("\u00E9"))) { break lab2; } break lab1; } base.cursor = base.limit - v_3; if (!(base.eq_s_b("\u00E8"))) { return false; } } base.bra = base.cursor; if (!base.slice_from("e")) { return false; } return true; }; this.stem = /** @return {boolean} */ function() { var /** number */ v_1 = base.cursor; r_prelude(); base.cursor = v_1; r_mark_regions(); base.limit_backward = base.cursor; base.cursor = base.limit; var /** number */ v_3 = base.limit - base.cursor; lab0: { lab1: { var /** number */ v_4 = base.limit - base.cursor; lab2: { var /** number */ v_5 = base.limit - base.cursor; lab3: { var /** number */ v_6 = base.limit - base.cursor; lab4: { if (!r_standard_suffix()) { break lab4; } break lab3; } base.cursor = base.limit - v_6; lab5: { if (!r_i_verb_suffix()) { break lab5; } break lab3; } base.cursor = base.limit - v_6; if (!r_verb_suffix()) { break lab2; } } base.cursor = base.limit - v_5; var /** number */ v_7 = base.limit - base.cursor; lab6: { base.ket = base.cursor; lab7: { var /** number */ v_8 = base.limit - base.cursor; lab8: { if (!(base.eq_s_b("Y"))) { break lab8; } base.bra = base.cursor; if (!base.slice_from("i")) { return false; } break lab7; } base.cursor = base.limit - v_8; if (!(base.eq_s_b("\u00E7"))) { base.cursor = base.limit - v_7; break lab6; } base.bra = base.cursor; if (!base.slice_from("c")) { return false; } } } break lab1; } base.cursor = base.limit - v_4; if (!r_residual_suffix()) { break lab0; } } } base.cursor = base.limit - v_3; var /** number */ v_9 = base.limit - base.cursor; r_un_double(); base.cursor = base.limit - v_9; var /** number */ v_10 = base.limit - base.cursor; r_un_accent(); base.cursor = base.limit - v_10; base.cursor = base.limit_backward; var /** number */ v_11 = base.cursor; r_postlude(); base.cursor = v_11; return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/german-stemmer.js����������������������������������������0000644�0000766�0000024�00000042357�00000000000�023373� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ GermanStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["", -1, 5], ["U", 0, 2], ["Y", 0, 1], ["\u00E4", 0, 3], ["\u00F6", 0, 4], ["\u00FC", 0, 2] ]; /** @const */ var a_1 = [ ["e", -1, 2], ["em", -1, 1], ["en", -1, 2], ["ern", -1, 1], ["er", -1, 1], ["s", -1, 3], ["es", 5, 2] ]; /** @const */ var a_2 = [ ["en", -1, 1], ["er", -1, 1], ["st", -1, 2], ["est", 2, 1] ]; /** @const */ var a_3 = [ ["ig", -1, 1], ["lich", -1, 1] ]; /** @const */ var a_4 = [ ["end", -1, 1], ["ig", -1, 2], ["ung", -1, 1], ["lich", -1, 3], ["isch", -1, 2], ["ik", -1, 2], ["heit", -1, 3], ["keit", -1, 4] ]; /** @const */ var /** Array<int> */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 8, 0, 32, 8]; /** @const */ var /** Array<int> */ g_s_ending = [117, 30, 5]; /** @const */ var /** Array<int> */ g_st_ending = [117, 30, 4]; var /** number */ I_x = 0; var /** number */ I_p2 = 0; var /** number */ I_p1 = 0; /** @return {boolean} */ function r_prelude() { var /** number */ v_1 = base.cursor; while(true) { var /** number */ v_2 = base.cursor; lab0: { lab1: { var /** number */ v_3 = base.cursor; lab2: { base.bra = base.cursor; if (!(base.eq_s("\u00DF"))) { break lab2; } base.ket = base.cursor; if (!base.slice_from("ss")) { return false; } break lab1; } base.cursor = v_3; if (base.cursor >= base.limit) { break lab0; } base.cursor++; } continue; } base.cursor = v_2; break; } base.cursor = v_1; while(true) { var /** number */ v_4 = base.cursor; lab3: { golab4: while(true) { var /** number */ v_5 = base.cursor; lab5: { if (!(base.in_grouping(g_v, 97, 252))) { break lab5; } base.bra = base.cursor; lab6: { var /** number */ v_6 = base.cursor; lab7: { if (!(base.eq_s("u"))) { break lab7; } base.ket = base.cursor; if (!(base.in_grouping(g_v, 97, 252))) { break lab7; } if (!base.slice_from("U")) { return false; } break lab6; } base.cursor = v_6; if (!(base.eq_s("y"))) { break lab5; } base.ket = base.cursor; if (!(base.in_grouping(g_v, 97, 252))) { break lab5; } if (!base.slice_from("Y")) { return false; } } base.cursor = v_5; break golab4; } base.cursor = v_5; if (base.cursor >= base.limit) { break lab3; } base.cursor++; } continue; } base.cursor = v_4; break; } return true; }; /** @return {boolean} */ function r_mark_regions() { I_p1 = base.limit; I_p2 = base.limit; var /** number */ v_1 = base.cursor; { var /** number */ c1 = base.cursor + 3; if (c1 > base.limit) { return false; } base.cursor = c1; } I_x = base.cursor; base.cursor = v_1; golab0: while(true) { lab1: { if (!(base.in_grouping(g_v, 97, 252))) { break lab1; } break golab0; } if (base.cursor >= base.limit) { return false; } base.cursor++; } golab2: while(true) { lab3: { if (!(base.out_grouping(g_v, 97, 252))) { break lab3; } break golab2; } if (base.cursor >= base.limit) { return false; } base.cursor++; } I_p1 = base.cursor; lab4: { if (!(I_p1 < I_x)) { break lab4; } I_p1 = I_x; } golab5: while(true) { lab6: { if (!(base.in_grouping(g_v, 97, 252))) { break lab6; } break golab5; } if (base.cursor >= base.limit) { return false; } base.cursor++; } golab7: while(true) { lab8: { if (!(base.out_grouping(g_v, 97, 252))) { break lab8; } break golab7; } if (base.cursor >= base.limit) { return false; } base.cursor++; } I_p2 = base.cursor; return true; }; /** @return {boolean} */ function r_postlude() { var /** number */ among_var; while(true) { var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_0); if (among_var == 0) { break lab0; } base.ket = base.cursor; switch (among_var) { case 1: if (!base.slice_from("y")) { return false; } break; case 2: if (!base.slice_from("u")) { return false; } break; case 3: if (!base.slice_from("a")) { return false; } break; case 4: if (!base.slice_from("o")) { return false; } break; case 5: if (base.cursor >= base.limit) { break lab0; } base.cursor++; break; } continue; } base.cursor = v_1; break; } return true; }; /** @return {boolean} */ function r_R1() { if (!(I_p1 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_R2() { if (!(I_p2 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_standard_suffix() { var /** number */ among_var; var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; among_var = base.find_among_b(a_1); if (among_var == 0) { break lab0; } base.bra = base.cursor; if (!r_R1()) { break lab0; } switch (among_var) { case 1: if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_del()) { return false; } var /** number */ v_2 = base.limit - base.cursor; lab1: { base.ket = base.cursor; if (!(base.eq_s_b("s"))) { base.cursor = base.limit - v_2; break lab1; } base.bra = base.cursor; if (!(base.eq_s_b("nis"))) { base.cursor = base.limit - v_2; break lab1; } if (!base.slice_del()) { return false; } } break; case 3: if (!(base.in_grouping_b(g_s_ending, 98, 116))) { break lab0; } if (!base.slice_del()) { return false; } break; } } base.cursor = base.limit - v_1; var /** number */ v_3 = base.limit - base.cursor; lab2: { base.ket = base.cursor; among_var = base.find_among_b(a_2); if (among_var == 0) { break lab2; } base.bra = base.cursor; if (!r_R1()) { break lab2; } switch (among_var) { case 1: if (!base.slice_del()) { return false; } break; case 2: if (!(base.in_grouping_b(g_st_ending, 98, 116))) { break lab2; } { var /** number */ c1 = base.cursor - 3; if (c1 < base.limit_backward) { break lab2; } base.cursor = c1; } if (!base.slice_del()) { return false; } break; } } base.cursor = base.limit - v_3; var /** number */ v_4 = base.limit - base.cursor; lab3: { base.ket = base.cursor; among_var = base.find_among_b(a_4); if (among_var == 0) { break lab3; } base.bra = base.cursor; if (!r_R2()) { break lab3; } switch (among_var) { case 1: if (!base.slice_del()) { return false; } var /** number */ v_5 = base.limit - base.cursor; lab4: { base.ket = base.cursor; if (!(base.eq_s_b("ig"))) { base.cursor = base.limit - v_5; break lab4; } base.bra = base.cursor; { var /** number */ v_6 = base.limit - base.cursor; lab5: { if (!(base.eq_s_b("e"))) { break lab5; } base.cursor = base.limit - v_5; break lab4; } base.cursor = base.limit - v_6; } if (!r_R2()) { base.cursor = base.limit - v_5; break lab4; } if (!base.slice_del()) { return false; } } break; case 2: { var /** number */ v_7 = base.limit - base.cursor; lab6: { if (!(base.eq_s_b("e"))) { break lab6; } break lab3; } base.cursor = base.limit - v_7; } if (!base.slice_del()) { return false; } break; case 3: if (!base.slice_del()) { return false; } var /** number */ v_8 = base.limit - base.cursor; lab7: { base.ket = base.cursor; lab8: { var /** number */ v_9 = base.limit - base.cursor; lab9: { if (!(base.eq_s_b("er"))) { break lab9; } break lab8; } base.cursor = base.limit - v_9; if (!(base.eq_s_b("en"))) { base.cursor = base.limit - v_8; break lab7; } } base.bra = base.cursor; if (!r_R1()) { base.cursor = base.limit - v_8; break lab7; } if (!base.slice_del()) { return false; } } break; case 4: if (!base.slice_del()) { return false; } var /** number */ v_10 = base.limit - base.cursor; lab10: { base.ket = base.cursor; if (base.find_among_b(a_3) == 0) { base.cursor = base.limit - v_10; break lab10; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_10; break lab10; } if (!base.slice_del()) { return false; } } break; } } base.cursor = base.limit - v_4; return true; }; this.stem = /** @return {boolean} */ function() { var /** number */ v_1 = base.cursor; r_prelude(); base.cursor = v_1; var /** number */ v_2 = base.cursor; r_mark_regions(); base.cursor = v_2; base.limit_backward = base.cursor; base.cursor = base.limit; r_standard_suffix(); base.cursor = base.limit_backward; var /** number */ v_4 = base.cursor; r_postlude(); base.cursor = v_4; return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/hungarian-stemmer.js�������������������������������������0000644�0000766�0000024�00000042234�00000000000�024070� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ HungarianStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["cs", -1, -1], ["dzs", -1, -1], ["gy", -1, -1], ["ly", -1, -1], ["ny", -1, -1], ["sz", -1, -1], ["ty", -1, -1], ["zs", -1, -1] ]; /** @const */ var a_1 = [ ["\u00E1", -1, 1], ["\u00E9", -1, 2] ]; /** @const */ var a_2 = [ ["bb", -1, -1], ["cc", -1, -1], ["dd", -1, -1], ["ff", -1, -1], ["gg", -1, -1], ["jj", -1, -1], ["kk", -1, -1], ["ll", -1, -1], ["mm", -1, -1], ["nn", -1, -1], ["pp", -1, -1], ["rr", -1, -1], ["ccs", -1, -1], ["ss", -1, -1], ["zzs", -1, -1], ["tt", -1, -1], ["vv", -1, -1], ["ggy", -1, -1], ["lly", -1, -1], ["nny", -1, -1], ["tty", -1, -1], ["ssz", -1, -1], ["zz", -1, -1] ]; /** @const */ var a_3 = [ ["al", -1, 1], ["el", -1, 1] ]; /** @const */ var a_4 = [ ["ba", -1, -1], ["ra", -1, -1], ["be", -1, -1], ["re", -1, -1], ["ig", -1, -1], ["nak", -1, -1], ["nek", -1, -1], ["val", -1, -1], ["vel", -1, -1], ["ul", -1, -1], ["n\u00E1l", -1, -1], ["n\u00E9l", -1, -1], ["b\u00F3l", -1, -1], ["r\u00F3l", -1, -1], ["t\u00F3l", -1, -1], ["\u00FCl", -1, -1], ["b\u0151l", -1, -1], ["r\u0151l", -1, -1], ["t\u0151l", -1, -1], ["n", -1, -1], ["an", 19, -1], ["ban", 20, -1], ["en", 19, -1], ["ben", 22, -1], ["k\u00E9ppen", 22, -1], ["on", 19, -1], ["\u00F6n", 19, -1], ["k\u00E9pp", -1, -1], ["kor", -1, -1], ["t", -1, -1], ["at", 29, -1], ["et", 29, -1], ["k\u00E9nt", 29, -1], ["ank\u00E9nt", 32, -1], ["enk\u00E9nt", 32, -1], ["onk\u00E9nt", 32, -1], ["ot", 29, -1], ["\u00E9rt", 29, -1], ["\u00F6t", 29, -1], ["hez", -1, -1], ["hoz", -1, -1], ["h\u00F6z", -1, -1], ["v\u00E1", -1, -1], ["v\u00E9", -1, -1] ]; /** @const */ var a_5 = [ ["\u00E1n", -1, 2], ["\u00E9n", -1, 1], ["\u00E1nk\u00E9nt", -1, 2] ]; /** @const */ var a_6 = [ ["stul", -1, 1], ["astul", 0, 1], ["\u00E1stul", 0, 2], ["st\u00FCl", -1, 1], ["est\u00FCl", 3, 1], ["\u00E9st\u00FCl", 3, 3] ]; /** @const */ var a_7 = [ ["\u00E1", -1, 1], ["\u00E9", -1, 1] ]; /** @const */ var a_8 = [ ["k", -1, 3], ["ak", 0, 3], ["ek", 0, 3], ["ok", 0, 3], ["\u00E1k", 0, 1], ["\u00E9k", 0, 2], ["\u00F6k", 0, 3] ]; /** @const */ var a_9 = [ ["\u00E9i", -1, 1], ["\u00E1\u00E9i", 0, 3], ["\u00E9\u00E9i", 0, 2], ["\u00E9", -1, 1], ["k\u00E9", 3, 1], ["ak\u00E9", 4, 1], ["ek\u00E9", 4, 1], ["ok\u00E9", 4, 1], ["\u00E1k\u00E9", 4, 3], ["\u00E9k\u00E9", 4, 2], ["\u00F6k\u00E9", 4, 1], ["\u00E9\u00E9", 3, 2] ]; /** @const */ var a_10 = [ ["a", -1, 1], ["ja", 0, 1], ["d", -1, 1], ["ad", 2, 1], ["ed", 2, 1], ["od", 2, 1], ["\u00E1d", 2, 2], ["\u00E9d", 2, 3], ["\u00F6d", 2, 1], ["e", -1, 1], ["je", 9, 1], ["nk", -1, 1], ["unk", 11, 1], ["\u00E1nk", 11, 2], ["\u00E9nk", 11, 3], ["\u00FCnk", 11, 1], ["uk", -1, 1], ["juk", 16, 1], ["\u00E1juk", 17, 2], ["\u00FCk", -1, 1], ["j\u00FCk", 19, 1], ["\u00E9j\u00FCk", 20, 3], ["m", -1, 1], ["am", 22, 1], ["em", 22, 1], ["om", 22, 1], ["\u00E1m", 22, 2], ["\u00E9m", 22, 3], ["o", -1, 1], ["\u00E1", -1, 2], ["\u00E9", -1, 3] ]; /** @const */ var a_11 = [ ["id", -1, 1], ["aid", 0, 1], ["jaid", 1, 1], ["eid", 0, 1], ["jeid", 3, 1], ["\u00E1id", 0, 2], ["\u00E9id", 0, 3], ["i", -1, 1], ["ai", 7, 1], ["jai", 8, 1], ["ei", 7, 1], ["jei", 10, 1], ["\u00E1i", 7, 2], ["\u00E9i", 7, 3], ["itek", -1, 1], ["eitek", 14, 1], ["jeitek", 15, 1], ["\u00E9itek", 14, 3], ["ik", -1, 1], ["aik", 18, 1], ["jaik", 19, 1], ["eik", 18, 1], ["jeik", 21, 1], ["\u00E1ik", 18, 2], ["\u00E9ik", 18, 3], ["ink", -1, 1], ["aink", 25, 1], ["jaink", 26, 1], ["eink", 25, 1], ["jeink", 28, 1], ["\u00E1ink", 25, 2], ["\u00E9ink", 25, 3], ["aitok", -1, 1], ["jaitok", 32, 1], ["\u00E1itok", -1, 2], ["im", -1, 1], ["aim", 35, 1], ["jaim", 36, 1], ["eim", 35, 1], ["jeim", 38, 1], ["\u00E1im", 35, 2], ["\u00E9im", 35, 3] ]; /** @const */ var /** Array<int> */ g_v = [17, 65, 16, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 17, 36, 10, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 1]; var /** number */ I_p1 = 0; /** @return {boolean} */ function r_mark_regions() { I_p1 = base.limit; lab0: { var /** number */ v_1 = base.cursor; lab1: { if (!(base.in_grouping(g_v, 97, 369))) { break lab1; } golab2: while(true) { var /** number */ v_2 = base.cursor; lab3: { if (!(base.out_grouping(g_v, 97, 369))) { break lab3; } base.cursor = v_2; break golab2; } base.cursor = v_2; if (base.cursor >= base.limit) { break lab1; } base.cursor++; } lab4: { var /** number */ v_3 = base.cursor; lab5: { if (base.find_among(a_0) == 0) { break lab5; } break lab4; } base.cursor = v_3; if (base.cursor >= base.limit) { break lab1; } base.cursor++; } I_p1 = base.cursor; break lab0; } base.cursor = v_1; if (!(base.out_grouping(g_v, 97, 369))) { return false; } golab6: while(true) { lab7: { if (!(base.in_grouping(g_v, 97, 369))) { break lab7; } break golab6; } if (base.cursor >= base.limit) { return false; } base.cursor++; } I_p1 = base.cursor; } return true; }; /** @return {boolean} */ function r_R1() { if (!(I_p1 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_v_ending() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_1); if (among_var == 0) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } switch (among_var) { case 1: if (!base.slice_from("a")) { return false; } break; case 2: if (!base.slice_from("e")) { return false; } break; } return true; }; /** @return {boolean} */ function r_double() { var /** number */ v_1 = base.limit - base.cursor; if (base.find_among_b(a_2) == 0) { return false; } base.cursor = base.limit - v_1; return true; }; /** @return {boolean} */ function r_undouble() { if (base.cursor <= base.limit_backward) { return false; } base.cursor--; base.ket = base.cursor; { var /** number */ c1 = base.cursor - 1; if (c1 < base.limit_backward) { return false; } base.cursor = c1; } base.bra = base.cursor; if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_instrum() { base.ket = base.cursor; if (base.find_among_b(a_3) == 0) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } if (!r_double()) { return false; } if (!base.slice_del()) { return false; } if (!r_undouble()) { return false; } return true; }; /** @return {boolean} */ function r_case() { base.ket = base.cursor; if (base.find_among_b(a_4) == 0) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } if (!base.slice_del()) { return false; } if (!r_v_ending()) { return false; } return true; }; /** @return {boolean} */ function r_case_special() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_5); if (among_var == 0) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } switch (among_var) { case 1: if (!base.slice_from("e")) { return false; } break; case 2: if (!base.slice_from("a")) { return false; } break; } return true; }; /** @return {boolean} */ function r_case_other() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_6); if (among_var == 0) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } switch (among_var) { case 1: if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_from("a")) { return false; } break; case 3: if (!base.slice_from("e")) { return false; } break; } return true; }; /** @return {boolean} */ function r_factive() { base.ket = base.cursor; if (base.find_among_b(a_7) == 0) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } if (!r_double()) { return false; } if (!base.slice_del()) { return false; } if (!r_undouble()) { return false; } return true; }; /** @return {boolean} */ function r_plural() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_8); if (among_var == 0) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } switch (among_var) { case 1: if (!base.slice_from("a")) { return false; } break; case 2: if (!base.slice_from("e")) { return false; } break; case 3: if (!base.slice_del()) { return false; } break; } return true; }; /** @return {boolean} */ function r_owned() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_9); if (among_var == 0) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } switch (among_var) { case 1: if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_from("e")) { return false; } break; case 3: if (!base.slice_from("a")) { return false; } break; } return true; }; /** @return {boolean} */ function r_sing_owner() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_10); if (among_var == 0) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } switch (among_var) { case 1: if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_from("a")) { return false; } break; case 3: if (!base.slice_from("e")) { return false; } break; } return true; }; /** @return {boolean} */ function r_plur_owner() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_11); if (among_var == 0) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } switch (among_var) { case 1: if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_from("a")) { return false; } break; case 3: if (!base.slice_from("e")) { return false; } break; } return true; }; this.stem = /** @return {boolean} */ function() { var /** number */ v_1 = base.cursor; r_mark_regions(); base.cursor = v_1; base.limit_backward = base.cursor; base.cursor = base.limit; var /** number */ v_2 = base.limit - base.cursor; r_instrum(); base.cursor = base.limit - v_2; var /** number */ v_3 = base.limit - base.cursor; r_case(); base.cursor = base.limit - v_3; var /** number */ v_4 = base.limit - base.cursor; r_case_special(); base.cursor = base.limit - v_4; var /** number */ v_5 = base.limit - base.cursor; r_case_other(); base.cursor = base.limit - v_5; var /** number */ v_6 = base.limit - base.cursor; r_factive(); base.cursor = base.limit - v_6; var /** number */ v_7 = base.limit - base.cursor; r_owned(); base.cursor = base.limit - v_7; var /** number */ v_8 = base.limit - base.cursor; r_sing_owner(); base.cursor = base.limit - v_8; var /** number */ v_9 = base.limit - base.cursor; r_plur_owner(); base.cursor = base.limit - v_9; var /** number */ v_10 = base.limit - base.cursor; r_plural(); base.cursor = base.limit - v_10; base.cursor = base.limit_backward; return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/italian-stemmer.js���������������������������������������0000644�0000766�0000024�00000070611�00000000000�023535� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ ItalianStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["", -1, 7], ["qu", 0, 6], ["\u00E1", 0, 1], ["\u00E9", 0, 2], ["\u00ED", 0, 3], ["\u00F3", 0, 4], ["\u00FA", 0, 5] ]; /** @const */ var a_1 = [ ["", -1, 3], ["I", 0, 1], ["U", 0, 2] ]; /** @const */ var a_2 = [ ["la", -1, -1], ["cela", 0, -1], ["gliela", 0, -1], ["mela", 0, -1], ["tela", 0, -1], ["vela", 0, -1], ["le", -1, -1], ["cele", 6, -1], ["gliele", 6, -1], ["mele", 6, -1], ["tele", 6, -1], ["vele", 6, -1], ["ne", -1, -1], ["cene", 12, -1], ["gliene", 12, -1], ["mene", 12, -1], ["sene", 12, -1], ["tene", 12, -1], ["vene", 12, -1], ["ci", -1, -1], ["li", -1, -1], ["celi", 20, -1], ["glieli", 20, -1], ["meli", 20, -1], ["teli", 20, -1], ["veli", 20, -1], ["gli", 20, -1], ["mi", -1, -1], ["si", -1, -1], ["ti", -1, -1], ["vi", -1, -1], ["lo", -1, -1], ["celo", 31, -1], ["glielo", 31, -1], ["melo", 31, -1], ["telo", 31, -1], ["velo", 31, -1] ]; /** @const */ var a_3 = [ ["ando", -1, 1], ["endo", -1, 1], ["ar", -1, 2], ["er", -1, 2], ["ir", -1, 2] ]; /** @const */ var a_4 = [ ["ic", -1, -1], ["abil", -1, -1], ["os", -1, -1], ["iv", -1, 1] ]; /** @const */ var a_5 = [ ["ic", -1, 1], ["abil", -1, 1], ["iv", -1, 1] ]; /** @const */ var a_6 = [ ["ica", -1, 1], ["logia", -1, 3], ["osa", -1, 1], ["ista", -1, 1], ["iva", -1, 9], ["anza", -1, 1], ["enza", -1, 5], ["ice", -1, 1], ["atrice", 7, 1], ["iche", -1, 1], ["logie", -1, 3], ["abile", -1, 1], ["ibile", -1, 1], ["usione", -1, 4], ["azione", -1, 2], ["uzione", -1, 4], ["atore", -1, 2], ["ose", -1, 1], ["ante", -1, 1], ["mente", -1, 1], ["amente", 19, 7], ["iste", -1, 1], ["ive", -1, 9], ["anze", -1, 1], ["enze", -1, 5], ["ici", -1, 1], ["atrici", 25, 1], ["ichi", -1, 1], ["abili", -1, 1], ["ibili", -1, 1], ["ismi", -1, 1], ["usioni", -1, 4], ["azioni", -1, 2], ["uzioni", -1, 4], ["atori", -1, 2], ["osi", -1, 1], ["anti", -1, 1], ["amenti", -1, 6], ["imenti", -1, 6], ["isti", -1, 1], ["ivi", -1, 9], ["ico", -1, 1], ["ismo", -1, 1], ["oso", -1, 1], ["amento", -1, 6], ["imento", -1, 6], ["ivo", -1, 9], ["it\u00E0", -1, 8], ["ist\u00E0", -1, 1], ["ist\u00E8", -1, 1], ["ist\u00EC", -1, 1] ]; /** @const */ var a_7 = [ ["isca", -1, 1], ["enda", -1, 1], ["ata", -1, 1], ["ita", -1, 1], ["uta", -1, 1], ["ava", -1, 1], ["eva", -1, 1], ["iva", -1, 1], ["erebbe", -1, 1], ["irebbe", -1, 1], ["isce", -1, 1], ["ende", -1, 1], ["are", -1, 1], ["ere", -1, 1], ["ire", -1, 1], ["asse", -1, 1], ["ate", -1, 1], ["avate", 16, 1], ["evate", 16, 1], ["ivate", 16, 1], ["ete", -1, 1], ["erete", 20, 1], ["irete", 20, 1], ["ite", -1, 1], ["ereste", -1, 1], ["ireste", -1, 1], ["ute", -1, 1], ["erai", -1, 1], ["irai", -1, 1], ["isci", -1, 1], ["endi", -1, 1], ["erei", -1, 1], ["irei", -1, 1], ["assi", -1, 1], ["ati", -1, 1], ["iti", -1, 1], ["eresti", -1, 1], ["iresti", -1, 1], ["uti", -1, 1], ["avi", -1, 1], ["evi", -1, 1], ["ivi", -1, 1], ["isco", -1, 1], ["ando", -1, 1], ["endo", -1, 1], ["Yamo", -1, 1], ["iamo", -1, 1], ["avamo", -1, 1], ["evamo", -1, 1], ["ivamo", -1, 1], ["eremo", -1, 1], ["iremo", -1, 1], ["assimo", -1, 1], ["ammo", -1, 1], ["emmo", -1, 1], ["eremmo", 54, 1], ["iremmo", 54, 1], ["immo", -1, 1], ["ano", -1, 1], ["iscano", 58, 1], ["avano", 58, 1], ["evano", 58, 1], ["ivano", 58, 1], ["eranno", -1, 1], ["iranno", -1, 1], ["ono", -1, 1], ["iscono", 65, 1], ["arono", 65, 1], ["erono", 65, 1], ["irono", 65, 1], ["erebbero", -1, 1], ["irebbero", -1, 1], ["assero", -1, 1], ["essero", -1, 1], ["issero", -1, 1], ["ato", -1, 1], ["ito", -1, 1], ["uto", -1, 1], ["avo", -1, 1], ["evo", -1, 1], ["ivo", -1, 1], ["ar", -1, 1], ["ir", -1, 1], ["er\u00E0", -1, 1], ["ir\u00E0", -1, 1], ["er\u00F2", -1, 1], ["ir\u00F2", -1, 1] ]; /** @const */ var /** Array<int> */ g_v = [17, 65, 16, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128, 128, 8, 2, 1]; /** @const */ var /** Array<int> */ g_AEIO = [17, 65, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 128, 128, 8, 2]; /** @const */ var /** Array<int> */ g_CG = [17]; var /** number */ I_p2 = 0; var /** number */ I_p1 = 0; var /** number */ I_pV = 0; /** @return {boolean} */ function r_prelude() { var /** number */ among_var; var /** number */ v_1 = base.cursor; while(true) { var /** number */ v_2 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_0); if (among_var == 0) { break lab0; } base.ket = base.cursor; switch (among_var) { case 1: if (!base.slice_from("\u00E0")) { return false; } break; case 2: if (!base.slice_from("\u00E8")) { return false; } break; case 3: if (!base.slice_from("\u00EC")) { return false; } break; case 4: if (!base.slice_from("\u00F2")) { return false; } break; case 5: if (!base.slice_from("\u00F9")) { return false; } break; case 6: if (!base.slice_from("qU")) { return false; } break; case 7: if (base.cursor >= base.limit) { break lab0; } base.cursor++; break; } continue; } base.cursor = v_2; break; } base.cursor = v_1; while(true) { var /** number */ v_3 = base.cursor; lab1: { golab2: while(true) { var /** number */ v_4 = base.cursor; lab3: { if (!(base.in_grouping(g_v, 97, 249))) { break lab3; } base.bra = base.cursor; lab4: { var /** number */ v_5 = base.cursor; lab5: { if (!(base.eq_s("u"))) { break lab5; } base.ket = base.cursor; if (!(base.in_grouping(g_v, 97, 249))) { break lab5; } if (!base.slice_from("U")) { return false; } break lab4; } base.cursor = v_5; if (!(base.eq_s("i"))) { break lab3; } base.ket = base.cursor; if (!(base.in_grouping(g_v, 97, 249))) { break lab3; } if (!base.slice_from("I")) { return false; } } base.cursor = v_4; break golab2; } base.cursor = v_4; if (base.cursor >= base.limit) { break lab1; } base.cursor++; } continue; } base.cursor = v_3; break; } return true; }; /** @return {boolean} */ function r_mark_regions() { I_pV = base.limit; I_p1 = base.limit; I_p2 = base.limit; var /** number */ v_1 = base.cursor; lab0: { lab1: { var /** number */ v_2 = base.cursor; lab2: { if (!(base.in_grouping(g_v, 97, 249))) { break lab2; } lab3: { var /** number */ v_3 = base.cursor; lab4: { if (!(base.out_grouping(g_v, 97, 249))) { break lab4; } golab5: while(true) { lab6: { if (!(base.in_grouping(g_v, 97, 249))) { break lab6; } break golab5; } if (base.cursor >= base.limit) { break lab4; } base.cursor++; } break lab3; } base.cursor = v_3; if (!(base.in_grouping(g_v, 97, 249))) { break lab2; } golab7: while(true) { lab8: { if (!(base.out_grouping(g_v, 97, 249))) { break lab8; } break golab7; } if (base.cursor >= base.limit) { break lab2; } base.cursor++; } } break lab1; } base.cursor = v_2; if (!(base.out_grouping(g_v, 97, 249))) { break lab0; } lab9: { var /** number */ v_6 = base.cursor; lab10: { if (!(base.out_grouping(g_v, 97, 249))) { break lab10; } golab11: while(true) { lab12: { if (!(base.in_grouping(g_v, 97, 249))) { break lab12; } break golab11; } if (base.cursor >= base.limit) { break lab10; } base.cursor++; } break lab9; } base.cursor = v_6; if (!(base.in_grouping(g_v, 97, 249))) { break lab0; } if (base.cursor >= base.limit) { break lab0; } base.cursor++; } } I_pV = base.cursor; } base.cursor = v_1; var /** number */ v_8 = base.cursor; lab13: { golab14: while(true) { lab15: { if (!(base.in_grouping(g_v, 97, 249))) { break lab15; } break golab14; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } golab16: while(true) { lab17: { if (!(base.out_grouping(g_v, 97, 249))) { break lab17; } break golab16; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } I_p1 = base.cursor; golab18: while(true) { lab19: { if (!(base.in_grouping(g_v, 97, 249))) { break lab19; } break golab18; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } golab20: while(true) { lab21: { if (!(base.out_grouping(g_v, 97, 249))) { break lab21; } break golab20; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } I_p2 = base.cursor; } base.cursor = v_8; return true; }; /** @return {boolean} */ function r_postlude() { var /** number */ among_var; while(true) { var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_1); if (among_var == 0) { break lab0; } base.ket = base.cursor; switch (among_var) { case 1: if (!base.slice_from("i")) { return false; } break; case 2: if (!base.slice_from("u")) { return false; } break; case 3: if (base.cursor >= base.limit) { break lab0; } base.cursor++; break; } continue; } base.cursor = v_1; break; } return true; }; /** @return {boolean} */ function r_RV() { if (!(I_pV <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_R1() { if (!(I_p1 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_R2() { if (!(I_p2 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_attached_pronoun() { var /** number */ among_var; base.ket = base.cursor; if (base.find_among_b(a_2) == 0) { return false; } base.bra = base.cursor; among_var = base.find_among_b(a_3); if (among_var == 0) { return false; } if (!r_RV()) { return false; } switch (among_var) { case 1: if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_from("e")) { return false; } break; } return true; }; /** @return {boolean} */ function r_standard_suffix() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_6); if (among_var == 0) { return false; } base.bra = base.cursor; switch (among_var) { case 1: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } break; case 2: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.eq_s_b("ic"))) { base.cursor = base.limit - v_1; break lab0; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_1; break lab0; } if (!base.slice_del()) { return false; } } break; case 3: if (!r_R2()) { return false; } if (!base.slice_from("log")) { return false; } break; case 4: if (!r_R2()) { return false; } if (!base.slice_from("u")) { return false; } break; case 5: if (!r_R2()) { return false; } if (!base.slice_from("ente")) { return false; } break; case 6: if (!r_RV()) { return false; } if (!base.slice_del()) { return false; } break; case 7: if (!r_R1()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_2 = base.limit - base.cursor; lab1: { base.ket = base.cursor; among_var = base.find_among_b(a_4); if (among_var == 0) { base.cursor = base.limit - v_2; break lab1; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_2; break lab1; } if (!base.slice_del()) { return false; } switch (among_var) { case 1: base.ket = base.cursor; if (!(base.eq_s_b("at"))) { base.cursor = base.limit - v_2; break lab1; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_2; break lab1; } if (!base.slice_del()) { return false; } break; } } break; case 8: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_3 = base.limit - base.cursor; lab2: { base.ket = base.cursor; if (base.find_among_b(a_5) == 0) { base.cursor = base.limit - v_3; break lab2; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_3; break lab2; } if (!base.slice_del()) { return false; } } break; case 9: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_4 = base.limit - base.cursor; lab3: { base.ket = base.cursor; if (!(base.eq_s_b("at"))) { base.cursor = base.limit - v_4; break lab3; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_4; break lab3; } if (!base.slice_del()) { return false; } base.ket = base.cursor; if (!(base.eq_s_b("ic"))) { base.cursor = base.limit - v_4; break lab3; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_4; break lab3; } if (!base.slice_del()) { return false; } } break; } return true; }; /** @return {boolean} */ function r_verb_suffix() { if (base.cursor < I_pV) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; if (base.find_among_b(a_7) == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; if (!base.slice_del()) { return false; } base.limit_backward = v_2; return true; }; /** @return {boolean} */ function r_vowel_suffix() { var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.in_grouping_b(g_AEIO, 97, 242))) { base.cursor = base.limit - v_1; break lab0; } base.bra = base.cursor; if (!r_RV()) { base.cursor = base.limit - v_1; break lab0; } if (!base.slice_del()) { return false; } base.ket = base.cursor; if (!(base.eq_s_b("i"))) { base.cursor = base.limit - v_1; break lab0; } base.bra = base.cursor; if (!r_RV()) { base.cursor = base.limit - v_1; break lab0; } if (!base.slice_del()) { return false; } } var /** number */ v_2 = base.limit - base.cursor; lab1: { base.ket = base.cursor; if (!(base.eq_s_b("h"))) { base.cursor = base.limit - v_2; break lab1; } base.bra = base.cursor; if (!(base.in_grouping_b(g_CG, 99, 103))) { base.cursor = base.limit - v_2; break lab1; } if (!r_RV()) { base.cursor = base.limit - v_2; break lab1; } if (!base.slice_del()) { return false; } } return true; }; this.stem = /** @return {boolean} */ function() { var /** number */ v_1 = base.cursor; r_prelude(); base.cursor = v_1; r_mark_regions(); base.limit_backward = base.cursor; base.cursor = base.limit; var /** number */ v_3 = base.limit - base.cursor; r_attached_pronoun(); base.cursor = base.limit - v_3; var /** number */ v_4 = base.limit - base.cursor; lab0: { lab1: { var /** number */ v_5 = base.limit - base.cursor; lab2: { if (!r_standard_suffix()) { break lab2; } break lab1; } base.cursor = base.limit - v_5; if (!r_verb_suffix()) { break lab0; } } } base.cursor = base.limit - v_4; var /** number */ v_6 = base.limit - base.cursor; r_vowel_suffix(); base.cursor = base.limit - v_6; base.cursor = base.limit_backward; var /** number */ v_7 = base.cursor; r_postlude(); base.cursor = v_7; return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; �����������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/norwegian-stemmer.js�������������������������������������0000644�0000766�0000024�00000015326�00000000000�024107� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ NorwegianStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["a", -1, 1], ["e", -1, 1], ["ede", 1, 1], ["ande", 1, 1], ["ende", 1, 1], ["ane", 1, 1], ["ene", 1, 1], ["hetene", 6, 1], ["erte", 1, 3], ["en", -1, 1], ["heten", 9, 1], ["ar", -1, 1], ["er", -1, 1], ["heter", 12, 1], ["s", -1, 2], ["as", 14, 1], ["es", 14, 1], ["edes", 16, 1], ["endes", 16, 1], ["enes", 16, 1], ["hetenes", 19, 1], ["ens", 14, 1], ["hetens", 21, 1], ["ers", 14, 1], ["ets", 14, 1], ["et", -1, 1], ["het", 25, 1], ["ert", -1, 3], ["ast", -1, 1] ]; /** @const */ var a_1 = [ ["dt", -1, -1], ["vt", -1, -1] ]; /** @const */ var a_2 = [ ["leg", -1, 1], ["eleg", 0, 1], ["ig", -1, 1], ["eig", 2, 1], ["lig", 2, 1], ["elig", 4, 1], ["els", -1, 1], ["lov", -1, 1], ["elov", 7, 1], ["slov", 7, 1], ["hetslov", 9, 1] ]; /** @const */ var /** Array<int> */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 48, 0, 128]; /** @const */ var /** Array<int> */ g_s_ending = [119, 125, 149, 1]; var /** number */ I_x = 0; var /** number */ I_p1 = 0; /** @return {boolean} */ function r_mark_regions() { I_p1 = base.limit; var /** number */ v_1 = base.cursor; { var /** number */ c1 = base.cursor + 3; if (c1 > base.limit) { return false; } base.cursor = c1; } I_x = base.cursor; base.cursor = v_1; golab0: while(true) { var /** number */ v_2 = base.cursor; lab1: { if (!(base.in_grouping(g_v, 97, 248))) { break lab1; } base.cursor = v_2; break golab0; } base.cursor = v_2; if (base.cursor >= base.limit) { return false; } base.cursor++; } golab2: while(true) { lab3: { if (!(base.out_grouping(g_v, 97, 248))) { break lab3; } break golab2; } if (base.cursor >= base.limit) { return false; } base.cursor++; } I_p1 = base.cursor; lab4: { if (!(I_p1 < I_x)) { break lab4; } I_p1 = I_x; } return true; }; /** @return {boolean} */ function r_main_suffix() { var /** number */ among_var; if (base.cursor < I_p1) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; among_var = base.find_among_b(a_0); if (among_var == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; base.limit_backward = v_2; switch (among_var) { case 1: if (!base.slice_del()) { return false; } break; case 2: lab0: { var /** number */ v_3 = base.limit - base.cursor; lab1: { if (!(base.in_grouping_b(g_s_ending, 98, 122))) { break lab1; } break lab0; } base.cursor = base.limit - v_3; if (!(base.eq_s_b("k"))) { return false; } if (!(base.out_grouping_b(g_v, 97, 248))) { return false; } } if (!base.slice_del()) { return false; } break; case 3: if (!base.slice_from("er")) { return false; } break; } return true; }; /** @return {boolean} */ function r_consonant_pair() { var /** number */ v_1 = base.limit - base.cursor; if (base.cursor < I_p1) { return false; } var /** number */ v_3 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; if (base.find_among_b(a_1) == 0) { base.limit_backward = v_3; return false; } base.bra = base.cursor; base.limit_backward = v_3; base.cursor = base.limit - v_1; if (base.cursor <= base.limit_backward) { return false; } base.cursor--; base.bra = base.cursor; if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_other_suffix() { if (base.cursor < I_p1) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; if (base.find_among_b(a_2) == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; base.limit_backward = v_2; if (!base.slice_del()) { return false; } return true; }; this.stem = /** @return {boolean} */ function() { var /** number */ v_1 = base.cursor; r_mark_regions(); base.cursor = v_1; base.limit_backward = base.cursor; base.cursor = base.limit; var /** number */ v_2 = base.limit - base.cursor; r_main_suffix(); base.cursor = base.limit - v_2; var /** number */ v_3 = base.limit - base.cursor; r_consonant_pair(); base.cursor = base.limit - v_3; var /** number */ v_4 = base.limit - base.cursor; r_other_suffix(); base.cursor = base.limit - v_4; base.cursor = base.limit_backward; return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/porter-stemmer.js����������������������������������������0000644�0000766�0000024�00000047647�00000000000�023444� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ PorterStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["s", -1, 3], ["ies", 0, 2], ["sses", 0, 1], ["ss", 0, -1] ]; /** @const */ var a_1 = [ ["", -1, 3], ["bb", 0, 2], ["dd", 0, 2], ["ff", 0, 2], ["gg", 0, 2], ["bl", 0, 1], ["mm", 0, 2], ["nn", 0, 2], ["pp", 0, 2], ["rr", 0, 2], ["at", 0, 1], ["tt", 0, 2], ["iz", 0, 1] ]; /** @const */ var a_2 = [ ["ed", -1, 2], ["eed", 0, 1], ["ing", -1, 2] ]; /** @const */ var a_3 = [ ["anci", -1, 3], ["enci", -1, 2], ["abli", -1, 4], ["eli", -1, 6], ["alli", -1, 9], ["ousli", -1, 11], ["entli", -1, 5], ["aliti", -1, 9], ["biliti", -1, 13], ["iviti", -1, 12], ["tional", -1, 1], ["ational", 10, 8], ["alism", -1, 9], ["ation", -1, 8], ["ization", 13, 7], ["izer", -1, 7], ["ator", -1, 8], ["iveness", -1, 12], ["fulness", -1, 10], ["ousness", -1, 11] ]; /** @const */ var a_4 = [ ["icate", -1, 2], ["ative", -1, 3], ["alize", -1, 1], ["iciti", -1, 2], ["ical", -1, 2], ["ful", -1, 3], ["ness", -1, 3] ]; /** @const */ var a_5 = [ ["ic", -1, 1], ["ance", -1, 1], ["ence", -1, 1], ["able", -1, 1], ["ible", -1, 1], ["ate", -1, 1], ["ive", -1, 1], ["ize", -1, 1], ["iti", -1, 1], ["al", -1, 1], ["ism", -1, 1], ["ion", -1, 2], ["er", -1, 1], ["ous", -1, 1], ["ant", -1, 1], ["ent", -1, 1], ["ment", 15, 1], ["ement", 16, 1], ["ou", -1, 1] ]; /** @const */ var /** Array<int> */ g_v = [17, 65, 16, 1]; /** @const */ var /** Array<int> */ g_v_WXY = [1, 17, 65, 208, 1]; var /** boolean */ B_Y_found = false; var /** number */ I_p2 = 0; var /** number */ I_p1 = 0; /** @return {boolean} */ function r_shortv() { if (!(base.out_grouping_b(g_v_WXY, 89, 121))) { return false; } if (!(base.in_grouping_b(g_v, 97, 121))) { return false; } if (!(base.out_grouping_b(g_v, 97, 121))) { return false; } return true; }; /** @return {boolean} */ function r_R1() { if (!(I_p1 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_R2() { if (!(I_p2 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_Step_1a() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_0); if (among_var == 0) { return false; } base.bra = base.cursor; switch (among_var) { case 1: if (!base.slice_from("ss")) { return false; } break; case 2: if (!base.slice_from("i")) { return false; } break; case 3: if (!base.slice_del()) { return false; } break; } return true; }; /** @return {boolean} */ function r_Step_1b() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_2); if (among_var == 0) { return false; } base.bra = base.cursor; switch (among_var) { case 1: if (!r_R1()) { return false; } if (!base.slice_from("ee")) { return false; } break; case 2: var /** number */ v_1 = base.limit - base.cursor; golab0: while(true) { lab1: { if (!(base.in_grouping_b(g_v, 97, 121))) { break lab1; } break golab0; } if (base.cursor <= base.limit_backward) { return false; } base.cursor--; } base.cursor = base.limit - v_1; if (!base.slice_del()) { return false; } var /** number */ v_3 = base.limit - base.cursor; among_var = base.find_among_b(a_1); if (among_var == 0) { return false; } base.cursor = base.limit - v_3; switch (among_var) { case 1: { var /** number */ c1 = base.cursor; base.insert(base.cursor, base.cursor, "e"); base.cursor = c1; } break; case 2: base.ket = base.cursor; if (base.cursor <= base.limit_backward) { return false; } base.cursor--; base.bra = base.cursor; if (!base.slice_del()) { return false; } break; case 3: if (base.cursor != I_p1) { return false; } var /** number */ v_4 = base.limit - base.cursor; if (!r_shortv()) { return false; } base.cursor = base.limit - v_4; { var /** number */ c2 = base.cursor; base.insert(base.cursor, base.cursor, "e"); base.cursor = c2; } break; } break; } return true; }; /** @return {boolean} */ function r_Step_1c() { base.ket = base.cursor; lab0: { var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("y"))) { break lab1; } break lab0; } base.cursor = base.limit - v_1; if (!(base.eq_s_b("Y"))) { return false; } } base.bra = base.cursor; golab2: while(true) { lab3: { if (!(base.in_grouping_b(g_v, 97, 121))) { break lab3; } break golab2; } if (base.cursor <= base.limit_backward) { return false; } base.cursor--; } if (!base.slice_from("i")) { return false; } return true; }; /** @return {boolean} */ function r_Step_2() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_3); if (among_var == 0) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } switch (among_var) { case 1: if (!base.slice_from("tion")) { return false; } break; case 2: if (!base.slice_from("ence")) { return false; } break; case 3: if (!base.slice_from("ance")) { return false; } break; case 4: if (!base.slice_from("able")) { return false; } break; case 5: if (!base.slice_from("ent")) { return false; } break; case 6: if (!base.slice_from("e")) { return false; } break; case 7: if (!base.slice_from("ize")) { return false; } break; case 8: if (!base.slice_from("ate")) { return false; } break; case 9: if (!base.slice_from("al")) { return false; } break; case 10: if (!base.slice_from("ful")) { return false; } break; case 11: if (!base.slice_from("ous")) { return false; } break; case 12: if (!base.slice_from("ive")) { return false; } break; case 13: if (!base.slice_from("ble")) { return false; } break; } return true; }; /** @return {boolean} */ function r_Step_3() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_4); if (among_var == 0) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } switch (among_var) { case 1: if (!base.slice_from("al")) { return false; } break; case 2: if (!base.slice_from("ic")) { return false; } break; case 3: if (!base.slice_del()) { return false; } break; } return true; }; /** @return {boolean} */ function r_Step_4() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_5); if (among_var == 0) { return false; } base.bra = base.cursor; if (!r_R2()) { return false; } switch (among_var) { case 1: if (!base.slice_del()) { return false; } break; case 2: lab0: { var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("s"))) { break lab1; } break lab0; } base.cursor = base.limit - v_1; if (!(base.eq_s_b("t"))) { return false; } } if (!base.slice_del()) { return false; } break; } return true; }; /** @return {boolean} */ function r_Step_5a() { base.ket = base.cursor; if (!(base.eq_s_b("e"))) { return false; } base.bra = base.cursor; lab0: { var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!r_R2()) { break lab1; } break lab0; } base.cursor = base.limit - v_1; if (!r_R1()) { return false; } { var /** number */ v_2 = base.limit - base.cursor; lab2: { if (!r_shortv()) { break lab2; } return false; } base.cursor = base.limit - v_2; } } if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_Step_5b() { base.ket = base.cursor; if (!(base.eq_s_b("l"))) { return false; } base.bra = base.cursor; if (!r_R2()) { return false; } if (!(base.eq_s_b("l"))) { return false; } if (!base.slice_del()) { return false; } return true; }; this.stem = /** @return {boolean} */ function() { B_Y_found = false; var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; if (!(base.eq_s("y"))) { break lab0; } base.ket = base.cursor; if (!base.slice_from("Y")) { return false; } B_Y_found = true; } base.cursor = v_1; var /** number */ v_2 = base.cursor; lab1: { while(true) { var /** number */ v_3 = base.cursor; lab2: { golab3: while(true) { var /** number */ v_4 = base.cursor; lab4: { if (!(base.in_grouping(g_v, 97, 121))) { break lab4; } base.bra = base.cursor; if (!(base.eq_s("y"))) { break lab4; } base.ket = base.cursor; base.cursor = v_4; break golab3; } base.cursor = v_4; if (base.cursor >= base.limit) { break lab2; } base.cursor++; } if (!base.slice_from("Y")) { return false; } B_Y_found = true; continue; } base.cursor = v_3; break; } } base.cursor = v_2; I_p1 = base.limit; I_p2 = base.limit; var /** number */ v_5 = base.cursor; lab5: { golab6: while(true) { lab7: { if (!(base.in_grouping(g_v, 97, 121))) { break lab7; } break golab6; } if (base.cursor >= base.limit) { break lab5; } base.cursor++; } golab8: while(true) { lab9: { if (!(base.out_grouping(g_v, 97, 121))) { break lab9; } break golab8; } if (base.cursor >= base.limit) { break lab5; } base.cursor++; } I_p1 = base.cursor; golab10: while(true) { lab11: { if (!(base.in_grouping(g_v, 97, 121))) { break lab11; } break golab10; } if (base.cursor >= base.limit) { break lab5; } base.cursor++; } golab12: while(true) { lab13: { if (!(base.out_grouping(g_v, 97, 121))) { break lab13; } break golab12; } if (base.cursor >= base.limit) { break lab5; } base.cursor++; } I_p2 = base.cursor; } base.cursor = v_5; base.limit_backward = base.cursor; base.cursor = base.limit; var /** number */ v_10 = base.limit - base.cursor; r_Step_1a(); base.cursor = base.limit - v_10; var /** number */ v_11 = base.limit - base.cursor; r_Step_1b(); base.cursor = base.limit - v_11; var /** number */ v_12 = base.limit - base.cursor; r_Step_1c(); base.cursor = base.limit - v_12; var /** number */ v_13 = base.limit - base.cursor; r_Step_2(); base.cursor = base.limit - v_13; var /** number */ v_14 = base.limit - base.cursor; r_Step_3(); base.cursor = base.limit - v_14; var /** number */ v_15 = base.limit - base.cursor; r_Step_4(); base.cursor = base.limit - v_15; var /** number */ v_16 = base.limit - base.cursor; r_Step_5a(); base.cursor = base.limit - v_16; var /** number */ v_17 = base.limit - base.cursor; r_Step_5b(); base.cursor = base.limit - v_17; base.cursor = base.limit_backward; var /** number */ v_18 = base.cursor; lab14: { if (!B_Y_found) { break lab14; } while(true) { var /** number */ v_19 = base.cursor; lab15: { golab16: while(true) { var /** number */ v_20 = base.cursor; lab17: { base.bra = base.cursor; if (!(base.eq_s("Y"))) { break lab17; } base.ket = base.cursor; base.cursor = v_20; break golab16; } base.cursor = v_20; if (base.cursor >= base.limit) { break lab15; } base.cursor++; } if (!base.slice_from("y")) { return false; } continue; } base.cursor = v_19; break; } } base.cursor = v_18; return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; �����������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/portuguese-stemmer.js������������������������������������0000644�0000766�0000024�00000064136�00000000000�024323� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ PortugueseStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["", -1, 3], ["\u00E3", 0, 1], ["\u00F5", 0, 2] ]; /** @const */ var a_1 = [ ["", -1, 3], ["a~", 0, 1], ["o~", 0, 2] ]; /** @const */ var a_2 = [ ["ic", -1, -1], ["ad", -1, -1], ["os", -1, -1], ["iv", -1, 1] ]; /** @const */ var a_3 = [ ["ante", -1, 1], ["avel", -1, 1], ["\u00EDvel", -1, 1] ]; /** @const */ var a_4 = [ ["ic", -1, 1], ["abil", -1, 1], ["iv", -1, 1] ]; /** @const */ var a_5 = [ ["ica", -1, 1], ["\u00E2ncia", -1, 1], ["\u00EAncia", -1, 4], ["logia", -1, 2], ["ira", -1, 9], ["adora", -1, 1], ["osa", -1, 1], ["ista", -1, 1], ["iva", -1, 8], ["eza", -1, 1], ["idade", -1, 7], ["ante", -1, 1], ["mente", -1, 6], ["amente", 12, 5], ["\u00E1vel", -1, 1], ["\u00EDvel", -1, 1], ["ico", -1, 1], ["ismo", -1, 1], ["oso", -1, 1], ["amento", -1, 1], ["imento", -1, 1], ["ivo", -1, 8], ["a\u00E7a~o", -1, 1], ["u\u00E7a~o", -1, 3], ["ador", -1, 1], ["icas", -1, 1], ["\u00EAncias", -1, 4], ["logias", -1, 2], ["iras", -1, 9], ["adoras", -1, 1], ["osas", -1, 1], ["istas", -1, 1], ["ivas", -1, 8], ["ezas", -1, 1], ["idades", -1, 7], ["adores", -1, 1], ["antes", -1, 1], ["a\u00E7o~es", -1, 1], ["u\u00E7o~es", -1, 3], ["icos", -1, 1], ["ismos", -1, 1], ["osos", -1, 1], ["amentos", -1, 1], ["imentos", -1, 1], ["ivos", -1, 8] ]; /** @const */ var a_6 = [ ["ada", -1, 1], ["ida", -1, 1], ["ia", -1, 1], ["aria", 2, 1], ["eria", 2, 1], ["iria", 2, 1], ["ara", -1, 1], ["era", -1, 1], ["ira", -1, 1], ["ava", -1, 1], ["asse", -1, 1], ["esse", -1, 1], ["isse", -1, 1], ["aste", -1, 1], ["este", -1, 1], ["iste", -1, 1], ["ei", -1, 1], ["arei", 16, 1], ["erei", 16, 1], ["irei", 16, 1], ["am", -1, 1], ["iam", 20, 1], ["ariam", 21, 1], ["eriam", 21, 1], ["iriam", 21, 1], ["aram", 20, 1], ["eram", 20, 1], ["iram", 20, 1], ["avam", 20, 1], ["em", -1, 1], ["arem", 29, 1], ["erem", 29, 1], ["irem", 29, 1], ["assem", 29, 1], ["essem", 29, 1], ["issem", 29, 1], ["ado", -1, 1], ["ido", -1, 1], ["ando", -1, 1], ["endo", -1, 1], ["indo", -1, 1], ["ara~o", -1, 1], ["era~o", -1, 1], ["ira~o", -1, 1], ["ar", -1, 1], ["er", -1, 1], ["ir", -1, 1], ["as", -1, 1], ["adas", 47, 1], ["idas", 47, 1], ["ias", 47, 1], ["arias", 50, 1], ["erias", 50, 1], ["irias", 50, 1], ["aras", 47, 1], ["eras", 47, 1], ["iras", 47, 1], ["avas", 47, 1], ["es", -1, 1], ["ardes", 58, 1], ["erdes", 58, 1], ["irdes", 58, 1], ["ares", 58, 1], ["eres", 58, 1], ["ires", 58, 1], ["asses", 58, 1], ["esses", 58, 1], ["isses", 58, 1], ["astes", 58, 1], ["estes", 58, 1], ["istes", 58, 1], ["is", -1, 1], ["ais", 71, 1], ["eis", 71, 1], ["areis", 73, 1], ["ereis", 73, 1], ["ireis", 73, 1], ["\u00E1reis", 73, 1], ["\u00E9reis", 73, 1], ["\u00EDreis", 73, 1], ["\u00E1sseis", 73, 1], ["\u00E9sseis", 73, 1], ["\u00EDsseis", 73, 1], ["\u00E1veis", 73, 1], ["\u00EDeis", 73, 1], ["ar\u00EDeis", 84, 1], ["er\u00EDeis", 84, 1], ["ir\u00EDeis", 84, 1], ["ados", -1, 1], ["idos", -1, 1], ["amos", -1, 1], ["\u00E1ramos", 90, 1], ["\u00E9ramos", 90, 1], ["\u00EDramos", 90, 1], ["\u00E1vamos", 90, 1], ["\u00EDamos", 90, 1], ["ar\u00EDamos", 95, 1], ["er\u00EDamos", 95, 1], ["ir\u00EDamos", 95, 1], ["emos", -1, 1], ["aremos", 99, 1], ["eremos", 99, 1], ["iremos", 99, 1], ["\u00E1ssemos", 99, 1], ["\u00EAssemos", 99, 1], ["\u00EDssemos", 99, 1], ["imos", -1, 1], ["armos", -1, 1], ["ermos", -1, 1], ["irmos", -1, 1], ["\u00E1mos", -1, 1], ["ar\u00E1s", -1, 1], ["er\u00E1s", -1, 1], ["ir\u00E1s", -1, 1], ["eu", -1, 1], ["iu", -1, 1], ["ou", -1, 1], ["ar\u00E1", -1, 1], ["er\u00E1", -1, 1], ["ir\u00E1", -1, 1] ]; /** @const */ var a_7 = [ ["a", -1, 1], ["i", -1, 1], ["o", -1, 1], ["os", -1, 1], ["\u00E1", -1, 1], ["\u00ED", -1, 1], ["\u00F3", -1, 1] ]; /** @const */ var a_8 = [ ["e", -1, 1], ["\u00E7", -1, 2], ["\u00E9", -1, 1], ["\u00EA", -1, 1] ]; /** @const */ var /** Array<int> */ g_v = [17, 65, 16, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 3, 19, 12, 2]; var /** number */ I_p2 = 0; var /** number */ I_p1 = 0; var /** number */ I_pV = 0; /** @return {boolean} */ function r_prelude() { var /** number */ among_var; while(true) { var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_0); if (among_var == 0) { break lab0; } base.ket = base.cursor; switch (among_var) { case 1: if (!base.slice_from("a~")) { return false; } break; case 2: if (!base.slice_from("o~")) { return false; } break; case 3: if (base.cursor >= base.limit) { break lab0; } base.cursor++; break; } continue; } base.cursor = v_1; break; } return true; }; /** @return {boolean} */ function r_mark_regions() { I_pV = base.limit; I_p1 = base.limit; I_p2 = base.limit; var /** number */ v_1 = base.cursor; lab0: { lab1: { var /** number */ v_2 = base.cursor; lab2: { if (!(base.in_grouping(g_v, 97, 250))) { break lab2; } lab3: { var /** number */ v_3 = base.cursor; lab4: { if (!(base.out_grouping(g_v, 97, 250))) { break lab4; } golab5: while(true) { lab6: { if (!(base.in_grouping(g_v, 97, 250))) { break lab6; } break golab5; } if (base.cursor >= base.limit) { break lab4; } base.cursor++; } break lab3; } base.cursor = v_3; if (!(base.in_grouping(g_v, 97, 250))) { break lab2; } golab7: while(true) { lab8: { if (!(base.out_grouping(g_v, 97, 250))) { break lab8; } break golab7; } if (base.cursor >= base.limit) { break lab2; } base.cursor++; } } break lab1; } base.cursor = v_2; if (!(base.out_grouping(g_v, 97, 250))) { break lab0; } lab9: { var /** number */ v_6 = base.cursor; lab10: { if (!(base.out_grouping(g_v, 97, 250))) { break lab10; } golab11: while(true) { lab12: { if (!(base.in_grouping(g_v, 97, 250))) { break lab12; } break golab11; } if (base.cursor >= base.limit) { break lab10; } base.cursor++; } break lab9; } base.cursor = v_6; if (!(base.in_grouping(g_v, 97, 250))) { break lab0; } if (base.cursor >= base.limit) { break lab0; } base.cursor++; } } I_pV = base.cursor; } base.cursor = v_1; var /** number */ v_8 = base.cursor; lab13: { golab14: while(true) { lab15: { if (!(base.in_grouping(g_v, 97, 250))) { break lab15; } break golab14; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } golab16: while(true) { lab17: { if (!(base.out_grouping(g_v, 97, 250))) { break lab17; } break golab16; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } I_p1 = base.cursor; golab18: while(true) { lab19: { if (!(base.in_grouping(g_v, 97, 250))) { break lab19; } break golab18; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } golab20: while(true) { lab21: { if (!(base.out_grouping(g_v, 97, 250))) { break lab21; } break golab20; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } I_p2 = base.cursor; } base.cursor = v_8; return true; }; /** @return {boolean} */ function r_postlude() { var /** number */ among_var; while(true) { var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_1); if (among_var == 0) { break lab0; } base.ket = base.cursor; switch (among_var) { case 1: if (!base.slice_from("\u00E3")) { return false; } break; case 2: if (!base.slice_from("\u00F5")) { return false; } break; case 3: if (base.cursor >= base.limit) { break lab0; } base.cursor++; break; } continue; } base.cursor = v_1; break; } return true; }; /** @return {boolean} */ function r_RV() { if (!(I_pV <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_R1() { if (!(I_p1 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_R2() { if (!(I_p2 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_standard_suffix() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_5); if (among_var == 0) { return false; } base.bra = base.cursor; switch (among_var) { case 1: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } break; case 2: if (!r_R2()) { return false; } if (!base.slice_from("log")) { return false; } break; case 3: if (!r_R2()) { return false; } if (!base.slice_from("u")) { return false; } break; case 4: if (!r_R2()) { return false; } if (!base.slice_from("ente")) { return false; } break; case 5: if (!r_R1()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; among_var = base.find_among_b(a_2); if (among_var == 0) { base.cursor = base.limit - v_1; break lab0; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_1; break lab0; } if (!base.slice_del()) { return false; } switch (among_var) { case 1: base.ket = base.cursor; if (!(base.eq_s_b("at"))) { base.cursor = base.limit - v_1; break lab0; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_1; break lab0; } if (!base.slice_del()) { return false; } break; } } break; case 6: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_2 = base.limit - base.cursor; lab1: { base.ket = base.cursor; if (base.find_among_b(a_3) == 0) { base.cursor = base.limit - v_2; break lab1; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_2; break lab1; } if (!base.slice_del()) { return false; } } break; case 7: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_3 = base.limit - base.cursor; lab2: { base.ket = base.cursor; if (base.find_among_b(a_4) == 0) { base.cursor = base.limit - v_3; break lab2; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_3; break lab2; } if (!base.slice_del()) { return false; } } break; case 8: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_4 = base.limit - base.cursor; lab3: { base.ket = base.cursor; if (!(base.eq_s_b("at"))) { base.cursor = base.limit - v_4; break lab3; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_4; break lab3; } if (!base.slice_del()) { return false; } } break; case 9: if (!r_RV()) { return false; } if (!(base.eq_s_b("e"))) { return false; } if (!base.slice_from("ir")) { return false; } break; } return true; }; /** @return {boolean} */ function r_verb_suffix() { if (base.cursor < I_pV) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; if (base.find_among_b(a_6) == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; if (!base.slice_del()) { return false; } base.limit_backward = v_2; return true; }; /** @return {boolean} */ function r_residual_suffix() { base.ket = base.cursor; if (base.find_among_b(a_7) == 0) { return false; } base.bra = base.cursor; if (!r_RV()) { return false; } if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_residual_form() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_8); if (among_var == 0) { return false; } base.bra = base.cursor; switch (among_var) { case 1: if (!r_RV()) { return false; } if (!base.slice_del()) { return false; } base.ket = base.cursor; lab0: { var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("u"))) { break lab1; } base.bra = base.cursor; var /** number */ v_2 = base.limit - base.cursor; if (!(base.eq_s_b("g"))) { break lab1; } base.cursor = base.limit - v_2; break lab0; } base.cursor = base.limit - v_1; if (!(base.eq_s_b("i"))) { return false; } base.bra = base.cursor; var /** number */ v_3 = base.limit - base.cursor; if (!(base.eq_s_b("c"))) { return false; } base.cursor = base.limit - v_3; } if (!r_RV()) { return false; } if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_from("c")) { return false; } break; } return true; }; this.stem = /** @return {boolean} */ function() { var /** number */ v_1 = base.cursor; r_prelude(); base.cursor = v_1; r_mark_regions(); base.limit_backward = base.cursor; base.cursor = base.limit; var /** number */ v_3 = base.limit - base.cursor; lab0: { lab1: { var /** number */ v_4 = base.limit - base.cursor; lab2: { var /** number */ v_5 = base.limit - base.cursor; lab3: { var /** number */ v_6 = base.limit - base.cursor; lab4: { if (!r_standard_suffix()) { break lab4; } break lab3; } base.cursor = base.limit - v_6; if (!r_verb_suffix()) { break lab2; } } base.cursor = base.limit - v_5; var /** number */ v_7 = base.limit - base.cursor; lab5: { base.ket = base.cursor; if (!(base.eq_s_b("i"))) { break lab5; } base.bra = base.cursor; var /** number */ v_8 = base.limit - base.cursor; if (!(base.eq_s_b("c"))) { break lab5; } base.cursor = base.limit - v_8; if (!r_RV()) { break lab5; } if (!base.slice_del()) { return false; } } base.cursor = base.limit - v_7; break lab1; } base.cursor = base.limit - v_4; if (!r_residual_suffix()) { break lab0; } } } base.cursor = base.limit - v_3; var /** number */ v_9 = base.limit - base.cursor; r_residual_form(); base.cursor = base.limit - v_9; base.cursor = base.limit_backward; var /** number */ v_10 = base.cursor; r_postlude(); base.cursor = v_10; return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/romanian-stemmer.js��������������������������������������0000644�0000766�0000024�00000060656�00000000000�023730� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ RomanianStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["", -1, 3], ["I", 0, 1], ["U", 0, 2] ]; /** @const */ var a_1 = [ ["ea", -1, 3], ["a\u0163ia", -1, 7], ["aua", -1, 2], ["iua", -1, 4], ["a\u0163ie", -1, 7], ["ele", -1, 3], ["ile", -1, 5], ["iile", 6, 4], ["iei", -1, 4], ["atei", -1, 6], ["ii", -1, 4], ["ului", -1, 1], ["ul", -1, 1], ["elor", -1, 3], ["ilor", -1, 4], ["iilor", 14, 4] ]; /** @const */ var a_2 = [ ["icala", -1, 4], ["iciva", -1, 4], ["ativa", -1, 5], ["itiva", -1, 6], ["icale", -1, 4], ["a\u0163iune", -1, 5], ["i\u0163iune", -1, 6], ["atoare", -1, 5], ["itoare", -1, 6], ["\u0103toare", -1, 5], ["icitate", -1, 4], ["abilitate", -1, 1], ["ibilitate", -1, 2], ["ivitate", -1, 3], ["icive", -1, 4], ["ative", -1, 5], ["itive", -1, 6], ["icali", -1, 4], ["atori", -1, 5], ["icatori", 18, 4], ["itori", -1, 6], ["\u0103tori", -1, 5], ["icitati", -1, 4], ["abilitati", -1, 1], ["ivitati", -1, 3], ["icivi", -1, 4], ["ativi", -1, 5], ["itivi", -1, 6], ["icit\u0103i", -1, 4], ["abilit\u0103i", -1, 1], ["ivit\u0103i", -1, 3], ["icit\u0103\u0163i", -1, 4], ["abilit\u0103\u0163i", -1, 1], ["ivit\u0103\u0163i", -1, 3], ["ical", -1, 4], ["ator", -1, 5], ["icator", 35, 4], ["itor", -1, 6], ["\u0103tor", -1, 5], ["iciv", -1, 4], ["ativ", -1, 5], ["itiv", -1, 6], ["ical\u0103", -1, 4], ["iciv\u0103", -1, 4], ["ativ\u0103", -1, 5], ["itiv\u0103", -1, 6] ]; /** @const */ var a_3 = [ ["ica", -1, 1], ["abila", -1, 1], ["ibila", -1, 1], ["oasa", -1, 1], ["ata", -1, 1], ["ita", -1, 1], ["anta", -1, 1], ["ista", -1, 3], ["uta", -1, 1], ["iva", -1, 1], ["ic", -1, 1], ["ice", -1, 1], ["abile", -1, 1], ["ibile", -1, 1], ["isme", -1, 3], ["iune", -1, 2], ["oase", -1, 1], ["ate", -1, 1], ["itate", 17, 1], ["ite", -1, 1], ["ante", -1, 1], ["iste", -1, 3], ["ute", -1, 1], ["ive", -1, 1], ["ici", -1, 1], ["abili", -1, 1], ["ibili", -1, 1], ["iuni", -1, 2], ["atori", -1, 1], ["osi", -1, 1], ["ati", -1, 1], ["itati", 30, 1], ["iti", -1, 1], ["anti", -1, 1], ["isti", -1, 3], ["uti", -1, 1], ["i\u015Fti", -1, 3], ["ivi", -1, 1], ["it\u0103i", -1, 1], ["o\u015Fi", -1, 1], ["it\u0103\u0163i", -1, 1], ["abil", -1, 1], ["ibil", -1, 1], ["ism", -1, 3], ["ator", -1, 1], ["os", -1, 1], ["at", -1, 1], ["it", -1, 1], ["ant", -1, 1], ["ist", -1, 3], ["ut", -1, 1], ["iv", -1, 1], ["ic\u0103", -1, 1], ["abil\u0103", -1, 1], ["ibil\u0103", -1, 1], ["oas\u0103", -1, 1], ["at\u0103", -1, 1], ["it\u0103", -1, 1], ["ant\u0103", -1, 1], ["ist\u0103", -1, 3], ["ut\u0103", -1, 1], ["iv\u0103", -1, 1] ]; /** @const */ var a_4 = [ ["ea", -1, 1], ["ia", -1, 1], ["esc", -1, 1], ["\u0103sc", -1, 1], ["ind", -1, 1], ["\u00E2nd", -1, 1], ["are", -1, 1], ["ere", -1, 1], ["ire", -1, 1], ["\u00E2re", -1, 1], ["se", -1, 2], ["ase", 10, 1], ["sese", 10, 2], ["ise", 10, 1], ["use", 10, 1], ["\u00E2se", 10, 1], ["e\u015Fte", -1, 1], ["\u0103\u015Fte", -1, 1], ["eze", -1, 1], ["ai", -1, 1], ["eai", 19, 1], ["iai", 19, 1], ["sei", -1, 2], ["e\u015Fti", -1, 1], ["\u0103\u015Fti", -1, 1], ["ui", -1, 1], ["ezi", -1, 1], ["\u00E2i", -1, 1], ["a\u015Fi", -1, 1], ["se\u015Fi", -1, 2], ["ase\u015Fi", 29, 1], ["sese\u015Fi", 29, 2], ["ise\u015Fi", 29, 1], ["use\u015Fi", 29, 1], ["\u00E2se\u015Fi", 29, 1], ["i\u015Fi", -1, 1], ["u\u015Fi", -1, 1], ["\u00E2\u015Fi", -1, 1], ["a\u0163i", -1, 2], ["ea\u0163i", 38, 1], ["ia\u0163i", 38, 1], ["e\u0163i", -1, 2], ["i\u0163i", -1, 2], ["\u00E2\u0163i", -1, 2], ["ar\u0103\u0163i", -1, 1], ["ser\u0103\u0163i", -1, 2], ["aser\u0103\u0163i", 45, 1], ["seser\u0103\u0163i", 45, 2], ["iser\u0103\u0163i", 45, 1], ["user\u0103\u0163i", 45, 1], ["\u00E2ser\u0103\u0163i", 45, 1], ["ir\u0103\u0163i", -1, 1], ["ur\u0103\u0163i", -1, 1], ["\u00E2r\u0103\u0163i", -1, 1], ["am", -1, 1], ["eam", 54, 1], ["iam", 54, 1], ["em", -1, 2], ["asem", 57, 1], ["sesem", 57, 2], ["isem", 57, 1], ["usem", 57, 1], ["\u00E2sem", 57, 1], ["im", -1, 2], ["\u00E2m", -1, 2], ["\u0103m", -1, 2], ["ar\u0103m", 65, 1], ["ser\u0103m", 65, 2], ["aser\u0103m", 67, 1], ["seser\u0103m", 67, 2], ["iser\u0103m", 67, 1], ["user\u0103m", 67, 1], ["\u00E2ser\u0103m", 67, 1], ["ir\u0103m", 65, 1], ["ur\u0103m", 65, 1], ["\u00E2r\u0103m", 65, 1], ["au", -1, 1], ["eau", 76, 1], ["iau", 76, 1], ["indu", -1, 1], ["\u00E2ndu", -1, 1], ["ez", -1, 1], ["easc\u0103", -1, 1], ["ar\u0103", -1, 1], ["ser\u0103", -1, 2], ["aser\u0103", 84, 1], ["seser\u0103", 84, 2], ["iser\u0103", 84, 1], ["user\u0103", 84, 1], ["\u00E2ser\u0103", 84, 1], ["ir\u0103", -1, 1], ["ur\u0103", -1, 1], ["\u00E2r\u0103", -1, 1], ["eaz\u0103", -1, 1] ]; /** @const */ var a_5 = [ ["a", -1, 1], ["e", -1, 1], ["ie", 1, 1], ["i", -1, 1], ["\u0103", -1, 1] ]; /** @const */ var /** Array<int> */ g_v = [17, 65, 16, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 2, 32, 0, 0, 4]; var /** boolean */ B_standard_suffix_removed = false; var /** number */ I_p2 = 0; var /** number */ I_p1 = 0; var /** number */ I_pV = 0; /** @return {boolean} */ function r_prelude() { while(true) { var /** number */ v_1 = base.cursor; lab0: { golab1: while(true) { var /** number */ v_2 = base.cursor; lab2: { if (!(base.in_grouping(g_v, 97, 259))) { break lab2; } base.bra = base.cursor; lab3: { var /** number */ v_3 = base.cursor; lab4: { if (!(base.eq_s("u"))) { break lab4; } base.ket = base.cursor; if (!(base.in_grouping(g_v, 97, 259))) { break lab4; } if (!base.slice_from("U")) { return false; } break lab3; } base.cursor = v_3; if (!(base.eq_s("i"))) { break lab2; } base.ket = base.cursor; if (!(base.in_grouping(g_v, 97, 259))) { break lab2; } if (!base.slice_from("I")) { return false; } } base.cursor = v_2; break golab1; } base.cursor = v_2; if (base.cursor >= base.limit) { break lab0; } base.cursor++; } continue; } base.cursor = v_1; break; } return true; }; /** @return {boolean} */ function r_mark_regions() { I_pV = base.limit; I_p1 = base.limit; I_p2 = base.limit; var /** number */ v_1 = base.cursor; lab0: { lab1: { var /** number */ v_2 = base.cursor; lab2: { if (!(base.in_grouping(g_v, 97, 259))) { break lab2; } lab3: { var /** number */ v_3 = base.cursor; lab4: { if (!(base.out_grouping(g_v, 97, 259))) { break lab4; } golab5: while(true) { lab6: { if (!(base.in_grouping(g_v, 97, 259))) { break lab6; } break golab5; } if (base.cursor >= base.limit) { break lab4; } base.cursor++; } break lab3; } base.cursor = v_3; if (!(base.in_grouping(g_v, 97, 259))) { break lab2; } golab7: while(true) { lab8: { if (!(base.out_grouping(g_v, 97, 259))) { break lab8; } break golab7; } if (base.cursor >= base.limit) { break lab2; } base.cursor++; } } break lab1; } base.cursor = v_2; if (!(base.out_grouping(g_v, 97, 259))) { break lab0; } lab9: { var /** number */ v_6 = base.cursor; lab10: { if (!(base.out_grouping(g_v, 97, 259))) { break lab10; } golab11: while(true) { lab12: { if (!(base.in_grouping(g_v, 97, 259))) { break lab12; } break golab11; } if (base.cursor >= base.limit) { break lab10; } base.cursor++; } break lab9; } base.cursor = v_6; if (!(base.in_grouping(g_v, 97, 259))) { break lab0; } if (base.cursor >= base.limit) { break lab0; } base.cursor++; } } I_pV = base.cursor; } base.cursor = v_1; var /** number */ v_8 = base.cursor; lab13: { golab14: while(true) { lab15: { if (!(base.in_grouping(g_v, 97, 259))) { break lab15; } break golab14; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } golab16: while(true) { lab17: { if (!(base.out_grouping(g_v, 97, 259))) { break lab17; } break golab16; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } I_p1 = base.cursor; golab18: while(true) { lab19: { if (!(base.in_grouping(g_v, 97, 259))) { break lab19; } break golab18; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } golab20: while(true) { lab21: { if (!(base.out_grouping(g_v, 97, 259))) { break lab21; } break golab20; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } I_p2 = base.cursor; } base.cursor = v_8; return true; }; /** @return {boolean} */ function r_postlude() { var /** number */ among_var; while(true) { var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_0); if (among_var == 0) { break lab0; } base.ket = base.cursor; switch (among_var) { case 1: if (!base.slice_from("i")) { return false; } break; case 2: if (!base.slice_from("u")) { return false; } break; case 3: if (base.cursor >= base.limit) { break lab0; } base.cursor++; break; } continue; } base.cursor = v_1; break; } return true; }; /** @return {boolean} */ function r_RV() { if (!(I_pV <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_R1() { if (!(I_p1 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_R2() { if (!(I_p2 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_step_0() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_1); if (among_var == 0) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } switch (among_var) { case 1: if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_from("a")) { return false; } break; case 3: if (!base.slice_from("e")) { return false; } break; case 4: if (!base.slice_from("i")) { return false; } break; case 5: { var /** number */ v_1 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("ab"))) { break lab0; } return false; } base.cursor = base.limit - v_1; } if (!base.slice_from("i")) { return false; } break; case 6: if (!base.slice_from("at")) { return false; } break; case 7: if (!base.slice_from("a\u0163i")) { return false; } break; } return true; }; /** @return {boolean} */ function r_combo_suffix() { var /** number */ among_var; var /** number */ v_1 = base.limit - base.cursor; base.ket = base.cursor; among_var = base.find_among_b(a_2); if (among_var == 0) { return false; } base.bra = base.cursor; if (!r_R1()) { return false; } switch (among_var) { case 1: if (!base.slice_from("abil")) { return false; } break; case 2: if (!base.slice_from("ibil")) { return false; } break; case 3: if (!base.slice_from("iv")) { return false; } break; case 4: if (!base.slice_from("ic")) { return false; } break; case 5: if (!base.slice_from("at")) { return false; } break; case 6: if (!base.slice_from("it")) { return false; } break; } B_standard_suffix_removed = true; base.cursor = base.limit - v_1; return true; }; /** @return {boolean} */ function r_standard_suffix() { var /** number */ among_var; B_standard_suffix_removed = false; while(true) { var /** number */ v_1 = base.limit - base.cursor; lab0: { if (!r_combo_suffix()) { break lab0; } continue; } base.cursor = base.limit - v_1; break; } base.ket = base.cursor; among_var = base.find_among_b(a_3); if (among_var == 0) { return false; } base.bra = base.cursor; if (!r_R2()) { return false; } switch (among_var) { case 1: if (!base.slice_del()) { return false; } break; case 2: if (!(base.eq_s_b("\u0163"))) { return false; } base.bra = base.cursor; if (!base.slice_from("t")) { return false; } break; case 3: if (!base.slice_from("ist")) { return false; } break; } B_standard_suffix_removed = true; return true; }; /** @return {boolean} */ function r_verb_suffix() { var /** number */ among_var; if (base.cursor < I_pV) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; among_var = base.find_among_b(a_4); if (among_var == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; switch (among_var) { case 1: lab0: { var /** number */ v_3 = base.limit - base.cursor; lab1: { if (!(base.out_grouping_b(g_v, 97, 259))) { break lab1; } break lab0; } base.cursor = base.limit - v_3; if (!(base.eq_s_b("u"))) { base.limit_backward = v_2; return false; } } if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_del()) { return false; } break; } base.limit_backward = v_2; return true; }; /** @return {boolean} */ function r_vowel_suffix() { base.ket = base.cursor; if (base.find_among_b(a_5) == 0) { return false; } base.bra = base.cursor; if (!r_RV()) { return false; } if (!base.slice_del()) { return false; } return true; }; this.stem = /** @return {boolean} */ function() { var /** number */ v_1 = base.cursor; r_prelude(); base.cursor = v_1; r_mark_regions(); base.limit_backward = base.cursor; base.cursor = base.limit; var /** number */ v_3 = base.limit - base.cursor; r_step_0(); base.cursor = base.limit - v_3; var /** number */ v_4 = base.limit - base.cursor; r_standard_suffix(); base.cursor = base.limit - v_4; var /** number */ v_5 = base.limit - base.cursor; lab0: { lab1: { var /** number */ v_6 = base.limit - base.cursor; lab2: { if (!B_standard_suffix_removed) { break lab2; } break lab1; } base.cursor = base.limit - v_6; if (!r_verb_suffix()) { break lab0; } } } base.cursor = base.limit - v_5; var /** number */ v_7 = base.limit - base.cursor; r_vowel_suffix(); base.cursor = base.limit - v_7; base.cursor = base.limit_backward; var /** number */ v_8 = base.cursor; r_postlude(); base.cursor = v_8; return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; ����������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/russian-stemmer.js���������������������������������������0000644�0000766�0000024�00000043114�00000000000�023576� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ RussianStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["\u0432", -1, 1], ["\u0438\u0432", 0, 2], ["\u044B\u0432", 0, 2], ["\u0432\u0448\u0438", -1, 1], ["\u0438\u0432\u0448\u0438", 3, 2], ["\u044B\u0432\u0448\u0438", 3, 2], ["\u0432\u0448\u0438\u0441\u044C", -1, 1], ["\u0438\u0432\u0448\u0438\u0441\u044C", 6, 2], ["\u044B\u0432\u0448\u0438\u0441\u044C", 6, 2] ]; /** @const */ var a_1 = [ ["\u0435\u0435", -1, 1], ["\u0438\u0435", -1, 1], ["\u043E\u0435", -1, 1], ["\u044B\u0435", -1, 1], ["\u0438\u043C\u0438", -1, 1], ["\u044B\u043C\u0438", -1, 1], ["\u0435\u0439", -1, 1], ["\u0438\u0439", -1, 1], ["\u043E\u0439", -1, 1], ["\u044B\u0439", -1, 1], ["\u0435\u043C", -1, 1], ["\u0438\u043C", -1, 1], ["\u043E\u043C", -1, 1], ["\u044B\u043C", -1, 1], ["\u0435\u0433\u043E", -1, 1], ["\u043E\u0433\u043E", -1, 1], ["\u0435\u043C\u0443", -1, 1], ["\u043E\u043C\u0443", -1, 1], ["\u0438\u0445", -1, 1], ["\u044B\u0445", -1, 1], ["\u0435\u044E", -1, 1], ["\u043E\u044E", -1, 1], ["\u0443\u044E", -1, 1], ["\u044E\u044E", -1, 1], ["\u0430\u044F", -1, 1], ["\u044F\u044F", -1, 1] ]; /** @const */ var a_2 = [ ["\u0435\u043C", -1, 1], ["\u043D\u043D", -1, 1], ["\u0432\u0448", -1, 1], ["\u0438\u0432\u0448", 2, 2], ["\u044B\u0432\u0448", 2, 2], ["\u0449", -1, 1], ["\u044E\u0449", 5, 1], ["\u0443\u044E\u0449", 6, 2] ]; /** @const */ var a_3 = [ ["\u0441\u044C", -1, 1], ["\u0441\u044F", -1, 1] ]; /** @const */ var a_4 = [ ["\u043B\u0430", -1, 1], ["\u0438\u043B\u0430", 0, 2], ["\u044B\u043B\u0430", 0, 2], ["\u043D\u0430", -1, 1], ["\u0435\u043D\u0430", 3, 2], ["\u0435\u0442\u0435", -1, 1], ["\u0438\u0442\u0435", -1, 2], ["\u0439\u0442\u0435", -1, 1], ["\u0435\u0439\u0442\u0435", 7, 2], ["\u0443\u0439\u0442\u0435", 7, 2], ["\u043B\u0438", -1, 1], ["\u0438\u043B\u0438", 10, 2], ["\u044B\u043B\u0438", 10, 2], ["\u0439", -1, 1], ["\u0435\u0439", 13, 2], ["\u0443\u0439", 13, 2], ["\u043B", -1, 1], ["\u0438\u043B", 16, 2], ["\u044B\u043B", 16, 2], ["\u0435\u043C", -1, 1], ["\u0438\u043C", -1, 2], ["\u044B\u043C", -1, 2], ["\u043D", -1, 1], ["\u0435\u043D", 22, 2], ["\u043B\u043E", -1, 1], ["\u0438\u043B\u043E", 24, 2], ["\u044B\u043B\u043E", 24, 2], ["\u043D\u043E", -1, 1], ["\u0435\u043D\u043E", 27, 2], ["\u043D\u043D\u043E", 27, 1], ["\u0435\u0442", -1, 1], ["\u0443\u0435\u0442", 30, 2], ["\u0438\u0442", -1, 2], ["\u044B\u0442", -1, 2], ["\u044E\u0442", -1, 1], ["\u0443\u044E\u0442", 34, 2], ["\u044F\u0442", -1, 2], ["\u043D\u044B", -1, 1], ["\u0435\u043D\u044B", 37, 2], ["\u0442\u044C", -1, 1], ["\u0438\u0442\u044C", 39, 2], ["\u044B\u0442\u044C", 39, 2], ["\u0435\u0448\u044C", -1, 1], ["\u0438\u0448\u044C", -1, 2], ["\u044E", -1, 2], ["\u0443\u044E", 44, 2] ]; /** @const */ var a_5 = [ ["\u0430", -1, 1], ["\u0435\u0432", -1, 1], ["\u043E\u0432", -1, 1], ["\u0435", -1, 1], ["\u0438\u0435", 3, 1], ["\u044C\u0435", 3, 1], ["\u0438", -1, 1], ["\u0435\u0438", 6, 1], ["\u0438\u0438", 6, 1], ["\u0430\u043C\u0438", 6, 1], ["\u044F\u043C\u0438", 6, 1], ["\u0438\u044F\u043C\u0438", 10, 1], ["\u0439", -1, 1], ["\u0435\u0439", 12, 1], ["\u0438\u0435\u0439", 13, 1], ["\u0438\u0439", 12, 1], ["\u043E\u0439", 12, 1], ["\u0430\u043C", -1, 1], ["\u0435\u043C", -1, 1], ["\u0438\u0435\u043C", 18, 1], ["\u043E\u043C", -1, 1], ["\u044F\u043C", -1, 1], ["\u0438\u044F\u043C", 21, 1], ["\u043E", -1, 1], ["\u0443", -1, 1], ["\u0430\u0445", -1, 1], ["\u044F\u0445", -1, 1], ["\u0438\u044F\u0445", 26, 1], ["\u044B", -1, 1], ["\u044C", -1, 1], ["\u044E", -1, 1], ["\u0438\u044E", 30, 1], ["\u044C\u044E", 30, 1], ["\u044F", -1, 1], ["\u0438\u044F", 33, 1], ["\u044C\u044F", 33, 1] ]; /** @const */ var a_6 = [ ["\u043E\u0441\u0442", -1, 1], ["\u043E\u0441\u0442\u044C", -1, 1] ]; /** @const */ var a_7 = [ ["\u0435\u0439\u0448\u0435", -1, 1], ["\u043D", -1, 2], ["\u0435\u0439\u0448", -1, 1], ["\u044C", -1, 3] ]; /** @const */ var /** Array<int> */ g_v = [33, 65, 8, 232]; var /** number */ I_p2 = 0; var /** number */ I_pV = 0; /** @return {boolean} */ function r_mark_regions() { I_pV = base.limit; I_p2 = base.limit; var /** number */ v_1 = base.cursor; lab0: { golab1: while(true) { lab2: { if (!(base.in_grouping(g_v, 1072, 1103))) { break lab2; } break golab1; } if (base.cursor >= base.limit) { break lab0; } base.cursor++; } I_pV = base.cursor; golab3: while(true) { lab4: { if (!(base.out_grouping(g_v, 1072, 1103))) { break lab4; } break golab3; } if (base.cursor >= base.limit) { break lab0; } base.cursor++; } golab5: while(true) { lab6: { if (!(base.in_grouping(g_v, 1072, 1103))) { break lab6; } break golab5; } if (base.cursor >= base.limit) { break lab0; } base.cursor++; } golab7: while(true) { lab8: { if (!(base.out_grouping(g_v, 1072, 1103))) { break lab8; } break golab7; } if (base.cursor >= base.limit) { break lab0; } base.cursor++; } I_p2 = base.cursor; } base.cursor = v_1; return true; }; /** @return {boolean} */ function r_R2() { if (!(I_p2 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_perfective_gerund() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_0); if (among_var == 0) { return false; } base.bra = base.cursor; switch (among_var) { case 1: lab0: { var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("\u0430"))) { break lab1; } break lab0; } base.cursor = base.limit - v_1; if (!(base.eq_s_b("\u044F"))) { return false; } } if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_del()) { return false; } break; } return true; }; /** @return {boolean} */ function r_adjective() { base.ket = base.cursor; if (base.find_among_b(a_1) == 0) { return false; } base.bra = base.cursor; if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_adjectival() { var /** number */ among_var; if (!r_adjective()) { return false; } var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; among_var = base.find_among_b(a_2); if (among_var == 0) { base.cursor = base.limit - v_1; break lab0; } base.bra = base.cursor; switch (among_var) { case 1: lab1: { var /** number */ v_2 = base.limit - base.cursor; lab2: { if (!(base.eq_s_b("\u0430"))) { break lab2; } break lab1; } base.cursor = base.limit - v_2; if (!(base.eq_s_b("\u044F"))) { base.cursor = base.limit - v_1; break lab0; } } if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_del()) { return false; } break; } } return true; }; /** @return {boolean} */ function r_reflexive() { base.ket = base.cursor; if (base.find_among_b(a_3) == 0) { return false; } base.bra = base.cursor; if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_verb() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_4); if (among_var == 0) { return false; } base.bra = base.cursor; switch (among_var) { case 1: lab0: { var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("\u0430"))) { break lab1; } break lab0; } base.cursor = base.limit - v_1; if (!(base.eq_s_b("\u044F"))) { return false; } } if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_del()) { return false; } break; } return true; }; /** @return {boolean} */ function r_noun() { base.ket = base.cursor; if (base.find_among_b(a_5) == 0) { return false; } base.bra = base.cursor; if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_derivational() { base.ket = base.cursor; if (base.find_among_b(a_6) == 0) { return false; } base.bra = base.cursor; if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_tidy_up() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_7); if (among_var == 0) { return false; } base.bra = base.cursor; switch (among_var) { case 1: if (!base.slice_del()) { return false; } base.ket = base.cursor; if (!(base.eq_s_b("\u043D"))) { return false; } base.bra = base.cursor; if (!(base.eq_s_b("\u043D"))) { return false; } if (!base.slice_del()) { return false; } break; case 2: if (!(base.eq_s_b("\u043D"))) { return false; } if (!base.slice_del()) { return false; } break; case 3: if (!base.slice_del()) { return false; } break; } return true; }; this.stem = /** @return {boolean} */ function() { var /** number */ v_1 = base.cursor; lab0: { while(true) { var /** number */ v_2 = base.cursor; lab1: { golab2: while(true) { var /** number */ v_3 = base.cursor; lab3: { base.bra = base.cursor; if (!(base.eq_s("\u0451"))) { break lab3; } base.ket = base.cursor; base.cursor = v_3; break golab2; } base.cursor = v_3; if (base.cursor >= base.limit) { break lab1; } base.cursor++; } if (!base.slice_from("\u0435")) { return false; } continue; } base.cursor = v_2; break; } } base.cursor = v_1; r_mark_regions(); base.limit_backward = base.cursor; base.cursor = base.limit; if (base.cursor < I_pV) { return false; } var /** number */ v_6 = base.limit_backward; base.limit_backward = I_pV; var /** number */ v_7 = base.limit - base.cursor; lab4: { lab5: { var /** number */ v_8 = base.limit - base.cursor; lab6: { if (!r_perfective_gerund()) { break lab6; } break lab5; } base.cursor = base.limit - v_8; var /** number */ v_9 = base.limit - base.cursor; lab7: { if (!r_reflexive()) { base.cursor = base.limit - v_9; break lab7; } } lab8: { var /** number */ v_10 = base.limit - base.cursor; lab9: { if (!r_adjectival()) { break lab9; } break lab8; } base.cursor = base.limit - v_10; lab10: { if (!r_verb()) { break lab10; } break lab8; } base.cursor = base.limit - v_10; if (!r_noun()) { break lab4; } } } } base.cursor = base.limit - v_7; var /** number */ v_11 = base.limit - base.cursor; lab11: { base.ket = base.cursor; if (!(base.eq_s_b("\u0438"))) { base.cursor = base.limit - v_11; break lab11; } base.bra = base.cursor; if (!base.slice_del()) { return false; } } var /** number */ v_12 = base.limit - base.cursor; r_derivational(); base.cursor = base.limit - v_12; var /** number */ v_13 = base.limit - base.cursor; r_tidy_up(); base.cursor = base.limit - v_13; base.limit_backward = v_6; base.cursor = base.limit_backward; return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/spanish-stemmer.js���������������������������������������0000644�0000766�0000024�00000067566�00000000000�023600� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ SpanishStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["", -1, 6], ["\u00E1", 0, 1], ["\u00E9", 0, 2], ["\u00ED", 0, 3], ["\u00F3", 0, 4], ["\u00FA", 0, 5] ]; /** @const */ var a_1 = [ ["la", -1, -1], ["sela", 0, -1], ["le", -1, -1], ["me", -1, -1], ["se", -1, -1], ["lo", -1, -1], ["selo", 5, -1], ["las", -1, -1], ["selas", 7, -1], ["les", -1, -1], ["los", -1, -1], ["selos", 10, -1], ["nos", -1, -1] ]; /** @const */ var a_2 = [ ["ando", -1, 6], ["iendo", -1, 6], ["yendo", -1, 7], ["\u00E1ndo", -1, 2], ["i\u00E9ndo", -1, 1], ["ar", -1, 6], ["er", -1, 6], ["ir", -1, 6], ["\u00E1r", -1, 3], ["\u00E9r", -1, 4], ["\u00EDr", -1, 5] ]; /** @const */ var a_3 = [ ["ic", -1, -1], ["ad", -1, -1], ["os", -1, -1], ["iv", -1, 1] ]; /** @const */ var a_4 = [ ["able", -1, 1], ["ible", -1, 1], ["ante", -1, 1] ]; /** @const */ var a_5 = [ ["ic", -1, 1], ["abil", -1, 1], ["iv", -1, 1] ]; /** @const */ var a_6 = [ ["ica", -1, 1], ["ancia", -1, 2], ["encia", -1, 5], ["adora", -1, 2], ["osa", -1, 1], ["ista", -1, 1], ["iva", -1, 9], ["anza", -1, 1], ["log\u00EDa", -1, 3], ["idad", -1, 8], ["able", -1, 1], ["ible", -1, 1], ["ante", -1, 2], ["mente", -1, 7], ["amente", 13, 6], ["aci\u00F3n", -1, 2], ["uci\u00F3n", -1, 4], ["ico", -1, 1], ["ismo", -1, 1], ["oso", -1, 1], ["amiento", -1, 1], ["imiento", -1, 1], ["ivo", -1, 9], ["ador", -1, 2], ["icas", -1, 1], ["ancias", -1, 2], ["encias", -1, 5], ["adoras", -1, 2], ["osas", -1, 1], ["istas", -1, 1], ["ivas", -1, 9], ["anzas", -1, 1], ["log\u00EDas", -1, 3], ["idades", -1, 8], ["ables", -1, 1], ["ibles", -1, 1], ["aciones", -1, 2], ["uciones", -1, 4], ["adores", -1, 2], ["antes", -1, 2], ["icos", -1, 1], ["ismos", -1, 1], ["osos", -1, 1], ["amientos", -1, 1], ["imientos", -1, 1], ["ivos", -1, 9] ]; /** @const */ var a_7 = [ ["ya", -1, 1], ["ye", -1, 1], ["yan", -1, 1], ["yen", -1, 1], ["yeron", -1, 1], ["yendo", -1, 1], ["yo", -1, 1], ["yas", -1, 1], ["yes", -1, 1], ["yais", -1, 1], ["yamos", -1, 1], ["y\u00F3", -1, 1] ]; /** @const */ var a_8 = [ ["aba", -1, 2], ["ada", -1, 2], ["ida", -1, 2], ["ara", -1, 2], ["iera", -1, 2], ["\u00EDa", -1, 2], ["ar\u00EDa", 5, 2], ["er\u00EDa", 5, 2], ["ir\u00EDa", 5, 2], ["ad", -1, 2], ["ed", -1, 2], ["id", -1, 2], ["ase", -1, 2], ["iese", -1, 2], ["aste", -1, 2], ["iste", -1, 2], ["an", -1, 2], ["aban", 16, 2], ["aran", 16, 2], ["ieran", 16, 2], ["\u00EDan", 16, 2], ["ar\u00EDan", 20, 2], ["er\u00EDan", 20, 2], ["ir\u00EDan", 20, 2], ["en", -1, 1], ["asen", 24, 2], ["iesen", 24, 2], ["aron", -1, 2], ["ieron", -1, 2], ["ar\u00E1n", -1, 2], ["er\u00E1n", -1, 2], ["ir\u00E1n", -1, 2], ["ado", -1, 2], ["ido", -1, 2], ["ando", -1, 2], ["iendo", -1, 2], ["ar", -1, 2], ["er", -1, 2], ["ir", -1, 2], ["as", -1, 2], ["abas", 39, 2], ["adas", 39, 2], ["idas", 39, 2], ["aras", 39, 2], ["ieras", 39, 2], ["\u00EDas", 39, 2], ["ar\u00EDas", 45, 2], ["er\u00EDas", 45, 2], ["ir\u00EDas", 45, 2], ["es", -1, 1], ["ases", 49, 2], ["ieses", 49, 2], ["abais", -1, 2], ["arais", -1, 2], ["ierais", -1, 2], ["\u00EDais", -1, 2], ["ar\u00EDais", 55, 2], ["er\u00EDais", 55, 2], ["ir\u00EDais", 55, 2], ["aseis", -1, 2], ["ieseis", -1, 2], ["asteis", -1, 2], ["isteis", -1, 2], ["\u00E1is", -1, 2], ["\u00E9is", -1, 1], ["ar\u00E9is", 64, 2], ["er\u00E9is", 64, 2], ["ir\u00E9is", 64, 2], ["ados", -1, 2], ["idos", -1, 2], ["amos", -1, 2], ["\u00E1bamos", 70, 2], ["\u00E1ramos", 70, 2], ["i\u00E9ramos", 70, 2], ["\u00EDamos", 70, 2], ["ar\u00EDamos", 74, 2], ["er\u00EDamos", 74, 2], ["ir\u00EDamos", 74, 2], ["emos", -1, 1], ["aremos", 78, 2], ["eremos", 78, 2], ["iremos", 78, 2], ["\u00E1semos", 78, 2], ["i\u00E9semos", 78, 2], ["imos", -1, 2], ["ar\u00E1s", -1, 2], ["er\u00E1s", -1, 2], ["ir\u00E1s", -1, 2], ["\u00EDs", -1, 2], ["ar\u00E1", -1, 2], ["er\u00E1", -1, 2], ["ir\u00E1", -1, 2], ["ar\u00E9", -1, 2], ["er\u00E9", -1, 2], ["ir\u00E9", -1, 2], ["i\u00F3", -1, 2] ]; /** @const */ var a_9 = [ ["a", -1, 1], ["e", -1, 2], ["o", -1, 1], ["os", -1, 1], ["\u00E1", -1, 1], ["\u00E9", -1, 2], ["\u00ED", -1, 1], ["\u00F3", -1, 1] ]; /** @const */ var /** Array<int> */ g_v = [17, 65, 16, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 17, 4, 10]; var /** number */ I_p2 = 0; var /** number */ I_p1 = 0; var /** number */ I_pV = 0; /** @return {boolean} */ function r_mark_regions() { I_pV = base.limit; I_p1 = base.limit; I_p2 = base.limit; var /** number */ v_1 = base.cursor; lab0: { lab1: { var /** number */ v_2 = base.cursor; lab2: { if (!(base.in_grouping(g_v, 97, 252))) { break lab2; } lab3: { var /** number */ v_3 = base.cursor; lab4: { if (!(base.out_grouping(g_v, 97, 252))) { break lab4; } golab5: while(true) { lab6: { if (!(base.in_grouping(g_v, 97, 252))) { break lab6; } break golab5; } if (base.cursor >= base.limit) { break lab4; } base.cursor++; } break lab3; } base.cursor = v_3; if (!(base.in_grouping(g_v, 97, 252))) { break lab2; } golab7: while(true) { lab8: { if (!(base.out_grouping(g_v, 97, 252))) { break lab8; } break golab7; } if (base.cursor >= base.limit) { break lab2; } base.cursor++; } } break lab1; } base.cursor = v_2; if (!(base.out_grouping(g_v, 97, 252))) { break lab0; } lab9: { var /** number */ v_6 = base.cursor; lab10: { if (!(base.out_grouping(g_v, 97, 252))) { break lab10; } golab11: while(true) { lab12: { if (!(base.in_grouping(g_v, 97, 252))) { break lab12; } break golab11; } if (base.cursor >= base.limit) { break lab10; } base.cursor++; } break lab9; } base.cursor = v_6; if (!(base.in_grouping(g_v, 97, 252))) { break lab0; } if (base.cursor >= base.limit) { break lab0; } base.cursor++; } } I_pV = base.cursor; } base.cursor = v_1; var /** number */ v_8 = base.cursor; lab13: { golab14: while(true) { lab15: { if (!(base.in_grouping(g_v, 97, 252))) { break lab15; } break golab14; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } golab16: while(true) { lab17: { if (!(base.out_grouping(g_v, 97, 252))) { break lab17; } break golab16; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } I_p1 = base.cursor; golab18: while(true) { lab19: { if (!(base.in_grouping(g_v, 97, 252))) { break lab19; } break golab18; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } golab20: while(true) { lab21: { if (!(base.out_grouping(g_v, 97, 252))) { break lab21; } break golab20; } if (base.cursor >= base.limit) { break lab13; } base.cursor++; } I_p2 = base.cursor; } base.cursor = v_8; return true; }; /** @return {boolean} */ function r_postlude() { var /** number */ among_var; while(true) { var /** number */ v_1 = base.cursor; lab0: { base.bra = base.cursor; among_var = base.find_among(a_0); if (among_var == 0) { break lab0; } base.ket = base.cursor; switch (among_var) { case 1: if (!base.slice_from("a")) { return false; } break; case 2: if (!base.slice_from("e")) { return false; } break; case 3: if (!base.slice_from("i")) { return false; } break; case 4: if (!base.slice_from("o")) { return false; } break; case 5: if (!base.slice_from("u")) { return false; } break; case 6: if (base.cursor >= base.limit) { break lab0; } base.cursor++; break; } continue; } base.cursor = v_1; break; } return true; }; /** @return {boolean} */ function r_RV() { if (!(I_pV <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_R1() { if (!(I_p1 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_R2() { if (!(I_p2 <= base.cursor)) { return false; } return true; }; /** @return {boolean} */ function r_attached_pronoun() { var /** number */ among_var; base.ket = base.cursor; if (base.find_among_b(a_1) == 0) { return false; } base.bra = base.cursor; among_var = base.find_among_b(a_2); if (among_var == 0) { return false; } if (!r_RV()) { return false; } switch (among_var) { case 1: base.bra = base.cursor; if (!base.slice_from("iendo")) { return false; } break; case 2: base.bra = base.cursor; if (!base.slice_from("ando")) { return false; } break; case 3: base.bra = base.cursor; if (!base.slice_from("ar")) { return false; } break; case 4: base.bra = base.cursor; if (!base.slice_from("er")) { return false; } break; case 5: base.bra = base.cursor; if (!base.slice_from("ir")) { return false; } break; case 6: if (!base.slice_del()) { return false; } break; case 7: if (!(base.eq_s_b("u"))) { return false; } if (!base.slice_del()) { return false; } break; } return true; }; /** @return {boolean} */ function r_standard_suffix() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_6); if (among_var == 0) { return false; } base.bra = base.cursor; switch (among_var) { case 1: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } break; case 2: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.eq_s_b("ic"))) { base.cursor = base.limit - v_1; break lab0; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_1; break lab0; } if (!base.slice_del()) { return false; } } break; case 3: if (!r_R2()) { return false; } if (!base.slice_from("log")) { return false; } break; case 4: if (!r_R2()) { return false; } if (!base.slice_from("u")) { return false; } break; case 5: if (!r_R2()) { return false; } if (!base.slice_from("ente")) { return false; } break; case 6: if (!r_R1()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_2 = base.limit - base.cursor; lab1: { base.ket = base.cursor; among_var = base.find_among_b(a_3); if (among_var == 0) { base.cursor = base.limit - v_2; break lab1; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_2; break lab1; } if (!base.slice_del()) { return false; } switch (among_var) { case 1: base.ket = base.cursor; if (!(base.eq_s_b("at"))) { base.cursor = base.limit - v_2; break lab1; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_2; break lab1; } if (!base.slice_del()) { return false; } break; } } break; case 7: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_3 = base.limit - base.cursor; lab2: { base.ket = base.cursor; if (base.find_among_b(a_4) == 0) { base.cursor = base.limit - v_3; break lab2; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_3; break lab2; } if (!base.slice_del()) { return false; } } break; case 8: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_4 = base.limit - base.cursor; lab3: { base.ket = base.cursor; if (base.find_among_b(a_5) == 0) { base.cursor = base.limit - v_4; break lab3; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_4; break lab3; } if (!base.slice_del()) { return false; } } break; case 9: if (!r_R2()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_5 = base.limit - base.cursor; lab4: { base.ket = base.cursor; if (!(base.eq_s_b("at"))) { base.cursor = base.limit - v_5; break lab4; } base.bra = base.cursor; if (!r_R2()) { base.cursor = base.limit - v_5; break lab4; } if (!base.slice_del()) { return false; } } break; } return true; }; /** @return {boolean} */ function r_y_verb_suffix() { if (base.cursor < I_pV) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; if (base.find_among_b(a_7) == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; base.limit_backward = v_2; if (!(base.eq_s_b("u"))) { return false; } if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_verb_suffix() { var /** number */ among_var; if (base.cursor < I_pV) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_pV; base.ket = base.cursor; among_var = base.find_among_b(a_8); if (among_var == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; base.limit_backward = v_2; switch (among_var) { case 1: var /** number */ v_3 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("u"))) { base.cursor = base.limit - v_3; break lab0; } var /** number */ v_4 = base.limit - base.cursor; if (!(base.eq_s_b("g"))) { base.cursor = base.limit - v_3; break lab0; } base.cursor = base.limit - v_4; } base.bra = base.cursor; if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_del()) { return false; } break; } return true; }; /** @return {boolean} */ function r_residual_suffix() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_9); if (among_var == 0) { return false; } base.bra = base.cursor; switch (among_var) { case 1: if (!r_RV()) { return false; } if (!base.slice_del()) { return false; } break; case 2: if (!r_RV()) { return false; } if (!base.slice_del()) { return false; } var /** number */ v_1 = base.limit - base.cursor; lab0: { base.ket = base.cursor; if (!(base.eq_s_b("u"))) { base.cursor = base.limit - v_1; break lab0; } base.bra = base.cursor; var /** number */ v_2 = base.limit - base.cursor; if (!(base.eq_s_b("g"))) { base.cursor = base.limit - v_1; break lab0; } base.cursor = base.limit - v_2; if (!r_RV()) { base.cursor = base.limit - v_1; break lab0; } if (!base.slice_del()) { return false; } } break; } return true; }; this.stem = /** @return {boolean} */ function() { r_mark_regions(); base.limit_backward = base.cursor; base.cursor = base.limit; var /** number */ v_2 = base.limit - base.cursor; r_attached_pronoun(); base.cursor = base.limit - v_2; var /** number */ v_3 = base.limit - base.cursor; lab0: { lab1: { var /** number */ v_4 = base.limit - base.cursor; lab2: { if (!r_standard_suffix()) { break lab2; } break lab1; } base.cursor = base.limit - v_4; lab3: { if (!r_y_verb_suffix()) { break lab3; } break lab1; } base.cursor = base.limit - v_4; if (!r_verb_suffix()) { break lab0; } } } base.cursor = base.limit - v_3; var /** number */ v_5 = base.limit - base.cursor; r_residual_suffix(); base.cursor = base.limit - v_5; base.cursor = base.limit_backward; var /** number */ v_6 = base.cursor; r_postlude(); base.cursor = v_6; return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; ������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/swedish-stemmer.js���������������������������������������0000644�0000766�0000024�00000015303�00000000000�023557� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ SwedishStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["a", -1, 1], ["arna", 0, 1], ["erna", 0, 1], ["heterna", 2, 1], ["orna", 0, 1], ["ad", -1, 1], ["e", -1, 1], ["ade", 6, 1], ["ande", 6, 1], ["arne", 6, 1], ["are", 6, 1], ["aste", 6, 1], ["en", -1, 1], ["anden", 12, 1], ["aren", 12, 1], ["heten", 12, 1], ["ern", -1, 1], ["ar", -1, 1], ["er", -1, 1], ["heter", 18, 1], ["or", -1, 1], ["s", -1, 2], ["as", 21, 1], ["arnas", 22, 1], ["ernas", 22, 1], ["ornas", 22, 1], ["es", 21, 1], ["ades", 26, 1], ["andes", 26, 1], ["ens", 21, 1], ["arens", 29, 1], ["hetens", 29, 1], ["erns", 21, 1], ["at", -1, 1], ["andet", -1, 1], ["het", -1, 1], ["ast", -1, 1] ]; /** @const */ var a_1 = [ ["dd", -1, -1], ["gd", -1, -1], ["nn", -1, -1], ["dt", -1, -1], ["gt", -1, -1], ["kt", -1, -1], ["tt", -1, -1] ]; /** @const */ var a_2 = [ ["ig", -1, 1], ["lig", 0, 1], ["els", -1, 1], ["fullt", -1, 3], ["l\u00F6st", -1, 2] ]; /** @const */ var /** Array<int> */ g_v = [17, 65, 16, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 24, 0, 32]; /** @const */ var /** Array<int> */ g_s_ending = [119, 127, 149]; var /** number */ I_x = 0; var /** number */ I_p1 = 0; /** @return {boolean} */ function r_mark_regions() { I_p1 = base.limit; var /** number */ v_1 = base.cursor; { var /** number */ c1 = base.cursor + 3; if (c1 > base.limit) { return false; } base.cursor = c1; } I_x = base.cursor; base.cursor = v_1; golab0: while(true) { var /** number */ v_2 = base.cursor; lab1: { if (!(base.in_grouping(g_v, 97, 246))) { break lab1; } base.cursor = v_2; break golab0; } base.cursor = v_2; if (base.cursor >= base.limit) { return false; } base.cursor++; } golab2: while(true) { lab3: { if (!(base.out_grouping(g_v, 97, 246))) { break lab3; } break golab2; } if (base.cursor >= base.limit) { return false; } base.cursor++; } I_p1 = base.cursor; lab4: { if (!(I_p1 < I_x)) { break lab4; } I_p1 = I_x; } return true; }; /** @return {boolean} */ function r_main_suffix() { var /** number */ among_var; if (base.cursor < I_p1) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; among_var = base.find_among_b(a_0); if (among_var == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; base.limit_backward = v_2; switch (among_var) { case 1: if (!base.slice_del()) { return false; } break; case 2: if (!(base.in_grouping_b(g_s_ending, 98, 121))) { return false; } if (!base.slice_del()) { return false; } break; } return true; }; /** @return {boolean} */ function r_consonant_pair() { if (base.cursor < I_p1) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; var /** number */ v_3 = base.limit - base.cursor; if (base.find_among_b(a_1) == 0) { base.limit_backward = v_2; return false; } base.cursor = base.limit - v_3; base.ket = base.cursor; if (base.cursor <= base.limit_backward) { base.limit_backward = v_2; return false; } base.cursor--; base.bra = base.cursor; if (!base.slice_del()) { return false; } base.limit_backward = v_2; return true; }; /** @return {boolean} */ function r_other_suffix() { var /** number */ among_var; if (base.cursor < I_p1) { return false; } var /** number */ v_2 = base.limit_backward; base.limit_backward = I_p1; base.ket = base.cursor; among_var = base.find_among_b(a_2); if (among_var == 0) { base.limit_backward = v_2; return false; } base.bra = base.cursor; switch (among_var) { case 1: if (!base.slice_del()) { return false; } break; case 2: if (!base.slice_from("l\u00F6s")) { return false; } break; case 3: if (!base.slice_from("full")) { return false; } break; } base.limit_backward = v_2; return true; }; this.stem = /** @return {boolean} */ function() { var /** number */ v_1 = base.cursor; r_mark_regions(); base.cursor = v_1; base.limit_backward = base.cursor; base.cursor = base.limit; var /** number */ v_2 = base.limit - base.cursor; r_main_suffix(); base.cursor = base.limit - v_2; var /** number */ v_3 = base.limit - base.cursor; r_consonant_pair(); base.cursor = base.limit - v_3; var /** number */ v_4 = base.limit - base.cursor; r_other_suffix(); base.cursor = base.limit - v_4; base.cursor = base.limit_backward; return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/non-minified-js/turkish-stemmer.js���������������������������������������0000644�0000766�0000024�00000227307�00000000000�023613� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������// Generated by Snowball 2.1.0 - https://snowballstem.org/ /**@constructor*/ TurkishStemmer = function() { var base = new BaseStemmer(); /** @const */ var a_0 = [ ["m", -1, -1], ["n", -1, -1], ["miz", -1, -1], ["niz", -1, -1], ["muz", -1, -1], ["nuz", -1, -1], ["m\u00FCz", -1, -1], ["n\u00FCz", -1, -1], ["m\u0131z", -1, -1], ["n\u0131z", -1, -1] ]; /** @const */ var a_1 = [ ["leri", -1, -1], ["lar\u0131", -1, -1] ]; /** @const */ var a_2 = [ ["ni", -1, -1], ["nu", -1, -1], ["n\u00FC", -1, -1], ["n\u0131", -1, -1] ]; /** @const */ var a_3 = [ ["in", -1, -1], ["un", -1, -1], ["\u00FCn", -1, -1], ["\u0131n", -1, -1] ]; /** @const */ var a_4 = [ ["a", -1, -1], ["e", -1, -1] ]; /** @const */ var a_5 = [ ["na", -1, -1], ["ne", -1, -1] ]; /** @const */ var a_6 = [ ["da", -1, -1], ["ta", -1, -1], ["de", -1, -1], ["te", -1, -1] ]; /** @const */ var a_7 = [ ["nda", -1, -1], ["nde", -1, -1] ]; /** @const */ var a_8 = [ ["dan", -1, -1], ["tan", -1, -1], ["den", -1, -1], ["ten", -1, -1] ]; /** @const */ var a_9 = [ ["ndan", -1, -1], ["nden", -1, -1] ]; /** @const */ var a_10 = [ ["la", -1, -1], ["le", -1, -1] ]; /** @const */ var a_11 = [ ["ca", -1, -1], ["ce", -1, -1] ]; /** @const */ var a_12 = [ ["im", -1, -1], ["um", -1, -1], ["\u00FCm", -1, -1], ["\u0131m", -1, -1] ]; /** @const */ var a_13 = [ ["sin", -1, -1], ["sun", -1, -1], ["s\u00FCn", -1, -1], ["s\u0131n", -1, -1] ]; /** @const */ var a_14 = [ ["iz", -1, -1], ["uz", -1, -1], ["\u00FCz", -1, -1], ["\u0131z", -1, -1] ]; /** @const */ var a_15 = [ ["siniz", -1, -1], ["sunuz", -1, -1], ["s\u00FCn\u00FCz", -1, -1], ["s\u0131n\u0131z", -1, -1] ]; /** @const */ var a_16 = [ ["lar", -1, -1], ["ler", -1, -1] ]; /** @const */ var a_17 = [ ["niz", -1, -1], ["nuz", -1, -1], ["n\u00FCz", -1, -1], ["n\u0131z", -1, -1] ]; /** @const */ var a_18 = [ ["dir", -1, -1], ["tir", -1, -1], ["dur", -1, -1], ["tur", -1, -1], ["d\u00FCr", -1, -1], ["t\u00FCr", -1, -1], ["d\u0131r", -1, -1], ["t\u0131r", -1, -1] ]; /** @const */ var a_19 = [ ["cas\u0131na", -1, -1], ["cesine", -1, -1] ]; /** @const */ var a_20 = [ ["di", -1, -1], ["ti", -1, -1], ["dik", -1, -1], ["tik", -1, -1], ["duk", -1, -1], ["tuk", -1, -1], ["d\u00FCk", -1, -1], ["t\u00FCk", -1, -1], ["d\u0131k", -1, -1], ["t\u0131k", -1, -1], ["dim", -1, -1], ["tim", -1, -1], ["dum", -1, -1], ["tum", -1, -1], ["d\u00FCm", -1, -1], ["t\u00FCm", -1, -1], ["d\u0131m", -1, -1], ["t\u0131m", -1, -1], ["din", -1, -1], ["tin", -1, -1], ["dun", -1, -1], ["tun", -1, -1], ["d\u00FCn", -1, -1], ["t\u00FCn", -1, -1], ["d\u0131n", -1, -1], ["t\u0131n", -1, -1], ["du", -1, -1], ["tu", -1, -1], ["d\u00FC", -1, -1], ["t\u00FC", -1, -1], ["d\u0131", -1, -1], ["t\u0131", -1, -1] ]; /** @const */ var a_21 = [ ["sa", -1, -1], ["se", -1, -1], ["sak", -1, -1], ["sek", -1, -1], ["sam", -1, -1], ["sem", -1, -1], ["san", -1, -1], ["sen", -1, -1] ]; /** @const */ var a_22 = [ ["mi\u015F", -1, -1], ["mu\u015F", -1, -1], ["m\u00FC\u015F", -1, -1], ["m\u0131\u015F", -1, -1] ]; /** @const */ var a_23 = [ ["b", -1, 1], ["c", -1, 2], ["d", -1, 3], ["\u011F", -1, 4] ]; /** @const */ var /** Array<int> */ g_vowel = [17, 65, 16, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 32, 8, 0, 0, 0, 0, 0, 0, 1]; /** @const */ var /** Array<int> */ g_U = [1, 16, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 8, 0, 0, 0, 0, 0, 0, 1]; /** @const */ var /** Array<int> */ g_vowel1 = [1, 64, 16, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1]; /** @const */ var /** Array<int> */ g_vowel2 = [17, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 130]; /** @const */ var /** Array<int> */ g_vowel3 = [1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1]; /** @const */ var /** Array<int> */ g_vowel4 = [17]; /** @const */ var /** Array<int> */ g_vowel5 = [65]; /** @const */ var /** Array<int> */ g_vowel6 = [65]; var /** boolean */ B_continue_stemming_noun_suffixes = false; /** @return {boolean} */ function r_check_vowel_harmony() { var /** number */ v_1 = base.limit - base.cursor; golab0: while(true) { var /** number */ v_2 = base.limit - base.cursor; lab1: { if (!(base.in_grouping_b(g_vowel, 97, 305))) { break lab1; } base.cursor = base.limit - v_2; break golab0; } base.cursor = base.limit - v_2; if (base.cursor <= base.limit_backward) { return false; } base.cursor--; } lab2: { var /** number */ v_3 = base.limit - base.cursor; lab3: { if (!(base.eq_s_b("a"))) { break lab3; } golab4: while(true) { var /** number */ v_4 = base.limit - base.cursor; lab5: { if (!(base.in_grouping_b(g_vowel1, 97, 305))) { break lab5; } base.cursor = base.limit - v_4; break golab4; } base.cursor = base.limit - v_4; if (base.cursor <= base.limit_backward) { break lab3; } base.cursor--; } break lab2; } base.cursor = base.limit - v_3; lab6: { if (!(base.eq_s_b("e"))) { break lab6; } golab7: while(true) { var /** number */ v_5 = base.limit - base.cursor; lab8: { if (!(base.in_grouping_b(g_vowel2, 101, 252))) { break lab8; } base.cursor = base.limit - v_5; break golab7; } base.cursor = base.limit - v_5; if (base.cursor <= base.limit_backward) { break lab6; } base.cursor--; } break lab2; } base.cursor = base.limit - v_3; lab9: { if (!(base.eq_s_b("\u0131"))) { break lab9; } golab10: while(true) { var /** number */ v_6 = base.limit - base.cursor; lab11: { if (!(base.in_grouping_b(g_vowel3, 97, 305))) { break lab11; } base.cursor = base.limit - v_6; break golab10; } base.cursor = base.limit - v_6; if (base.cursor <= base.limit_backward) { break lab9; } base.cursor--; } break lab2; } base.cursor = base.limit - v_3; lab12: { if (!(base.eq_s_b("i"))) { break lab12; } golab13: while(true) { var /** number */ v_7 = base.limit - base.cursor; lab14: { if (!(base.in_grouping_b(g_vowel4, 101, 105))) { break lab14; } base.cursor = base.limit - v_7; break golab13; } base.cursor = base.limit - v_7; if (base.cursor <= base.limit_backward) { break lab12; } base.cursor--; } break lab2; } base.cursor = base.limit - v_3; lab15: { if (!(base.eq_s_b("o"))) { break lab15; } golab16: while(true) { var /** number */ v_8 = base.limit - base.cursor; lab17: { if (!(base.in_grouping_b(g_vowel5, 111, 117))) { break lab17; } base.cursor = base.limit - v_8; break golab16; } base.cursor = base.limit - v_8; if (base.cursor <= base.limit_backward) { break lab15; } base.cursor--; } break lab2; } base.cursor = base.limit - v_3; lab18: { if (!(base.eq_s_b("\u00F6"))) { break lab18; } golab19: while(true) { var /** number */ v_9 = base.limit - base.cursor; lab20: { if (!(base.in_grouping_b(g_vowel6, 246, 252))) { break lab20; } base.cursor = base.limit - v_9; break golab19; } base.cursor = base.limit - v_9; if (base.cursor <= base.limit_backward) { break lab18; } base.cursor--; } break lab2; } base.cursor = base.limit - v_3; lab21: { if (!(base.eq_s_b("u"))) { break lab21; } golab22: while(true) { var /** number */ v_10 = base.limit - base.cursor; lab23: { if (!(base.in_grouping_b(g_vowel5, 111, 117))) { break lab23; } base.cursor = base.limit - v_10; break golab22; } base.cursor = base.limit - v_10; if (base.cursor <= base.limit_backward) { break lab21; } base.cursor--; } break lab2; } base.cursor = base.limit - v_3; if (!(base.eq_s_b("\u00FC"))) { return false; } golab24: while(true) { var /** number */ v_11 = base.limit - base.cursor; lab25: { if (!(base.in_grouping_b(g_vowel6, 246, 252))) { break lab25; } base.cursor = base.limit - v_11; break golab24; } base.cursor = base.limit - v_11; if (base.cursor <= base.limit_backward) { return false; } base.cursor--; } } base.cursor = base.limit - v_1; return true; }; /** @return {boolean} */ function r_mark_suffix_with_optional_n_consonant() { lab0: { var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("n"))) { break lab1; } var /** number */ v_2 = base.limit - base.cursor; if (!(base.in_grouping_b(g_vowel, 97, 305))) { break lab1; } base.cursor = base.limit - v_2; break lab0; } base.cursor = base.limit - v_1; { var /** number */ v_3 = base.limit - base.cursor; lab2: { var /** number */ v_4 = base.limit - base.cursor; if (!(base.eq_s_b("n"))) { break lab2; } base.cursor = base.limit - v_4; return false; } base.cursor = base.limit - v_3; } var /** number */ v_5 = base.limit - base.cursor; if (base.cursor <= base.limit_backward) { return false; } base.cursor--; if (!(base.in_grouping_b(g_vowel, 97, 305))) { return false; } base.cursor = base.limit - v_5; } return true; }; /** @return {boolean} */ function r_mark_suffix_with_optional_s_consonant() { lab0: { var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("s"))) { break lab1; } var /** number */ v_2 = base.limit - base.cursor; if (!(base.in_grouping_b(g_vowel, 97, 305))) { break lab1; } base.cursor = base.limit - v_2; break lab0; } base.cursor = base.limit - v_1; { var /** number */ v_3 = base.limit - base.cursor; lab2: { var /** number */ v_4 = base.limit - base.cursor; if (!(base.eq_s_b("s"))) { break lab2; } base.cursor = base.limit - v_4; return false; } base.cursor = base.limit - v_3; } var /** number */ v_5 = base.limit - base.cursor; if (base.cursor <= base.limit_backward) { return false; } base.cursor--; if (!(base.in_grouping_b(g_vowel, 97, 305))) { return false; } base.cursor = base.limit - v_5; } return true; }; /** @return {boolean} */ function r_mark_suffix_with_optional_y_consonant() { lab0: { var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("y"))) { break lab1; } var /** number */ v_2 = base.limit - base.cursor; if (!(base.in_grouping_b(g_vowel, 97, 305))) { break lab1; } base.cursor = base.limit - v_2; break lab0; } base.cursor = base.limit - v_1; { var /** number */ v_3 = base.limit - base.cursor; lab2: { var /** number */ v_4 = base.limit - base.cursor; if (!(base.eq_s_b("y"))) { break lab2; } base.cursor = base.limit - v_4; return false; } base.cursor = base.limit - v_3; } var /** number */ v_5 = base.limit - base.cursor; if (base.cursor <= base.limit_backward) { return false; } base.cursor--; if (!(base.in_grouping_b(g_vowel, 97, 305))) { return false; } base.cursor = base.limit - v_5; } return true; }; /** @return {boolean} */ function r_mark_suffix_with_optional_U_vowel() { lab0: { var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!(base.in_grouping_b(g_U, 105, 305))) { break lab1; } var /** number */ v_2 = base.limit - base.cursor; if (!(base.out_grouping_b(g_vowel, 97, 305))) { break lab1; } base.cursor = base.limit - v_2; break lab0; } base.cursor = base.limit - v_1; { var /** number */ v_3 = base.limit - base.cursor; lab2: { var /** number */ v_4 = base.limit - base.cursor; if (!(base.in_grouping_b(g_U, 105, 305))) { break lab2; } base.cursor = base.limit - v_4; return false; } base.cursor = base.limit - v_3; } var /** number */ v_5 = base.limit - base.cursor; if (base.cursor <= base.limit_backward) { return false; } base.cursor--; if (!(base.out_grouping_b(g_vowel, 97, 305))) { return false; } base.cursor = base.limit - v_5; } return true; }; /** @return {boolean} */ function r_mark_possessives() { if (base.find_among_b(a_0) == 0) { return false; } if (!r_mark_suffix_with_optional_U_vowel()) { return false; } return true; }; /** @return {boolean} */ function r_mark_sU() { if (!r_check_vowel_harmony()) { return false; } if (!(base.in_grouping_b(g_U, 105, 305))) { return false; } if (!r_mark_suffix_with_optional_s_consonant()) { return false; } return true; }; /** @return {boolean} */ function r_mark_lArI() { if (base.find_among_b(a_1) == 0) { return false; } return true; }; /** @return {boolean} */ function r_mark_yU() { if (!r_check_vowel_harmony()) { return false; } if (!(base.in_grouping_b(g_U, 105, 305))) { return false; } if (!r_mark_suffix_with_optional_y_consonant()) { return false; } return true; }; /** @return {boolean} */ function r_mark_nU() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_2) == 0) { return false; } return true; }; /** @return {boolean} */ function r_mark_nUn() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_3) == 0) { return false; } if (!r_mark_suffix_with_optional_n_consonant()) { return false; } return true; }; /** @return {boolean} */ function r_mark_yA() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_4) == 0) { return false; } if (!r_mark_suffix_with_optional_y_consonant()) { return false; } return true; }; /** @return {boolean} */ function r_mark_nA() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_5) == 0) { return false; } return true; }; /** @return {boolean} */ function r_mark_DA() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_6) == 0) { return false; } return true; }; /** @return {boolean} */ function r_mark_ndA() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_7) == 0) { return false; } return true; }; /** @return {boolean} */ function r_mark_DAn() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_8) == 0) { return false; } return true; }; /** @return {boolean} */ function r_mark_ndAn() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_9) == 0) { return false; } return true; }; /** @return {boolean} */ function r_mark_ylA() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_10) == 0) { return false; } if (!r_mark_suffix_with_optional_y_consonant()) { return false; } return true; }; /** @return {boolean} */ function r_mark_ki() { if (!(base.eq_s_b("ki"))) { return false; } return true; }; /** @return {boolean} */ function r_mark_ncA() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_11) == 0) { return false; } if (!r_mark_suffix_with_optional_n_consonant()) { return false; } return true; }; /** @return {boolean} */ function r_mark_yUm() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_12) == 0) { return false; } if (!r_mark_suffix_with_optional_y_consonant()) { return false; } return true; }; /** @return {boolean} */ function r_mark_sUn() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_13) == 0) { return false; } return true; }; /** @return {boolean} */ function r_mark_yUz() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_14) == 0) { return false; } if (!r_mark_suffix_with_optional_y_consonant()) { return false; } return true; }; /** @return {boolean} */ function r_mark_sUnUz() { if (base.find_among_b(a_15) == 0) { return false; } return true; }; /** @return {boolean} */ function r_mark_lAr() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_16) == 0) { return false; } return true; }; /** @return {boolean} */ function r_mark_nUz() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_17) == 0) { return false; } return true; }; /** @return {boolean} */ function r_mark_DUr() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_18) == 0) { return false; } return true; }; /** @return {boolean} */ function r_mark_cAsInA() { if (base.find_among_b(a_19) == 0) { return false; } return true; }; /** @return {boolean} */ function r_mark_yDU() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_20) == 0) { return false; } if (!r_mark_suffix_with_optional_y_consonant()) { return false; } return true; }; /** @return {boolean} */ function r_mark_ysA() { if (base.find_among_b(a_21) == 0) { return false; } if (!r_mark_suffix_with_optional_y_consonant()) { return false; } return true; }; /** @return {boolean} */ function r_mark_ymUs_() { if (!r_check_vowel_harmony()) { return false; } if (base.find_among_b(a_22) == 0) { return false; } if (!r_mark_suffix_with_optional_y_consonant()) { return false; } return true; }; /** @return {boolean} */ function r_mark_yken() { if (!(base.eq_s_b("ken"))) { return false; } if (!r_mark_suffix_with_optional_y_consonant()) { return false; } return true; }; /** @return {boolean} */ function r_stem_nominal_verb_suffixes() { base.ket = base.cursor; B_continue_stemming_noun_suffixes = true; lab0: { var /** number */ v_1 = base.limit - base.cursor; lab1: { lab2: { var /** number */ v_2 = base.limit - base.cursor; lab3: { if (!r_mark_ymUs_()) { break lab3; } break lab2; } base.cursor = base.limit - v_2; lab4: { if (!r_mark_yDU()) { break lab4; } break lab2; } base.cursor = base.limit - v_2; lab5: { if (!r_mark_ysA()) { break lab5; } break lab2; } base.cursor = base.limit - v_2; if (!r_mark_yken()) { break lab1; } } break lab0; } base.cursor = base.limit - v_1; lab6: { if (!r_mark_cAsInA()) { break lab6; } lab7: { var /** number */ v_3 = base.limit - base.cursor; lab8: { if (!r_mark_sUnUz()) { break lab8; } break lab7; } base.cursor = base.limit - v_3; lab9: { if (!r_mark_lAr()) { break lab9; } break lab7; } base.cursor = base.limit - v_3; lab10: { if (!r_mark_yUm()) { break lab10; } break lab7; } base.cursor = base.limit - v_3; lab11: { if (!r_mark_sUn()) { break lab11; } break lab7; } base.cursor = base.limit - v_3; lab12: { if (!r_mark_yUz()) { break lab12; } break lab7; } base.cursor = base.limit - v_3; } if (!r_mark_ymUs_()) { break lab6; } break lab0; } base.cursor = base.limit - v_1; lab13: { if (!r_mark_lAr()) { break lab13; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_4 = base.limit - base.cursor; lab14: { base.ket = base.cursor; lab15: { var /** number */ v_5 = base.limit - base.cursor; lab16: { if (!r_mark_DUr()) { break lab16; } break lab15; } base.cursor = base.limit - v_5; lab17: { if (!r_mark_yDU()) { break lab17; } break lab15; } base.cursor = base.limit - v_5; lab18: { if (!r_mark_ysA()) { break lab18; } break lab15; } base.cursor = base.limit - v_5; if (!r_mark_ymUs_()) { base.cursor = base.limit - v_4; break lab14; } } } B_continue_stemming_noun_suffixes = false; break lab0; } base.cursor = base.limit - v_1; lab19: { if (!r_mark_nUz()) { break lab19; } lab20: { var /** number */ v_6 = base.limit - base.cursor; lab21: { if (!r_mark_yDU()) { break lab21; } break lab20; } base.cursor = base.limit - v_6; if (!r_mark_ysA()) { break lab19; } } break lab0; } base.cursor = base.limit - v_1; lab22: { lab23: { var /** number */ v_7 = base.limit - base.cursor; lab24: { if (!r_mark_sUnUz()) { break lab24; } break lab23; } base.cursor = base.limit - v_7; lab25: { if (!r_mark_yUz()) { break lab25; } break lab23; } base.cursor = base.limit - v_7; lab26: { if (!r_mark_sUn()) { break lab26; } break lab23; } base.cursor = base.limit - v_7; if (!r_mark_yUm()) { break lab22; } } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_8 = base.limit - base.cursor; lab27: { base.ket = base.cursor; if (!r_mark_ymUs_()) { base.cursor = base.limit - v_8; break lab27; } } break lab0; } base.cursor = base.limit - v_1; if (!r_mark_DUr()) { return false; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_9 = base.limit - base.cursor; lab28: { base.ket = base.cursor; lab29: { var /** number */ v_10 = base.limit - base.cursor; lab30: { if (!r_mark_sUnUz()) { break lab30; } break lab29; } base.cursor = base.limit - v_10; lab31: { if (!r_mark_lAr()) { break lab31; } break lab29; } base.cursor = base.limit - v_10; lab32: { if (!r_mark_yUm()) { break lab32; } break lab29; } base.cursor = base.limit - v_10; lab33: { if (!r_mark_sUn()) { break lab33; } break lab29; } base.cursor = base.limit - v_10; lab34: { if (!r_mark_yUz()) { break lab34; } break lab29; } base.cursor = base.limit - v_10; } if (!r_mark_ymUs_()) { base.cursor = base.limit - v_9; break lab28; } } } base.bra = base.cursor; if (!base.slice_del()) { return false; } return true; }; /** @return {boolean} */ function r_stem_suffix_chain_before_ki() { base.ket = base.cursor; if (!r_mark_ki()) { return false; } lab0: { var /** number */ v_1 = base.limit - base.cursor; lab1: { if (!r_mark_DA()) { break lab1; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_2 = base.limit - base.cursor; lab2: { base.ket = base.cursor; lab3: { var /** number */ v_3 = base.limit - base.cursor; lab4: { if (!r_mark_lAr()) { break lab4; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_4 = base.limit - base.cursor; lab5: { if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_4; break lab5; } } break lab3; } base.cursor = base.limit - v_3; if (!r_mark_possessives()) { base.cursor = base.limit - v_2; break lab2; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_5 = base.limit - base.cursor; lab6: { base.ket = base.cursor; if (!r_mark_lAr()) { base.cursor = base.limit - v_5; break lab6; } base.bra = base.cursor; if (!base.slice_del()) { return false; } if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_5; break lab6; } } } } break lab0; } base.cursor = base.limit - v_1; lab7: { if (!r_mark_nUn()) { break lab7; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_6 = base.limit - base.cursor; lab8: { base.ket = base.cursor; lab9: { var /** number */ v_7 = base.limit - base.cursor; lab10: { if (!r_mark_lArI()) { break lab10; } base.bra = base.cursor; if (!base.slice_del()) { return false; } break lab9; } base.cursor = base.limit - v_7; lab11: { base.ket = base.cursor; lab12: { var /** number */ v_8 = base.limit - base.cursor; lab13: { if (!r_mark_possessives()) { break lab13; } break lab12; } base.cursor = base.limit - v_8; if (!r_mark_sU()) { break lab11; } } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_9 = base.limit - base.cursor; lab14: { base.ket = base.cursor; if (!r_mark_lAr()) { base.cursor = base.limit - v_9; break lab14; } base.bra = base.cursor; if (!base.slice_del()) { return false; } if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_9; break lab14; } } break lab9; } base.cursor = base.limit - v_7; if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_6; break lab8; } } } break lab0; } base.cursor = base.limit - v_1; if (!r_mark_ndA()) { return false; } lab15: { var /** number */ v_10 = base.limit - base.cursor; lab16: { if (!r_mark_lArI()) { break lab16; } base.bra = base.cursor; if (!base.slice_del()) { return false; } break lab15; } base.cursor = base.limit - v_10; lab17: { if (!r_mark_sU()) { break lab17; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_11 = base.limit - base.cursor; lab18: { base.ket = base.cursor; if (!r_mark_lAr()) { base.cursor = base.limit - v_11; break lab18; } base.bra = base.cursor; if (!base.slice_del()) { return false; } if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_11; break lab18; } } break lab15; } base.cursor = base.limit - v_10; if (!r_stem_suffix_chain_before_ki()) { return false; } } } return true; }; /** @return {boolean} */ function r_stem_noun_suffixes() { lab0: { var /** number */ v_1 = base.limit - base.cursor; lab1: { base.ket = base.cursor; if (!r_mark_lAr()) { break lab1; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_2 = base.limit - base.cursor; lab2: { if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_2; break lab2; } } break lab0; } base.cursor = base.limit - v_1; lab3: { base.ket = base.cursor; if (!r_mark_ncA()) { break lab3; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_3 = base.limit - base.cursor; lab4: { lab5: { var /** number */ v_4 = base.limit - base.cursor; lab6: { base.ket = base.cursor; if (!r_mark_lArI()) { break lab6; } base.bra = base.cursor; if (!base.slice_del()) { return false; } break lab5; } base.cursor = base.limit - v_4; lab7: { base.ket = base.cursor; lab8: { var /** number */ v_5 = base.limit - base.cursor; lab9: { if (!r_mark_possessives()) { break lab9; } break lab8; } base.cursor = base.limit - v_5; if (!r_mark_sU()) { break lab7; } } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_6 = base.limit - base.cursor; lab10: { base.ket = base.cursor; if (!r_mark_lAr()) { base.cursor = base.limit - v_6; break lab10; } base.bra = base.cursor; if (!base.slice_del()) { return false; } if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_6; break lab10; } } break lab5; } base.cursor = base.limit - v_4; base.ket = base.cursor; if (!r_mark_lAr()) { base.cursor = base.limit - v_3; break lab4; } base.bra = base.cursor; if (!base.slice_del()) { return false; } if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_3; break lab4; } } } break lab0; } base.cursor = base.limit - v_1; lab11: { base.ket = base.cursor; lab12: { var /** number */ v_7 = base.limit - base.cursor; lab13: { if (!r_mark_ndA()) { break lab13; } break lab12; } base.cursor = base.limit - v_7; if (!r_mark_nA()) { break lab11; } } lab14: { var /** number */ v_8 = base.limit - base.cursor; lab15: { if (!r_mark_lArI()) { break lab15; } base.bra = base.cursor; if (!base.slice_del()) { return false; } break lab14; } base.cursor = base.limit - v_8; lab16: { if (!r_mark_sU()) { break lab16; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_9 = base.limit - base.cursor; lab17: { base.ket = base.cursor; if (!r_mark_lAr()) { base.cursor = base.limit - v_9; break lab17; } base.bra = base.cursor; if (!base.slice_del()) { return false; } if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_9; break lab17; } } break lab14; } base.cursor = base.limit - v_8; if (!r_stem_suffix_chain_before_ki()) { break lab11; } } break lab0; } base.cursor = base.limit - v_1; lab18: { base.ket = base.cursor; lab19: { var /** number */ v_10 = base.limit - base.cursor; lab20: { if (!r_mark_ndAn()) { break lab20; } break lab19; } base.cursor = base.limit - v_10; if (!r_mark_nU()) { break lab18; } } lab21: { var /** number */ v_11 = base.limit - base.cursor; lab22: { if (!r_mark_sU()) { break lab22; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_12 = base.limit - base.cursor; lab23: { base.ket = base.cursor; if (!r_mark_lAr()) { base.cursor = base.limit - v_12; break lab23; } base.bra = base.cursor; if (!base.slice_del()) { return false; } if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_12; break lab23; } } break lab21; } base.cursor = base.limit - v_11; if (!r_mark_lArI()) { break lab18; } } break lab0; } base.cursor = base.limit - v_1; lab24: { base.ket = base.cursor; if (!r_mark_DAn()) { break lab24; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_13 = base.limit - base.cursor; lab25: { base.ket = base.cursor; lab26: { var /** number */ v_14 = base.limit - base.cursor; lab27: { if (!r_mark_possessives()) { break lab27; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_15 = base.limit - base.cursor; lab28: { base.ket = base.cursor; if (!r_mark_lAr()) { base.cursor = base.limit - v_15; break lab28; } base.bra = base.cursor; if (!base.slice_del()) { return false; } if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_15; break lab28; } } break lab26; } base.cursor = base.limit - v_14; lab29: { if (!r_mark_lAr()) { break lab29; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_16 = base.limit - base.cursor; lab30: { if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_16; break lab30; } } break lab26; } base.cursor = base.limit - v_14; if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_13; break lab25; } } } break lab0; } base.cursor = base.limit - v_1; lab31: { base.ket = base.cursor; lab32: { var /** number */ v_17 = base.limit - base.cursor; lab33: { if (!r_mark_nUn()) { break lab33; } break lab32; } base.cursor = base.limit - v_17; if (!r_mark_ylA()) { break lab31; } } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_18 = base.limit - base.cursor; lab34: { lab35: { var /** number */ v_19 = base.limit - base.cursor; lab36: { base.ket = base.cursor; if (!r_mark_lAr()) { break lab36; } base.bra = base.cursor; if (!base.slice_del()) { return false; } if (!r_stem_suffix_chain_before_ki()) { break lab36; } break lab35; } base.cursor = base.limit - v_19; lab37: { base.ket = base.cursor; lab38: { var /** number */ v_20 = base.limit - base.cursor; lab39: { if (!r_mark_possessives()) { break lab39; } break lab38; } base.cursor = base.limit - v_20; if (!r_mark_sU()) { break lab37; } } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_21 = base.limit - base.cursor; lab40: { base.ket = base.cursor; if (!r_mark_lAr()) { base.cursor = base.limit - v_21; break lab40; } base.bra = base.cursor; if (!base.slice_del()) { return false; } if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_21; break lab40; } } break lab35; } base.cursor = base.limit - v_19; if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_18; break lab34; } } } break lab0; } base.cursor = base.limit - v_1; lab41: { base.ket = base.cursor; if (!r_mark_lArI()) { break lab41; } base.bra = base.cursor; if (!base.slice_del()) { return false; } break lab0; } base.cursor = base.limit - v_1; lab42: { if (!r_stem_suffix_chain_before_ki()) { break lab42; } break lab0; } base.cursor = base.limit - v_1; lab43: { base.ket = base.cursor; lab44: { var /** number */ v_22 = base.limit - base.cursor; lab45: { if (!r_mark_DA()) { break lab45; } break lab44; } base.cursor = base.limit - v_22; lab46: { if (!r_mark_yU()) { break lab46; } break lab44; } base.cursor = base.limit - v_22; if (!r_mark_yA()) { break lab43; } } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_23 = base.limit - base.cursor; lab47: { base.ket = base.cursor; lab48: { var /** number */ v_24 = base.limit - base.cursor; lab49: { if (!r_mark_possessives()) { break lab49; } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_25 = base.limit - base.cursor; lab50: { base.ket = base.cursor; if (!r_mark_lAr()) { base.cursor = base.limit - v_25; break lab50; } } break lab48; } base.cursor = base.limit - v_24; if (!r_mark_lAr()) { base.cursor = base.limit - v_23; break lab47; } } base.bra = base.cursor; if (!base.slice_del()) { return false; } base.ket = base.cursor; if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_23; break lab47; } } break lab0; } base.cursor = base.limit - v_1; base.ket = base.cursor; lab51: { var /** number */ v_26 = base.limit - base.cursor; lab52: { if (!r_mark_possessives()) { break lab52; } break lab51; } base.cursor = base.limit - v_26; if (!r_mark_sU()) { return false; } } base.bra = base.cursor; if (!base.slice_del()) { return false; } var /** number */ v_27 = base.limit - base.cursor; lab53: { base.ket = base.cursor; if (!r_mark_lAr()) { base.cursor = base.limit - v_27; break lab53; } base.bra = base.cursor; if (!base.slice_del()) { return false; } if (!r_stem_suffix_chain_before_ki()) { base.cursor = base.limit - v_27; break lab53; } } } return true; }; /** @return {boolean} */ function r_post_process_last_consonants() { var /** number */ among_var; base.ket = base.cursor; among_var = base.find_among_b(a_23); if (among_var == 0) { return false; } base.bra = base.cursor; switch (among_var) { case 1: if (!base.slice_from("p")) { return false; } break; case 2: if (!base.slice_from("\u00E7")) { return false; } break; case 3: if (!base.slice_from("t")) { return false; } break; case 4: if (!base.slice_from("k")) { return false; } break; } return true; }; /** @return {boolean} */ function r_append_U_to_stems_ending_with_d_or_g() { var /** number */ v_1 = base.limit - base.cursor; lab0: { var /** number */ v_2 = base.limit - base.cursor; lab1: { if (!(base.eq_s_b("d"))) { break lab1; } break lab0; } base.cursor = base.limit - v_2; if (!(base.eq_s_b("g"))) { return false; } } base.cursor = base.limit - v_1; lab2: { var /** number */ v_3 = base.limit - base.cursor; lab3: { var /** number */ v_4 = base.limit - base.cursor; golab4: while(true) { var /** number */ v_5 = base.limit - base.cursor; lab5: { if (!(base.in_grouping_b(g_vowel, 97, 305))) { break lab5; } base.cursor = base.limit - v_5; break golab4; } base.cursor = base.limit - v_5; if (base.cursor <= base.limit_backward) { break lab3; } base.cursor--; } lab6: { var /** number */ v_6 = base.limit - base.cursor; lab7: { if (!(base.eq_s_b("a"))) { break lab7; } break lab6; } base.cursor = base.limit - v_6; if (!(base.eq_s_b("\u0131"))) { break lab3; } } base.cursor = base.limit - v_4; { var /** number */ c1 = base.cursor; base.insert(base.cursor, base.cursor, "\u0131"); base.cursor = c1; } break lab2; } base.cursor = base.limit - v_3; lab8: { var /** number */ v_7 = base.limit - base.cursor; golab9: while(true) { var /** number */ v_8 = base.limit - base.cursor; lab10: { if (!(base.in_grouping_b(g_vowel, 97, 305))) { break lab10; } base.cursor = base.limit - v_8; break golab9; } base.cursor = base.limit - v_8; if (base.cursor <= base.limit_backward) { break lab8; } base.cursor--; } lab11: { var /** number */ v_9 = base.limit - base.cursor; lab12: { if (!(base.eq_s_b("e"))) { break lab12; } break lab11; } base.cursor = base.limit - v_9; if (!(base.eq_s_b("i"))) { break lab8; } } base.cursor = base.limit - v_7; { var /** number */ c2 = base.cursor; base.insert(base.cursor, base.cursor, "i"); base.cursor = c2; } break lab2; } base.cursor = base.limit - v_3; lab13: { var /** number */ v_10 = base.limit - base.cursor; golab14: while(true) { var /** number */ v_11 = base.limit - base.cursor; lab15: { if (!(base.in_grouping_b(g_vowel, 97, 305))) { break lab15; } base.cursor = base.limit - v_11; break golab14; } base.cursor = base.limit - v_11; if (base.cursor <= base.limit_backward) { break lab13; } base.cursor--; } lab16: { var /** number */ v_12 = base.limit - base.cursor; lab17: { if (!(base.eq_s_b("o"))) { break lab17; } break lab16; } base.cursor = base.limit - v_12; if (!(base.eq_s_b("u"))) { break lab13; } } base.cursor = base.limit - v_10; { var /** number */ c3 = base.cursor; base.insert(base.cursor, base.cursor, "u"); base.cursor = c3; } break lab2; } base.cursor = base.limit - v_3; var /** number */ v_13 = base.limit - base.cursor; golab18: while(true) { var /** number */ v_14 = base.limit - base.cursor; lab19: { if (!(base.in_grouping_b(g_vowel, 97, 305))) { break lab19; } base.cursor = base.limit - v_14; break golab18; } base.cursor = base.limit - v_14; if (base.cursor <= base.limit_backward) { return false; } base.cursor--; } lab20: { var /** number */ v_15 = base.limit - base.cursor; lab21: { if (!(base.eq_s_b("\u00F6"))) { break lab21; } break lab20; } base.cursor = base.limit - v_15; if (!(base.eq_s_b("\u00FC"))) { return false; } } base.cursor = base.limit - v_13; { var /** number */ c4 = base.cursor; base.insert(base.cursor, base.cursor, "\u00FC"); base.cursor = c4; } } return true; }; /** @return {boolean} */ function r_is_reserved_word() { if (!(base.eq_s_b("ad"))) { return false; } var /** number */ v_1 = base.limit - base.cursor; lab0: { if (!(base.eq_s_b("soy"))) { base.cursor = base.limit - v_1; break lab0; } } if (base.cursor > base.limit_backward) { return false; } return true; }; /** @return {boolean} */ function r_more_than_one_syllable_word() { var /** number */ v_1 = base.cursor; { var v_2 = 2; while(true) { var /** number */ v_3 = base.cursor; lab0: { golab1: while(true) { lab2: { if (!(base.in_grouping(g_vowel, 97, 305))) { break lab2; } break golab1; } if (base.cursor >= base.limit) { break lab0; } base.cursor++; } v_2--; continue; } base.cursor = v_3; break; } if (v_2 > 0) { return false; } } base.cursor = v_1; return true; }; /** @return {boolean} */ function r_postlude() { base.limit_backward = base.cursor; base.cursor = base.limit; { var /** number */ v_1 = base.limit - base.cursor; lab0: { if (!r_is_reserved_word()) { break lab0; } return false; } base.cursor = base.limit - v_1; } var /** number */ v_2 = base.limit - base.cursor; r_append_U_to_stems_ending_with_d_or_g(); base.cursor = base.limit - v_2; var /** number */ v_3 = base.limit - base.cursor; r_post_process_last_consonants(); base.cursor = base.limit - v_3; base.cursor = base.limit_backward; return true; }; this.stem = /** @return {boolean} */ function() { if (!r_more_than_one_syllable_word()) { return false; } base.limit_backward = base.cursor; base.cursor = base.limit; var /** number */ v_1 = base.limit - base.cursor; r_stem_nominal_verb_suffixes(); base.cursor = base.limit - v_1; if (!B_continue_stemming_noun_suffixes) { return false; } var /** number */ v_2 = base.limit - base.cursor; r_stem_noun_suffixes(); base.cursor = base.limit - v_2; base.cursor = base.limit_backward; if (!r_postlude()) { return false; } return true; }; /**@return{string}*/ this['stemWord'] = function(/**string*/word) { base.setCurrent(word); this.stem(); return base.getCurrent(); }; }; �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/pt.py��������������������������������������������������������������������0000644�0000766�0000024�00000011247�00000000000�016113� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.pt ~~~~~~~~~~~~~~~~ Portuguese search language: includes the JS Portuguese stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict import snowballstemmer from sphinx.search import SearchLanguage, parse_stop_word portuguese_stopwords = parse_stop_word(''' | source: http://snowball.tartarus.org/algorithms/portuguese/stop.txt de | of, from a | the; to, at; her o | the; him que | who, that e | and do | de + o da | de + a em | in um | a para | for | é from SER com | with não | not, no uma | a os | the; them no | em + o se | himself etc na | em + a por | for mais | more as | the; them dos | de + os como | as, like mas | but | foi from SER ao | a + o ele | he das | de + as | tem from TER à | a + a seu | his sua | her ou | or | ser from SER quando | when muito | much | há from HAV nos | em + os; us já | already, now | está from EST eu | I também | also só | only, just pelo | per + o pela | per + a até | up to isso | that ela | he entre | between | era from SER depois | after sem | without mesmo | same aos | a + os | ter from TER seus | his quem | whom nas | em + as me | me esse | that eles | they | estão from EST você | you | tinha from TER | foram from SER essa | that num | em + um nem | nor suas | her meu | my às | a + as minha | my | têm from TER numa | em + uma pelos | per + os elas | they | havia from HAV | seja from SER qual | which | será from SER nós | we | tenho from TER lhe | to him, her deles | of them essas | those esses | those pelas | per + as este | this | fosse from SER dele | of him | other words. There are many contractions such as naquele = em+aquele, | mo = me+o, but they are rare. | Indefinite article plural forms are also rare. tu | thou te | thee vocês | you (plural) vos | you lhes | to them meus | my minhas teu | thy tua teus tuas nosso | our nossa nossos nossas dela | of her delas | of them esta | this estes | these estas | these aquele | that aquela | that aqueles | those aquelas | those isto | this aquilo | that | forms of estar, to be (not including the infinitive): estou está estamos estão estive esteve estivemos estiveram estava estávamos estavam estivera estivéramos esteja estejamos estejam estivesse estivéssemos estivessem estiver estivermos estiverem | forms of haver, to have (not including the infinitive): hei há havemos hão houve houvemos houveram houvera houvéramos haja hajamos hajam houvesse houvéssemos houvessem houver houvermos houverem houverei houverá houveremos houverão houveria houveríamos houveriam | forms of ser, to be (not including the infinitive): sou somos são era éramos eram fui foi fomos foram fora fôramos seja sejamos sejam fosse fôssemos fossem for formos forem serei será seremos serão seria seríamos seriam | forms of ter, to have (not including the infinitive): tenho tem temos tém tinha tínhamos tinham tive teve tivemos tiveram tivera tivéramos tenha tenhamos tenham tivesse tivéssemos tivessem tiver tivermos tiverem terei terá teremos terão teria teríamos teriam ''') class SearchPortuguese(SearchLanguage): lang = 'pt' language_name = 'Portuguese' js_stemmer_rawcode = 'portuguese-stemmer.js' stopwords = portuguese_stopwords def init(self, options: Dict) -> None: self.stemmer = snowballstemmer.stemmer('portuguese') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/ro.py��������������������������������������������������������������������0000644�0000766�0000024�00000001254�00000000000�016105� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.ro ~~~~~~~~~~~~~~~~ Romanian search language: includes the JS Romanian stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict, Set import snowballstemmer from sphinx.search import SearchLanguage class SearchRomanian(SearchLanguage): lang = 'ro' language_name = 'Romanian' js_stemmer_rawcode = 'romanian-stemmer.js' stopwords: Set[str] = set() def init(self, options: Dict) -> None: self.stemmer = snowballstemmer.stemmer('romanian') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/ru.py��������������������������������������������������������������������0000644�0000766�0000024�00000017540�00000000000�016120� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.ru ~~~~~~~~~~~~~~~~ Russian search language: includes the JS Russian stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict import snowballstemmer from sphinx.search import SearchLanguage, parse_stop_word russian_stopwords = parse_stop_word(''' | source: http://snowball.tartarus.org/algorithms/russian/stop.txt и | and в | in/into во | alternative form не | not что | what/that он | he на | on/onto я | i с | from со | alternative form как | how а | milder form of `no' (but) то | conjunction and form of `that' все | all она | she так | so, thus его | him но | but да | yes/and ты | thou к | towards, by у | around, chez же | intensifier particle вы | you за | beyond, behind бы | conditional/subj. particle по | up to, along только | only ее | her мне | to me было | it was вот | here is/are, particle от | away from меня | me еще | still, yet, more нет | no, there isnt/arent о | about из | out of ему | to him теперь | now когда | when даже | even ну | so, well вдруг | suddenly ли | interrogative particle если | if уже | already, but homonym of `narrower' или | or ни | neither быть | to be был | he was него | prepositional form of его до | up to вас | you accusative нибудь | indef. suffix preceded by hyphen опять | again уж | already, but homonym of `adder' вам | to you сказал | he said ведь | particle `after all' там | there потом | then себя | oneself ничего | nothing ей | to her может | usually with `быть' as `maybe' они | they тут | here где | where есть | there is/are надо | got to, must ней | prepositional form of ей для | for мы | we тебя | thee их | them, their чем | than была | she was сам | self чтоб | in order to без | without будто | as if человек | man, person, one чего | genitive form of `what' раз | once тоже | also себе | to oneself под | beneath жизнь | life будет | will be ж | short form of intensifer particle `же' тогда | then кто | who этот | this говорил | was saying того | genitive form of `that' потому | for that reason этого | genitive form of `this' какой | which совсем | altogether ним | prepositional form of `его', `они' здесь | here этом | prepositional form of `этот' один | one почти | almost мой | my тем | instrumental/dative plural of `тот', `то' чтобы | full form of `in order that' нее | her (acc.) кажется | it seems сейчас | now были | they were куда | where to зачем | why сказать | to say всех | all (acc., gen. preposn. plural) никогда | never сегодня | today можно | possible, one can при | by наконец | finally два | two об | alternative form of `о', about другой | another хоть | even после | after над | above больше | more тот | that one (masc.) через | across, in эти | these нас | us про | about всего | in all, only, of all них | prepositional form of `они' (they) какая | which, feminine много | lots разве | interrogative particle сказала | she said три | three эту | this, acc. fem. sing. моя | my, feminine впрочем | moreover, besides хорошо | good свою | ones own, acc. fem. sing. этой | oblique form of `эта', fem. `this' перед | in front of иногда | sometimes лучше | better чуть | a little том | preposn. form of `that one' нельзя | one must not такой | such a one им | to them более | more всегда | always конечно | of course всю | acc. fem. sing of `all' между | between | b: some paradigms | | personal pronouns | | я меня мне мной [мною] | ты тебя тебе тобой [тобою] | он его ему им [него, нему, ним] | она ее эи ею [нее, нэи, нею] | оно его ему им [него, нему, ним] | | мы нас нам нами | вы вас вам вами | они их им ими [них, ним, ними] | | себя себе собой [собою] | | demonstrative pronouns: этот (this), тот (that) | | этот эта это эти | этого эты это эти | этого этой этого этих | этому этой этому этим | этим этой этим [этою] этими | этом этой этом этих | | тот та то те | того ту то те | того той того тех | тому той тому тем | тем той тем [тою] теми | том той том тех | | determinative pronouns | | (a) весь (all) | | весь вся все все | всего всю все все | всего всей всего всех | всему всей всему всем | всем всей всем [всею] всеми | всем всей всем всех | | (b) сам (himself etc) | | сам сама само сами | самого саму само самих | самого самой самого самих | самому самой самому самим | самим самой самим [самою] самими | самом самой самом самих | | stems of verbs `to be', `to have', `to do' and modal | | быть бы буд быв есть суть | име | дел | мог мож мочь | уме | хоч хот | долж | можн | нужн | нельзя ''') class SearchRussian(SearchLanguage): lang = 'ru' language_name = 'Russian' js_stemmer_rawcode = 'russian-stemmer.js' stopwords = russian_stopwords def init(self, options: Dict) -> None: self.stemmer = snowballstemmer.stemmer('russian') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) ����������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164042.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/sv.py��������������������������������������������������������������������0000644�0000766�0000024�00000006753�00000000000�016126� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.sv ~~~~~~~~~~~~~~~~ Swedish search language: includes the JS Swedish stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict import snowballstemmer from sphinx.search import SearchLanguage, parse_stop_word swedish_stopwords = parse_stop_word(''' | source: http://snowball.tartarus.org/algorithms/swedish/stop.txt och | and det | it, this/that att | to (with infinitive) i | in, at en | a jag | I hon | she som | who, that han | he på | on den | it, this/that med | with var | where, each sig | him(self) etc för | for så | so (also: seed) till | to är | is men | but ett | a om | if; around, about hade | had de | they, these/those av | of icke | not, no mig | me du | you henne | her då | then, when sin | his nu | now har | have inte | inte någon = no one hans | his honom | him skulle | 'sake' hennes | her där | there min | my man | one (pronoun) ej | nor vid | at, by, on (also: vast) kunde | could något | some etc från | from, off ut | out när | when efter | after, behind upp | up vi | we dem | them vara | be vad | what över | over än | than dig | you kan | can sina | his här | here ha | have mot | towards alla | all under | under (also: wonder) någon | some etc eller | or (else) allt | all mycket | much sedan | since ju | why denna | this/that själv | myself, yourself etc detta | this/that åt | to utan | without varit | was hur | how ingen | no mitt | my ni | you bli | to be, become blev | from bli oss | us din | thy dessa | these/those några | some etc deras | their blir | from bli mina | my samma | (the) same vilken | who, that er | you, your sådan | such a vår | our blivit | from bli dess | its inom | within mellan | between sådant | such a varför | why varje | each vilka | who, that ditt | thy vem | who vilket | who, that sitta | his sådana | such a vart | each dina | thy vars | whose vårt | our våra | our ert | your era | your vilkas | whose ''') class SearchSwedish(SearchLanguage): lang = 'sv' language_name = 'Swedish' js_stemmer_rawcode = 'swedish-stemmer.js' stopwords = swedish_stopwords def init(self, options: Dict) -> None: self.stemmer = snowballstemmer.stemmer('swedish') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) ���������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/tr.py��������������������������������������������������������������������0000644�0000766�0000024�00000001246�00000000000�016113� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.tr ~~~~~~~~~~~~~~~~ Turkish search language: includes the JS Turkish stemmer. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from typing import Dict, Set import snowballstemmer from sphinx.search import SearchLanguage class SearchTurkish(SearchLanguage): lang = 'tr' language_name = 'Turkish' js_stemmer_rawcode = 'turkish-stemmer.js' stopwords: Set[str] = set() def init(self, options: Dict) -> None: self.stemmer = snowballstemmer.stemmer('turkish') def stem(self, word: str) -> str: return self.stemmer.stemWord(word.lower()) ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/search/zh.py��������������������������������������������������������������������0000644�0000766�0000024�00000014170�00000000000�016107� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.search.zh ~~~~~~~~~~~~~~~~ Chinese search language: includes routine to split words. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import os import re from typing import Dict, List from sphinx.search import SearchLanguage from sphinx.util.stemmer import get_stemmer try: import jieba JIEBA = True except ImportError: JIEBA = False english_stopwords = set(""" a and are as at be but by for if in into is it near no not of on or such that the their then there these they this to was will with """.split()) js_porter_stemmer = """ /** * Porter Stemmer */ var Stemmer = function() { var step2list = { ational: 'ate', tional: 'tion', enci: 'ence', anci: 'ance', izer: 'ize', bli: 'ble', alli: 'al', entli: 'ent', eli: 'e', ousli: 'ous', ization: 'ize', ation: 'ate', ator: 'ate', alism: 'al', iveness: 'ive', fulness: 'ful', ousness: 'ous', aliti: 'al', iviti: 'ive', biliti: 'ble', logi: 'log' }; var step3list = { icate: 'ic', ative: '', alize: 'al', iciti: 'ic', ical: 'ic', ful: '', ness: '' }; var c = "[^aeiou]"; // consonant var v = "[aeiouy]"; // vowel var C = c + "[^aeiouy]*"; // consonant sequence var V = v + "[aeiou]*"; // vowel sequence var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 var s_v = "^(" + C + ")?" + v; // vowel in stem this.stemWord = function (w) { var stem; var suffix; var firstch; var origword = w; if (w.length < 3) return w; var re; var re2; var re3; var re4; firstch = w.substr(0,1); if (firstch == "y") w = firstch.toUpperCase() + w.substr(1); // Step 1a re = /^(.+?)(ss|i)es$/; re2 = /^(.+?)([^s])s$/; if (re.test(w)) w = w.replace(re,"$1$2"); else if (re2.test(w)) w = w.replace(re2,"$1$2"); // Step 1b re = /^(.+?)eed$/; re2 = /^(.+?)(ed|ing)$/; if (re.test(w)) { var fp = re.exec(w); re = new RegExp(mgr0); if (re.test(fp[1])) { re = /.$/; w = w.replace(re,""); } } else if (re2.test(w)) { var fp = re2.exec(w); stem = fp[1]; re2 = new RegExp(s_v); if (re2.test(stem)) { w = stem; re2 = /(at|bl|iz)$/; re3 = new RegExp("([^aeiouylsz])\\\\1$"); re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); if (re2.test(w)) w = w + "e"; else if (re3.test(w)) { re = /.$/; w = w.replace(re,""); } else if (re4.test(w)) w = w + "e"; } } // Step 1c re = /^(.+?)y$/; if (re.test(w)) { var fp = re.exec(w); stem = fp[1]; re = new RegExp(s_v); if (re.test(stem)) w = stem + "i"; } // Step 2 re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|\ ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; if (re.test(w)) { var fp = re.exec(w); stem = fp[1]; suffix = fp[2]; re = new RegExp(mgr0); if (re.test(stem)) w = stem + step2list[suffix]; } // Step 3 re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; if (re.test(w)) { var fp = re.exec(w); stem = fp[1]; suffix = fp[2]; re = new RegExp(mgr0); if (re.test(stem)) w = stem + step3list[suffix]; } // Step 4 re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|\ iti|ous|ive|ize)$/; re2 = /^(.+?)(s|t)(ion)$/; if (re.test(w)) { var fp = re.exec(w); stem = fp[1]; re = new RegExp(mgr1); if (re.test(stem)) w = stem; } else if (re2.test(w)) { var fp = re2.exec(w); stem = fp[1] + fp[2]; re2 = new RegExp(mgr1); if (re2.test(stem)) w = stem; } // Step 5 re = /^(.+?)e$/; if (re.test(w)) { var fp = re.exec(w); stem = fp[1]; re = new RegExp(mgr1); re2 = new RegExp(meq1); re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) w = stem; } re = /ll$/; re2 = new RegExp(mgr1); if (re.test(w) && re2.test(w)) { re = /.$/; w = w.replace(re,""); } // and turn initial Y back to y if (firstch == "y") w = firstch.toLowerCase() + w.substr(1); return w; } } """ class SearchChinese(SearchLanguage): """ Chinese search implementation """ lang = 'zh' language_name = 'Chinese' js_stemmer_code = js_porter_stemmer stopwords = english_stopwords latin1_letters = re.compile(r'[a-zA-Z0-9_]+') latin_terms: List[str] = [] def init(self, options: Dict) -> None: if JIEBA: dict_path = options.get('dict') if dict_path and os.path.isfile(dict_path): jieba.load_userdict(dict_path) self.stemmer = get_stemmer() def split(self, input: str) -> List[str]: chinese: List[str] = [] if JIEBA: chinese = list(jieba.cut_for_search(input)) latin1 = \ [term.strip() for term in self.latin1_letters.findall(input)] self.latin_terms.extend(latin1) return chinese + latin1 def word_filter(self, stemmed_word: str) -> bool: return len(stemmed_word) > 1 def stem(self, word: str) -> str: # Don't stem Latin words that are long enough to be relevant for search # if not stemmed, but would be too short after being stemmed # avoids some issues with acronyms should_not_be_stemmed = ( word in self.latin_terms and len(word) >= 3 and len(self.stemmer.stem(word.lower())) < 3 ) if should_not_be_stemmed: return word.lower() return self.stemmer.stem(word.lower()) ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/setup_command.py����������������������������������������������������������������0000644�0000766�0000024�00000015560�00000000000�017063� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������""" sphinx.setup_command ~~~~~~~~~~~~~~~~~~~~ Setuptools/distutils commands to assist the building of sphinx documentation. :author: Sebastian Wiesner :contact: basti.wiesner@gmx.net :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import os import sys from distutils.cmd import Command from distutils.errors import DistutilsExecError from io import StringIO from typing import Any, Dict from sphinx.application import Sphinx from sphinx.cmd.build import handle_exception from sphinx.util.console import color_terminal, nocolor from sphinx.util.docutils import docutils_namespace, patch_docutils from sphinx.util.osutil import abspath class BuildDoc(Command): """ Distutils command to build Sphinx documentation. The Sphinx build can then be triggered from distutils, and some Sphinx options can be set in ``setup.py`` or ``setup.cfg`` instead of Sphinx's own configuration file. For instance, from `setup.py`:: # this is only necessary when not using setuptools/distribute from sphinx.setup_command import BuildDoc cmdclass = {'build_sphinx': BuildDoc} name = 'My project' version = '1.2' release = '1.2.0' setup( name=name, author='Bernard Montgomery', version=release, cmdclass=cmdclass, # these are optional and override conf.py settings command_options={ 'build_sphinx': { 'project': ('setup.py', name), 'version': ('setup.py', version), 'release': ('setup.py', release)}}, ) Or add this section in ``setup.cfg``:: [build_sphinx] project = 'My project' version = 1.2 release = 1.2.0 """ description = 'Build Sphinx documentation' user_options = [ ('fresh-env', 'E', 'discard saved environment'), ('all-files', 'a', 'build all files'), ('source-dir=', 's', 'Source directory'), ('build-dir=', None, 'Build directory'), ('config-dir=', 'c', 'Location of the configuration directory'), ('builder=', 'b', 'The builder (or builders) to use. Can be a comma- ' 'or space-separated list. Defaults to "html"'), ('warning-is-error', 'W', 'Turn warning into errors'), ('project=', None, 'The documented project\'s name'), ('version=', None, 'The short X.Y version'), ('release=', None, 'The full version, including alpha/beta/rc tags'), ('today=', None, 'How to format the current date, used as the ' 'replacement for |today|'), ('link-index', 'i', 'Link index.html to the master doc'), ('copyright', None, 'The copyright string'), ('pdb', None, 'Start pdb on exception'), ('verbosity', 'v', 'increase verbosity (can be repeated)'), ('nitpicky', 'n', 'nit-picky mode, warn about all missing references'), ('keep-going', None, 'With -W, keep going when getting warnings'), ] boolean_options = ['fresh-env', 'all-files', 'warning-is-error', 'link-index', 'nitpicky'] def initialize_options(self) -> None: self.fresh_env = self.all_files = False self.pdb = False self.source_dir: str = None self.build_dir: str = None self.builder = 'html' self.warning_is_error = False self.project = '' self.version = '' self.release = '' self.today = '' self.config_dir: str = None self.link_index = False self.copyright = '' # Link verbosity to distutils' (which uses 1 by default). self.verbosity = self.distribution.verbose - 1 # type: ignore self.traceback = False self.nitpicky = False self.keep_going = False def _guess_source_dir(self) -> str: for guess in ('doc', 'docs'): if not os.path.isdir(guess): continue for root, dirnames, filenames in os.walk(guess): if 'conf.py' in filenames: return root return os.curdir def finalize_options(self) -> None: self.ensure_string_list('builder') if self.source_dir is None: self.source_dir = self._guess_source_dir() self.announce('Using source directory %s' % self.source_dir) self.ensure_dirname('source_dir') if self.config_dir is None: self.config_dir = self.source_dir if self.build_dir is None: build = self.get_finalized_command('build') self.build_dir = os.path.join(abspath(build.build_base), 'sphinx') # type: ignore self.doctree_dir = os.path.join(self.build_dir, 'doctrees') self.builder_target_dirs = [ (builder, os.path.join(self.build_dir, builder)) for builder in self.builder] def run(self) -> None: if not color_terminal(): nocolor() if not self.verbose: # type: ignore status_stream = StringIO() else: status_stream = sys.stdout # type: ignore confoverrides: Dict[str, Any] = {} if self.project: confoverrides['project'] = self.project if self.version: confoverrides['version'] = self.version if self.release: confoverrides['release'] = self.release if self.today: confoverrides['today'] = self.today if self.copyright: confoverrides['copyright'] = self.copyright if self.nitpicky: confoverrides['nitpicky'] = self.nitpicky for builder, builder_target_dir in self.builder_target_dirs: app = None try: confdir = self.config_dir or self.source_dir with patch_docutils(confdir), docutils_namespace(): app = Sphinx(self.source_dir, self.config_dir, builder_target_dir, self.doctree_dir, builder, confoverrides, status_stream, freshenv=self.fresh_env, warningiserror=self.warning_is_error, verbosity=self.verbosity, keep_going=self.keep_going) app.build(force_all=self.all_files) if app.statuscode: raise DistutilsExecError( 'caused by %s builder.' % app.builder.name) except Exception as exc: handle_exception(app, self, exc, sys.stderr) if not self.pdb: raise SystemExit(1) from exc if not self.link_index: continue src = app.config.root_doc + app.builder.out_suffix # type: ignore dst = app.builder.get_outfilename('index') # type: ignore os.symlink(src, dst) ������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000033�00000000000�010211� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������27 mtime=1639903107.335369 �����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/templates/����������������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�015642� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5317175 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/templates/apidoc/���������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�017101� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163740.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/templates/apidoc/module.rst_t���������������������������������������������������0000644�0000766�0000024�00000000304�00000000000�021440� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������{%- if show_headings %} {{- [basename, "module"] | join(' ') | e | heading }} {% endif -%} .. automodule:: {{ qualname }} {%- for option in automodule_options %} :{{ option }}: {%- endfor %} ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637164247.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/templates/apidoc/package.rst_t��������������������������������������������������0000644�0000766�0000024�00000002225�00000000000�021552� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������{%- macro automodule(modname, options) -%} .. automodule:: {{ modname }} {%- for option in options %} :{{ option }}: {%- endfor %} {%- endmacro %} {%- macro toctree(docnames) -%} .. toctree:: :maxdepth: {{ maxdepth }} {% for docname in docnames %} {{ docname }} {%- endfor %} {%- endmacro %} {%- if is_namespace %} {{- [pkgname, "namespace"] | join(" ") | e | heading }} {% else %} {{- [pkgname, "package"] | join(" ") | e | heading }} {% endif %} {%- if is_namespace %} .. py:module:: {{ pkgname }} {% endif %} {%- if modulefirst and not is_namespace %} {{ automodule(pkgname, automodule_options) }} {% endif %} {%- if subpackages %} Subpackages ----------- {{ toctree(subpackages) }} {% endif %} {%- if submodules %} Submodules ---------- {% if separatemodules %} {{ toctree(submodules) }} {% else %} {%- for submodule in submodules %} {% if show_headings %} {{- [submodule, "module"] | join(" ") | e | heading(2) }} {% endif %} {{ automodule(submodule, automodule_options) }} {% endfor %} {%- endif %} {%- endif %} {%- if not modulefirst and not is_namespace %} Module contents --------------- {{ automodule(pkgname, automodule_options) }} {% endif %} ���������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1637163740.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/templates/apidoc/toc.rst_t������������������������������������������������������0000644�0000766�0000024�00000000200�00000000000�020733� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������{{ header | heading }} .. toctree:: :maxdepth: {{ maxdepth }} {% for docname in docnames %} {{ docname }} {%- endfor %} ������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000034�00000000000�010212� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������28 mtime=1639903107.5327895 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/templates/epub3/����������������������������������������������������������������0000755�0000766�0000024�00000000000�00000000000�016660� 5����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1609484009.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/templates/epub3/container.xml���������������������������������������������������0000644�0000766�0000024�00000000366�00000000000�021371� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������<?xml version="1.0" encoding="UTF-8"?> <container version="1.0" xmlns="urn:oasis:names:tc:opendocument:xmlns:container"> <rootfiles> <rootfile full-path="content.opf" media-type="application/oebps-package+xml"/> </rootfiles> </container> ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1609484009.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/templates/epub3/content.opf_t���������������������������������������������������0000644�0000766�0000024�00000004117�00000000000�021366� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������<?xml version="1.0" encoding="UTF-8"?> <package xmlns="http://www.idpf.org/2007/opf" version="{{ epub_version }}" xml:lang="{{ lang }}" unique-identifier="{{ uid }}" prefix="ibooks: http://vocabulary.itunes.apple.com/rdf/ibooks/vocabulary-extensions-1.0/"> <metadata xmlns:opf="http://www.idpf.org/2007/opf" xmlns:dc="http://purl.org/dc/elements/1.1/"> <dc:language>{{ lang }}</dc:language> <dc:title>{{ title }}</dc:title> <dc:description>{{ description }}</dc:description> <dc:creator>{{ author }}</dc:creator> <dc:contributor>{{ contributor }}</dc:contributor> <dc:publisher>{{ publisher }}</dc:publisher> <dc:rights>{{ copyright }}</dc:rights> {%- if epub_version == 3.1 %} <dc:identifier id="{{ uid }}" opf:scheme="{{ scheme }}">{{ id }}</dc:identifier> {%- else %} <dc:identifier id="{{ uid }}">{{ id }}</dc:identifier> {%- endif %} <dc:date>{{ date }}</dc:date> <meta property="dcterms:modified">{{ date }}</meta> <meta property="ibooks:version">{{ version }}</meta> <meta property="ibooks:specified-fonts">true</meta> <meta property="ibooks:binding">true</meta> <meta property="ibooks:scroll-axis">{{ ibook_scroll_axis }}</meta> {%- if cover %} <meta name="cover" content="{{ cover }}"/> {%- endif %} </metadata> <manifest> <item id="ncx" href="toc.ncx" media-type="application/x-dtbncx+xml" /> <item id="nav" href="nav.xhtml" media-type="application/xhtml+xml" properties="nav"/> {%- for item in manifest_items %} <item id="{{ item.id }}" href="{{ item.href }}" media-type="{{ item.media_type }}" /> {%- endfor %} </manifest> <spine toc="ncx" page-progression-direction="{{ page_progression_direction }}"> {%- for spine in spines %} {%- if spine.linear %} <itemref idref="{{ spine.idref }}" /> {%- else %} <itemref idref="{{ spine.idref }}" linear="no" /> {%- endif %} {%- endfor %} </spine> <guide> {%- for guide in guides %} <reference type="{{ guide.type }}" title="{{ guide.title }}" href="{{ guide.uri }}" /> {%- endfor %} </guide> </package> �������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1609484009.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/templates/epub3/mimetype��������������������������������������������������������0000644�0000766�0000024�00000000024�00000000000�020430� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������application/epub+zip������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������././@PaxHeader��������������������������������������������������������������������������������������0000000�0000000�0000000�00000000026�00000000000�010213� x����������������������������������������������������������������������������������������������������ustar�00�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������22 mtime=1609484009.0 ����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������Sphinx-4.3.2/sphinx/templates/epub3/nav.xhtml_t�����������������������������������������������������0000644�0000766�0000024�00000001165�00000000000�021050� 0����������������������������������������������������������������������������������������������������ustar�00tkomiya�������������������������staff������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������{%- macro toctree(navlist) -%} <ol> {%- for nav in navlist %} <li> <a href="{{ nav.refuri }}">{{ nav.text }}</a> {%- if nav.children %} {{ toctree(nav.children)|indent(4, true) }} {%- endif %} </li> {%- endfor %} </ol> {%- endmacro -%} <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops" lang="{{ lang }}" xml:lang="{{ lang }}"> <head> <title>{{ toc_locale }} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/sphinx/templates/epub3/toc.ncx_t0000644000076600000240000000134700000000000020507 0ustar00tkomiyastaff{%- macro navPoints(navlist) %} {%- for nav in navlist %} {{ nav.text }} {{ navPoints(nav.children)|indent(2, true) }} {%- endfor %} {%- endmacro -%} {{ title }} {{ navPoints(navpoints)|indent(4, true) }} ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.5329928 Sphinx-4.3.2/sphinx/templates/gettext/0000755000076600000240000000000000000000000017326 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163740.0 Sphinx-4.3.2/sphinx/templates/gettext/message.pot_t0000644000076600000240000000155300000000000022025 0ustar00tkomiyastaff# SOME DESCRIPTIVE TITLE. # Copyright (C) {{ copyright }} # This file is distributed under the same license as the {{ project }} package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: {{ project|e }} {{ version|e }}\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: {{ ctime|e }}\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: {{ last_translator|e }}\n" "Language-Team: {{ language_team|e }}\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" {% for message in messages %} {% if display_location -%} {% for source, line in message.locations -%} #: {{ relpath(source) }}:{{ line }} {% endfor -%} {% endif -%} {% if display_uuid -%} {% for uuid in message.uuids -%} #: {{ uuid }} {% endfor -%} {% endif -%} msgid "{{ message.text|e }}" msgstr "" {% endfor -%} ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.5332036 Sphinx-4.3.2/sphinx/templates/graphviz/0000755000076600000240000000000000000000000017474 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/templates/graphviz/graphviz.css0000644000076600000240000000045300000000000022042 0ustar00tkomiyastaff/* * graphviz.css * ~~~~~~~~~~~~ * * Sphinx stylesheet -- graphviz extension. * * :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. * :license: BSD, see LICENSE for details. * */ img.graphviz { border: 0; max-width: 100%; } object.graphviz { max-width: 100%; } ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.5338187 Sphinx-4.3.2/sphinx/templates/htmlhelp/0000755000076600000240000000000000000000000017457 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/templates/htmlhelp/project.hhc0000644000076600000240000000154000000000000021611 0ustar00tkomiyastaff{%- macro sitemap(name, docname) -%} {%- endmacro -%}
    • {{ sitemap(short_title, root_doc)|indent(8) }}
      • {%- for indexname, indexcls, content, collapse in domain_indices %}
    • {{ sitemap(indexcls.localname, indexname)|indent(8) }}
      • {%- endfor %} {{ body|indent(6) }}
    ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/templates/htmlhelp/project.hhp0000644000076600000240000000107200000000000021626 0ustar00tkomiyastaff[OPTIONS] Binary TOC=No Binary Index=No Compiled file={{ outname }}.chm Contents file={{ outname }}.hhc Default Window={{ outname }} Default topic={{ root_doc }} Display compile progress=No Full text search stop list file={{ outname }}.stp Full-text search=Yes Index file={{ outname }}.hhk Language={{ "%#x"|format(lcid) }} Title={{ title }} [WINDOWS] {{ outname }}="{{ title }}","{{ outname }}.hhc","{{ outname }}.hhk","{{ root_doc }}","{{ root_doc }}",,,,,0x63520,220,0x10384e,[0,0,1024,768],,,,,,,0 [FILES] {%- for filename in files %} {{ filename }} {%- endfor %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163740.0 Sphinx-4.3.2/sphinx/templates/htmlhelp/project.stp0000644000076600000240000000024500000000000021656 0ustar00tkomiyastaffa and are as at be but by for if in into is it near no not of on or such that the their then there these they this to was will with ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.5342467 Sphinx-4.3.2/sphinx/templates/imgmath/0000755000076600000240000000000000000000000017270 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163740.0 Sphinx-4.3.2/sphinx/templates/imgmath/preview.tex_t0000644000076600000240000000061500000000000022020 0ustar00tkomiyastaff\documentclass[12pt]{article} \usepackage[utf8]{inputenc} \usepackage{amsmath} \usepackage{amsthm} \usepackage{amssymb} \usepackage{amsfonts} \usepackage{anyfontsize} \usepackage{bm} \pagestyle{empty} <%= preamble %> \usepackage[active<%= tightpage %>]{preview} \begin{document} \begin{preview} \fontsize{<%= fontsize %>}{<%= baselineskip %>}\selectfont <%= math %> \end{preview} \end{document} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163740.0 Sphinx-4.3.2/sphinx/templates/imgmath/template.tex_t0000644000076600000240000000050100000000000022144 0ustar00tkomiyastaff\documentclass[12pt]{article} \usepackage[utf8]{inputenc} \usepackage{amsmath} \usepackage{amsthm} \usepackage{amssymb} \usepackage{amsfonts} \usepackage{anyfontsize} \usepackage{bm} \pagestyle{empty} <%= preamble %> \begin{document} \fontsize{<%= fontsize %>}{<%= baselineskip %>}\selectfont <%= math %> \end{document} ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.5353198 Sphinx-4.3.2/sphinx/templates/latex/0000755000076600000240000000000000000000000016757 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/templates/latex/latex.tex_t0000644000076600000240000000531500000000000021145 0ustar00tkomiyastaff%% Generated by Sphinx. \def\sphinxdocclass{<%= docclass %>} <% if latex_engine == 'lualatex' -%> \IfFileExists{luatex85.sty} {\RequirePackage{luatex85}} {\ifdefined\luatexversion\ifnum\luatexversion>84\relax \PackageError{sphinx} {** With this LuaTeX (\the\luatexversion),Sphinx requires luatex85.sty **} {** Add the LaTeX package luatex85 to your TeX installation, and try again **} \endinput\fi\fi} <% endif -%> \documentclass[<%= papersize %>,<%= pointsize %><%= classoptions %>]{<%= wrapperclass %>} \ifdefined\pdfpxdimen \let\sphinxpxdimen\pdfpxdimen\else\newdimen\sphinxpxdimen \fi \sphinxpxdimen=<%= pxunit %>\relax \ifdefined\pdfimageresolution \pdfimageresolution= \numexpr \dimexpr1in\relax/\sphinxpxdimen\relax \fi %% let collapsible pdf bookmarks panel have high depth per default \PassOptionsToPackage{bookmarksdepth=5}{hyperref} <% if use_xindy -%> %% turn off hyperref patch of \index as sphinx.xdy xindy module takes care of %% suitable \hyperpage mark-up, working around hyperref-xindy incompatibility \PassOptionsToPackage{hyperindex=false}{hyperref} %% memoir class requires extra handling \makeatletter\@ifclassloaded{memoir} {\ifdefined\memhyperindexfalse\memhyperindexfalse\fi}{}\makeatother <% endif -%> <%= passoptionstopackages %> \PassOptionsToPackage{warn}{textcomp} <%= inputenc %> <%= utf8extra %> <%= cmappkg %> <%= fontenc %> <%= amsmath %> <%= multilingual %> <%= substitutefont %> <%= textcyrillic %> <%= fontpkg %> <%= fontsubstitution %> <%= textgreek %> <%= fncychap %> \usepackage<%= sphinxpkgoptions %>{sphinx} <%= sphinxsetup %> <%= fvset %> <%= geometry %> <%= extrapackages %> <%- for name, option in packages %> <%- if option %> \usepackage[<%= option %>]{<%= name %>} <%- else %> \usepackage{<%= name %>} <%- endif %> <%- endfor %> <%= hyperref %> <%- for name, option in packages_after_hyperref %> <%- if option %> \usepackage[<%= option %>]{<%= name %>} <%- else %> \usepackage{<%= name %>} <%- endif %> <%- endfor %> <%= contentsname %> \usepackage{sphinxmessages} <%= tocdepth %> <%= secnumdepth %> <%= preamble %> \title{<%= title %>} \date{<%= date %>} \release{<%= release | e %>} \author{<%= author %>} <%- if logofilename %> \newcommand{\sphinxlogo}{\sphinxincludegraphics{<%= logofilename %>}\par} <%- else %> \newcommand{\sphinxlogo}{\vbox{}} <%- endif %> <%- if releasename or release %> \renewcommand{\releasename}{<%= releasename or _('Release') | e %>} <%- else %> \renewcommand{\releasename}{} <%- endif %> <%= makeindex %> \begin{document} <%= shorthandoff %> \pagestyle{empty} <%= maketitle %> \pagestyle{plain} <%= tableofcontents %> \pagestyle{normal} <%= body %> <%= atendofbody %> <%= indices %> \renewcommand{\indexname}{<%= _('Index') | e %>} <%= printindex %> \end{document} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/templates/latex/longtable.tex_t0000644000076600000240000000171200000000000021774 0ustar00tkomiyastaff\begin{savenotes}\sphinxatlongtablestart\begin{longtable} <%- if table.align in ('center', 'default') -%> [c] <%- elif table.align == 'left' -%> [l] <%- elif table.align == 'right' -%> [r] <%- endif -%> <%= table.get_colspec() %> <%- if table.caption -%> \sphinxthelongtablecaptionisattop \caption{<%= ''.join(table.caption) %>\strut}<%= labels %>\\*[\sphinxlongtablecapskipadjust] \hline <% elif labels -%> \hline\noalign{\phantomsection<%= labels %>}% <% else -%> \hline <% endif -%> <%= ''.join(table.header) %> \endfirsthead \multicolumn{<%= table.colcount %>}{c}% {\makebox[0pt]{\sphinxtablecontinued{\tablename\ \thetable{} \textendash{} <%= _('continued from previous page') %>}}}\\ \hline <%= ''.join(table.header) %> \endhead \hline \multicolumn{<%= table.colcount %>}{r}{\makebox[0pt][r]{\sphinxtablecontinued{<%= _('continues on next page') %>}}}\\ \endfoot \endlastfoot <%= ''.join(table.body) %> \end{longtable}\sphinxatlongtableend\end{savenotes} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163740.0 Sphinx-4.3.2/sphinx/templates/latex/sphinxmessages.sty_t0000644000076600000240000000166000000000000023107 0ustar00tkomiyastaff% % sphinxmessages.sty % % message resources for Sphinx % \ProvidesPackage{sphinxmessages}[2019/01/04 v2.0 Localized LaTeX macros (Sphinx team)] \renewcommand{\literalblockcontinuedname}{<%= _('continued from previous page') | e %>} \renewcommand{\literalblockcontinuesname}{<%= _('continues on next page') | e %>} \renewcommand{\sphinxnonalphabeticalgroupname}{<%= _('Non-alphabetical') | e %>} \renewcommand{\sphinxsymbolsname}{<%= _('Symbols') | e %>} \renewcommand{\sphinxnumbersname}{<%= _('Numbers') | e %>} \def\pageautorefname{<%= _('page') | e %>} <%= addtocaptions %>{\renewcommand{\figurename}{<%= figurename[0] | e | eabbr %>}} \def\fnum@figure{\figurename\thefigure{}<%= figurename[1] | e %>} <%= addtocaptions %>{\renewcommand{\tablename}{<%= tablename[0] | e | eabbr %>}} \def\fnum@table{\tablename\thetable{}<%= tablename[1] | e %>} <%= addtocaptions %>{\renewcommand{\literalblockname}{<%= literalblockname[0].strip() %>}} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163740.0 Sphinx-4.3.2/sphinx/templates/latex/tabular.tex_t0000644000076600000240000000120400000000000021453 0ustar00tkomiyastaff\begin{savenotes}\sphinxattablestart <% if table.align -%> <%- if table.align in ('center', 'default') -%> \centering <%- elif table.align == 'left' -%> \raggedright <%- else -%> \raggedleft <%- endif %> <%- else -%> \centering <%- endif %> <% if table.caption -%> \sphinxcapstartof{table} \sphinxthecaptionisattop \sphinxcaption{<%= ''.join(table.caption) %>}<%= labels %> \sphinxaftertopcaption <% elif labels -%> \phantomsection<%= labels %>\nobreak <% endif -%> \begin{tabular}[t]<%= table.get_colspec() -%> \hline <%= ''.join(table.header) %> <%=- ''.join(table.body) %> \end{tabular} \par \sphinxattableend\end{savenotes} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163740.0 Sphinx-4.3.2/sphinx/templates/latex/tabulary.tex_t0000644000076600000240000000122200000000000021644 0ustar00tkomiyastaff\begin{savenotes}\sphinxattablestart <% if table.align -%> <%- if table.align in ('center', 'default') -%> \centering <%- elif table.align == 'left' -%> \raggedright <%- else -%> \raggedleft <%- endif %> <%- else -%> \centering <%- endif %> <% if table.caption -%> \sphinxcapstartof{table} \sphinxthecaptionisattop \sphinxcaption{<%= ''.join(table.caption) %>}<%= labels %> \sphinxaftertopcaption <% elif labels -%> \phantomsection<%= labels %>\nobreak <% endif -%> \begin{tabulary}{\linewidth}[t]<%= table.get_colspec() -%> \hline <%= ''.join(table.header) %> <%=- ''.join(table.body) %> \end{tabulary} \par \sphinxattableend\end{savenotes} ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.5365791 Sphinx-4.3.2/sphinx/templates/quickstart/0000755000076600000240000000000000000000000020034 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163740.0 Sphinx-4.3.2/sphinx/templates/quickstart/Makefile.new_t0000644000076600000240000000122000000000000022602 0ustar00tkomiyastaff# Minimal makefile for Sphinx documentation # # You can set these variables from the command line, and also # from the environment for the first two. SPHINXOPTS ?= SPHINXBUILD ?= sphinx-build SOURCEDIR = {{ rsrcdir }} BUILDDIR = {{ rbuilddir }} # Put it first so that "make" without argument is like "make help". help: @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) .PHONY: help Makefile # Catch-all target: route all unknown targets to Sphinx using the new # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). %: Makefile @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/templates/quickstart/Makefile_t0000644000076600000240000000767700000000000022040 0ustar00tkomiyastaff# Makefile for Sphinx documentation # # You can set these variables from the command line. SPHINXOPTS ?= SPHINXBUILD ?= sphinx-build PAPER ?= SOURCEDIR = {{ rsrcdir }} BUILDDIR = {{ rbuilddir }} # Internal variables. PAPEROPT_a4 = -D latex_elements.papersize=a4paper PAPEROPT_letter = -D latex_elements.papersize=letterpaper # $(O) is meant as a shortcut for $(SPHINXOPTS) ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) $(O) $(SOURCEDIR) # the i18n builder cannot share the environment and doctrees with the others I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) $(O) $(SOURCEDIR) .PHONY: help help: @echo "Please use \`make ' where is one of" @echo " html to make standalone HTML files" @echo " dirhtml to make HTML files named index.html in directories" @echo " singlehtml to make a single large HTML file" @echo " pickle to make pickle files" @echo " json to make JSON files" @echo " htmlhelp to make HTML files and an HTML help project" @echo " qthelp to make HTML files and a qthelp project" @echo " applehelp to make an Apple Help Book" @echo " devhelp to make HTML files and a Devhelp project" @echo " epub to make an epub" @echo " latex to make LaTeX files (you can set PAPER=a4 or PAPER=letter)" @echo " latexpdf to make LaTeX files and then PDFs out of them" @echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx" @echo " lualatexpdf to make LaTeX files and run them through lualatex" @echo " xelatexpdf to make LaTeX files and run them through xelatex" @echo " text to make text files" @echo " man to make manual pages" @echo " texinfo to make Texinfo files" @echo " info to make Texinfo files and run them through makeinfo" @echo " gettext to make PO message catalogs" @echo " changes to make an overview of all changed/added/deprecated items" @echo " xml to make Docutils-native XML files" @echo " pseudoxml to make pseudoxml-XML files for display purposes" @echo " linkcheck to check all external links for integrity" @echo " doctest to run all doctests embedded in the documentation (if enabled)" @echo " coverage to run coverage check of the documentation (if enabled)" @echo " dummy to check syntax errors of document sources" @echo " clean to remove everything in the build directory" .PHONY: clean clean: rm -rf $(BUILDDIR) .PHONY: latexpdf latexpdf: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through pdflatex..." $(MAKE) -C $(BUILDDIR)/latex all-pdf @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." .PHONY: latexpdfja latexpdfja: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through platex and dvipdfmx..." $(MAKE) -C $(BUILDDIR)/latex all-pdf-ja @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." .PHONY: lualatexpdf lualatexpdf: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through lualatex..." $(MAKE) PDFLATEX=lualatex -C $(BUILDDIR)/latex all-pdf @echo "lualatex finished; the PDF files are in $(BUILDDIR)/latex." .PHONY: xelatexpdf xelatexpdf: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @echo "Running LaTeX files through xelatex..." $(MAKE) PDFLATEX=xelatex -C $(BUILDDIR)/latex all-pdf @echo "xelatex finished; the PDF files are in $(BUILDDIR)/latex." .PHONY: info info: $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo @echo "Running Texinfo files through makeinfo..." make -C $(BUILDDIR)/texinfo info @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo." .PHONY: gettext gettext: $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale # Catch-all target: route all unknown targets to Sphinx .PHONY: Makefile %: Makefile $(SPHINXBUILD) -b "$@" $(ALLSPHINXOPTS) "$(BUILDDIR)/$@" ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/templates/quickstart/conf.py_t0000644000076600000240000000705000000000000021660 0ustar00tkomiyastaff# Configuration file for the Sphinx documentation builder. # # This file only contains a selection of the most common options. For a full # list see the documentation: # https://www.sphinx-doc.org/en/master/usage/configuration.html # -- Path setup -------------------------------------------------------------- # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. # {% if append_syspath -%} import os import sys sys.path.insert(0, {{ module_path | repr }}) {% else -%} # import os # import sys {% if module_path -%} # sys.path.insert(0, {{ module_path | repr }}) {% else -%} # sys.path.insert(0, os.path.abspath('.')) {% endif -%} {% endif %} # -- Project information ----------------------------------------------------- project = {{ project | repr }} copyright = {{ copyright | repr }} author = {{ author | repr }} {%- if version %} # The short X.Y version version = {{ version | repr }} {%- endif %} {%- if release %} # The full version, including alpha/beta/rc tags release = {{ release | repr }} {%- endif %} # -- General configuration --------------------------------------------------- # Add any Sphinx extension module names here, as strings. They can be # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom # ones. extensions = [ {%- for ext in extensions %} '{{ ext }}', {%- endfor %} ] # Add any paths that contain templates here, relative to this directory. templates_path = ['{{ dot }}templates'] {% if suffix != '.rst' -%} # The suffix(es) of source filenames. # You can specify multiple suffix as a list of string: # # source_suffix = ['.rst', '.md'] source_suffix = {{ suffix | repr }} {% endif -%} {% if root_doc != 'index' -%} # The root document. root_doc = {{ root_doc | repr }} {% endif -%} {% if language -%} # The language for content autogenerated by Sphinx. Refer to documentation # for a list of supported languages. # # This is also used if you do content translation via gettext catalogs. # Usually you set "language" from the command line for these cases. language = {{ language | repr }} {% endif -%} # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. # This pattern also affects html_static_path and html_extra_path. exclude_patterns = [{{ exclude_patterns }}] # -- Options for HTML output ------------------------------------------------- # The theme to use for HTML and HTML Help pages. See the documentation for # a list of builtin themes. # html_theme = 'alabaster' # Add any paths that contain custom static files (such as style sheets) here, # relative to this directory. They are copied after the builtin static files, # so a file named "default.css" will overwrite the builtin "default.css". html_static_path = ['{{ dot }}static'] {%- if extensions %} # -- Extension configuration ------------------------------------------------- {%- endif %} {%- if 'sphinx.ext.intersphinx' in extensions %} # -- Options for intersphinx extension --------------------------------------- # Example configuration for intersphinx: refer to the Python standard library. intersphinx_mapping = { 'python': ('https://docs.python.org/3', None), } {%- endif %} {%- if 'sphinx.ext.todo' in extensions %} # -- Options for todo extension ---------------------------------------------- # If true, `todo` and `todoList` produce output, else they produce nothing. todo_include_todos = True {%- endif %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/templates/quickstart/make.bat.new_t0000644000076600000240000000142300000000000022554 0ustar00tkomiyastaff@ECHO OFF pushd %~dp0 REM Command file for Sphinx documentation if "%SPHINXBUILD%" == "" ( set SPHINXBUILD=sphinx-build ) set SOURCEDIR={{ rsrcdir }} set BUILDDIR={{ rbuilddir }} if "%1" == "" goto help %SPHINXBUILD% >NUL 2>NUL if errorlevel 9009 ( echo. echo.The 'sphinx-build' command was not found. Make sure you have Sphinx echo.installed, then set the SPHINXBUILD environment variable to point echo.to the full path of the 'sphinx-build' executable. Alternatively you echo.may add the Sphinx directory to PATH. echo. echo.If you don't have Sphinx installed, grab it from echo.https://www.sphinx-doc.org/ exit /b 1 ) %SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% goto end :help %SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% :end popd ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/templates/quickstart/make.bat_t0000644000076600000240000000633500000000000021773 0ustar00tkomiyastaff@ECHO OFF REM Command file for Sphinx documentation pushd %~dp0 if "%SPHINXBUILD%" == "" ( set SPHINXBUILD=sphinx-build ) set BUILDDIR={{ rbuilddir }} set SOURCEDIR={{ rsrcdir }} set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% %O% %SOURCEDIR% set I18NSPHINXOPTS=%SPHINXOPTS% %SOURCEDIR% if NOT "%PAPER%" == "" ( set ALLSPHINXOPTS=-D latex_elements.papersize=%PAPER%paper %ALLSPHINXOPTS% set I18NSPHINXOPTS=-D latex_elements.papersize=%PAPER%paper %I18NSPHINXOPTS% ) if "%1" == "" goto help if "%1" == "help" ( :help echo.Please use `make ^` where ^ is one of echo. html to make standalone HTML files echo. dirhtml to make HTML files named index.html in directories echo. singlehtml to make a single large HTML file echo. pickle to make pickle files echo. json to make JSON files echo. htmlhelp to make HTML files and an HTML help project echo. qthelp to make HTML files and a Qt help project echo. devhelp to make HTML files and a Devhelp project echo. epub to make an EPUB echo. latex to make LaTeX files (you can set PAPER=a4 or PAPER=letter) echo. latexpdf to make LaTeX files and then PDFs out of them echo. text to make text files echo. man to make manual pages echo. texinfo to make Texinfo files echo. gettext to make PO message catalogs echo. changes to make an overview over all changed/added/deprecated items echo. xml to make Docutils-native XML files echo. pseudoxml to make pseudoxml-XML files for display purposes echo. linkcheck to check all external links for integrity echo. doctest to run all doctests embedded in the documentation if enabled echo. coverage to run coverage check of the documentation if enabled echo. dummy to check syntax errors of document sources echo. clean to remove everything in the build directory goto end ) if "%1" == "clean" ( for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i del /q /s %BUILDDIR%\* goto end ) REM Check if sphinx-build is available and fallback to Python version if any %SPHINXBUILD% 1>NUL 2>NUL if errorlevel 9009 goto sphinx_python goto sphinx_ok :sphinx_python set SPHINXBUILD=python -m sphinx.__init__ %SPHINXBUILD% 2> nul if errorlevel 9009 ( echo. echo.The 'sphinx-build' command was not found. Make sure you have Sphinx echo.installed, then set the SPHINXBUILD environment variable to point echo.to the full path of the 'sphinx-build' executable. Alternatively you echo.may add the Sphinx directory to PATH. echo. echo.If you don't have Sphinx installed, grab it from echo.https://www.sphinx-doc.org/ exit /b 1 ) :sphinx_ok if "%1" == "latexpdf" ( %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex cd %BUILDDIR%/latex make all-pdf cd %~dp0 echo. echo.Build finished; the PDF files are in %BUILDDIR%/latex. goto end ) if "%1" == "latexpdfja" ( %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex cd %BUILDDIR%/latex make all-pdf-ja cd %~dp0 echo. echo.Build finished; the PDF files are in %BUILDDIR%/latex. goto end ) if "%1" == "gettext" ( %SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale if errorlevel 1 exit /b 1 goto end ) %SPHINXBUILD% -b %1 %ALLSPHINXOPTS% %BUILDDIR%/%1 goto end :end popd ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/templates/quickstart/root_doc.rst_t0000644000076600000240000000075400000000000022727 0ustar00tkomiyastaff.. {{ project }} documentation master file, created by sphinx-quickstart on {{ now }}. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. Welcome to {{ project }}'s documentation! ==========={{ project_underline }}================= .. toctree:: :maxdepth: {{ mastertocmaxdepth }} :caption: Contents: {{ mastertoctree }} Indices and tables ================== * :ref:`genindex` * :ref:`modindex` * :ref:`search` ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.5367863 Sphinx-4.3.2/sphinx/templates/texinfo/0000755000076600000240000000000000000000000017316 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163740.0 Sphinx-4.3.2/sphinx/templates/texinfo/Makefile0000644000076600000240000000261700000000000020764 0ustar00tkomiyastaff# Makefile for Sphinx Texinfo output infodir ?= /usr/share/info MAKEINFO = makeinfo --no-split MAKEINFO_html = makeinfo --no-split --html MAKEINFO_plaintext = makeinfo --no-split --plaintext TEXI2PDF = texi2pdf --batch --expand INSTALL_INFO = install-info ALLDOCS = $(basename $(wildcard *.texi)) all: info info: $(addsuffix .info,$(ALLDOCS)) plaintext: $(addsuffix .txt,$(ALLDOCS)) html: $(addsuffix .html,$(ALLDOCS)) pdf: $(addsuffix .pdf,$(ALLDOCS)) install-info: info for f in *.info; do \ mkdir -p $(infodir) && \ cp "$$f" $(infodir) && \ $(INSTALL_INFO) --info-dir=$(infodir) "$$f" && \ \ FIGURE_DIR="`basename \"$$f\" .info`-figures" && \ if [ -e "$$FIGURE_DIR" ]; then \ cp -r "$$FIGURE_DIR" $(infodir) ; \ fi; \ done uninstall-info: info for f in *.info; do \ rm -f "$(infodir)/$$f" ; \ rm -rf "$(infodir)/`basename '$$f' .info`-figures" && \ $(INSTALL_INFO) --delete --info-dir=$(infodir) "$$f" ; \ done %.info: %.texi $(MAKEINFO) -o '$@' '$<' %.txt: %.texi $(MAKEINFO_plaintext) -o '$@' '$<' %.html: %.texi $(MAKEINFO_html) -o '$@' '$<' %.pdf: %.texi -$(TEXI2PDF) '$<' -$(TEXI2PDF) '$<' -$(TEXI2PDF) '$<' clean: rm -f *.info *.pdf *.txt *.html rm -f *.log *.ind *.aux *.toc *.syn *.idx *.out *.ilg *.pla *.ky *.pg rm -f *.vr *.tp *.fn *.fns *.def *.defs *.cp *.cps *.ge *.ges *.mo .PHONY: all info plaintext html pdf install-info uninstall-info clean ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.5380492 Sphinx-4.3.2/sphinx/testing/0000755000076600000240000000000000000000000015321 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/testing/__init__.py0000644000076600000240000000052500000000000017434 0ustar00tkomiyastaff""" sphinx.testing ~~~~~~~~~~~~~~ Sphinx test utilities You can require sphinx.testing pytest fixtures in a test module or a conftest file like this: pytest_plugins = 'sphinx.testing.fixtures' :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/testing/comparer.py0000644000076600000240000000552400000000000017511 0ustar00tkomiyastaff""" sphinx.testing.comparer ~~~~~~~~~~~~~~~~~~~~~~~ Sphinx test comparer for pytest :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import difflib import pathlib from typing import Any, List, Union class PathComparer: """ OS-independent path comparison. Windows path sep and posix path sep: >>> '\\to\\index' == PathComparer('/to/index') True >>> '\\to\\index' == PathComparer('/to/index2') False Windows path with drive letters >>> 'C:\\to\\index' == PathComparer('/to/index') True >>> 'C:\\to\\index' == PathComparer('C:/to/index') True >>> 'C:\\to\\index' == PathComparer('D:/to/index') False """ def __init__(self, path: Union[str, pathlib.Path]): """ :param str path: path string, it will be cast as pathlib.Path. """ self.path = pathlib.Path(path) def __str__(self) -> str: return self.path.as_posix() def __repr__(self) -> str: return "<{0.__class__.__name__}: '{0}'>".format(self) def __eq__(self, other: Union[str, pathlib.Path]) -> bool: # type: ignore return not bool(self.ldiff(other)) def diff(self, other: Union[str, pathlib.Path]) -> List[str]: """compare self and other. When different is not exist, return empty list. >>> PathComparer('/to/index').diff('C:\\to\\index') [] When different is exist, return unified diff style list as: >>> PathComparer('/to/index').diff('C:\\to\\index2') [ '- C:/to/index' '+ C:/to/index2' '? +' ] """ return self.ldiff(other) def ldiff(self, other: Union[str, pathlib.Path]) -> List[str]: return self._diff( self.path, pathlib.Path(other), ) def rdiff(self, other: Union[str, pathlib.Path]) -> List[str]: return self._diff( pathlib.Path(other), self.path, ) def _diff(self, lhs: pathlib.Path, rhs: pathlib.Path) -> List[str]: if lhs == rhs: return [] if lhs.drive or rhs.drive: # If either has a drive letter compare by absolute path s_path, o_path = lhs.absolute().as_posix(), rhs.absolute().as_posix() else: s_path, o_path = lhs.as_posix(), rhs.as_posix() if s_path == o_path: return [] return [line.strip() for line in difflib.Differ().compare([s_path], [o_path])] def pytest_assertrepr_compare(op: str, left: Any, right: Any) -> List[str]: if isinstance(left, PathComparer) and op == "==": return ['Comparing path:'] + left.ldiff(right) elif isinstance(right, PathComparer) and op == "==": return ['Comparing path:'] + right.rdiff(left) else: return [] ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/testing/fixtures.py0000644000076600000240000001750100000000000017550 0ustar00tkomiyastaff""" sphinx.testing.fixtures ~~~~~~~~~~~~~~~~~~~~~~~ Sphinx test fixtures for pytest :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import subprocess import sys from collections import namedtuple from io import StringIO from subprocess import PIPE from typing import Any, Callable, Dict, Generator, Tuple import pytest from sphinx.testing import util from sphinx.testing.util import SphinxTestApp, SphinxTestAppWrapperForSkipBuilding DEFAULT_ENABLED_MARKERS = [ ( 'sphinx(builder, testroot=None, freshenv=False, confoverrides=None, tags=None,' ' docutilsconf=None, parallel=0): arguments to initialize the sphinx test application.' ), 'test_params(shared_result=...): test parameters.', ] def pytest_configure(config): """Register custom markers""" for marker in DEFAULT_ENABLED_MARKERS: config.addinivalue_line('markers', marker) @pytest.fixture(scope='session') def rootdir() -> str: return None class SharedResult: cache: Dict[str, Dict[str, str]] = {} def store(self, key: str, app_: SphinxTestApp) -> Any: if key in self.cache: return data = { 'status': app_._status.getvalue(), 'warning': app_._warning.getvalue(), } self.cache[key] = data def restore(self, key: str) -> Dict[str, StringIO]: if key not in self.cache: return {} data = self.cache[key] return { 'status': StringIO(data['status']), 'warning': StringIO(data['warning']), } @pytest.fixture def app_params(request: Any, test_params: Dict, shared_result: SharedResult, sphinx_test_tempdir: str, rootdir: str) -> Tuple[Dict, Dict]: """ Parameters that are specified by 'pytest.mark.sphinx' for sphinx.application.Sphinx initialization """ # ##### process pytest.mark.sphinx if hasattr(request.node, 'iter_markers'): # pytest-3.6.0 or newer markers = request.node.iter_markers("sphinx") else: markers = request.node.get_marker("sphinx") pargs = {} kwargs: Dict[str, Any] = {} if markers is not None: # to avoid stacking positional args for info in reversed(list(markers)): for i, a in enumerate(info.args): pargs[i] = a kwargs.update(info.kwargs) args = [pargs[i] for i in sorted(pargs.keys())] # ##### process pytest.mark.test_params if test_params['shared_result']: if 'srcdir' in kwargs: raise pytest.Exception('You can not specify shared_result and ' 'srcdir in same time.') kwargs['srcdir'] = test_params['shared_result'] restore = shared_result.restore(test_params['shared_result']) kwargs.update(restore) # ##### prepare Application params testroot = kwargs.pop('testroot', 'root') kwargs['srcdir'] = srcdir = sphinx_test_tempdir / kwargs.get('srcdir', testroot) # special support for sphinx/tests if rootdir and not srcdir.exists(): testroot_path = rootdir / ('test-' + testroot) testroot_path.copytree(srcdir) return namedtuple('app_params', 'args,kwargs')(args, kwargs) # type: ignore @pytest.fixture def test_params(request: Any) -> Dict: """ Test parameters that are specified by 'pytest.mark.test_params' :param Union[str] shared_result: If the value is provided, app._status and app._warning objects will be shared in the parametrized test functions and/or test functions that have same 'shared_result' value. **NOTE**: You can not specify both shared_result and srcdir. """ if hasattr(request.node, 'get_closest_marker'): # pytest-3.6.0 or newer env = request.node.get_closest_marker('test_params') else: env = request.node.get_marker('test_params') kwargs = env.kwargs if env else {} result = { 'shared_result': None, } result.update(kwargs) if (result['shared_result'] and not isinstance(result['shared_result'], str)): raise pytest.Exception('You can only provide a string type of value ' 'for "shared_result" ') return result @pytest.fixture(scope='function') def app(test_params: Dict, app_params: Tuple[Dict, Dict], make_app: Callable, shared_result: SharedResult) -> Generator[SphinxTestApp, None, None]: """ Provides the 'sphinx.application.Sphinx' object """ args, kwargs = app_params app_ = make_app(*args, **kwargs) yield app_ print('# testroot:', kwargs.get('testroot', 'root')) print('# builder:', app_.builder.name) print('# srcdir:', app_.srcdir) print('# outdir:', app_.outdir) print('# status:', '\n' + app_._status.getvalue()) print('# warning:', '\n' + app_._warning.getvalue()) if test_params['shared_result']: shared_result.store(test_params['shared_result'], app_) @pytest.fixture(scope='function') def status(app: SphinxTestApp) -> StringIO: """ Back-compatibility for testing with previous @with_app decorator """ return app._status @pytest.fixture(scope='function') def warning(app: SphinxTestApp) -> StringIO: """ Back-compatibility for testing with previous @with_app decorator """ return app._warning @pytest.fixture() def make_app(test_params: Dict, monkeypatch: Any) -> Generator[Callable, None, None]: """ Provides make_app function to initialize SphinxTestApp instance. if you want to initialize 'app' in your test function. please use this instead of using SphinxTestApp class directory. """ monkeypatch.setattr('sphinx.application.abspath', lambda x: x) apps = [] syspath = sys.path[:] def make(*args, **kwargs): status, warning = StringIO(), StringIO() kwargs.setdefault('status', status) kwargs.setdefault('warning', warning) app_: Any = SphinxTestApp(*args, **kwargs) apps.append(app_) if test_params['shared_result']: app_ = SphinxTestAppWrapperForSkipBuilding(app_) return app_ yield make sys.path[:] = syspath for app_ in reversed(apps): # clean up applications from the new ones app_.cleanup() @pytest.fixture def shared_result() -> SharedResult: return SharedResult() @pytest.fixture(scope='module', autouse=True) def _shared_result_cache() -> None: SharedResult.cache.clear() @pytest.fixture def if_graphviz_found(app: SphinxTestApp) -> None: """ The test will be skipped when using 'if_graphviz_found' fixture and graphviz dot command is not found. """ graphviz_dot = getattr(app.config, 'graphviz_dot', '') try: if graphviz_dot: subprocess.run([graphviz_dot, '-V'], stdout=PIPE, stderr=PIPE) # show version return except OSError: # No such file or directory pass pytest.skip('graphviz "dot" is not available') @pytest.fixture(scope='session') def sphinx_test_tempdir(tmpdir_factory: Any) -> "util.path": """ Temporary directory wrapped with `path` class. """ tmpdir = tmpdir_factory.getbasetemp() return util.path(tmpdir).abspath() @pytest.fixture def tempdir(tmpdir: str) -> "util.path": """ Temporary directory wrapped with `path` class. This fixture is for back-compatibility with old test implementation. """ return util.path(tmpdir) @pytest.fixture def rollback_sysmodules(): """ Rollback sys.modules to its value before testing to unload modules during tests. For example, used in test_ext_autosummary.py to permit unloading the target module to clear its cache. """ try: sysmodules = list(sys.modules) yield finally: for modname in list(sys.modules): if modname not in sysmodules: sys.modules.pop(modname) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/testing/path.py0000644000076600000240000001570500000000000016637 0ustar00tkomiyastaff""" sphinx.testing.path ~~~~~~~~~~~~~~~~~~~ :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import builtins import os import shutil import sys import warnings from typing import IO, Any, Callable, List from sphinx.deprecation import RemovedInSphinx50Warning FILESYSTEMENCODING = sys.getfilesystemencoding() or sys.getdefaultencoding() def getumask() -> int: """Get current umask value""" umask = os.umask(0) # Note: Change umask value temporarily to obtain it os.umask(umask) return umask UMASK = getumask() class path(str): """ Represents a path which behaves like a string. """ @property def parent(self) -> "path": """ The name of the directory the file or directory is in. """ return self.__class__(os.path.dirname(self)) def basename(self) -> str: return os.path.basename(self) def abspath(self) -> "path": """ Returns the absolute path. """ return self.__class__(os.path.abspath(self)) def isabs(self) -> bool: """ Returns ``True`` if the path is absolute. """ return os.path.isabs(self) def isdir(self) -> bool: """ Returns ``True`` if the path is a directory. """ return os.path.isdir(self) def isfile(self) -> bool: """ Returns ``True`` if the path is a file. """ return os.path.isfile(self) def islink(self) -> bool: """ Returns ``True`` if the path is a symbolic link. """ return os.path.islink(self) def ismount(self) -> bool: """ Returns ``True`` if the path is a mount point. """ return os.path.ismount(self) def rmtree(self, ignore_errors: bool = False, onerror: Callable = None) -> None: """ Removes the file or directory and any files or directories it may contain. :param ignore_errors: If ``True`` errors are silently ignored, otherwise an exception is raised in case an error occurs. :param onerror: A callback which gets called with the arguments `func`, `path` and `exc_info`. `func` is one of :func:`os.listdir`, :func:`os.remove` or :func:`os.rmdir`. `path` is the argument to the function which caused it to fail and `exc_info` is a tuple as returned by :func:`sys.exc_info`. """ shutil.rmtree(self, ignore_errors=ignore_errors, onerror=onerror) def copytree(self, destination: str, symlinks: bool = False) -> None: """ Recursively copy a directory to the given `destination`. If the given `destination` does not exist it will be created. :param symlinks: If ``True`` symbolic links in the source tree result in symbolic links in the destination tree otherwise the contents of the files pointed to by the symbolic links are copied. """ shutil.copytree(self, destination, symlinks=symlinks) if os.environ.get('SPHINX_READONLY_TESTDIR'): # If source tree is marked read-only (e.g. because it is on a read-only # filesystem), `shutil.copytree` will mark the destination as read-only # as well. To avoid failures when adding additional files/directories # to the destination tree, ensure destination directories are not marked # read-only. for root, dirs, files in os.walk(destination): os.chmod(root, 0o755 & ~UMASK) for name in files: os.chmod(os.path.join(root, name), 0o644 & ~UMASK) def movetree(self, destination: str) -> None: """ Recursively move the file or directory to the given `destination` similar to the Unix "mv" command. If the `destination` is a file it may be overwritten depending on the :func:`os.rename` semantics. """ shutil.move(self, destination) move = movetree def unlink(self) -> None: """ Removes a file. """ os.unlink(self) def stat(self) -> Any: """ Returns a stat of the file. """ return os.stat(self) def utime(self, arg: Any) -> None: os.utime(self, arg) def open(self, mode: str = 'r', **kwargs: Any) -> IO: return open(self, mode, **kwargs) def write_text(self, text: str, encoding: str = 'utf-8', **kwargs: Any) -> None: """ Writes the given `text` to the file. """ with open(self, 'w', encoding=encoding, **kwargs) as f: f.write(text) def text(self, encoding: str = 'utf-8', **kwargs: Any) -> str: """ Returns the text in the file. """ warnings.warn('Path.text() is deprecated. Please use read_text() instead.', RemovedInSphinx50Warning, stacklevel=2) return self.read_text(encoding, **kwargs) def read_text(self, encoding: str = 'utf-8', **kwargs: Any) -> str: """ Returns the text in the file. """ with open(self, encoding=encoding, **kwargs) as f: return f.read() def bytes(self) -> builtins.bytes: """ Returns the bytes in the file. """ warnings.warn('Path.bytes() is deprecated. Please use read_bytes() instead.', RemovedInSphinx50Warning, stacklevel=2) return self.read_bytes() def read_bytes(self) -> builtins.bytes: """ Returns the bytes in the file. """ with open(self, mode='rb') as f: return f.read() def write_bytes(self, bytes: str, append: bool = False) -> None: """ Writes the given `bytes` to the file. :param append: If ``True`` given `bytes` are added at the end of the file. """ if append: mode = 'ab' else: mode = 'wb' with open(self, mode=mode) as f: f.write(bytes) def exists(self) -> bool: """ Returns ``True`` if the path exist. """ return os.path.exists(self) def lexists(self) -> bool: """ Returns ``True`` if the path exists unless it is a broken symbolic link. """ return os.path.lexists(self) def makedirs(self, mode: int = 0o777, exist_ok: bool = False) -> None: """ Recursively create directories. """ os.makedirs(self, mode, exist_ok=exist_ok) def joinpath(self, *args: Any) -> "path": """ Joins the path with the argument given and returns the result. """ return self.__class__(os.path.join(self, *map(self.__class__, args))) def listdir(self) -> List[str]: return os.listdir(self) __div__ = __truediv__ = joinpath def __repr__(self) -> str: return '%s(%s)' % (self.__class__.__name__, super().__repr__()) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/testing/restructuredtext.py0000644000076600000240000000231000000000000021327 0ustar00tkomiyastaff""" sphinx.testing.restructuredtext ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ from os import path from docutils import nodes from docutils.core import publish_doctree from sphinx.application import Sphinx from sphinx.io import SphinxStandaloneReader from sphinx.parsers import RSTParser from sphinx.util.docutils import sphinx_domains def parse(app: Sphinx, text: str, docname: str = 'index') -> nodes.document: """Parse a string as reStructuredText with Sphinx application.""" try: app.env.temp_data['docname'] = docname reader = SphinxStandaloneReader() reader.setup(app) parser = RSTParser() parser.set_application(app) with sphinx_domains(app.env): return publish_doctree(text, path.join(app.srcdir, docname + '.rst'), reader=reader, parser=parser, settings_overrides={'env': app.env, 'gettext_compact': True}) finally: app.env.temp_data.pop('docname', None) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/testing/util.py0000644000076600000240000001571100000000000016655 0ustar00tkomiyastaff""" sphinx.testing.util ~~~~~~~~~~~~~~~~~~~ Sphinx test suite utilities :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. """ import functools import os import re import sys import warnings from io import StringIO from typing import IO, Any, Dict, Generator, List, Pattern from xml.etree import ElementTree from docutils import nodes from docutils.nodes import Node from docutils.parsers.rst import directives, roles from sphinx import application, locale from sphinx.pycode import ModuleAnalyzer from sphinx.testing.path import path from sphinx.util.osutil import relpath __all__ = [ 'Struct', 'SphinxTestApp', 'SphinxTestAppWrapperForSkipBuilding', ] def assert_re_search(regex: Pattern, text: str, flags: int = 0) -> None: if not re.search(regex, text, flags): assert False, '%r did not match %r' % (regex, text) def assert_not_re_search(regex: Pattern, text: str, flags: int = 0) -> None: if re.search(regex, text, flags): assert False, '%r did match %r' % (regex, text) def assert_startswith(thing: str, prefix: str) -> None: if not thing.startswith(prefix): assert False, '%r does not start with %r' % (thing, prefix) def assert_node(node: Node, cls: Any = None, xpath: str = "", **kwargs: Any) -> None: if cls: if isinstance(cls, list): assert_node(node, cls[0], xpath=xpath, **kwargs) if cls[1:]: if isinstance(cls[1], tuple): assert_node(node, cls[1], xpath=xpath, **kwargs) else: assert isinstance(node, nodes.Element), \ 'The node%s does not have any children' % xpath assert len(node) == 1, \ 'The node%s has %d child nodes, not one' % (xpath, len(node)) assert_node(node[0], cls[1:], xpath=xpath + "[0]", **kwargs) elif isinstance(cls, tuple): assert isinstance(node, (list, nodes.Element)), \ 'The node%s does not have any items' % xpath assert len(node) == len(cls), \ 'The node%s has %d child nodes, not %r' % (xpath, len(node), len(cls)) for i, nodecls in enumerate(cls): path = xpath + "[%d]" % i assert_node(node[i], nodecls, xpath=path, **kwargs) elif isinstance(cls, str): assert node == cls, 'The node %r is not %r: %r' % (xpath, cls, node) else: assert isinstance(node, cls), \ 'The node%s is not subclass of %r: %r' % (xpath, cls, node) if kwargs: assert isinstance(node, nodes.Element), \ 'The node%s does not have any attributes' % xpath for key, value in kwargs.items(): assert key in node, \ 'The node%s does not have %r attribute: %r' % (xpath, key, node) assert node[key] == value, \ 'The node%s[%s] is not %r: %r' % (xpath, key, value, node[key]) def etree_parse(path: str) -> Any: with warnings.catch_warnings(record=False): warnings.filterwarnings("ignore", category=DeprecationWarning) return ElementTree.parse(path) class Struct: def __init__(self, **kwargs: Any) -> None: self.__dict__.update(kwargs) class SphinxTestApp(application.Sphinx): """ A subclass of :class:`Sphinx` that runs on the test root, with some better default values for the initialization parameters. """ _status: StringIO = None _warning: StringIO = None def __init__(self, buildername: str = 'html', srcdir: path = None, builddir: path = None, freshenv: bool = False, confoverrides: Dict = None, status: IO = None, warning: IO = None, tags: List[str] = None, docutilsconf: str = None, parallel: int = 0) -> None: if docutilsconf is not None: (srcdir / 'docutils.conf').write_text(docutilsconf) if builddir is None: builddir = srcdir / '_build' confdir = srcdir outdir = builddir.joinpath(buildername) outdir.makedirs(exist_ok=True) doctreedir = builddir.joinpath('doctrees') doctreedir.makedirs(exist_ok=True) if confoverrides is None: confoverrides = {} warningiserror = False self._saved_path = sys.path[:] self._saved_directives = directives._directives.copy() # type: ignore self._saved_roles = roles._roles.copy() # type: ignore self._saved_nodeclasses = {v for v in dir(nodes.GenericNodeVisitor) if v.startswith('visit_')} try: super().__init__(srcdir, confdir, outdir, doctreedir, buildername, confoverrides, status, warning, freshenv, warningiserror, tags, parallel=parallel) except Exception: self.cleanup() raise def cleanup(self, doctrees: bool = False) -> None: ModuleAnalyzer.cache.clear() locale.translators.clear() sys.path[:] = self._saved_path sys.modules.pop('autodoc_fodder', None) directives._directives = self._saved_directives # type: ignore roles._roles = self._saved_roles # type: ignore for method in dir(nodes.GenericNodeVisitor): if method.startswith('visit_') and \ method not in self._saved_nodeclasses: delattr(nodes.GenericNodeVisitor, 'visit_' + method[6:]) delattr(nodes.GenericNodeVisitor, 'depart_' + method[6:]) def __repr__(self) -> str: return '<%s buildername=%r>' % (self.__class__.__name__, self.builder.name) class SphinxTestAppWrapperForSkipBuilding: """ This class is a wrapper for SphinxTestApp to speed up the test by skipping `app.build` process if it is already built and there is even one output file. """ def __init__(self, app_: SphinxTestApp) -> None: self.app = app_ def __getattr__(self, name: str) -> Any: return getattr(self.app, name) def build(self, *args: Any, **kwargs: Any) -> None: if not self.app.outdir.listdir(): # type: ignore # if listdir is empty, do build. self.app.build(*args, **kwargs) # otherwise, we can use built cache _unicode_literals_re = re.compile(r'u(".*?")|u(\'.*?\')') def find_files(root: str, suffix: bool = None) -> Generator[str, None, None]: for dirpath, dirs, files in os.walk(root, followlinks=True): dirpath = path(dirpath) for f in [f for f in files if not suffix or f.endswith(suffix)]: # type: ignore fpath = dirpath / f yield relpath(fpath, root) def strip_escseq(text: str) -> str: return re.sub('\x1b.*?m', '', text) def simple_decorator(f): """ A simple decorator that does nothing, for tests to use. """ @functools.wraps(f) def wrapper(*args, **kwargs): return f(*args, **kwargs) return wrapper ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.5443738 Sphinx-4.3.2/sphinx/texinputs/0000755000076600000240000000000000000000000015707 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/sphinx/texinputs/LICRcyr2utf8.xdy0000644000076600000240000001041600000000000020577 0ustar00tkomiyastaff;; -*- coding: utf-8; mode: Lisp; -*- ;; style file for xindy ;; filename: LICRcyr2utf8.xdy ;; description: style file for xindy which maps back LaTeX Internal ;; Character Representation of Cyrillic to utf-8 ;; usage: for use with pdflatex produced .idx files. ;; Contributed by the Sphinx team, July 2018. (merge-rule "\IeC {\'\CYRG }" "Ѓ" :string) (merge-rule "\IeC {\'\CYRK }" "Ќ" :string) (merge-rule "\IeC {\'\cyrg }" "ѓ" :string) (merge-rule "\IeC {\'\cyrk }" "ќ" :string) (merge-rule "\IeC {\CYRA }" "А" :string) (merge-rule "\IeC {\CYRB }" "Б" :string) (merge-rule "\IeC {\CYRC }" "Ц" :string) (merge-rule "\IeC {\CYRCH }" "Ч" :string) (merge-rule "\IeC {\CYRD }" "Д" :string) (merge-rule "\IeC {\CYRDJE }" "Ђ" :string) (merge-rule "\IeC {\CYRDZE }" "Ѕ" :string) (merge-rule "\IeC {\CYRDZHE }" "Џ" :string) (merge-rule "\IeC {\CYRE }" "Е" :string) (merge-rule "\IeC {\CYREREV }" "Э" :string) (merge-rule "\IeC {\CYRERY }" "Ы" :string) (merge-rule "\IeC {\CYRF }" "Ф" :string) (merge-rule "\IeC {\CYRG }" "Г" :string) (merge-rule "\IeC {\CYRGUP }" "Ґ" :string) (merge-rule "\IeC {\CYRH }" "Х" :string) (merge-rule "\IeC {\CYRHRDSN }" "Ъ" :string) (merge-rule "\IeC {\CYRI }" "И" :string) (merge-rule "\IeC {\CYRIE }" "Є" :string) (merge-rule "\IeC {\CYRII }" "І" :string) (merge-rule "\IeC {\CYRISHRT }" "Й" :string) (merge-rule "\IeC {\CYRJE }" "Ј" :string) (merge-rule "\IeC {\CYRK }" "К" :string) (merge-rule "\IeC {\CYRL }" "Л" :string) (merge-rule "\IeC {\CYRLJE }" "Љ" :string) (merge-rule "\IeC {\CYRM }" "М" :string) (merge-rule "\IeC {\CYRN }" "Н" :string) (merge-rule "\IeC {\CYRNJE }" "Њ" :string) (merge-rule "\IeC {\CYRO }" "О" :string) (merge-rule "\IeC {\CYRP }" "П" :string) (merge-rule "\IeC {\CYRR }" "Р" :string) (merge-rule "\IeC {\CYRS }" "С" :string) (merge-rule "\IeC {\CYRSFTSN }" "Ь" :string) (merge-rule "\IeC {\CYRSH }" "Ш" :string) (merge-rule "\IeC {\CYRSHCH }" "Щ" :string) (merge-rule "\IeC {\CYRT }" "Т" :string) (merge-rule "\IeC {\CYRTSHE }" "Ћ" :string) (merge-rule "\IeC {\CYRU }" "У" :string) (merge-rule "\IeC {\CYRUSHRT }" "Ў" :string) (merge-rule "\IeC {\CYRV }" "В" :string) (merge-rule "\IeC {\CYRYA }" "Я" :string) (merge-rule "\IeC {\CYRYI }" "Ї" :string) (merge-rule "\IeC {\CYRYO }" "Ё" :string) (merge-rule "\IeC {\CYRYU }" "Ю" :string) (merge-rule "\IeC {\CYRZ }" "З" :string) (merge-rule "\IeC {\CYRZH }" "Ж" :string) (merge-rule "\IeC {\cyra }" "а" :string) (merge-rule "\IeC {\cyrb }" "б" :string) (merge-rule "\IeC {\cyrc }" "ц" :string) (merge-rule "\IeC {\cyrch }" "ч" :string) (merge-rule "\IeC {\cyrd }" "д" :string) (merge-rule "\IeC {\cyrdje }" "ђ" :string) (merge-rule "\IeC {\cyrdze }" "ѕ" :string) (merge-rule "\IeC {\cyrdzhe }" "џ" :string) (merge-rule "\IeC {\cyre }" "е" :string) (merge-rule "\IeC {\cyrerev }" "э" :string) (merge-rule "\IeC {\cyrery }" "ы" :string) (merge-rule "\IeC {\cyrf }" "ф" :string) (merge-rule "\IeC {\cyrg }" "г" :string) (merge-rule "\IeC {\cyrgup }" "ґ" :string) (merge-rule "\IeC {\cyrh }" "х" :string) (merge-rule "\IeC {\cyrhrdsn }" "ъ" :string) (merge-rule "\IeC {\cyri }" "и" :string) (merge-rule "\IeC {\cyrie }" "є" :string) (merge-rule "\IeC {\cyrii }" "і" :string) (merge-rule "\IeC {\cyrishrt }" "й" :string) (merge-rule "\IeC {\cyrje }" "ј" :string) (merge-rule "\IeC {\cyrk }" "к" :string) (merge-rule "\IeC {\cyrl }" "л" :string) (merge-rule "\IeC {\cyrlje }" "љ" :string) (merge-rule "\IeC {\cyrm }" "м" :string) (merge-rule "\IeC {\cyrn }" "н" :string) (merge-rule "\IeC {\cyrnje }" "њ" :string) (merge-rule "\IeC {\cyro }" "о" :string) (merge-rule "\IeC {\cyrp }" "п" :string) (merge-rule "\IeC {\cyrr }" "р" :string) (merge-rule "\IeC {\cyrs }" "с" :string) (merge-rule "\IeC {\cyrsftsn }" "ь" :string) (merge-rule "\IeC {\cyrsh }" "ш" :string) (merge-rule "\IeC {\cyrshch }" "щ" :string) (merge-rule "\IeC {\cyrt }" "т" :string) (merge-rule "\IeC {\cyrtshe }" "ћ" :string) (merge-rule "\IeC {\cyru }" "у" :string) (merge-rule "\IeC {\cyrushrt }" "ў" :string) (merge-rule "\IeC {\cyrv }" "в" :string) (merge-rule "\IeC {\cyrya }" "я" :string) (merge-rule "\IeC {\cyryi }" "ї" :string) (merge-rule "\IeC {\cyryo }" "ё" :string) (merge-rule "\IeC {\cyryu }" "ю" :string) (merge-rule "\IeC {\cyrz }" "з" :string) (merge-rule "\IeC {\cyrzh }" "ж" :string) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/LICRlatin2utf8.xdy0000644000076600000240000002371400000000000021116 0ustar00tkomiyastaff;; style file for xindy ;; filename: LICRlatin2utf8.xdy ;; description: style file for xindy which maps back LaTeX Internal ;; Character Representation of letters (as arising in .idx index ;; file) to UTF-8 encoding for correct sorting by xindy. ;; usage: for use with the pdflatex engine, ;; *not* for use with xelatex or lualatex. ;; ;; This is based upon xindy's distributed file tex/inputenc/utf8.xdy. ;; The modifications include: ;; ;; - Updates for compatibility with current LaTeX macro encoding. ;; ;; - Systematic usage of the \IeC {...} mark-up, because mark-up in ;; tex/inputenc/utf8.xdy was using it on seemingly random basis, and ;; Sphinx coercing of xindy usability for both Latin and Cyrillic scripts ;; with pdflatex requires its systematic presence here. ;; ;; - Support for some extra letters: Ÿ, Ŋ, ŋ, Œ, œ, IJ, ij, ȷ and ẞ. ;; ;; Indeed Sphinx needs to support for pdflatex engine all Unicode letters ;; available in TeX T1 font encoding. The above letters are found in ;; that encoding but not in the Latin1, 2, 3 charsets which are those ;; covered by original tex/inputenc/utf8.xdy. ;; ;; - There is a problem that ȷ is not supported out-of-the box by LaTeX ;; with inputenc, one must add explicitly ;; \DeclareUnicodeCharacter{0237}{\j} ;; to preamble of LaTeX document. However this character is not supported ;; by the TeX "times" font used by default by Sphinx for pdflatex engine. ;; ;; **Update**: since LaTeX 2018/12/01, the \j as well as \SS, \k{} and ;; \.{} need no extra user declaration anymore. ;; ;; - ẞ needs \DeclareUnicodeCharacter{1E9E}{\SS} (but ß needs no extra set-up). ;; ;; - U+02DB (˛) and U+02D9 (˙) are also not supported by inputenc ;; out of the box and require ;; \DeclareUnicodeCharacter{02DB}{\k{}} ;; \DeclareUnicodeCharacter{02D9}{\.{}} ;; to be added to preamble. ;; ;; - U+0127 ħ and U+0126 Ħ are absent from TeX T1+TS1 font encodings. ;; ;; - Characters Ŋ and ŋ are not supported by TeX font "times" used by ;; default by Sphinx for pdflatex engine but they are supported by ;; some TeX fonts, in particular by the default LaTeX font for T1 ;; encoding. ;; ;; - " and ~ must be escaped as ~" and resp. ~~ in xindy merge rules. ;; ;; Contributed by the Sphinx team, July 2018. ;; ;; See sphinx.xdy for superior figures, as they are escaped by LaTeX writer. (merge-rule "\IeC {\textonesuperior }" "¹" :string) (merge-rule "\IeC {\texttwosuperior }" "²" :string) (merge-rule "\IeC {\textthreesuperior }" "³" :string) (merge-rule "\IeC {\'a}" "á" :string) (merge-rule "\IeC {\'A}" "Á" :string) (merge-rule "\IeC {\`a}" "à" :string) (merge-rule "\IeC {\`A}" "À" :string) (merge-rule "\IeC {\^a}" "â" :string) (merge-rule "\IeC {\^A}" "Â" :string) (merge-rule "\IeC {\~"a}" "ä" :string) (merge-rule "\IeC {\~"A}" "Ä" :string) (merge-rule "\IeC {\~~a}" "ã" :string) (merge-rule "\IeC {\~~A}" "Ã" :string) (merge-rule "\IeC {\c c}" "ç" :string) (merge-rule "\IeC {\c C}" "Ç" :string) (merge-rule "\IeC {\'c}" "ć" :string) (merge-rule "\IeC {\'C}" "Ć" :string) (merge-rule "\IeC {\^c}" "ĉ" :string) (merge-rule "\IeC {\^C}" "Ĉ" :string) (merge-rule "\IeC {\.c}" "ċ" :string) (merge-rule "\IeC {\.C}" "Ċ" :string) (merge-rule "\IeC {\c s}" "ş" :string) (merge-rule "\IeC {\c S}" "Ş" :string) (merge-rule "\IeC {\c t}" "ţ" :string) (merge-rule "\IeC {\c T}" "Ţ" :string) (merge-rule "\IeC {\-}" "­" :string); soft hyphen (merge-rule "\IeC {\textdiv }" "÷" :string) (merge-rule "\IeC {\'e}" "é" :string) (merge-rule "\IeC {\'E}" "É" :string) (merge-rule "\IeC {\`e}" "è" :string) (merge-rule "\IeC {\`E}" "È" :string) (merge-rule "\IeC {\^e}" "ê" :string) (merge-rule "\IeC {\^E}" "Ê" :string) (merge-rule "\IeC {\~"e}" "ë" :string) (merge-rule "\IeC {\~"E}" "Ë" :string) (merge-rule "\IeC {\^g}" "ĝ" :string) (merge-rule "\IeC {\^G}" "Ĝ" :string) (merge-rule "\IeC {\.g}" "ġ" :string) (merge-rule "\IeC {\.G}" "Ġ" :string) (merge-rule "\IeC {\^h}" "ĥ" :string) (merge-rule "\IeC {\^H}" "Ĥ" :string) (merge-rule "\IeC {\H o}" "ő" :string) (merge-rule "\IeC {\H O}" "Ő" :string) (merge-rule "\IeC {\textacutedbl }" "˝" :string) (merge-rule "\IeC {\H u}" "ű" :string) (merge-rule "\IeC {\H U}" "Ű" :string) (merge-rule "\IeC {\ae }" "æ" :string) (merge-rule "\IeC {\AE }" "Æ" :string) (merge-rule "\IeC {\textcopyright }" "©" :string) (merge-rule "\IeC {\c \ }" "¸" :string) (merge-rule "\IeC {\dh }" "ð" :string) (merge-rule "\IeC {\DH }" "Ð" :string) (merge-rule "\IeC {\dj }" "đ" :string) (merge-rule "\IeC {\DJ }" "Đ" :string) (merge-rule "\IeC {\guillemotleft }" "«" :string) (merge-rule "\IeC {\guillemotright }" "»" :string) (merge-rule "\IeC {\'\i }" "í" :string) (merge-rule "\IeC {\`\i }" "ì" :string) (merge-rule "\IeC {\^\i }" "î" :string) (merge-rule "\IeC {\~"\i }" "ï" :string) (merge-rule "\IeC {\i }" "ı" :string) (merge-rule "\IeC {\^\j }" "ĵ" :string) (merge-rule "\IeC {\k {}}" "˛" :string) (merge-rule "\IeC {\l }" "ł" :string) (merge-rule "\IeC {\L }" "Ł" :string) (merge-rule "\IeC {\nobreakspace }" " " :string) (merge-rule "\IeC {\o }" "ø" :string) (merge-rule "\IeC {\O }" "Ø" :string) (merge-rule "\IeC {\textsterling }" "£" :string) (merge-rule "\IeC {\textparagraph }" "¶" :string) (merge-rule "\IeC {\ss }" "ß" :string) (merge-rule "\IeC {\textsection }" "§" :string) (merge-rule "\IeC {\textbrokenbar }" "¦" :string) (merge-rule "\IeC {\textcent }" "¢" :string) (merge-rule "\IeC {\textcurrency }" "¤" :string) (merge-rule "\IeC {\textdegree }" "°" :string) (merge-rule "\IeC {\textexclamdown }" "¡" :string) (merge-rule "\IeC {\texthbar }" "ħ" :string) (merge-rule "\IeC {\textHbar }" "Ħ" :string) (merge-rule "\IeC {\textonehalf }" "½" :string) (merge-rule "\IeC {\textonequarter }" "¼" :string) (merge-rule "\IeC {\textordfeminine }" "ª" :string) (merge-rule "\IeC {\textordmasculine }" "º" :string) (merge-rule "\IeC {\textperiodcentered }" "·" :string) (merge-rule "\IeC {\textquestiondown }" "¿" :string) (merge-rule "\IeC {\textregistered }" "®" :string) (merge-rule "\IeC {\textthreequarters }" "¾" :string) (merge-rule "\IeC {\textyen }" "¥" :string) (merge-rule "\IeC {\th }" "þ" :string) (merge-rule "\IeC {\TH }" "Þ" :string) (merge-rule "\IeC {\'I}" "Í" :string) (merge-rule "\IeC {\`I}" "Ì" :string) (merge-rule "\IeC {\^I}" "Î" :string) (merge-rule "\IeC {\~"I}" "Ï" :string) (merge-rule "\IeC {\.I}" "İ" :string) (merge-rule "\IeC {\^J}" "Ĵ" :string) (merge-rule "\IeC {\k a}" "ą" :string) (merge-rule "\IeC {\k A}" "Ą" :string) (merge-rule "\IeC {\k e}" "ę" :string) (merge-rule "\IeC {\k E}" "Ę" :string) (merge-rule "\IeC {\'l}" "ĺ" :string) (merge-rule "\IeC {\'L}" "Ĺ" :string) (merge-rule "\IeC {\textlnot }" "¬" :string) (merge-rule "\IeC {\textmu }" "µ" :string) (merge-rule "\IeC {\'n}" "ń" :string) (merge-rule "\IeC {\'N}" "Ń" :string) (merge-rule "\IeC {\~~n}" "ñ" :string) (merge-rule "\IeC {\~~N}" "Ñ" :string) (merge-rule "\IeC {\'o}" "ó" :string) (merge-rule "\IeC {\'O}" "Ó" :string) (merge-rule "\IeC {\`o}" "ò" :string) (merge-rule "\IeC {\`O}" "Ò" :string) (merge-rule "\IeC {\^o}" "ô" :string) (merge-rule "\IeC {\^O}" "Ô" :string) (merge-rule "\IeC {\~"o}" "ö" :string) (merge-rule "\IeC {\~"O}" "Ö" :string) (merge-rule "\IeC {\~~o}" "õ" :string) (merge-rule "\IeC {\~~O}" "Õ" :string) (merge-rule "\IeC {\textpm }" "±" :string) (merge-rule "\IeC {\r a}" "å" :string) (merge-rule "\IeC {\r A}" "Å" :string) (merge-rule "\IeC {\'r}" "ŕ" :string) (merge-rule "\IeC {\'R}" "Ŕ" :string) (merge-rule "\IeC {\r u}" "ů" :string) (merge-rule "\IeC {\r U}" "Ů" :string) (merge-rule "\IeC {\'s}" "ś" :string) (merge-rule "\IeC {\'S}" "Ś" :string) (merge-rule "\IeC {\^s}" "ŝ" :string) (merge-rule "\IeC {\^S}" "Ŝ" :string) (merge-rule "\IeC {\textasciidieresis }" "¨" :string) (merge-rule "\IeC {\textasciimacron }" "¯" :string) (merge-rule "\IeC {\.{}}" "˙" :string) (merge-rule "\IeC {\textasciiacute }" "´" :string) (merge-rule "\IeC {\texttimes }" "×" :string) (merge-rule "\IeC {\u a}" "ă" :string) (merge-rule "\IeC {\u A}" "Ă" :string) (merge-rule "\IeC {\u g}" "ğ" :string) (merge-rule "\IeC {\u G}" "Ğ" :string) (merge-rule "\IeC {\textasciibreve }" "˘" :string) (merge-rule "\IeC {\'u}" "ú" :string) (merge-rule "\IeC {\'U}" "Ú" :string) (merge-rule "\IeC {\`u}" "ù" :string) (merge-rule "\IeC {\`U}" "Ù" :string) (merge-rule "\IeC {\^u}" "û" :string) (merge-rule "\IeC {\^U}" "Û" :string) (merge-rule "\IeC {\~"u}" "ü" :string) (merge-rule "\IeC {\~"U}" "Ü" :string) (merge-rule "\IeC {\u u}" "ŭ" :string) (merge-rule "\IeC {\u U}" "Ŭ" :string) (merge-rule "\IeC {\v c}" "č" :string) (merge-rule "\IeC {\v C}" "Č" :string) (merge-rule "\IeC {\v d}" "ď" :string) (merge-rule "\IeC {\v D}" "Ď" :string) (merge-rule "\IeC {\v e}" "ě" :string) (merge-rule "\IeC {\v E}" "Ě" :string) (merge-rule "\IeC {\v l}" "ľ" :string) (merge-rule "\IeC {\v L}" "Ľ" :string) (merge-rule "\IeC {\v n}" "ň" :string) (merge-rule "\IeC {\v N}" "Ň" :string) (merge-rule "\IeC {\v r}" "ř" :string) (merge-rule "\IeC {\v R}" "Ř" :string) (merge-rule "\IeC {\v s}" "š" :string) (merge-rule "\IeC {\v S}" "Š" :string) (merge-rule "\IeC {\textasciicaron }" "ˇ" :string) (merge-rule "\IeC {\v t}" "ť" :string) (merge-rule "\IeC {\v T}" "Ť" :string) (merge-rule "\IeC {\v z}" "ž" :string) (merge-rule "\IeC {\v Z}" "Ž" :string) (merge-rule "\IeC {\'y}" "ý" :string) (merge-rule "\IeC {\'Y}" "Ý" :string) (merge-rule "\IeC {\~"y}" "ÿ" :string) (merge-rule "\IeC {\'z}" "ź" :string) (merge-rule "\IeC {\'Z}" "Ź" :string) (merge-rule "\IeC {\.z}" "ż" :string) (merge-rule "\IeC {\.Z}" "Ż" :string) ;; letters not in Latin1, 2, 3 but available in TeX T1 font encoding (merge-rule "\IeC {\~"Y}" "Ÿ" :string) (merge-rule "\IeC {\NG }" "Ŋ" :string) (merge-rule "\IeC {\ng }" "ŋ" :string) (merge-rule "\IeC {\OE }" "Œ" :string) (merge-rule "\IeC {\oe }" "œ" :string) (merge-rule "\IeC {\IJ }" "IJ" :string) (merge-rule "\IeC {\ij }" "ij" :string) (merge-rule "\IeC {\j }" "ȷ" :string) (merge-rule "\IeC {\SS }" "ẞ" :string) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/sphinx/texinputs/LatinRules.xdy0000644000076600000240000004440500000000000020526 0ustar00tkomiyastaff;; style file for xindy ;; filename: LatinRules.xdy ;; ;; It is based upon xindy's files lang/general/utf8.xdy and ;; lang/general/utf8-lang.xdy which implement ;; "a general sorting order for Western European languages" ;; ;; The aim for Sphinx is to be able to index in a Cyrillic document ;; also terms using the Latin alphabets, inclusive of letters ;; with diacritics. To this effect the xindy rules from lang/general ;; got manually re-coded to avoid collisions with the encoding ;; done by xindy for sorting words in Cyrillic languages, which was ;; observed not to use bytes with octal encoding 0o266 or higher. ;; ;; So here we use only 0o266 or higher bytes. ;; (Ŋ, ŋ, IJ, and ij are absent from ;; lang/general/utf8.xdy and not included here) ;; Contributed by the Sphinx team, 2018. (define-letter-group "A" :prefixes ("")) (define-letter-group "B" :after "A" :prefixes ("")) (define-letter-group "C" :after "B" :prefixes ("")) (define-letter-group "D" :after "C" :prefixes ("")) (define-letter-group "E" :after "D" :prefixes ("")) (define-letter-group "F" :after "E" :prefixes ("")) (define-letter-group "G" :after "F" :prefixes ("")) (define-letter-group "H" :after "G" :prefixes ("")) (define-letter-group "I" :after "H" :prefixes ("")) (define-letter-group "J" :after "I" :prefixes ("")) (define-letter-group "K" :after "J" :prefixes ("")) (define-letter-group "L" :after "K" :prefixes ("")) (define-letter-group "M" :after "L" :prefixes ("")) (define-letter-group "N" :after "M" :prefixes ("")) (define-letter-group "O" :after "N" :prefixes ("")) (define-letter-group "P" :after "O" :prefixes ("")) (define-letter-group "Q" :after "P" :prefixes ("")) (define-letter-group "R" :after "Q" :prefixes ("")) (define-letter-group "S" :after "R" :prefixes ("")) (define-letter-group "T" :after "S" :prefixes ("")) (define-letter-group "U" :after "T" :prefixes ("")) (define-letter-group "V" :after "U" :prefixes ("")) (define-letter-group "W" :after "V" :prefixes ("")) (define-letter-group "X" :after "W" :prefixes ("")) (define-letter-group "Y" :after "X" :prefixes ("")) (define-letter-group "Z" :after "Y" :prefixes ("")) (define-rule-set "sphinx-xy-alphabetize" :rules (("À" "" :string) ("Ă" "" :string) ("â" "" :string) ("Ä" "" :string) ("à" "" :string) ("Å" "" :string) ("Ã" "" :string) ("Á" "" :string) ("á" "" :string) ("ã" "" :string) ("Â" "" :string) ("ă" "" :string) ("å" "" :string) ("ą" "" :string) ("ä" "" :string) ("Ą" "" :string) ("æ" "" :string) ("Æ" "" :string) ("ć" "" :string) ("ĉ" "" :string) ("ç" "" :string) ("Č" "" :string) ("č" "" :string) ("Ĉ" "" :string) ("Ç" "" :string) ("Ć" "" :string) ("ď" "" :string) ("Đ" "" :string) ("Ď" "" :string) ("đ" "" :string) ("ê" "" :string) ("Ę" "" :string) ("Ě" "" :string) ("ë" "" :string) ("ě" "" :string) ("é" "" :string) ("È" "" :string) ("Ë" "" :string) ("É" "" :string) ("è" "" :string) ("Ê" "" :string) ("ę" "" :string) ("ĝ" "" :string) ("ğ" "" :string) ("Ğ" "" :string) ("Ĝ" "" :string) ("ĥ" "" :string) ("Ĥ" "" :string) ("Ï" "" :string) ("Í" "" :string) ("ï" "" :string) ("Î" "" :string) ("î" "" :string) ("ı" "" :string) ("İ" "" :string) ("í" "" :string) ("Ì" "" :string) ("ì" "" :string) ("Ĵ" "" :string) ("ĵ" "" :string) ("ł" "" :string) ("Ł" "" :string) ("ľ" "" :string) ("Ľ" "" :string) ("ń" "" :string) ("Ń" "" :string) ("ñ" "" :string) ("ň" "" :string) ("Ñ" "" :string) ("Ň" "" :string) ("Õ" "" :string) ("Ő" "" :string) ("ó" "" :string) ("ö" "" :string) ("ô" "" :string) ("ő" "" :string) ("Ø" "" :string) ("Ö" "" :string) ("õ" "" :string) ("Ô" "" :string) ("ø" "" :string) ("Ó" "" :string) ("Ò" "" :string) ("ò" "" :string) ("œ" "ĺ" :string) ("Œ" "ĺ" :string) ("Ř" "" :string) ("ř" "" :string) ("Ŕ" "" :string) ("ŕ" "" :string) ("ŝ" "" :string) ("Ś" "" :string) ("ș" "" :string) ("ş" "" :string) ("Ŝ" "" :string) ("ś" "" :string) ("Ș" "" :string) ("š" "" :string) ("Ş" "" :string) ("Š" "" :string) ("ß" "" :string) ("Ț" "" :string) ("Ť" "" :string) ("ț" "" :string) ("ť" "" :string) ("û" "" :string) ("ŭ" "" :string) ("ů" "" :string) ("ű" "" :string) ("ù" "" :string) ("Ŭ" "" :string) ("Ù" "" :string) ("Ű" "" :string) ("Ü" "" :string) ("Ů" "" :string) ("ú" "" :string) ("Ú" "" :string) ("Û" "" :string) ("ü" "" :string) ("ÿ" "" :string) ("Ý" "" :string) ("Ÿ" "" :string) ("ý" "" :string) ("Ż" "" :string) ("Ž" "" :string) ("Ź" "" :string) ("ž" "" :string) ("ż" "" :string) ("ź" "" :string) ("a" "" :string) ("A" "" :string) ("b" "" :string) ("B" "" :string) ("c" "" :string) ("C" "" :string) ("d" "" :string) ("D" "" :string) ("e" "" :string) ("E" "" :string) ("F" "" :string) ("f" "" :string) ("G" "" :string) ("g" "" :string) ("H" "" :string) ("h" "" :string) ("i" "" :string) ("I" "" :string) ("J" "" :string) ("j" "" :string) ("K" "" :string) ("k" "" :string) ("L" "" :string) ("l" "" :string) ("M" "" :string) ("m" "" :string) ("n" "" :string) ("N" "" :string) ("O" "" :string) ("o" "" :string) ("p" "" :string) ("P" "" :string) ("Q" "" :string) ("q" "" :string) ("r" "" :string) ("R" "" :string) ("S" "" :string) ("s" "" :string) ("t" "" :string) ("T" "" :string) ("u" "" :string) ("U" "" :string) ("v" "" :string) ("V" "" :string) ("W" "" :string) ("w" "" :string) ("x" "" :string) ("X" "" :string) ("Y" "" :string) ("y" "" :string) ("z" "" :string) ("Z" "" :string) )) (define-rule-set "sphinx-xy-resolve-diacritics" :rules (("Ĥ" "" :string) ("ó" "" :string) ("ľ" "" :string) ("Ř" "" :string) ("ĝ" "" :string) ("ď" "" :string) ("Ě" "" :string) ("ĥ" "" :string) ("Č" "" :string) ("Ĵ" "" :string) ("ě" "" :string) ("ž" "" :string) ("Ď" "" :string) ("ř" "" :string) ("Ž" "" :string) ("ı" "" :string) ("Ť" "" :string) ("á" "" :string) ("č" "" :string) ("Á" "" :string) ("ň" "" :string) ("Š" "" :string) ("Ň" "" :string) ("ĵ" "" :string) ("ť" "" :string) ("Ó" "" :string) ("ý" "" :string) ("Ĝ" "" :string) ("Ú" "" :string) ("Ľ" "" :string) ("š" "" :string) ("Ý" "" :string) ("ú" "" :string) ("Ś" "" :string) ("ć" "" :string) ("Ł" "" :string) ("ł" "" :string) ("ń" "" :string) ("À" "" :string) ("Ź" "" :string) ("à" "" :string) ("Ń" "" :string) ("Đ" "" :string) ("ÿ" "" :string) ("ś" "" :string) ("Ğ" "" :string) ("ğ" "" :string) ("Ù" "" :string) ("İ" "" :string) ("đ" "" :string) ("ù" "" :string) ("Ț" "" :string) ("é" "" :string) ("ŕ" "" :string) ("Ć" "" :string) ("ț" "" :string) ("ò" "" :string) ("ź" "" :string) ("Ò" "" :string) ("Ÿ" "" :string) ("Ŕ" "" :string) ("É" "" :string) ("ĉ" "" :string) ("ô" "" :string) ("Í" "" :string) ("ŝ" "" :string) ("Ż" "" :string) ("Ă" "" :string) ("Ŝ" "" :string) ("ñ" "" :string) ("ŭ" "" :string) ("í" "" :string) ("È" "" :string) ("Ô" "" :string) ("Ŭ" "" :string) ("ż" "" :string) ("Ñ" "" :string) ("è" "" :string) ("Ĉ" "" :string) ("ă" "" :string) ("â" "" :string) ("û" "" :string) ("ê" "" :string) ("Õ" "" :string) ("õ" "" :string) ("ș" "" :string) ("ç" "" :string) ("Â" "" :string) ("Ê" "" :string) ("Û" "" :string) ("Ç" "" :string) ("ì" "" :string) ("Ì" "" :string) ("Ș" "" :string) ("ö" "" :string) ("Ö" "" :string) ("ş" "" :string) ("ů" "" :string) ("ë" "" :string) ("ã" "" :string) ("î" "" :string) ("Î" "" :string) ("Ã" "" :string) ("Ş" "" :string) ("Ů" "" :string) ("Ë" "" :string) ("ï" "" :string) ("Ő" "" :string) ("Ï" "" :string) ("Ę" "" :string) ("ő" "" :string) ("Ü" "" :string) ("Å" "" :string) ("ü" "" :string) ("ę" "" :string) ("å" "" :string) ("Ä" "" :string) ("ű" "" :string) ("Ø" "" :string) ("ø" "" :string) ("Ű" "" :string) ("ä" "" :string) ("Ą" "" :string) ("ą" "" :string) ("œ" "" :string) ("ß" "" :string) ("Æ" "" :string) ("Œ" "" :string) ("æ" "" :string) ("e" "" :string) ("t" "" :string) ("L" "" :string) ("Y" "" :string) ("J" "" :string) ("a" "" :string) ("p" "" :string) ("u" "" :string) ("j" "" :string) ("b" "" :string) ("G" "" :string) ("U" "" :string) ("F" "" :string) ("H" "" :string) ("i" "" :string) ("z" "" :string) ("c" "" :string) ("l" "" :string) ("A" "" :string) ("Q" "" :string) ("w" "" :string) ("D" "" :string) ("R" "" :string) ("d" "" :string) ("s" "" :string) ("r" "" :string) ("k" "" :string) ("v" "" :string) ("m" "" :string) ("P" "" :string) ("y" "" :string) ("K" "" :string) ("q" "" :string) ("S" "" :string) ("I" "" :string) ("C" "" :string) ("M" "" :string) ("Z" "" :string) ("T" "" :string) ("W" "" :string) ("B" "" :string) ("h" "" :string) ("x" "" :string) ("X" "" :string) ("f" "" :string) ("E" "" :string) ("V" "" :string) ("N" "" :string) ("O" "" :string) ("o" "" :string) ("g" "" :string) ("n" "" :string) )) (define-rule-set "sphinx-xy-resolve-case" :rules (("Ú" "8" :string) ("Ÿ" "8" :string) ("Ç" "8" :string) ("Ĉ" "8" :string) ("Ŕ" "8" :string) ("Ľ" "8" :string) ("Ů" "8" :string) ("Ý" "8" :string) ("É" "8" :string) ("Ë" "8" :string) ("Ș" "8" :string) ("Ì" "8" :string) ("Ê" "8" :string) ("Ň" "8" :string) ("Ą" "8" :string) ("Š" "8" :string) ("Û" "8" :string) ("Ş" "8" :string) ("Ć" "8" :string) ("Ò" "8" :string) ("Ĝ" "8" :string) ("Ñ" "8" :string) ("Ó" "8" :string) ("Î" "8" :string) ("Á" "8" :string) ("Ã" "8" :string) ("Ț" "8" :string) ("Å" "8" :string) ("Ğ" "8" :string) ("Ü" "8" :string) ("È" "8" :string) ("Ô" "8" :string) ("İ" "8" :string) ("Ű" "8" :string) ("Ù" "8" :string) ("Ŭ" "8" :string) ("Â" "8" :string) ("Ť" "8" :string) ("Ń" "8" :string) ("Ď" "8" :string) ("Ź" "8" :string) ("Ž" "8" :string) ("Đ" "8" :string) ("Ŝ" "8" :string) ("Č" "8" :string) ("Ĵ" "8" :string) ("Ö" "8" :string) ("Ø" "8" :string) ("Ż" "8" :string) ("Ł" "8" :string) ("Ă" "8" :string) ("Ě" "8" :string) ("Ő" "8" :string) ("Õ" "8" :string) ("Ę" "8" :string) ("Ï" "8" :string) ("À" "8" :string) ("Ĥ" "8" :string) ("Ä" "8" :string) ("Ś" "8" :string) ("Ř" "8" :string) ("Í" "8" :string) ("Œ" "89" :string) ("Æ" "89" :string) ("ì" "9" :string) ("è" "9" :string) ("ą" "9" :string) ("š" "9" :string) ("ú" "9" :string) ("å" "9" :string) ("ă" "9" :string) ("ę" "9" :string) ("ü" "9" :string) ("ź" "9" :string) ("ò" "9" :string) ("ť" "9" :string) ("ț" "9" :string) ("ĵ" "9" :string) ("ŕ" "9" :string) ("ż" "9" :string) ("ä" "9" :string) ("ý" "9" :string) ("ù" "9" :string) ("á" "9" :string) ("é" "9" :string) ("č" "9" :string) ("ň" "9" :string) ("ś" "9" :string) ("ø" "9" :string) ("í" "9" :string) ("đ" "9" :string) ("ı" "9" :string) ("ğ" "9" :string) ("î" "9" :string) ("ã" "9" :string) ("à" "9" :string) ("ř" "9" :string) ("ő" "9" :string) ("ů" "9" :string) ("ș" "9" :string) ("ÿ" "9" :string) ("ë" "9" :string) ("ŭ" "9" :string) ("ç" "9" :string) ("ű" "9" :string) ("ñ" "9" :string) ("õ" "9" :string) ("ě" "9" :string) ("ş" "9" :string) ("ž" "9" :string) ("ĝ" "9" :string) ("ŝ" "9" :string) ("ń" "9" :string) ("û" "9" :string) ("ł" "9" :string) ("ď" "9" :string) ("ĥ" "9" :string) ("ê" "9" :string) ("ô" "9" :string) ("ĉ" "9" :string) ("â" "9" :string) ("ć" "9" :string) ("ï" "9" :string) ("ö" "9" :string) ("ľ" "9" :string) ("ó" "9" :string) ("æ" "99" :string) ("ß" "99" :string) ("œ" "99" :string) ("N" "8" :string) ("V" "8" :string) ("O" "8" :string) ("X" "8" :string) ("E" "8" :string) ("P" "8" :string) ("K" "8" :string) ("T" "8" :string) ("Z" "8" :string) ("M" "8" :string) ("C" "8" :string) ("I" "8" :string) ("S" "8" :string) ("B" "8" :string) ("W" "8" :string) ("D" "8" :string) ("R" "8" :string) ("H" "8" :string) ("F" "8" :string) ("Q" "8" :string) ("A" "8" :string) ("G" "8" :string) ("U" "8" :string) ("J" "8" :string) ("Y" "8" :string) ("L" "8" :string) ("o" "9" :string) ("n" "9" :string) ("g" "9" :string) ("x" "9" :string) ("f" "9" :string) ("y" "9" :string) ("q" "9" :string) ("h" "9" :string) ("w" "9" :string) ("s" "9" :string) ("d" "9" :string) ("v" "9" :string) ("k" "9" :string) ("r" "9" :string) ("m" "9" :string) ("z" "9" :string) ("c" "9" :string) ("i" "9" :string) ("l" "9" :string) ("b" "9" :string) ("j" "9" :string) ("a" "9" :string) ("p" "9" :string) ("u" "9" :string) ("t" "9" :string) ("e" "9" :string) )) (use-rule-set :run 0 :rule-set ("sphinx-xy-alphabetize")) (use-rule-set :run 1 :rule-set ("sphinx-xy-resolve-diacritics")) (use-rule-set :run 2 :rule-set ("sphinx-xy-resolve-case")) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/texinputs/Makefile_t0000644000076600000240000000454100000000000017676 0ustar00tkomiyastaff# Makefile for Sphinx LaTeX output ALLDOCS = $(basename $(wildcard *.tex)) ALLPDF = $(addsuffix .pdf,$(ALLDOCS)) {% if latex_engine == 'xelatex' -%} ALLDVI = ALLXDV = $(addsuffix .xdv,$(ALLDOCS)) {% else -%} ALLDVI = $(addsuffix .dvi,$(ALLDOCS)) ALLXDV = {% endif -%} ALLPS = $(addsuffix .ps,$(ALLDOCS)) # Prefix for archive names ARCHIVEPREFIX = # Additional LaTeX options (passed via variables in latexmkrc/latexmkjarc file) export LATEXOPTS ?= # Additional latexmk options {% if latex_engine == 'xelatex' -%} # with latexmk version 4.52b or higher set LATEXMKOPTS to -xelatex either here # or on command line for faster builds. {% endif -%} LATEXMKOPTS ?= {% if xindy_use -%} export XINDYOPTS = {{ xindy_lang_option }} -M sphinx.xdy {% if latex_engine == 'pdflatex' -%} XINDYOPTS += -M LICRlatin2utf8.xdy {% if xindy_cyrillic -%} XINDYOPTS += -M LICRcyr2utf8.xdy {% endif -%} {% endif -%} {% if xindy_cyrillic -%} XINDYOPTS += -M LatinRules.xdy {% endif -%} {% endif -%} # format: pdf or dvi (used only by archive targets) FMT = pdf {% if latex_engine in ('platex', 'uplatex') -%} # latexmkrc is read then overridden by latexmkjarc LATEX = latexmk -r latexmkjarc -dvi PDFLATEX = latexmk -r latexmkjarc -pdfdvi -dvi- -ps- {% else -%} LATEX = latexmk -dvi PDFLATEX = latexmk -pdf -dvi- -ps- {% endif %} {% if latex_engine != 'xelatex' -%} %.dvi: %.tex FORCE_MAKE $(LATEX) $(LATEXMKOPTS) '$<' {% endif -%} %.ps: %.dvi dvips '$<' %.pdf: %.tex FORCE_MAKE $(PDFLATEX) $(LATEXMKOPTS) '$<' all: $(ALLPDF) all-dvi: $(ALLDVI) all-ps: $(ALLPS) all-pdf: $(ALLPDF) zip: all-$(FMT) mkdir $(ARCHIVEPREFIX)docs-$(FMT) cp $(ALLPDF) $(ARCHIVEPREFIX)docs-$(FMT) zip -q -r -9 $(ARCHIVEPREFIX)docs-$(FMT).zip $(ARCHIVEPREFIX)docs-$(FMT) rm -r $(ARCHIVEPREFIX)docs-$(FMT) tar: all-$(FMT) mkdir $(ARCHIVEPREFIX)docs-$(FMT) cp $(ALLPDF) $(ARCHIVEPREFIX)docs-$(FMT) tar cf $(ARCHIVEPREFIX)docs-$(FMT).tar $(ARCHIVEPREFIX)docs-$(FMT) rm -r $(ARCHIVEPREFIX)docs-$(FMT) gz: tar gzip -9 < $(ARCHIVEPREFIX)docs-$(FMT).tar > $(ARCHIVEPREFIX)docs-$(FMT).tar.gz bz2: tar bzip2 -9 -k $(ARCHIVEPREFIX)docs-$(FMT).tar xz: tar xz -9 -k $(ARCHIVEPREFIX)docs-$(FMT).tar clean: rm -f *.log *.ind *.aux *.toc *.syn *.idx *.out *.ilg *.pla *.ps *.tar *.tar.gz *.tar.bz2 *.tar.xz $(ALLPDF) $(ALLDVI) $(ALLXDV) *.fls *.fdb_latexmk .PHONY: all all-pdf all-dvi all-ps clean zip tar gz bz2 xz .PHONY: FORCE_MAKE ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163740.0 Sphinx-4.3.2/sphinx/texinputs/latexmkjarc_t0000644000076600000240000000126700000000000020470 0ustar00tkomiyastaff$latex = '{{ latex_engine }} ' . $ENV{'LATEXOPTS'} . ' -kanji=utf8 %O %S'; $dvipdf = 'dvipdfmx %O -o %D %S'; $makeindex = 'internal mendex %S %B %D'; sub mendex { my ($source, $basename, $destination) = @_; my $dictfile = $basename . ".dic"; unlink($destination); system("mendex", "-U", "-f", "-d", $dictfile, "-s", "python.ist", $source); if ($? > 0) { print("mendex exited with error code $? (ignored)\n"); } if (!-e $destination) { # create an empty .ind file if nothing open(FH, ">" . $destination); close(FH); } return 0; } add_cus_dep( "glo", "gls", 0, "makeglo" ); sub makeglo { return system( "mendex -J -f -s gglo.ist -o '$_[0].gls' '$_[0].glo'" ); } ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/sphinx/texinputs/latexmkrc_t0000644000076600000240000000212000000000000020142 0ustar00tkomiyastaff{% if latex_engine == 'pdflatex' -%} $latex = 'latex ' . $ENV{'LATEXOPTS'} . ' %O %S'; $pdflatex = 'pdflatex ' . $ENV{'LATEXOPTS'} . ' %O %S'; {% elif latex_engine == 'lualatex' -%} $latex = 'lualatex --output-format=dvi ' . $ENV{'LATEXOPTS'} . ' %O %S'; $pdflatex = 'lualatex ' . $ENV{'LATEXOPTS'} . ' %O %S'; {% elif latex_engine == 'xelatex' -%} $latex = 'xelatex --no-pdf ' . $ENV{'LATEXOPTS'} . ' %O %S'; $pdflatex = 'xelatex ' . $ENV{'LATEXOPTS'} . ' %O %S'; {% endif -%} $lualatex = 'lualatex ' . $ENV{'LATEXOPTS'} . ' %O %S'; $xelatex = 'xelatex --no-pdf ' . $ENV{'LATEXOPTS'} . ' %O %S'; {% if xindy_use -%} $makeindex = 'internal xindy ' . $ENV{'XINDYOPTS'} . ' %O -o %D %S'; sub xindy { my @args = @_; if (-z $args[-1]) { # create an empty .ind file if .idx is empty open(FH, ">" . $args[-2]); close(FH); return 0; } else { return system("xindy", @args); } } {% else -%} $makeindex = 'makeindex -s python.ist %O -o %D %S'; {% endif -%} add_cus_dep( "glo", "gls", 0, "makeglo" ); sub makeglo { return system( "makeindex -s gglo.ist -o '$_[0].gls' '$_[0].glo'" ); } ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/make.bat_t0000644000076600000240000000202100000000000017632 0ustar00tkomiyastaff@ECHO OFF REM Command file for Sphinx documentation pushd %~dp0 {% if latex_engine in ('platex', 'uplatex') -%} REM latexmkrc is read then overridden by latexmkjarc set PDFLATEX=latexmk -r latexmkjarc -pdfdvi -dvi- -ps- {% else -%} set PDFLATEX=latexmk -pdf -dvi- -ps- {% endif %} set "LATEXOPTS= " {% if xindy_use -%} set XINDYOPTS={{ xindy_lang_option }} -M sphinx.xdy {% if latex_engine == 'pdflatex' -%} set XINDYOPTS=%XINDYOPTS% -M LICRlatin2utf8.xdy {% if xindy_cyrillic -%} set XINDYOPTS=%XINDYOPTS% -M LICRcyr2utf8.xdy {% endif -%} {% endif -%} {% if xindy_cyrillic -%} set XINDYOPTS=%XINDYOPTS% -M LatinRules.xdy {% endif -%} set XINDYOPTS=%XINDYOPTS% -I xelatex {% endif -%} if "%1" == "" goto all-pdf if "%1" == "all-pdf" ( :all-pdf for %%i in (*.tex) do ( %PDFLATEX% %LATEXMKOPTS% %%i ) goto end ) if "%1" == "all-pdf-ja" ( goto all-pdf ) if "%1" == "clean" ( del /q /s *.dvi *.log *.ind *.aux *.toc *.syn *.idx *.out *.ilg *.pla *.ps *.tar *.tar.gz *.tar.bz2 *.tar.xz *.fls *.fdb_latexmk goto end ) :end popd ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/sphinx/texinputs/python.ist0000644000076600000240000000061000000000000017746 0ustar00tkomiyastaffline_max 100 headings_flag 1 heading_prefix " \\bigletter " preamble "\\begin{sphinxtheindex} \\let\\bigletter\\sphinxstyleindexlettergroup \\let\\spxpagem \\sphinxstyleindexpagemain \\let\\spxentry \\sphinxstyleindexentry \\let\\spxextra \\sphinxstyleindexextra " postamble "\n\n\\end{sphinxtheindex}\n" symhead_positive "{\\sphinxsymbolsname}" numhead_positive "{\\sphinxnumbersname}" ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinx.sty0000644000076600000240000003171600000000000017771 0ustar00tkomiyastaff% % sphinx.sty % % Adapted from the old python.sty, mostly written by Fred Drake, % by Georg Brandl. % \NeedsTeXFormat{LaTeX2e}[1995/12/01] \ProvidesPackage{sphinx}[2021/01/27 v4.0.0 LaTeX package (Sphinx markup)] % provides \ltx@ifundefined % (many packages load ltxcmds: graphicx does for pdftex and lualatex but % not xelatex, and anyhow kvoptions does, but it may be needed in future to % use \sphinxdeprecationwarning earlier, and it needs \ltx@ifundefined) \RequirePackage{ltxcmds} %% for deprecation warnings \newcommand\sphinxdeprecationwarning[4]{% #1 the deprecated macro or name, % #2 = when deprecated, #3 = when removed, #4 = additional info \edef\spx@tempa{\detokenize{#1}}% \ltx@ifundefined{sphinx_depr_\spx@tempa}{% \global\expandafter\let\csname sphinx_depr_\spx@tempa\endcsname\spx@tempa \expandafter\AtEndDocument\expandafter{\expandafter\let\expandafter \sphinxdeprecatedmacro\csname sphinx_depr_\spx@tempa\endcsname \PackageWarningNoLine{sphinx}{^^J**** SPHINX DEPRECATION WARNING:^^J \sphinxdeprecatedmacro^^J \@spaces- is deprecated at Sphinx #2^^J \@spaces- and removed at Sphinx #3.^^J #4^^J****}}% }{% warning already emitted (at end of latex log), don't repeat }} %% OPTION HANDLING % % We first handle options then load packages, but we need \definecolor from % xcolor/color. % FIXME: we should \RequirePackage{xcolor} always now % The xcolor package draws better fcolorboxes around verbatim code \IfFileExists{xcolor.sty}{ \RequirePackage{xcolor} }{ \RequirePackage{color} } % Handle options via "kvoptions" (later loaded by hyperref anyhow) \RequirePackage{kvoptions} \SetupKeyvalOptions{prefix=spx@opt@} % use \spx@opt@ prefix % Sphinx legacy text layout: 1in margins on all four sides \ifx\@jsc@uplatextrue\@undefined \DeclareStringOption[1in]{hmargin} \DeclareStringOption[1in]{vmargin} \DeclareStringOption[.5in]{marginpar} \else % Japanese standard document classes handle \mag in a special way \DeclareStringOption[\inv@mag in]{hmargin} \DeclareStringOption[\inv@mag in]{vmargin} \DeclareStringOption[.5\dimexpr\inv@mag in\relax]{marginpar} \fi \DeclareStringOption[0]{maxlistdepth}% \newcommand*\spx@opt@maxlistdepth{0} \DeclareStringOption[-1]{numfigreset} \DeclareBoolOption[false]{nonumfigreset} \DeclareBoolOption[false]{mathnumfig} \define@key{sphinx}{bookmarksdepth}{\AtBeginDocument{\hypersetup{bookmarksdepth=#1}}} \AtBeginDocument{\define@key{sphinx}{bookmarksdepth}{\hypersetup{bookmarksdepth=#1}}} % \DeclareBoolOption[false]{usespart}% not used % dimensions, we declare the \dimen registers here. \newdimen\sphinxverbatimsep \newdimen\sphinxverbatimborder \newdimen\sphinxshadowsep \newdimen\sphinxshadowsize \newdimen\sphinxshadowrule % \DeclareStringOption is not convenient for the handling of these dimensions % because we want to assign the values to the corresponding registers. Even if % we added the code to the key handler it would be too late for the initial % set-up and we would need to do initial assignments explicitly. We end up % using \define@key directly. % verbatim \sphinxverbatimsep=\fboxsep \define@key{sphinx}{verbatimsep}{\sphinxverbatimsep\dimexpr #1\relax} \sphinxverbatimborder=\fboxrule \define@key{sphinx}{verbatimborder}{\sphinxverbatimborder\dimexpr #1\relax} % topic boxes \sphinxshadowsep =5pt \define@key{sphinx}{shadowsep}{\sphinxshadowsep\dimexpr #1\relax} \sphinxshadowsize=4pt \define@key{sphinx}{shadowsize}{\sphinxshadowsize\dimexpr #1\relax} \sphinxshadowrule=\fboxrule \define@key{sphinx}{shadowrule}{\sphinxshadowrule\dimexpr #1\relax} % verbatim \DeclareBoolOption[true]{verbatimwithframe} \DeclareBoolOption[true]{verbatimwrapslines} \DeclareBoolOption[false]{verbatimforcewraps} \DeclareStringOption[3]{verbatimmaxoverfull} \DeclareStringOption[100]{verbatimmaxunderfull} \DeclareBoolOption[true]{verbatimhintsturnover} \DeclareBoolOption[true]{inlineliteralwraps} \DeclareStringOption[t]{literalblockcappos} \DeclareStringOption[r]{verbatimcontinuedalign} \DeclareStringOption[r]{verbatimcontinuesalign} % parsed literal \DeclareBoolOption[true]{parsedliteralwraps} % \textvisiblespace for compatibility with fontspec+XeTeX/LuaTeX \DeclareStringOption[\textcolor{red}{\textvisiblespace}]{verbatimvisiblespace} \DeclareStringOption % must use braces to hide the brackets [{\makebox[2\fontcharwd\font`\x][r]{\textcolor{red}{\tiny$\m@th\hookrightarrow$}}}]% {verbatimcontinued} % notices/admonitions % the dimensions for notices/admonitions are kept as macros and assigned to % \spx@notice@border at time of use, hence \DeclareStringOption is ok for this \newdimen\spx@notice@border \DeclareStringOption[0.5pt]{noteborder} \DeclareStringOption[0.5pt]{hintborder} \DeclareStringOption[0.5pt]{importantborder} \DeclareStringOption[0.5pt]{tipborder} \DeclareStringOption[1pt]{warningborder} \DeclareStringOption[1pt]{cautionborder} \DeclareStringOption[1pt]{attentionborder} \DeclareStringOption[1pt]{dangerborder} \DeclareStringOption[1pt]{errorborder} % footnotes \DeclareStringOption[\mbox{ }]{AtStartFootnote} % we need a public macro name for direct use in latex file \newcommand*{\sphinxAtStartFootnote}{\spx@opt@AtStartFootnote} % no such need for this one, as it is used inside other macros \DeclareStringOption[\leavevmode\unskip]{BeforeFootnote} % some font styling. \DeclareStringOption[\sffamily\bfseries]{HeaderFamily} % colours % same problems as for dimensions: we want the key handler to use \definecolor. % first, some colours with no prefix, for backwards compatibility \newcommand*{\sphinxDeclareColorOption}[2]{% \definecolor{#1}#2% \define@key{sphinx}{#1}{\definecolor{#1}##1}% }% \sphinxDeclareColorOption{TitleColor}{{rgb}{0.126,0.263,0.361}} \sphinxDeclareColorOption{InnerLinkColor}{{rgb}{0.208,0.374,0.486}} \sphinxDeclareColorOption{OuterLinkColor}{{rgb}{0.216,0.439,0.388}} \sphinxDeclareColorOption{VerbatimColor}{{rgb}{1,1,1}} \sphinxDeclareColorOption{VerbatimBorderColor}{{rgb}{0,0,0}} % now the colours defined with "sphinx" prefix in their names \newcommand*{\sphinxDeclareSphinxColorOption}[2]{% % set the initial default \definecolor{sphinx#1}#2% % set the key handler. The "value" ##1 must be acceptable by \definecolor. \define@key{sphinx}{#1}{\definecolor{sphinx#1}##1}% }% % Default color chosen to be as in minted.sty LaTeX package! \sphinxDeclareSphinxColorOption{VerbatimHighlightColor}{{rgb}{0.878,1,1}} % admonition boxes, "light" style \sphinxDeclareSphinxColorOption{noteBorderColor}{{rgb}{0,0,0}} \sphinxDeclareSphinxColorOption{hintBorderColor}{{rgb}{0,0,0}} \sphinxDeclareSphinxColorOption{importantBorderColor}{{rgb}{0,0,0}} \sphinxDeclareSphinxColorOption{tipBorderColor}{{rgb}{0,0,0}} % admonition boxes, "heavy" style \sphinxDeclareSphinxColorOption{warningBorderColor}{{rgb}{0,0,0}} \sphinxDeclareSphinxColorOption{cautionBorderColor}{{rgb}{0,0,0}} \sphinxDeclareSphinxColorOption{attentionBorderColor}{{rgb}{0,0,0}} \sphinxDeclareSphinxColorOption{dangerBorderColor}{{rgb}{0,0,0}} \sphinxDeclareSphinxColorOption{errorBorderColor}{{rgb}{0,0,0}} \sphinxDeclareSphinxColorOption{warningBgColor}{{rgb}{1,1,1}} \sphinxDeclareSphinxColorOption{cautionBgColor}{{rgb}{1,1,1}} \sphinxDeclareSphinxColorOption{attentionBgColor}{{rgb}{1,1,1}} \sphinxDeclareSphinxColorOption{dangerBgColor}{{rgb}{1,1,1}} \sphinxDeclareSphinxColorOption{errorBgColor}{{rgb}{1,1,1}} \DeclareDefaultOption{\@unknownoptionerror} \ProcessKeyvalOptions* % don't allow use of maxlistdepth via \sphinxsetup. \DisableKeyvalOption{sphinx}{maxlistdepth} \DisableKeyvalOption{sphinx}{numfigreset} \DisableKeyvalOption{sphinx}{nonumfigreset} \DisableKeyvalOption{sphinx}{mathnumfig} % FIXME: this is unrelated to an option, move this elsewhere % To allow hyphenation of first word in narrow contexts; no option, % customization to be done via 'preamble' key \newcommand*\sphinxAtStartPar{\leavevmode\nobreak\hskip\z@skip} % No need for the \hspace{0pt} trick (\hskip\z@skip) with luatex \ifdefined\directlua\let\sphinxAtStartPar\@empty\fi % user interface: options can be changed midway in a document! \newcommand\sphinxsetup[1]{\setkeys{sphinx}{#1}} %% MISCELLANEOUS CONTEXT % % flag to be set in a framed environment % (defined here as currently needed by three sphinxlatex....sty files and % even if not needed if such files are replaced, the definition does no harm) \newif\ifspx@inframed % % \spx@ifcaptionpackage (defined at begin document) % is needed currently in macros from: % sphinxlatexliterals.sty (sphinxVerbatim) % sphinxlatextables.sty (for some macros used in the table templates) % % \sphinxcaption is mark-up injected by the tabular and tabulary templates % it is defined in sphinxlatextables.sty % % store the original \caption macro for usage with figures inside longtable % and tabulary cells. Make sure we get the final \caption in presence of % caption package, whether the latter was loaded before or after sphinx. \AtBeginDocument{% \let\spx@originalcaption\caption \@ifpackageloaded{caption} {\let\spx@ifcaptionpackage\@firstoftwo \caption@AtBeginDocument*{\let\spx@originalcaption\caption}% % in presence of caption package, drop our own \sphinxcaption whose aim was to % ensure same width of caption to all kinds of tables (tabular(y), longtable), % because caption package has its own width (or margin) option \def\sphinxcaption{\caption}% }% {\let\spx@ifcaptionpackage\@secondoftwo}% } %% PASS OPTIONS % % pass options to hyperref; it must not have been loaded already \input{sphinxoptionshyperref.sty} % pass options to geometry; it must not have been loaded already \input{sphinxoptionsgeometry.sty} %% COLOR (general) % % FIXME: these two should be deprecated % % FIXME: \normalcolor should be used and \py@NormalColor never defined \def\py@NormalColor{\color{black}} % FIXME: \color{TitleColor} should be used directly and \py@TitleColor % should never get defined. \def\py@TitleColor{\color{TitleColor}} %% PACKAGES % % as will be indicated below, secondary style files load some more packages % % For \text macro (sphinx.util.texescape) % also for usage of \firstchoice@true(false) in sphinxlatexgraphics.sty \RequirePackage{amstext} % It was passed "warn" option from latex template in case it is already loaded % via some other package before \usepackage{sphinx} in preamble \RequirePackage{textcomp} % For the H specifier. Do not \restylefloat{figure}, it breaks Sphinx code % for allowing figures in tables. \RequirePackage{float} % For floating figures in the text. Better to load after float. \RequirePackage{wrapfig} % Provides \captionof, used once by latex writer (\captionof{figure}) \RequirePackage{capt-of} % Support hlist directive \RequirePackage{multicol} %% GRAPHICS % % It will always be needed, so let's load it here \RequirePackage{graphicx} \input{sphinxlatexgraphics.sty} %% FRAMED ENVIRONMENTS % \input{sphinxlatexadmonitions.sty} \input{sphinxlatexliterals.sty} \input{sphinxlatexshadowbox.sty} %% CONTAINERS % \input{sphinxlatexcontainers.sty} %% PYGMENTS % stylesheet for highlighting with pygments \RequirePackage{sphinxhighlight} %% TABLES % \input{sphinxlatextables.sty} %% NUMBERING OF FIGURES, TABLES, AND LITERAL BLOCKS % \input{sphinxlatexnumfig.sty} %% LISTS % \input{sphinxlatexlists.sty} %% FOOTNOTES % % Support scopes for footnote numbering \newcounter{sphinxscope} \newcommand{\sphinxstepscope}{\stepcounter{sphinxscope}} % Explicitly numbered footnotes may be referred to, and for this to be % clickable we need to have only one target. So we will step this at each % explicit footnote and let \thesphinxscope take it into account \newcounter{sphinxexplicit} \newcommand{\sphinxstepexplicit}{\stepcounter{sphinxexplicit}} % Some babel/polyglossia languages fiddle with \@arabic, so let's be extra % cautious and redefine \thesphinxscope with \number not \@arabic. % Memo: we expect some subtle redefinition of \thesphinxscope to be a part of page % scoping for footnotes, when we shall implement it. \renewcommand{\thesphinxscope}{\number\value{sphinxscope}.\number\value{sphinxexplicit}} \newcommand\sphinxthefootnotemark[2]{% % this is used to make reference to an explicitly numbered footnote not on same page % #1=label of footnote text, #2=page number where footnote text was printed \ifdefined\pagename \pagename\space#2, % <- space \else p. #2, % <- space \fi #1% no space } % support large numbered footnotes in minipage; but this is now obsolete % from systematic use of savenotes environment around minipages \def\thempfootnote{\arabic{mpfootnote}} % This package is needed to support hyperlinked footnotes in tables and % framed contents, and to allow code-blocks in footnotes. \RequirePackage{sphinxpackagefootnote} %% INDEX, BIBLIOGRAPHY, APPENDIX, TABLE OF CONTENTS % \input{sphinxlatexindbibtoc.sty} %% STYLING % \input{sphinxlatexstylepage.sty} \input{sphinxlatexstyleheadings.sty} \input{sphinxlatexstyletext.sty} %% MODULE RELEASE DATA AND OBJECT DESCRIPTIONS % \input{sphinxlatexobjects.sty} % FIXME: this line should be dropped, as "9" is default anyhow. \ifdefined\pdfcompresslevel\pdfcompresslevel = 9 \fi \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinx.xdy0000644000076600000240000002240200000000000017746 0ustar00tkomiyastaff;;; -*- mode: lisp; coding: utf-8; -*- ;; Unfortunately xindy is out-of-the-box hyperref-incompatible. This ;; configuration is a workaround, which requires to pass option ;; hyperindex=false to hyperref. ;; textit and emph not currently used, spxpagem replaces former textbf (define-attributes (("textbf" "textit" "emph" "spxpagem" "default"))) (markup-locref :open "\textbf{\hyperpage{" :close "}}" :attr "textbf") (markup-locref :open "\textit{\hyperpage{" :close "}}" :attr "textit") (markup-locref :open "\emph{\hyperpage{" :close "}}" :attr "emph") (markup-locref :open "\spxpagem{\hyperpage{" :close "}}" :attr "spxpagem") (markup-locref :open "\hyperpage{" :close "}" :attr "default") (require "numeric-sort.xdy") ;; xindy base module latex.xdy loads tex.xdy and the latter instructs ;; xindy to ignore **all** TeX macros in .idx entries, except those ;; explicitly described in merge rule. But when after applying all ;; merge rules an empty string results, xindy raises an error: ;; ERROR: CHAR: index 0 should be less than the length of the string ;; For example when using pdflatex with utf-8 characters the index ;; file will contain \IeC macros and they will get ignored except if ;; suitable merge rules are loaded early. The texindy script coming ;; with xindy provides this, but only for Latin scripts. The texindy ;; man page says to use rather xelatex or lualatex in case of Cyrillic ;; scripts. ;; Sphinx contributes LICRcyr2utf8.xdy to provide support for Cyrillic ;; scripts for the pdflatex engine. ;; Another issue caused by xindy ignoring all TeX macros except those ;; explicitly declared reveals itself when attempting to index ">>>", ;; as the ">" is converted to "\textgreater{}" by Sphinx's LaTeX ;; escaping. ;; To fix this, Sphinx does **not** use texindy, and does not even ;; load the xindy latex.xdy base module. ;(require "latex.xdy") ;; Rather it incorporates some suitable extracts from latex.xdy and ;; tex.xdy with additional Sphinx contributed rules. ;; But, this means for pdflatex and Latin scripts that the xindy file ;; tex/inputenc/uf8.xdy is not usable because it refers to the macro ;; \IeC only sporadically, and as tex.xdy is not loaded, a rule such as ;; (merge-rule "\'e" "é" :string) ;; does not work, it must be ;; (merge-rule "\IeC {\'e}" "é" :string) ;; So Sphinx contributes LICRlatin2utf8.xdy to mitigate that problem. ;;;;;;;; extracts from tex.xdy (discarding most original comments): ;;; ;;; TeX conventions ;;; ;; Discard leading and trailing white space. Collapse multiple white ;; space characters to blank. (merge-rule "^ +" "" :eregexp) (merge-rule " +$" "" :eregexp) (merge-rule " +" " " :eregexp) ;; Handle TeX markup (merge-rule "\\([{}$%&#])" "\1" :eregexp) ;;;;;;;; end of extracts from xindy's tex.xdy ;;;;;;;; extracts from latex.xdy: ;; Standard location classes: arabic and roman numbers, and alphabets. (define-location-class "arabic-page-numbers" ("arabic-numbers")) (define-location-class "roman-page-numbers" ("roman-numbers-lowercase")) (define-location-class "Roman-page-numbers" ("roman-numbers-uppercase")) (define-location-class "alpha-page-numbers" ("alpha")) (define-location-class "Alpha-page-numbers" ("ALPHA")) ;; Output Markup (markup-letter-group-list :sep "~n~n \indexspace~n") (markup-indexentry :open "~n \item " :depth 0) (markup-indexentry :open "~n \subitem " :depth 1) (markup-indexentry :open "~n \subsubitem " :depth 2) (markup-locclass-list :open ", " :sep ", ") (markup-locref-list :sep ", ") ;;;;;;;; end of extracts from latex.xdy ;; The LaTeX \index command turns \ into normal character so the TeX macros ;; written to .idx files are not followed by a blank. This is different ;; from non-ascii letters which end up (with pdflatex) as \IeC macros in .idx ;; file, with a blank space after \IeC ;; Details of the syntax are explained at ;; http://xindy.sourceforge.net/doc/manual-3.html ;; In absence of :string, "xindy uses an auto-detection mechanism to decide, ;; if the pattern is a regular expression or not". But it is not obvious to ;; guess, for example "\\_" is not detected as RE but "\\P\{\}" is, so for ;; being sure we apply the :string switch everywhere and do not use \\ etc... ;; Go back from sphinx.util.texescape TeX macros to UTF-8 (merge-rule "\sphinxleftcurlybrace{}" "{" :string) (merge-rule "\sphinxrightcurlybrace{}" "}" :string) (merge-rule "\_" "_" :string) (merge-rule "{[}" "[" :string) (merge-rule "{]}" "]" :string) (merge-rule "\textbackslash{}" "\" :string) ; " for Emacs syntax highlighting (merge-rule "\textasciitilde{}" "~~" :string); the ~~ escape is needed here (merge-rule "\textasciicircum{}" "^" :string) (merge-rule "\sphinxhyphen{}" "-" :string) (merge-rule "\textquotesingle{}" "'" :string) (merge-rule "\textasciigrave{}" "`" :string) (merge-rule "\textless{}" "<" :string) (merge-rule "\textgreater{}" ">" :string) (merge-rule "\P{}" "¶" :string) (merge-rule "\S{}" "§" :string) (merge-rule "\texteuro{}" "€" :string) (merge-rule "\(\infty\)" "∞" :string) (merge-rule "\(\pm\)" "±" :string) (merge-rule "\(\rightarrow\)" "→" :string) (merge-rule "\(\checkmark\)" "✓" :string) (merge-rule "\textendash{}" "–" :string) (merge-rule "\textbar{}" "|" :string) (merge-rule "\(\sp{\text{0}}\)" "⁰" :string) (merge-rule "\(\sp{\text{1}}\)" "¹" :string) (merge-rule "\(\sp{\text{2}}\)" "²" :string) (merge-rule "\(\sp{\text{3}}\)" "³" :string) (merge-rule "\(\sp{\text{4}}\)" "⁴" :string) (merge-rule "\(\sp{\text{5}}\)" "⁵" :string) (merge-rule "\(\sp{\text{6}}\)" "⁶" :string) (merge-rule "\(\sp{\text{7}}\)" "⁷" :string) (merge-rule "\(\sp{\text{8}}\)" "⁸" :string) (merge-rule "\(\sp{\text{9}}\)" "⁹" :string) (merge-rule "\(\sb{\text{0}}\)" "₀" :string) (merge-rule "\(\sb{\text{1}}\)" "₁" :string) (merge-rule "\(\sb{\text{2}}\)" "₂" :string) (merge-rule "\(\sb{\text{3}}\)" "₃" :string) (merge-rule "\(\sb{\text{4}}\)" "₄" :string) (merge-rule "\(\sb{\text{5}}\)" "₅" :string) (merge-rule "\(\sb{\text{6}}\)" "₆" :string) (merge-rule "\(\sb{\text{7}}\)" "₇" :string) (merge-rule "\(\sb{\text{8}}\)" "₈" :string) (merge-rule "\(\sb{\text{9}}\)" "₉" :string) (merge-rule "\IeC {\textalpha }" "α" :string) (merge-rule "\IeC {\textbeta }" "β" :string) (merge-rule "\IeC {\textgamma }" "γ" :string) (merge-rule "\IeC {\textdelta }" "δ" :string) (merge-rule "\IeC {\textepsilon }" "ε" :string) (merge-rule "\IeC {\textzeta }" "ζ" :string) (merge-rule "\IeC {\texteta }" "η" :string) (merge-rule "\IeC {\texttheta }" "θ" :string) (merge-rule "\IeC {\textiota }" "ι" :string) (merge-rule "\IeC {\textkappa }" "κ" :string) (merge-rule "\IeC {\textlambda }" "λ" :string) (merge-rule "\IeC {\textmu }" "μ" :string) (merge-rule "\IeC {\textnu }" "ν" :string) (merge-rule "\IeC {\textxi }" "ξ" :string) (merge-rule "\IeC {\textomicron }" "ο" :string) (merge-rule "\IeC {\textpi }" "π" :string) (merge-rule "\IeC {\textrho }" "ρ" :string) (merge-rule "\IeC {\textsigma }" "σ" :string) (merge-rule "\IeC {\texttau }" "τ" :string) (merge-rule "\IeC {\textupsilon }" "υ" :string) (merge-rule "\IeC {\textphi }" "φ" :string) (merge-rule "\IeC {\textchi }" "χ" :string) (merge-rule "\IeC {\textpsi }" "ψ" :string) (merge-rule "\IeC {\textomega }" "ω" :string) (merge-rule "\IeC {\textAlpha }" "Α" :string) (merge-rule "\IeC {\textBeta }" "Β" :string) (merge-rule "\IeC {\textGamma }" "Γ" :string) (merge-rule "\IeC {\textDelta }" "Δ" :string) (merge-rule "\IeC {\textEpsilon }" "Ε" :string) (merge-rule "\IeC {\textZeta }" "Ζ" :string) (merge-rule "\IeC {\textEta }" "Η" :string) (merge-rule "\IeC {\textTheta }" "Θ" :string) (merge-rule "\IeC {\textIota }" "Ι" :string) (merge-rule "\IeC {\textKappa }" "Κ" :string) (merge-rule "\IeC {\textLambda }" "Λ" :string) (merge-rule "\IeC {\textMu }" "Μ" :string) (merge-rule "\IeC {\textNu }" "Ν" :string) (merge-rule "\IeC {\textTheta }" "Θ" :string) (merge-rule "\IeC {\textIota }" "Ι" :string) (merge-rule "\IeC {\textKappa }" "Κ" :string) (merge-rule "\IeC {\textLambda }" "Λ" :string) (merge-rule "\IeC {\textMu }" "Μ" :string) (merge-rule "\IeC {\textNu }" "Ν" :string) (merge-rule "\IeC {\textXi }" "Ξ" :string) (merge-rule "\IeC {\textOmicron }" "Ο" :string) (merge-rule "\IeC {\textPi }" "Π" :string) (merge-rule "\IeC {\textRho }" "Ρ" :string) (merge-rule "\IeC {\textSigma }" "Σ" :string) (merge-rule "\IeC {\textTau }" "Τ" :string) (merge-rule "\IeC {\textUpsilon }" "Υ" :string) (merge-rule "\IeC {\textPhi }" "Φ" :string) (merge-rule "\IeC {\textChi }" "Χ" :string) (merge-rule "\IeC {\textPsi }" "Ψ" :string) (merge-rule "\IeC {\textOmega }" "Ω" :string) (merge-rule "\IeC {\textohm }" "Ω" :string) ;; This xindy module provides some basic support for "see" (require "makeindex.xdy") ;; This creates one-letter headings and works fine with utf-8 letters. ;; For Cyrillic with pdflatex works thanks to LICRcyr2utf8.xdy (require "latin-lettergroups.xdy") ;; currently we don't (know how to easily) separate "Numbers" from ;; "Symbols" with xindy as is the case with makeindex. (markup-index :open "\begin{sphinxtheindex} \let\lettergroup\sphinxstyleindexlettergroup \let\lettergroupDefault\sphinxstyleindexlettergroupDefault \let\spxpagem\sphinxstyleindexpagemain \let\spxentry\sphinxstyleindexentry \let\spxextra\sphinxstyleindexextra " :close " \end{sphinxtheindex} " :tree) ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxhowto.cls0000644000076600000240000000627000000000000021011 0ustar00tkomiyastaff% % sphinxhowto.cls for Sphinx (https://www.sphinx-doc.org/) % \NeedsTeXFormat{LaTeX2e}[1995/12/01] \ProvidesClass{sphinxhowto}[2019/12/01 v2.3.0 Document class (Sphinx howto)] % 'oneside' option overriding the 'twoside' default \newif\if@oneside \DeclareOption{oneside}{\@onesidetrue} % Pass remaining document options to the parent class. \DeclareOption*{\PassOptionsToClass{\CurrentOption}{\sphinxdocclass}} \ProcessOptions\relax % Default to two-side document \if@oneside % nothing to do (oneside is the default) \else \PassOptionsToClass{twoside}{\sphinxdocclass} \fi \LoadClass{\sphinxdocclass} % Set some sane defaults for section numbering depth and TOC depth. You can % reset these counters in your preamble. % \setcounter{secnumdepth}{2} \setcounter{tocdepth}{2}% i.e. section and subsection % Adapt \and command to the flushright context of \sphinxmaketitle, to % avoid ragged line endings if author names do not fit all on one single line \DeclareRobustCommand{\and}{% \end{tabular}\kern-\tabcolsep \allowbreak \hskip\dimexpr1em+\tabcolsep\@plus.17fil\begin{tabular}[t]{c}% }% % If it is desired that each author name be on its own line, use in preamble: %\DeclareRobustCommand{\and}{% % \end{tabular}\kern-\tabcolsep\\\begin{tabular}[t]{c}% %}% % Change the title page to look a bit better, and fit in with the fncychap % ``Bjarne'' style a bit better. % \newcommand{\sphinxmaketitle}{% \noindent\rule{\textwidth}{1pt}\par \begingroup % for PDF information dictionary \def\endgraf{ }\def\and{\& }% \pdfstringdefDisableCommands{\def\\{, }}% overwrite hyperref setup \hypersetup{pdfauthor={\@author}, pdftitle={\@title}}% \endgroup \begin{flushright} \sphinxlogo \py@HeaderFamily {\Huge \@title }\par {\itshape\large \py@release \releaseinfo}\par \vspace{25pt} {\Large \begin{tabular}[t]{c} \@author \end{tabular}\kern-\tabcolsep}\par \vspace{25pt} \@date \par \py@authoraddress \par \end{flushright} \@thanks \setcounter{footnote}{0} \let\thanks\relax\let\maketitle\relax %\gdef\@thanks{}\gdef\@author{}\gdef\@title{} } \newcommand{\sphinxtableofcontents}{% \begingroup \parskip \z@skip \sphinxtableofcontentshook \tableofcontents \endgroup \noindent\rule{\textwidth}{1pt}\par \vspace{12pt}% } \newcommand\sphinxtableofcontentshook{} \pagenumbering{arabic} % Fix the bibliography environment to add an entry to the Table of % Contents. % For an article document class this environment is a section, % so no page break before it. % \newenvironment{sphinxthebibliography}[1]{% % \phantomsection % not needed here since TeXLive 2010's hyperref \begin{thebibliography}{#1}% \addcontentsline{toc}{section}{\ifdefined\refname\refname\else\ifdefined\bibname\bibname\fi\fi}}{\end{thebibliography}} % Same for the indices. % The memoir class already does this, so we don't duplicate it in that case. % \@ifclassloaded{memoir} {\newenvironment{sphinxtheindex}{\begin{theindex}}{\end{theindex}}} {\newenvironment{sphinxtheindex}{% \phantomsection % needed because no chapter, section, ... is created by theindex \begin{theindex}% \addcontentsline{toc}{section}{\indexname}}{\end{theindex}}} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxlatexadmonitions.sty0000644000076600000240000001413600000000000023271 0ustar00tkomiyastaff%% NOTICES AND ADMONITIONS % % change this info string if making any custom modification \ProvidesFile{sphinxlatexadmonitions.sty}[2021/01/27 admonitions] % Provides support for this output mark-up from Sphinx latex writer: % % - sphinxadmonition (environment) % This is a dispatch supporting % % - note, hint, important, tip (via sphinxlightbox) % - warning, caution, attention, danger, error (via sphinxheavybox) % % Each sphinx environment can be redefined by user. % The defaults are customizable via various colour and dimension % settings, cf sphinx docs (latex customization). % % Requires: \RequirePackage{framed}% used by sphinxheavybox % % Dependencies (they do not need to be defined at time of loading): % - of course the various colour and dimension options handled via sphinx.sty % - \sphinxstrong (for sphinxlightbox and sphinxheavybox) % - dimension register \spx@image@maxheight from sphinxlatexgraphics.sty % - \savenotes/\spewnotes from sphinxpackagefootnote (for sphinxheavybox) % Provides: (also in sphinxlatexliterals.sty) \providecommand*\sphinxvspacefixafterfrenchlists{% \ifvmode\ifdim\lastskip<\z@ \vskip\parskip\fi\else\par\fi } % Some are quite plain % the spx@notice@bordercolor etc are set in the sphinxadmonition environment \newenvironment{sphinxlightbox}{% \par \noindent{\color{spx@notice@bordercolor}% \rule{\linewidth}{\spx@notice@border}}\par\nobreak {\parskip\z@skip\noindent}% } {% % counteract previous possible negative skip (French lists!): % (we can't cancel that any earlier \vskip introduced a potential pagebreak) \sphinxvspacefixafterfrenchlists \nobreak\vbox{\noindent\kern\@totalleftmargin {\color{spx@notice@bordercolor}% \rule[\dimexpr.4\baselineskip-\spx@notice@border\relax] {\linewidth}{\spx@notice@border}}\hss}\allowbreak }% end of sphinxlightbox environment definition % may be renewenvironment'd by user for complete customization \newenvironment{sphinxnote}[1] {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}} \newenvironment{sphinxhint}[1] {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}} \newenvironment{sphinximportant}[1] {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}} \newenvironment{sphinxtip}[1] {\begin{sphinxlightbox}\sphinxstrong{#1} }{\end{sphinxlightbox}} % or just use the package options % these are needed for common handling by notice environment of lightbox % and heavybox but they are currently not used by lightbox environment % and there is consequently no corresponding package option \definecolor{sphinxnoteBgColor}{rgb}{1,1,1} \definecolor{sphinxhintBgColor}{rgb}{1,1,1} \definecolor{sphinximportantBgColor}{rgb}{1,1,1} \definecolor{sphinxtipBgColor}{rgb}{1,1,1} % Others get more distinction % Code adapted from framed.sty's "snugshade" environment. % Nesting works (inner frames do not allow page breaks). \newenvironment{sphinxheavybox}{\par \setlength{\FrameRule}{\spx@notice@border}% \setlength{\FrameSep}{\dimexpr.6\baselineskip-\FrameRule\relax} \advance\spx@image@maxheight -\dimexpr2\FrameRule +2\FrameSep +\baselineskip\relax % will happen again if nested, needed indeed! % configure framed.sty's parameters to obtain same vertical spacing % as for "light" boxes. We need for this to manually insert parskip glue and % revert a skip done by framed before the frame. \ltx@ifundefined{OuterFrameSep}{}{\OuterFrameSep\z@skip}% \vspace{\FrameHeightAdjust} % copied/adapted from framed.sty's snugshade \def\FrameCommand##1{\hskip\@totalleftmargin \fboxsep\FrameSep \fboxrule\FrameRule \fcolorbox{spx@notice@bordercolor}{spx@notice@bgcolor}{##1}% \hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth}% \savenotes % use a minipage if we are already inside a framed environment \ifspx@inframed \noindent\begin{minipage}{\linewidth} \else % handle case where notice is first thing in a list item (or is quoted) \if@inlabel \noindent\par\vspace{-\baselineskip} \else \vspace{\parskip} \fi \fi \MakeFramed {\spx@inframedtrue \advance\hsize-\width \@totalleftmargin\z@ \linewidth\hsize % minipage initialization copied from LaTeX source code. \@pboxswfalse \let\@listdepth\@mplistdepth \@mplistdepth\z@ \@minipagerestore \@setminipage }% } {% \par\unskip \@minipagefalse \endMakeFramed \ifspx@inframed\end{minipage}\fi % set footnotes at bottom of page \spewnotes % arrange for similar spacing below frame as for "light" boxes. \vskip .4\baselineskip }% end of sphinxheavybox environment definition % may be renewenvironment'd by user for complete customization \newenvironment{sphinxwarning}[1] {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}} \newenvironment{sphinxcaution}[1] {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}} \newenvironment{sphinxattention}[1] {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}} \newenvironment{sphinxdanger}[1] {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}} \newenvironment{sphinxerror}[1] {\begin{sphinxheavybox}\sphinxstrong{#1} }{\end{sphinxheavybox}} % or just use package options % the \colorlet of xcolor (if at all loaded) is overkill for our use case \newcommand{\sphinxcolorlet}[2] {\expandafter\let\csname\@backslashchar color@#1\expandafter\endcsname \csname\@backslashchar color@#2\endcsname } % the main dispatch for all types of notices \newenvironment{sphinxadmonition}[2]{% #1=type, #2=heading % can't use #1 directly in definition of end part \def\spx@noticetype {#1}% % set parameters of heavybox/lightbox \sphinxcolorlet{spx@notice@bordercolor}{sphinx#1BorderColor}% \sphinxcolorlet{spx@notice@bgcolor}{sphinx#1BgColor}% \spx@notice@border \dimexpr\csname spx@opt@#1border\endcsname\relax % start specific environment, passing the heading as argument \begin{sphinx#1}{#2}} % workaround some LaTeX "feature" of \end command {\edef\spx@temp{\noexpand\end{sphinx\spx@noticetype}}\spx@temp} \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxlatexcontainers.sty0000644000076600000240000000160500000000000023107 0ustar00tkomiyastaff%% CONTAINER DIRECTIVES % % change this info string if making any custom modification \ProvidesFile{sphinxlatexcontainers.sty}[2021/05/03 containers] % The purpose of this file is to provide a dummy environment sphinxclass which % will be inserted for each class in each container directive. The class name % will be passed as the argument to the environment. % % For a class foo, the user can define customised handling of that class by % defining the sphinxclassfoo LaTeX environment. \newenvironment{sphinxuseclass}[1]{% \def\sphinxClassFunctionName{sphinxclass#1}% \ltx@ifundefined{\sphinxClassFunctionName}% {}% undefined so do nothing {\expandafter\begin\expandafter{\sphinxClassFunctionName}}% }{% \ltx@ifundefined{\sphinxClassFunctionName}% {}% we did nothing so we keep doing nothing {\expandafter\end\expandafter{\sphinxClassFunctionName}}% }% ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxlatexgraphics.sty0000644000076600000240000001135000000000000022540 0ustar00tkomiyastaff%% GRAPHICS % % change this info string if making any custom modification \ProvidesFile{sphinxlatexgraphics.sty}[2021/01/27 graphics] % Provides support for this output mark-up from Sphinx latex writer: % % - macros: % % - \sphinxfigcaption % - \sphinxincludegraphics % % - environments: % % - sphinxfigure-in-table % % May change: % % - \sphinxcaption (at begin document) % % Also provides: % % - \sphinxsafeincludegraphics (default of \sphinxincludegraphics since 2.0) % - \spx@image@maxheight dimension (used by sphinxlatexadmonitions.sty) % - \spx@image@box scratch box register (also used by sphinxlatexliterals.sty) % % Requires: % \RequirePackage{graphicx}% done in sphinx.sty \RequirePackage{amstext}% needed for \firstchoice@true(false) % \sphinxincludegraphics resizes images larger than the TeX \linewidth (which % is adjusted in indented environments), or taller than a certain maximal % height (usually \textheight and this is reduced in the environments which use % framed.sty to avoid infinite loop if image too tall). % % In case height or width options are present the rescaling is done % (since 2.0), in a way keeping the width:height ratio either native from % image or from the width and height options if both were present. % \newdimen\spx@image@maxheight \AtBeginDocument{\spx@image@maxheight\textheight} % box scratch register \newbox\spx@image@box \newcommand*{\sphinxsafeincludegraphics}[2][]{% % #1 contains possibly width=, height=, but no scale= since 1.8.4 \setbox\spx@image@box\hbox{\includegraphics[#1,draft]{#2}}% \in@false % use some handy boolean flag \ifdim \wd\spx@image@box>\linewidth \in@true % flag to remember to adjust options and set box dimensions % compute height which results from rescaling width to \linewidth % and keep current aspect ratio. multiply-divide in \numexpr uses % temporarily doubled precision, hence no overflow. (of course we % assume \ht is not a few sp's below \maxdimen...(about 16384pt). \edef\spx@image@rescaledheight % with sp units {\the\numexpr\ht\spx@image@box *\linewidth/\wd\spx@image@box sp}% \ifdim\spx@image@rescaledheight>\spx@image@maxheight % the rescaled height will be too big, so it is height which decides % the rescaling factor \def\spx@image@requiredheight{\spx@image@maxheight}% dimen register \edef\spx@image@requiredwidth % with sp units {\the\numexpr\wd\spx@image@box *\spx@image@maxheight/\ht\spx@image@box sp}% % TODO: decide if this commented-out block could be needed due to % rounding in numexpr operations going up % \ifdim\spx@image@requiredwidth>\linewidth % \def\spx@image@requiredwidth{\linewidth}% dimen register % \fi \else \def\spx@image@requiredwidth{\linewidth}% dimen register \let\spx@image@requiredheight\spx@image@rescaledheight% sp units \fi \else % width is ok, let's check height \ifdim\ht\spx@image@box>\spx@image@maxheight \in@true \edef\spx@image@requiredwidth % with sp units {\the\numexpr\wd\spx@image@box *\spx@image@maxheight/\ht\spx@image@box sp}% \def\spx@image@requiredheight{\spx@image@maxheight}% dimen register \fi \fi % end of check of width and height \ifin@ \setbox\spx@image@box \hbox{\includegraphics [%#1,% contained only width and/or height and overruled anyhow width=\spx@image@requiredwidth,height=\spx@image@requiredheight]% {#2}}% % \includegraphics does not set box dimensions to the exactly % requested ones, see https://github.com/latex3/latex2e/issues/112 \wd\spx@image@box\spx@image@requiredwidth \ht\spx@image@box\spx@image@requiredheight \leavevmode\box\spx@image@box \else % here we do not modify the options, no need to adjust width and height % on output, they will be computed exactly as with "draft" option \setbox\spx@image@box\box\voidb@x % clear memory \includegraphics[#1]{#2}% \fi }% % Use the "safe" one by default (2.0) \def\sphinxincludegraphics{\sphinxsafeincludegraphics} %% FIGURE IN TABLE % \newenvironment{sphinxfigure-in-table}[1][\linewidth]{% \def\@captype{figure}% \sphinxsetvskipsforfigintablecaption \begin{minipage}{#1}% }{\end{minipage}} % tabulary expands twice contents, we need to prevent double counter stepping \newcommand*\sphinxfigcaption {\ifx\equation$%$% this is trick to identify tabulary first pass \firstchoice@false\else\firstchoice@true\fi \spx@originalcaption } \newcommand*\sphinxsetvskipsforfigintablecaption {\abovecaptionskip\smallskipamount \belowcaptionskip\smallskipamount} \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxlatexindbibtoc.sty0000644000076600000240000000402200000000000022673 0ustar00tkomiyastaff%% INDEX, BIBLIOGRAPHY, APPENDIX, TABLE OF CONTENTS % % change this info string if making any custom modification \ProvidesFile{sphinxlatexindbibtoc.sty}[2021/01/27 index, bib., toc] % Provides support for this output mark-up from Sphinx latex writer: % % - environments: (backup defaults or get redefined) % % - sphinxtheindex (direct mark-up or via python.ist or sphinx.xdy) % - sphinxthebibliography % % - macros: (defines defaults) % % - \sphinxmaketitle % - \sphinxtableofcontents % - \sphinxnonalphabeticalgroupname % - \sphinxsymbolsname % - \sphinxnumbersname % - \sphinxcite % % Requires: \RequirePackage{makeidx} % fix the double index and bibliography on the table of contents % in jsclasses (Japanese standard document classes) \ifx\@jsc@uplatextrue\@undefined\else \renewenvironment{sphinxtheindex} {\cleardoublepage\phantomsection \begin{theindex}} {\end{theindex}} \renewenvironment{sphinxthebibliography}[1] {\cleardoublepage% \phantomsection % not needed here since TeXLive 2010's hyperref \begin{thebibliography}{#1}} {\end{thebibliography}} \fi % disable \@chappos in Appendix in pTeX \ifx\kanjiskip\@undefined\else \let\py@OldAppendix=\appendix \renewcommand{\appendix}{ \py@OldAppendix \gdef\@chappos{} } \fi % make commands known to non-Sphinx document classes \providecommand*{\sphinxmaketitle}{\maketitle} \providecommand*{\sphinxtableofcontents}{\tableofcontents} \ltx@ifundefined{sphinxthebibliography} {\newenvironment {sphinxthebibliography}{\begin{thebibliography}}{\end{thebibliography}}% } {}% else clause of \ltx@ifundefined \ltx@ifundefined{sphinxtheindex} {\newenvironment{sphinxtheindex}{\begin{theindex}}{\end{theindex}}}% {}% else clause of \ltx@ifundefined % for usage with xindy: this string gets internationalized in preamble \newcommand*{\sphinxnonalphabeticalgroupname}{} % redefined in preamble, headings for makeindex produced index \newcommand*{\sphinxsymbolsname}{} \newcommand*{\sphinxnumbersname}{} \protected\def\sphinxcite{\cite} \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxlatexlists.sty0000644000076600000240000000672400000000000022107 0ustar00tkomiyastaff%% ALPHANUMERIC LIST ITEMS % % change this info string if making any custom modification \ProvidesFile{sphinxlatexlists.sty}[2021/01/27 lists] % Provides support for this output mark-up from Sphinx latex writer: % - \sphinxsetlistlabels % Dependencies: the \spx@opt@maxlistdepth from sphinx.sty \newcommand\sphinxsetlistlabels[5] {% #1 = style, #2 = enum, #3 = enumnext, #4 = prefix, #5 = suffix % #2 and #3 are counters used by enumerate environment e.g. enumi, enumii. % #1 is a macro such as \arabic or \alph % prefix and suffix are strings (by default empty and a dot). \@namedef{the#2}{#1{#2}}% \@namedef{label#2}{#4\@nameuse{the#2}#5}% \@namedef{p@#3}{\@nameuse{p@#2}#4\@nameuse{the#2}#5}% }% %% MAXLISTDEPTH % % remove LaTeX's cap on nesting depth if 'maxlistdepth' key used. % This is a hack, which works with the standard classes: it assumes \@toodeep % is always used in "true" branches: "\if ... \@toodeep \else .. \fi." % will force use the "false" branch (if there is one) \def\spx@toodeep@hack{\fi\iffalse} % do nothing if 'maxlistdepth' key not used or if package enumitem loaded. \ifnum\spx@opt@maxlistdepth=\z@\expandafter\@gobbletwo\fi \AtBeginDocument{% \@ifpackageloaded{enumitem}{\remove@to@nnil}{}% \let\spx@toodeepORI\@toodeep \def\@toodeep{% \ifnum\@listdepth<\spx@opt@maxlistdepth\relax \expandafter\spx@toodeep@hack \else \expandafter\spx@toodeepORI \fi}% % define all missing \@list... macros \count@\@ne \loop \ltx@ifundefined{@list\romannumeral\the\count@} {\iffalse}{\iftrue\advance\count@\@ne}% \repeat \loop \ifnum\count@>\spx@opt@maxlistdepth\relax\else \expandafter\let \csname @list\romannumeral\the\count@\expandafter\endcsname \csname @list\romannumeral\the\numexpr\count@-\@ne\endcsname % workaround 2.6--3.2d babel-french issue (fixed in 3.2e; no change needed) \ltx@ifundefined{leftmargin\romannumeral\the\count@} {\expandafter\let \csname leftmargin\romannumeral\the\count@\expandafter\endcsname \csname leftmargin\romannumeral\the\numexpr\count@-\@ne\endcsname}{}% \advance\count@\@ne \repeat % define all missing enum... counters and \labelenum... macros and \p@enum.. \count@\@ne \loop \ltx@ifundefined{c@enum\romannumeral\the\count@} {\iffalse}{\iftrue\advance\count@\@ne}% \repeat \loop \ifnum\count@>\spx@opt@maxlistdepth\relax\else \newcounter{enum\romannumeral\the\count@}% \expandafter\def \csname labelenum\romannumeral\the\count@\expandafter\endcsname \expandafter {\csname theenum\romannumeral\the\numexpr\count@\endcsname.}% \expandafter\def \csname p@enum\romannumeral\the\count@\expandafter\endcsname \expandafter {\csname p@enum\romannumeral\the\numexpr\count@-\@ne\expandafter \endcsname\csname theenum\romannumeral\the\numexpr\count@-\@ne\endcsname.}% \advance\count@\@ne \repeat % define all missing labelitem... macros \count@\@ne \loop \ltx@ifundefined{labelitem\romannumeral\the\count@} {\iffalse}{\iftrue\advance\count@\@ne}% \repeat \loop \ifnum\count@>\spx@opt@maxlistdepth\relax\else \expandafter\let \csname labelitem\romannumeral\the\count@\expandafter\endcsname \csname labelitem\romannumeral\the\numexpr\count@-\@ne\endcsname \advance\count@\@ne \repeat \PackageInfo{sphinx}{maximal list depth extended to \spx@opt@maxlistdepth}% \@gobble\@nnil } \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxlatexliterals.sty0000644000076600000240000010450300000000000022562 0ustar00tkomiyastaff%% LITERAL BLOCKS % % change this info string if making any custom modification \ProvidesFile{sphinxlatexliterals.sty}[2021/01/27 code-blocks and parsed literals] % Provides support for this output mark-up from Sphinx latex writer: % % - macros: % - \sphinxLiteralBlockLabel % - \sphinxSetupCaptionForVerbatim % - \sphinxSetupCodeBlockInFootnote % - \sphinxhref % - \sphinxnolinkurl % - \sphinxresetverbatimhllines % - \sphinxunactivateextrasandspace % - \sphinxupquote % - \sphinxurl % % - environments: % - sphinxVerbatim % - sphinxVerbatimintable % - sphinxalltt % % Dependency: % % - hyperref (for \phantomsection and \capstart) (loaded later) % % Executes \RequirePackage for: % % - framed % - fancyvrb % - alltt % - upquote % - needspace % also in sphinxlatexadmonitions.sty: % This is a workaround to a "feature" of French lists, when literal block % follows immediately; usable generally (does only \par then), a priori... \providecommand*\sphinxvspacefixafterfrenchlists{% \ifvmode\ifdim\lastskip<\z@ \vskip\parskip\fi\else\par\fi } % For framing allowing pagebreaks \RequirePackage{framed} % For source code % MEMO: fancyvrb is used mainly to % 1- control horizontal and vertical spacing % 2- optional line numbering % 3- optional line emphasizing % 4- while still allowing expansion of Pygments latex mark-up % Other aspects such as framing, caption handling, codeline wrapping are % added on top of it. We should stop using fancyvrb and implement % 1, 2, 3, 4 by own Sphinx fully native Verbatim. This would allow to solve % limitations with wrapped long code line not allowing page break. \RequirePackage{fancyvrb} % For parsed-literal blocks. \RequirePackage{alltt} % Display "real" single quotes in literal blocks. \RequirePackage{upquote} % Skip to next page if not enough space at bottom \RequirePackage{needspace} % Based on use of "fancyvrb.sty"'s Verbatim. % - with framing allowing page breaks ("framed.sty") % - with breaking of long lines (exploits Pygments mark-up), % - with possibly of a top caption, non-separable by pagebreak. % - and usable inside tables or footnotes ("sphinxpackagefootnote.sty"). % for emphasizing lines \define@key{FV}{hllines}{\def\sphinx@verbatim@checkifhl##1{\in@{, ##1,}{#1}}} % sphinxVerbatim must be usable by third party without requiring hllines set-up \def\sphinxresetverbatimhllines{\def\sphinx@verbatim@checkifhl##1{\in@false}} \sphinxresetverbatimhllines % Prior to Sphinx 1.5, \Verbatim and \endVerbatim were modified by Sphinx. % The aliases defined here are used in sphinxVerbatim environment and can % serve as hook-points with no need to modify \Verbatim itself. \let\OriginalVerbatim \Verbatim \let\endOriginalVerbatim\endVerbatim % for captions of literal blocks % at start of caption title \newcommand*{\fnum@literalblock}{\literalblockname\nobreakspace\theliteralblock} % this will be overwritten in document preamble by Babel translation \newcommand*{\literalblockname}{Listing } % file extension needed for \caption's good functioning, the file is created % only if a \listof{literalblock}{foo} command is encountered, which is % analogous to \listoffigures, but for the code listings (foo = chosen title.) \newcommand*{\ext@literalblock}{lol} % if forced use of minipage encapsulation is needed (e.g. table cells) \newif\ifsphinxverbatimwithminipage \sphinxverbatimwithminipagefalse % Framing macro for use with framed.sty's \FrameCommand % - it obeys current indentation, % - frame is \fboxsep separated from the contents, % - the contents use the full available text width, % - #1 = color of frame, #2 = color of background, % - #3 = above frame, #4 = below frame, #5 = within frame, % - #3 and #4 must be already typeset boxes; they must issue \normalcolor % or similar, else, they are under scope of color #1 \long\def\spx@fcolorbox #1#2#3#4#5{% \hskip\@totalleftmargin \hskip-\fboxsep\hskip-\fboxrule % use of \color@b@x here is compatible with both xcolor.sty and color.sty \color@b@x {\color{#1}\spx@CustomFBox{#3}{#4}}{\color{#2}}{#5}% \hskip-\fboxsep\hskip-\fboxrule \hskip-\linewidth \hskip-\@totalleftmargin \hskip\columnwidth }% % #1 = for material above frame, such as a caption or a "continued" hint % #2 = for material below frame, such as a caption or "continues on next page" % #3 = actual contents, which will be typeset with a background color \long\def\spx@CustomFBox#1#2#3{% \begingroup \setbox\@tempboxa\hbox{{#3}}% inner braces to avoid color leaks \vbox{#1% above frame % draw frame border _latest_ to avoid pdf viewer issue \kern\fboxrule \hbox{\kern\fboxrule \copy\@tempboxa \kern-\wd\@tempboxa\kern-\fboxrule \vrule\@width\fboxrule \kern\wd\@tempboxa \vrule\@width\fboxrule}% \kern-\dimexpr\ht\@tempboxa+\dp\@tempboxa+\fboxrule\relax \hrule\@height\fboxrule \kern\dimexpr\ht\@tempboxa+\dp\@tempboxa\relax \hrule\@height\fboxrule #2% below frame }% \endgroup }% \def\spx@fcolorbox@put@c#1{% hide width from framed.sty measuring \moveright\dimexpr\fboxrule+.5\wd\@tempboxa\hb@xt@\z@{\hss#1\hss}% }% \def\spx@fcolorbox@put@r#1{% right align with contents, width hidden \moveright\dimexpr\fboxrule+\wd\@tempboxa-\fboxsep\hb@xt@\z@{\hss#1}% }% \def\spx@fcolorbox@put@l#1{% left align with contents, width hidden \moveright\dimexpr\fboxrule+\fboxsep\hb@xt@\z@{#1\hss}% }% % \def\sphinxVerbatim@Continued {\csname spx@fcolorbox@put@\spx@opt@verbatimcontinuedalign\endcsname {\normalcolor\sphinxstylecodecontinued\literalblockcontinuedname}}% \def\sphinxVerbatim@Continues {\csname spx@fcolorbox@put@\spx@opt@verbatimcontinuesalign\endcsname {\normalcolor\sphinxstylecodecontinues\literalblockcontinuesname}}% \def\sphinxVerbatim@Title {\spx@fcolorbox@put@c{\unhcopy\sphinxVerbatim@TitleBox}}% \let\sphinxVerbatim@Before\@empty \let\sphinxVerbatim@After\@empty % Defaults are redefined in document preamble according to language \newcommand*\literalblockcontinuedname{continued from previous page}% \newcommand*\literalblockcontinuesname{continues on next page}% % \def\spx@verbatimfcolorbox{\spx@fcolorbox{VerbatimBorderColor}{VerbatimColor}}% \def\sphinxVerbatim@FrameCommand {\spx@verbatimfcolorbox\sphinxVerbatim@Before\sphinxVerbatim@After}% \def\sphinxVerbatim@FirstFrameCommand {\spx@verbatimfcolorbox\sphinxVerbatim@Before\sphinxVerbatim@Continues}% \def\sphinxVerbatim@MidFrameCommand {\spx@verbatimfcolorbox\sphinxVerbatim@Continued\sphinxVerbatim@Continues}% \def\sphinxVerbatim@LastFrameCommand {\spx@verbatimfcolorbox\sphinxVerbatim@Continued\sphinxVerbatim@After}% % For linebreaks inside Verbatim environment from package fancyvrb. \newbox\sphinxcontinuationbox \newbox\sphinxvisiblespacebox \newcommand*\sphinxafterbreak {\copy\sphinxcontinuationbox} % Take advantage of the already applied Pygments mark-up to insert % potential linebreaks for TeX processing. % {, <, #, %, $, ' and ": go to next line. % _, }, ^, &, >, -, ~, and \: stay at end of broken line. % Use of \textquotesingle for straight quote. % FIXME: convert this to package options ? \newcommand*\sphinxbreaksbeforelist {% \do\PYGZob\{\do\PYGZlt\<\do\PYGZsh\#\do\PYGZpc\%% {, <, #, %, \do\PYGZdl\$\do\PYGZdq\"% $, " \def\PYGZsq {\discretionary{}{\sphinxafterbreak\textquotesingle}{\textquotesingle}}% ' } \newcommand*\sphinxbreaksafterlist {% \do\PYGZus\_\do\PYGZcb\}\do\PYGZca\^\do\PYGZam\&% _, }, ^, &, \do\PYGZgt\>\do\PYGZhy\-\do\PYGZti\~% >, -, ~ \do\PYGZbs\\% \ } \newcommand*\sphinxbreaksatspecials {% \def\do##1##2% {\def##1{\discretionary{}{\sphinxafterbreak\char`##2}{\char`##2}}}% \sphinxbreaksbeforelist \def\do##1##2% {\def##1{\discretionary{\char`##2}{\sphinxafterbreak}{\char`##2}}}% \sphinxbreaksafterlist } \def\sphinx@verbatim@nolig@list {\do \`}% % Some characters . , ; ? ! / are neither pygmentized nor "tex-escaped". % This macro makes them "active" and they will insert potential linebreaks. % Not compatible with math mode (cf \sphinxunactivateextras). \newcommand*\sphinxbreaksbeforeactivelist {}% none \newcommand*\sphinxbreaksafteractivelist {\do\.\do\,\do\;\do\?\do\!\do\/} \newcommand*\sphinxbreaksviaactive {% \def\do##1{\lccode`\~`##1% \lowercase{\def~}{\discretionary{}{\sphinxafterbreak\char`##1}{\char`##1}}% \catcode`##1\active}% \sphinxbreaksbeforeactivelist \def\do##1{\lccode`\~`##1% \lowercase{\def~}{\discretionary{\char`##1}{\sphinxafterbreak}{\char`##1}}% \catcode`##1\active}% \sphinxbreaksafteractivelist \lccode`\~`\~ } % If the linebreak is at a space, the latter will be displayed as visible % space at end of first line, and a continuation symbol starts next line. \def\spx@verbatim@space {% \nobreak\hskip\z@skip \discretionary{\copy\sphinxvisiblespacebox}{\sphinxafterbreak} {\kern\fontdimen2\font}% }% % if the available space on page is less than \literalblockneedspace, insert pagebreak \newcommand{\sphinxliteralblockneedspace}{5\baselineskip} \newcommand{\sphinxliteralblockwithoutcaptionneedspace}{1.5\baselineskip} % The title (caption) is specified from outside as macro \sphinxVerbatimTitle. % \sphinxVerbatimTitle is reset to empty after each use of Verbatim. \newcommand*\sphinxVerbatimTitle {} % This box to typeset the caption before framed.sty multiple passes for framing. \newbox\sphinxVerbatim@TitleBox % This box to measure contents if nested as inner \MakeFramed requires then % minipage encapsulation but too long contents then break outer \MakeFramed \newbox\sphinxVerbatim@ContentsBox % Holder macro for labels of literal blocks. Set-up by LaTeX writer. \newcommand*\sphinxLiteralBlockLabel {} \newcommand*\sphinxSetupCaptionForVerbatim [1] {% \sphinxvspacefixafterfrenchlists \needspace{\sphinxliteralblockneedspace}% % insert a \label via \sphinxLiteralBlockLabel % reset to normal the color for the literal block caption \def\sphinxVerbatimTitle {\py@NormalColor\sphinxcaption{\sphinxLiteralBlockLabel #1}}% } \newcommand*\sphinxSetupCodeBlockInFootnote {% \fvset{fontsize=\footnotesize}\let\caption\sphinxfigcaption \sphinxverbatimwithminipagetrue % reduces vertical spaces % we counteract (this is in a group) the \@normalsize from \caption \let\normalsize\footnotesize\let\@parboxrestore\relax \def\spx@abovecaptionskip{\sphinxverbatimsmallskipamount}% } \newcommand*{\sphinxverbatimsmallskipamount}{\smallskipamount} % serves to implement line highlighting and line wrapping \newcommand\sphinxFancyVerbFormatLine[1]{% \expandafter\sphinx@verbatim@checkifhl\expandafter{\the\FV@CodeLineNo}% \ifin@ \sphinxVerbatimHighlightLine{#1}% \else \sphinxVerbatimFormatLine{#1}% \fi }% \newcommand\sphinxVerbatimHighlightLine[1]{% \edef\sphinxrestorefboxsep{\fboxsep\the\fboxsep\relax}% \fboxsep0pt\relax % cf LaTeX bug graphics/4524 \colorbox{sphinxVerbatimHighlightColor}% {\sphinxrestorefboxsep\sphinxVerbatimFormatLine{#1}}% % no need to restore \fboxsep here, as this ends up in a \hbox from fancyvrb }% % \sphinxVerbatimFormatLine will be set locally to one of those two: \newcommand\sphinxVerbatimFormatLineWrap{% \hsize\linewidth \ifspx@opt@verbatimforcewraps \expandafter\spx@verb@FormatLineForceWrap \else\expandafter\spx@verb@FormatLineWrap \fi }% \newcommand\sphinxVerbatimFormatLineNoWrap[1]{\hb@xt@\linewidth{\strut #1\hss}}% \long\def\spx@verb@FormatLineWrap#1{% \vtop{\raggedright\hyphenpenalty\z@\exhyphenpenalty\z@ \doublehyphendemerits\z@\finalhyphendemerits\z@ \strut #1\strut}% }% % % The normal line wrapping allows breaks at spaces and ascii non % letters, non digits. The \raggedright above means there will be % an overfilled line only if some non-breakable "word" was % encountered, which is longer than a line (it is moved always to % be on its own on a new line). % % The "forced" line wrapping will parse the tokens to add potential % breakpoints at each character. As some strings are highlighted, % we have to apply the highlighting character per character, which % requires to manipulate the output of the Pygments LaTeXFormatter. % % Doing this at latex level is complicated. The contents should % be as expected: i.e. some active characters from % \sphinxbreaksviaactive, some Pygments character escapes such as % \PYGZdl{}, and the highlighting \PYG macro with always 2 % arguments. No other macros should be there, except perhaps % zero-parameter macros. In particular: % - the texcomments Pygments option must be set to False % % With pdflatex, Unicode input gives multi-bytes characters % where the first byte is active. We support the "utf8" macros % only. "utf8x" is not supported. % % The highlighting macro \PYG will be applied character per % character. Highlighting via a colored background gives thus a % chain of small colored boxes which may cause some artefact in % some pdf viewers. Can't do anything here if we do want the line % break to be possible. % % First a measurement step is done of what would the standard line % wrapping give (i.e line breaks only at spaces and non-letter, % non-digit ascii characters), cf TeX by Topic for the basic % dissecting technique: TeX unfortunately when building a vertical % box does not store in an accessible way what was the maximal % line-width during paragraph building. % % Avoid LaTeX 2021 alteration of \@@par which potentially could break our % measurement step (typically if the para/after hook is configured to use % \vspace). Of course, breakage could happen only from user or package % adding things to basic Sphinx latex. And perhaps spring LaTeX 2021 will % provide a non-hooked \@@par, but this should work anyway and can't be % beaten for speed. \ltx@ifundefined{tex_par:D} % We could use \@ifl@t@r\fmtversion{2020/02/02}{use \tex_par:D}{use \@@par}. {\let\spx@par\@@par}% \@@par is then expected to be TeX's original \par {\expandafter\let\expandafter\spx@par\csname tex_par:D\endcsname} % More hesitation for avoiding the at-start-of-par hooks for our % measurement : 1. with old LaTeX, we can not avoid hooks from everyhook % or similar packages, 2. and perhaps the hooks add stuff which we should % actually measure. Ideally, hooks are for inserting things in margin % which do not change spacing. Most everything else in fact should not be % executed in our scratch box for measurement, such as counter stepping. \ltx@ifundefined{tex_everypar:D} {\let\spx@everypar\everypar} {\expandafter\let\expandafter\spx@everypar\csname tex_everypar:D\endcsname} % % If the max width exceeds the linewidth by more than verbatimmaxoverfull % character widths, or if the min width plus verbatimmaxunderfull character % widths is inferior to linewidth, then we apply the "force wrapping" with % potential line break at each character, else we don't. \long\def\spx@verb@FormatLineForceWrap#1{% % \spx@image@box is a scratch box register that we can use here \global\let\spx@verb@maxwidth\z@ \global\let\spx@verb@minwidth\linewidth \setbox\spx@image@box \vtop{\raggedright\hyphenpenalty\z@\exhyphenpenalty\z@ \doublehyphendemerits\z@\finalhyphendemerits\z@ \spx@everypar{}\noindent\strut #1\strut\spx@par \spx@verb@getwidths}% \ifdim\spx@verb@maxwidth> \dimexpr\linewidth+\spx@opt@verbatimmaxoverfull\fontcharwd\font`X \relax \spx@verb@FormatLineWrap{\spx@verb@wrapPYG #1\spx@verb@wrapPYG}% \else \ifdim\spx@verb@minwidth< \dimexpr\linewidth-\spx@opt@verbatimmaxunderfull\fontcharwd\font`X \relax \spx@verb@FormatLineWrap{\spx@verb@wrapPYG #1\spx@verb@wrapPYG}% \else \spx@verb@FormatLineWrap{#1}% \fi\fi }% % auxiliary paragraph dissector to get max and min widths % but minwidth must not take into account the last line \newbox\spx@scratchbox \def\spx@verb@getwidths {% \unskip\unpenalty \setbox\spx@scratchbox\lastbox \ifvoid\spx@scratchbox \else \setbox\spx@scratchbox\hbox{\unhbox\spx@scratchbox}% \ifdim\spx@verb@maxwidth<\wd\spx@scratchbox \xdef\spx@verb@maxwidth{\number\wd\spx@scratchbox sp}% \fi \expandafter\spx@verb@getwidths@loop \fi }% \def\spx@verb@getwidths@loop {% \unskip\unpenalty \setbox\spx@scratchbox\lastbox \ifvoid\spx@scratchbox \else \setbox\spx@scratchbox\hbox{\unhbox\spx@scratchbox}% \ifdim\spx@verb@maxwidth<\wd\spx@scratchbox \xdef\spx@verb@maxwidth{\number\wd\spx@scratchbox sp}% \fi \ifdim\spx@verb@minwidth>\wd\spx@scratchbox \xdef\spx@verb@minwidth{\number\wd\spx@scratchbox sp}% \fi \expandafter\spx@verb@getwidths@loop \fi }% % auxiliary macros to implement "cut long line even in middle of word" \catcode`Z=3 % safe delimiter \def\spx@verb@wrapPYG{% \futurelet\spx@nexttoken\spx@verb@wrapPYG@i }% \def\spx@verb@wrapPYG@i{% \ifx\spx@nexttoken\spx@verb@wrapPYG\let\next=\@gobble\else \ifx\spx@nexttoken\PYG\let\next=\spx@verb@wrapPYG@PYG@onebyone\else \discretionary{}{\sphinxafterbreak}{}% \let\next\spx@verb@wrapPYG@ii \fi\fi \next }% % Let's recognize active characters. We don't support utf8x only utf8. % And here #1 should not have picked up (non empty) braced contents \long\def\spx@verb@wrapPYG@ii#1{% \ifcat\noexpand~\noexpand#1\relax% active character \expandafter\spx@verb@wrapPYG@active \else % non-active character, control sequence such as \PYGZdl, or empty \expandafter\spx@verb@wrapPYG@one \fi {#1}% }% \long\def\spx@verb@wrapPYG@active#1{% % Let's hope expansion of active character does not really require arguments, % as we certainly don't want to go into expanding upfront token stream anyway. \expandafter\spx@verb@wrapPYG@iii#1{}{}{}{}{}{}{}{}{}Z#1% }% \long\def\spx@verb@wrapPYG@iii#1#2Z{% \ifx\UTFviii@four@octets#1\let\next=\spx@verb@wrapPYG@four\else \ifx\UTFviii@three@octets#1\let\next=\spx@verb@wrapPYG@three\else \ifx\UTFviii@two@octets#1\let\next=\spx@verb@wrapPYG@two\else \let\next=\spx@verb@wrapPYG@one \fi\fi\fi \next }% \long\def\spx@verb@wrapPYG@one #1{#1\futurelet\spx@nexttoken\spx@verb@wrapPYG@i}% \long\def\spx@verb@wrapPYG@two #1#2{#1#2\futurelet\spx@nexttoken\spx@verb@wrapPYG@i}% \long\def\spx@verb@wrapPYG@three #1#2#3{#1#2#3\futurelet\spx@nexttoken\spx@verb@wrapPYG@i}% \long\def\spx@verb@wrapPYG@four #1#2#3#4{#1#2#3#4\futurelet\spx@nexttoken\spx@verb@wrapPYG@i}% % Replace \PYG by itself applied one character at a time! This way breakpoints % can be inserted. \def\spx@verb@wrapPYG@PYG@onebyone#1#2#3{% #1 = \PYG, #2 = highlight spec, #3 = tokens \def\spx@verb@wrapPYG@PYG@spec{{#2}}% \futurelet\spx@nexttoken\spx@verb@wrapPYG@PYG@i#3Z% }% \def\spx@verb@wrapPYG@PYG@i{% \ifx\spx@nexttokenZ\let\next=\spx@verb@wrapPYG@PYG@done\else \discretionary{}{\sphinxafterbreak}{}% \let\next\spx@verb@wrapPYG@PYG@ii \fi \next }% \def\spx@verb@wrapPYG@PYG@doneZ{\futurelet\spx@nexttoken\spx@verb@wrapPYG@i}% \long\def\spx@verb@wrapPYG@PYG@ii#1{% \ifcat\noexpand~\noexpand#1\relax% active character \expandafter\spx@verb@wrapPYG@PYG@active \else % non-active character, control sequence such as \PYGZdl, or empty \expandafter\spx@verb@wrapPYG@PYG@one \fi {#1}% }% \long\def\spx@verb@wrapPYG@PYG@active#1{% % Let's hope expansion of active character does not really require arguments, % as we certainly don't want to go into expanding upfront token stream anyway. \expandafter\spx@verb@wrapPYG@PYG@iii#1{}{}{}{}{}{}{}{}{}Z#1% }% \long\def\spx@verb@wrapPYG@PYG@iii#1#2Z{% \ifx\UTFviii@four@octets#1\let\next=\spx@verb@wrapPYG@PYG@four\else \ifx\UTFviii@three@octets#1\let\next=\spx@verb@wrapPYG@PYG@three\else \ifx\UTFviii@two@octets#1\let\next=\spx@verb@wrapPYG@PYG@two\else \let\next=\spx@verb@wrapPYG@PYG@one \fi\fi\fi \next }% \long\def\spx@verb@wrapPYG@PYG@one#1{% \expandafter\PYG\spx@verb@wrapPYG@PYG@spec{#1}% \futurelet\spx@nexttoken\spx@verb@wrapPYG@PYG@i }% \long\def\spx@verb@wrapPYG@PYG@two#1#2{% \expandafter\PYG\spx@verb@wrapPYG@PYG@spec{#1#2}% \futurelet\spx@nexttoken\spx@verb@wrapPYG@PYG@i }% \long\def\spx@verb@wrapPYG@PYG@three#1#2#3{% \expandafter\PYG\spx@verb@wrapPYG@PYG@spec{#1#2#3}% \futurelet\spx@nexttoken\spx@verb@wrapPYG@PYG@i }% \long\def\spx@verb@wrapPYG@PYG@four#1#2#3#4{% \expandafter\PYG\spx@verb@wrapPYG@PYG@spec{#1#2#3#4}% \futurelet\spx@nexttoken\spx@verb@wrapPYG@PYG@i }% \catcode`Z 11 % % \g@addto@macro\FV@SetupFont{% \sbox\sphinxcontinuationbox {\spx@opt@verbatimcontinued}% \sbox\sphinxvisiblespacebox {\spx@opt@verbatimvisiblespace}% }% \newenvironment{sphinxVerbatim}{% % first, let's check if there is a caption \ifx\sphinxVerbatimTitle\empty \sphinxvspacefixafterfrenchlists \parskip\z@skip \vskip\sphinxverbatimsmallskipamount % there was no caption. Check if nevertheless a label was set. \ifx\sphinxLiteralBlockLabel\empty\else % we require some space to be sure hyperlink target from \phantomsection % will not be separated from upcoming verbatim by a page break \needspace{\sphinxliteralblockwithoutcaptionneedspace}% \phantomsection\sphinxLiteralBlockLabel \fi \else \parskip\z@skip \if t\spx@opt@literalblockcappos \vskip\spx@abovecaptionskip \def\sphinxVerbatim@Before {\sphinxVerbatim@Title\nointerlineskip \kern\dimexpr-\dp\strutbox+\sphinxbelowcaptionspace % if no frame (code-blocks inside table cells), remove % the "verbatimsep" whitespace from the top (better visually) \ifspx@opt@verbatimwithframe\else-\sphinxverbatimsep\fi % caption package adds \abovecaptionskip vspace, remove it \spx@ifcaptionpackage{-\abovecaptionskip}{}\relax}% \else \vskip\sphinxverbatimsmallskipamount \def\sphinxVerbatim@After {\nointerlineskip\kern\dimexpr\dp\strutbox \ifspx@opt@verbatimwithframe\else-\sphinxverbatimsep\fi \spx@ifcaptionpackage{-\abovecaptionskip}{}\relax \sphinxVerbatim@Title}% \fi \def\@captype{literalblock}% \capstart % \sphinxVerbatimTitle must reset color \setbox\sphinxVerbatim@TitleBox \hbox{\begin{minipage}{\linewidth}% % caption package may detect wrongly if top or bottom, so we help it \spx@ifcaptionpackage {\caption@setposition{\spx@opt@literalblockcappos}}{}% \sphinxVerbatimTitle \end{minipage}}% \fi \global\let\sphinxLiteralBlockLabel\empty \global\let\sphinxVerbatimTitle\empty \fboxsep\sphinxverbatimsep \fboxrule\sphinxverbatimborder \ifspx@opt@verbatimwithframe\else\fboxrule\z@\fi \let\FrameCommand \sphinxVerbatim@FrameCommand \let\FirstFrameCommand\sphinxVerbatim@FirstFrameCommand \let\MidFrameCommand \sphinxVerbatim@MidFrameCommand \let\LastFrameCommand \sphinxVerbatim@LastFrameCommand \ifspx@opt@verbatimhintsturnover\else \let\sphinxVerbatim@Continued\@empty \let\sphinxVerbatim@Continues\@empty \fi \ifspx@opt@verbatimwrapslines % fancyvrb's Verbatim puts each input line in (unbreakable) horizontal boxes. % This customization wraps each line from the input in a \vtop, thus % allowing it to wrap and display on two or more lines in the latex output. % - The codeline counter will be increased only once. % - The wrapped material will not break across pages, it is impossible % to achieve this without extensive rewrite of fancyvrb. % - The (not used in sphinx) obeytabs option to Verbatim is % broken by this change (showtabs and tabspace work). \let\sphinxVerbatimFormatLine\sphinxVerbatimFormatLineWrap \let\FV@Space\spx@verbatim@space % Allow breaks at special characters using \PYG... macros. \sphinxbreaksatspecials % Breaks at punctuation characters . , ; ? ! and / (needs catcode activation) \fvset{codes*=\sphinxbreaksviaactive}% \else % end of conditional code for wrapping long code lines \let\sphinxVerbatimFormatLine\sphinxVerbatimFormatLineNoWrap \fi \let\FancyVerbFormatLine\sphinxFancyVerbFormatLine \VerbatimEnvironment % workaround to fancyvrb's check of current list depth \def\@toodeep {\advance\@listdepth\@ne}% % The list environment is needed to control perfectly the vertical space. % Note: \OuterFrameSep used by framed.sty is later set to \topsep hence 0pt. % - if caption: distance from last text baseline to caption baseline is % A+(B-F)+\ht\strutbox, A = \abovecaptionskip (default 10pt), B = % \baselineskip, F is the framed.sty \FrameHeightAdjust macro, default 6pt. % Formula valid for F < 10pt. % - distance of baseline of caption to top of frame is like for tables: % \sphinxbelowcaptionspace (=0.5\baselineskip) % - if no caption: distance of last text baseline to code frame is S+(B-F), % with S = \sphinxverbatimtopskip (=\smallskip) % - and distance from bottom of frame to next text baseline is % \baselineskip+\parskip. % The \trivlist is used to avoid possible "too deeply nested" error. \itemsep \z@skip \topsep \z@skip \partopsep \z@skip % trivlist will set \parsep to \parskip (which itself is set to zero above) % \leftmargin will be set to zero by trivlist \rightmargin\z@ \parindent \z@% becomes \itemindent. Default zero, but perhaps overwritten. \trivlist\item\relax \ifspx@inframed\setbox\sphinxVerbatim@ContentsBox\vbox\bgroup \@setminipage\hsize\linewidth % use bulk of minipage paragraph shape restores (this is needed % in indented contexts, at least for some) \textwidth\hsize \columnwidth\hsize \@totalleftmargin\z@ \leftskip\z@skip \rightskip\z@skip \@rightskip\z@skip \else \ifsphinxverbatimwithminipage\noindent\begin{minipage}{\linewidth}\fi \MakeFramed {% adapted over from framed.sty's snugshade environment \advance\hsize-\width\@totalleftmargin\z@\linewidth\hsize\@setminipage }% \fi % For grid placement from \strut's in \FancyVerbFormatLine \lineskip\z@skip % active comma should not be overwritten by \@noligs \ifspx@opt@verbatimwrapslines \let\verbatim@nolig@list \sphinx@verbatim@nolig@list \fi % will fetch its optional arguments if any \OriginalVerbatim } {% \endOriginalVerbatim \ifspx@inframed \egroup % finish \sphinxVerbatim@ContentsBox vbox \nobreak % update page totals \ifdim\dimexpr\ht\sphinxVerbatim@ContentsBox+ \dp\sphinxVerbatim@ContentsBox+ \ht\sphinxVerbatim@TitleBox+ \dp\sphinxVerbatim@TitleBox+ 2\fboxsep+2\fboxrule+ % try to account for external frame parameters \FrameSep+\FrameRule+ % Usage here of 2 baseline distances is empirical. % In border case where code-block fits barely in remaining space, % it gets framed and looks good but the outer frame may continue % on top of next page and give (if no contents after code-block) % an empty framed line, as testing showed. 2\baselineskip+ % now add all to accumulated page totals and compare to \pagegoal \pagetotal+\pagedepth>\pagegoal % long contents: do not \MakeFramed. Do make a caption (either before or % after) if title exists. Continuation hints across pagebreaks dropped. % FIXME? a bottom caption may end up isolated at top of next page % (no problem with a top caption, which is default) \spx@opt@verbatimwithframefalse \def\sphinxVerbatim@Title{\noindent\box\sphinxVerbatim@TitleBox\par}% \sphinxVerbatim@Before \noindent\unvbox\sphinxVerbatim@ContentsBox\par \sphinxVerbatim@After \else % short enough contents: use \MakeFramed. As it is nested, this requires % minipage encapsulation. \noindent\begin{minipage}{\linewidth}% \MakeFramed {% Use it now with the fetched contents \advance\hsize-\width\@totalleftmargin\z@\linewidth\hsize\@setminipage }% \unvbox\sphinxVerbatim@ContentsBox % some of this may be superfluous: \par\unskip\@minipagefalse\endMakeFramed \end{minipage}% \fi \else % non-nested \MakeFramed \par\unskip\@minipagefalse\endMakeFramed % from framed.sty snugshade \ifsphinxverbatimwithminipage\end{minipage}\fi \fi \endtrivlist } \newenvironment {sphinxVerbatimNoFrame} {\spx@opt@verbatimwithframefalse \VerbatimEnvironment \begin{sphinxVerbatim}} {\end{sphinxVerbatim}} \newenvironment {sphinxVerbatimintable} {% don't use a frame if in a table cell \spx@opt@verbatimwithframefalse \sphinxverbatimwithminipagetrue % the literal block caption uses \sphinxcaption which is wrapper of \caption, % but \caption must be modified because longtable redefines it to work only % for the own table caption, and tabulary has multiple passes \let\caption\sphinxfigcaption % reduce above caption skip \def\spx@abovecaptionskip{\sphinxverbatimsmallskipamount}% \VerbatimEnvironment \begin{sphinxVerbatim}} {\end{sphinxVerbatim}} %% PARSED LITERALS % allow long lines to wrap like they do in code-blocks % this should be kept in sync with definitions in sphinx.util.texescape \newcommand*\sphinxbreaksattexescapedchars{% \def\do##1##2% put potential break point before character {\def##1{\discretionary{}{\sphinxafterbreak\char`##2}{\char`##2}}}% \do\{\{\do\textless\<\do\#\#\do\%\%\do\$\$% {, <, #, %, $ \def\do##1##2% put potential break point after character {\def##1{\discretionary{\char`##2}{\sphinxafterbreak}{\char`##2}}}% \do\_\_\do\}\}\do\textasciicircum\^\do\&\&% _, }, ^, &, \do\textgreater\>\do\textasciitilde\~% >, ~ \do\textbackslash\\% \ } \newcommand*\sphinxbreaksviaactiveinparsedliteral{% \sphinxbreaksviaactive % by default handles . , ; ? ! / \lccode`\~`\~ % % update \dospecials as it is used by \url % but deactivation will already have been done hence this is unneeded: % \expandafter\def\expandafter\dospecials\expandafter{\dospecials % \sphinxbreaksbeforeactivelist\sphinxbreaksafteractivelist\do\-}% } \newcommand*\sphinxbreaksatspaceinparsedliteral{% \lccode`~32 \lowercase{\let~}\spx@verbatim@space\lccode`\~`\~ } \newcommand*{\sphinxunactivateextras}{\let\do\@makeother \sphinxbreaksbeforeactivelist\sphinxbreaksafteractivelist}% % the \catcode13=5\relax (deactivate end of input lines) is left to callers \newcommand*{\sphinxunactivateextrasandspace}{\catcode32=10\relax \sphinxunactivateextras}% % now for the modified alltt environment \newenvironment{sphinxalltt} {% at start of next line to workaround Emacs/AUCTeX issue with this file \begin{alltt}% \ifspx@opt@parsedliteralwraps \sbox\sphinxcontinuationbox {\spx@opt@verbatimcontinued}% \sbox\sphinxvisiblespacebox {\spx@opt@verbatimvisiblespace}% \sphinxbreaksattexescapedchars \sphinxbreaksviaactiveinparsedliteral \sphinxbreaksatspaceinparsedliteral % alltt takes care of the ' as derivative ("prime") in math mode \everymath\expandafter{\the\everymath\sphinxunactivateextrasandspace \catcode`\<=12\catcode`\>=12\catcode`\^=7\catcode`\_=8 }% % not sure if displayed math (align,...) can end up in parsed-literal, anyway \everydisplay\expandafter{\the\everydisplay \catcode13=5 \sphinxunactivateextrasandspace \catcode`\<=12\catcode`\>=12\catcode`\^=7\catcode`\_=8 }% \fi } {\end{alltt}} %% INLINE MARK-UP % % Protect \href's first argument in contexts such as sphinxalltt (or % \sphinxcode). Sphinx uses \#, \%, \& ... always inside \sphinxhref. \protected\def\sphinxhref#1#2{{% \sphinxunactivateextrasandspace % never do \scantokens with active space! % for the \endlinechar business, https://github.com/latex3/latex2e/issues/286 \endlinechar\m@ne\everyeof{{\endlinechar13 #2}}% keep catcode regime for #2 \scantokens{\href{#1}}% normalise it for #1 during \href expansion }} % Same for \url. And also \nolinkurl for coherence. \protected\def\sphinxurl#1{{% \sphinxunactivateextrasandspace\everyeof{}% (<- precaution for \scantokens) \endlinechar\m@ne\scantokens{\url{#1}}% }} \protected\def\sphinxnolinkurl#1{{% \sphinxunactivateextrasandspace\everyeof{}% \endlinechar\m@ne\scantokens{\nolinkurl{#1}}% }} % \sphinxupquote % to obtain straight quotes we execute \@noligs as patched by upquote, and % \scantokens is needed in cases where it would be too late for the macro to % first set catcodes and then fetch its argument. We also make the contents % breakable at non-escaped . , ; ? ! / using \sphinxbreaksviaactive, % and also at \ character (which is escaped to \textbackslash{}). \protected\def\sphinxtextbackslashbreakbefore {\discretionary{}{\sphinxafterbreak\sphinx@textbackslash}{\sphinx@textbackslash}} \protected\def\sphinxtextbackslashbreakafter {\discretionary{\sphinx@textbackslash}{\sphinxafterbreak}{\sphinx@textbackslash}} \let\sphinxtextbackslash\sphinxtextbackslashbreakafter % the macro must be protected if it ends up used in moving arguments, % in 'alltt' \@noligs is done already, and the \scantokens must be avoided. \protected\def\sphinxupquote#1{{\def\@tempa{alltt}% \ifx\@tempa\@currenvir\else \ifspx@opt@inlineliteralwraps % break at . , ; ? ! / \sphinxbreaksviaactive % break also at \ \setbox8=\hbox{\textbackslash}% \def\sphinx@textbackslash{\copy8}% \let\textbackslash\sphinxtextbackslash % by default, no continuation symbol on next line but may be added \let\sphinxafterbreak\sphinxafterbreakofinlineliteral % do not overwrite the comma set-up \let\verbatim@nolig@list\sphinx@literal@nolig@list \fi % fix a space-gobbling issue due to LaTeX's original \do@noligs % TODO: using \@noligs as patched by upquote.sty is now unneeded because % either ` and ' are escaped (non-unicode engines) or they don't build % ligatures (unicode engines). Thus remove this and unify handling of `, <, >, % ' and - with the characters . , ; ? ! / as handled via % \sphinxbreaksviaactive. % Hence \sphinx@do@noligs will be removed, or rather replaced with code % inserting discretionaries, as they allow a continuation symbol on start of % next line to achieve common design with code-blocks. \let\do@noligs\sphinx@do@noligs \@noligs\endlinechar\m@ne\everyeof{}% (<- in case inside \sphinxhref) \expandafter\scantokens \fi {{#1}}}}% extra brace pair to fix end-space gobbling issue... \def\sphinx@do@noligs #1{\catcode`#1\active\begingroup\lccode`\~`#1\relax \lowercase{\endgroup\def~{\leavevmode\kern\z@\char`#1 }}} \def\sphinx@literal@nolig@list {\do\`\do\<\do\>\do\'\do\-}% \let\sphinxafterbreakofinlineliteral\empty \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxlatexnumfig.sty0000644000076600000240000001066400000000000022234 0ustar00tkomiyastaff%% NUMBERING OF FIGURES, TABLES, AND LITERAL BLOCKS % % change this info string if making any custom modification \ProvidesFile{sphinxlatexnumfig.sty}[2021/01/27 numbering] % Requires: remreset (old LaTeX only) % relates to numfig and numfig_secnum_depth configuration variables % LaTeX 2018-04-01 and later provides \@removefromreset \ltx@ifundefined{@removefromreset} {\RequirePackage{remreset}} {}% avoid warning % Everything is delayed to \begin{document} to allow hyperref patches into % \newcounter to solve duplicate label problems for internal hyperlinks to % code listings (literalblock counter). User or extension re-definitions of % \theliteralblock, et al., thus have also to be delayed. (changed at 3.5.0) \AtBeginDocument{% \ltx@ifundefined{c@chapter} {\newcounter{literalblock}}% {\newcounter{literalblock}[chapter]% \def\theliteralblock{\ifnum\c@chapter>\z@\arabic{chapter}.\fi \arabic{literalblock}}% }% \ifspx@opt@nonumfigreset \ltx@ifundefined{c@chapter}{}{% \@removefromreset{figure}{chapter}% \@removefromreset{table}{chapter}% \@removefromreset{literalblock}{chapter}% \ifspx@opt@mathnumfig \@removefromreset{equation}{chapter}% \fi }% \def\thefigure{\arabic{figure}}% \def\thetable {\arabic{table}}% \def\theliteralblock{\arabic{literalblock}}% \ifspx@opt@mathnumfig \def\theequation{\arabic{equation}}% \fi \else \let\spx@preAthefigure\@empty \let\spx@preBthefigure\@empty % \ifspx@opt@usespart % <-- LaTeX writer could pass such a 'usespart' boolean % % as sphinx.sty package option % If document uses \part, (triggered in Sphinx by latex_toplevel_sectioning) % LaTeX core per default does not reset chapter or section % counters at each part. % But if we modify this, we need to redefine \thechapter, \thesection to % include the part number and this will cause problems in table of contents % because of too wide numbering. Simplest is to do nothing. % \fi \ifnum\spx@opt@numfigreset>0 \ltx@ifundefined{c@chapter} {} {\g@addto@macro\spx@preAthefigure{\ifnum\c@chapter>\z@\arabic{chapter}.}% \g@addto@macro\spx@preBthefigure{\fi}}% \fi \ifnum\spx@opt@numfigreset>1 \@addtoreset{figure}{section}% \@addtoreset{table}{section}% \@addtoreset{literalblock}{section}% \ifspx@opt@mathnumfig \@addtoreset{equation}{section}% \fi% \g@addto@macro\spx@preAthefigure{\ifnum\c@section>\z@\arabic{section}.}% \g@addto@macro\spx@preBthefigure{\fi}% \fi \ifnum\spx@opt@numfigreset>2 \@addtoreset{figure}{subsection}% \@addtoreset{table}{subsection}% \@addtoreset{literalblock}{subsection}% \ifspx@opt@mathnumfig \@addtoreset{equation}{subsection}% \fi% \g@addto@macro\spx@preAthefigure{\ifnum\c@subsection>\z@\arabic{subsection}.}% \g@addto@macro\spx@preBthefigure{\fi}% \fi \ifnum\spx@opt@numfigreset>3 \@addtoreset{figure}{subsubsection}% \@addtoreset{table}{subsubsection}% \@addtoreset{literalblock}{subsubsection}% \ifspx@opt@mathnumfig \@addtoreset{equation}{subsubsection}% \fi% \g@addto@macro\spx@preAthefigure{\ifnum\c@subsubsection>\z@\arabic{subsubsection}.}% \g@addto@macro\spx@preBthefigure{\fi}% \fi \ifnum\spx@opt@numfigreset>4 \@addtoreset{figure}{paragraph}% \@addtoreset{table}{paragraph}% \@addtoreset{literalblock}{paragraph}% \ifspx@opt@mathnumfig \@addtoreset{equation}{paragraph}% \fi% \g@addto@macro\spx@preAthefigure{\ifnum\c@subparagraph>\z@\arabic{subparagraph}.}% \g@addto@macro\spx@preBthefigure{\fi}% \fi \ifnum\spx@opt@numfigreset>5 \@addtoreset{figure}{subparagraph}% \@addtoreset{table}{subparagraph}% \@addtoreset{literalblock}{subparagraph}% \ifspx@opt@mathnumfig \@addtoreset{equation}{subparagraph}% \fi% \g@addto@macro\spx@preAthefigure{\ifnum\c@subsubparagraph>\z@\arabic{subsubparagraph}.}% \g@addto@macro\spx@preBthefigure{\fi}% \fi \expandafter\g@addto@macro \expandafter\spx@preAthefigure\expandafter{\spx@preBthefigure}% \let\thefigure\spx@preAthefigure \let\thetable\spx@preAthefigure \let\theliteralblock\spx@preAthefigure \g@addto@macro\thefigure{\arabic{figure}}% \g@addto@macro\thetable{\arabic{table}}% \g@addto@macro\theliteralblock{\arabic{literalblock}}% \ifspx@opt@mathnumfig \let\theequation\spx@preAthefigure \g@addto@macro\theequation{\arabic{equation}}% \fi \fi }% end of big \AtBeginDocument \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxlatexobjects.sty0000644000076600000240000001614600000000000022401 0ustar00tkomiyastaff%% MODULE RELEASE DATA AND OBJECT DESCRIPTIONS % % change this info string if making any custom modification \ProvidesFile{sphinxlatexobjects.sty}[2021/01/27 documentation environments] % Provides support for this output mark-up from Sphinx latex writer: % % - environments % % - fulllineitems % - productionlist % - optionlist % - DUlineblock (also "lineblock") % % - macros % % - \DUrole % - various legacy support macros related to author and release % data of documented objects and modules. % \moduleauthor{name}{email} \newcommand{\moduleauthor}[2]{} % \sectionauthor{name}{email} \newcommand{\sectionauthor}[2]{} % Allow the release number to be specified independently of the % \date{}. This allows the date to reflect the document's date and % release to specify the release that is documented. % \newcommand{\py@release}{\releasename\space\version} \newcommand{\version}{}% part of \py@release, used by title page and headers % \releaseinfo is used on titlepage (sphinxmanual.cls, sphinxhowto.cls) \newcommand{\releaseinfo}{} \newcommand{\setreleaseinfo}[1]{\renewcommand{\releaseinfo}{#1}} % this is inserted via template and #1=release config variable \newcommand{\release}[1]{\renewcommand{\version}{#1}} % this is defined by template to 'releasename' latex_elements key \newcommand{\releasename}{} % Fix issue in case release and releasename deliberately left blank \newcommand{\sphinxheadercomma}{, }% used in fancyhdr header definition \newcommand{\sphinxifemptyorblank}[1]{% % test after one expansion of macro #1 if contents is empty or spaces \if&\expandafter\@firstofone\detokenize\expandafter{#1}&% \expandafter\@firstoftwo\else\expandafter\@secondoftwo\fi}% \AtBeginDocument {% \sphinxifemptyorblank{\releasename} {\sphinxifemptyorblank{\version}{\let\sphinxheadercomma\empty}{}} {}% }% % Allow specification of the author's address separately from the % author's name. This can be used to format them differently, which % is a good thing. % \newcommand{\py@authoraddress}{} \newcommand{\authoraddress}[1]{\renewcommand{\py@authoraddress}{#1}} % {fulllineitems} is the main environment for object descriptions. % % With 4.0.0 \pysigline (and \pysiglinewithargsret), used in a fulllineitems % environment the #1 will already be of the width which is computed here, i.e. % the available width on line, so the \makebox becomes a bit superfluous \newcommand{\py@itemnewline}[1]{% macro used as \makelabel in fulllineitems % Memo: this presupposes \itemindent is 0pt \kern\labelsep % because \@labels core latex box does \hskip-\labelsep \makebox[\dimexpr\linewidth+\labelwidth\relax][l]{#1}% \kern-\labelsep % because at end of \@labels box there is \hskip\labelsep } \newenvironment{fulllineitems}{% \begin{list}{}{\labelwidth \leftmargin \rightmargin \z@ \topsep -\parskip \partopsep \parskip \itemsep -\parsep \let\makelabel=\py@itemnewline}% }{\end{list}} % Signatures, possibly multi-line % \newlength{\py@argswidth} \newcommand{\py@sigparams}[2]{% % The \py@argswidth has been computed in \pysiglinewithargsret to make this % occupy full available width on line. \parbox[t]{\py@argswidth}{\raggedright #1\sphinxcode{)}#2\strut}% % final strut is to help get correct vertical separation in case of multi-line % box with the item contents. } \newcommand{\pysigline}[1]{% % the \py@argswidth is available we use it despite its name (no "args" here) % the \relax\relax is because \py@argswidth is a "skip" variable and the first % \relax only ends its "dimen" part \py@argswidth=\dimexpr\linewidth+\labelwidth\relax\relax \item[{\parbox[t]{\py@argswidth}{\raggedright #1\strut}}] % contrarily to \pysiglinewithargsret, we do not do this: % \leavevmode\par\nobreak\vskip-\parskip\prevdepth\dp\strutbox % which would give exact vertical spacing if item parbox is multi-line, % as it affects negatively more common situation of \pysigline % used twice or more in a row for labels sharing common description, % due to bad interaction with the \phantomsection in the mark-up } \newcommand{\pysiglinewithargsret}[3]{% \settowidth{\py@argswidth}{#1\sphinxcode{(}}% \py@argswidth=\dimexpr\linewidth+\labelwidth-\py@argswidth\relax\relax \item[{#1\sphinxcode{(}\py@sigparams{#2}{#3}}] % this strange incantation is because at its root LaTeX in fact did not % imagine a multi-line label, it is always wrapped in a horizontal box at core % LaTeX level and we have to find tricks to get correct interline distances. \leavevmode\par\nobreak\vskip-\parskip\prevdepth\dp\strutbox} \newcommand{\pysigstartmultiline}{% \def\pysigstartmultiline{\vskip\smallskipamount\parskip\z@skip\itemsep\z@skip}% \edef\pysigstopmultiline {\noexpand\leavevmode\parskip\the\parskip\relax\itemsep\the\itemsep\relax}% \parskip\z@skip\itemsep\z@skip } % Production lists % \newenvironment{productionlist}{% % \def\sphinxoptional##1{{\Large[}##1{\Large]}} \def\production##1##2{\\\sphinxcode{\sphinxupquote{##1}}&::=&\sphinxcode{\sphinxupquote{##2}}}% \def\productioncont##1{\\& &\sphinxcode{\sphinxupquote{##1}}}% \parindent=2em \indent \setlength{\LTpre}{0pt}% \setlength{\LTpost}{0pt}% \begin{longtable}[l]{lcl} }{% \end{longtable} } % Definition lists; requested by AMK for HOWTO documents. Probably useful % elsewhere as well, so keep in in the general style support. % \newenvironment{definitions}{% \begin{description}% \def\term##1{\item[{##1}]\mbox{}\\*[0mm]}% }{% \end{description}% } %% FROM DOCTUTILS LATEX WRITER % % The following is stuff copied from docutils' latex writer. % \newcommand{\optionlistlabel}[1]{\normalfont\bfseries #1 \hfill}% \bf deprecated \newenvironment{optionlist}[1] {\begin{list}{} {\setlength{\labelwidth}{#1} \setlength{\rightmargin}{1cm} \setlength{\leftmargin}{\rightmargin} \addtolength{\leftmargin}{\labelwidth} \addtolength{\leftmargin}{\labelsep} \renewcommand{\makelabel}{\optionlistlabel}} }{\end{list}} \newlength{\lineblockindentation} \setlength{\lineblockindentation}{2.5em} \newenvironment{lineblock}[1] {\begin{list}{} {\setlength{\partopsep}{\parskip} \addtolength{\partopsep}{\baselineskip} \topsep0pt\itemsep0.15\baselineskip\parsep0pt \leftmargin#1\relax} \raggedright} {\end{list}} % From docutils.writers.latex2e % inline markup (custom roles) % \DUrole{#1}{#2} tries \DUrole#1{#2} \providecommand*{\DUrole}[2]{% \ifcsname DUrole\detokenize{#1}\endcsname \csname DUrole\detokenize{#1}\endcsname{#2}% \else% backwards compatibility: try \docutilsrole#1{#2} \ifcsname docutilsrole\detokenize{#1}\endcsname \csname docutilsrole\detokenize{#1}\endcsname{#2}% \else #2% \fi \fi } \providecommand*{\DUprovidelength}[2]{% \ifdefined#1\else\newlength{#1}\setlength{#1}{#2}\fi } \DUprovidelength{\DUlineblockindent}{2.5em} \ifdefined\DUlineblock\else \newenvironment{DUlineblock}[1]{% \list{}{\setlength{\partopsep}{\parskip} \addtolength{\partopsep}{\baselineskip} \setlength{\topsep}{0pt} \setlength{\itemsep}{0.15\baselineskip} \setlength{\parsep}{0pt} \setlength{\leftmargin}{#1}} \raggedright } {\endlist} \fi \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxlatexshadowbox.sty0000644000076600000240000000745500000000000022751 0ustar00tkomiyastaff%% TOPIC AND CONTENTS BOXES % % change this info string if making any custom modification \ProvidesFile{sphinxlatexshadowbox.sty}[2021/01/27 sphinxShadowBox] % Provides support for this output mark-up from Sphinx latex writer: % % - sphinxShadowBox (environment) % % Dependencies (they do not need to be defined at time of loading): % % - of course the various colour and dimension options handled via sphinx.sty % - dimension register \spx@image@maxheight from sphinxlatexgraphics.sty % - \savenotes/\spewnotes from sphinxpackagefootnote % - \ifspx@inframed defined in sphinx.sty % % Requires: \RequirePackage{framed} % Again based on use of "framed.sty", this allows breakable framed boxes. \long\def\spx@ShadowFBox#1{% \leavevmode\begingroup % first we frame the box #1 \setbox\@tempboxa \hbox{\vrule\@width\sphinxshadowrule \vbox{\hrule\@height\sphinxshadowrule \kern\sphinxshadowsep \hbox{\kern\sphinxshadowsep #1\kern\sphinxshadowsep}% \kern\sphinxshadowsep \hrule\@height\sphinxshadowrule}% \vrule\@width\sphinxshadowrule}% % Now we add the shadow, like \shadowbox from fancybox.sty would do \dimen@\dimexpr.5\sphinxshadowrule+\sphinxshadowsize\relax \hbox{\vbox{\offinterlineskip \hbox{\copy\@tempboxa\kern-.5\sphinxshadowrule % add shadow on right side \lower\sphinxshadowsize \hbox{\vrule\@height\ht\@tempboxa \@width\dimen@}% }% \kern-\dimen@ % shift back vertically to bottom of frame % and add shadow at bottom \moveright\sphinxshadowsize \vbox{\hrule\@width\wd\@tempboxa \@height\dimen@}% }% % move left by the size of right shadow so shadow adds no width \kern-\sphinxshadowsize }% \endgroup } % use framed.sty to allow page breaks in frame+shadow % works well inside Lists and Quote-like environments % produced by ``topic'' directive (or local contents) % could nest if LaTeX writer authorized it \newenvironment{sphinxShadowBox} {\def\FrameCommand {\spx@ShadowFBox }% \advance\spx@image@maxheight -\dimexpr2\sphinxshadowrule +2\sphinxshadowsep +\sphinxshadowsize +\baselineskip\relax % configure framed.sty not to add extra vertical spacing \ltx@ifundefined{OuterFrameSep}{}{\OuterFrameSep\z@skip}% % the \trivlist will add the vertical spacing on top and bottom which is % typical of center environment as used in Sphinx <= 1.4.1 % the \noindent has the effet of an extra blank line on top, to % imitate closely the layout from Sphinx <= 1.4.1; the \FrameHeightAdjust % will put top part of frame on this baseline. \def\FrameHeightAdjust {\baselineskip}% % use package footnote to handle footnotes \savenotes \trivlist\item\noindent % use a minipage if we are already inside a framed environment \ifspx@inframed\begin{minipage}{\linewidth}\fi \MakeFramed {\spx@inframedtrue % framed.sty puts into "\width" the added width (=2shadowsep+2shadowrule) % adjust \hsize to what the contents must use \advance\hsize-\width % adjust LaTeX parameters to behave properly in indented/quoted contexts \FrameRestore % typeset the contents as in a minipage (Sphinx <= 1.4.1 used a minipage and % itemize/enumerate are therein typeset more tightly, we want to keep % that). We copy-paste from LaTeX source code but don't do a real minipage. \@pboxswfalse \let\@listdepth\@mplistdepth \@mplistdepth\z@ \@minipagerestore \@setminipage }% }% {% insert the "endminipage" code \par\unskip \@minipagefalse \endMakeFramed \ifspx@inframed\end{minipage}\fi \endtrivlist % output the stored footnotes \spewnotes } \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxlatexstyleheadings.sty0000644000076600000240000000626500000000000023614 0ustar00tkomiyastaff%% TITLES % % change this info string if making any custom modification \ProvidesFile{sphinxlatexstyleheadings.sty}[2021/01/27 headings] \RequirePackage[nobottomtitles*]{titlesec} \@ifpackagelater{titlesec}{2016/03/15}% {\@ifpackagelater{titlesec}{2016/03/21}% {}% {\newif\ifsphinx@ttlpatch@ok \IfFileExists{etoolbox.sty}{% \RequirePackage{etoolbox}% \patchcmd{\ttlh@hang}{\parindent\z@}{\parindent\z@\leavevmode}% {\sphinx@ttlpatch@oktrue}{}% \ifsphinx@ttlpatch@ok \patchcmd{\ttlh@hang}{\noindent}{}{}{\sphinx@ttlpatch@okfalse}% \fi }{}% \ifsphinx@ttlpatch@ok \typeout{^^J Package Sphinx Info: ^^J **** titlesec 2.10.1 successfully patched for bugfix ****^^J}% \else \AtEndDocument{\PackageWarningNoLine{sphinx}{^^J% ******** titlesec 2.10.1 has a bug, (section numbers disappear) ......|^^J% ******** and Sphinx could not patch it, perhaps because your local ...|^^J% ******** copy is already fixed without a changed release date. .......|^^J% ******** If not, you must update titlesec! ...........................|}}% \fi }% }{} % Augment the sectioning commands used to get our own font family in place, % and reset some internal data items (\titleformat from titlesec package) \titleformat{\section}{\Large\py@HeaderFamily}% {\py@TitleColor\thesection}{0.5em}{\py@TitleColor} \titleformat{\subsection}{\large\py@HeaderFamily}% {\py@TitleColor\thesubsection}{0.5em}{\py@TitleColor} \titleformat{\subsubsection}{\py@HeaderFamily}% {\py@TitleColor\thesubsubsection}{0.5em}{\py@TitleColor} % By default paragraphs (and subsubsections) will not be numbered because % sphinxmanual.cls and sphinxhowto.cls set secnumdepth to 2 \titleformat{\paragraph}{\py@HeaderFamily}% {\py@TitleColor\theparagraph}{0.5em}{\py@TitleColor} \titleformat{\subparagraph}{\py@HeaderFamily}% {\py@TitleColor\thesubparagraph}{0.5em}{\py@TitleColor} % Since Sphinx 1.5, users should use HeaderFamily key to 'sphinxsetup' rather % than defining their own \py@HeaderFamily command (which is still possible). % Memo: \py@HeaderFamily is also used by \maketitle as defined in % sphinxmanual.cls/sphinxhowto.cls \newcommand{\py@HeaderFamily}{\spx@opt@HeaderFamily} % This sets up the fancy chapter headings that make the documents look % at least a little better than the usual LaTeX output. \@ifpackagewith{fncychap}{Bjarne}{ \ChNameVar {\raggedleft\normalsize \py@HeaderFamily} \ChNumVar {\raggedleft\Large \py@HeaderFamily} \ChTitleVar{\raggedleft\Large \py@HeaderFamily} % This creates (numbered) chapter heads without the leading \vspace*{}: \def\@makechapterhead#1{% {\parindent \z@ \raggedright \normalfont \ifnum \c@secnumdepth >\m@ne \if@mainmatter \DOCH \fi \fi \interlinepenalty\@M \if@mainmatter \DOTI{#1}% \else% \DOTIS{#1}% \fi }} }{}% <-- "false" clause of \@ifpackagewith % fix fncychap's bug which uses prematurely the \textwidth value \@ifpackagewith{fncychap}{Bjornstrup} {\AtBeginDocument{\mylen\textwidth\advance\mylen-2\myhi}}% {}% <-- "false" clause of \@ifpackagewith \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxlatexstylepage.sty0000644000076600000240000000577000000000000022746 0ustar00tkomiyastaff%% PAGE STYLING % % change this info string if making any custom modification \ProvidesFile{sphinxlatexstylepage.sty}[2021/01/27 page styling] % Separate paragraphs by space by default. \IfFileExists{parskip-2001-04-09.sty}% since September 2018 TeXLive update % new parskip.sty, but let it rollback to old one. % hopefully TeX installation not broken and LaTeX kernel not too old {\RequirePackage{parskip}[=v1]} % standard one from 1989. Admittedly \section of article/book gives possibly % anomalous spacing, but we can't require September 2018 release for some time. {\RequirePackage{parskip}} % Style parameters and macros used by most documents here \raggedbottom \sloppy \hbadness = 5000 % don't print trivial gripes % Require package fancyhdr except under memoir class \@ifclassloaded{memoir}{}{\RequirePackage{fancyhdr}} % Use \pagestyle{normal} as the primary pagestyle for text. % Redefine the 'normal' header/footer style when using "fancyhdr" package: \@ifpackageloaded{fancyhdr}{% \ltx@ifundefined{c@chapter} {% no \chapter, "howto" (non-Japanese) docclass \fancypagestyle{plain}{ \fancyhf{} \fancyfoot[C]{{\py@HeaderFamily\thepage}} \renewcommand{\headrulewidth}{0pt} \renewcommand{\footrulewidth}{0pt} } % Same as 'plain', this way we can use it in template % FIXME: shouldn't this have a running header with Name and Release like 'manual'? \fancypagestyle{normal}{ \fancyhf{} \fancyfoot[C]{{\py@HeaderFamily\thepage}} \renewcommand{\headrulewidth}{0pt} \renewcommand{\footrulewidth}{0pt} } }% {% classes with \chapter command \fancypagestyle{normal}{ \fancyhf{} \fancyfoot[RO]{{\py@HeaderFamily\thepage}} \fancyfoot[LO]{{\py@HeaderFamily\nouppercase{\rightmark}}} \fancyhead[RO]{{\py@HeaderFamily \@title\sphinxheadercomma\py@release}} \if@twoside \fancyfoot[LE]{{\py@HeaderFamily\thepage}} \fancyfoot[RE]{{\py@HeaderFamily\nouppercase{\leftmark}}} \fancyhead[LE]{{\py@HeaderFamily \@title\sphinxheadercomma\py@release}} \fi \renewcommand{\headrulewidth}{0.4pt} \renewcommand{\footrulewidth}{0.4pt} % define chaptermark with \@chappos when \@chappos is available for Japanese \ltx@ifundefined{@chappos}{} {\def\chaptermark##1{\markboth{\@chapapp\space\thechapter\space\@chappos\space ##1}{}}} } % Update the plain style so we get the page number & footer line, % but not a chapter or section title. This is to keep the first % page of a chapter `clean.' \fancypagestyle{plain}{ \fancyhf{} \fancyfoot[RO]{{\py@HeaderFamily\thepage}} \if@twoside\fancyfoot[LE]{{\py@HeaderFamily\thepage}}\fi \renewcommand{\headrulewidth}{0pt} \renewcommand{\footrulewidth}{0.4pt} } } } {% no fancyhdr: memoir class % Provide default for 'normal' style simply as an alias of 'plain' style % This way we can use \pagestyle{normal} in LaTeX template \def\ps@normal{\ps@plain} % Users of memoir class are invited to redefine 'normal' style in preamble } \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxlatexstyletext.sty0000644000076600000240000001321300000000000023005 0ustar00tkomiyastaff%% TEXT STYLING % % change this info string if making any custom modification \ProvidesFile{sphinxlatexstyletext.sty}[2021/01/27 text styling] % Basically everything here consists of macros which are part of the latex % markup produced by the Sphinx latex writer % Some custom font markup commands. \protected\def\sphinxstrong#1{\textbf{#1}} \protected\def\sphinxcode#1{\texttt{#1}} \protected\def\sphinxbfcode#1{\textbf{\sphinxcode{#1}}} \protected\def\sphinxemail#1{\textsf{#1}} \protected\def\sphinxtablecontinued#1{\textsf{#1}} \protected\def\sphinxtitleref#1{\emph{#1}} \protected\def\sphinxmenuselection#1{\emph{#1}} \protected\def\sphinxguilabel#1{\emph{#1}} \protected\def\sphinxkeyboard#1{\sphinxcode{#1}} \protected\def\sphinxaccelerator#1{\underline{#1}} \protected\def\sphinxcrossref#1{\emph{#1}} \protected\def\sphinxtermref#1{\emph{#1}} % \optional is used for ``[, arg]``, i.e. desc_optional nodes. \long\protected\def\sphinxoptional#1{% {\textnormal{\Large[}}{#1}\hspace{0.5mm}{\textnormal{\Large]}}} % additional customizable styling \def\sphinxstyleindexentry #1{\texttt{#1}} \def\sphinxstyleindexextra #1{ (\emph{#1})} \def\sphinxstyleindexpageref #1{, \pageref{#1}} \def\sphinxstyleindexpagemain#1{\textbf{#1}} \def\spxentry{\@backslashchar spxentry}% let to \sphinxstyleindexentry in index \def\spxextra{\@backslashchar spxextra}% let to \sphinxstyleindexextra in index \def\sphinxstyleindexlettergroup #1% {{\Large\sffamily#1}\nopagebreak\vspace{1mm}} \def\sphinxstyleindexlettergroupDefault #1% {{\Large\sffamily\sphinxnonalphabeticalgroupname}\nopagebreak\vspace{1mm}} \protected\def\sphinxstyletopictitle #1{\textbf{#1}\par\medskip} \let\sphinxstylesidebartitle\sphinxstyletopictitle \protected\def\sphinxstyleothertitle #1{\textbf{#1}} \protected\def\sphinxstylesidebarsubtitle #1{~\\\textbf{#1} \smallskip} % \text.. commands do not allow multiple paragraphs \protected\def\sphinxstyletheadfamily {\sffamily} \protected\def\sphinxstyleemphasis #1{\emph{#1}} \protected\def\sphinxstyleliteralemphasis#1{\emph{\sphinxcode{#1}}} \protected\def\sphinxstylestrong #1{\textbf{#1}} \protected\def\sphinxstyleliteralstrong#1{\sphinxbfcode{#1}} \protected\def\sphinxstyleabbreviation #1{\textsc{#1}} \protected\def\sphinxstyleliteralintitle#1{\sphinxcode{#1}} \newcommand*\sphinxstylecodecontinued[1]{\footnotesize(#1)}% \newcommand*\sphinxstylecodecontinues[1]{\footnotesize(#1)}% % figure legend comes after caption and may contain arbitrary body elements \newenvironment{sphinxlegend}{\par\small}{\par} % reduce hyperref "Token not allowed in a PDF string" warnings on PDF builds \AtBeginDocument{\pdfstringdefDisableCommands{% % all "protected" macros possibly ending up in section titles should be here % TODO: examine if \sphinxhref, \sphinxurl, \sphinnolinkurl should be handled \let\sphinxstyleemphasis \@firstofone \let\sphinxstyleliteralemphasis \@firstofone \let\sphinxstylestrong \@firstofone \let\sphinxstyleliteralstrong \@firstofone \let\sphinxstyleabbreviation \@firstofone \let\sphinxstyleliteralintitle \@firstofone \let\sphinxupquote \@firstofone \let\sphinxstrong \@firstofone \let\sphinxcode \@firstofone \let\sphinxbfcode \@firstofone \let\sphinxemail \@firstofone \let\sphinxcrossref \@firstofone \let\sphinxtermref \@firstofone \let\sphinxhyphen\sphinxhyphenforbookmarks }} % Special characters % % This definition prevents en-dash and em-dash TeX ligatures. % % It inserts a potential breakpoint after the hyphen. This is to keep in sync % with behavior in code-blocks, parsed and inline literals. For a breakpoint % before the hyphen use \leavevmode\kern\z@- (within \makeatletter/\makeatother) \protected\def\sphinxhyphen#1{-\kern\z@} % The {} from texescape mark-up is kept, else -- gives en-dash in PDF bookmark \def\sphinxhyphenforbookmarks{-} % For curly braces inside \index macro \def\sphinxleftcurlybrace{\{} \def\sphinxrightcurlybrace{\}} % Declare Unicode characters used by linux tree command to pdflatex utf8/utf8x \def\spx@bd#1#2{% \leavevmode \begingroup \ifx\spx@bd@height \@undefined\def\spx@bd@height{\baselineskip}\fi \ifx\spx@bd@width \@undefined\setbox0\hbox{0}\def\spx@bd@width{\wd0 }\fi \ifx\spx@bd@thickness\@undefined\def\spx@bd@thickness{.6\p@}\fi \ifx\spx@bd@lower \@undefined\def\spx@bd@lower{\dp\strutbox}\fi \lower\spx@bd@lower#1{#2}% \endgroup }% \@namedef{sphinx@u2500}% BOX DRAWINGS LIGHT HORIZONTAL {\spx@bd{\vbox to\spx@bd@height} {\vss\hrule\@height\spx@bd@thickness \@width\spx@bd@width\vss}}% \@namedef{sphinx@u2502}% BOX DRAWINGS LIGHT VERTICAL {\spx@bd{\hb@xt@\spx@bd@width} {\hss\vrule\@height\spx@bd@height \@width \spx@bd@thickness\hss}}% \@namedef{sphinx@u2514}% BOX DRAWINGS LIGHT UP AND RIGHT {\spx@bd{\hb@xt@\spx@bd@width} {\hss\raise.5\spx@bd@height \hb@xt@\z@{\hss\vrule\@height.5\spx@bd@height \@width \spx@bd@thickness\hss}% \vbox to\spx@bd@height{\vss\hrule\@height\spx@bd@thickness \@width.5\spx@bd@width\vss}}}% \@namedef{sphinx@u251C}% BOX DRAWINGS LIGHT VERTICAL AND RIGHT {\spx@bd{\hb@xt@\spx@bd@width} {\hss \hb@xt@\z@{\hss\vrule\@height\spx@bd@height \@width \spx@bd@thickness\hss}% \vbox to\spx@bd@height{\vss\hrule\@height\spx@bd@thickness \@width.5\spx@bd@width\vss}}}% \protected\def\sphinxunichar#1{\@nameuse{sphinx@u#1}}% % Tell TeX about pathological hyphenation cases: \hyphenation{Base-HTTP-Re-quest-Hand-ler} \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxlatextables.sty0000644000076600000240000005253000000000000022217 0ustar00tkomiyastaff%% TABLES (WITH SUPPORT FOR MERGED CELLS OF GENERAL CONTENTS) % % change this info string if making any custom modification \ProvidesFile{sphinxlatextables.sty}[2021/01/27 tables]% % Provides support for this output mark-up from Sphinx latex writer % and table templates: % % - the tabulary and longtable environments from the eponymous packages % - the varwidth environment % - the >{} etc mark-up possible in tabularcolumns is from array package % which is loaded by longtable and tabulary % - \X, \Y, T column types; others (L, C, R, J) are from tabulary package % - \sphinxaftertopcaption % - \sphinxatlongtableend % - \sphinxatlongtablestart % - \sphinxattableend % - \sphinxattablestart % - \sphinxcapstartof % - \sphinxcolwidth % - \sphinxlongtablecapskipadjust % - \sphinxmultirow % - \sphinxstartmulticolumn % - \sphinxstopmulticolumn % - \sphinxtablestrut % - \sphinxthecaptionisattop % - \sphinxthelongtablecaptionisattop % % Executes \RequirePackage for: % % - tabulary % - longtable % - varwidth % % Extends tabulary and longtable via patches and custom macros to support % merged cells possibly containing code-blocks in complex tables \RequirePackage{tabulary} % tabulary has a bug with its re-definition of \multicolumn in its first pass % which is not \long. But now Sphinx does not use LaTeX's \multicolumn but its % own macro. Hence we don't even need to patch tabulary. See % sphinxpackagemulticell.sty % X or S (Sphinx) may have meanings if some table package is loaded hence % \X was chosen to avoid possibility of conflict \newcolumntype{\X}[2]{p{\dimexpr (\linewidth-\arrayrulewidth)*#1/#2-\tw@\tabcolsep-\arrayrulewidth\relax}} \newcolumntype{\Y}[1]{p{\dimexpr #1\dimexpr\linewidth-\arrayrulewidth\relax-\tw@\tabcolsep-\arrayrulewidth\relax}} % using here T (for Tabulary) feels less of a problem than the X could be \newcolumntype{T}{J}% % For tables allowing pagebreaks \RequirePackage{longtable} % User interface to set-up whitespace before and after tables: \newcommand*\sphinxtablepre {0pt}% \newcommand*\sphinxtablepost{\medskipamount}% % Space from caption baseline to top of table or frame of literal-block \newcommand*\sphinxbelowcaptionspace{.5\sphinxbaselineskip}% % as one can not use \baselineskip from inside longtable (it is zero there) % we need \sphinxbaselineskip, which defaults to \baselineskip \def\sphinxbaselineskip{\baselineskip}% % The following is to ensure that, whether tabular(y) or longtable: % - if a caption is on top of table: % a) the space between its last baseline and the top rule of table is % exactly \sphinxbelowcaptionspace % b) the space from last baseline of previous text to first baseline of % caption is exactly \parskip+\baselineskip+ height of a strut. % c) the caption text will wrap at width \LTcapwidth (4in) % - make sure this works also if "caption" package is loaded by user % (with its width or margin option taking place of \LTcapwidth role) % TODO: obtain same for caption of literal block: a) & c) DONE, b) TO BE DONE % % To modify space below such top caption, adjust \sphinxbelowcaptionspace % To add or remove space above such top caption, adjust \sphinxtablepre: % notice that \abovecaptionskip, \belowcaptionskip, \LTpre are **ignored** % A. Table with longtable \def\sphinxatlongtablestart {\par \vskip\parskip \vskip\dimexpr\sphinxtablepre\relax % adjust vertical position \vbox{}% get correct baseline from above \LTpre\z@skip\LTpost\z@skip % set to zero longtable's own skips \edef\sphinxbaselineskip{\dimexpr\the\dimexpr\baselineskip\relax\relax}% }% % Compatibility with caption package \def\sphinxthelongtablecaptionisattop{% \spx@ifcaptionpackage{\noalign{\vskip-\belowcaptionskip}}{}% }% % Achieves exactly \sphinxbelowcaptionspace below longtable caption \def\sphinxlongtablecapskipadjust {\dimexpr-\dp\strutbox -\spx@ifcaptionpackage{\abovecaptionskip}{\sphinxbaselineskip}% +\sphinxbelowcaptionspace\relax}% \def\sphinxatlongtableend{\@nobreakfalse % latex3/latex2e#173 \prevdepth\z@\vskip\sphinxtablepost\relax}% % B. Table with tabular or tabulary \def\sphinxattablestart{\par\vskip\dimexpr\sphinxtablepre\relax}% \let\sphinxattableend\sphinxatlongtableend % This is used by tabular and tabulary templates \newcommand*\sphinxcapstartof[1]{% \vskip\parskip \vbox{}% force baselineskip for good positioning by capstart of hyperanchor % hyperref puts the anchor 6pt above this baseline; in case of caption % this baseline will be \ht\strutbox above first baseline of caption \def\@captype{#1}% \capstart % move back vertically, as tabular (or its caption) will compensate \vskip-\baselineskip\vskip-\parskip }% \def\sphinxthecaptionisattop{% locate it after \sphinxcapstartof \spx@ifcaptionpackage {\caption@setposition{t}% \vskip\baselineskip\vskip\parskip % undo those from \sphinxcapstartof \vskip-\belowcaptionskip % anticipate caption package skip % caption package uses a \vbox, not a \vtop, so "single line" case % gives different result from "multi-line" without this: \nointerlineskip }% {}% }% \def\sphinxthecaptionisatbottom{% (not finalized; for template usage) \spx@ifcaptionpackage{\caption@setposition{b}}{}% }% % The aim of \sphinxcaption is to apply to tabular(y) the maximal width % of caption as done by longtable \def\sphinxtablecapwidth{\LTcapwidth}% \newcommand\sphinxcaption{\@dblarg\spx@caption}% \long\def\spx@caption[#1]#2{% \noindent\hb@xt@\linewidth{\hss \vtop{\@tempdima\dimexpr\sphinxtablecapwidth\relax % don't exceed linewidth for the caption width \ifdim\@tempdima>\linewidth\hsize\linewidth\else\hsize\@tempdima\fi % longtable ignores \abovecaptionskip/\belowcaptionskip, so do the same here \abovecaptionskip\sphinxabovecaptionskip % \z@skip \belowcaptionskip\sphinxbelowcaptionskip % \z@skip \caption[{#1}]% {\strut\ignorespaces#2\ifhmode\unskip\@finalstrut\strutbox\fi}% }\hss}% \par\prevdepth\dp\strutbox }% \def\sphinxabovecaptionskip{\z@skip}% Do not use! Flagged for removal \def\sphinxbelowcaptionskip{\z@skip}% Do not use! Flagged for removal % This wrapper of \abovecaptionskip is used in sphinxVerbatim for top % caption, and with another value in sphinxVerbatimintable % TODO: To unify space above caption of a code-block with the one above % caption of a table/longtable, \abovecaptionskip must not be used % This auxiliary will get renamed and receive a different meaning % in future. \def\spx@abovecaptionskip{\abovecaptionskip}% % Achieve \sphinxbelowcaptionspace below a caption located above a tabular % or a tabulary \newcommand\sphinxaftertopcaption {% \spx@ifcaptionpackage {\par\prevdepth\dp\strutbox\nobreak\vskip-\abovecaptionskip}{\nobreak}% \vskip\dimexpr\sphinxbelowcaptionspace\relax \vskip-\baselineskip\vskip-\parskip }% % varwidth is crucial for our handling of general contents in merged cells \RequirePackage{varwidth} % but addition of a compatibility patch with hyperref is needed % (tested with varwidth v 0.92 Mar 2009) \AtBeginDocument {% \let\@@vwid@Hy@raisedlink\Hy@raisedlink \long\def\@vwid@Hy@raisedlink#1{\@vwid@wrap{\@@vwid@Hy@raisedlink{#1}}}% \edef\@vwid@setup{% \let\noexpand\Hy@raisedlink\noexpand\@vwid@Hy@raisedlink % HYPERREF ! \unexpanded\expandafter{\@vwid@setup}}% }% %%%%%%%%%%%%%%%%%%%%% % --- MULTICOLUMN --- % standard LaTeX's \multicolumn % 1. does not allow verbatim contents, % 2. interacts very poorly with tabulary. % % It is needed to write own macros for Sphinx: to allow code-blocks in merged % cells rendered by tabular/longtable, and to allow multi-column cells with % paragraphs to be taken into account sanely by tabulary algorithm for column % widths. % % This requires quite a bit of hacking. First, in Sphinx, the multi-column % contents will *always* be wrapped in a varwidth environment. The issue % becomes to pass it the correct target width. We must trick tabulary into % believing the multicolumn is simply separate columns, else tabulary does not % incorporate the contents in its algorithm. But then we must clear the % vertical rules... % % configuration of tabulary \setlength{\tymin}{3\fontcharwd\font`0 }% minimal width of "squeezed" columns \setlength{\tymax}{10000pt}% allow enough room for paragraphs to "compete" % we need access to tabulary's final computed width. \@tempdima is too volatile % to hope it has kept tabulary's value when \sphinxcolwidth needs it. \newdimen\sphinx@TY@tablewidth \def\tabulary{% \def\TY@final{\sphinx@TY@tablewidth\@tempdima\tabular}% \let\endTY@final\endtabular \TY@tabular}% % next hack is needed only if user has set latex_use_latex_multicolumn to True: % it fixes tabulary's bug with \multicolumn defined "short" in first pass. (if % upstream tabulary adds a \long, our extra one causes no harm) \def\sphinx@tempa #1\def\multicolumn#2#3#4#5#6#7#8#9\sphinx@tempa {\def\TY@tab{#1\long\def\multicolumn####1####2####3{\multispan####1\relax}#9}}% \expandafter\sphinx@tempa\TY@tab\sphinx@tempa % % TN. 1: as \omit is never executed, Sphinx multicolumn does not need to worry % like standard multicolumn about |l| vs l|. On the other hand it assumes % columns are separated by a | ... (if not it will add extraneous % \arrayrulewidth space for each column separation in its estimate of available % width). % % TN. 1b: as Sphinx multicolumn uses neither \omit nor \span, it can not % (easily) get rid of extra macros from >{...} or <{...} between columns. At % least, it has been made compatible with colortbl's \columncolor. % % TN. 2: tabulary's second pass is handled like tabular/longtable's single % pass, with the difference that we hacked \TY@final to set in % \sphinx@TY@tablewidth the final target width as computed by tabulary. This is % needed only to handle columns with a "horizontal" specifier: "p" type columns % (inclusive of tabulary's LJRC) holds the target column width in the % \linewidth dimension. % % TN. 3: use of \begin{sphinxmulticolumn}...\end{sphinxmulticolumn} mark-up % would need some hacking around the fact that groups can not span across table % cells (the code does inserts & tokens, see TN1b). It was decided to keep it % simple with \sphinxstartmulticolumn...\sphinxstopmulticolumn. % % MEMO about nesting: if sphinxmulticolumn is encountered in a nested tabular % inside a tabulary it will think to be at top level in the tabulary. But % Sphinx generates no nested tables, and if some LaTeX macro uses internally a % tabular this will not have a \sphinxstartmulticolumn within it! % \def\sphinxstartmulticolumn{% \ifx\equation$% $ tabulary's first pass \expandafter\sphinx@TYI@start@multicolumn \else % either not tabulary or tabulary's second pass \expandafter\sphinx@start@multicolumn \fi }% \def\sphinxstopmulticolumn{% \ifx\equation$% $ tabulary's first pass \expandafter\sphinx@TYI@stop@multicolumn \else % either not tabulary or tabulary's second pass \ignorespaces \fi }% \def\sphinx@TYI@start@multicolumn#1{% % use \gdef always to avoid stack space build up \gdef\sphinx@tempa{#1}\begingroup\setbox\z@\hbox\bgroup }% \def\sphinx@TYI@stop@multicolumn{\egroup % varwidth was used with \tymax \xdef\sphinx@tempb{\the\dimexpr\wd\z@/\sphinx@tempa}% per column width \endgroup \expandafter\sphinx@TYI@multispan\expandafter{\sphinx@tempa}% }% \def\sphinx@TYI@multispan #1{% \kern\sphinx@tempb\ignorespaces % the per column occupied width \ifnum#1>\@ne % repeat, taking into account subtleties of TeX's & ... \expandafter\sphinx@TYI@multispan@next\expandafter{\the\numexpr#1-\@ne\expandafter}% \fi }% \def\sphinx@TYI@multispan@next{&\relax\sphinx@TYI@multispan}% % % Now the branch handling either the second pass of tabulary or the single pass % of tabular/longtable. This is the delicate part where we gather the % dimensions from the p columns either set-up by tabulary or by user p column % or Sphinx \X, \Y columns. The difficulty is that to get the said width, the % template must be inserted (other hacks would be horribly complicated except % if we rewrote crucial parts of LaTeX's \@array !) and we can not do % \omit\span like standard \multicolumn's easy approach. Thus we must cancel % the \vrule separators. Also, perhaps the column specifier is of the l, c, r % type, then we attempt an ad hoc rescue to give varwidth a reasonable target % width. \def\sphinx@start@multicolumn#1{% \gdef\sphinx@multiwidth{0pt}\gdef\sphinx@tempa{#1}\sphinx@multispan{#1}% }% \def\sphinx@multispan #1{% \ifnum#1=\@ne\expandafter\sphinx@multispan@end \else\expandafter\sphinx@multispan@next \fi {#1}% }% \def\sphinx@multispan@next #1{% % trick to recognize L, C, R, J or p, m, b type columns \ifdim\baselineskip>\z@ \gdef\sphinx@tempb{\linewidth}% \else % if in an l, r, c type column, try and hope for the best \xdef\sphinx@tempb{\the\dimexpr(\ifx\TY@final\@undefined\linewidth\else \sphinx@TY@tablewidth\fi-\arrayrulewidth)/\sphinx@tempa -\tw@\tabcolsep-\arrayrulewidth\relax}% \fi \noindent\kern\sphinx@tempb\relax \xdef\sphinx@multiwidth {\the\dimexpr\sphinx@multiwidth+\sphinx@tempb+\tw@\tabcolsep+\arrayrulewidth}% % hack the \vline and the colortbl macros \sphinx@hack@vline\sphinx@hack@CT&\relax % repeat \expandafter\sphinx@multispan\expandafter{\the\numexpr#1-\@ne}% }% % packages like colortbl add group levels, we need to "climb back up" to be % able to hack the \vline and also the colortbl inserted tokens. This creates % empty space whether or not the columns were | separated: \def\sphinx@hack@vline{\ifnum\currentgrouptype=6\relax \kern\arrayrulewidth\arrayrulewidth\z@\else\aftergroup\sphinx@hack@vline\fi}% \def\sphinx@hack@CT{\ifnum\currentgrouptype=6\relax \let\CT@setup\sphinx@CT@setup\else\aftergroup\sphinx@hack@CT\fi}% % It turns out \CT@row@color is not expanded contrarily to \CT@column@color % during LaTeX+colortbl preamble preparation, hence it would be possible for % \sphinx@CT@setup to discard only the column color and choose to obey or not % row color and cell color. It would even be possible to propagate cell color % to row color for the duration of the Sphinx multicolumn... the (provisional?) % choice has been made to cancel the colortbl colours for the multicolumn % duration. \def\sphinx@CT@setup #1\endgroup{\endgroup}% hack to remove colour commands \def\sphinx@multispan@end#1{% % first, trace back our steps horizontally \noindent\kern-\dimexpr\sphinx@multiwidth\relax % and now we set the final computed width for the varwidth environment \ifdim\baselineskip>\z@ \xdef\sphinx@multiwidth{\the\dimexpr\sphinx@multiwidth+\linewidth}% \else \xdef\sphinx@multiwidth{\the\dimexpr\sphinx@multiwidth+ (\ifx\TY@final\@undefined\linewidth\else \sphinx@TY@tablewidth\fi-\arrayrulewidth)/\sphinx@tempa -\tw@\tabcolsep-\arrayrulewidth\relax}% \fi % we need to remove colour set-up also for last cell of the multi-column \aftergroup\sphinx@hack@CT }% \newcommand*\sphinxcolwidth[2]{% % this dimension will always be used for varwidth, and serves as maximum % width when cells are merged either via multirow or multicolumn or both, % as always their contents is wrapped in varwidth environment. \ifnum#1>\@ne % multi-column (and possibly also multi-row) % we wrote our own multicolumn code especially to handle that (and allow % verbatim contents) \ifx\equation$%$ \tymax % first pass of tabulary (cf MEMO above regarding nesting) \else % the \@gobble thing is for compatibility with standard \multicolumn \sphinx@multiwidth\@gobble{#1/#2}% \fi \else % single column multirow \ifx\TY@final\@undefined % not a tabulary. \ifdim\baselineskip>\z@ % in a p{..} type column, \linewidth is the target box width \linewidth \else % l, c, r columns. Do our best. \dimexpr(\linewidth-\arrayrulewidth)/#2- \tw@\tabcolsep-\arrayrulewidth\relax \fi \else % in tabulary \ifx\equation$%$% first pass \tymax % it is set to a big value so that paragraphs can express themselves \else % second pass. \ifdim\baselineskip>\z@ \linewidth % in a L, R, C, J column or a p, \X, \Y ... \else % we have hacked \TY@final to put in \sphinx@TY@tablewidth the table width \dimexpr(\sphinx@TY@tablewidth-\arrayrulewidth)/#2- \tw@\tabcolsep-\arrayrulewidth\relax \fi \fi \fi \fi }% % fallback default in case user has set latex_use_latex_multicolumn to True: % \sphinxcolwidth will use this only inside LaTeX's standard \multicolumn \def\sphinx@multiwidth #1#2{\dimexpr % #1 to gobble the \@gobble (!) (\ifx\TY@final\@undefined\linewidth\else\sphinx@TY@tablewidth\fi -\arrayrulewidth)*#2-\tw@\tabcolsep-\arrayrulewidth\relax}% %%%%%%%%%%%%%%%%%% % --- MULTIROW --- % standard \multirow % 1. does not allow verbatim contents, % 2. does not allow blank lines in its argument, % 3. its * specifier means to typeset "horizontally" which is very % bad for paragraph content. 2016 version has = specifier but it % must be used with p type columns only, else results are bad, % 4. it requires manual intervention if the contents is too long to fit % in the asked-for number of rows. % 5. colour panels (either from \rowcolor or \columncolor) will hide % the bottom part of multirow text, hence manual tuning is needed % to put the multirow insertion at the _bottom_. % % The Sphinx solution consists in always having contents wrapped % in a varwidth environment so that it makes sense to estimate how many % lines it will occupy, and then ensure by insertion of suitable struts % that the table rows have the needed height. The needed mark-up is done % by LaTeX writer, which has its own id for the merged cells. % % The colour issue is solved by clearing colour panels in all cells, % whether or not the multirow is single-column or multi-column. % % In passing we obtain baseline alignements across rows (only if % \arraystretch is 1, as LaTeX's does not obey \arraystretch in "p" % multi-line contents, only first and last line...) % % TODO: examine the situation with \arraystretch > 1. The \extrarowheight % is hopeless for multirow anyhow, it makes baseline alignment strictly % impossible. \newcommand\sphinxmultirow[2]{\begingroup % #1 = nb of spanned rows, #2 = Sphinx id of "cell", #3 = contents % but let's fetch #3 in a way allowing verbatim contents ! \def\sphinx@nbofrows{#1}\def\sphinx@cellid{#2}% \afterassignment\sphinx@multirow\let\next= }% \def\sphinx@multirow {% \setbox\z@\hbox\bgroup\aftergroup\sphinx@@multirow\strut }% \def\sphinx@@multirow {% % The contents, which is a varwidth environment, has been captured in % \box0 (a \hbox). % We have with \sphinx@cellid an assigned unique id. The goal is to give % about the same height to all the involved rows. % For this Sphinx will insert a \sphinxtablestrut{cell_id} mark-up % in LaTeX file and the expansion of the latter will do the suitable thing. \dimen@\dp\z@ \dimen\tw@\ht\@arstrutbox \advance\dimen@\dimen\tw@ \advance\dimen\tw@\dp\@arstrutbox \count@=\dimen@ % type conversion dim -> int \count\tw@=\dimen\tw@ \divide\count@\count\tw@ % TeX division truncates \advance\dimen@-\count@\dimen\tw@ % 1300sp is about 0.02pt. For comparison a rule default width is 0.4pt. % (note that if \count@ holds 0, surely \dimen@>1300sp) \ifdim\dimen@>1300sp \advance\count@\@ne \fi % now \count@ holds the count L of needed "lines" % and \sphinx@nbofrows holds the number N of rows % we have L >= 1 and N >= 1 % if L is a multiple of N, ... clear what to do ! % else write L = qN + r, 1 <= r < N and we will % arrange for each row to have enough space for: % q+1 "lines" in each of the first r rows % q "lines" in each of the (N-r) bottom rows % for a total of (q+1) * r + q * (N-r) = q * N + r = L % It is possible that q == 0. \count\tw@\count@ % the TeX division truncates \divide\count\tw@\sphinx@nbofrows\relax \count4\count\tw@ % q \multiply\count\tw@\sphinx@nbofrows\relax \advance\count@-\count\tw@ % r \expandafter\xdef\csname sphinx@tablestrut_\sphinx@cellid\endcsname {\noexpand\sphinx@tablestrut{\the\count4}{\the\count@}{\sphinx@cellid}}% \dp\z@\z@ % this will use the real height if it is >\ht\@arstrutbox \sphinxtablestrut{\sphinx@cellid}\box\z@ \endgroup % group was opened in \sphinxmultirow }% \newcommand*\sphinxtablestrut[1]{% % #1 is a "cell_id", i.e. the id of a merged group of table cells \csname sphinx@tablestrut_#1\endcsname }% % LaTeX typesets the table row by row, hence each execution can do % an update for the next row. \newcommand*\sphinx@tablestrut[3]{\begingroup % #1 = q, #2 = (initially) r, #3 = cell_id, q+1 lines in first r rows % if #2 = 0, create space for max(q,1) table lines % if #2 > 0, create space for q+1 lines and decrement #2 \leavevmode \count@#1\relax \ifnum#2=\z@ \ifnum\count@=\z@\count@\@ne\fi \else % next row will be with a #2 decremented by one \expandafter\xdef\csname sphinx@tablestrut_#3\endcsname {\noexpand\sphinx@tablestrut{#1}{\the\numexpr#2-\@ne}{#3}}% \advance\count@\@ne \fi \vrule\@height\ht\@arstrutbox \@depth\dimexpr\count@\ht\@arstrutbox+\count@\dp\@arstrutbox-\ht\@arstrutbox\relax \@width\z@ \endgroup % we need this to avoid colour panels hiding bottom parts of multirow text \sphinx@hack@CT }% \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxmanual.cls0000644000076600000240000001022100000000000021115 0ustar00tkomiyastaff% % sphinxmanual.cls for Sphinx (https://www.sphinx-doc.org/) % \NeedsTeXFormat{LaTeX2e}[1995/12/01] \ProvidesClass{sphinxmanual}[2019/12/01 v2.3.0 Document class (Sphinx manual)] % chapters starting at odd pages (overridden by 'openany' document option) \PassOptionsToClass{openright}{\sphinxdocclass} % 'oneside' option overriding the 'twoside' default \newif\if@oneside \DeclareOption{oneside}{\@onesidetrue} % Pass remaining document options to the parent class. \DeclareOption*{\PassOptionsToClass{\CurrentOption}{\sphinxdocclass}} \ProcessOptions\relax % Defaults two-side document \if@oneside % nothing to do (oneside is the default) \else \PassOptionsToClass{twoside}{\sphinxdocclass} \fi \LoadClass{\sphinxdocclass} % Set some sane defaults for section numbering depth and TOC depth. You can % reset these counters in your preamble. % \setcounter{secnumdepth}{2} \setcounter{tocdepth}{1} % Adapt \and command to the flushright context of \sphinxmaketitle, to % avoid ragged line endings if author names do not fit all on one single line \DeclareRobustCommand{\and}{% \end{tabular}\kern-\tabcolsep \allowbreak \hskip\dimexpr1em+\tabcolsep\@plus.17fil\begin{tabular}[t]{c}% }% % If it is desired that each author name be on its own line, use in preamble: %\DeclareRobustCommand{\and}{% % \end{tabular}\kern-\tabcolsep\\\begin{tabular}[t]{c}% %}% % Change the title page to look a bit better, and fit in with the fncychap % ``Bjarne'' style a bit better. % \newcommand{\sphinxmaketitle}{% \let\sphinxrestorepageanchorsetting\relax \ifHy@pageanchor\def\sphinxrestorepageanchorsetting{\Hy@pageanchortrue}\fi \hypersetup{pageanchor=false}% avoid duplicate destination warnings \begin{titlepage}% \let\footnotesize\small \let\footnoterule\relax \noindent\rule{\textwidth}{1pt}\par \begingroup % for PDF information dictionary \def\endgraf{ }\def\and{\& }% \pdfstringdefDisableCommands{\def\\{, }}% overwrite hyperref setup \hypersetup{pdfauthor={\@author}, pdftitle={\@title}}% \endgroup \begin{flushright}% \sphinxlogo \py@HeaderFamily {\Huge \@title \par} {\itshape\LARGE \py@release\releaseinfo \par} \vfill {\LARGE \begin{tabular}[t]{c} \@author \end{tabular}\kern-\tabcolsep \par} \vfill\vfill {\large \@date \par \vfill \py@authoraddress \par }% \end{flushright}%\par \@thanks \end{titlepage}% \setcounter{footnote}{0}% \let\thanks\relax\let\maketitle\relax %\gdef\@thanks{}\gdef\@author{}\gdef\@title{} \clearpage \ifdefined\sphinxbackoftitlepage\sphinxbackoftitlepage\fi \if@openright\cleardoublepage\else\clearpage\fi \sphinxrestorepageanchorsetting } \newcommand{\sphinxtableofcontents}{% \pagenumbering{roman}% \begingroup \parskip \z@skip \sphinxtableofcontentshook \tableofcontents \endgroup % before resetting page counter, let's do the right thing. \if@openright\cleardoublepage\else\clearpage\fi \pagenumbering{arabic}% } % This is needed to get the width of the section # area wide enough in the % library reference. Doing it here keeps it the same for all the manuals. % \newcommand{\sphinxtableofcontentshook}{% \renewcommand*\l@section{\@dottedtocline{1}{1.5em}{2.6em}}% \renewcommand*\l@subsection{\@dottedtocline{2}{4.1em}{3.5em}}% } % Fix the bibliography environment to add an entry to the Table of % Contents. % For a report document class this environment is a chapter. % \newenvironment{sphinxthebibliography}[1]{% \if@openright\cleardoublepage\else\clearpage\fi % \phantomsection % not needed here since TeXLive 2010's hyperref \begin{thebibliography}{#1}% \addcontentsline{toc}{chapter}{\bibname}}{\end{thebibliography}} % Same for the indices. % The memoir class already does this, so we don't duplicate it in that case. % \@ifclassloaded{memoir} {\newenvironment{sphinxtheindex}{\begin{theindex}}{\end{theindex}}} {\newenvironment{sphinxtheindex}{% \if@openright\cleardoublepage\else\clearpage\fi \phantomsection % needed as no chapter, section, ... created \begin{theindex}% \addcontentsline{toc}{chapter}{\indexname}}{\end{theindex}}} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxoptionsgeometry.sty0000644000076600000240000000401500000000000023151 0ustar00tkomiyastaff%% OPTIONS FOR GEOMETRY % % change this info string if making any custom modification \ProvidesFile{sphinxoptionsgeometry.sty}[2021/01/27 geometry] % geometry \ifx\kanjiskip\@undefined \PassOptionsToPackage{% hmargin={\unexpanded{\spx@opt@hmargin}},% vmargin={\unexpanded{\spx@opt@vmargin}},% marginpar=\unexpanded{\spx@opt@marginpar}} {geometry} \else % set text width for Japanese documents to be integer multiple of 1zw % and text height to be integer multiple of \baselineskip % the execution is delayed to \sphinxsetup then geometry.sty \normalsize\normalfont \newcommand*\sphinxtextwidthja[1]{% \if@twocolumn\tw@\fi \dimexpr \numexpr\dimexpr\paperwidth-\tw@\dimexpr#1\relax\relax/ \dimexpr\if@twocolumn\tw@\else\@ne\fi zw\relax zw\relax}% \newcommand*\sphinxmarginparwidthja[1]{% \dimexpr\numexpr\dimexpr#1\relax/\dimexpr1zw\relax zw\relax}% \newcommand*\sphinxtextlinesja[1]{% \numexpr\@ne+\dimexpr\paperheight-\topskip-\tw@\dimexpr#1\relax\relax/ \baselineskip\relax}% \ifx\@jsc@uplatextrue\@undefined\else % the way we found in order for the papersize special written by % geometry in the dvi file to be correct in case of jsbook class \ifnum\mag=\@m\else % do nothing special if nomag class option or 10pt \PassOptionsToPackage{truedimen}{geometry}% \fi \fi \PassOptionsToPackage{% hmarginratio={1:1},% textwidth=\unexpanded{\sphinxtextwidthja{\spx@opt@hmargin}},% vmarginratio={1:1},% lines=\unexpanded{\sphinxtextlinesja{\spx@opt@vmargin}},% marginpar=\unexpanded{\sphinxmarginparwidthja{\spx@opt@marginpar}},% footskip=2\baselineskip,% }{geometry}% \AtBeginDocument {% update a dimension used by the jsclasses \ifx\@jsc@uplatextrue\@undefined\else\fullwidth\textwidth\fi % for some reason, jreport normalizes all dimensions with \@settopoint \@ifclassloaded{jreport} {\@settopoint\textwidth\@settopoint\textheight\@settopoint\marginparwidth} {}% <-- "false" clause of \@ifclassloaded }% \fi \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxoptionshyperref.sty0000644000076600000240000000210600000000000023141 0ustar00tkomiyastaff%% Bookmarks and hyperlinks % % change this info string if making any custom modification \ProvidesFile{sphinxoptionshyperref.sty}[2021/01/27 hyperref] % to make pdf with correct encoded bookmarks in Japanese % this should precede the hyperref package \ifx\kanjiskip\@undefined % for non-Japanese: make sure bookmarks are ok also with lualatex \PassOptionsToPackage{pdfencoding=unicode}{hyperref} \else \RequirePackage{atbegshi} \ifx\ucs\@undefined \ifnum 42146=\euc"A4A2 \AtBeginShipoutFirst{\special{pdf:tounicode EUC-UCS2}} \else \AtBeginShipoutFirst{\special{pdf:tounicode 90ms-RKSJ-UCS2}} \fi \else \AtBeginShipoutFirst{\special{pdf:tounicode UTF8-UCS2}} \fi \fi \ifx\@jsc@uplatextrue\@undefined\else \PassOptionsToPackage{setpagesize=false}{hyperref} \fi % These options can be overridden inside 'hyperref' key % or by later use of \hypersetup. \PassOptionsToPackage{colorlinks,breaklinks,% linkcolor=InnerLinkColor,filecolor=OuterLinkColor,% menucolor=OuterLinkColor,urlcolor=OuterLinkColor,% citecolor=InnerLinkColor}{hyperref} \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxpackagecyrillic.sty0000644000076600000240000000503600000000000023034 0ustar00tkomiyastaff%% CYRILLIC IN NON-CYRILLIC DOCUMENTS (pdflatex only) % % refs: https://tex.stackexchange.com/q/460271/ \ProvidesPackage{sphinxpackagecyrillic}% [2018/11/21 v2.0 support for Cyrillic in non-Cyrillic documents] \RequirePackage{kvoptions} \SetupKeyvalOptions{prefix=spx@cyropt@} % use \spx@cyropt@ prefix \DeclareBoolOption[false]{Xtwo} \DeclareBoolOption[false]{TtwoA} \DeclareDefaultOption{\@unknownoptionerror} \ProcessLocalKeyvalOptions* % ignore class options \ifspx@cyropt@Xtwo % original code by tex.sx user egreg (updated 2019/10/28): % https://tex.stackexchange.com/a/460325/ % 159 Cyrillic glyphs as available in X2 TeX 8bit font encoding % This assumes inputenc loaded with utf8 option, or LaTeX release % as recent as 2018/04/01 which does it automatically. \@tfor\next:=% {Ё}{Ђ}{Є}{Ѕ}{І}{Ј}{Љ}{Њ}{Ћ}{Ў}{Џ}{А}{Б}{В}{Г}{Д}{Е}{Ж}{З}{И}{Й}% {К}{Л}{М}{Н}{О}{П}{Р}{С}{Т}{У}{Ф}{Х}{Ц}{Ч}{Ш}{Щ}{Ъ}{Ы}{Ь}{Э}{Ю}% {Я}{а}{б}{в}{г}{д}{е}{ж}{з}{и}{й}{к}{л}{м}{н}{о}{п}{р}{с}{т}{у}% {ф}{х}{ц}{ч}{ш}{щ}{ъ}{ы}{ь}{э}{ю}{я}{ё}{ђ}{є}{ѕ}{і}{ј}{љ}{њ}{ћ}% {ў}{џ}{Ѣ}{ѣ}{Ѫ}{ѫ}{Ѵ}{ѵ}{Ґ}{ґ}{Ғ}{ғ}{Ҕ}{ҕ}{Җ}{җ}{Ҙ}{ҙ}{Қ}{қ}{Ҝ}{ҝ}% {Ҟ}{ҟ}{Ҡ}{ҡ}{Ң}{ң}{Ҥ}{ҥ}{Ҧ}{ҧ}{Ҩ}{ҩ}{Ҫ}{ҫ}{Ҭ}{ҭ}{Ү}{ү}{Ұ}{ұ}{Ҳ}{ҳ}% {Ҵ}{ҵ}{Ҷ}{ҷ}{Ҹ}{ҹ}{Һ}{һ}{Ҽ}{ҽ}{Ҿ}{ҿ}{Ӏ}{Ӄ}{ӄ}{Ӆ}{ӆ}{Ӈ}{ӈ}{Ӌ}{ӌ}% {Ӎ}{ӎ}{Ӕ}{ӕ}{Ә}{ә}{Ӡ}{ӡ}{Ө}{ө}\do {% \begingroup\def\IeC{\protect\DeclareTextSymbolDefault}% \protected@edef\@temp{\endgroup \@ifl@t@r{\fmtversion}{2019/10/01}{\csname u8:\next\endcsname}{\next}}% \@temp{X2}% }% \else \ifspx@cyropt@TtwoA % original code by tex.sx user jfbu: % https://tex.stackexchange.com/a/460305/ % 63*2+1=127 Cyrillic glyphs as found in T2A 8bit TeX font-encoding \@tfor\@tempa:=% {ae}{a}{b}{chrdsc}{chvcrs}{ch}{c}{dje}{dze}{dzhe}{d}{erev}{ery}{e}% {f}{ghcrs}{gup}{g}{hdsc}{hrdsn}{h}{ie}{ii}{ishrt}{i}{je}% {kbeak}{kdsc}{kvcrs}{k}{lje}{l}{m}{ndsc}{ng}{nje}{n}{otld}{o}{p}{r}% {schwa}{sdsc}{sftsn}{shch}{shha}{sh}{s}{tshe}{t}{ushrt}{u}{v}% {ya}{yhcrs}{yi}{yo}{yu}{y}{zdsc}{zhdsc}{zh}{z}\do {% \expandafter\DeclareTextSymbolDefault\expandafter {\csname cyr\@tempa\endcsname}{T2A}% \expandafter\uppercase\expandafter{\expandafter \def\expandafter\@tempa\expandafter{\@tempa}}% \expandafter\DeclareTextSymbolDefault\expandafter {\csname CYR\@tempa\endcsname}{T2A}% }% \DeclareTextSymbolDefault{\CYRpalochka}{T2A}% \fi\fi \endinput ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs/sphinxpackagefootnote.sty0000644000076600000240000003170000000000000023054 0ustar00tkomiyastaff\NeedsTeXFormat{LaTeX2e} \ProvidesPackage{sphinxpackagefootnote}% [2021/02/04 v1.1d footnotehyper adapted to sphinx (Sphinx team)] % Provides support for this output mark-up from Sphinx latex writer: % - footnote environment % - savenotes environment (table templates) % - \sphinxfootnotemark % %% %% Package: sphinxpackagefootnote %% Version: based on footnotehyper.sty 2021/02/04 v1.1d %% as available at https://www.ctan.org/pkg/footnotehyper %% License: the one applying to Sphinx %% %% Refer to the PDF documentation at https://www.ctan.org/pkg/footnotehyper for %% the code comments. %% %% Differences: %% 1. a partial tabulary compatibility layer added (enough for Sphinx mark-up), %% 2. use of \spx@opt@BeforeFootnote from sphinx.sty, %% 3. use of \sphinxunactivateextrasandspace from sphinx.sty, %% 4. macro definition \sphinxfootnotemark, %% 5. macro definition \sphinxlongtablepatch %% 6. replaced some \undefined by \@undefined \newif\iffootnotehyperparse\footnotehyperparsetrue \DeclareOption*{\PackageWarning{sphinxpackagefootnote}{Option `\CurrentOption' is unknown}}% \ProcessOptions\relax \newbox\FNH@notes \newtoks\FNH@toks % 1.1c \newdimen\FNH@width \let\FNH@colwidth\columnwidth \newif\ifFNH@savingnotes \AtBeginDocument {% \let\FNH@latex@footnote \footnote \let\FNH@latex@footnotetext\footnotetext \let\FNH@H@@footnotetext \@footnotetext \let\FNH@H@@mpfootnotetext \@mpfootnotetext \newenvironment{savenotes} {\FNH@savenotes\ignorespaces}{\FNH@spewnotes\ignorespacesafterend}% \let\spewnotes \FNH@spewnotes \let\footnote \FNH@footnote \let\footnotetext \FNH@footnotetext \let\endfootnote \FNH@endfntext \let\endfootnotetext\FNH@endfntext \@ifpackageloaded{hyperref} {\ifHy@hyperfootnotes \let\FNH@H@@footnotetext\H@@footnotetext \let\FNH@H@@mpfootnotetext\H@@mpfootnotetext \else \let\FNH@hyper@fntext\FNH@nohyp@fntext \fi}% {\let\FNH@hyper@fntext\FNH@nohyp@fntext}% }% \def\FNH@hyper@fntext{\FNH@fntext\FNH@hyper@fntext@i}% \def\FNH@nohyp@fntext{\FNH@fntext\FNH@nohyp@fntext@i}% \def\FNH@fntext #1{% \ifx\ifmeasuring@\@undefined \expandafter\@secondoftwo\else\expandafter\@firstofone\fi % these two lines modified for Sphinx (tabulary compatibility): {\ifmeasuring@\expandafter\@gobbletwo\else\expandafter\@firstofone\fi}% {\ifx\equation$\expandafter\@gobbletwo\fi #1}%$ }% \long\def\FNH@hyper@fntext@i#1{% \global\setbox\FNH@notes\vbox {\unvbox\FNH@notes \FNH@startnote \@makefntext {\rule\z@\footnotesep\ignorespaces \ifHy@nesting\expandafter\ltx@firstoftwo \else\expandafter\ltx@secondoftwo \fi {\expandafter\hyper@@anchor\expandafter{\Hy@footnote@currentHref}{#1}}% {\Hy@raisedlink {\expandafter\hyper@@anchor\expandafter{\Hy@footnote@currentHref}% {\relax}}% \let\@currentHref\Hy@footnote@currentHref \let\@currentlabelname\@empty #1}% \@finalstrut\strutbox }% \FNH@endnote }% }% \long\def\FNH@nohyp@fntext@i#1{% \global\setbox\FNH@notes\vbox {\unvbox\FNH@notes \FNH@startnote \@makefntext{\rule\z@\footnotesep\ignorespaces#1\@finalstrut\strutbox}% \FNH@endnote }% }% \def\FNH@startnote{% \hsize\FNH@colwidth \interlinepenalty\interfootnotelinepenalty \reset@font\footnotesize \floatingpenalty\@MM \@parboxrestore \protected@edef\@currentlabel{\csname p@\@mpfn\endcsname\@thefnmark}% \color@begingroup }% \def\FNH@endnote{\color@endgroup}% \def\FNH@savenotes{% \begingroup \ifFNH@savingnotes\else \FNH@savingnotestrue \let\@footnotetext \FNH@hyper@fntext \let\@mpfootnotetext \FNH@hyper@fntext \let\H@@mpfootnotetext\FNH@nohyp@fntext \FNH@width\columnwidth \let\FNH@colwidth\FNH@width \global\setbox\FNH@notes\box\voidb@x \let\FNH@thempfn\thempfn \let\FNH@mpfn\@mpfn \ifx\@minipagerestore\relax\let\@minipagerestore\@empty\fi \expandafter\def\expandafter\@minipagerestore\expandafter{% \@minipagerestore \let\thempfn\FNH@thempfn \let\@mpfn\FNH@mpfn }% \fi }% \def\FNH@spewnotes {% \if@endpe\ifx\par\@@par\FNH@toks{}\else \FNH@toks\expandafter{\expandafter \def\expandafter\par\expandafter{\par}\@endpetrue}% \expandafter\expandafter\expandafter \FNH@toks \expandafter\expandafter\expandafter {\expandafter\the\expandafter\FNH@toks \expandafter\def\expandafter\@par\expandafter{\@par}}% \expandafter\expandafter\expandafter \FNH@toks \expandafter\expandafter\expandafter {\expandafter\the\expandafter\FNH@toks \expandafter\everypar\expandafter{\the\everypar}}\fi \else\FNH@toks{}\fi \expandafter \endgroup\the\FNH@toks \ifFNH@savingnotes\else \ifvoid\FNH@notes\else \begingroup \let\@makefntext\@empty \let\@finalstrut\@gobble \let\rule\@gobbletwo \ifx\@footnotetext\@mpfootnotetext \expandafter\FNH@H@@mpfootnotetext \else \expandafter\FNH@H@@footnotetext \fi{\unvbox\FNH@notes}% \endgroup \fi \fi }% \def\FNH@footnote@envname {footnote}% \def\FNH@footnotetext@envname{footnotetext}% \def\FNH@footnote{% % this line added for Sphinx: \spx@opt@BeforeFootnote \ifx\@currenvir\FNH@footnote@envname \expandafter\FNH@footnoteenv \else \expandafter\FNH@latex@footnote \fi }% \def\FNH@footnoteenv{% % this line added for Sphinx (footnotes in parsed literal blocks): \catcode13=5 \sphinxunactivateextrasandspace \@ifnextchar[% \FNH@footnoteenv@i %] {\stepcounter\@mpfn \protected@xdef\@thefnmark{\thempfn}% \@footnotemark \def\FNH@endfntext@fntext{\@footnotetext}% \FNH@startfntext}% }% \def\FNH@footnoteenv@i[#1]{% \begingroup \csname c@\@mpfn\endcsname #1\relax \unrestored@protected@xdef\@thefnmark{\thempfn}% \endgroup \@footnotemark \def\FNH@endfntext@fntext{\@footnotetext}% \FNH@startfntext }% \def\FNH@footnotetext{% \ifx\@currenvir\FNH@footnotetext@envname \expandafter\FNH@footnotetextenv \else \expandafter\FNH@latex@footnotetext \fi }% \def\FNH@footnotetextenv{% \@ifnextchar[% \FNH@footnotetextenv@i %] {\protected@xdef\@thefnmark{\thempfn}% \def\FNH@endfntext@fntext{\@footnotetext}% \FNH@startfntext}% }% \def\FNH@footnotetextenv@i[#1]{% \begingroup \csname c@\@mpfn\endcsname #1\relax \unrestored@protected@xdef\@thefnmark{\thempfn}% \endgroup \ifFNH@savingnotes \def\FNH@endfntext@fntext{\FNH@nohyp@fntext}% \else \def\FNH@endfntext@fntext{\FNH@H@@footnotetext}% \fi \FNH@startfntext }% \def\FNH@startfntext{% \setbox\z@\vbox\bgroup \FNH@startnote \FNH@prefntext \rule\z@\footnotesep\ignorespaces }% \def\FNH@endfntext {% \@finalstrut\strutbox \FNH@postfntext \FNH@endnote \egroup \begingroup \let\@makefntext\@empty\let\@finalstrut\@gobble\let\rule\@gobbletwo \FNH@endfntext@fntext {\unvbox\z@}% \endgroup }% \let\FNH@prefntext\@empty \let\FNH@postfntext\@empty \AtBeginDocument{\iffootnotehyperparse\expandafter\FNH@check\fi}% \def\FNH@safeif#1{% \iftrue\csname if#1\endcsname\csname fi\endcsname\expandafter\@firstoftwo \else\csname fi\endcsname\expandafter\@secondoftwo \fi }% \def\FNH@check{% \ifx\@makefntextFB\@undefined\expandafter\FNH@check@ \else\expandafter\FNH@frenchb@ \fi }% \def\FNH@frenchb@{% \def\FNH@prefntext{% \localleftbox{}% \let\FBeverypar@save\FBeverypar@quote \let\FBeverypar@quote\relax \FNH@safeif{FB@koma}% {\FNH@safeif{FBFrenchFootnotes}% {\ifx\footnote\thanks \let\@@makefnmark\@@makefnmarkTH \@makefntextTH{} % space as in french.ldf \else \let\@@makefnmark\@@makefnmarkFB \@makefntextFB{} % space as in french.ldf \fi }{\let\@@makefnmark\@@makefnmarkORI \@makefntextORI{}% no space as in french.ldf }% }% {\FNH@safeif{FBFrenchFootnotes}% {\@makefntextFB{}}% {\@makefntextORI{}}% }% }% \def\FNH@postfntext{% \let\FBeverypar@quote\FBeverypar@save \localleftbox{\FBeveryline@quote}% }% }% \def\FNH@check@{% \expandafter\FNH@check@a\@makefntext{1.2!3?4,}% \FNH@@@1.2!3?4,\FNH@@@\relax }% \long\def\FNH@check@a #11.2!3?4,#2\FNH@@@#3{% \ifx\relax#3\expandafter\FNH@checkagain@ \else \def\FNH@prefntext{#1}\def\FNH@postfntext{#2}% \expandafter\FNH@check@b \fi }% \def\FNH@checkagain@{% \expandafter\FNH@checkagain@a \detokenize\expandafter{\@makefntext{1.2!3?4,}}\relax\FNH@@@ }% \edef\FNH@temp{\noexpand\FNH@checkagain@a ##1\string{1.2!3?4,\string}}% \expandafter\def\FNH@temp#2#3\FNH@@@{% \ifx\relax#2% \def\FNH@prefntext{\@makefntext{}}% \else\FNH@bad@makefntext@alert \fi }% \def\FNH@check@b #1\relax{% \expandafter\expandafter\expandafter\FNH@check@c \expandafter\meaning\expandafter\FNH@prefntext \meaning\FNH@postfntext1.2!3?4,\FNH@check@c\relax }% \def\FNH@check@c #11.2!3?4,#2#3\relax{% \ifx\FNH@check@c#2\else\FNH@bad@makefntext@alert\fi }% % slight reformulation for Sphinx \def\FNH@bad@makefntext@alert{% \PackageWarningNoLine{sphinxpackagefootnote}% {Footnotes will be sub-optimal, sorry. This is due to the document class or^^J some package modifying macro \string\@makefntext.^^J You can try to report this incompatibility at^^J https://github.com/sphinx-doc/sphinx with this info:}% \typeout{\meaning\@makefntext}% \let\FNH@prefntext\@empty\let\FNH@postfntext\@empty }% % this macro from original footnote.sty is not used anymore by Sphinx % but for simplicity sake let's just keep it as is \def\makesavenoteenv{\@ifnextchar[\FNH@msne@ii\FNH@msne@i}%] \def\FNH@msne@i #1{% \expandafter\let\csname FNH$#1\expandafter\endcsname %$ \csname #1\endcsname \expandafter\let\csname endFNH$#1\expandafter\endcsname %$ \csname end#1\endcsname \FNH@msne@ii[#1]{FNH$#1}%$ }% \def\FNH@msne@ii[#1]#2{% \expandafter\edef\csname#1\endcsname{% \noexpand\savenotes \expandafter\noexpand\csname#2\endcsname }% \expandafter\edef\csname end#1\endcsname{% \expandafter\noexpand\csname end#2\endcsname \noexpand\expandafter \noexpand\spewnotes \noexpand\if@endpe\noexpand\@endpetrue\noexpand\fi }% }% % % some extras for Sphinx : % \sphinxfootnotemark: usable in section titles and silently removed from TOCs. \def\sphinxfootnotemark [#1]% {\ifx\thepage\relax\else\sphinxfootref{#1}\fi}% % \sphinxfootref: % - \spx@opt@BeforeFootnote is from BeforeFootnote sphinxsetup option % - \ref: % the latex.py writer inserts a \phantomsection\label{.} % whenever % - the footnote was explicitly numbered in sources, % - or it was in restrained context and is rendered using footnotetext % % These are the two types of footnotes that \sphinxfootnotemark must % handle. But for explicitly numbered footnotes the same number % can be found in document. So a secondary part in is updated % at each novel such footnote to know what is the target from then on % for \sphinxfootnotemark and already encountered [1], or [2],... % % LaTeX package varioref is not supported by hyperref (from its doc: "There % are too many problems with varioref. Nobody has time to sort them out. % Therefore this package is now unsupported.") So we will simply use our own % macros to access the page number of footnote text and decide whether to print % it. \pagename is internationalized by latex-babel. \def\spx@thefnmark#1#2{% % #1=label for reference, #2=page where footnote was printed \ifx\spx@tempa\spx@tempb % same page #1% \else \sphinxthefootnotemark{#1}{#2}% \fi }% \def\sphinxfootref@get #1#2#3#4#5\relax{% \def\sphinxfootref@label{#1}% \def\sphinxfootref@page {#2}% \def\sphinxfootref@Href {#4}% }% \protected\def\sphinxfootref#1{% #1 always explicit number in Sphinx usage \spx@opt@BeforeFootnote \ltx@ifundefined{r@\thesphinxscope.#1}% {\gdef\@thefnmark{?}\H@@footnotemark}% {\expandafter\expandafter\expandafter\sphinxfootref@get \csname r@\thesphinxscope.#1\endcsname\relax \edef\spx@tempa{\thepage}\edef\spx@tempb{\sphinxfootref@page}% \protected@xdef\@thefnmark{\spx@thefnmark{\sphinxfootref@label}{\sphinxfootref@page}}% \let\spx@@makefnmark\@makefnmark \def\@makefnmark{% \hyper@linkstart{link}{\sphinxfootref@Href}% \spx@@makefnmark \hyper@linkend }% \H@@footnotemark \let\@makefnmark\spx@@makefnmark }% }% \AtBeginDocument{% % let hyperref less complain \pdfstringdefDisableCommands{\def\sphinxfootnotemark [#1]{}}% % to obtain hyperlinked footnotes in longtable environment we must replace % hyperref's patch of longtable's patch of \@footnotetext by our own \let\LT@p@ftntext\FNH@hyper@fntext % this *requires* longtable to be used always wrapped in savenotes environment }% \endinput %% %% End of file `sphinxpackagefootnote.sty'. ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.5445874 Sphinx-4.3.2/sphinx/texinputs_win/0000755000076600000240000000000000000000000016564 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/texinputs_win/Makefile_t0000644000076600000240000000470700000000000020557 0ustar00tkomiyastaff# Makefile for Sphinx LaTeX output ALLDOCS = $(basename $(wildcard *.tex)) ALLPDF = $(addsuffix .pdf,$(ALLDOCS)) ALLDVI = $(addsuffix .dvi,$(ALLDOCS)) ALLPS = $(addsuffix .ps,$(ALLDOCS)) # Prefix for archive names ARCHIVEPREFIX = # Additional LaTeX options LATEXOPTS = # format: pdf or dvi FMT = pdf LATEX = latex PDFLATEX = {{ latex_engine }} MAKEINDEX = makeindex {% if latex_engine in ('platex', 'uplatex') -%} all: all-pdf-ja all-pdf: all-pdf-ja {% else %} all: $(ALLPDF) all-pdf: $(ALLPDF) {% endif -%} all-dvi: $(ALLDVI) all-ps: $(ALLPS) all-pdf-ja: for f in *.pdf *.png *.gif *.jpg *.jpeg; do extractbb $$f; done for f in *.tex; do {{ latex_engine }} -kanji=utf8 $(LATEXOPTS) $$f; done for f in *.tex; do {{ latex_engine }} -kanji=utf8 $(LATEXOPTS) $$f; done for f in *.tex; do {{ latex_engine }} -kanji=utf8 $(LATEXOPTS) $$f; done -for f in *.idx; do mendex -U -f -d "`basename $$f .idx`.dic" -s python.ist $$f; done for f in *.tex; do {{ latex_engine }} -kanji=utf8 $(LATEXOPTS) $$f; done for f in *.tex; do {{ latex_engine }} -kanji=utf8 $(LATEXOPTS) $$f; done for f in *.dvi; do dvipdfmx $$f; done zip: all-$(FMT) mkdir $(ARCHIVEPREFIX)docs-$(FMT) cp $(ALLPDF) $(ARCHIVEPREFIX)docs-$(FMT) zip -q -r -9 $(ARCHIVEPREFIX)docs-$(FMT).zip $(ARCHIVEPREFIX)docs-$(FMT) rm -r $(ARCHIVEPREFIX)docs-$(FMT) tar: all-$(FMT) mkdir $(ARCHIVEPREFIX)docs-$(FMT) cp $(ALLPDF) $(ARCHIVEPREFIX)docs-$(FMT) tar cf $(ARCHIVEPREFIX)docs-$(FMT).tar $(ARCHIVEPREFIX)docs-$(FMT) rm -r $(ARCHIVEPREFIX)docs-$(FMT) gz: tar gzip -9 < $(ARCHIVEPREFIX)docs-$(FMT).tar > $(ARCHIVEPREFIX)docs-$(FMT).tar.gz bz2: tar bzip2 -9 -k $(ARCHIVEPREFIX)docs-$(FMT).tar xz: tar xz -9 -k $(ARCHIVEPREFIX)docs-$(FMT).tar # The number of LaTeX runs is quite conservative, but I don't expect it # to get run often, so the little extra time won't hurt. %.dvi: %.tex $(LATEX) $(LATEXOPTS) '$<' $(LATEX) $(LATEXOPTS) '$<' $(LATEX) $(LATEXOPTS) '$<' -$(MAKEINDEX) -s python.ist '$(basename $<).idx' $(LATEX) $(LATEXOPTS) '$<' $(LATEX) $(LATEXOPTS) '$<' %.pdf: %.tex $(PDFLATEX) $(LATEXOPTS) '$<' $(PDFLATEX) $(LATEXOPTS) '$<' $(PDFLATEX) $(LATEXOPTS) '$<' -$(MAKEINDEX) -s python.ist '$(basename $<).idx' $(PDFLATEX) $(LATEXOPTS) '$<' $(PDFLATEX) $(LATEXOPTS) '$<' %.ps: %.dvi dvips '$<' clean: rm -f *.log *.ind *.aux *.toc *.syn *.idx *.out *.ilg *.pla *.ps *.tar *.tar.gz *.tar.bz2 *.tar.xz $(ALLPDF) $(ALLDVI) .PHONY: all all-pdf all-dvi all-ps clean zip tar gz bz2 xz .PHONY: all-pdf-ja ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.3387053 Sphinx-4.3.2/sphinx/themes/0000755000076600000240000000000000000000000015131 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.5450082 Sphinx-4.3.2/sphinx/themes/agogo/0000755000076600000240000000000000000000000016225 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/themes/agogo/layout.html0000644000076600000240000000634700000000000020442 0ustar00tkomiyastaff{# agogo/layout.html ~~~~~~~~~~~~~~~~~ Sphinx layout template for the agogo theme, originally written by Andi Albrecht. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. #} {%- extends "basic/layout.html" %} {% block header %} {% endblock %} {%- macro agogo_sidebar() %} {%- block sidebartoc %}

    {{ _('Table of Contents') }}

    {{ toctree() }} {%- endblock %} {%- block sidebarsearch %}

    {{ _('Search') }}

    {%- endblock %} {% endmacro %} {% block content %}
    {%- if not theme_rightsidebar|tobool %}
    {{ agogo_sidebar() }}
    {%- endif %}
    {%- block document %} {{ super() }} {%- endblock %}
    {%- if theme_rightsidebar|tobool %}
    {{ agogo_sidebar() }}
    {%- endif %}
    {% endblock %} {% block footer %}
    {%- for rellink in rellinks|reverse %} {{ rellink[3] }} {%- if not loop.last %}{{ reldelim2 }}{% endif %} {%- endfor %}
    {%- if show_source and has_source and sourcename %}
    {{ _('Show Source') }} {%- endif %}
    {{ super() }}
    {% endblock %} {% block relbar1 %}{% endblock %} {% block relbar2 %}{% endblock %} ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.5456464 Sphinx-4.3.2/sphinx/themes/agogo/static/0000755000076600000240000000000000000000000017514 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/themes/agogo/static/agogo.css_t0000644000076600000240000002106400000000000021650 0ustar00tkomiyastaff/* * agogo.css_t * ~~~~~~~~~~~ * * Sphinx stylesheet -- agogo theme. * * :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. * :license: BSD, see LICENSE for details. * */ * { margin: 0px; padding: 0px; } body { font-family: {{ theme_bodyfont }}; line-height: 1.4em; color: black; background-color: {{ theme_bgcolor }}; } /* Page layout */ div.header, div.content, div.footer { width: {{ theme_pagewidth }}; margin-left: auto; margin-right: auto; } div.header-wrapper { background: {{ theme_headerbg }}; border-bottom: 3px solid #2e3436; } /* Default body styles */ a { color: {{ theme_linkcolor }}; } div.bodywrapper a, div.footer a { text-decoration: underline; } .clearer { clear: both; } .left { float: left; } .right { float: right; } .line-block { display: block; margin-top: 1em; margin-bottom: 1em; } .line-block .line-block { margin-top: 0; margin-bottom: 0; margin-left: 1.5em; } h1, h2, h3, h4 { font-family: {{ theme_headerfont }}; font-weight: normal; color: {{ theme_headercolor2 }}; margin-bottom: .8em; } h1 { color: {{ theme_headercolor1 }}; } h2 { padding-bottom: .5em; border-bottom: 1px solid {{ theme_headercolor2 }}; } a.headerlink { visibility: hidden; color: #dddddd; padding-left: .3em; } h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, h4:hover > a.headerlink, h5:hover > a.headerlink, h6:hover > a.headerlink, dt:hover > a.headerlink, caption:hover > a.headerlink, p.caption:hover > a.headerlink, div.code-block-caption:hover > a.headerlink { visibility: visible; } img { border: 0; } div.admonition { margin-top: 10px; margin-bottom: 10px; padding: 2px 7px 1px 7px; border-left: 0.2em solid black; } p.admonition-title { margin: 0px 10px 5px 0px; font-weight: bold; } dt:target, .highlighted { background-color: #fbe54e; } /* Header */ div.header { padding-top: 10px; padding-bottom: 10px; } div.header .headertitle { font-family: {{ theme_headerfont }}; font-weight: normal; font-size: 180%; letter-spacing: .08em; margin-bottom: .8em; } div.header .headertitle a { color: white; } div.header div.rel { margin-top: 1em; } div.header div.rel a { color: {{ theme_headerlinkcolor }}; letter-spacing: .1em; text-transform: uppercase; } p.logo { float: right; } img.logo { border: 0; } /* Content */ div.content-wrapper { background-color: white; padding-top: 20px; padding-bottom: 20px; } div.document { width: {{ theme_documentwidth }}; float: left; } div.body { {%- if theme_rightsidebar|tobool %} padding-right: 2em; {%- else %} padding-left: 2em; {% endif %} text-align: {{ theme_textalign }}; } div.document h1 { line-height: 120%; } div.document ul { margin: 1.5em; list-style-type: square; } div.document dd { margin-left: 1.2em; margin-top: .4em; margin-bottom: 1em; } div.document .section { margin-top: 1.7em; } div.document .section:first-child { margin-top: 0px; } div.document div.highlight { padding: 3px; border-top: 2px solid #dddddd; border-bottom: 2px solid #dddddd; margin-top: .8em; margin-bottom: .8em; } div.document div.literal-block-wrapper { margin-top: .8em; margin-bottom: .8em; } div.document div.literal-block-wrapper div.highlight { margin: 0; } div.document div.code-block-caption span.caption-number { padding: 0.1em 0.3em; font-style: italic; } div.document div.code-block-caption span.caption-text { } div.document h2 { margin-top: .7em; } div.document p { margin-bottom: .5em; } div.document li.toctree-l1 { margin-bottom: 1em; } div.document .descname { font-weight: bold; } div.document .sig-paren { font-size: larger; } div.document .docutils.literal { background-color: #eeeeec; padding: 1px; } div.document .docutils.xref.literal { background-color: transparent; padding: 0px; } div.document blockquote { margin: 1em; } div.document ol { margin: 1.5em; } /* Sidebar */ div.sidebar { width: {{ theme_sidebarwidth|todim }}; {%- if theme_rightsidebar|tobool %} float: right; {%- else %} float: left; {%- endif %} font-size: .9em; } div.sidebar a, div.header a { text-decoration: none; } div.sidebar a:hover, div.header a:hover { text-decoration: underline; } div.sidebar h3 { color: #2e3436; text-transform: uppercase; font-size: 130%; letter-spacing: .1em; } div.sidebar ul { list-style-type: none; } div.sidebar li.toctree-l1 a { display: block; padding: 1px; border: 1px solid #dddddd; background-color: #eeeeec; margin-bottom: .4em; padding-left: 3px; color: #2e3436; } div.sidebar li.toctree-l2 a { background-color: transparent; border: none; margin-left: 1em; border-bottom: 1px solid #dddddd; } div.sidebar li.toctree-l3 a { background-color: transparent; border: none; margin-left: 2em; border-bottom: 1px solid #dddddd; } div.sidebar li.toctree-l2:last-child a { border-bottom: none; } div.sidebar li.toctree-l1.current a { border-right: 5px solid {{ theme_headerlinkcolor }}; } div.sidebar li.toctree-l1.current li.toctree-l2 a { border-right: none; } div.sidebar input[type="text"] { width: 170px; } div.sidebar input[type="submit"] { width: 30px; } /* Footer */ div.footer-wrapper { background: {{ theme_footerbg }}; border-top: 4px solid #babdb6; padding-top: 10px; padding-bottom: 10px; min-height: 80px; } div.footer, div.footer a { color: #888a85; } div.footer .right { text-align: right; } div.footer .left { text-transform: uppercase; } /* Styles copied from basic theme */ img.align-left, figure.align-left, .figure.align-left, object.align-left { clear: left; float: left; margin-right: 1em; } img.align-right, figure.align-right, .figure.align-right, object.align-right { clear: right; float: right; margin-left: 1em; } img.align-center, figure.align-center, .figure.align-center, object.align-center { display: block; margin-left: auto; margin-right: auto; } img.align-default, figure.align-default, .figure.align-default { display: block; margin-left: auto; margin-right: auto; } .align-left { text-align: left; } .align-center { text-align: center; } .align-right { text-align: right; } table caption span.caption-number { font-style: italic; } table caption span.caption-text { } div.figure p.caption span.caption-number, figcaption span.caption-number { font-style: italic; } div.figure p.caption span.caption-text, figcaption span.caption-text { } /* -- search page ----------------------------------------------------------- */ ul.search { margin: 10px 0 0 20px; padding: 0; } ul.search li { padding: 5px 0 5px 20px; background-image: url(file.png); background-repeat: no-repeat; background-position: 0 7px; } ul.search li a { font-weight: bold; } ul.search li div.context { color: #888; margin: 2px 0 0 30px; text-align: left; } ul.keywordmatches li.goodmatch a { font-weight: bold; } /* -- index page ------------------------------------------------------------ */ table.contentstable { width: 90%; } table.contentstable p.biglink { line-height: 150%; } a.biglink { font-size: 1.3em; } span.linkdescr { font-style: italic; padding-top: 5px; font-size: 90%; } /* -- general index --------------------------------------------------------- */ table.indextable td { text-align: left; vertical-align: top; } table.indextable ul { margin-top: 0; margin-bottom: 0; list-style-type: none; } table.indextable > tbody > tr > td > ul { padding-left: 0em; } table.indextable tr.pcap { height: 10px; } table.indextable tr.cap { margin-top: 10px; background-color: #f2f2f2; } img.toggler { margin-right: 3px; margin-top: 3px; cursor: pointer; } /* -- domain module index --------------------------------------------------- */ table.modindextable td { padding: 2px; border-collapse: collapse; } /* -- viewcode extension ---------------------------------------------------- */ .viewcode-link { float: right; } .viewcode-back { float: right; font-family:: {{ theme_bodyfont }}; } div.viewcode-block:target { margin: -1px -3px; padding: 0 3px; background-color: #f4debf; border-top: 1px solid #ac9; border-bottom: 1px solid #ac9; } div.code-block-caption { background-color: #ddd; color: #333; padding: 2px 5px; font-size: small; } /* -- math display ---------------------------------------------------------- */ div.body div.math p { text-align: center; } span.eqno { float: right; } ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/sphinx/themes/agogo/static/bgfooter.png0000644000076600000240000000042400000000000022031 0ustar00tkomiyastaffPNG  IHDRPSPXIDATx]ч K^t(4ҕټ';WoTT;*Sr<Me;ʨS84؜=LJwuh0.XH{.ϱ49 r-/jxsF'm%t>>;A5K8S>m9sh"L\/ߴ^w^ڶ5eѕ*ʈ}*>m V1$KE |v>:y.9G^GI.ArIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/sphinx/themes/agogo/static/bgtop.png0000644000076600000240000000041200000000000021332 0ustar00tkomiyastaffPNG  IHDRPSPXIDATx] 0 E;^GC~Xܨړ\Jcl!$3ӘXTʌZ9`%onll11KBleQjLQ9 0+ Iаr-2i6  us)zjԙG:vu1Y82ؼ\Q(6(36M}o$F(:rlzR "6IENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637163740.0 Sphinx-4.3.2/sphinx/themes/agogo/theme.conf0000644000076600000240000000073500000000000020203 0ustar00tkomiyastaff[theme] inherit = basic stylesheet = agogo.css pygments_style = tango [options] bodyfont = "Verdana", Arial, sans-serif headerfont = "Georgia", "Times New Roman", serif pagewidth = 70em documentwidth = 50em rightsidebar = true sidebarwidth = 20em bgcolor = #eeeeec headerbg = #555573 url(bgtop.png) top left repeat-x footerbg = url(bgfooter.png) top left repeat-x linkcolor = #ce5c00 headercolor1 = #204a87 headercolor2 = #3465a4 headerlinkcolor = #fcaf3e textalign = justify ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.5487285 Sphinx-4.3.2/sphinx/themes/basic/0000755000076600000240000000000000000000000016212 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1639903107.549358 Sphinx-4.3.2/sphinx/themes/basic/changes/0000755000076600000240000000000000000000000017622 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/sphinx/themes/basic/changes/frameset.html0000644000076600000240000000072200000000000022317 0ustar00tkomiyastaff {% trans version=version|e, docstitle=docstitle|e %}Changes in Version {{ version }} — {{ docstitle }}{% endtrans %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/sphinx/themes/basic/changes/rstsource.html0000644000076600000240000000074500000000000022547 0ustar00tkomiyastaff {% trans filename=filename, docstitle=docstitle|e %}{{ filename }} — {{ docstitle }}{% endtrans %} 
          {{ text }}
    ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/sphinx/themes/basic/changes/versionchanges.html0000644000076600000240000000243200000000000023527 0ustar00tkomiyastaff{% macro entries(changes) %}
      {% for entry, docname, lineno in changes %}
    • {{ entry }}
      • {% endfor %}
    {% endmacro -%} {% trans version=version|e, docstitle=docstitle|e %}Changes in Version {{ version }} — {{ docstitle }}{% endtrans %}

    {% trans version=version|e %}Automatically generated list of changes in version {{ version }}{% endtrans %}

    {{ _('Library changes') }}

    {% for modname, changes in libchanges %}

    {{ modname }}

    {{ entries(changes) }} {% endfor %}

    {{ _('C API changes') }}

    {{ entries(apichanges) }}

    {{ _('Other changes') }}

    {% for (fn, title), changes in otherchanges %}

    {{ title }} ({{ fn }})

    {{ entries(changes) }} {% endfor %}
    ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/themes/basic/defindex.html0000644000076600000240000000314400000000000020670 0ustar00tkomiyastaff{# basic/defindex.html ~~~~~~~~~~~~~~~~~~~ Default template for the "index" page. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. #}{{ warn('Now base template defindex.html is deprecated.') }} {%- extends "layout.html" %} {% set title = _('Overview') %} {% block body %}

    {{ docstitle|e }}

    {{ _('Welcome! This is') }} {% block description %}{{ _('the documentation for') }} {{ project|e }} {{ release|e }}{% if last_updated %}, {{ _('last updated') }} {{ last_updated|e }}{% endif %}{% endblock %}.

    {% block tables %}

    {{ _('Indices and tables:') }}

    {{ _('Complete Table of Contents') }}
    {{ _('lists all sections and subsections') }}

    {{ _('Search Page') }}
    {{ _('search this documentation') }}

    {{ _('Global Module Index') }}
    {{ _('quick access to all modules') }}

    {{ _('General Index') }}
    {{ _('all functions, classes, terms') }}

    {% endblock %} {% endblock %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/themes/basic/domainindex.html0000644000076600000240000000354400000000000021405 0ustar00tkomiyastaff{# basic/domainindex.html ~~~~~~~~~~~~~~~~~~~~~~ Template for domain indices (module index, ...). :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. #} {%- extends "layout.html" %} {% set title = indextitle %} {% block extrahead %} {{ super() }} {% if not embedded and collapse_index %} {% endif %} {% endblock %} {% block body %} {%- set groupid = idgen() %}

    {{ indextitle }}

    {%- for (letter, entries) in content %} {{ letter }} {%- if not loop.last %} | {% endif %} {%- endfor %}
    {%- for letter, entries in content %} {%- for (name, grouptype, page, anchor, extra, qualifier, description) in entries %} {%- endfor %} {%- endfor %}
     
    {{ letter }}
    {% if grouptype == 1 -%} {%- endif %} {% if grouptype == 2 %}   {% endif %} {% if page %}{% endif -%} {{ name|e }} {%- if page %}{% endif %} {%- if extra %} ({{ extra|e }}){% endif -%} {% if qualifier %}{{ qualifier|e }}:{% endif %} {{ description|e }}
    {% endblock %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/themes/basic/genindex-single.html0000644000076600000240000000341400000000000022162 0ustar00tkomiyastaff{# basic/genindex-single.html ~~~~~~~~~~~~~~~~~~~~~~~~~~ Template for a "single" page of a split index. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. #} {% macro indexentries(firstname, links) %} {%- if links -%} {%- if links[0][0] %}{% endif -%} {{ firstname|e }} {%- if links[0][0] %}{% endif -%} {%- for ismain, link in links[1:] -%} , {% if ismain %}{% endif -%} [{{ loop.index }}] {%- if ismain %}{% endif -%} {%- endfor %} {%- else %} {{ firstname|e }} {%- endif %} {% endmacro %} {%- extends "layout.html" %} {% set title = _('Index') %} {% block body %}

    {% trans key=key %}Index – {{ key }}{% endtrans %}

    {%- for column in entries|slice(2) if column %} {%- endfor %}
      {%- for entryname, (links, subitems, _) in column %}
    • {{ indexentries(entryname, links) }} {%- if subitems %}
        {%- for subentryname, subentrylinks in subitems %}
      • {{ indexentries(subentryname, subentrylinks) }}
        • {%- endfor %}
      {%- endif -%}
      • {%- endfor %}
    {% endblock %} {% block sidebarrel %}

    {{ _('Index') }}

    {% for key, dummy in genindexentries -%} {{ key }} {% if not loop.last %}| {% endif %} {%- endfor %}

    {{ _('Full index on one page') }}

    {{ super() }} {% endblock %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/themes/basic/genindex-split.html0000644000076600000240000000227200000000000022035 0ustar00tkomiyastaff{# basic/genindex-split.html ~~~~~~~~~~~~~~~~~~~~~~~~~ Template for a "split" index overview page. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. #} {%- extends "layout.html" %} {% set title = _('Index') %} {% block body %}

    {{ _('Index') }}

    {{ _('Index pages by letter') }}:

    {% for key, dummy in genindexentries -%} {{ key }} {% if not loop.last %}| {% endif %} {%- endfor %}

    {{ _('Full index on one page') }} ({{ _('can be huge') }})

    {% endblock %} {% block sidebarrel %} {% if split_index %}

    Index

    {% for key, dummy in genindexentries -%} {{ key }} {% if not loop.last %}| {% endif %} {%- endfor %}

    {{ _('Full index on one page') }}

    {% endif %} {{ super() }} {% endblock %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/themes/basic/genindex.html0000644000076600000240000000402500000000000020702 0ustar00tkomiyastaff{# basic/genindex.html ~~~~~~~~~~~~~~~~~~~ Template for an "all-in-one" index. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. #} {%- extends "layout.html" %} {% set title = _('Index') %} {% macro indexentries(firstname, links) %} {%- if links -%} {%- if links[0][0] %}{% endif -%} {{ firstname|e }} {%- if links[0][0] %}{% endif -%} {%- for ismain, link in links[1:] -%} , {% if ismain %}{% endif -%} [{{ loop.index }}] {%- if ismain %}{% endif -%} {%- endfor %} {%- else %} {{ firstname|e }} {%- endif %} {% endmacro %} {% block body %}

    {{ _('Index') }}

    {% for key, dummy in genindexentries -%} {{ key }} {% if not loop.last %}| {% endif %} {%- endfor %}
    {%- for key, entries in genindexentries %}

    {{ key }}

    {%- for column in entries|slice_index(2) if column %} {%- endfor %}
      {%- for entryname, (links, subitems, _) in column %}
    • {{ indexentries(entryname, links) }} {%- if subitems %}
        {%- for subentryname, subentrylinks in subitems %}
      • {{ indexentries(subentryname, subentrylinks) }}
        • {%- endfor %}
      {%- endif -%}
      • {%- endfor %}
    {% endfor %} {% endblock %} {% block sidebarrel %} {% if split_index %}

    {{ _('Index') }}

    {% for key, dummy in genindexentries -%} {{ key }} {% if not loop.last %}| {% endif %} {%- endfor %}

    {{ _('Full index on one page') }}

    {% endif %} {{ super() }} {% endblock %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/themes/basic/globaltoc.html0000644000076600000240000000066000000000000021050 0ustar00tkomiyastaff{# basic/globaltoc.html ~~~~~~~~~~~~~~~~~~~~ Sphinx sidebar template: global table of contents. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. #}

    {{ _('Table of Contents') }}

    {{ toctree(includehidden=theme_globaltoc_includehidden, collapse=theme_globaltoc_collapse, maxdepth=theme_globaltoc_maxdepth) }} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/themes/basic/layout.html0000644000076600000240000001672100000000000020424 0ustar00tkomiyastaff{# basic/layout.html ~~~~~~~~~~~~~~~~~ Master layout template for Sphinx themes. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. #} {%- block doctype -%}{%- if html5_doctype %} {%- else %} {%- endif %}{%- endblock %} {%- set reldelim1 = reldelim1 is not defined and ' »' or reldelim1 %} {%- set reldelim2 = reldelim2 is not defined and ' |' or reldelim2 %} {%- set render_sidebar = (not embedded) and (not theme_nosidebar|tobool) and (sidebars != []) %} {# URL root should never be #, then all links are fragments #} {%- if not embedded and docstitle %} {%- set titlesuffix = " — "|safe + docstitle|e %} {%- else %} {%- set titlesuffix = "" %} {%- endif %} {%- macro relbar() %} {%- endmacro %} {%- macro sidebar() %} {%- if render_sidebar %} {%- endif %} {%- endmacro %} {%- macro script() %} {%- for js in script_files %} {{ js_tag(js) }} {%- endfor %} {%- endmacro %} {%- macro css() %} {%- for css in css_files %} {%- if css|attr("filename") %} {{ css_tag(css) }} {%- else %} {%- endif %} {%- endfor %} {%- endmacro %} {%- if html_tag %} {{ html_tag }} {%- else %} {%- endif %} {%- if not html5_doctype and not skip_ua_compatible %} {%- endif %} {%- if use_meta_charset or html5_doctype %} {%- else %} {%- endif %} {{- metatags }} {%- block htmltitle %} {{ title|striptags|e }}{{ titlesuffix }} {%- endblock %} {%- block css %} {{- css() }} {%- endblock %} {%- if not embedded %} {%- block scripts %} {{- script() }} {%- endblock %} {%- if pageurl %} {%- endif %} {%- if use_opensearch %} {%- endif %} {%- if favicon_url %} {%- endif %} {%- endif %} {%- block linktags %} {%- if hasdoc('about') %} {%- endif %} {%- if hasdoc('genindex') %} {%- endif %} {%- if hasdoc('search') %} {%- endif %} {%- if hasdoc('copyright') %} {%- endif %} {%- if next %} {%- endif %} {%- if prev %} {%- endif %} {%- endblock %} {%- block extrahead %} {% endblock %} {%- block body_tag %}{% endblock %} {%- block header %}{% endblock %} {%- block relbar1 %}{{ relbar() }}{% endblock %} {%- block content %} {%- block sidebar1 %} {# possible location for sidebar #} {% endblock %}
    {%- block document %}
    {%- if render_sidebar %}
    {%- endif %}
    {% block body %} {% endblock %}
    {%- if render_sidebar %}
    {%- endif %}
    {%- endblock %} {%- block sidebar2 %}{{ sidebar() }}{% endblock %}
    {%- endblock %} {%- block relbar2 %}{{ relbar() }}{% endblock %} {%- block footer %} {%- endblock %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1639902831.0 Sphinx-4.3.2/sphinx/themes/basic/localtoc.html0000644000076600000240000000053500000000000020703 0ustar00tkomiyastaff{# basic/localtoc.html ~~~~~~~~~~~~~~~~~~~ Sphinx sidebar template: local table of contents. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. #} {%- if display_toc %}

    {{ _('Table of Contents') }}

    {{ toc }} {%- endif %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/themes/basic/opensearch.xml0000644000076600000240000000124700000000000021067 0ustar00tkomiyastaff {{ project|e }} {% trans docstitle=docstitle|e %}Search {{ docstitle }}{% endtrans %} utf-8 {{ docstitle|e }} {%- if favicon_url %} {{ use_opensearch }}/{{ favicon_url|e }} {%- endif %} {% block extra %} {# Put e.g. an element here. #} {% endblock %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/themes/basic/page.html0000644000076600000240000000042100000000000020011 0ustar00tkomiyastaff{# basic/page.html ~~~~~~~~~~~~~~~ Master template for simple pages. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. #} {%- extends "layout.html" %} {% block body %} {{ body }} {% endblock %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1639902831.0 Sphinx-4.3.2/sphinx/themes/basic/relations.html0000644000076600000240000000113600000000000021101 0ustar00tkomiyastaff{# basic/relations.html ~~~~~~~~~~~~~~~~~~~~ Sphinx sidebar template: relation links. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. #} {%- if prev %}

    {{ _('Previous topic') }}

    {{ prev.title }}

    {%- endif %} {%- if next %}

    {{ _('Next topic') }}

    {{ next.title }}

    {%- endif %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/themes/basic/search.html0000644000076600000240000000376700000000000020362 0ustar00tkomiyastaff{# basic/search.html ~~~~~~~~~~~~~~~~~ Template for the search page. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. #} {%- extends "layout.html" %} {% set title = _('Search') %} {%- block scripts %} {{ super() }} {%- endblock %} {% block extrahead %} {{ super() }} {% endblock %} {% block body %}

    {{ _('Search') }}

    {% block scriptwarning %} {% endblock %} {% block searchtext %}

    {% trans %}Searching for multiple words only shows matches that contain all words.{% endtrans %}

    {% endblock %} {% block searchbox %}
    {% endblock %} {% block searchresults %} {% if search_performed %}

    {{ _('Search Results') }}

    {% if not search_results %}

    {{ _('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.') }}

    {% endif %} {% endif %}
    {% if search_results %}
      {% for href, caption, context in search_results %}
    • {{ caption }}
      {{ context|e }}
      • {% endfor %}
    {% endif %}
    {% endblock %} {% endblock %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/themes/basic/searchbox.html0000644000076600000240000000140500000000000021056 0ustar00tkomiyastaff{# basic/searchbox.html ~~~~~~~~~~~~~~~~~~~~ Sphinx sidebar template: quick search box. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. #} {%- if pagename != "search" and builder != "singlehtml" %} {%- endif %} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/themes/basic/sourcelink.html0000644000076600000240000000104000000000000021251 0ustar00tkomiyastaff{# basic/sourcelink.html ~~~~~~~~~~~~~~~~~~~~~ Sphinx sidebar template: "show source" link. :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. #} {%- if show_source and has_source and sourcename %}

    {{ _('This Page') }}

    {%- endif %} ././@PaxHeader0000000000000000000000000000003300000000000010211 xustar0027 mtime=1639903107.552421 Sphinx-4.3.2/sphinx/themes/basic/static/0000755000076600000240000000000000000000000017501 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/themes/basic/static/basic.css_t0000644000076600000240000003463300000000000021630 0ustar00tkomiyastaff/* * basic.css * ~~~~~~~~~ * * Sphinx stylesheet -- basic theme. * * :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. * :license: BSD, see LICENSE for details. * */ /* -- main layout ----------------------------------------------------------- */ div.clearer { clear: both; } div.section::after { display: block; content: ''; clear: left; } /* -- relbar ---------------------------------------------------------------- */ div.related { width: 100%; font-size: 90%; } div.related h3 { display: none; } div.related ul { margin: 0; padding: 0 0 0 10px; list-style: none; } div.related li { display: inline; } div.related li.right { float: right; margin-right: 5px; } /* -- sidebar --------------------------------------------------------------- */ div.sphinxsidebarwrapper { padding: 10px 5px 0 10px; } div.sphinxsidebar { float: left; width: {{ theme_sidebarwidth|todim }}; margin-left: -100%; font-size: 90%; word-wrap: break-word; overflow-wrap : break-word; } div.sphinxsidebar ul { list-style: none; } div.sphinxsidebar ul ul, div.sphinxsidebar ul.want-points { margin-left: 20px; list-style: square; } div.sphinxsidebar ul ul { margin-top: 0; margin-bottom: 0; } div.sphinxsidebar form { margin-top: 10px; } div.sphinxsidebar input { border: 1px solid #98dbcc; font-family: sans-serif; font-size: 1em; } div.sphinxsidebar #searchbox form.search { overflow: hidden; } div.sphinxsidebar #searchbox input[type="text"] { float: left; width: 80%; padding: 0.25em; box-sizing: border-box; } div.sphinxsidebar #searchbox input[type="submit"] { float: left; width: 20%; border-left: none; padding: 0.25em; box-sizing: border-box; } img { border: 0; max-width: 100%; } /* -- search page ----------------------------------------------------------- */ ul.search { margin: 10px 0 0 20px; padding: 0; } ul.search li { padding: 5px 0 5px 20px; background-image: url(file.png); background-repeat: no-repeat; background-position: 0 7px; } ul.search li a { font-weight: bold; } ul.search li p.context { color: #888; margin: 2px 0 0 30px; text-align: left; } ul.keywordmatches li.goodmatch a { font-weight: bold; } /* -- index page ------------------------------------------------------------ */ table.contentstable { width: 90%; margin-left: auto; margin-right: auto; } table.contentstable p.biglink { line-height: 150%; } a.biglink { font-size: 1.3em; } span.linkdescr { font-style: italic; padding-top: 5px; font-size: 90%; } /* -- general index --------------------------------------------------------- */ table.indextable { width: 100%; } table.indextable td { text-align: left; vertical-align: top; } table.indextable ul { margin-top: 0; margin-bottom: 0; list-style-type: none; } table.indextable > tbody > tr > td > ul { padding-left: 0em; } table.indextable tr.pcap { height: 10px; } table.indextable tr.cap { margin-top: 10px; background-color: #f2f2f2; } img.toggler { margin-right: 3px; margin-top: 3px; cursor: pointer; } div.modindex-jumpbox { border-top: 1px solid #ddd; border-bottom: 1px solid #ddd; margin: 1em 0 1em 0; padding: 0.4em; } div.genindex-jumpbox { border-top: 1px solid #ddd; border-bottom: 1px solid #ddd; margin: 1em 0 1em 0; padding: 0.4em; } /* -- domain module index --------------------------------------------------- */ table.modindextable td { padding: 2px; border-collapse: collapse; } /* -- general body styles --------------------------------------------------- */ div.body { min-width: {{ theme_body_min_width|todim }}; max-width: {{ theme_body_max_width|todim }}; } div.body p, div.body dd, div.body li, div.body blockquote { -moz-hyphens: auto; -ms-hyphens: auto; -webkit-hyphens: auto; hyphens: auto; } a.headerlink { visibility: hidden; } a.brackets:before, span.brackets > a:before{ content: "["; } a.brackets:after, span.brackets > a:after { content: "]"; } h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, h4:hover > a.headerlink, h5:hover > a.headerlink, h6:hover > a.headerlink, dt:hover > a.headerlink, caption:hover > a.headerlink, p.caption:hover > a.headerlink, div.code-block-caption:hover > a.headerlink { visibility: visible; } div.body p.caption { text-align: inherit; } div.body td { text-align: left; } .first { margin-top: 0 !important; } p.rubric { margin-top: 30px; font-weight: bold; } img.align-left, figure.align-left, .figure.align-left, object.align-left { clear: left; float: left; margin-right: 1em; } img.align-right, figure.align-right, .figure.align-right, object.align-right { clear: right; float: right; margin-left: 1em; } img.align-center, figure.align-center, .figure.align-center, object.align-center { display: block; margin-left: auto; margin-right: auto; } img.align-default, figure.align-default, .figure.align-default { display: block; margin-left: auto; margin-right: auto; } .align-left { text-align: left; } .align-center { text-align: center; } .align-default { text-align: center; } .align-right { text-align: right; } /* -- sidebars -------------------------------------------------------------- */ div.sidebar, aside.sidebar { margin: 0 0 0.5em 1em; border: 1px solid #ddb; padding: 7px; background-color: #ffe; width: 40%; float: right; clear: right; overflow-x: auto; } p.sidebar-title { font-weight: bold; } div.admonition, div.topic, blockquote { clear: left; } /* -- topics ---------------------------------------------------------------- */ div.topic { border: 1px solid #ccc; padding: 7px; margin: 10px 0 10px 0; } p.topic-title { font-size: 1.1em; font-weight: bold; margin-top: 10px; } /* -- admonitions ----------------------------------------------------------- */ div.admonition { margin-top: 10px; margin-bottom: 10px; padding: 7px; } div.admonition dt { font-weight: bold; } p.admonition-title { margin: 0px 10px 5px 0px; font-weight: bold; } div.body p.centered { text-align: center; margin-top: 25px; } /* -- content of sidebars/topics/admonitions -------------------------------- */ div.sidebar > :last-child, aside.sidebar > :last-child, div.topic > :last-child, div.admonition > :last-child { margin-bottom: 0; } div.sidebar::after, aside.sidebar::after, div.topic::after, div.admonition::after, blockquote::after { display: block; content: ''; clear: both; } /* -- tables ---------------------------------------------------------------- */ table.docutils { margin-top: 10px; margin-bottom: 10px; border: 0; border-collapse: collapse; } table.align-center { margin-left: auto; margin-right: auto; } table.align-default { margin-left: auto; margin-right: auto; } table caption span.caption-number { font-style: italic; } table caption span.caption-text { } table.docutils td, table.docutils th { padding: 1px 8px 1px 5px; border-top: 0; border-left: 0; border-right: 0; border-bottom: 1px solid #aaa; } table.footnote td, table.footnote th { border: 0 !important; } th { text-align: left; padding-right: 5px; } table.citation { border-left: solid 1px gray; margin-left: 1px; } table.citation td { border-bottom: none; } th > :first-child, td > :first-child { margin-top: 0px; } th > :last-child, td > :last-child { margin-bottom: 0px; } /* -- figures --------------------------------------------------------------- */ div.figure, figure { margin: 0.5em; padding: 0.5em; } div.figure p.caption, figcaption { padding: 0.3em; } div.figure p.caption span.caption-number, figcaption span.caption-number { font-style: italic; } div.figure p.caption span.caption-text, figcaption span.caption-text { } /* -- field list styles ----------------------------------------------------- */ table.field-list td, table.field-list th { border: 0 !important; } .field-list ul { margin: 0; padding-left: 1em; } .field-list p { margin: 0; } .field-name { -moz-hyphens: manual; -ms-hyphens: manual; -webkit-hyphens: manual; hyphens: manual; } /* -- hlist styles ---------------------------------------------------------- */ table.hlist { margin: 1em 0; } table.hlist td { vertical-align: top; } /* -- object description styles --------------------------------------------- */ .sig { font-family: 'Consolas', 'Menlo', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', monospace; } .sig-name, code.descname { background-color: transparent; font-weight: bold; } .sig-name { font-size: 1.1em; } code.descname { font-size: 1.2em; } .sig-prename, code.descclassname { background-color: transparent; } .optional { font-size: 1.3em; } .sig-paren { font-size: larger; } .sig-param.n { font-style: italic; } /* C++ specific styling */ .sig-inline.c-texpr, .sig-inline.cpp-texpr { font-family: unset; } .sig.c .k, .sig.c .kt, .sig.cpp .k, .sig.cpp .kt { color: #0033B3; } .sig.c .m, .sig.cpp .m { color: #1750EB; } .sig.c .s, .sig.c .sc, .sig.cpp .s, .sig.cpp .sc { color: #067D17; } /* -- other body styles ----------------------------------------------------- */ ol.arabic { list-style: decimal; } ol.loweralpha { list-style: lower-alpha; } ol.upperalpha { list-style: upper-alpha; } ol.lowerroman { list-style: lower-roman; } ol.upperroman { list-style: upper-roman; } :not(li) > ol > li:first-child > :first-child, :not(li) > ul > li:first-child > :first-child { margin-top: 0px; } :not(li) > ol > li:last-child > :last-child, :not(li) > ul > li:last-child > :last-child { margin-bottom: 0px; } ol.simple ol p, ol.simple ul p, ul.simple ol p, ul.simple ul p { margin-top: 0; } ol.simple > li:not(:first-child) > p, ul.simple > li:not(:first-child) > p { margin-top: 0; } ol.simple p, ul.simple p { margin-bottom: 0; } dl.footnote > dt, dl.citation > dt { float: left; margin-right: 0.5em; } dl.footnote > dd, dl.citation > dd { margin-bottom: 0em; } dl.footnote > dd:after, dl.citation > dd:after { content: ""; clear: both; } dl.field-list { display: grid; grid-template-columns: fit-content(30%) auto; } dl.field-list > dt { font-weight: bold; word-break: break-word; padding-left: 0.5em; padding-right: 5px; } dl.field-list > dt:after { content: ":"; } dl.field-list > dd { padding-left: 0.5em; margin-top: 0em; margin-left: 0em; margin-bottom: 0em; } dl { margin-bottom: 15px; } dd > :first-child { margin-top: 0px; } dd ul, dd table { margin-bottom: 10px; } dd { margin-top: 3px; margin-bottom: 10px; margin-left: 30px; } dl > dd:last-child, dl > dd:last-child > :last-child { margin-bottom: 0; } dt:target, span.highlighted { background-color: #fbe54e; } rect.highlighted { fill: #fbe54e; } dl.glossary dt { font-weight: bold; font-size: 1.1em; } .versionmodified { font-style: italic; } .system-message { background-color: #fda; padding: 5px; border: 3px solid red; } .footnote:target { background-color: #ffa; } .line-block { display: block; margin-top: 1em; margin-bottom: 1em; } .line-block .line-block { margin-top: 0; margin-bottom: 0; margin-left: 1.5em; } .guilabel, .menuselection { font-family: sans-serif; } .accelerator { text-decoration: underline; } .classifier { font-style: oblique; } .classifier:before { font-style: normal; margin: 0 0.5em; content: ":"; display: inline-block; } abbr, acronym { border-bottom: dotted 1px; cursor: help; } /* -- code displays --------------------------------------------------------- */ pre { overflow: auto; overflow-y: hidden; /* fixes display issues on Chrome browsers */ } pre, div[class*="highlight-"] { clear: both; } span.pre { -moz-hyphens: none; -ms-hyphens: none; -webkit-hyphens: none; hyphens: none; } div[class*="highlight-"] { margin: 1em 0; } td.linenos pre { border: 0; background-color: transparent; color: #aaa; } table.highlighttable { display: block; } table.highlighttable tbody { display: block; } table.highlighttable tr { display: flex; } table.highlighttable td { margin: 0; padding: 0; } table.highlighttable td.linenos { padding-right: 0.5em; } table.highlighttable td.code { flex: 1; overflow: hidden; } .highlight .hll { display: block; } div.highlight pre, table.highlighttable pre { margin: 0; } div.code-block-caption + div { margin-top: 0; } div.code-block-caption { margin-top: 1em; padding: 2px 5px; font-size: small; } div.code-block-caption code { background-color: transparent; } table.highlighttable td.linenos, span.linenos, div.highlight span.gp { /* gp: Generic.Prompt */ user-select: none; -webkit-user-select: text; /* Safari fallback only */ -webkit-user-select: none; /* Chrome/Safari */ -moz-user-select: none; /* Firefox */ -ms-user-select: none; /* IE10+ */ } div.code-block-caption span.caption-number { padding: 0.1em 0.3em; font-style: italic; } div.code-block-caption span.caption-text { } div.literal-block-wrapper { margin: 1em 0; } code.xref, a code { background-color: transparent; font-weight: bold; } h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { background-color: transparent; } .viewcode-link { float: right; } .viewcode-back { float: right; font-family: sans-serif; } div.viewcode-block:target { margin: -1px -10px; padding: 0 10px; } /* -- math display ---------------------------------------------------------- */ img.math { vertical-align: middle; } div.body div.math p { text-align: center; } span.eqno { float: right; } span.eqno a.headerlink { position: absolute; z-index: 1; } div.math:hover a.headerlink { visibility: visible; } /* -- printout stylesheet --------------------------------------------------- */ @media print { div.document, div.documentwrapper, div.bodywrapper { margin: 0 !important; width: 100%; } div.sphinxsidebar, div.related, div.footer, #top-link { display: none; } } ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164247.0 Sphinx-4.3.2/sphinx/themes/basic/static/doctools.js0000644000076600000240000002263600000000000021676 0ustar00tkomiyastaff/* * doctools.js * ~~~~~~~~~~~ * * Sphinx JavaScript utilities for all documentation. * * :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS. * :license: BSD, see LICENSE for details. * */ /** * select a different prefix for underscore */ $u = _.noConflict(); /** * make the code below compatible with browsers without * an installed firebug like debugger if (!window.console || !console.firebug) { var names = ["log", "debug", "info", "warn", "error", "assert", "dir", "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", "profile", "profileEnd"]; window.console = {}; for (var i = 0; i < names.length; ++i) window.console[names[i]] = function() {}; } */ /** * small helper function to urldecode strings * * See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/decodeURIComponent#Decoding_query_parameters_from_a_URL */ jQuery.urldecode = function(x) { if (!x) { return x } return decodeURIComponent(x.replace(/\+/g, ' ')); }; /** * small helper function to urlencode strings */ jQuery.urlencode = encodeURIComponent; /** * This function returns the parsed url parameters of the * current request. Multiple values per key are supported, * it will always return arrays of strings for the value parts. */ jQuery.getQueryParameters = function(s) { if (typeof s === 'undefined') s = document.location.search; var parts = s.substr(s.indexOf('?') + 1).split('&'); var result = {}; for (var i = 0; i < parts.length; i++) { var tmp = parts[i].split('=', 2); var key = jQuery.urldecode(tmp[0]); var value = jQuery.urldecode(tmp[1]); if (key in result) result[key].push(value); else result[key] = [value]; } return result; }; /** * highlight a given string on a jquery object by wrapping it in * span elements with the given class name. */ jQuery.fn.highlightText = function(text, className) { function highlight(node, addItems) { if (node.nodeType === 3) { var val = node.nodeValue; var pos = val.toLowerCase().indexOf(text); if (pos >= 0 && !jQuery(node.parentNode).hasClass(className) && !jQuery(node.parentNode).hasClass("nohighlight")) { var span; var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg"); if (isInSVG) { span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); } else { span = document.createElement("span"); span.className = className; } span.appendChild(document.createTextNode(val.substr(pos, text.length))); node.parentNode.insertBefore(span, node.parentNode.insertBefore( document.createTextNode(val.substr(pos + text.length)), node.nextSibling)); node.nodeValue = val.substr(0, pos); if (isInSVG) { var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect"); var bbox = node.parentElement.getBBox(); rect.x.baseVal.value = bbox.x; rect.y.baseVal.value = bbox.y; rect.width.baseVal.value = bbox.width; rect.height.baseVal.value = bbox.height; rect.setAttribute('class', className); addItems.push({ "parent": node.parentNode, "target": rect}); } } } else if (!jQuery(node).is("button, select, textarea")) { jQuery.each(node.childNodes, function() { highlight(this, addItems); }); } } var addItems = []; var result = this.each(function() { highlight(this, addItems); }); for (var i = 0; i < addItems.length; ++i) { jQuery(addItems[i].parent).before(addItems[i].target); } return result; }; /* * backward compatibility for jQuery.browser * This will be supported until firefox bug is fixed. */ if (!jQuery.browser) { jQuery.uaMatch = function(ua) { ua = ua.toLowerCase(); var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || /(webkit)[ \/]([\w.]+)/.exec(ua) || /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || /(msie) ([\w.]+)/.exec(ua) || ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || []; return { browser: match[ 1 ] || "", version: match[ 2 ] || "0" }; }; jQuery.browser = {}; jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; } /** * Small JavaScript module for the documentation. */ var Documentation = { init : function() { this.fixFirefoxAnchorBug(); this.highlightSearchWords(); this.initIndexTable(); if (DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) { this.initOnKeyListeners(); } }, /** * i18n support */ TRANSLATIONS : {}, PLURAL_EXPR : function(n) { return n === 1 ? 0 : 1; }, LOCALE : 'unknown', // gettext and ngettext don't access this so that the functions // can safely bound to a different name (_ = Documentation.gettext) gettext : function(string) { var translated = Documentation.TRANSLATIONS[string]; if (typeof translated === 'undefined') return string; return (typeof translated === 'string') ? translated : translated[0]; }, ngettext : function(singular, plural, n) { var translated = Documentation.TRANSLATIONS[singular]; if (typeof translated === 'undefined') return (n == 1) ? singular : plural; return translated[Documentation.PLURALEXPR(n)]; }, addTranslations : function(catalog) { for (var key in catalog.messages) this.TRANSLATIONS[key] = catalog.messages[key]; this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); this.LOCALE = catalog.locale; }, /** * add context elements like header anchor links */ addContextElements : function() { $('div[id] > :header:first').each(function() { $('\u00B6'). attr('href', '#' + this.id). attr('title', _('Permalink to this headline')). appendTo(this); }); $('dt[id]').each(function() { $('\u00B6'). attr('href', '#' + this.id). attr('title', _('Permalink to this definition')). appendTo(this); }); }, /** * workaround a firefox stupidity * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075 */ fixFirefoxAnchorBug : function() { if (document.location.hash && $.browser.mozilla) window.setTimeout(function() { document.location.href += ''; }, 10); }, /** * highlight the search words provided in the url in the text */ highlightSearchWords : function() { var params = $.getQueryParameters(); var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; if (terms.length) { var body = $('div.body'); if (!body.length) { body = $('body'); } window.setTimeout(function() { $.each(terms, function() { body.highlightText(this.toLowerCase(), 'highlighted'); }); }, 10); $('

    ' + _('Hide Search Matches') + '

    ') .appendTo($('#searchbox')); } }, /** * init the domain index toggle buttons */ initIndexTable : function() { var togglers = $('img.toggler').click(function() { var src = $(this).attr('src'); var idnum = $(this).attr('id').substr(7); $('tr.cg-' + idnum).toggle(); if (src.substr(-9) === 'minus.png') $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); else $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); }).css('display', ''); if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { togglers.click(); } }, /** * helper function to hide the search marks again */ hideSearchWords : function() { $('#searchbox .highlight-link').fadeOut(300); $('span.highlighted').removeClass('highlighted'); }, /** * make the url absolute */ makeURL : function(relativeURL) { return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; }, /** * get the current relative url */ getCurrentURL : function() { var path = document.location.pathname; var parts = path.split(/\//); $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { if (this === '..') parts.pop(); }); var url = parts.join('/'); return path.substring(url.lastIndexOf('/') + 1, path.length - 1); }, initOnKeyListeners: function() { $(document).keydown(function(event) { var activeElementType = document.activeElement.tagName; // don't navigate when in search box, textarea, dropdown or button if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT' && activeElementType !== 'BUTTON' && !event.altKey && !event.ctrlKey && !event.metaKey && !event.shiftKey) { switch (event.keyCode) { case 37: // left var prevHref = $('link[rel="prev"]').prop('href'); if (prevHref) { window.location.href = prevHref; return false; } break; case 39: // right var nextHref = $('link[rel="next"]').prop('href'); if (nextHref) { window.location.href = nextHref; return false; } break; } } }); } }; // quick alias for translations _ = Documentation.gettext; $(document).ready(function() { Documentation.init(); }); ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/themes/basic/static/documentation_options.js_t0000644000076600000240000000076600000000000025017 0ustar00tkomiyastaffvar DOCUMENTATION_OPTIONS = { URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), VERSION: '{{ release|e }}', LANGUAGE: '{{ language }}', COLLAPSE_INDEX: false, BUILDER: '{{ builder }}', FILE_SUFFIX: '{{ file_suffix }}', LINK_SUFFIX: '{{ link_suffix }}', HAS_SOURCE: {{ has_source|lower }}, SOURCELINK_SUFFIX: '{{ sourcelink_suffix }}', NAVIGATION_WITH_KEYS: {{ 'true' if theme_navigation_with_keys|tobool else 'false'}} }; ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/sphinx/themes/basic/static/file.png0000644000076600000240000000043600000000000021131 0ustar00tkomiyastaffPNG  IHDRaIDATxR){l ۶f=@ :3~箄rX$AX-D ~ lj(P%8<<9:: PO&$ l~X&EW^4wQ}^ͣ i0/H/@F)Dzq+j[SU5h/oY G&Lfs|{3%U+S`AFIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/themes/basic/static/jquery-3.5.1.js0000644000076600000240000106161600000000000022033 0ustar00tkomiyastaff/*! * jQuery JavaScript Library v3.5.1 * https://jquery.com/ * * Includes Sizzle.js * https://sizzlejs.com/ * * Copyright JS Foundation and other contributors * Released under the MIT license * https://jquery.org/license * * Date: 2020-05-04T22:49Z */ ( function( global, factory ) { "use strict"; if ( typeof module === "object" && typeof module.exports === "object" ) { // For CommonJS and CommonJS-like environments where a proper `window` // is present, execute the factory and get jQuery. // For environments that do not have a `window` with a `document` // (such as Node.js), expose a factory as module.exports. // This accentuates the need for the creation of a real `window`. // e.g. var jQuery = require("jquery")(window); // See ticket #14549 for more info. module.exports = global.document ? factory( global, true ) : function( w ) { if ( !w.document ) { throw new Error( "jQuery requires a window with a document" ); } return factory( w ); }; } else { factory( global ); } // Pass this if window is not defined yet } )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) { // Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1 // throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode // arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common // enough that all such attempts are guarded in a try block. "use strict"; var arr = []; var getProto = Object.getPrototypeOf; var slice = arr.slice; var flat = arr.flat ? function( array ) { return arr.flat.call( array ); } : function( array ) { return arr.concat.apply( [], array ); }; var push = arr.push; var indexOf = arr.indexOf; var class2type = {}; var toString = class2type.toString; var hasOwn = class2type.hasOwnProperty; var fnToString = hasOwn.toString; var ObjectFunctionString = fnToString.call( Object ); var support = {}; var isFunction = function isFunction( obj ) { // Support: Chrome <=57, Firefox <=52 // In some browsers, typeof returns "function" for HTML elements // (i.e., `typeof document.createElement( "object" ) === "function"`). // We don't want to classify *any* DOM node as a function. return typeof obj === "function" && typeof obj.nodeType !== "number"; }; var isWindow = function isWindow( obj ) { return obj != null && obj === obj.window; }; var document = window.document; var preservedScriptAttributes = { type: true, src: true, nonce: true, noModule: true }; function DOMEval( code, node, doc ) { doc = doc || document; var i, val, script = doc.createElement( "script" ); script.text = code; if ( node ) { for ( i in preservedScriptAttributes ) { // Support: Firefox 64+, Edge 18+ // Some browsers don't support the "nonce" property on scripts. // On the other hand, just using `getAttribute` is not enough as // the `nonce` attribute is reset to an empty string whenever it // becomes browsing-context connected. // See https://github.com/whatwg/html/issues/2369 // See https://html.spec.whatwg.org/#nonce-attributes // The `node.getAttribute` check was added for the sake of // `jQuery.globalEval` so that it can fake a nonce-containing node // via an object. val = node[ i ] || node.getAttribute && node.getAttribute( i ); if ( val ) { script.setAttribute( i, val ); } } } doc.head.appendChild( script ).parentNode.removeChild( script ); } function toType( obj ) { if ( obj == null ) { return obj + ""; } // Support: Android <=2.3 only (functionish RegExp) return typeof obj === "object" || typeof obj === "function" ? class2type[ toString.call( obj ) ] || "object" : typeof obj; } /* global Symbol */ // Defining this global in .eslintrc.json would create a danger of using the global // unguarded in another place, it seems safer to define global only for this module var version = "3.5.1", // Define a local copy of jQuery jQuery = function( selector, context ) { // The jQuery object is actually just the init constructor 'enhanced' // Need init if jQuery is called (just allow error to be thrown if not included) return new jQuery.fn.init( selector, context ); }; jQuery.fn = jQuery.prototype = { // The current version of jQuery being used jquery: version, constructor: jQuery, // The default length of a jQuery object is 0 length: 0, toArray: function() { return slice.call( this ); }, // Get the Nth element in the matched element set OR // Get the whole matched element set as a clean array get: function( num ) { // Return all the elements in a clean array if ( num == null ) { return slice.call( this ); } // Return just the one element from the set return num < 0 ? this[ num + this.length ] : this[ num ]; }, // Take an array of elements and push it onto the stack // (returning the new matched element set) pushStack: function( elems ) { // Build a new jQuery matched element set var ret = jQuery.merge( this.constructor(), elems ); // Add the old object onto the stack (as a reference) ret.prevObject = this; // Return the newly-formed element set return ret; }, // Execute a callback for every element in the matched set. each: function( callback ) { return jQuery.each( this, callback ); }, map: function( callback ) { return this.pushStack( jQuery.map( this, function( elem, i ) { return callback.call( elem, i, elem ); } ) ); }, slice: function() { return this.pushStack( slice.apply( this, arguments ) ); }, first: function() { return this.eq( 0 ); }, last: function() { return this.eq( -1 ); }, even: function() { return this.pushStack( jQuery.grep( this, function( _elem, i ) { return ( i + 1 ) % 2; } ) ); }, odd: function() { return this.pushStack( jQuery.grep( this, function( _elem, i ) { return i % 2; } ) ); }, eq: function( i ) { var len = this.length, j = +i + ( i < 0 ? len : 0 ); return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] ); }, end: function() { return this.prevObject || this.constructor(); }, // For internal use only. // Behaves like an Array's method, not like a jQuery method. push: push, sort: arr.sort, splice: arr.splice }; jQuery.extend = jQuery.fn.extend = function() { var options, name, src, copy, copyIsArray, clone, target = arguments[ 0 ] || {}, i = 1, length = arguments.length, deep = false; // Handle a deep copy situation if ( typeof target === "boolean" ) { deep = target; // Skip the boolean and the target target = arguments[ i ] || {}; i++; } // Handle case when target is a string or something (possible in deep copy) if ( typeof target !== "object" && !isFunction( target ) ) { target = {}; } // Extend jQuery itself if only one argument is passed if ( i === length ) { target = this; i--; } for ( ; i < length; i++ ) { // Only deal with non-null/undefined values if ( ( options = arguments[ i ] ) != null ) { // Extend the base object for ( name in options ) { copy = options[ name ]; // Prevent Object.prototype pollution // Prevent never-ending loop if ( name === "__proto__" || target === copy ) { continue; } // Recurse if we're merging plain objects or arrays if ( deep && copy && ( jQuery.isPlainObject( copy ) || ( copyIsArray = Array.isArray( copy ) ) ) ) { src = target[ name ]; // Ensure proper type for the source value if ( copyIsArray && !Array.isArray( src ) ) { clone = []; } else if ( !copyIsArray && !jQuery.isPlainObject( src ) ) { clone = {}; } else { clone = src; } copyIsArray = false; // Never move original objects, clone them target[ name ] = jQuery.extend( deep, clone, copy ); // Don't bring in undefined values } else if ( copy !== undefined ) { target[ name ] = copy; } } } } // Return the modified object return target; }; jQuery.extend( { // Unique for each copy of jQuery on the page expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ), // Assume jQuery is ready without the ready module isReady: true, error: function( msg ) { throw new Error( msg ); }, noop: function() {}, isPlainObject: function( obj ) { var proto, Ctor; // Detect obvious negatives // Use toString instead of jQuery.type to catch host objects if ( !obj || toString.call( obj ) !== "[object Object]" ) { return false; } proto = getProto( obj ); // Objects with no prototype (e.g., `Object.create( null )`) are plain if ( !proto ) { return true; } // Objects with prototype are plain iff they were constructed by a global Object function Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor; return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString; }, isEmptyObject: function( obj ) { var name; for ( name in obj ) { return false; } return true; }, // Evaluates a script in a provided context; falls back to the global one // if not specified. globalEval: function( code, options, doc ) { DOMEval( code, { nonce: options && options.nonce }, doc ); }, each: function( obj, callback ) { var length, i = 0; if ( isArrayLike( obj ) ) { length = obj.length; for ( ; i < length; i++ ) { if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { break; } } } else { for ( i in obj ) { if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { break; } } } return obj; }, // results is for internal usage only makeArray: function( arr, results ) { var ret = results || []; if ( arr != null ) { if ( isArrayLike( Object( arr ) ) ) { jQuery.merge( ret, typeof arr === "string" ? [ arr ] : arr ); } else { push.call( ret, arr ); } } return ret; }, inArray: function( elem, arr, i ) { return arr == null ? -1 : indexOf.call( arr, elem, i ); }, // Support: Android <=4.0 only, PhantomJS 1 only // push.apply(_, arraylike) throws on ancient WebKit merge: function( first, second ) { var len = +second.length, j = 0, i = first.length; for ( ; j < len; j++ ) { first[ i++ ] = second[ j ]; } first.length = i; return first; }, grep: function( elems, callback, invert ) { var callbackInverse, matches = [], i = 0, length = elems.length, callbackExpect = !invert; // Go through the array, only saving the items // that pass the validator function for ( ; i < length; i++ ) { callbackInverse = !callback( elems[ i ], i ); if ( callbackInverse !== callbackExpect ) { matches.push( elems[ i ] ); } } return matches; }, // arg is for internal usage only map: function( elems, callback, arg ) { var length, value, i = 0, ret = []; // Go through the array, translating each of the items to their new values if ( isArrayLike( elems ) ) { length = elems.length; for ( ; i < length; i++ ) { value = callback( elems[ i ], i, arg ); if ( value != null ) { ret.push( value ); } } // Go through every key on the object, } else { for ( i in elems ) { value = callback( elems[ i ], i, arg ); if ( value != null ) { ret.push( value ); } } } // Flatten any nested arrays return flat( ret ); }, // A global GUID counter for objects guid: 1, // jQuery.support is not used in Core but other projects attach their // properties to it so it needs to exist. support: support } ); if ( typeof Symbol === "function" ) { jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ]; } // Populate the class2type map jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ), function( _i, name ) { class2type[ "[object " + name + "]" ] = name.toLowerCase(); } ); function isArrayLike( obj ) { // Support: real iOS 8.2 only (not reproducible in simulator) // `in` check used to prevent JIT error (gh-2145) // hasOwn isn't used here due to false negatives // regarding Nodelist length in IE var length = !!obj && "length" in obj && obj.length, type = toType( obj ); if ( isFunction( obj ) || isWindow( obj ) ) { return false; } return type === "array" || length === 0 || typeof length === "number" && length > 0 && ( length - 1 ) in obj; } var Sizzle = /*! * Sizzle CSS Selector Engine v2.3.5 * https://sizzlejs.com/ * * Copyright JS Foundation and other contributors * Released under the MIT license * https://js.foundation/ * * Date: 2020-03-14 */ ( function( window ) { var i, support, Expr, getText, isXML, tokenize, compile, select, outermostContext, sortInput, hasDuplicate, // Local document vars setDocument, document, docElem, documentIsHTML, rbuggyQSA, rbuggyMatches, matches, contains, // Instance-specific data expando = "sizzle" + 1 * new Date(), preferredDoc = window.document, dirruns = 0, done = 0, classCache = createCache(), tokenCache = createCache(), compilerCache = createCache(), nonnativeSelectorCache = createCache(), sortOrder = function( a, b ) { if ( a === b ) { hasDuplicate = true; } return 0; }, // Instance methods hasOwn = ( {} ).hasOwnProperty, arr = [], pop = arr.pop, pushNative = arr.push, push = arr.push, slice = arr.slice, // Use a stripped-down indexOf as it's faster than native // https://jsperf.com/thor-indexof-vs-for/5 indexOf = function( list, elem ) { var i = 0, len = list.length; for ( ; i < len; i++ ) { if ( list[ i ] === elem ) { return i; } } return -1; }, booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|" + "ismap|loop|multiple|open|readonly|required|scoped", // Regular expressions // http://www.w3.org/TR/css3-selectors/#whitespace whitespace = "[\\x20\\t\\r\\n\\f]", // https://www.w3.org/TR/css-syntax-3/#ident-token-diagram identifier = "(?:\\\\[\\da-fA-F]{1,6}" + whitespace + "?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+", // Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace + // Operator (capture 2) "*([*^$|!~]?=)" + whitespace + // "Attribute values must be CSS identifiers [capture 5] // or strings [capture 3 or capture 4]" "*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + whitespace + "*\\]", pseudos = ":(" + identifier + ")(?:\\((" + // To reduce the number of selectors needing tokenize in the preFilter, prefer arguments: // 1. quoted (capture 3; capture 4 or capture 5) "('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" + // 2. simple (capture 6) "((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" + // 3. anything else (capture 2) ".*" + ")\\)|)", // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter rwhitespace = new RegExp( whitespace + "+", "g" ), rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + whitespace + "+$", "g" ), rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + "*" ), rdescend = new RegExp( whitespace + "|>" ), rpseudo = new RegExp( pseudos ), ridentifier = new RegExp( "^" + identifier + "$" ), matchExpr = { "ID": new RegExp( "^#(" + identifier + ")" ), "CLASS": new RegExp( "^\\.(" + identifier + ")" ), "TAG": new RegExp( "^(" + identifier + "|[*])" ), "ATTR": new RegExp( "^" + attributes ), "PSEUDO": new RegExp( "^" + pseudos ), "CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + whitespace + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + whitespace + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), "bool": new RegExp( "^(?:" + booleans + ")$", "i" ), // For use in libraries implementing .is() // We use this for POS matching in `select` "needsContext": new RegExp( "^" + whitespace + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + whitespace + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) }, rhtml = /HTML$/i, rinputs = /^(?:input|select|textarea|button)$/i, rheader = /^h\d$/i, rnative = /^[^{]+\{\s*\[native \w/, // Easily-parseable/retrievable ID or TAG or CLASS selectors rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, rsibling = /[+~]/, // CSS escapes // http://www.w3.org/TR/CSS21/syndata.html#escaped-characters runescape = new RegExp( "\\\\[\\da-fA-F]{1,6}" + whitespace + "?|\\\\([^\\r\\n\\f])", "g" ), funescape = function( escape, nonHex ) { var high = "0x" + escape.slice( 1 ) - 0x10000; return nonHex ? // Strip the backslash prefix from a non-hex escape sequence nonHex : // Replace a hexadecimal escape sequence with the encoded Unicode code point // Support: IE <=11+ // For values outside the Basic Multilingual Plane (BMP), manually construct a // surrogate pair high < 0 ? String.fromCharCode( high + 0x10000 ) : String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); }, // CSS string/identifier serialization // https://drafts.csswg.org/cssom/#common-serializing-idioms rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g, fcssescape = function( ch, asCodePoint ) { if ( asCodePoint ) { // U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER if ( ch === "\0" ) { return "\uFFFD"; } // Control characters and (dependent upon position) numbers get escaped as code points return ch.slice( 0, -1 ) + "\\" + ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " "; } // Other potentially-special ASCII characters get backslash-escaped return "\\" + ch; }, // Used for iframes // See setDocument() // Removing the function wrapper causes a "Permission Denied" // error in IE unloadHandler = function() { setDocument(); }, inDisabledFieldset = addCombinator( function( elem ) { return elem.disabled === true && elem.nodeName.toLowerCase() === "fieldset"; }, { dir: "parentNode", next: "legend" } ); // Optimize for push.apply( _, NodeList ) try { push.apply( ( arr = slice.call( preferredDoc.childNodes ) ), preferredDoc.childNodes ); // Support: Android<4.0 // Detect silently failing push.apply // eslint-disable-next-line no-unused-expressions arr[ preferredDoc.childNodes.length ].nodeType; } catch ( e ) { push = { apply: arr.length ? // Leverage slice if possible function( target, els ) { pushNative.apply( target, slice.call( els ) ); } : // Support: IE<9 // Otherwise append directly function( target, els ) { var j = target.length, i = 0; // Can't trust NodeList.length while ( ( target[ j++ ] = els[ i++ ] ) ) {} target.length = j - 1; } }; } function Sizzle( selector, context, results, seed ) { var m, i, elem, nid, match, groups, newSelector, newContext = context && context.ownerDocument, // nodeType defaults to 9, since context defaults to document nodeType = context ? context.nodeType : 9; results = results || []; // Return early from calls with invalid selector or context if ( typeof selector !== "string" || !selector || nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) { return results; } // Try to shortcut find operations (as opposed to filters) in HTML documents if ( !seed ) { setDocument( context ); context = context || document; if ( documentIsHTML ) { // If the selector is sufficiently simple, try using a "get*By*" DOM method // (excepting DocumentFragment context, where the methods don't exist) if ( nodeType !== 11 && ( match = rquickExpr.exec( selector ) ) ) { // ID selector if ( ( m = match[ 1 ] ) ) { // Document context if ( nodeType === 9 ) { if ( ( elem = context.getElementById( m ) ) ) { // Support: IE, Opera, Webkit // TODO: identify versions // getElementById can match elements by name instead of ID if ( elem.id === m ) { results.push( elem ); return results; } } else { return results; } // Element context } else { // Support: IE, Opera, Webkit // TODO: identify versions // getElementById can match elements by name instead of ID if ( newContext && ( elem = newContext.getElementById( m ) ) && contains( context, elem ) && elem.id === m ) { results.push( elem ); return results; } } // Type selector } else if ( match[ 2 ] ) { push.apply( results, context.getElementsByTagName( selector ) ); return results; // Class selector } else if ( ( m = match[ 3 ] ) && support.getElementsByClassName && context.getElementsByClassName ) { push.apply( results, context.getElementsByClassName( m ) ); return results; } } // Take advantage of querySelectorAll if ( support.qsa && !nonnativeSelectorCache[ selector + " " ] && ( !rbuggyQSA || !rbuggyQSA.test( selector ) ) && // Support: IE 8 only // Exclude object elements ( nodeType !== 1 || context.nodeName.toLowerCase() !== "object" ) ) { newSelector = selector; newContext = context; // qSA considers elements outside a scoping root when evaluating child or // descendant combinators, which is not what we want. // In such cases, we work around the behavior by prefixing every selector in the // list with an ID selector referencing the scope context. // The technique has to be used as well when a leading combinator is used // as such selectors are not recognized by querySelectorAll. // Thanks to Andrew Dupont for this technique. if ( nodeType === 1 && ( rdescend.test( selector ) || rcombinators.test( selector ) ) ) { // Expand context for sibling selectors newContext = rsibling.test( selector ) && testContext( context.parentNode ) || context; // We can use :scope instead of the ID hack if the browser // supports it & if we're not changing the context. if ( newContext !== context || !support.scope ) { // Capture the context ID, setting it first if necessary if ( ( nid = context.getAttribute( "id" ) ) ) { nid = nid.replace( rcssescape, fcssescape ); } else { context.setAttribute( "id", ( nid = expando ) ); } } // Prefix every selector in the list groups = tokenize( selector ); i = groups.length; while ( i-- ) { groups[ i ] = ( nid ? "#" + nid : ":scope" ) + " " + toSelector( groups[ i ] ); } newSelector = groups.join( "," ); } try { push.apply( results, newContext.querySelectorAll( newSelector ) ); return results; } catch ( qsaError ) { nonnativeSelectorCache( selector, true ); } finally { if ( nid === expando ) { context.removeAttribute( "id" ); } } } } } // All others return select( selector.replace( rtrim, "$1" ), context, results, seed ); } /** * Create key-value caches of limited size * @returns {function(string, object)} Returns the Object data after storing it on itself with * property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) * deleting the oldest entry */ function createCache() { var keys = []; function cache( key, value ) { // Use (key + " ") to avoid collision with native prototype properties (see Issue #157) if ( keys.push( key + " " ) > Expr.cacheLength ) { // Only keep the most recent entries delete cache[ keys.shift() ]; } return ( cache[ key + " " ] = value ); } return cache; } /** * Mark a function for special use by Sizzle * @param {Function} fn The function to mark */ function markFunction( fn ) { fn[ expando ] = true; return fn; } /** * Support testing using an element * @param {Function} fn Passed the created element and returns a boolean result */ function assert( fn ) { var el = document.createElement( "fieldset" ); try { return !!fn( el ); } catch ( e ) { return false; } finally { // Remove from its parent by default if ( el.parentNode ) { el.parentNode.removeChild( el ); } // release memory in IE el = null; } } /** * Adds the same handler for all of the specified attrs * @param {String} attrs Pipe-separated list of attributes * @param {Function} handler The method that will be applied */ function addHandle( attrs, handler ) { var arr = attrs.split( "|" ), i = arr.length; while ( i-- ) { Expr.attrHandle[ arr[ i ] ] = handler; } } /** * Checks document order of two siblings * @param {Element} a * @param {Element} b * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b */ function siblingCheck( a, b ) { var cur = b && a, diff = cur && a.nodeType === 1 && b.nodeType === 1 && a.sourceIndex - b.sourceIndex; // Use IE sourceIndex if available on both nodes if ( diff ) { return diff; } // Check if b follows a if ( cur ) { while ( ( cur = cur.nextSibling ) ) { if ( cur === b ) { return -1; } } } return a ? 1 : -1; } /** * Returns a function to use in pseudos for input types * @param {String} type */ function createInputPseudo( type ) { return function( elem ) { var name = elem.nodeName.toLowerCase(); return name === "input" && elem.type === type; }; } /** * Returns a function to use in pseudos for buttons * @param {String} type */ function createButtonPseudo( type ) { return function( elem ) { var name = elem.nodeName.toLowerCase(); return ( name === "input" || name === "button" ) && elem.type === type; }; } /** * Returns a function to use in pseudos for :enabled/:disabled * @param {Boolean} disabled true for :disabled; false for :enabled */ function createDisabledPseudo( disabled ) { // Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable return function( elem ) { // Only certain elements can match :enabled or :disabled // https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled // https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled if ( "form" in elem ) { // Check for inherited disabledness on relevant non-disabled elements: // * listed form-associated elements in a disabled fieldset // https://html.spec.whatwg.org/multipage/forms.html#category-listed // https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled // * option elements in a disabled optgroup // https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled // All such elements have a "form" property. if ( elem.parentNode && elem.disabled === false ) { // Option elements defer to a parent optgroup if present if ( "label" in elem ) { if ( "label" in elem.parentNode ) { return elem.parentNode.disabled === disabled; } else { return elem.disabled === disabled; } } // Support: IE 6 - 11 // Use the isDisabled shortcut property to check for disabled fieldset ancestors return elem.isDisabled === disabled || // Where there is no isDisabled, check manually /* jshint -W018 */ elem.isDisabled !== !disabled && inDisabledFieldset( elem ) === disabled; } return elem.disabled === disabled; // Try to winnow out elements that can't be disabled before trusting the disabled property. // Some victims get caught in our net (label, legend, menu, track), but it shouldn't // even exist on them, let alone have a boolean value. } else if ( "label" in elem ) { return elem.disabled === disabled; } // Remaining elements are neither :enabled nor :disabled return false; }; } /** * Returns a function to use in pseudos for positionals * @param {Function} fn */ function createPositionalPseudo( fn ) { return markFunction( function( argument ) { argument = +argument; return markFunction( function( seed, matches ) { var j, matchIndexes = fn( [], seed.length, argument ), i = matchIndexes.length; // Match elements found at the specified indexes while ( i-- ) { if ( seed[ ( j = matchIndexes[ i ] ) ] ) { seed[ j ] = !( matches[ j ] = seed[ j ] ); } } } ); } ); } /** * Checks a node for validity as a Sizzle context * @param {Element|Object=} context * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value */ function testContext( context ) { return context && typeof context.getElementsByTagName !== "undefined" && context; } // Expose support vars for convenience support = Sizzle.support = {}; /** * Detects XML nodes * @param {Element|Object} elem An element or a document * @returns {Boolean} True iff elem is a non-HTML XML node */ isXML = Sizzle.isXML = function( elem ) { var namespace = elem.namespaceURI, docElem = ( elem.ownerDocument || elem ).documentElement; // Support: IE <=8 // Assume HTML when documentElement doesn't yet exist, such as inside loading iframes // https://bugs.jquery.com/ticket/4833 return !rhtml.test( namespace || docElem && docElem.nodeName || "HTML" ); }; /** * Sets document-related variables once based on the current document * @param {Element|Object} [doc] An element or document object to use to set the document * @returns {Object} Returns the current document */ setDocument = Sizzle.setDocument = function( node ) { var hasCompare, subWindow, doc = node ? node.ownerDocument || node : preferredDoc; // Return early if doc is invalid or already selected // Support: IE 11+, Edge 17 - 18+ // IE/Edge sometimes throw a "Permission denied" error when strict-comparing // two documents; shallow comparisons work. // eslint-disable-next-line eqeqeq if ( doc == document || doc.nodeType !== 9 || !doc.documentElement ) { return document; } // Update global variables document = doc; docElem = document.documentElement; documentIsHTML = !isXML( document ); // Support: IE 9 - 11+, Edge 12 - 18+ // Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936) // Support: IE 11+, Edge 17 - 18+ // IE/Edge sometimes throw a "Permission denied" error when strict-comparing // two documents; shallow comparisons work. // eslint-disable-next-line eqeqeq if ( preferredDoc != document && ( subWindow = document.defaultView ) && subWindow.top !== subWindow ) { // Support: IE 11, Edge if ( subWindow.addEventListener ) { subWindow.addEventListener( "unload", unloadHandler, false ); // Support: IE 9 - 10 only } else if ( subWindow.attachEvent ) { subWindow.attachEvent( "onunload", unloadHandler ); } } // Support: IE 8 - 11+, Edge 12 - 18+, Chrome <=16 - 25 only, Firefox <=3.6 - 31 only, // Safari 4 - 5 only, Opera <=11.6 - 12.x only // IE/Edge & older browsers don't support the :scope pseudo-class. // Support: Safari 6.0 only // Safari 6.0 supports :scope but it's an alias of :root there. support.scope = assert( function( el ) { docElem.appendChild( el ).appendChild( document.createElement( "div" ) ); return typeof el.querySelectorAll !== "undefined" && !el.querySelectorAll( ":scope fieldset div" ).length; } ); /* Attributes ---------------------------------------------------------------------- */ // Support: IE<8 // Verify that getAttribute really returns attributes and not properties // (excepting IE8 booleans) support.attributes = assert( function( el ) { el.className = "i"; return !el.getAttribute( "className" ); } ); /* getElement(s)By* ---------------------------------------------------------------------- */ // Check if getElementsByTagName("*") returns only elements support.getElementsByTagName = assert( function( el ) { el.appendChild( document.createComment( "" ) ); return !el.getElementsByTagName( "*" ).length; } ); // Support: IE<9 support.getElementsByClassName = rnative.test( document.getElementsByClassName ); // Support: IE<10 // Check if getElementById returns elements by name // The broken getElementById methods don't pick up programmatically-set names, // so use a roundabout getElementsByName test support.getById = assert( function( el ) { docElem.appendChild( el ).id = expando; return !document.getElementsByName || !document.getElementsByName( expando ).length; } ); // ID filter and find if ( support.getById ) { Expr.filter[ "ID" ] = function( id ) { var attrId = id.replace( runescape, funescape ); return function( elem ) { return elem.getAttribute( "id" ) === attrId; }; }; Expr.find[ "ID" ] = function( id, context ) { if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { var elem = context.getElementById( id ); return elem ? [ elem ] : []; } }; } else { Expr.filter[ "ID" ] = function( id ) { var attrId = id.replace( runescape, funescape ); return function( elem ) { var node = typeof elem.getAttributeNode !== "undefined" && elem.getAttributeNode( "id" ); return node && node.value === attrId; }; }; // Support: IE 6 - 7 only // getElementById is not reliable as a find shortcut Expr.find[ "ID" ] = function( id, context ) { if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { var node, i, elems, elem = context.getElementById( id ); if ( elem ) { // Verify the id attribute node = elem.getAttributeNode( "id" ); if ( node && node.value === id ) { return [ elem ]; } // Fall back on getElementsByName elems = context.getElementsByName( id ); i = 0; while ( ( elem = elems[ i++ ] ) ) { node = elem.getAttributeNode( "id" ); if ( node && node.value === id ) { return [ elem ]; } } } return []; } }; } // Tag Expr.find[ "TAG" ] = support.getElementsByTagName ? function( tag, context ) { if ( typeof context.getElementsByTagName !== "undefined" ) { return context.getElementsByTagName( tag ); // DocumentFragment nodes don't have gEBTN } else if ( support.qsa ) { return context.querySelectorAll( tag ); } } : function( tag, context ) { var elem, tmp = [], i = 0, // By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too results = context.getElementsByTagName( tag ); // Filter out possible comments if ( tag === "*" ) { while ( ( elem = results[ i++ ] ) ) { if ( elem.nodeType === 1 ) { tmp.push( elem ); } } return tmp; } return results; }; // Class Expr.find[ "CLASS" ] = support.getElementsByClassName && function( className, context ) { if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) { return context.getElementsByClassName( className ); } }; /* QSA/matchesSelector ---------------------------------------------------------------------- */ // QSA and matchesSelector support // matchesSelector(:active) reports false when true (IE9/Opera 11.5) rbuggyMatches = []; // qSa(:focus) reports false when true (Chrome 21) // We allow this because of a bug in IE8/9 that throws an error // whenever `document.activeElement` is accessed on an iframe // So, we allow :focus to pass through QSA all the time to avoid the IE error // See https://bugs.jquery.com/ticket/13378 rbuggyQSA = []; if ( ( support.qsa = rnative.test( document.querySelectorAll ) ) ) { // Build QSA regex // Regex strategy adopted from Diego Perini assert( function( el ) { var input; // Select is set to empty string on purpose // This is to test IE's treatment of not explicitly // setting a boolean content attribute, // since its presence should be enough // https://bugs.jquery.com/ticket/12359 docElem.appendChild( el ).innerHTML = "" + ""; // Support: IE8, Opera 11-12.16 // Nothing should be selected when empty strings follow ^= or $= or *= // The test attribute must be unknown in Opera but "safe" for WinRT // https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section if ( el.querySelectorAll( "[msallowcapture^='']" ).length ) { rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); } // Support: IE8 // Boolean attributes and "value" are not treated correctly if ( !el.querySelectorAll( "[selected]" ).length ) { rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); } // Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+ if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) { rbuggyQSA.push( "~=" ); } // Support: IE 11+, Edge 15 - 18+ // IE 11/Edge don't find elements on a `[name='']` query in some cases. // Adding a temporary attribute to the document before the selection works // around the issue. // Interestingly, IE 10 & older don't seem to have the issue. input = document.createElement( "input" ); input.setAttribute( "name", "" ); el.appendChild( input ); if ( !el.querySelectorAll( "[name='']" ).length ) { rbuggyQSA.push( "\\[" + whitespace + "*name" + whitespace + "*=" + whitespace + "*(?:''|\"\")" ); } // Webkit/Opera - :checked should return selected option elements // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked // IE8 throws error here and will not see later tests if ( !el.querySelectorAll( ":checked" ).length ) { rbuggyQSA.push( ":checked" ); } // Support: Safari 8+, iOS 8+ // https://bugs.webkit.org/show_bug.cgi?id=136851 // In-page `selector#id sibling-combinator selector` fails if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) { rbuggyQSA.push( ".#.+[+~]" ); } // Support: Firefox <=3.6 - 5 only // Old Firefox doesn't throw on a badly-escaped identifier. el.querySelectorAll( "\\\f" ); rbuggyQSA.push( "[\\r\\n\\f]" ); } ); assert( function( el ) { el.innerHTML = "" + ""; // Support: Windows 8 Native Apps // The type and name attributes are restricted during .innerHTML assignment var input = document.createElement( "input" ); input.setAttribute( "type", "hidden" ); el.appendChild( input ).setAttribute( "name", "D" ); // Support: IE8 // Enforce case-sensitivity of name attribute if ( el.querySelectorAll( "[name=d]" ).length ) { rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" ); } // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) // IE8 throws error here and will not see later tests if ( el.querySelectorAll( ":enabled" ).length !== 2 ) { rbuggyQSA.push( ":enabled", ":disabled" ); } // Support: IE9-11+ // IE's :disabled selector does not pick up the children of disabled fieldsets docElem.appendChild( el ).disabled = true; if ( el.querySelectorAll( ":disabled" ).length !== 2 ) { rbuggyQSA.push( ":enabled", ":disabled" ); } // Support: Opera 10 - 11 only // Opera 10-11 does not throw on post-comma invalid pseudos el.querySelectorAll( "*,:x" ); rbuggyQSA.push( ",.*:" ); } ); } if ( ( support.matchesSelector = rnative.test( ( matches = docElem.matches || docElem.webkitMatchesSelector || docElem.mozMatchesSelector || docElem.oMatchesSelector || docElem.msMatchesSelector ) ) ) ) { assert( function( el ) { // Check to see if it's possible to do matchesSelector // on a disconnected node (IE 9) support.disconnectedMatch = matches.call( el, "*" ); // This should fail with an exception // Gecko does not error, returns false instead matches.call( el, "[s!='']:x" ); rbuggyMatches.push( "!=", pseudos ); } ); } rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join( "|" ) ); rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join( "|" ) ); /* Contains ---------------------------------------------------------------------- */ hasCompare = rnative.test( docElem.compareDocumentPosition ); // Element contains another // Purposefully self-exclusive // As in, an element does not contain itself contains = hasCompare || rnative.test( docElem.contains ) ? function( a, b ) { var adown = a.nodeType === 9 ? a.documentElement : a, bup = b && b.parentNode; return a === bup || !!( bup && bup.nodeType === 1 && ( adown.contains ? adown.contains( bup ) : a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 ) ); } : function( a, b ) { if ( b ) { while ( ( b = b.parentNode ) ) { if ( b === a ) { return true; } } } return false; }; /* Sorting ---------------------------------------------------------------------- */ // Document order sorting sortOrder = hasCompare ? function( a, b ) { // Flag for duplicate removal if ( a === b ) { hasDuplicate = true; return 0; } // Sort on method existence if only one input has compareDocumentPosition var compare = !a.compareDocumentPosition - !b.compareDocumentPosition; if ( compare ) { return compare; } // Calculate position if both inputs belong to the same document // Support: IE 11+, Edge 17 - 18+ // IE/Edge sometimes throw a "Permission denied" error when strict-comparing // two documents; shallow comparisons work. // eslint-disable-next-line eqeqeq compare = ( a.ownerDocument || a ) == ( b.ownerDocument || b ) ? a.compareDocumentPosition( b ) : // Otherwise we know they are disconnected 1; // Disconnected nodes if ( compare & 1 || ( !support.sortDetached && b.compareDocumentPosition( a ) === compare ) ) { // Choose the first element that is related to our preferred document // Support: IE 11+, Edge 17 - 18+ // IE/Edge sometimes throw a "Permission denied" error when strict-comparing // two documents; shallow comparisons work. // eslint-disable-next-line eqeqeq if ( a == document || a.ownerDocument == preferredDoc && contains( preferredDoc, a ) ) { return -1; } // Support: IE 11+, Edge 17 - 18+ // IE/Edge sometimes throw a "Permission denied" error when strict-comparing // two documents; shallow comparisons work. // eslint-disable-next-line eqeqeq if ( b == document || b.ownerDocument == preferredDoc && contains( preferredDoc, b ) ) { return 1; } // Maintain original order return sortInput ? ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : 0; } return compare & 4 ? -1 : 1; } : function( a, b ) { // Exit early if the nodes are identical if ( a === b ) { hasDuplicate = true; return 0; } var cur, i = 0, aup = a.parentNode, bup = b.parentNode, ap = [ a ], bp = [ b ]; // Parentless nodes are either documents or disconnected if ( !aup || !bup ) { // Support: IE 11+, Edge 17 - 18+ // IE/Edge sometimes throw a "Permission denied" error when strict-comparing // two documents; shallow comparisons work. /* eslint-disable eqeqeq */ return a == document ? -1 : b == document ? 1 : /* eslint-enable eqeqeq */ aup ? -1 : bup ? 1 : sortInput ? ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : 0; // If the nodes are siblings, we can do a quick check } else if ( aup === bup ) { return siblingCheck( a, b ); } // Otherwise we need full lists of their ancestors for comparison cur = a; while ( ( cur = cur.parentNode ) ) { ap.unshift( cur ); } cur = b; while ( ( cur = cur.parentNode ) ) { bp.unshift( cur ); } // Walk down the tree looking for a discrepancy while ( ap[ i ] === bp[ i ] ) { i++; } return i ? // Do a sibling check if the nodes have a common ancestor siblingCheck( ap[ i ], bp[ i ] ) : // Otherwise nodes in our document sort first // Support: IE 11+, Edge 17 - 18+ // IE/Edge sometimes throw a "Permission denied" error when strict-comparing // two documents; shallow comparisons work. /* eslint-disable eqeqeq */ ap[ i ] == preferredDoc ? -1 : bp[ i ] == preferredDoc ? 1 : /* eslint-enable eqeqeq */ 0; }; return document; }; Sizzle.matches = function( expr, elements ) { return Sizzle( expr, null, null, elements ); }; Sizzle.matchesSelector = function( elem, expr ) { setDocument( elem ); if ( support.matchesSelector && documentIsHTML && !nonnativeSelectorCache[ expr + " " ] && ( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && ( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { try { var ret = matches.call( elem, expr ); // IE 9's matchesSelector returns false on disconnected nodes if ( ret || support.disconnectedMatch || // As well, disconnected nodes are said to be in a document // fragment in IE 9 elem.document && elem.document.nodeType !== 11 ) { return ret; } } catch ( e ) { nonnativeSelectorCache( expr, true ); } } return Sizzle( expr, document, null, [ elem ] ).length > 0; }; Sizzle.contains = function( context, elem ) { // Set document vars if needed // Support: IE 11+, Edge 17 - 18+ // IE/Edge sometimes throw a "Permission denied" error when strict-comparing // two documents; shallow comparisons work. // eslint-disable-next-line eqeqeq if ( ( context.ownerDocument || context ) != document ) { setDocument( context ); } return contains( context, elem ); }; Sizzle.attr = function( elem, name ) { // Set document vars if needed // Support: IE 11+, Edge 17 - 18+ // IE/Edge sometimes throw a "Permission denied" error when strict-comparing // two documents; shallow comparisons work. // eslint-disable-next-line eqeqeq if ( ( elem.ownerDocument || elem ) != document ) { setDocument( elem ); } var fn = Expr.attrHandle[ name.toLowerCase() ], // Don't get fooled by Object.prototype properties (jQuery #13807) val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? fn( elem, name, !documentIsHTML ) : undefined; return val !== undefined ? val : support.attributes || !documentIsHTML ? elem.getAttribute( name ) : ( val = elem.getAttributeNode( name ) ) && val.specified ? val.value : null; }; Sizzle.escape = function( sel ) { return ( sel + "" ).replace( rcssescape, fcssescape ); }; Sizzle.error = function( msg ) { throw new Error( "Syntax error, unrecognized expression: " + msg ); }; /** * Document sorting and removing duplicates * @param {ArrayLike} results */ Sizzle.uniqueSort = function( results ) { var elem, duplicates = [], j = 0, i = 0; // Unless we *know* we can detect duplicates, assume their presence hasDuplicate = !support.detectDuplicates; sortInput = !support.sortStable && results.slice( 0 ); results.sort( sortOrder ); if ( hasDuplicate ) { while ( ( elem = results[ i++ ] ) ) { if ( elem === results[ i ] ) { j = duplicates.push( i ); } } while ( j-- ) { results.splice( duplicates[ j ], 1 ); } } // Clear input after sorting to release objects // See https://github.com/jquery/sizzle/pull/225 sortInput = null; return results; }; /** * Utility function for retrieving the text value of an array of DOM nodes * @param {Array|Element} elem */ getText = Sizzle.getText = function( elem ) { var node, ret = "", i = 0, nodeType = elem.nodeType; if ( !nodeType ) { // If no nodeType, this is expected to be an array while ( ( node = elem[ i++ ] ) ) { // Do not traverse comment nodes ret += getText( node ); } } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { // Use textContent for elements // innerText usage removed for consistency of new lines (jQuery #11153) if ( typeof elem.textContent === "string" ) { return elem.textContent; } else { // Traverse its children for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { ret += getText( elem ); } } } else if ( nodeType === 3 || nodeType === 4 ) { return elem.nodeValue; } // Do not include comment or processing instruction nodes return ret; }; Expr = Sizzle.selectors = { // Can be adjusted by the user cacheLength: 50, createPseudo: markFunction, match: matchExpr, attrHandle: {}, find: {}, relative: { ">": { dir: "parentNode", first: true }, " ": { dir: "parentNode" }, "+": { dir: "previousSibling", first: true }, "~": { dir: "previousSibling" } }, preFilter: { "ATTR": function( match ) { match[ 1 ] = match[ 1 ].replace( runescape, funescape ); // Move the given value to match[3] whether quoted or unquoted match[ 3 ] = ( match[ 3 ] || match[ 4 ] || match[ 5 ] || "" ).replace( runescape, funescape ); if ( match[ 2 ] === "~=" ) { match[ 3 ] = " " + match[ 3 ] + " "; } return match.slice( 0, 4 ); }, "CHILD": function( match ) { /* matches from matchExpr["CHILD"] 1 type (only|nth|...) 2 what (child|of-type) 3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) 4 xn-component of xn+y argument ([+-]?\d*n|) 5 sign of xn-component 6 x of xn-component 7 sign of y-component 8 y of y-component */ match[ 1 ] = match[ 1 ].toLowerCase(); if ( match[ 1 ].slice( 0, 3 ) === "nth" ) { // nth-* requires argument if ( !match[ 3 ] ) { Sizzle.error( match[ 0 ] ); } // numeric x and y parameters for Expr.filter.CHILD // remember that false/true cast respectively to 0/1 match[ 4 ] = +( match[ 4 ] ? match[ 5 ] + ( match[ 6 ] || 1 ) : 2 * ( match[ 3 ] === "even" || match[ 3 ] === "odd" ) ); match[ 5 ] = +( ( match[ 7 ] + match[ 8 ] ) || match[ 3 ] === "odd" ); // other types prohibit arguments } else if ( match[ 3 ] ) { Sizzle.error( match[ 0 ] ); } return match; }, "PSEUDO": function( match ) { var excess, unquoted = !match[ 6 ] && match[ 2 ]; if ( matchExpr[ "CHILD" ].test( match[ 0 ] ) ) { return null; } // Accept quoted arguments as-is if ( match[ 3 ] ) { match[ 2 ] = match[ 4 ] || match[ 5 ] || ""; // Strip excess characters from unquoted arguments } else if ( unquoted && rpseudo.test( unquoted ) && // Get excess from tokenize (recursively) ( excess = tokenize( unquoted, true ) ) && // advance to the next closing parenthesis ( excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length ) ) { // excess is a negative index match[ 0 ] = match[ 0 ].slice( 0, excess ); match[ 2 ] = unquoted.slice( 0, excess ); } // Return only captures needed by the pseudo filter method (type and argument) return match.slice( 0, 3 ); } }, filter: { "TAG": function( nodeNameSelector ) { var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); return nodeNameSelector === "*" ? function() { return true; } : function( elem ) { return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; }; }, "CLASS": function( className ) { var pattern = classCache[ className + " " ]; return pattern || ( pattern = new RegExp( "(^|" + whitespace + ")" + className + "(" + whitespace + "|$)" ) ) && classCache( className, function( elem ) { return pattern.test( typeof elem.className === "string" && elem.className || typeof elem.getAttribute !== "undefined" && elem.getAttribute( "class" ) || "" ); } ); }, "ATTR": function( name, operator, check ) { return function( elem ) { var result = Sizzle.attr( elem, name ); if ( result == null ) { return operator === "!="; } if ( !operator ) { return true; } result += ""; /* eslint-disable max-len */ return operator === "=" ? result === check : operator === "!=" ? result !== check : operator === "^=" ? check && result.indexOf( check ) === 0 : operator === "*=" ? check && result.indexOf( check ) > -1 : operator === "$=" ? check && result.slice( -check.length ) === check : operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 : operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : false; /* eslint-enable max-len */ }; }, "CHILD": function( type, what, _argument, first, last ) { var simple = type.slice( 0, 3 ) !== "nth", forward = type.slice( -4 ) !== "last", ofType = what === "of-type"; return first === 1 && last === 0 ? // Shortcut for :nth-*(n) function( elem ) { return !!elem.parentNode; } : function( elem, _context, xml ) { var cache, uniqueCache, outerCache, node, nodeIndex, start, dir = simple !== forward ? "nextSibling" : "previousSibling", parent = elem.parentNode, name = ofType && elem.nodeName.toLowerCase(), useCache = !xml && !ofType, diff = false; if ( parent ) { // :(first|last|only)-(child|of-type) if ( simple ) { while ( dir ) { node = elem; while ( ( node = node[ dir ] ) ) { if ( ofType ? node.nodeName.toLowerCase() === name : node.nodeType === 1 ) { return false; } } // Reverse direction for :only-* (if we haven't yet done so) start = dir = type === "only" && !start && "nextSibling"; } return true; } start = [ forward ? parent.firstChild : parent.lastChild ]; // non-xml :nth-child(...) stores cache data on `parent` if ( forward && useCache ) { // Seek `elem` from a previously-cached index // ...in a gzip-friendly way node = parent; outerCache = node[ expando ] || ( node[ expando ] = {} ); // Support: IE <9 only // Defend against cloned attroperties (jQuery gh-1709) uniqueCache = outerCache[ node.uniqueID ] || ( outerCache[ node.uniqueID ] = {} ); cache = uniqueCache[ type ] || []; nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; diff = nodeIndex && cache[ 2 ]; node = nodeIndex && parent.childNodes[ nodeIndex ]; while ( ( node = ++nodeIndex && node && node[ dir ] || // Fallback to seeking `elem` from the start ( diff = nodeIndex = 0 ) || start.pop() ) ) { // When found, cache indexes on `parent` and break if ( node.nodeType === 1 && ++diff && node === elem ) { uniqueCache[ type ] = [ dirruns, nodeIndex, diff ]; break; } } } else { // Use previously-cached element index if available if ( useCache ) { // ...in a gzip-friendly way node = elem; outerCache = node[ expando ] || ( node[ expando ] = {} ); // Support: IE <9 only // Defend against cloned attroperties (jQuery gh-1709) uniqueCache = outerCache[ node.uniqueID ] || ( outerCache[ node.uniqueID ] = {} ); cache = uniqueCache[ type ] || []; nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; diff = nodeIndex; } // xml :nth-child(...) // or :nth-last-child(...) or :nth(-last)?-of-type(...) if ( diff === false ) { // Use the same loop as above to seek `elem` from the start while ( ( node = ++nodeIndex && node && node[ dir ] || ( diff = nodeIndex = 0 ) || start.pop() ) ) { if ( ( ofType ? node.nodeName.toLowerCase() === name : node.nodeType === 1 ) && ++diff ) { // Cache the index of each encountered element if ( useCache ) { outerCache = node[ expando ] || ( node[ expando ] = {} ); // Support: IE <9 only // Defend against cloned attroperties (jQuery gh-1709) uniqueCache = outerCache[ node.uniqueID ] || ( outerCache[ node.uniqueID ] = {} ); uniqueCache[ type ] = [ dirruns, diff ]; } if ( node === elem ) { break; } } } } } // Incorporate the offset, then check against cycle size diff -= last; return diff === first || ( diff % first === 0 && diff / first >= 0 ); } }; }, "PSEUDO": function( pseudo, argument ) { // pseudo-class names are case-insensitive // http://www.w3.org/TR/selectors/#pseudo-classes // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters // Remember that setFilters inherits from pseudos var args, fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || Sizzle.error( "unsupported pseudo: " + pseudo ); // The user may use createPseudo to indicate that // arguments are needed to create the filter function // just as Sizzle does if ( fn[ expando ] ) { return fn( argument ); } // But maintain support for old signatures if ( fn.length > 1 ) { args = [ pseudo, pseudo, "", argument ]; return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? markFunction( function( seed, matches ) { var idx, matched = fn( seed, argument ), i = matched.length; while ( i-- ) { idx = indexOf( seed, matched[ i ] ); seed[ idx ] = !( matches[ idx ] = matched[ i ] ); } } ) : function( elem ) { return fn( elem, 0, args ); }; } return fn; } }, pseudos: { // Potentially complex pseudos "not": markFunction( function( selector ) { // Trim the selector passed to compile // to avoid treating leading and trailing // spaces as combinators var input = [], results = [], matcher = compile( selector.replace( rtrim, "$1" ) ); return matcher[ expando ] ? markFunction( function( seed, matches, _context, xml ) { var elem, unmatched = matcher( seed, null, xml, [] ), i = seed.length; // Match elements unmatched by `matcher` while ( i-- ) { if ( ( elem = unmatched[ i ] ) ) { seed[ i ] = !( matches[ i ] = elem ); } } } ) : function( elem, _context, xml ) { input[ 0 ] = elem; matcher( input, null, xml, results ); // Don't keep the element (issue #299) input[ 0 ] = null; return !results.pop(); }; } ), "has": markFunction( function( selector ) { return function( elem ) { return Sizzle( selector, elem ).length > 0; }; } ), "contains": markFunction( function( text ) { text = text.replace( runescape, funescape ); return function( elem ) { return ( elem.textContent || getText( elem ) ).indexOf( text ) > -1; }; } ), // "Whether an element is represented by a :lang() selector // is based solely on the element's language value // being equal to the identifier C, // or beginning with the identifier C immediately followed by "-". // The matching of C against the element's language value is performed case-insensitively. // The identifier C does not have to be a valid language name." // http://www.w3.org/TR/selectors/#lang-pseudo "lang": markFunction( function( lang ) { // lang value must be a valid identifier if ( !ridentifier.test( lang || "" ) ) { Sizzle.error( "unsupported lang: " + lang ); } lang = lang.replace( runescape, funescape ).toLowerCase(); return function( elem ) { var elemLang; do { if ( ( elemLang = documentIsHTML ? elem.lang : elem.getAttribute( "xml:lang" ) || elem.getAttribute( "lang" ) ) ) { elemLang = elemLang.toLowerCase(); return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; } } while ( ( elem = elem.parentNode ) && elem.nodeType === 1 ); return false; }; } ), // Miscellaneous "target": function( elem ) { var hash = window.location && window.location.hash; return hash && hash.slice( 1 ) === elem.id; }, "root": function( elem ) { return elem === docElem; }, "focus": function( elem ) { return elem === document.activeElement && ( !document.hasFocus || document.hasFocus() ) && !!( elem.type || elem.href || ~elem.tabIndex ); }, // Boolean properties "enabled": createDisabledPseudo( false ), "disabled": createDisabledPseudo( true ), "checked": function( elem ) { // In CSS3, :checked should return both checked and selected elements // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked var nodeName = elem.nodeName.toLowerCase(); return ( nodeName === "input" && !!elem.checked ) || ( nodeName === "option" && !!elem.selected ); }, "selected": function( elem ) { // Accessing this property makes selected-by-default // options in Safari work properly if ( elem.parentNode ) { // eslint-disable-next-line no-unused-expressions elem.parentNode.selectedIndex; } return elem.selected === true; }, // Contents "empty": function( elem ) { // http://www.w3.org/TR/selectors/#empty-pseudo // :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5), // but not by others (comment: 8; processing instruction: 7; etc.) // nodeType < 6 works because attributes (2) do not appear as children for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { if ( elem.nodeType < 6 ) { return false; } } return true; }, "parent": function( elem ) { return !Expr.pseudos[ "empty" ]( elem ); }, // Element/input types "header": function( elem ) { return rheader.test( elem.nodeName ); }, "input": function( elem ) { return rinputs.test( elem.nodeName ); }, "button": function( elem ) { var name = elem.nodeName.toLowerCase(); return name === "input" && elem.type === "button" || name === "button"; }, "text": function( elem ) { var attr; return elem.nodeName.toLowerCase() === "input" && elem.type === "text" && // Support: IE<8 // New HTML5 attribute values (e.g., "search") appear with elem.type === "text" ( ( attr = elem.getAttribute( "type" ) ) == null || attr.toLowerCase() === "text" ); }, // Position-in-collection "first": createPositionalPseudo( function() { return [ 0 ]; } ), "last": createPositionalPseudo( function( _matchIndexes, length ) { return [ length - 1 ]; } ), "eq": createPositionalPseudo( function( _matchIndexes, length, argument ) { return [ argument < 0 ? argument + length : argument ]; } ), "even": createPositionalPseudo( function( matchIndexes, length ) { var i = 0; for ( ; i < length; i += 2 ) { matchIndexes.push( i ); } return matchIndexes; } ), "odd": createPositionalPseudo( function( matchIndexes, length ) { var i = 1; for ( ; i < length; i += 2 ) { matchIndexes.push( i ); } return matchIndexes; } ), "lt": createPositionalPseudo( function( matchIndexes, length, argument ) { var i = argument < 0 ? argument + length : argument > length ? length : argument; for ( ; --i >= 0; ) { matchIndexes.push( i ); } return matchIndexes; } ), "gt": createPositionalPseudo( function( matchIndexes, length, argument ) { var i = argument < 0 ? argument + length : argument; for ( ; ++i < length; ) { matchIndexes.push( i ); } return matchIndexes; } ) } }; Expr.pseudos[ "nth" ] = Expr.pseudos[ "eq" ]; // Add button/input type pseudos for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { Expr.pseudos[ i ] = createInputPseudo( i ); } for ( i in { submit: true, reset: true } ) { Expr.pseudos[ i ] = createButtonPseudo( i ); } // Easy API for creating new setFilters function setFilters() {} setFilters.prototype = Expr.filters = Expr.pseudos; Expr.setFilters = new setFilters(); tokenize = Sizzle.tokenize = function( selector, parseOnly ) { var matched, match, tokens, type, soFar, groups, preFilters, cached = tokenCache[ selector + " " ]; if ( cached ) { return parseOnly ? 0 : cached.slice( 0 ); } soFar = selector; groups = []; preFilters = Expr.preFilter; while ( soFar ) { // Comma and first run if ( !matched || ( match = rcomma.exec( soFar ) ) ) { if ( match ) { // Don't consume trailing commas as valid soFar = soFar.slice( match[ 0 ].length ) || soFar; } groups.push( ( tokens = [] ) ); } matched = false; // Combinators if ( ( match = rcombinators.exec( soFar ) ) ) { matched = match.shift(); tokens.push( { value: matched, // Cast descendant combinators to space type: match[ 0 ].replace( rtrim, " " ) } ); soFar = soFar.slice( matched.length ); } // Filters for ( type in Expr.filter ) { if ( ( match = matchExpr[ type ].exec( soFar ) ) && ( !preFilters[ type ] || ( match = preFilters[ type ]( match ) ) ) ) { matched = match.shift(); tokens.push( { value: matched, type: type, matches: match } ); soFar = soFar.slice( matched.length ); } } if ( !matched ) { break; } } // Return the length of the invalid excess // if we're just parsing // Otherwise, throw an error or return tokens return parseOnly ? soFar.length : soFar ? Sizzle.error( selector ) : // Cache the tokens tokenCache( selector, groups ).slice( 0 ); }; function toSelector( tokens ) { var i = 0, len = tokens.length, selector = ""; for ( ; i < len; i++ ) { selector += tokens[ i ].value; } return selector; } function addCombinator( matcher, combinator, base ) { var dir = combinator.dir, skip = combinator.next, key = skip || dir, checkNonElements = base && key === "parentNode", doneName = done++; return combinator.first ? // Check against closest ancestor/preceding element function( elem, context, xml ) { while ( ( elem = elem[ dir ] ) ) { if ( elem.nodeType === 1 || checkNonElements ) { return matcher( elem, context, xml ); } } return false; } : // Check against all ancestor/preceding elements function( elem, context, xml ) { var oldCache, uniqueCache, outerCache, newCache = [ dirruns, doneName ]; // We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching if ( xml ) { while ( ( elem = elem[ dir ] ) ) { if ( elem.nodeType === 1 || checkNonElements ) { if ( matcher( elem, context, xml ) ) { return true; } } } } else { while ( ( elem = elem[ dir ] ) ) { if ( elem.nodeType === 1 || checkNonElements ) { outerCache = elem[ expando ] || ( elem[ expando ] = {} ); // Support: IE <9 only // Defend against cloned attroperties (jQuery gh-1709) uniqueCache = outerCache[ elem.uniqueID ] || ( outerCache[ elem.uniqueID ] = {} ); if ( skip && skip === elem.nodeName.toLowerCase() ) { elem = elem[ dir ] || elem; } else if ( ( oldCache = uniqueCache[ key ] ) && oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) { // Assign to newCache so results back-propagate to previous elements return ( newCache[ 2 ] = oldCache[ 2 ] ); } else { // Reuse newcache so results back-propagate to previous elements uniqueCache[ key ] = newCache; // A match means we're done; a fail means we have to keep checking if ( ( newCache[ 2 ] = matcher( elem, context, xml ) ) ) { return true; } } } } } return false; }; } function elementMatcher( matchers ) { return matchers.length > 1 ? function( elem, context, xml ) { var i = matchers.length; while ( i-- ) { if ( !matchers[ i ]( elem, context, xml ) ) { return false; } } return true; } : matchers[ 0 ]; } function multipleContexts( selector, contexts, results ) { var i = 0, len = contexts.length; for ( ; i < len; i++ ) { Sizzle( selector, contexts[ i ], results ); } return results; } function condense( unmatched, map, filter, context, xml ) { var elem, newUnmatched = [], i = 0, len = unmatched.length, mapped = map != null; for ( ; i < len; i++ ) { if ( ( elem = unmatched[ i ] ) ) { if ( !filter || filter( elem, context, xml ) ) { newUnmatched.push( elem ); if ( mapped ) { map.push( i ); } } } } return newUnmatched; } function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { if ( postFilter && !postFilter[ expando ] ) { postFilter = setMatcher( postFilter ); } if ( postFinder && !postFinder[ expando ] ) { postFinder = setMatcher( postFinder, postSelector ); } return markFunction( function( seed, results, context, xml ) { var temp, i, elem, preMap = [], postMap = [], preexisting = results.length, // Get initial elements from seed or context elems = seed || multipleContexts( selector || "*", context.nodeType ? [ context ] : context, [] ), // Prefilter to get matcher input, preserving a map for seed-results synchronization matcherIn = preFilter && ( seed || !selector ) ? condense( elems, preMap, preFilter, context, xml ) : elems, matcherOut = matcher ? // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, postFinder || ( seed ? preFilter : preexisting || postFilter ) ? // ...intermediate processing is necessary [] : // ...otherwise use results directly results : matcherIn; // Find primary matches if ( matcher ) { matcher( matcherIn, matcherOut, context, xml ); } // Apply postFilter if ( postFilter ) { temp = condense( matcherOut, postMap ); postFilter( temp, [], context, xml ); // Un-match failing elements by moving them back to matcherIn i = temp.length; while ( i-- ) { if ( ( elem = temp[ i ] ) ) { matcherOut[ postMap[ i ] ] = !( matcherIn[ postMap[ i ] ] = elem ); } } } if ( seed ) { if ( postFinder || preFilter ) { if ( postFinder ) { // Get the final matcherOut by condensing this intermediate into postFinder contexts temp = []; i = matcherOut.length; while ( i-- ) { if ( ( elem = matcherOut[ i ] ) ) { // Restore matcherIn since elem is not yet a final match temp.push( ( matcherIn[ i ] = elem ) ); } } postFinder( null, ( matcherOut = [] ), temp, xml ); } // Move matched elements from seed to results to keep them synchronized i = matcherOut.length; while ( i-- ) { if ( ( elem = matcherOut[ i ] ) && ( temp = postFinder ? indexOf( seed, elem ) : preMap[ i ] ) > -1 ) { seed[ temp ] = !( results[ temp ] = elem ); } } } // Add elements to results, through postFinder if defined } else { matcherOut = condense( matcherOut === results ? matcherOut.splice( preexisting, matcherOut.length ) : matcherOut ); if ( postFinder ) { postFinder( null, results, matcherOut, xml ); } else { push.apply( results, matcherOut ); } } } ); } function matcherFromTokens( tokens ) { var checkContext, matcher, j, len = tokens.length, leadingRelative = Expr.relative[ tokens[ 0 ].type ], implicitRelative = leadingRelative || Expr.relative[ " " ], i = leadingRelative ? 1 : 0, // The foundational matcher ensures that elements are reachable from top-level context(s) matchContext = addCombinator( function( elem ) { return elem === checkContext; }, implicitRelative, true ), matchAnyContext = addCombinator( function( elem ) { return indexOf( checkContext, elem ) > -1; }, implicitRelative, true ), matchers = [ function( elem, context, xml ) { var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( ( checkContext = context ).nodeType ? matchContext( elem, context, xml ) : matchAnyContext( elem, context, xml ) ); // Avoid hanging onto element (issue #299) checkContext = null; return ret; } ]; for ( ; i < len; i++ ) { if ( ( matcher = Expr.relative[ tokens[ i ].type ] ) ) { matchers = [ addCombinator( elementMatcher( matchers ), matcher ) ]; } else { matcher = Expr.filter[ tokens[ i ].type ].apply( null, tokens[ i ].matches ); // Return special upon seeing a positional matcher if ( matcher[ expando ] ) { // Find the next relative operator (if any) for proper handling j = ++i; for ( ; j < len; j++ ) { if ( Expr.relative[ tokens[ j ].type ] ) { break; } } return setMatcher( i > 1 && elementMatcher( matchers ), i > 1 && toSelector( // If the preceding token was a descendant combinator, insert an implicit any-element `*` tokens .slice( 0, i - 1 ) .concat( { value: tokens[ i - 2 ].type === " " ? "*" : "" } ) ).replace( rtrim, "$1" ), matcher, i < j && matcherFromTokens( tokens.slice( i, j ) ), j < len && matcherFromTokens( ( tokens = tokens.slice( j ) ) ), j < len && toSelector( tokens ) ); } matchers.push( matcher ); } } return elementMatcher( matchers ); } function matcherFromGroupMatchers( elementMatchers, setMatchers ) { var bySet = setMatchers.length > 0, byElement = elementMatchers.length > 0, superMatcher = function( seed, context, xml, results, outermost ) { var elem, j, matcher, matchedCount = 0, i = "0", unmatched = seed && [], setMatched = [], contextBackup = outermostContext, // We must always have either seed elements or outermost context elems = seed || byElement && Expr.find[ "TAG" ]( "*", outermost ), // Use integer dirruns iff this is the outermost matcher dirrunsUnique = ( dirruns += contextBackup == null ? 1 : Math.random() || 0.1 ), len = elems.length; if ( outermost ) { // Support: IE 11+, Edge 17 - 18+ // IE/Edge sometimes throw a "Permission denied" error when strict-comparing // two documents; shallow comparisons work. // eslint-disable-next-line eqeqeq outermostContext = context == document || context || outermost; } // Add elements passing elementMatchers directly to results // Support: IE<9, Safari // Tolerate NodeList properties (IE: "length"; Safari: ) matching elements by id for ( ; i !== len && ( elem = elems[ i ] ) != null; i++ ) { if ( byElement && elem ) { j = 0; // Support: IE 11+, Edge 17 - 18+ // IE/Edge sometimes throw a "Permission denied" error when strict-comparing // two documents; shallow comparisons work. // eslint-disable-next-line eqeqeq if ( !context && elem.ownerDocument != document ) { setDocument( elem ); xml = !documentIsHTML; } while ( ( matcher = elementMatchers[ j++ ] ) ) { if ( matcher( elem, context || document, xml ) ) { results.push( elem ); break; } } if ( outermost ) { dirruns = dirrunsUnique; } } // Track unmatched elements for set filters if ( bySet ) { // They will have gone through all possible matchers if ( ( elem = !matcher && elem ) ) { matchedCount--; } // Lengthen the array for every element, matched or not if ( seed ) { unmatched.push( elem ); } } } // `i` is now the count of elements visited above, and adding it to `matchedCount` // makes the latter nonnegative. matchedCount += i; // Apply set filters to unmatched elements // NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount` // equals `i`), unless we didn't visit _any_ elements in the above loop because we have // no element matchers and no seed. // Incrementing an initially-string "0" `i` allows `i` to remain a string only in that // case, which will result in a "00" `matchedCount` that differs from `i` but is also // numerically zero. if ( bySet && i !== matchedCount ) { j = 0; while ( ( matcher = setMatchers[ j++ ] ) ) { matcher( unmatched, setMatched, context, xml ); } if ( seed ) { // Reintegrate element matches to eliminate the need for sorting if ( matchedCount > 0 ) { while ( i-- ) { if ( !( unmatched[ i ] || setMatched[ i ] ) ) { setMatched[ i ] = pop.call( results ); } } } // Discard index placeholder values to get only actual matches setMatched = condense( setMatched ); } // Add matches to results push.apply( results, setMatched ); // Seedless set matches succeeding multiple successful matchers stipulate sorting if ( outermost && !seed && setMatched.length > 0 && ( matchedCount + setMatchers.length ) > 1 ) { Sizzle.uniqueSort( results ); } } // Override manipulation of globals by nested matchers if ( outermost ) { dirruns = dirrunsUnique; outermostContext = contextBackup; } return unmatched; }; return bySet ? markFunction( superMatcher ) : superMatcher; } compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) { var i, setMatchers = [], elementMatchers = [], cached = compilerCache[ selector + " " ]; if ( !cached ) { // Generate a function of recursive functions that can be used to check each element if ( !match ) { match = tokenize( selector ); } i = match.length; while ( i-- ) { cached = matcherFromTokens( match[ i ] ); if ( cached[ expando ] ) { setMatchers.push( cached ); } else { elementMatchers.push( cached ); } } // Cache the compiled function cached = compilerCache( selector, matcherFromGroupMatchers( elementMatchers, setMatchers ) ); // Save selector and tokenization cached.selector = selector; } return cached; }; /** * A low-level selection function that works with Sizzle's compiled * selector functions * @param {String|Function} selector A selector or a pre-compiled * selector function built with Sizzle.compile * @param {Element} context * @param {Array} [results] * @param {Array} [seed] A set of elements to match against */ select = Sizzle.select = function( selector, context, results, seed ) { var i, tokens, token, type, find, compiled = typeof selector === "function" && selector, match = !seed && tokenize( ( selector = compiled.selector || selector ) ); results = results || []; // Try to minimize operations if there is only one selector in the list and no seed // (the latter of which guarantees us context) if ( match.length === 1 ) { // Reduce context if the leading compound selector is an ID tokens = match[ 0 ] = match[ 0 ].slice( 0 ); if ( tokens.length > 2 && ( token = tokens[ 0 ] ).type === "ID" && context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[ 1 ].type ] ) { context = ( Expr.find[ "ID" ]( token.matches[ 0 ] .replace( runescape, funescape ), context ) || [] )[ 0 ]; if ( !context ) { return results; // Precompiled matchers will still verify ancestry, so step up a level } else if ( compiled ) { context = context.parentNode; } selector = selector.slice( tokens.shift().value.length ); } // Fetch a seed set for right-to-left matching i = matchExpr[ "needsContext" ].test( selector ) ? 0 : tokens.length; while ( i-- ) { token = tokens[ i ]; // Abort if we hit a combinator if ( Expr.relative[ ( type = token.type ) ] ) { break; } if ( ( find = Expr.find[ type ] ) ) { // Search, expanding context for leading sibling combinators if ( ( seed = find( token.matches[ 0 ].replace( runescape, funescape ), rsibling.test( tokens[ 0 ].type ) && testContext( context.parentNode ) || context ) ) ) { // If seed is empty or no tokens remain, we can return early tokens.splice( i, 1 ); selector = seed.length && toSelector( tokens ); if ( !selector ) { push.apply( results, seed ); return results; } break; } } } } // Compile and execute a filtering function if one is not provided // Provide `match` to avoid retokenization if we modified the selector above ( compiled || compile( selector, match ) )( seed, context, !documentIsHTML, results, !context || rsibling.test( selector ) && testContext( context.parentNode ) || context ); return results; }; // One-time assignments // Sort stability support.sortStable = expando.split( "" ).sort( sortOrder ).join( "" ) === expando; // Support: Chrome 14-35+ // Always assume duplicates if they aren't passed to the comparison function support.detectDuplicates = !!hasDuplicate; // Initialize against the default document setDocument(); // Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) // Detached nodes confoundingly follow *each other* support.sortDetached = assert( function( el ) { // Should return 1, but returns 4 (following) return el.compareDocumentPosition( document.createElement( "fieldset" ) ) & 1; } ); // Support: IE<8 // Prevent attribute/property "interpolation" // https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx if ( !assert( function( el ) { el.innerHTML = ""; return el.firstChild.getAttribute( "href" ) === "#"; } ) ) { addHandle( "type|href|height|width", function( elem, name, isXML ) { if ( !isXML ) { return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); } } ); } // Support: IE<9 // Use defaultValue in place of getAttribute("value") if ( !support.attributes || !assert( function( el ) { el.innerHTML = ""; el.firstChild.setAttribute( "value", "" ); return el.firstChild.getAttribute( "value" ) === ""; } ) ) { addHandle( "value", function( elem, _name, isXML ) { if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { return elem.defaultValue; } } ); } // Support: IE<9 // Use getAttributeNode to fetch booleans when getAttribute lies if ( !assert( function( el ) { return el.getAttribute( "disabled" ) == null; } ) ) { addHandle( booleans, function( elem, name, isXML ) { var val; if ( !isXML ) { return elem[ name ] === true ? name.toLowerCase() : ( val = elem.getAttributeNode( name ) ) && val.specified ? val.value : null; } } ); } return Sizzle; } )( window ); jQuery.find = Sizzle; jQuery.expr = Sizzle.selectors; // Deprecated jQuery.expr[ ":" ] = jQuery.expr.pseudos; jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort; jQuery.text = Sizzle.getText; jQuery.isXMLDoc = Sizzle.isXML; jQuery.contains = Sizzle.contains; jQuery.escapeSelector = Sizzle.escape; var dir = function( elem, dir, until ) { var matched = [], truncate = until !== undefined; while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) { if ( elem.nodeType === 1 ) { if ( truncate && jQuery( elem ).is( until ) ) { break; } matched.push( elem ); } } return matched; }; var siblings = function( n, elem ) { var matched = []; for ( ; n; n = n.nextSibling ) { if ( n.nodeType === 1 && n !== elem ) { matched.push( n ); } } return matched; }; var rneedsContext = jQuery.expr.match.needsContext; function nodeName( elem, name ) { return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); }; var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i ); // Implement the identical functionality for filter and not function winnow( elements, qualifier, not ) { if ( isFunction( qualifier ) ) { return jQuery.grep( elements, function( elem, i ) { return !!qualifier.call( elem, i, elem ) !== not; } ); } // Single element if ( qualifier.nodeType ) { return jQuery.grep( elements, function( elem ) { return ( elem === qualifier ) !== not; } ); } // Arraylike of elements (jQuery, arguments, Array) if ( typeof qualifier !== "string" ) { return jQuery.grep( elements, function( elem ) { return ( indexOf.call( qualifier, elem ) > -1 ) !== not; } ); } // Filtered directly for both simple and complex selectors return jQuery.filter( qualifier, elements, not ); } jQuery.filter = function( expr, elems, not ) { var elem = elems[ 0 ]; if ( not ) { expr = ":not(" + expr + ")"; } if ( elems.length === 1 && elem.nodeType === 1 ) { return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : []; } return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { return elem.nodeType === 1; } ) ); }; jQuery.fn.extend( { find: function( selector ) { var i, ret, len = this.length, self = this; if ( typeof selector !== "string" ) { return this.pushStack( jQuery( selector ).filter( function() { for ( i = 0; i < len; i++ ) { if ( jQuery.contains( self[ i ], this ) ) { return true; } } } ) ); } ret = this.pushStack( [] ); for ( i = 0; i < len; i++ ) { jQuery.find( selector, self[ i ], ret ); } return len > 1 ? jQuery.uniqueSort( ret ) : ret; }, filter: function( selector ) { return this.pushStack( winnow( this, selector || [], false ) ); }, not: function( selector ) { return this.pushStack( winnow( this, selector || [], true ) ); }, is: function( selector ) { return !!winnow( this, // If this is a positional/relative selector, check membership in the returned set // so $("p:first").is("p:last") won't return true for a doc with two "p". typeof selector === "string" && rneedsContext.test( selector ) ? jQuery( selector ) : selector || [], false ).length; } } ); // Initialize a jQuery object // A central reference to the root jQuery(document) var rootjQuery, // A simple way to check for HTML strings // Prioritize #id over to avoid XSS via location.hash (#9521) // Strict HTML recognition (#11290: must start with <) // Shortcut simple #id case for speed rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/, init = jQuery.fn.init = function( selector, context, root ) { var match, elem; // HANDLE: $(""), $(null), $(undefined), $(false) if ( !selector ) { return this; } // Method init() accepts an alternate rootjQuery // so migrate can support jQuery.sub (gh-2101) root = root || rootjQuery; // Handle HTML strings if ( typeof selector === "string" ) { if ( selector[ 0 ] === "<" && selector[ selector.length - 1 ] === ">" && selector.length >= 3 ) { // Assume that strings that start and end with <> are HTML and skip the regex check match = [ null, selector, null ]; } else { match = rquickExpr.exec( selector ); } // Match html or make sure no context is specified for #id if ( match && ( match[ 1 ] || !context ) ) { // HANDLE: $(html) -> $(array) if ( match[ 1 ] ) { context = context instanceof jQuery ? context[ 0 ] : context; // Option to run scripts is true for back-compat // Intentionally let the error be thrown if parseHTML is not present jQuery.merge( this, jQuery.parseHTML( match[ 1 ], context && context.nodeType ? context.ownerDocument || context : document, true ) ); // HANDLE: $(html, props) if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) { for ( match in context ) { // Properties of context are called as methods if possible if ( isFunction( this[ match ] ) ) { this[ match ]( context[ match ] ); // ...and otherwise set as attributes } else { this.attr( match, context[ match ] ); } } } return this; // HANDLE: $(#id) } else { elem = document.getElementById( match[ 2 ] ); if ( elem ) { // Inject the element directly into the jQuery object this[ 0 ] = elem; this.length = 1; } return this; } // HANDLE: $(expr, $(...)) } else if ( !context || context.jquery ) { return ( context || root ).find( selector ); // HANDLE: $(expr, context) // (which is just equivalent to: $(context).find(expr) } else { return this.constructor( context ).find( selector ); } // HANDLE: $(DOMElement) } else if ( selector.nodeType ) { this[ 0 ] = selector; this.length = 1; return this; // HANDLE: $(function) // Shortcut for document ready } else if ( isFunction( selector ) ) { return root.ready !== undefined ? root.ready( selector ) : // Execute immediately if ready is not present selector( jQuery ); } return jQuery.makeArray( selector, this ); }; // Give the init function the jQuery prototype for later instantiation init.prototype = jQuery.fn; // Initialize central reference rootjQuery = jQuery( document ); var rparentsprev = /^(?:parents|prev(?:Until|All))/, // Methods guaranteed to produce a unique set when starting from a unique set guaranteedUnique = { children: true, contents: true, next: true, prev: true }; jQuery.fn.extend( { has: function( target ) { var targets = jQuery( target, this ), l = targets.length; return this.filter( function() { var i = 0; for ( ; i < l; i++ ) { if ( jQuery.contains( this, targets[ i ] ) ) { return true; } } } ); }, closest: function( selectors, context ) { var cur, i = 0, l = this.length, matched = [], targets = typeof selectors !== "string" && jQuery( selectors ); // Positional selectors never match, since there's no _selection_ context if ( !rneedsContext.test( selectors ) ) { for ( ; i < l; i++ ) { for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) { // Always skip document fragments if ( cur.nodeType < 11 && ( targets ? targets.index( cur ) > -1 : // Don't pass non-elements to Sizzle cur.nodeType === 1 && jQuery.find.matchesSelector( cur, selectors ) ) ) { matched.push( cur ); break; } } } } return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched ); }, // Determine the position of an element within the set index: function( elem ) { // No argument, return index in parent if ( !elem ) { return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1; } // Index in selector if ( typeof elem === "string" ) { return indexOf.call( jQuery( elem ), this[ 0 ] ); } // Locate the position of the desired element return indexOf.call( this, // If it receives a jQuery object, the first element is used elem.jquery ? elem[ 0 ] : elem ); }, add: function( selector, context ) { return this.pushStack( jQuery.uniqueSort( jQuery.merge( this.get(), jQuery( selector, context ) ) ) ); }, addBack: function( selector ) { return this.add( selector == null ? this.prevObject : this.prevObject.filter( selector ) ); } } ); function sibling( cur, dir ) { while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {} return cur; } jQuery.each( { parent: function( elem ) { var parent = elem.parentNode; return parent && parent.nodeType !== 11 ? parent : null; }, parents: function( elem ) { return dir( elem, "parentNode" ); }, parentsUntil: function( elem, _i, until ) { return dir( elem, "parentNode", until ); }, next: function( elem ) { return sibling( elem, "nextSibling" ); }, prev: function( elem ) { return sibling( elem, "previousSibling" ); }, nextAll: function( elem ) { return dir( elem, "nextSibling" ); }, prevAll: function( elem ) { return dir( elem, "previousSibling" ); }, nextUntil: function( elem, _i, until ) { return dir( elem, "nextSibling", until ); }, prevUntil: function( elem, _i, until ) { return dir( elem, "previousSibling", until ); }, siblings: function( elem ) { return siblings( ( elem.parentNode || {} ).firstChild, elem ); }, children: function( elem ) { return siblings( elem.firstChild ); }, contents: function( elem ) { if ( elem.contentDocument != null && // Support: IE 11+ // elements with no `data` attribute has an object // `contentDocument` with a `null` prototype. getProto( elem.contentDocument ) ) { return elem.contentDocument; } // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only // Treat the template element as a regular one in browsers that // don't support it. if ( nodeName( elem, "template" ) ) { elem = elem.content || elem; } return jQuery.merge( [], elem.childNodes ); } }, function( name, fn ) { jQuery.fn[ name ] = function( until, selector ) { var matched = jQuery.map( this, fn, until ); if ( name.slice( -5 ) !== "Until" ) { selector = until; } if ( selector && typeof selector === "string" ) { matched = jQuery.filter( selector, matched ); } if ( this.length > 1 ) { // Remove duplicates if ( !guaranteedUnique[ name ] ) { jQuery.uniqueSort( matched ); } // Reverse order for parents* and prev-derivatives if ( rparentsprev.test( name ) ) { matched.reverse(); } } return this.pushStack( matched ); }; } ); var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g ); // Convert String-formatted options into Object-formatted ones function createOptions( options ) { var object = {}; jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) { object[ flag ] = true; } ); return object; } /* * Create a callback list using the following parameters: * * options: an optional list of space-separated options that will change how * the callback list behaves or a more traditional option object * * By default a callback list will act like an event callback list and can be * "fired" multiple times. * * Possible options: * * once: will ensure the callback list can only be fired once (like a Deferred) * * memory: will keep track of previous values and will call any callback added * after the list has been fired right away with the latest "memorized" * values (like a Deferred) * * unique: will ensure a callback can only be added once (no duplicate in the list) * * stopOnFalse: interrupt callings when a callback returns false * */ jQuery.Callbacks = function( options ) { // Convert options from String-formatted to Object-formatted if needed // (we check in cache first) options = typeof options === "string" ? createOptions( options ) : jQuery.extend( {}, options ); var // Flag to know if list is currently firing firing, // Last fire value for non-forgettable lists memory, // Flag to know if list was already fired fired, // Flag to prevent firing locked, // Actual callback list list = [], // Queue of execution data for repeatable lists queue = [], // Index of currently firing callback (modified by add/remove as needed) firingIndex = -1, // Fire callbacks fire = function() { // Enforce single-firing locked = locked || options.once; // Execute callbacks for all pending executions, // respecting firingIndex overrides and runtime changes fired = firing = true; for ( ; queue.length; firingIndex = -1 ) { memory = queue.shift(); while ( ++firingIndex < list.length ) { // Run callback and check for early termination if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false && options.stopOnFalse ) { // Jump to end and forget the data so .add doesn't re-fire firingIndex = list.length; memory = false; } } } // Forget the data if we're done with it if ( !options.memory ) { memory = false; } firing = false; // Clean up if we're done firing for good if ( locked ) { // Keep an empty list if we have data for future add calls if ( memory ) { list = []; // Otherwise, this object is spent } else { list = ""; } } }, // Actual Callbacks object self = { // Add a callback or a collection of callbacks to the list add: function() { if ( list ) { // If we have memory from a past run, we should fire after adding if ( memory && !firing ) { firingIndex = list.length - 1; queue.push( memory ); } ( function add( args ) { jQuery.each( args, function( _, arg ) { if ( isFunction( arg ) ) { if ( !options.unique || !self.has( arg ) ) { list.push( arg ); } } else if ( arg && arg.length && toType( arg ) !== "string" ) { // Inspect recursively add( arg ); } } ); } )( arguments ); if ( memory && !firing ) { fire(); } } return this; }, // Remove a callback from the list remove: function() { jQuery.each( arguments, function( _, arg ) { var index; while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { list.splice( index, 1 ); // Handle firing indexes if ( index <= firingIndex ) { firingIndex--; } } } ); return this; }, // Check if a given callback is in the list. // If no argument is given, return whether or not list has callbacks attached. has: function( fn ) { return fn ? jQuery.inArray( fn, list ) > -1 : list.length > 0; }, // Remove all callbacks from the list empty: function() { if ( list ) { list = []; } return this; }, // Disable .fire and .add // Abort any current/pending executions // Clear all callbacks and values disable: function() { locked = queue = []; list = memory = ""; return this; }, disabled: function() { return !list; }, // Disable .fire // Also disable .add unless we have memory (since it would have no effect) // Abort any pending executions lock: function() { locked = queue = []; if ( !memory && !firing ) { list = memory = ""; } return this; }, locked: function() { return !!locked; }, // Call all callbacks with the given context and arguments fireWith: function( context, args ) { if ( !locked ) { args = args || []; args = [ context, args.slice ? args.slice() : args ]; queue.push( args ); if ( !firing ) { fire(); } } return this; }, // Call all the callbacks with the given arguments fire: function() { self.fireWith( this, arguments ); return this; }, // To know if the callbacks have already been called at least once fired: function() { return !!fired; } }; return self; }; function Identity( v ) { return v; } function Thrower( ex ) { throw ex; } function adoptValue( value, resolve, reject, noValue ) { var method; try { // Check for promise aspect first to privilege synchronous behavior if ( value && isFunction( ( method = value.promise ) ) ) { method.call( value ).done( resolve ).fail( reject ); // Other thenables } else if ( value && isFunction( ( method = value.then ) ) ) { method.call( value, resolve, reject ); // Other non-thenables } else { // Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer: // * false: [ value ].slice( 0 ) => resolve( value ) // * true: [ value ].slice( 1 ) => resolve() resolve.apply( undefined, [ value ].slice( noValue ) ); } // For Promises/A+, convert exceptions into rejections // Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in // Deferred#then to conditionally suppress rejection. } catch ( value ) { // Support: Android 4.0 only // Strict mode functions invoked without .call/.apply get global-object context reject.apply( undefined, [ value ] ); } } jQuery.extend( { Deferred: function( func ) { var tuples = [ // action, add listener, callbacks, // ... .then handlers, argument index, [final state] [ "notify", "progress", jQuery.Callbacks( "memory" ), jQuery.Callbacks( "memory" ), 2 ], [ "resolve", "done", jQuery.Callbacks( "once memory" ), jQuery.Callbacks( "once memory" ), 0, "resolved" ], [ "reject", "fail", jQuery.Callbacks( "once memory" ), jQuery.Callbacks( "once memory" ), 1, "rejected" ] ], state = "pending", promise = { state: function() { return state; }, always: function() { deferred.done( arguments ).fail( arguments ); return this; }, "catch": function( fn ) { return promise.then( null, fn ); }, // Keep pipe for back-compat pipe: function( /* fnDone, fnFail, fnProgress */ ) { var fns = arguments; return jQuery.Deferred( function( newDefer ) { jQuery.each( tuples, function( _i, tuple ) { // Map tuples (progress, done, fail) to arguments (done, fail, progress) var fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ]; // deferred.progress(function() { bind to newDefer or newDefer.notify }) // deferred.done(function() { bind to newDefer or newDefer.resolve }) // deferred.fail(function() { bind to newDefer or newDefer.reject }) deferred[ tuple[ 1 ] ]( function() { var returned = fn && fn.apply( this, arguments ); if ( returned && isFunction( returned.promise ) ) { returned.promise() .progress( newDefer.notify ) .done( newDefer.resolve ) .fail( newDefer.reject ); } else { newDefer[ tuple[ 0 ] + "With" ]( this, fn ? [ returned ] : arguments ); } } ); } ); fns = null; } ).promise(); }, then: function( onFulfilled, onRejected, onProgress ) { var maxDepth = 0; function resolve( depth, deferred, handler, special ) { return function() { var that = this, args = arguments, mightThrow = function() { var returned, then; // Support: Promises/A+ section 2.3.3.3.3 // https://promisesaplus.com/#point-59 // Ignore double-resolution attempts if ( depth < maxDepth ) { return; } returned = handler.apply( that, args ); // Support: Promises/A+ section 2.3.1 // https://promisesaplus.com/#point-48 if ( returned === deferred.promise() ) { throw new TypeError( "Thenable self-resolution" ); } // Support: Promises/A+ sections 2.3.3.1, 3.5 // https://promisesaplus.com/#point-54 // https://promisesaplus.com/#point-75 // Retrieve `then` only once then = returned && // Support: Promises/A+ section 2.3.4 // https://promisesaplus.com/#point-64 // Only check objects and functions for thenability ( typeof returned === "object" || typeof returned === "function" ) && returned.then; // Handle a returned thenable if ( isFunction( then ) ) { // Special processors (notify) just wait for resolution if ( special ) { then.call( returned, resolve( maxDepth, deferred, Identity, special ), resolve( maxDepth, deferred, Thrower, special ) ); // Normal processors (resolve) also hook into progress } else { // ...and disregard older resolution values maxDepth++; then.call( returned, resolve( maxDepth, deferred, Identity, special ), resolve( maxDepth, deferred, Thrower, special ), resolve( maxDepth, deferred, Identity, deferred.notifyWith ) ); } // Handle all other returned values } else { // Only substitute handlers pass on context // and multiple values (non-spec behavior) if ( handler !== Identity ) { that = undefined; args = [ returned ]; } // Process the value(s) // Default process is resolve ( special || deferred.resolveWith )( that, args ); } }, // Only normal processors (resolve) catch and reject exceptions process = special ? mightThrow : function() { try { mightThrow(); } catch ( e ) { if ( jQuery.Deferred.exceptionHook ) { jQuery.Deferred.exceptionHook( e, process.stackTrace ); } // Support: Promises/A+ section 2.3.3.3.4.1 // https://promisesaplus.com/#point-61 // Ignore post-resolution exceptions if ( depth + 1 >= maxDepth ) { // Only substitute handlers pass on context // and multiple values (non-spec behavior) if ( handler !== Thrower ) { that = undefined; args = [ e ]; } deferred.rejectWith( that, args ); } } }; // Support: Promises/A+ section 2.3.3.3.1 // https://promisesaplus.com/#point-57 // Re-resolve promises immediately to dodge false rejection from // subsequent errors if ( depth ) { process(); } else { // Call an optional hook to record the stack, in case of exception // since it's otherwise lost when execution goes async if ( jQuery.Deferred.getStackHook ) { process.stackTrace = jQuery.Deferred.getStackHook(); } window.setTimeout( process ); } }; } return jQuery.Deferred( function( newDefer ) { // progress_handlers.add( ... ) tuples[ 0 ][ 3 ].add( resolve( 0, newDefer, isFunction( onProgress ) ? onProgress : Identity, newDefer.notifyWith ) ); // fulfilled_handlers.add( ... ) tuples[ 1 ][ 3 ].add( resolve( 0, newDefer, isFunction( onFulfilled ) ? onFulfilled : Identity ) ); // rejected_handlers.add( ... ) tuples[ 2 ][ 3 ].add( resolve( 0, newDefer, isFunction( onRejected ) ? onRejected : Thrower ) ); } ).promise(); }, // Get a promise for this deferred // If obj is provided, the promise aspect is added to the object promise: function( obj ) { return obj != null ? jQuery.extend( obj, promise ) : promise; } }, deferred = {}; // Add list-specific methods jQuery.each( tuples, function( i, tuple ) { var list = tuple[ 2 ], stateString = tuple[ 5 ]; // promise.progress = list.add // promise.done = list.add // promise.fail = list.add promise[ tuple[ 1 ] ] = list.add; // Handle state if ( stateString ) { list.add( function() { // state = "resolved" (i.e., fulfilled) // state = "rejected" state = stateString; }, // rejected_callbacks.disable // fulfilled_callbacks.disable tuples[ 3 - i ][ 2 ].disable, // rejected_handlers.disable // fulfilled_handlers.disable tuples[ 3 - i ][ 3 ].disable, // progress_callbacks.lock tuples[ 0 ][ 2 ].lock, // progress_handlers.lock tuples[ 0 ][ 3 ].lock ); } // progress_handlers.fire // fulfilled_handlers.fire // rejected_handlers.fire list.add( tuple[ 3 ].fire ); // deferred.notify = function() { deferred.notifyWith(...) } // deferred.resolve = function() { deferred.resolveWith(...) } // deferred.reject = function() { deferred.rejectWith(...) } deferred[ tuple[ 0 ] ] = function() { deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments ); return this; }; // deferred.notifyWith = list.fireWith // deferred.resolveWith = list.fireWith // deferred.rejectWith = list.fireWith deferred[ tuple[ 0 ] + "With" ] = list.fireWith; } ); // Make the deferred a promise promise.promise( deferred ); // Call given func if any if ( func ) { func.call( deferred, deferred ); } // All done! return deferred; }, // Deferred helper when: function( singleValue ) { var // count of uncompleted subordinates remaining = arguments.length, // count of unprocessed arguments i = remaining, // subordinate fulfillment data resolveContexts = Array( i ), resolveValues = slice.call( arguments ), // the master Deferred master = jQuery.Deferred(), // subordinate callback factory updateFunc = function( i ) { return function( value ) { resolveContexts[ i ] = this; resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value; if ( !( --remaining ) ) { master.resolveWith( resolveContexts, resolveValues ); } }; }; // Single- and empty arguments are adopted like Promise.resolve if ( remaining <= 1 ) { adoptValue( singleValue, master.done( updateFunc( i ) ).resolve, master.reject, !remaining ); // Use .then() to unwrap secondary thenables (cf. gh-3000) if ( master.state() === "pending" || isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) { return master.then(); } } // Multiple arguments are aggregated like Promise.all array elements while ( i-- ) { adoptValue( resolveValues[ i ], updateFunc( i ), master.reject ); } return master.promise(); } } ); // These usually indicate a programmer mistake during development, // warn about them ASAP rather than swallowing them by default. var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/; jQuery.Deferred.exceptionHook = function( error, stack ) { // Support: IE 8 - 9 only // Console exists when dev tools are open, which can happen at any time if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) { window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack ); } }; jQuery.readyException = function( error ) { window.setTimeout( function() { throw error; } ); }; // The deferred used on DOM ready var readyList = jQuery.Deferred(); jQuery.fn.ready = function( fn ) { readyList .then( fn ) // Wrap jQuery.readyException in a function so that the lookup // happens at the time of error handling instead of callback // registration. .catch( function( error ) { jQuery.readyException( error ); } ); return this; }; jQuery.extend( { // Is the DOM ready to be used? Set to true once it occurs. isReady: false, // A counter to track how many items to wait for before // the ready event fires. See #6781 readyWait: 1, // Handle when the DOM is ready ready: function( wait ) { // Abort if there are pending holds or we're already ready if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { return; } // Remember that the DOM is ready jQuery.isReady = true; // If a normal DOM Ready event fired, decrement, and wait if need be if ( wait !== true && --jQuery.readyWait > 0 ) { return; } // If there are functions bound, to execute readyList.resolveWith( document, [ jQuery ] ); } } ); jQuery.ready.then = readyList.then; // The ready event handler and self cleanup method function completed() { document.removeEventListener( "DOMContentLoaded", completed ); window.removeEventListener( "load", completed ); jQuery.ready(); } // Catch cases where $(document).ready() is called // after the browser event has already occurred. // Support: IE <=9 - 10 only // Older IE sometimes signals "interactive" too soon if ( document.readyState === "complete" || ( document.readyState !== "loading" && !document.documentElement.doScroll ) ) { // Handle it asynchronously to allow scripts the opportunity to delay ready window.setTimeout( jQuery.ready ); } else { // Use the handy event callback document.addEventListener( "DOMContentLoaded", completed ); // A fallback to window.onload, that will always work window.addEventListener( "load", completed ); } // Multifunctional method to get and set values of a collection // The value/s can optionally be executed if it's a function var access = function( elems, fn, key, value, chainable, emptyGet, raw ) { var i = 0, len = elems.length, bulk = key == null; // Sets many values if ( toType( key ) === "object" ) { chainable = true; for ( i in key ) { access( elems, fn, i, key[ i ], true, emptyGet, raw ); } // Sets one value } else if ( value !== undefined ) { chainable = true; if ( !isFunction( value ) ) { raw = true; } if ( bulk ) { // Bulk operations run against the entire set if ( raw ) { fn.call( elems, value ); fn = null; // ...except when executing function values } else { bulk = fn; fn = function( elem, _key, value ) { return bulk.call( jQuery( elem ), value ); }; } } if ( fn ) { for ( ; i < len; i++ ) { fn( elems[ i ], key, raw ? value : value.call( elems[ i ], i, fn( elems[ i ], key ) ) ); } } } if ( chainable ) { return elems; } // Gets if ( bulk ) { return fn.call( elems ); } return len ? fn( elems[ 0 ], key ) : emptyGet; }; // Matches dashed string for camelizing var rmsPrefix = /^-ms-/, rdashAlpha = /-([a-z])/g; // Used by camelCase as callback to replace() function fcamelCase( _all, letter ) { return letter.toUpperCase(); } // Convert dashed to camelCase; used by the css and data modules // Support: IE <=9 - 11, Edge 12 - 15 // Microsoft forgot to hump their vendor prefix (#9572) function camelCase( string ) { return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); } var acceptData = function( owner ) { // Accepts only: // - Node // - Node.ELEMENT_NODE // - Node.DOCUMENT_NODE // - Object // - Any return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType ); }; function Data() { this.expando = jQuery.expando + Data.uid++; } Data.uid = 1; Data.prototype = { cache: function( owner ) { // Check if the owner object already has a cache var value = owner[ this.expando ]; // If not, create one if ( !value ) { value = {}; // We can accept data for non-element nodes in modern browsers, // but we should not, see #8335. // Always return an empty object. if ( acceptData( owner ) ) { // If it is a node unlikely to be stringify-ed or looped over // use plain assignment if ( owner.nodeType ) { owner[ this.expando ] = value; // Otherwise secure it in a non-enumerable property // configurable must be true to allow the property to be // deleted when data is removed } else { Object.defineProperty( owner, this.expando, { value: value, configurable: true } ); } } } return value; }, set: function( owner, data, value ) { var prop, cache = this.cache( owner ); // Handle: [ owner, key, value ] args // Always use camelCase key (gh-2257) if ( typeof data === "string" ) { cache[ camelCase( data ) ] = value; // Handle: [ owner, { properties } ] args } else { // Copy the properties one-by-one to the cache object for ( prop in data ) { cache[ camelCase( prop ) ] = data[ prop ]; } } return cache; }, get: function( owner, key ) { return key === undefined ? this.cache( owner ) : // Always use camelCase key (gh-2257) owner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ]; }, access: function( owner, key, value ) { // In cases where either: // // 1. No key was specified // 2. A string key was specified, but no value provided // // Take the "read" path and allow the get method to determine // which value to return, respectively either: // // 1. The entire cache object // 2. The data stored at the key // if ( key === undefined || ( ( key && typeof key === "string" ) && value === undefined ) ) { return this.get( owner, key ); } // When the key is not a string, or both a key and value // are specified, set or extend (existing objects) with either: // // 1. An object of properties // 2. A key and value // this.set( owner, key, value ); // Since the "set" path can have two possible entry points // return the expected data based on which path was taken[*] return value !== undefined ? value : key; }, remove: function( owner, key ) { var i, cache = owner[ this.expando ]; if ( cache === undefined ) { return; } if ( key !== undefined ) { // Support array or space separated string of keys if ( Array.isArray( key ) ) { // If key is an array of keys... // We always set camelCase keys, so remove that. key = key.map( camelCase ); } else { key = camelCase( key ); // If a key with the spaces exists, use it. // Otherwise, create an array by matching non-whitespace key = key in cache ? [ key ] : ( key.match( rnothtmlwhite ) || [] ); } i = key.length; while ( i-- ) { delete cache[ key[ i ] ]; } } // Remove the expando if there's no more data if ( key === undefined || jQuery.isEmptyObject( cache ) ) { // Support: Chrome <=35 - 45 // Webkit & Blink performance suffers when deleting properties // from DOM nodes, so set to undefined instead // https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted) if ( owner.nodeType ) { owner[ this.expando ] = undefined; } else { delete owner[ this.expando ]; } } }, hasData: function( owner ) { var cache = owner[ this.expando ]; return cache !== undefined && !jQuery.isEmptyObject( cache ); } }; var dataPriv = new Data(); var dataUser = new Data(); // Implementation Summary // // 1. Enforce API surface and semantic compatibility with 1.9.x branch // 2. Improve the module's maintainability by reducing the storage // paths to a single mechanism. // 3. Use the same single mechanism to support "private" and "user" data. // 4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData) // 5. Avoid exposing implementation details on user objects (eg. expando properties) // 6. Provide a clear path for implementation upgrade to WeakMap in 2014 var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/, rmultiDash = /[A-Z]/g; function getData( data ) { if ( data === "true" ) { return true; } if ( data === "false" ) { return false; } if ( data === "null" ) { return null; } // Only convert to a number if it doesn't change the string if ( data === +data + "" ) { return +data; } if ( rbrace.test( data ) ) { return JSON.parse( data ); } return data; } function dataAttr( elem, key, data ) { var name; // If nothing was found internally, try to fetch any // data from the HTML5 data-* attribute if ( data === undefined && elem.nodeType === 1 ) { name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase(); data = elem.getAttribute( name ); if ( typeof data === "string" ) { try { data = getData( data ); } catch ( e ) {} // Make sure we set the data so it isn't changed later dataUser.set( elem, key, data ); } else { data = undefined; } } return data; } jQuery.extend( { hasData: function( elem ) { return dataUser.hasData( elem ) || dataPriv.hasData( elem ); }, data: function( elem, name, data ) { return dataUser.access( elem, name, data ); }, removeData: function( elem, name ) { dataUser.remove( elem, name ); }, // TODO: Now that all calls to _data and _removeData have been replaced // with direct calls to dataPriv methods, these can be deprecated. _data: function( elem, name, data ) { return dataPriv.access( elem, name, data ); }, _removeData: function( elem, name ) { dataPriv.remove( elem, name ); } } ); jQuery.fn.extend( { data: function( key, value ) { var i, name, data, elem = this[ 0 ], attrs = elem && elem.attributes; // Gets all values if ( key === undefined ) { if ( this.length ) { data = dataUser.get( elem ); if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) { i = attrs.length; while ( i-- ) { // Support: IE 11 only // The attrs elements can be null (#14894) if ( attrs[ i ] ) { name = attrs[ i ].name; if ( name.indexOf( "data-" ) === 0 ) { name = camelCase( name.slice( 5 ) ); dataAttr( elem, name, data[ name ] ); } } } dataPriv.set( elem, "hasDataAttrs", true ); } } return data; } // Sets multiple values if ( typeof key === "object" ) { return this.each( function() { dataUser.set( this, key ); } ); } return access( this, function( value ) { var data; // The calling jQuery object (element matches) is not empty // (and therefore has an element appears at this[ 0 ]) and the // `value` parameter was not undefined. An empty jQuery object // will result in `undefined` for elem = this[ 0 ] which will // throw an exception if an attempt to read a data cache is made. if ( elem && value === undefined ) { // Attempt to get data from the cache // The key will always be camelCased in Data data = dataUser.get( elem, key ); if ( data !== undefined ) { return data; } // Attempt to "discover" the data in // HTML5 custom data-* attrs data = dataAttr( elem, key ); if ( data !== undefined ) { return data; } // We tried really hard, but the data doesn't exist. return; } // Set the data... this.each( function() { // We always store the camelCased key dataUser.set( this, key, value ); } ); }, null, value, arguments.length > 1, null, true ); }, removeData: function( key ) { return this.each( function() { dataUser.remove( this, key ); } ); } } ); jQuery.extend( { queue: function( elem, type, data ) { var queue; if ( elem ) { type = ( type || "fx" ) + "queue"; queue = dataPriv.get( elem, type ); // Speed up dequeue by getting out quickly if this is just a lookup if ( data ) { if ( !queue || Array.isArray( data ) ) { queue = dataPriv.access( elem, type, jQuery.makeArray( data ) ); } else { queue.push( data ); } } return queue || []; } }, dequeue: function( elem, type ) { type = type || "fx"; var queue = jQuery.queue( elem, type ), startLength = queue.length, fn = queue.shift(), hooks = jQuery._queueHooks( elem, type ), next = function() { jQuery.dequeue( elem, type ); }; // If the fx queue is dequeued, always remove the progress sentinel if ( fn === "inprogress" ) { fn = queue.shift(); startLength--; } if ( fn ) { // Add a progress sentinel to prevent the fx queue from being // automatically dequeued if ( type === "fx" ) { queue.unshift( "inprogress" ); } // Clear up the last queue stop function delete hooks.stop; fn.call( elem, next, hooks ); } if ( !startLength && hooks ) { hooks.empty.fire(); } }, // Not public - generate a queueHooks object, or return the current one _queueHooks: function( elem, type ) { var key = type + "queueHooks"; return dataPriv.get( elem, key ) || dataPriv.access( elem, key, { empty: jQuery.Callbacks( "once memory" ).add( function() { dataPriv.remove( elem, [ type + "queue", key ] ); } ) } ); } } ); jQuery.fn.extend( { queue: function( type, data ) { var setter = 2; if ( typeof type !== "string" ) { data = type; type = "fx"; setter--; } if ( arguments.length < setter ) { return jQuery.queue( this[ 0 ], type ); } return data === undefined ? this : this.each( function() { var queue = jQuery.queue( this, type, data ); // Ensure a hooks for this queue jQuery._queueHooks( this, type ); if ( type === "fx" && queue[ 0 ] !== "inprogress" ) { jQuery.dequeue( this, type ); } } ); }, dequeue: function( type ) { return this.each( function() { jQuery.dequeue( this, type ); } ); }, clearQueue: function( type ) { return this.queue( type || "fx", [] ); }, // Get a promise resolved when queues of a certain type // are emptied (fx is the type by default) promise: function( type, obj ) { var tmp, count = 1, defer = jQuery.Deferred(), elements = this, i = this.length, resolve = function() { if ( !( --count ) ) { defer.resolveWith( elements, [ elements ] ); } }; if ( typeof type !== "string" ) { obj = type; type = undefined; } type = type || "fx"; while ( i-- ) { tmp = dataPriv.get( elements[ i ], type + "queueHooks" ); if ( tmp && tmp.empty ) { count++; tmp.empty.add( resolve ); } } resolve(); return defer.promise( obj ); } } ); var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source; var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" ); var cssExpand = [ "Top", "Right", "Bottom", "Left" ]; var documentElement = document.documentElement; var isAttached = function( elem ) { return jQuery.contains( elem.ownerDocument, elem ); }, composed = { composed: true }; // Support: IE 9 - 11+, Edge 12 - 18+, iOS 10.0 - 10.2 only // Check attachment across shadow DOM boundaries when possible (gh-3504) // Support: iOS 10.0-10.2 only // Early iOS 10 versions support `attachShadow` but not `getRootNode`, // leading to errors. We need to check for `getRootNode`. if ( documentElement.getRootNode ) { isAttached = function( elem ) { return jQuery.contains( elem.ownerDocument, elem ) || elem.getRootNode( composed ) === elem.ownerDocument; }; } var isHiddenWithinTree = function( elem, el ) { // isHiddenWithinTree might be called from jQuery#filter function; // in that case, element will be second argument elem = el || elem; // Inline style trumps all return elem.style.display === "none" || elem.style.display === "" && // Otherwise, check computed style // Support: Firefox <=43 - 45 // Disconnected elements can have computed display: none, so first confirm that elem is // in the document. isAttached( elem ) && jQuery.css( elem, "display" ) === "none"; }; function adjustCSS( elem, prop, valueParts, tween ) { var adjusted, scale, maxIterations = 20, currentValue = tween ? function() { return tween.cur(); } : function() { return jQuery.css( elem, prop, "" ); }, initial = currentValue(), unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ), // Starting value computation is required for potential unit mismatches initialInUnit = elem.nodeType && ( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) && rcssNum.exec( jQuery.css( elem, prop ) ); if ( initialInUnit && initialInUnit[ 3 ] !== unit ) { // Support: Firefox <=54 // Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144) initial = initial / 2; // Trust units reported by jQuery.css unit = unit || initialInUnit[ 3 ]; // Iteratively approximate from a nonzero starting point initialInUnit = +initial || 1; while ( maxIterations-- ) { // Evaluate and update our best guess (doubling guesses that zero out). // Finish if the scale equals or crosses 1 (making the old*new product non-positive). jQuery.style( elem, prop, initialInUnit + unit ); if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) { maxIterations = 0; } initialInUnit = initialInUnit / scale; } initialInUnit = initialInUnit * 2; jQuery.style( elem, prop, initialInUnit + unit ); // Make sure we update the tween properties later on valueParts = valueParts || []; } if ( valueParts ) { initialInUnit = +initialInUnit || +initial || 0; // Apply relative offset (+=/-=) if specified adjusted = valueParts[ 1 ] ? initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] : +valueParts[ 2 ]; if ( tween ) { tween.unit = unit; tween.start = initialInUnit; tween.end = adjusted; } } return adjusted; } var defaultDisplayMap = {}; function getDefaultDisplay( elem ) { var temp, doc = elem.ownerDocument, nodeName = elem.nodeName, display = defaultDisplayMap[ nodeName ]; if ( display ) { return display; } temp = doc.body.appendChild( doc.createElement( nodeName ) ); display = jQuery.css( temp, "display" ); temp.parentNode.removeChild( temp ); if ( display === "none" ) { display = "block"; } defaultDisplayMap[ nodeName ] = display; return display; } function showHide( elements, show ) { var display, elem, values = [], index = 0, length = elements.length; // Determine new display value for elements that need to change for ( ; index < length; index++ ) { elem = elements[ index ]; if ( !elem.style ) { continue; } display = elem.style.display; if ( show ) { // Since we force visibility upon cascade-hidden elements, an immediate (and slow) // check is required in this first loop unless we have a nonempty display value (either // inline or about-to-be-restored) if ( display === "none" ) { values[ index ] = dataPriv.get( elem, "display" ) || null; if ( !values[ index ] ) { elem.style.display = ""; } } if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) { values[ index ] = getDefaultDisplay( elem ); } } else { if ( display !== "none" ) { values[ index ] = "none"; // Remember what we're overwriting dataPriv.set( elem, "display", display ); } } } // Set the display of the elements in a second loop to avoid constant reflow for ( index = 0; index < length; index++ ) { if ( values[ index ] != null ) { elements[ index ].style.display = values[ index ]; } } return elements; } jQuery.fn.extend( { show: function() { return showHide( this, true ); }, hide: function() { return showHide( this ); }, toggle: function( state ) { if ( typeof state === "boolean" ) { return state ? this.show() : this.hide(); } return this.each( function() { if ( isHiddenWithinTree( this ) ) { jQuery( this ).show(); } else { jQuery( this ).hide(); } } ); } } ); var rcheckableType = ( /^(?:checkbox|radio)$/i ); var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]*)/i ); var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i ); ( function() { var fragment = document.createDocumentFragment(), div = fragment.appendChild( document.createElement( "div" ) ), input = document.createElement( "input" ); // Support: Android 4.0 - 4.3 only // Check state lost if the name is set (#11217) // Support: Windows Web Apps (WWA) // `name` and `type` must use .setAttribute for WWA (#14901) input.setAttribute( "type", "radio" ); input.setAttribute( "checked", "checked" ); input.setAttribute( "name", "t" ); div.appendChild( input ); // Support: Android <=4.1 only // Older WebKit doesn't clone checked state correctly in fragments support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked; // Support: IE <=11 only // Make sure textarea (and checkbox) defaultValue is properly cloned div.innerHTML = ""; support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue; // Support: IE <=9 only // IE <=9 replaces "; support.option = !!div.lastChild; } )(); // We have to close these tags to support XHTML (#13200) var wrapMap = { // XHTML parsers do not magically insert elements in the // same way that tag soup parsers do. So we cannot shorten // this by omitting or other required elements. thead: [ 1, "", "
    " ], col: [ 2, "", "
    " ], tr: [ 2, "", "
    " ], td: [ 3, "", "
    " ], _default: [ 0, "", "" ] }; wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; wrapMap.th = wrapMap.td; // Support: IE <=9 only if ( !support.option ) { wrapMap.optgroup = wrapMap.option = [ 1, "" ]; } function getAll( context, tag ) { // Support: IE <=9 - 11 only // Use typeof to avoid zero-argument method invocation on host objects (#15151) var ret; if ( typeof context.getElementsByTagName !== "undefined" ) { ret = context.getElementsByTagName( tag || "*" ); } else if ( typeof context.querySelectorAll !== "undefined" ) { ret = context.querySelectorAll( tag || "*" ); } else { ret = []; } if ( tag === undefined || tag && nodeName( context, tag ) ) { return jQuery.merge( [ context ], ret ); } return ret; } // Mark scripts as having already been evaluated function setGlobalEval( elems, refElements ) { var i = 0, l = elems.length; for ( ; i < l; i++ ) { dataPriv.set( elems[ i ], "globalEval", !refElements || dataPriv.get( refElements[ i ], "globalEval" ) ); } } var rhtml = /<|&#?\w+;/; function buildFragment( elems, context, scripts, selection, ignored ) { var elem, tmp, tag, wrap, attached, j, fragment = context.createDocumentFragment(), nodes = [], i = 0, l = elems.length; for ( ; i < l; i++ ) { elem = elems[ i ]; if ( elem || elem === 0 ) { // Add nodes directly if ( toType( elem ) === "object" ) { // Support: Android <=4.0 only, PhantomJS 1 only // push.apply(_, arraylike) throws on ancient WebKit jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); // Convert non-html into a text node } else if ( !rhtml.test( elem ) ) { nodes.push( context.createTextNode( elem ) ); // Convert html into DOM nodes } else { tmp = tmp || fragment.appendChild( context.createElement( "div" ) ); // Deserialize a standard representation tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase(); wrap = wrapMap[ tag ] || wrapMap._default; tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ]; // Descend through wrappers to the right content j = wrap[ 0 ]; while ( j-- ) { tmp = tmp.lastChild; } // Support: Android <=4.0 only, PhantomJS 1 only // push.apply(_, arraylike) throws on ancient WebKit jQuery.merge( nodes, tmp.childNodes ); // Remember the top-level container tmp = fragment.firstChild; // Ensure the created nodes are orphaned (#12392) tmp.textContent = ""; } } } // Remove wrapper from fragment fragment.textContent = ""; i = 0; while ( ( elem = nodes[ i++ ] ) ) { // Skip elements already in the context collection (trac-4087) if ( selection && jQuery.inArray( elem, selection ) > -1 ) { if ( ignored ) { ignored.push( elem ); } continue; } attached = isAttached( elem ); // Append to fragment tmp = getAll( fragment.appendChild( elem ), "script" ); // Preserve script evaluation history if ( attached ) { setGlobalEval( tmp ); } // Capture executables if ( scripts ) { j = 0; while ( ( elem = tmp[ j++ ] ) ) { if ( rscriptType.test( elem.type || "" ) ) { scripts.push( elem ); } } } } return fragment; } var rkeyEvent = /^key/, rmouseEvent = /^(?:mouse|pointer|contextmenu|drag|drop)|click/, rtypenamespace = /^([^.]*)(?:\.(.+)|)/; function returnTrue() { return true; } function returnFalse() { return false; } // Support: IE <=9 - 11+ // focus() and blur() are asynchronous, except when they are no-op. // So expect focus to be synchronous when the element is already active, // and blur to be synchronous when the element is not already active. // (focus and blur are always synchronous in other supported browsers, // this just defines when we can count on it). function expectSync( elem, type ) { return ( elem === safeActiveElement() ) === ( type === "focus" ); } // Support: IE <=9 only // Accessing document.activeElement can throw unexpectedly // https://bugs.jquery.com/ticket/13393 function safeActiveElement() { try { return document.activeElement; } catch ( err ) { } } function on( elem, types, selector, data, fn, one ) { var origFn, type; // Types can be a map of types/handlers if ( typeof types === "object" ) { // ( types-Object, selector, data ) if ( typeof selector !== "string" ) { // ( types-Object, data ) data = data || selector; selector = undefined; } for ( type in types ) { on( elem, type, selector, data, types[ type ], one ); } return elem; } if ( data == null && fn == null ) { // ( types, fn ) fn = selector; data = selector = undefined; } else if ( fn == null ) { if ( typeof selector === "string" ) { // ( types, selector, fn ) fn = data; data = undefined; } else { // ( types, data, fn ) fn = data; data = selector; selector = undefined; } } if ( fn === false ) { fn = returnFalse; } else if ( !fn ) { return elem; } if ( one === 1 ) { origFn = fn; fn = function( event ) { // Can use an empty set, since event contains the info jQuery().off( event ); return origFn.apply( this, arguments ); }; // Use same guid so caller can remove using origFn fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); } return elem.each( function() { jQuery.event.add( this, types, fn, data, selector ); } ); } /* * Helper functions for managing events -- not part of the public interface. * Props to Dean Edwards' addEvent library for many of the ideas. */ jQuery.event = { global: {}, add: function( elem, types, handler, data, selector ) { var handleObjIn, eventHandle, tmp, events, t, handleObj, special, handlers, type, namespaces, origType, elemData = dataPriv.get( elem ); // Only attach events to objects that accept data if ( !acceptData( elem ) ) { return; } // Caller can pass in an object of custom data in lieu of the handler if ( handler.handler ) { handleObjIn = handler; handler = handleObjIn.handler; selector = handleObjIn.selector; } // Ensure that invalid selectors throw exceptions at attach time // Evaluate against documentElement in case elem is a non-element node (e.g., document) if ( selector ) { jQuery.find.matchesSelector( documentElement, selector ); } // Make sure that the handler has a unique ID, used to find/remove it later if ( !handler.guid ) { handler.guid = jQuery.guid++; } // Init the element's event structure and main handler, if this is the first if ( !( events = elemData.events ) ) { events = elemData.events = Object.create( null ); } if ( !( eventHandle = elemData.handle ) ) { eventHandle = elemData.handle = function( e ) { // Discard the second event of a jQuery.event.trigger() and // when an event is called after a page has unloaded return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ? jQuery.event.dispatch.apply( elem, arguments ) : undefined; }; } // Handle multiple events separated by a space types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; t = types.length; while ( t-- ) { tmp = rtypenamespace.exec( types[ t ] ) || []; type = origType = tmp[ 1 ]; namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); // There *must* be a type, no attaching namespace-only handlers if ( !type ) { continue; } // If event changes its type, use the special event handlers for the changed type special = jQuery.event.special[ type ] || {}; // If selector defined, determine special event api type, otherwise given type type = ( selector ? special.delegateType : special.bindType ) || type; // Update special based on newly reset type special = jQuery.event.special[ type ] || {}; // handleObj is passed to all event handlers handleObj = jQuery.extend( { type: type, origType: origType, data: data, handler: handler, guid: handler.guid, selector: selector, needsContext: selector && jQuery.expr.match.needsContext.test( selector ), namespace: namespaces.join( "." ) }, handleObjIn ); // Init the event handler queue if we're the first if ( !( handlers = events[ type ] ) ) { handlers = events[ type ] = []; handlers.delegateCount = 0; // Only use addEventListener if the special events handler returns false if ( !special.setup || special.setup.call( elem, data, namespaces, eventHandle ) === false ) { if ( elem.addEventListener ) { elem.addEventListener( type, eventHandle ); } } } if ( special.add ) { special.add.call( elem, handleObj ); if ( !handleObj.handler.guid ) { handleObj.handler.guid = handler.guid; } } // Add to the element's handler list, delegates in front if ( selector ) { handlers.splice( handlers.delegateCount++, 0, handleObj ); } else { handlers.push( handleObj ); } // Keep track of which events have ever been used, for event optimization jQuery.event.global[ type ] = true; } }, // Detach an event or set of events from an element remove: function( elem, types, handler, selector, mappedTypes ) { var j, origCount, tmp, events, t, handleObj, special, handlers, type, namespaces, origType, elemData = dataPriv.hasData( elem ) && dataPriv.get( elem ); if ( !elemData || !( events = elemData.events ) ) { return; } // Once for each type.namespace in types; type may be omitted types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; t = types.length; while ( t-- ) { tmp = rtypenamespace.exec( types[ t ] ) || []; type = origType = tmp[ 1 ]; namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); // Unbind all events (on this namespace, if provided) for the element if ( !type ) { for ( type in events ) { jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); } continue; } special = jQuery.event.special[ type ] || {}; type = ( selector ? special.delegateType : special.bindType ) || type; handlers = events[ type ] || []; tmp = tmp[ 2 ] && new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ); // Remove matching events origCount = j = handlers.length; while ( j-- ) { handleObj = handlers[ j ]; if ( ( mappedTypes || origType === handleObj.origType ) && ( !handler || handler.guid === handleObj.guid ) && ( !tmp || tmp.test( handleObj.namespace ) ) && ( !selector || selector === handleObj.selector || selector === "**" && handleObj.selector ) ) { handlers.splice( j, 1 ); if ( handleObj.selector ) { handlers.delegateCount--; } if ( special.remove ) { special.remove.call( elem, handleObj ); } } } // Remove generic event handler if we removed something and no more handlers exist // (avoids potential for endless recursion during removal of special event handlers) if ( origCount && !handlers.length ) { if ( !special.teardown || special.teardown.call( elem, namespaces, elemData.handle ) === false ) { jQuery.removeEvent( elem, type, elemData.handle ); } delete events[ type ]; } } // Remove data and the expando if it's no longer used if ( jQuery.isEmptyObject( events ) ) { dataPriv.remove( elem, "handle events" ); } }, dispatch: function( nativeEvent ) { var i, j, ret, matched, handleObj, handlerQueue, args = new Array( arguments.length ), // Make a writable jQuery.Event from the native event object event = jQuery.event.fix( nativeEvent ), handlers = ( dataPriv.get( this, "events" ) || Object.create( null ) )[ event.type ] || [], special = jQuery.event.special[ event.type ] || {}; // Use the fix-ed jQuery.Event rather than the (read-only) native event args[ 0 ] = event; for ( i = 1; i < arguments.length; i++ ) { args[ i ] = arguments[ i ]; } event.delegateTarget = this; // Call the preDispatch hook for the mapped type, and let it bail if desired if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { return; } // Determine handlers handlerQueue = jQuery.event.handlers.call( this, event, handlers ); // Run delegates first; they may want to stop propagation beneath us i = 0; while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) { event.currentTarget = matched.elem; j = 0; while ( ( handleObj = matched.handlers[ j++ ] ) && !event.isImmediatePropagationStopped() ) { // If the event is namespaced, then each handler is only invoked if it is // specially universal or its namespaces are a superset of the event's. if ( !event.rnamespace || handleObj.namespace === false || event.rnamespace.test( handleObj.namespace ) ) { event.handleObj = handleObj; event.data = handleObj.data; ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle || handleObj.handler ).apply( matched.elem, args ); if ( ret !== undefined ) { if ( ( event.result = ret ) === false ) { event.preventDefault(); event.stopPropagation(); } } } } } // Call the postDispatch hook for the mapped type if ( special.postDispatch ) { special.postDispatch.call( this, event ); } return event.result; }, handlers: function( event, handlers ) { var i, handleObj, sel, matchedHandlers, matchedSelectors, handlerQueue = [], delegateCount = handlers.delegateCount, cur = event.target; // Find delegate handlers if ( delegateCount && // Support: IE <=9 // Black-hole SVG instance trees (trac-13180) cur.nodeType && // Support: Firefox <=42 // Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861) // https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click // Support: IE 11 only // ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343) !( event.type === "click" && event.button >= 1 ) ) { for ( ; cur !== this; cur = cur.parentNode || this ) { // Don't check non-elements (#13208) // Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) { matchedHandlers = []; matchedSelectors = {}; for ( i = 0; i < delegateCount; i++ ) { handleObj = handlers[ i ]; // Don't conflict with Object.prototype properties (#13203) sel = handleObj.selector + " "; if ( matchedSelectors[ sel ] === undefined ) { matchedSelectors[ sel ] = handleObj.needsContext ? jQuery( sel, this ).index( cur ) > -1 : jQuery.find( sel, this, null, [ cur ] ).length; } if ( matchedSelectors[ sel ] ) { matchedHandlers.push( handleObj ); } } if ( matchedHandlers.length ) { handlerQueue.push( { elem: cur, handlers: matchedHandlers } ); } } } } // Add the remaining (directly-bound) handlers cur = this; if ( delegateCount < handlers.length ) { handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } ); } return handlerQueue; }, addProp: function( name, hook ) { Object.defineProperty( jQuery.Event.prototype, name, { enumerable: true, configurable: true, get: isFunction( hook ) ? function() { if ( this.originalEvent ) { return hook( this.originalEvent ); } } : function() { if ( this.originalEvent ) { return this.originalEvent[ name ]; } }, set: function( value ) { Object.defineProperty( this, name, { enumerable: true, configurable: true, writable: true, value: value } ); } } ); }, fix: function( originalEvent ) { return originalEvent[ jQuery.expando ] ? originalEvent : new jQuery.Event( originalEvent ); }, special: { load: { // Prevent triggered image.load events from bubbling to window.load noBubble: true }, click: { // Utilize native event to ensure correct state for checkable inputs setup: function( data ) { // For mutual compressibility with _default, replace `this` access with a local var. // `|| data` is dead code meant only to preserve the variable through minification. var el = this || data; // Claim the first handler if ( rcheckableType.test( el.type ) && el.click && nodeName( el, "input" ) ) { // dataPriv.set( el, "click", ... ) leverageNative( el, "click", returnTrue ); } // Return false to allow normal processing in the caller return false; }, trigger: function( data ) { // For mutual compressibility with _default, replace `this` access with a local var. // `|| data` is dead code meant only to preserve the variable through minification. var el = this || data; // Force setup before triggering a click if ( rcheckableType.test( el.type ) && el.click && nodeName( el, "input" ) ) { leverageNative( el, "click" ); } // Return non-false to allow normal event-path propagation return true; }, // For cross-browser consistency, suppress native .click() on links // Also prevent it if we're currently inside a leveraged native-event stack _default: function( event ) { var target = event.target; return rcheckableType.test( target.type ) && target.click && nodeName( target, "input" ) && dataPriv.get( target, "click" ) || nodeName( target, "a" ); } }, beforeunload: { postDispatch: function( event ) { // Support: Firefox 20+ // Firefox doesn't alert if the returnValue field is not set. if ( event.result !== undefined && event.originalEvent ) { event.originalEvent.returnValue = event.result; } } } } }; // Ensure the presence of an event listener that handles manually-triggered // synthetic events by interrupting progress until reinvoked in response to // *native* events that it fires directly, ensuring that state changes have // already occurred before other listeners are invoked. function leverageNative( el, type, expectSync ) { // Missing expectSync indicates a trigger call, which must force setup through jQuery.event.add if ( !expectSync ) { if ( dataPriv.get( el, type ) === undefined ) { jQuery.event.add( el, type, returnTrue ); } return; } // Register the controller as a special universal handler for all event namespaces dataPriv.set( el, type, false ); jQuery.event.add( el, type, { namespace: false, handler: function( event ) { var notAsync, result, saved = dataPriv.get( this, type ); if ( ( event.isTrigger & 1 ) && this[ type ] ) { // Interrupt processing of the outer synthetic .trigger()ed event // Saved data should be false in such cases, but might be a leftover capture object // from an async native handler (gh-4350) if ( !saved.length ) { // Store arguments for use when handling the inner native event // There will always be at least one argument (an event object), so this array // will not be confused with a leftover capture object. saved = slice.call( arguments ); dataPriv.set( this, type, saved ); // Trigger the native event and capture its result // Support: IE <=9 - 11+ // focus() and blur() are asynchronous notAsync = expectSync( this, type ); this[ type ](); result = dataPriv.get( this, type ); if ( saved !== result || notAsync ) { dataPriv.set( this, type, false ); } else { result = {}; } if ( saved !== result ) { // Cancel the outer synthetic event event.stopImmediatePropagation(); event.preventDefault(); return result.value; } // If this is an inner synthetic event for an event with a bubbling surrogate // (focus or blur), assume that the surrogate already propagated from triggering the // native event and prevent that from happening again here. // This technically gets the ordering wrong w.r.t. to `.trigger()` (in which the // bubbling surrogate propagates *after* the non-bubbling base), but that seems // less bad than duplication. } else if ( ( jQuery.event.special[ type ] || {} ).delegateType ) { event.stopPropagation(); } // If this is a native event triggered above, everything is now in order // Fire an inner synthetic event with the original arguments } else if ( saved.length ) { // ...and capture the result dataPriv.set( this, type, { value: jQuery.event.trigger( // Support: IE <=9 - 11+ // Extend with the prototype to reset the above stopImmediatePropagation() jQuery.extend( saved[ 0 ], jQuery.Event.prototype ), saved.slice( 1 ), this ) } ); // Abort handling of the native event event.stopImmediatePropagation(); } } } ); } jQuery.removeEvent = function( elem, type, handle ) { // This "if" is needed for plain objects if ( elem.removeEventListener ) { elem.removeEventListener( type, handle ); } }; jQuery.Event = function( src, props ) { // Allow instantiation without the 'new' keyword if ( !( this instanceof jQuery.Event ) ) { return new jQuery.Event( src, props ); } // Event object if ( src && src.type ) { this.originalEvent = src; this.type = src.type; // Events bubbling up the document may have been marked as prevented // by a handler lower down the tree; reflect the correct value. this.isDefaultPrevented = src.defaultPrevented || src.defaultPrevented === undefined && // Support: Android <=2.3 only src.returnValue === false ? returnTrue : returnFalse; // Create target properties // Support: Safari <=6 - 7 only // Target should not be a text node (#504, #13143) this.target = ( src.target && src.target.nodeType === 3 ) ? src.target.parentNode : src.target; this.currentTarget = src.currentTarget; this.relatedTarget = src.relatedTarget; // Event type } else { this.type = src; } // Put explicitly provided properties onto the event object if ( props ) { jQuery.extend( this, props ); } // Create a timestamp if incoming event doesn't have one this.timeStamp = src && src.timeStamp || Date.now(); // Mark it as fixed this[ jQuery.expando ] = true; }; // jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding // https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html jQuery.Event.prototype = { constructor: jQuery.Event, isDefaultPrevented: returnFalse, isPropagationStopped: returnFalse, isImmediatePropagationStopped: returnFalse, isSimulated: false, preventDefault: function() { var e = this.originalEvent; this.isDefaultPrevented = returnTrue; if ( e && !this.isSimulated ) { e.preventDefault(); } }, stopPropagation: function() { var e = this.originalEvent; this.isPropagationStopped = returnTrue; if ( e && !this.isSimulated ) { e.stopPropagation(); } }, stopImmediatePropagation: function() { var e = this.originalEvent; this.isImmediatePropagationStopped = returnTrue; if ( e && !this.isSimulated ) { e.stopImmediatePropagation(); } this.stopPropagation(); } }; // Includes all common event props including KeyEvent and MouseEvent specific props jQuery.each( { altKey: true, bubbles: true, cancelable: true, changedTouches: true, ctrlKey: true, detail: true, eventPhase: true, metaKey: true, pageX: true, pageY: true, shiftKey: true, view: true, "char": true, code: true, charCode: true, key: true, keyCode: true, button: true, buttons: true, clientX: true, clientY: true, offsetX: true, offsetY: true, pointerId: true, pointerType: true, screenX: true, screenY: true, targetTouches: true, toElement: true, touches: true, which: function( event ) { var button = event.button; // Add which for key events if ( event.which == null && rkeyEvent.test( event.type ) ) { return event.charCode != null ? event.charCode : event.keyCode; } // Add which for click: 1 === left; 2 === middle; 3 === right if ( !event.which && button !== undefined && rmouseEvent.test( event.type ) ) { if ( button & 1 ) { return 1; } if ( button & 2 ) { return 3; } if ( button & 4 ) { return 2; } return 0; } return event.which; } }, jQuery.event.addProp ); jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateType ) { jQuery.event.special[ type ] = { // Utilize native event if possible so blur/focus sequence is correct setup: function() { // Claim the first handler // dataPriv.set( this, "focus", ... ) // dataPriv.set( this, "blur", ... ) leverageNative( this, type, expectSync ); // Return false to allow normal processing in the caller return false; }, trigger: function() { // Force setup before trigger leverageNative( this, type ); // Return non-false to allow normal event-path propagation return true; }, delegateType: delegateType }; } ); // Create mouseenter/leave events using mouseover/out and event-time checks // so that event delegation works in jQuery. // Do the same for pointerenter/pointerleave and pointerover/pointerout // // Support: Safari 7 only // Safari sends mouseenter too often; see: // https://bugs.chromium.org/p/chromium/issues/detail?id=470258 // for the description of the bug (it existed in older Chrome versions as well). jQuery.each( { mouseenter: "mouseover", mouseleave: "mouseout", pointerenter: "pointerover", pointerleave: "pointerout" }, function( orig, fix ) { jQuery.event.special[ orig ] = { delegateType: fix, bindType: fix, handle: function( event ) { var ret, target = this, related = event.relatedTarget, handleObj = event.handleObj; // For mouseenter/leave call the handler if related is outside the target. // NB: No relatedTarget if the mouse left/entered the browser window if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) { event.type = handleObj.origType; ret = handleObj.handler.apply( this, arguments ); event.type = fix; } return ret; } }; } ); jQuery.fn.extend( { on: function( types, selector, data, fn ) { return on( this, types, selector, data, fn ); }, one: function( types, selector, data, fn ) { return on( this, types, selector, data, fn, 1 ); }, off: function( types, selector, fn ) { var handleObj, type; if ( types && types.preventDefault && types.handleObj ) { // ( event ) dispatched jQuery.Event handleObj = types.handleObj; jQuery( types.delegateTarget ).off( handleObj.namespace ? handleObj.origType + "." + handleObj.namespace : handleObj.origType, handleObj.selector, handleObj.handler ); return this; } if ( typeof types === "object" ) { // ( types-object [, selector] ) for ( type in types ) { this.off( type, selector, types[ type ] ); } return this; } if ( selector === false || typeof selector === "function" ) { // ( types [, fn] ) fn = selector; selector = undefined; } if ( fn === false ) { fn = returnFalse; } return this.each( function() { jQuery.event.remove( this, types, fn, selector ); } ); } } ); var // Support: IE <=10 - 11, Edge 12 - 13 only // In IE/Edge using regex groups here causes severe slowdowns. // See https://connect.microsoft.com/IE/feedback/details/1736512/ rnoInnerhtml = /\s*$/g; // Prefer a tbody over its parent table for containing new rows function manipulationTarget( elem, content ) { if ( nodeName( elem, "table" ) && nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) { return jQuery( elem ).children( "tbody" )[ 0 ] || elem; } return elem; } // Replace/restore the type attribute of script elements for safe DOM manipulation function disableScript( elem ) { elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type; return elem; } function restoreScript( elem ) { if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) { elem.type = elem.type.slice( 5 ); } else { elem.removeAttribute( "type" ); } return elem; } function cloneCopyEvent( src, dest ) { var i, l, type, pdataOld, udataOld, udataCur, events; if ( dest.nodeType !== 1 ) { return; } // 1. Copy private data: events, handlers, etc. if ( dataPriv.hasData( src ) ) { pdataOld = dataPriv.get( src ); events = pdataOld.events; if ( events ) { dataPriv.remove( dest, "handle events" ); for ( type in events ) { for ( i = 0, l = events[ type ].length; i < l; i++ ) { jQuery.event.add( dest, type, events[ type ][ i ] ); } } } } // 2. Copy user data if ( dataUser.hasData( src ) ) { udataOld = dataUser.access( src ); udataCur = jQuery.extend( {}, udataOld ); dataUser.set( dest, udataCur ); } } // Fix IE bugs, see support tests function fixInput( src, dest ) { var nodeName = dest.nodeName.toLowerCase(); // Fails to persist the checked state of a cloned checkbox or radio button. if ( nodeName === "input" && rcheckableType.test( src.type ) ) { dest.checked = src.checked; // Fails to return the selected option to the default selected state when cloning options } else if ( nodeName === "input" || nodeName === "textarea" ) { dest.defaultValue = src.defaultValue; } } function domManip( collection, args, callback, ignored ) { // Flatten any nested arrays args = flat( args ); var fragment, first, scripts, hasScripts, node, doc, i = 0, l = collection.length, iNoClone = l - 1, value = args[ 0 ], valueIsFunction = isFunction( value ); // We can't cloneNode fragments that contain checked, in WebKit if ( valueIsFunction || ( l > 1 && typeof value === "string" && !support.checkClone && rchecked.test( value ) ) ) { return collection.each( function( index ) { var self = collection.eq( index ); if ( valueIsFunction ) { args[ 0 ] = value.call( this, index, self.html() ); } domManip( self, args, callback, ignored ); } ); } if ( l ) { fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored ); first = fragment.firstChild; if ( fragment.childNodes.length === 1 ) { fragment = first; } // Require either new content or an interest in ignored elements to invoke the callback if ( first || ignored ) { scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); hasScripts = scripts.length; // Use the original fragment for the last item // instead of the first because it can end up // being emptied incorrectly in certain situations (#8070). for ( ; i < l; i++ ) { node = fragment; if ( i !== iNoClone ) { node = jQuery.clone( node, true, true ); // Keep references to cloned scripts for later restoration if ( hasScripts ) { // Support: Android <=4.0 only, PhantomJS 1 only // push.apply(_, arraylike) throws on ancient WebKit jQuery.merge( scripts, getAll( node, "script" ) ); } } callback.call( collection[ i ], node, i ); } if ( hasScripts ) { doc = scripts[ scripts.length - 1 ].ownerDocument; // Reenable scripts jQuery.map( scripts, restoreScript ); // Evaluate executable scripts on first document insertion for ( i = 0; i < hasScripts; i++ ) { node = scripts[ i ]; if ( rscriptType.test( node.type || "" ) && !dataPriv.access( node, "globalEval" ) && jQuery.contains( doc, node ) ) { if ( node.src && ( node.type || "" ).toLowerCase() !== "module" ) { // Optional AJAX dependency, but won't run scripts if not present if ( jQuery._evalUrl && !node.noModule ) { jQuery._evalUrl( node.src, { nonce: node.nonce || node.getAttribute( "nonce" ) }, doc ); } } else { DOMEval( node.textContent.replace( rcleanScript, "" ), node, doc ); } } } } } } return collection; } function remove( elem, selector, keepData ) { var node, nodes = selector ? jQuery.filter( selector, elem ) : elem, i = 0; for ( ; ( node = nodes[ i ] ) != null; i++ ) { if ( !keepData && node.nodeType === 1 ) { jQuery.cleanData( getAll( node ) ); } if ( node.parentNode ) { if ( keepData && isAttached( node ) ) { setGlobalEval( getAll( node, "script" ) ); } node.parentNode.removeChild( node ); } } return elem; } jQuery.extend( { htmlPrefilter: function( html ) { return html; }, clone: function( elem, dataAndEvents, deepDataAndEvents ) { var i, l, srcElements, destElements, clone = elem.cloneNode( true ), inPage = isAttached( elem ); // Fix IE cloning issues if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) && !jQuery.isXMLDoc( elem ) ) { // We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2 destElements = getAll( clone ); srcElements = getAll( elem ); for ( i = 0, l = srcElements.length; i < l; i++ ) { fixInput( srcElements[ i ], destElements[ i ] ); } } // Copy the events from the original to the clone if ( dataAndEvents ) { if ( deepDataAndEvents ) { srcElements = srcElements || getAll( elem ); destElements = destElements || getAll( clone ); for ( i = 0, l = srcElements.length; i < l; i++ ) { cloneCopyEvent( srcElements[ i ], destElements[ i ] ); } } else { cloneCopyEvent( elem, clone ); } } // Preserve script evaluation history destElements = getAll( clone, "script" ); if ( destElements.length > 0 ) { setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); } // Return the cloned set return clone; }, cleanData: function( elems ) { var data, elem, type, special = jQuery.event.special, i = 0; for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) { if ( acceptData( elem ) ) { if ( ( data = elem[ dataPriv.expando ] ) ) { if ( data.events ) { for ( type in data.events ) { if ( special[ type ] ) { jQuery.event.remove( elem, type ); // This is a shortcut to avoid jQuery.event.remove's overhead } else { jQuery.removeEvent( elem, type, data.handle ); } } } // Support: Chrome <=35 - 45+ // Assign undefined instead of using delete, see Data#remove elem[ dataPriv.expando ] = undefined; } if ( elem[ dataUser.expando ] ) { // Support: Chrome <=35 - 45+ // Assign undefined instead of using delete, see Data#remove elem[ dataUser.expando ] = undefined; } } } } } ); jQuery.fn.extend( { detach: function( selector ) { return remove( this, selector, true ); }, remove: function( selector ) { return remove( this, selector ); }, text: function( value ) { return access( this, function( value ) { return value === undefined ? jQuery.text( this ) : this.empty().each( function() { if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { this.textContent = value; } } ); }, null, value, arguments.length ); }, append: function() { return domManip( this, arguments, function( elem ) { if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { var target = manipulationTarget( this, elem ); target.appendChild( elem ); } } ); }, prepend: function() { return domManip( this, arguments, function( elem ) { if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { var target = manipulationTarget( this, elem ); target.insertBefore( elem, target.firstChild ); } } ); }, before: function() { return domManip( this, arguments, function( elem ) { if ( this.parentNode ) { this.parentNode.insertBefore( elem, this ); } } ); }, after: function() { return domManip( this, arguments, function( elem ) { if ( this.parentNode ) { this.parentNode.insertBefore( elem, this.nextSibling ); } } ); }, empty: function() { var elem, i = 0; for ( ; ( elem = this[ i ] ) != null; i++ ) { if ( elem.nodeType === 1 ) { // Prevent memory leaks jQuery.cleanData( getAll( elem, false ) ); // Remove any remaining nodes elem.textContent = ""; } } return this; }, clone: function( dataAndEvents, deepDataAndEvents ) { dataAndEvents = dataAndEvents == null ? false : dataAndEvents; deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; return this.map( function() { return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); } ); }, html: function( value ) { return access( this, function( value ) { var elem = this[ 0 ] || {}, i = 0, l = this.length; if ( value === undefined && elem.nodeType === 1 ) { return elem.innerHTML; } // See if we can take a shortcut and just use innerHTML if ( typeof value === "string" && !rnoInnerhtml.test( value ) && !wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) { value = jQuery.htmlPrefilter( value ); try { for ( ; i < l; i++ ) { elem = this[ i ] || {}; // Remove element nodes and prevent memory leaks if ( elem.nodeType === 1 ) { jQuery.cleanData( getAll( elem, false ) ); elem.innerHTML = value; } } elem = 0; // If using innerHTML throws an exception, use the fallback method } catch ( e ) {} } if ( elem ) { this.empty().append( value ); } }, null, value, arguments.length ); }, replaceWith: function() { var ignored = []; // Make the changes, replacing each non-ignored context element with the new content return domManip( this, arguments, function( elem ) { var parent = this.parentNode; if ( jQuery.inArray( this, ignored ) < 0 ) { jQuery.cleanData( getAll( this ) ); if ( parent ) { parent.replaceChild( elem, this ); } } // Force callback invocation }, ignored ); } } ); jQuery.each( { appendTo: "append", prependTo: "prepend", insertBefore: "before", insertAfter: "after", replaceAll: "replaceWith" }, function( name, original ) { jQuery.fn[ name ] = function( selector ) { var elems, ret = [], insert = jQuery( selector ), last = insert.length - 1, i = 0; for ( ; i <= last; i++ ) { elems = i === last ? this : this.clone( true ); jQuery( insert[ i ] )[ original ]( elems ); // Support: Android <=4.0 only, PhantomJS 1 only // .get() because push.apply(_, arraylike) throws on ancient WebKit push.apply( ret, elems.get() ); } return this.pushStack( ret ); }; } ); var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" ); var getStyles = function( elem ) { // Support: IE <=11 only, Firefox <=30 (#15098, #14150) // IE throws on elements created in popups // FF meanwhile throws on frame elements through "defaultView.getComputedStyle" var view = elem.ownerDocument.defaultView; if ( !view || !view.opener ) { view = window; } return view.getComputedStyle( elem ); }; var swap = function( elem, options, callback ) { var ret, name, old = {}; // Remember the old values, and insert the new ones for ( name in options ) { old[ name ] = elem.style[ name ]; elem.style[ name ] = options[ name ]; } ret = callback.call( elem ); // Revert the old values for ( name in options ) { elem.style[ name ] = old[ name ]; } return ret; }; var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" ); ( function() { // Executing both pixelPosition & boxSizingReliable tests require only one layout // so they're executed at the same time to save the second computation. function computeStyleTests() { // This is a singleton, we need to execute it only once if ( !div ) { return; } container.style.cssText = "position:absolute;left:-11111px;width:60px;" + "margin-top:1px;padding:0;border:0"; div.style.cssText = "position:relative;display:block;box-sizing:border-box;overflow:scroll;" + "margin:auto;border:1px;padding:1px;" + "width:60%;top:1%"; documentElement.appendChild( container ).appendChild( div ); var divStyle = window.getComputedStyle( div ); pixelPositionVal = divStyle.top !== "1%"; // Support: Android 4.0 - 4.3 only, Firefox <=3 - 44 reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12; // Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3 // Some styles come back with percentage values, even though they shouldn't div.style.right = "60%"; pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36; // Support: IE 9 - 11 only // Detect misreporting of content dimensions for box-sizing:border-box elements boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36; // Support: IE 9 only // Detect overflow:scroll screwiness (gh-3699) // Support: Chrome <=64 // Don't get tricked when zoom affects offsetWidth (gh-4029) div.style.position = "absolute"; scrollboxSizeVal = roundPixelMeasures( div.offsetWidth / 3 ) === 12; documentElement.removeChild( container ); // Nullify the div so it wouldn't be stored in the memory and // it will also be a sign that checks already performed div = null; } function roundPixelMeasures( measure ) { return Math.round( parseFloat( measure ) ); } var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal, reliableTrDimensionsVal, reliableMarginLeftVal, container = document.createElement( "div" ), div = document.createElement( "div" ); // Finish early in limited (non-browser) environments if ( !div.style ) { return; } // Support: IE <=9 - 11 only // Style of cloned element affects source element cloned (#8908) div.style.backgroundClip = "content-box"; div.cloneNode( true ).style.backgroundClip = ""; support.clearCloneStyle = div.style.backgroundClip === "content-box"; jQuery.extend( support, { boxSizingReliable: function() { computeStyleTests(); return boxSizingReliableVal; }, pixelBoxStyles: function() { computeStyleTests(); return pixelBoxStylesVal; }, pixelPosition: function() { computeStyleTests(); return pixelPositionVal; }, reliableMarginLeft: function() { computeStyleTests(); return reliableMarginLeftVal; }, scrollboxSize: function() { computeStyleTests(); return scrollboxSizeVal; }, // Support: IE 9 - 11+, Edge 15 - 18+ // IE/Edge misreport `getComputedStyle` of table rows with width/height // set in CSS while `offset*` properties report correct values. // Behavior in IE 9 is more subtle than in newer versions & it passes // some versions of this test; make sure not to make it pass there! reliableTrDimensions: function() { var table, tr, trChild, trStyle; if ( reliableTrDimensionsVal == null ) { table = document.createElement( "table" ); tr = document.createElement( "tr" ); trChild = document.createElement( "div" ); table.style.cssText = "position:absolute;left:-11111px"; tr.style.height = "1px"; trChild.style.height = "9px"; documentElement .appendChild( table ) .appendChild( tr ) .appendChild( trChild ); trStyle = window.getComputedStyle( tr ); reliableTrDimensionsVal = parseInt( trStyle.height ) > 3; documentElement.removeChild( table ); } return reliableTrDimensionsVal; } } ); } )(); function curCSS( elem, name, computed ) { var width, minWidth, maxWidth, ret, // Support: Firefox 51+ // Retrieving style before computed somehow // fixes an issue with getting wrong values // on detached elements style = elem.style; computed = computed || getStyles( elem ); // getPropertyValue is needed for: // .css('filter') (IE 9 only, #12537) // .css('--customProperty) (#3144) if ( computed ) { ret = computed.getPropertyValue( name ) || computed[ name ]; if ( ret === "" && !isAttached( elem ) ) { ret = jQuery.style( elem, name ); } // A tribute to the "awesome hack by Dean Edwards" // Android Browser returns percentage for some values, // but width seems to be reliably pixels. // This is against the CSSOM draft spec: // https://drafts.csswg.org/cssom/#resolved-values if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) { // Remember the original values width = style.width; minWidth = style.minWidth; maxWidth = style.maxWidth; // Put in the new values to get a computed value out style.minWidth = style.maxWidth = style.width = ret; ret = computed.width; // Revert the changed values style.width = width; style.minWidth = minWidth; style.maxWidth = maxWidth; } } return ret !== undefined ? // Support: IE <=9 - 11 only // IE returns zIndex value as an integer. ret + "" : ret; } function addGetHookIf( conditionFn, hookFn ) { // Define the hook, we'll check on the first run if it's really needed. return { get: function() { if ( conditionFn() ) { // Hook not needed (or it's not possible to use it due // to missing dependency), remove it. delete this.get; return; } // Hook needed; redefine it so that the support test is not executed again. return ( this.get = hookFn ).apply( this, arguments ); } }; } var cssPrefixes = [ "Webkit", "Moz", "ms" ], emptyStyle = document.createElement( "div" ).style, vendorProps = {}; // Return a vendor-prefixed property or undefined function vendorPropName( name ) { // Check for vendor prefixed names var capName = name[ 0 ].toUpperCase() + name.slice( 1 ), i = cssPrefixes.length; while ( i-- ) { name = cssPrefixes[ i ] + capName; if ( name in emptyStyle ) { return name; } } } // Return a potentially-mapped jQuery.cssProps or vendor prefixed property function finalPropName( name ) { var final = jQuery.cssProps[ name ] || vendorProps[ name ]; if ( final ) { return final; } if ( name in emptyStyle ) { return name; } return vendorProps[ name ] = vendorPropName( name ) || name; } var // Swappable if display is none or starts with table // except "table", "table-cell", or "table-caption" // See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display rdisplayswap = /^(none|table(?!-c[ea]).+)/, rcustomProp = /^--/, cssShow = { position: "absolute", visibility: "hidden", display: "block" }, cssNormalTransform = { letterSpacing: "0", fontWeight: "400" }; function setPositiveNumber( _elem, value, subtract ) { // Any relative (+/-) values have already been // normalized at this point var matches = rcssNum.exec( value ); return matches ? // Guard against undefined "subtract", e.g., when used as in cssHooks Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) : value; } function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) { var i = dimension === "width" ? 1 : 0, extra = 0, delta = 0; // Adjustment may not be necessary if ( box === ( isBorderBox ? "border" : "content" ) ) { return 0; } for ( ; i < 4; i += 2 ) { // Both box models exclude margin if ( box === "margin" ) { delta += jQuery.css( elem, box + cssExpand[ i ], true, styles ); } // If we get here with a content-box, we're seeking "padding" or "border" or "margin" if ( !isBorderBox ) { // Add padding delta += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); // For "border" or "margin", add border if ( box !== "padding" ) { delta += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); // But still keep track of it otherwise } else { extra += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); } // If we get here with a border-box (content + padding + border), we're seeking "content" or // "padding" or "margin" } else { // For "content", subtract padding if ( box === "content" ) { delta -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); } // For "content" or "padding", subtract border if ( box !== "margin" ) { delta -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); } } } // Account for positive content-box scroll gutter when requested by providing computedVal if ( !isBorderBox && computedVal >= 0 ) { // offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border // Assuming integer scroll gutter, subtract the rest and round down delta += Math.max( 0, Math.ceil( elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - computedVal - delta - extra - 0.5 // If offsetWidth/offsetHeight is unknown, then we can't determine content-box scroll gutter // Use an explicit zero to avoid NaN (gh-3964) ) ) || 0; } return delta; } function getWidthOrHeight( elem, dimension, extra ) { // Start with computed style var styles = getStyles( elem ), // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-4322). // Fake content-box until we know it's needed to know the true value. boxSizingNeeded = !support.boxSizingReliable() || extra, isBorderBox = boxSizingNeeded && jQuery.css( elem, "boxSizing", false, styles ) === "border-box", valueIsBorderBox = isBorderBox, val = curCSS( elem, dimension, styles ), offsetProp = "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ); // Support: Firefox <=54 // Return a confounding non-pixel value or feign ignorance, as appropriate. if ( rnumnonpx.test( val ) ) { if ( !extra ) { return val; } val = "auto"; } // Support: IE 9 - 11 only // Use offsetWidth/offsetHeight for when box sizing is unreliable. // In those cases, the computed value can be trusted to be border-box. if ( ( !support.boxSizingReliable() && isBorderBox || // Support: IE 10 - 11+, Edge 15 - 18+ // IE/Edge misreport `getComputedStyle` of table rows with width/height // set in CSS while `offset*` properties report correct values. // Interestingly, in some cases IE 9 doesn't suffer from this issue. !support.reliableTrDimensions() && nodeName( elem, "tr" ) || // Fall back to offsetWidth/offsetHeight when value is "auto" // This happens for inline elements with no explicit setting (gh-3571) val === "auto" || // Support: Android <=4.1 - 4.3 only // Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602) !parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) && // Make sure the element is visible & connected elem.getClientRects().length ) { isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box"; // Where available, offsetWidth/offsetHeight approximate border box dimensions. // Where not available (e.g., SVG), assume unreliable box-sizing and interpret the // retrieved value as a content box dimension. valueIsBorderBox = offsetProp in elem; if ( valueIsBorderBox ) { val = elem[ offsetProp ]; } } // Normalize "" and auto val = parseFloat( val ) || 0; // Adjust for the element's box model return ( val + boxModelAdjustment( elem, dimension, extra || ( isBorderBox ? "border" : "content" ), valueIsBorderBox, styles, // Provide the current computed size to request scroll gutter calculation (gh-3589) val ) ) + "px"; } jQuery.extend( { // Add in style property hooks for overriding the default // behavior of getting and setting a style property cssHooks: { opacity: { get: function( elem, computed ) { if ( computed ) { // We should always get a number back from opacity var ret = curCSS( elem, "opacity" ); return ret === "" ? "1" : ret; } } } }, // Don't automatically add "px" to these possibly-unitless properties cssNumber: { "animationIterationCount": true, "columnCount": true, "fillOpacity": true, "flexGrow": true, "flexShrink": true, "fontWeight": true, "gridArea": true, "gridColumn": true, "gridColumnEnd": true, "gridColumnStart": true, "gridRow": true, "gridRowEnd": true, "gridRowStart": true, "lineHeight": true, "opacity": true, "order": true, "orphans": true, "widows": true, "zIndex": true, "zoom": true }, // Add in properties whose names you wish to fix before // setting or getting the value cssProps: {}, // Get and set the style property on a DOM Node style: function( elem, name, value, extra ) { // Don't set styles on text and comment nodes if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { return; } // Make sure that we're working with the right name var ret, type, hooks, origName = camelCase( name ), isCustomProp = rcustomProp.test( name ), style = elem.style; // Make sure that we're working with the right name. We don't // want to query the value if it is a CSS custom property // since they are user-defined. if ( !isCustomProp ) { name = finalPropName( origName ); } // Gets hook for the prefixed version, then unprefixed version hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; // Check if we're setting a value if ( value !== undefined ) { type = typeof value; // Convert "+=" or "-=" to relative numbers (#7345) if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) { value = adjustCSS( elem, name, ret ); // Fixes bug #9237 type = "number"; } // Make sure that null and NaN values aren't set (#7116) if ( value == null || value !== value ) { return; } // If a number was passed in, add the unit (except for certain CSS properties) // The isCustomProp check can be removed in jQuery 4.0 when we only auto-append // "px" to a few hardcoded values. if ( type === "number" && !isCustomProp ) { value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" ); } // background-* props affect original clone's values if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) { style[ name ] = "inherit"; } // If a hook was provided, use that value, otherwise just set the specified value if ( !hooks || !( "set" in hooks ) || ( value = hooks.set( elem, value, extra ) ) !== undefined ) { if ( isCustomProp ) { style.setProperty( name, value ); } else { style[ name ] = value; } } } else { // If a hook was provided get the non-computed value from there if ( hooks && "get" in hooks && ( ret = hooks.get( elem, false, extra ) ) !== undefined ) { return ret; } // Otherwise just get the value from the style object return style[ name ]; } }, css: function( elem, name, extra, styles ) { var val, num, hooks, origName = camelCase( name ), isCustomProp = rcustomProp.test( name ); // Make sure that we're working with the right name. We don't // want to modify the value if it is a CSS custom property // since they are user-defined. if ( !isCustomProp ) { name = finalPropName( origName ); } // Try prefixed name followed by the unprefixed name hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; // If a hook was provided get the computed value from there if ( hooks && "get" in hooks ) { val = hooks.get( elem, true, extra ); } // Otherwise, if a way to get the computed value exists, use that if ( val === undefined ) { val = curCSS( elem, name, styles ); } // Convert "normal" to computed value if ( val === "normal" && name in cssNormalTransform ) { val = cssNormalTransform[ name ]; } // Make numeric if forced or a qualifier was provided and val looks numeric if ( extra === "" || extra ) { num = parseFloat( val ); return extra === true || isFinite( num ) ? num || 0 : val; } return val; } } ); jQuery.each( [ "height", "width" ], function( _i, dimension ) { jQuery.cssHooks[ dimension ] = { get: function( elem, computed, extra ) { if ( computed ) { // Certain elements can have dimension info if we invisibly show them // but it must have a current display style that would benefit return rdisplayswap.test( jQuery.css( elem, "display" ) ) && // Support: Safari 8+ // Table columns in Safari have non-zero offsetWidth & zero // getBoundingClientRect().width unless display is changed. // Support: IE <=11 only // Running getBoundingClientRect on a disconnected node // in IE throws an error. ( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ? swap( elem, cssShow, function() { return getWidthOrHeight( elem, dimension, extra ); } ) : getWidthOrHeight( elem, dimension, extra ); } }, set: function( elem, value, extra ) { var matches, styles = getStyles( elem ), // Only read styles.position if the test has a chance to fail // to avoid forcing a reflow. scrollboxSizeBuggy = !support.scrollboxSize() && styles.position === "absolute", // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-3991) boxSizingNeeded = scrollboxSizeBuggy || extra, isBorderBox = boxSizingNeeded && jQuery.css( elem, "boxSizing", false, styles ) === "border-box", subtract = extra ? boxModelAdjustment( elem, dimension, extra, isBorderBox, styles ) : 0; // Account for unreliable border-box dimensions by comparing offset* to computed and // faking a content-box to get border and padding (gh-3699) if ( isBorderBox && scrollboxSizeBuggy ) { subtract -= Math.ceil( elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - parseFloat( styles[ dimension ] ) - boxModelAdjustment( elem, dimension, "border", false, styles ) - 0.5 ); } // Convert to pixels if value adjustment is needed if ( subtract && ( matches = rcssNum.exec( value ) ) && ( matches[ 3 ] || "px" ) !== "px" ) { elem.style[ dimension ] = value; value = jQuery.css( elem, dimension ); } return setPositiveNumber( elem, value, subtract ); } }; } ); jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft, function( elem, computed ) { if ( computed ) { return ( parseFloat( curCSS( elem, "marginLeft" ) ) || elem.getBoundingClientRect().left - swap( elem, { marginLeft: 0 }, function() { return elem.getBoundingClientRect().left; } ) ) + "px"; } } ); // These hooks are used by animate to expand properties jQuery.each( { margin: "", padding: "", border: "Width" }, function( prefix, suffix ) { jQuery.cssHooks[ prefix + suffix ] = { expand: function( value ) { var i = 0, expanded = {}, // Assumes a single number if not a string parts = typeof value === "string" ? value.split( " " ) : [ value ]; for ( ; i < 4; i++ ) { expanded[ prefix + cssExpand[ i ] + suffix ] = parts[ i ] || parts[ i - 2 ] || parts[ 0 ]; } return expanded; } }; if ( prefix !== "margin" ) { jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber; } } ); jQuery.fn.extend( { css: function( name, value ) { return access( this, function( elem, name, value ) { var styles, len, map = {}, i = 0; if ( Array.isArray( name ) ) { styles = getStyles( elem ); len = name.length; for ( ; i < len; i++ ) { map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles ); } return map; } return value !== undefined ? jQuery.style( elem, name, value ) : jQuery.css( elem, name ); }, name, value, arguments.length > 1 ); } } ); function Tween( elem, options, prop, end, easing ) { return new Tween.prototype.init( elem, options, prop, end, easing ); } jQuery.Tween = Tween; Tween.prototype = { constructor: Tween, init: function( elem, options, prop, end, easing, unit ) { this.elem = elem; this.prop = prop; this.easing = easing || jQuery.easing._default; this.options = options; this.start = this.now = this.cur(); this.end = end; this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" ); }, cur: function() { var hooks = Tween.propHooks[ this.prop ]; return hooks && hooks.get ? hooks.get( this ) : Tween.propHooks._default.get( this ); }, run: function( percent ) { var eased, hooks = Tween.propHooks[ this.prop ]; if ( this.options.duration ) { this.pos = eased = jQuery.easing[ this.easing ]( percent, this.options.duration * percent, 0, 1, this.options.duration ); } else { this.pos = eased = percent; } this.now = ( this.end - this.start ) * eased + this.start; if ( this.options.step ) { this.options.step.call( this.elem, this.now, this ); } if ( hooks && hooks.set ) { hooks.set( this ); } else { Tween.propHooks._default.set( this ); } return this; } }; Tween.prototype.init.prototype = Tween.prototype; Tween.propHooks = { _default: { get: function( tween ) { var result; // Use a property on the element directly when it is not a DOM element, // or when there is no matching style property that exists. if ( tween.elem.nodeType !== 1 || tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) { return tween.elem[ tween.prop ]; } // Passing an empty string as a 3rd parameter to .css will automatically // attempt a parseFloat and fallback to a string if the parse fails. // Simple values such as "10px" are parsed to Float; // complex values such as "rotate(1rad)" are returned as-is. result = jQuery.css( tween.elem, tween.prop, "" ); // Empty strings, null, undefined and "auto" are converted to 0. return !result || result === "auto" ? 0 : result; }, set: function( tween ) { // Use step hook for back compat. // Use cssHook if its there. // Use .style if available and use plain properties where available. if ( jQuery.fx.step[ tween.prop ] ) { jQuery.fx.step[ tween.prop ]( tween ); } else if ( tween.elem.nodeType === 1 && ( jQuery.cssHooks[ tween.prop ] || tween.elem.style[ finalPropName( tween.prop ) ] != null ) ) { jQuery.style( tween.elem, tween.prop, tween.now + tween.unit ); } else { tween.elem[ tween.prop ] = tween.now; } } } }; // Support: IE <=9 only // Panic based approach to setting things on disconnected nodes Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = { set: function( tween ) { if ( tween.elem.nodeType && tween.elem.parentNode ) { tween.elem[ tween.prop ] = tween.now; } } }; jQuery.easing = { linear: function( p ) { return p; }, swing: function( p ) { return 0.5 - Math.cos( p * Math.PI ) / 2; }, _default: "swing" }; jQuery.fx = Tween.prototype.init; // Back compat <1.8 extension point jQuery.fx.step = {}; var fxNow, inProgress, rfxtypes = /^(?:toggle|show|hide)$/, rrun = /queueHooks$/; function schedule() { if ( inProgress ) { if ( document.hidden === false && window.requestAnimationFrame ) { window.requestAnimationFrame( schedule ); } else { window.setTimeout( schedule, jQuery.fx.interval ); } jQuery.fx.tick(); } } // Animations created synchronously will run synchronously function createFxNow() { window.setTimeout( function() { fxNow = undefined; } ); return ( fxNow = Date.now() ); } // Generate parameters to create a standard animation function genFx( type, includeWidth ) { var which, i = 0, attrs = { height: type }; // If we include width, step value is 1 to do all cssExpand values, // otherwise step value is 2 to skip over Left and Right includeWidth = includeWidth ? 1 : 0; for ( ; i < 4; i += 2 - includeWidth ) { which = cssExpand[ i ]; attrs[ "margin" + which ] = attrs[ "padding" + which ] = type; } if ( includeWidth ) { attrs.opacity = attrs.width = type; } return attrs; } function createTween( value, prop, animation ) { var tween, collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ), index = 0, length = collection.length; for ( ; index < length; index++ ) { if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) { // We're done with this property return tween; } } } function defaultPrefilter( elem, props, opts ) { var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display, isBox = "width" in props || "height" in props, anim = this, orig = {}, style = elem.style, hidden = elem.nodeType && isHiddenWithinTree( elem ), dataShow = dataPriv.get( elem, "fxshow" ); // Queue-skipping animations hijack the fx hooks if ( !opts.queue ) { hooks = jQuery._queueHooks( elem, "fx" ); if ( hooks.unqueued == null ) { hooks.unqueued = 0; oldfire = hooks.empty.fire; hooks.empty.fire = function() { if ( !hooks.unqueued ) { oldfire(); } }; } hooks.unqueued++; anim.always( function() { // Ensure the complete handler is called before this completes anim.always( function() { hooks.unqueued--; if ( !jQuery.queue( elem, "fx" ).length ) { hooks.empty.fire(); } } ); } ); } // Detect show/hide animations for ( prop in props ) { value = props[ prop ]; if ( rfxtypes.test( value ) ) { delete props[ prop ]; toggle = toggle || value === "toggle"; if ( value === ( hidden ? "hide" : "show" ) ) { // Pretend to be hidden if this is a "show" and // there is still data from a stopped show/hide if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) { hidden = true; // Ignore all other no-op show/hide data } else { continue; } } orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop ); } } // Bail out if this is a no-op like .hide().hide() propTween = !jQuery.isEmptyObject( props ); if ( !propTween && jQuery.isEmptyObject( orig ) ) { return; } // Restrict "overflow" and "display" styles during box animations if ( isBox && elem.nodeType === 1 ) { // Support: IE <=9 - 11, Edge 12 - 15 // Record all 3 overflow attributes because IE does not infer the shorthand // from identically-valued overflowX and overflowY and Edge just mirrors // the overflowX value there. opts.overflow = [ style.overflow, style.overflowX, style.overflowY ]; // Identify a display type, preferring old show/hide data over the CSS cascade restoreDisplay = dataShow && dataShow.display; if ( restoreDisplay == null ) { restoreDisplay = dataPriv.get( elem, "display" ); } display = jQuery.css( elem, "display" ); if ( display === "none" ) { if ( restoreDisplay ) { display = restoreDisplay; } else { // Get nonempty value(s) by temporarily forcing visibility showHide( [ elem ], true ); restoreDisplay = elem.style.display || restoreDisplay; display = jQuery.css( elem, "display" ); showHide( [ elem ] ); } } // Animate inline elements as inline-block if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) { if ( jQuery.css( elem, "float" ) === "none" ) { // Restore the original display value at the end of pure show/hide animations if ( !propTween ) { anim.done( function() { style.display = restoreDisplay; } ); if ( restoreDisplay == null ) { display = style.display; restoreDisplay = display === "none" ? "" : display; } } style.display = "inline-block"; } } } if ( opts.overflow ) { style.overflow = "hidden"; anim.always( function() { style.overflow = opts.overflow[ 0 ]; style.overflowX = opts.overflow[ 1 ]; style.overflowY = opts.overflow[ 2 ]; } ); } // Implement show/hide animations propTween = false; for ( prop in orig ) { // General show/hide setup for this element animation if ( !propTween ) { if ( dataShow ) { if ( "hidden" in dataShow ) { hidden = dataShow.hidden; } } else { dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } ); } // Store hidden/visible for toggle so `.stop().toggle()` "reverses" if ( toggle ) { dataShow.hidden = !hidden; } // Show elements before animating them if ( hidden ) { showHide( [ elem ], true ); } /* eslint-disable no-loop-func */ anim.done( function() { /* eslint-enable no-loop-func */ // The final step of a "hide" animation is actually hiding the element if ( !hidden ) { showHide( [ elem ] ); } dataPriv.remove( elem, "fxshow" ); for ( prop in orig ) { jQuery.style( elem, prop, orig[ prop ] ); } } ); } // Per-property setup propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim ); if ( !( prop in dataShow ) ) { dataShow[ prop ] = propTween.start; if ( hidden ) { propTween.end = propTween.start; propTween.start = 0; } } } } function propFilter( props, specialEasing ) { var index, name, easing, value, hooks; // camelCase, specialEasing and expand cssHook pass for ( index in props ) { name = camelCase( index ); easing = specialEasing[ name ]; value = props[ index ]; if ( Array.isArray( value ) ) { easing = value[ 1 ]; value = props[ index ] = value[ 0 ]; } if ( index !== name ) { props[ name ] = value; delete props[ index ]; } hooks = jQuery.cssHooks[ name ]; if ( hooks && "expand" in hooks ) { value = hooks.expand( value ); delete props[ name ]; // Not quite $.extend, this won't overwrite existing keys. // Reusing 'index' because we have the correct "name" for ( index in value ) { if ( !( index in props ) ) { props[ index ] = value[ index ]; specialEasing[ index ] = easing; } } } else { specialEasing[ name ] = easing; } } } function Animation( elem, properties, options ) { var result, stopped, index = 0, length = Animation.prefilters.length, deferred = jQuery.Deferred().always( function() { // Don't match elem in the :animated selector delete tick.elem; } ), tick = function() { if ( stopped ) { return false; } var currentTime = fxNow || createFxNow(), remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ), // Support: Android 2.3 only // Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497) temp = remaining / animation.duration || 0, percent = 1 - temp, index = 0, length = animation.tweens.length; for ( ; index < length; index++ ) { animation.tweens[ index ].run( percent ); } deferred.notifyWith( elem, [ animation, percent, remaining ] ); // If there's more to do, yield if ( percent < 1 && length ) { return remaining; } // If this was an empty animation, synthesize a final progress notification if ( !length ) { deferred.notifyWith( elem, [ animation, 1, 0 ] ); } // Resolve the animation and report its conclusion deferred.resolveWith( elem, [ animation ] ); return false; }, animation = deferred.promise( { elem: elem, props: jQuery.extend( {}, properties ), opts: jQuery.extend( true, { specialEasing: {}, easing: jQuery.easing._default }, options ), originalProperties: properties, originalOptions: options, startTime: fxNow || createFxNow(), duration: options.duration, tweens: [], createTween: function( prop, end ) { var tween = jQuery.Tween( elem, animation.opts, prop, end, animation.opts.specialEasing[ prop ] || animation.opts.easing ); animation.tweens.push( tween ); return tween; }, stop: function( gotoEnd ) { var index = 0, // If we are going to the end, we want to run all the tweens // otherwise we skip this part length = gotoEnd ? animation.tweens.length : 0; if ( stopped ) { return this; } stopped = true; for ( ; index < length; index++ ) { animation.tweens[ index ].run( 1 ); } // Resolve when we played the last frame; otherwise, reject if ( gotoEnd ) { deferred.notifyWith( elem, [ animation, 1, 0 ] ); deferred.resolveWith( elem, [ animation, gotoEnd ] ); } else { deferred.rejectWith( elem, [ animation, gotoEnd ] ); } return this; } } ), props = animation.props; propFilter( props, animation.opts.specialEasing ); for ( ; index < length; index++ ) { result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts ); if ( result ) { if ( isFunction( result.stop ) ) { jQuery._queueHooks( animation.elem, animation.opts.queue ).stop = result.stop.bind( result ); } return result; } } jQuery.map( props, createTween, animation ); if ( isFunction( animation.opts.start ) ) { animation.opts.start.call( elem, animation ); } // Attach callbacks from options animation .progress( animation.opts.progress ) .done( animation.opts.done, animation.opts.complete ) .fail( animation.opts.fail ) .always( animation.opts.always ); jQuery.fx.timer( jQuery.extend( tick, { elem: elem, anim: animation, queue: animation.opts.queue } ) ); return animation; } jQuery.Animation = jQuery.extend( Animation, { tweeners: { "*": [ function( prop, value ) { var tween = this.createTween( prop, value ); adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween ); return tween; } ] }, tweener: function( props, callback ) { if ( isFunction( props ) ) { callback = props; props = [ "*" ]; } else { props = props.match( rnothtmlwhite ); } var prop, index = 0, length = props.length; for ( ; index < length; index++ ) { prop = props[ index ]; Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || []; Animation.tweeners[ prop ].unshift( callback ); } }, prefilters: [ defaultPrefilter ], prefilter: function( callback, prepend ) { if ( prepend ) { Animation.prefilters.unshift( callback ); } else { Animation.prefilters.push( callback ); } } } ); jQuery.speed = function( speed, easing, fn ) { var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : { complete: fn || !fn && easing || isFunction( speed ) && speed, duration: speed, easing: fn && easing || easing && !isFunction( easing ) && easing }; // Go to the end state if fx are off if ( jQuery.fx.off ) { opt.duration = 0; } else { if ( typeof opt.duration !== "number" ) { if ( opt.duration in jQuery.fx.speeds ) { opt.duration = jQuery.fx.speeds[ opt.duration ]; } else { opt.duration = jQuery.fx.speeds._default; } } } // Normalize opt.queue - true/undefined/null -> "fx" if ( opt.queue == null || opt.queue === true ) { opt.queue = "fx"; } // Queueing opt.old = opt.complete; opt.complete = function() { if ( isFunction( opt.old ) ) { opt.old.call( this ); } if ( opt.queue ) { jQuery.dequeue( this, opt.queue ); } }; return opt; }; jQuery.fn.extend( { fadeTo: function( speed, to, easing, callback ) { // Show any hidden elements after setting opacity to 0 return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show() // Animate to the value specified .end().animate( { opacity: to }, speed, easing, callback ); }, animate: function( prop, speed, easing, callback ) { var empty = jQuery.isEmptyObject( prop ), optall = jQuery.speed( speed, easing, callback ), doAnimation = function() { // Operate on a copy of prop so per-property easing won't be lost var anim = Animation( this, jQuery.extend( {}, prop ), optall ); // Empty animations, or finishing resolves immediately if ( empty || dataPriv.get( this, "finish" ) ) { anim.stop( true ); } }; doAnimation.finish = doAnimation; return empty || optall.queue === false ? this.each( doAnimation ) : this.queue( optall.queue, doAnimation ); }, stop: function( type, clearQueue, gotoEnd ) { var stopQueue = function( hooks ) { var stop = hooks.stop; delete hooks.stop; stop( gotoEnd ); }; if ( typeof type !== "string" ) { gotoEnd = clearQueue; clearQueue = type; type = undefined; } if ( clearQueue ) { this.queue( type || "fx", [] ); } return this.each( function() { var dequeue = true, index = type != null && type + "queueHooks", timers = jQuery.timers, data = dataPriv.get( this ); if ( index ) { if ( data[ index ] && data[ index ].stop ) { stopQueue( data[ index ] ); } } else { for ( index in data ) { if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) { stopQueue( data[ index ] ); } } } for ( index = timers.length; index--; ) { if ( timers[ index ].elem === this && ( type == null || timers[ index ].queue === type ) ) { timers[ index ].anim.stop( gotoEnd ); dequeue = false; timers.splice( index, 1 ); } } // Start the next in the queue if the last step wasn't forced. // Timers currently will call their complete callbacks, which // will dequeue but only if they were gotoEnd. if ( dequeue || !gotoEnd ) { jQuery.dequeue( this, type ); } } ); }, finish: function( type ) { if ( type !== false ) { type = type || "fx"; } return this.each( function() { var index, data = dataPriv.get( this ), queue = data[ type + "queue" ], hooks = data[ type + "queueHooks" ], timers = jQuery.timers, length = queue ? queue.length : 0; // Enable finishing flag on private data data.finish = true; // Empty the queue first jQuery.queue( this, type, [] ); if ( hooks && hooks.stop ) { hooks.stop.call( this, true ); } // Look for any active animations, and finish them for ( index = timers.length; index--; ) { if ( timers[ index ].elem === this && timers[ index ].queue === type ) { timers[ index ].anim.stop( true ); timers.splice( index, 1 ); } } // Look for any animations in the old queue and finish them for ( index = 0; index < length; index++ ) { if ( queue[ index ] && queue[ index ].finish ) { queue[ index ].finish.call( this ); } } // Turn off finishing flag delete data.finish; } ); } } ); jQuery.each( [ "toggle", "show", "hide" ], function( _i, name ) { var cssFn = jQuery.fn[ name ]; jQuery.fn[ name ] = function( speed, easing, callback ) { return speed == null || typeof speed === "boolean" ? cssFn.apply( this, arguments ) : this.animate( genFx( name, true ), speed, easing, callback ); }; } ); // Generate shortcuts for custom animations jQuery.each( { slideDown: genFx( "show" ), slideUp: genFx( "hide" ), slideToggle: genFx( "toggle" ), fadeIn: { opacity: "show" }, fadeOut: { opacity: "hide" }, fadeToggle: { opacity: "toggle" } }, function( name, props ) { jQuery.fn[ name ] = function( speed, easing, callback ) { return this.animate( props, speed, easing, callback ); }; } ); jQuery.timers = []; jQuery.fx.tick = function() { var timer, i = 0, timers = jQuery.timers; fxNow = Date.now(); for ( ; i < timers.length; i++ ) { timer = timers[ i ]; // Run the timer and safely remove it when done (allowing for external removal) if ( !timer() && timers[ i ] === timer ) { timers.splice( i--, 1 ); } } if ( !timers.length ) { jQuery.fx.stop(); } fxNow = undefined; }; jQuery.fx.timer = function( timer ) { jQuery.timers.push( timer ); jQuery.fx.start(); }; jQuery.fx.interval = 13; jQuery.fx.start = function() { if ( inProgress ) { return; } inProgress = true; schedule(); }; jQuery.fx.stop = function() { inProgress = null; }; jQuery.fx.speeds = { slow: 600, fast: 200, // Default speed _default: 400 }; // Based off of the plugin by Clint Helfers, with permission. // https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/ jQuery.fn.delay = function( time, type ) { time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; type = type || "fx"; return this.queue( type, function( next, hooks ) { var timeout = window.setTimeout( next, time ); hooks.stop = function() { window.clearTimeout( timeout ); }; } ); }; ( function() { var input = document.createElement( "input" ), select = document.createElement( "select" ), opt = select.appendChild( document.createElement( "option" ) ); input.type = "checkbox"; // Support: Android <=4.3 only // Default value for a checkbox should be "on" support.checkOn = input.value !== ""; // Support: IE <=11 only // Must access selectedIndex to make default options select support.optSelected = opt.selected; // Support: IE <=11 only // An input loses its value after becoming a radio input = document.createElement( "input" ); input.value = "t"; input.type = "radio"; support.radioValue = input.value === "t"; } )(); var boolHook, attrHandle = jQuery.expr.attrHandle; jQuery.fn.extend( { attr: function( name, value ) { return access( this, jQuery.attr, name, value, arguments.length > 1 ); }, removeAttr: function( name ) { return this.each( function() { jQuery.removeAttr( this, name ); } ); } } ); jQuery.extend( { attr: function( elem, name, value ) { var ret, hooks, nType = elem.nodeType; // Don't get/set attributes on text, comment and attribute nodes if ( nType === 3 || nType === 8 || nType === 2 ) { return; } // Fallback to prop when attributes are not supported if ( typeof elem.getAttribute === "undefined" ) { return jQuery.prop( elem, name, value ); } // Attribute hooks are determined by the lowercase version // Grab necessary hook if one is defined if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { hooks = jQuery.attrHooks[ name.toLowerCase() ] || ( jQuery.expr.match.bool.test( name ) ? boolHook : undefined ); } if ( value !== undefined ) { if ( value === null ) { jQuery.removeAttr( elem, name ); return; } if ( hooks && "set" in hooks && ( ret = hooks.set( elem, value, name ) ) !== undefined ) { return ret; } elem.setAttribute( name, value + "" ); return value; } if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { return ret; } ret = jQuery.find.attr( elem, name ); // Non-existent attributes return null, we normalize to undefined return ret == null ? undefined : ret; }, attrHooks: { type: { set: function( elem, value ) { if ( !support.radioValue && value === "radio" && nodeName( elem, "input" ) ) { var val = elem.value; elem.setAttribute( "type", value ); if ( val ) { elem.value = val; } return value; } } } }, removeAttr: function( elem, value ) { var name, i = 0, // Attribute names can contain non-HTML whitespace characters // https://html.spec.whatwg.org/multipage/syntax.html#attributes-2 attrNames = value && value.match( rnothtmlwhite ); if ( attrNames && elem.nodeType === 1 ) { while ( ( name = attrNames[ i++ ] ) ) { elem.removeAttribute( name ); } } } } ); // Hooks for boolean attributes boolHook = { set: function( elem, value, name ) { if ( value === false ) { // Remove boolean attributes when set to false jQuery.removeAttr( elem, name ); } else { elem.setAttribute( name, name ); } return name; } }; jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( _i, name ) { var getter = attrHandle[ name ] || jQuery.find.attr; attrHandle[ name ] = function( elem, name, isXML ) { var ret, handle, lowercaseName = name.toLowerCase(); if ( !isXML ) { // Avoid an infinite loop by temporarily removing this function from the getter handle = attrHandle[ lowercaseName ]; attrHandle[ lowercaseName ] = ret; ret = getter( elem, name, isXML ) != null ? lowercaseName : null; attrHandle[ lowercaseName ] = handle; } return ret; }; } ); var rfocusable = /^(?:input|select|textarea|button)$/i, rclickable = /^(?:a|area)$/i; jQuery.fn.extend( { prop: function( name, value ) { return access( this, jQuery.prop, name, value, arguments.length > 1 ); }, removeProp: function( name ) { return this.each( function() { delete this[ jQuery.propFix[ name ] || name ]; } ); } } ); jQuery.extend( { prop: function( elem, name, value ) { var ret, hooks, nType = elem.nodeType; // Don't get/set properties on text, comment and attribute nodes if ( nType === 3 || nType === 8 || nType === 2 ) { return; } if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { // Fix name and attach hooks name = jQuery.propFix[ name ] || name; hooks = jQuery.propHooks[ name ]; } if ( value !== undefined ) { if ( hooks && "set" in hooks && ( ret = hooks.set( elem, value, name ) ) !== undefined ) { return ret; } return ( elem[ name ] = value ); } if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { return ret; } return elem[ name ]; }, propHooks: { tabIndex: { get: function( elem ) { // Support: IE <=9 - 11 only // elem.tabIndex doesn't always return the // correct value when it hasn't been explicitly set // https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ // Use proper attribute retrieval(#12072) var tabindex = jQuery.find.attr( elem, "tabindex" ); if ( tabindex ) { return parseInt( tabindex, 10 ); } if ( rfocusable.test( elem.nodeName ) || rclickable.test( elem.nodeName ) && elem.href ) { return 0; } return -1; } } }, propFix: { "for": "htmlFor", "class": "className" } } ); // Support: IE <=11 only // Accessing the selectedIndex property // forces the browser to respect setting selected // on the option // The getter ensures a default option is selected // when in an optgroup // eslint rule "no-unused-expressions" is disabled for this code // since it considers such accessions noop if ( !support.optSelected ) { jQuery.propHooks.selected = { get: function( elem ) { /* eslint no-unused-expressions: "off" */ var parent = elem.parentNode; if ( parent && parent.parentNode ) { parent.parentNode.selectedIndex; } return null; }, set: function( elem ) { /* eslint no-unused-expressions: "off" */ var parent = elem.parentNode; if ( parent ) { parent.selectedIndex; if ( parent.parentNode ) { parent.parentNode.selectedIndex; } } } }; } jQuery.each( [ "tabIndex", "readOnly", "maxLength", "cellSpacing", "cellPadding", "rowSpan", "colSpan", "useMap", "frameBorder", "contentEditable" ], function() { jQuery.propFix[ this.toLowerCase() ] = this; } ); // Strip and collapse whitespace according to HTML spec // https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace function stripAndCollapse( value ) { var tokens = value.match( rnothtmlwhite ) || []; return tokens.join( " " ); } function getClass( elem ) { return elem.getAttribute && elem.getAttribute( "class" ) || ""; } function classesToArray( value ) { if ( Array.isArray( value ) ) { return value; } if ( typeof value === "string" ) { return value.match( rnothtmlwhite ) || []; } return []; } jQuery.fn.extend( { addClass: function( value ) { var classes, elem, cur, curValue, clazz, j, finalValue, i = 0; if ( isFunction( value ) ) { return this.each( function( j ) { jQuery( this ).addClass( value.call( this, j, getClass( this ) ) ); } ); } classes = classesToArray( value ); if ( classes.length ) { while ( ( elem = this[ i++ ] ) ) { curValue = getClass( elem ); cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); if ( cur ) { j = 0; while ( ( clazz = classes[ j++ ] ) ) { if ( cur.indexOf( " " + clazz + " " ) < 0 ) { cur += clazz + " "; } } // Only assign if different to avoid unneeded rendering. finalValue = stripAndCollapse( cur ); if ( curValue !== finalValue ) { elem.setAttribute( "class", finalValue ); } } } } return this; }, removeClass: function( value ) { var classes, elem, cur, curValue, clazz, j, finalValue, i = 0; if ( isFunction( value ) ) { return this.each( function( j ) { jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) ); } ); } if ( !arguments.length ) { return this.attr( "class", "" ); } classes = classesToArray( value ); if ( classes.length ) { while ( ( elem = this[ i++ ] ) ) { curValue = getClass( elem ); // This expression is here for better compressibility (see addClass) cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); if ( cur ) { j = 0; while ( ( clazz = classes[ j++ ] ) ) { // Remove *all* instances while ( cur.indexOf( " " + clazz + " " ) > -1 ) { cur = cur.replace( " " + clazz + " ", " " ); } } // Only assign if different to avoid unneeded rendering. finalValue = stripAndCollapse( cur ); if ( curValue !== finalValue ) { elem.setAttribute( "class", finalValue ); } } } } return this; }, toggleClass: function( value, stateVal ) { var type = typeof value, isValidValue = type === "string" || Array.isArray( value ); if ( typeof stateVal === "boolean" && isValidValue ) { return stateVal ? this.addClass( value ) : this.removeClass( value ); } if ( isFunction( value ) ) { return this.each( function( i ) { jQuery( this ).toggleClass( value.call( this, i, getClass( this ), stateVal ), stateVal ); } ); } return this.each( function() { var className, i, self, classNames; if ( isValidValue ) { // Toggle individual class names i = 0; self = jQuery( this ); classNames = classesToArray( value ); while ( ( className = classNames[ i++ ] ) ) { // Check each className given, space separated list if ( self.hasClass( className ) ) { self.removeClass( className ); } else { self.addClass( className ); } } // Toggle whole class name } else if ( value === undefined || type === "boolean" ) { className = getClass( this ); if ( className ) { // Store className if set dataPriv.set( this, "__className__", className ); } // If the element has a class name or if we're passed `false`, // then remove the whole classname (if there was one, the above saved it). // Otherwise bring back whatever was previously saved (if anything), // falling back to the empty string if nothing was stored. if ( this.setAttribute ) { this.setAttribute( "class", className || value === false ? "" : dataPriv.get( this, "__className__" ) || "" ); } } } ); }, hasClass: function( selector ) { var className, elem, i = 0; className = " " + selector + " "; while ( ( elem = this[ i++ ] ) ) { if ( elem.nodeType === 1 && ( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) { return true; } } return false; } } ); var rreturn = /\r/g; jQuery.fn.extend( { val: function( value ) { var hooks, ret, valueIsFunction, elem = this[ 0 ]; if ( !arguments.length ) { if ( elem ) { hooks = jQuery.valHooks[ elem.type ] || jQuery.valHooks[ elem.nodeName.toLowerCase() ]; if ( hooks && "get" in hooks && ( ret = hooks.get( elem, "value" ) ) !== undefined ) { return ret; } ret = elem.value; // Handle most common string cases if ( typeof ret === "string" ) { return ret.replace( rreturn, "" ); } // Handle cases where value is null/undef or number return ret == null ? "" : ret; } return; } valueIsFunction = isFunction( value ); return this.each( function( i ) { var val; if ( this.nodeType !== 1 ) { return; } if ( valueIsFunction ) { val = value.call( this, i, jQuery( this ).val() ); } else { val = value; } // Treat null/undefined as ""; convert numbers to string if ( val == null ) { val = ""; } else if ( typeof val === "number" ) { val += ""; } else if ( Array.isArray( val ) ) { val = jQuery.map( val, function( value ) { return value == null ? "" : value + ""; } ); } hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; // If set returns undefined, fall back to normal setting if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) { this.value = val; } } ); } } ); jQuery.extend( { valHooks: { option: { get: function( elem ) { var val = jQuery.find.attr( elem, "value" ); return val != null ? val : // Support: IE <=10 - 11 only // option.text throws exceptions (#14686, #14858) // Strip and collapse whitespace // https://html.spec.whatwg.org/#strip-and-collapse-whitespace stripAndCollapse( jQuery.text( elem ) ); } }, select: { get: function( elem ) { var value, option, i, options = elem.options, index = elem.selectedIndex, one = elem.type === "select-one", values = one ? null : [], max = one ? index + 1 : options.length; if ( index < 0 ) { i = max; } else { i = one ? index : 0; } // Loop through all the selected options for ( ; i < max; i++ ) { option = options[ i ]; // Support: IE <=9 only // IE8-9 doesn't update selected after form reset (#2551) if ( ( option.selected || i === index ) && // Don't return options that are disabled or in a disabled optgroup !option.disabled && ( !option.parentNode.disabled || !nodeName( option.parentNode, "optgroup" ) ) ) { // Get the specific value for the option value = jQuery( option ).val(); // We don't need an array for one selects if ( one ) { return value; } // Multi-Selects return an array values.push( value ); } } return values; }, set: function( elem, value ) { var optionSet, option, options = elem.options, values = jQuery.makeArray( value ), i = options.length; while ( i-- ) { option = options[ i ]; /* eslint-disable no-cond-assign */ if ( option.selected = jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1 ) { optionSet = true; } /* eslint-enable no-cond-assign */ } // Force browsers to behave consistently when non-matching value is set if ( !optionSet ) { elem.selectedIndex = -1; } return values; } } } } ); // Radios and checkboxes getter/setter jQuery.each( [ "radio", "checkbox" ], function() { jQuery.valHooks[ this ] = { set: function( elem, value ) { if ( Array.isArray( value ) ) { return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 ); } } }; if ( !support.checkOn ) { jQuery.valHooks[ this ].get = function( elem ) { return elem.getAttribute( "value" ) === null ? "on" : elem.value; }; } } ); // Return jQuery for attributes-only inclusion support.focusin = "onfocusin" in window; var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, stopPropagationCallback = function( e ) { e.stopPropagation(); }; jQuery.extend( jQuery.event, { trigger: function( event, data, elem, onlyHandlers ) { var i, cur, tmp, bubbleType, ontype, handle, special, lastElement, eventPath = [ elem || document ], type = hasOwn.call( event, "type" ) ? event.type : event, namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : []; cur = lastElement = tmp = elem = elem || document; // Don't do events on text and comment nodes if ( elem.nodeType === 3 || elem.nodeType === 8 ) { return; } // focus/blur morphs to focusin/out; ensure we're not firing them right now if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { return; } if ( type.indexOf( "." ) > -1 ) { // Namespaced trigger; create a regexp to match event type in handle() namespaces = type.split( "." ); type = namespaces.shift(); namespaces.sort(); } ontype = type.indexOf( ":" ) < 0 && "on" + type; // Caller can pass in a jQuery.Event object, Object, or just an event type string event = event[ jQuery.expando ] ? event : new jQuery.Event( type, typeof event === "object" && event ); // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) event.isTrigger = onlyHandlers ? 2 : 3; event.namespace = namespaces.join( "." ); event.rnamespace = event.namespace ? new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) : null; // Clean up the event in case it is being reused event.result = undefined; if ( !event.target ) { event.target = elem; } // Clone any incoming data and prepend the event, creating the handler arg list data = data == null ? [ event ] : jQuery.makeArray( data, [ event ] ); // Allow special events to draw outside the lines special = jQuery.event.special[ type ] || {}; if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { return; } // Determine event propagation path in advance, per W3C events spec (#9951) // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) { bubbleType = special.delegateType || type; if ( !rfocusMorph.test( bubbleType + type ) ) { cur = cur.parentNode; } for ( ; cur; cur = cur.parentNode ) { eventPath.push( cur ); tmp = cur; } // Only add window if we got to document (e.g., not plain obj or detached DOM) if ( tmp === ( elem.ownerDocument || document ) ) { eventPath.push( tmp.defaultView || tmp.parentWindow || window ); } } // Fire handlers on the event path i = 0; while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) { lastElement = cur; event.type = i > 1 ? bubbleType : special.bindType || type; // jQuery handler handle = ( dataPriv.get( cur, "events" ) || Object.create( null ) )[ event.type ] && dataPriv.get( cur, "handle" ); if ( handle ) { handle.apply( cur, data ); } // Native handler handle = ontype && cur[ ontype ]; if ( handle && handle.apply && acceptData( cur ) ) { event.result = handle.apply( cur, data ); if ( event.result === false ) { event.preventDefault(); } } } event.type = type; // If nobody prevented the default action, do it now if ( !onlyHandlers && !event.isDefaultPrevented() ) { if ( ( !special._default || special._default.apply( eventPath.pop(), data ) === false ) && acceptData( elem ) ) { // Call a native DOM method on the target with the same name as the event. // Don't do default actions on window, that's where global variables be (#6170) if ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) { // Don't re-trigger an onFOO event when we call its FOO() method tmp = elem[ ontype ]; if ( tmp ) { elem[ ontype ] = null; } // Prevent re-triggering of the same event, since we already bubbled it above jQuery.event.triggered = type; if ( event.isPropagationStopped() ) { lastElement.addEventListener( type, stopPropagationCallback ); } elem[ type ](); if ( event.isPropagationStopped() ) { lastElement.removeEventListener( type, stopPropagationCallback ); } jQuery.event.triggered = undefined; if ( tmp ) { elem[ ontype ] = tmp; } } } } return event.result; }, // Piggyback on a donor event to simulate a different one // Used only for `focus(in | out)` events simulate: function( type, elem, event ) { var e = jQuery.extend( new jQuery.Event(), event, { type: type, isSimulated: true } ); jQuery.event.trigger( e, null, elem ); } } ); jQuery.fn.extend( { trigger: function( type, data ) { return this.each( function() { jQuery.event.trigger( type, data, this ); } ); }, triggerHandler: function( type, data ) { var elem = this[ 0 ]; if ( elem ) { return jQuery.event.trigger( type, data, elem, true ); } } } ); // Support: Firefox <=44 // Firefox doesn't have focus(in | out) events // Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787 // // Support: Chrome <=48 - 49, Safari <=9.0 - 9.1 // focus(in | out) events fire after focus & blur events, // which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order // Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857 if ( !support.focusin ) { jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) { // Attach a single capturing handler on the document while someone wants focusin/focusout var handler = function( event ) { jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) ); }; jQuery.event.special[ fix ] = { setup: function() { // Handle: regular nodes (via `this.ownerDocument`), window // (via `this.document`) & document (via `this`). var doc = this.ownerDocument || this.document || this, attaches = dataPriv.access( doc, fix ); if ( !attaches ) { doc.addEventListener( orig, handler, true ); } dataPriv.access( doc, fix, ( attaches || 0 ) + 1 ); }, teardown: function() { var doc = this.ownerDocument || this.document || this, attaches = dataPriv.access( doc, fix ) - 1; if ( !attaches ) { doc.removeEventListener( orig, handler, true ); dataPriv.remove( doc, fix ); } else { dataPriv.access( doc, fix, attaches ); } } }; } ); } var location = window.location; var nonce = { guid: Date.now() }; var rquery = ( /\?/ ); // Cross-browser xml parsing jQuery.parseXML = function( data ) { var xml; if ( !data || typeof data !== "string" ) { return null; } // Support: IE 9 - 11 only // IE throws on parseFromString with invalid input. try { xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" ); } catch ( e ) { xml = undefined; } if ( !xml || xml.getElementsByTagName( "parsererror" ).length ) { jQuery.error( "Invalid XML: " + data ); } return xml; }; var rbracket = /\[\]$/, rCRLF = /\r?\n/g, rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i, rsubmittable = /^(?:input|select|textarea|keygen)/i; function buildParams( prefix, obj, traditional, add ) { var name; if ( Array.isArray( obj ) ) { // Serialize array item. jQuery.each( obj, function( i, v ) { if ( traditional || rbracket.test( prefix ) ) { // Treat each array item as a scalar. add( prefix, v ); } else { // Item is non-scalar (array or object), encode its numeric index. buildParams( prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]", v, traditional, add ); } } ); } else if ( !traditional && toType( obj ) === "object" ) { // Serialize object item. for ( name in obj ) { buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add ); } } else { // Serialize scalar item. add( prefix, obj ); } } // Serialize an array of form elements or a set of // key/values into a query string jQuery.param = function( a, traditional ) { var prefix, s = [], add = function( key, valueOrFunction ) { // If value is a function, invoke it and use its return value var value = isFunction( valueOrFunction ) ? valueOrFunction() : valueOrFunction; s[ s.length ] = encodeURIComponent( key ) + "=" + encodeURIComponent( value == null ? "" : value ); }; if ( a == null ) { return ""; } // If an array was passed in, assume that it is an array of form elements. if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { // Serialize the form elements jQuery.each( a, function() { add( this.name, this.value ); } ); } else { // If traditional, encode the "old" way (the way 1.3.2 or older // did it), otherwise encode params recursively. for ( prefix in a ) { buildParams( prefix, a[ prefix ], traditional, add ); } } // Return the resulting serialization return s.join( "&" ); }; jQuery.fn.extend( { serialize: function() { return jQuery.param( this.serializeArray() ); }, serializeArray: function() { return this.map( function() { // Can add propHook for "elements" to filter or add form elements var elements = jQuery.prop( this, "elements" ); return elements ? jQuery.makeArray( elements ) : this; } ) .filter( function() { var type = this.type; // Use .is( ":disabled" ) so that fieldset[disabled] works return this.name && !jQuery( this ).is( ":disabled" ) && rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) && ( this.checked || !rcheckableType.test( type ) ); } ) .map( function( _i, elem ) { var val = jQuery( this ).val(); if ( val == null ) { return null; } if ( Array.isArray( val ) ) { return jQuery.map( val, function( val ) { return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; } ); } return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; } ).get(); } } ); var r20 = /%20/g, rhash = /#.*$/, rantiCache = /([?&])_=[^&]*/, rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg, // #7653, #8125, #8152: local protocol detection rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/, rnoContent = /^(?:GET|HEAD)$/, rprotocol = /^\/\//, /* Prefilters * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example) * 2) These are called: * - BEFORE asking for a transport * - AFTER param serialization (s.data is a string if s.processData is true) * 3) key is the dataType * 4) the catchall symbol "*" can be used * 5) execution will start with transport dataType and THEN continue down to "*" if needed */ prefilters = {}, /* Transports bindings * 1) key is the dataType * 2) the catchall symbol "*" can be used * 3) selection will start with transport dataType and THEN go to "*" if needed */ transports = {}, // Avoid comment-prolog char sequence (#10098); must appease lint and evade compression allTypes = "*/".concat( "*" ), // Anchor tag for parsing the document origin originAnchor = document.createElement( "a" ); originAnchor.href = location.href; // Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport function addToPrefiltersOrTransports( structure ) { // dataTypeExpression is optional and defaults to "*" return function( dataTypeExpression, func ) { if ( typeof dataTypeExpression !== "string" ) { func = dataTypeExpression; dataTypeExpression = "*"; } var dataType, i = 0, dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || []; if ( isFunction( func ) ) { // For each dataType in the dataTypeExpression while ( ( dataType = dataTypes[ i++ ] ) ) { // Prepend if requested if ( dataType[ 0 ] === "+" ) { dataType = dataType.slice( 1 ) || "*"; ( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func ); // Otherwise append } else { ( structure[ dataType ] = structure[ dataType ] || [] ).push( func ); } } } }; } // Base inspection function for prefilters and transports function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) { var inspected = {}, seekingTransport = ( structure === transports ); function inspect( dataType ) { var selected; inspected[ dataType ] = true; jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) { var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR ); if ( typeof dataTypeOrTransport === "string" && !seekingTransport && !inspected[ dataTypeOrTransport ] ) { options.dataTypes.unshift( dataTypeOrTransport ); inspect( dataTypeOrTransport ); return false; } else if ( seekingTransport ) { return !( selected = dataTypeOrTransport ); } } ); return selected; } return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" ); } // A special extend for ajax options // that takes "flat" options (not to be deep extended) // Fixes #9887 function ajaxExtend( target, src ) { var key, deep, flatOptions = jQuery.ajaxSettings.flatOptions || {}; for ( key in src ) { if ( src[ key ] !== undefined ) { ( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ]; } } if ( deep ) { jQuery.extend( true, target, deep ); } return target; } /* Handles responses to an ajax request: * - finds the right dataType (mediates between content-type and expected dataType) * - returns the corresponding response */ function ajaxHandleResponses( s, jqXHR, responses ) { var ct, type, finalDataType, firstDataType, contents = s.contents, dataTypes = s.dataTypes; // Remove auto dataType and get content-type in the process while ( dataTypes[ 0 ] === "*" ) { dataTypes.shift(); if ( ct === undefined ) { ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" ); } } // Check if we're dealing with a known content-type if ( ct ) { for ( type in contents ) { if ( contents[ type ] && contents[ type ].test( ct ) ) { dataTypes.unshift( type ); break; } } } // Check to see if we have a response for the expected dataType if ( dataTypes[ 0 ] in responses ) { finalDataType = dataTypes[ 0 ]; } else { // Try convertible dataTypes for ( type in responses ) { if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) { finalDataType = type; break; } if ( !firstDataType ) { firstDataType = type; } } // Or just use first one finalDataType = finalDataType || firstDataType; } // If we found a dataType // We add the dataType to the list if needed // and return the corresponding response if ( finalDataType ) { if ( finalDataType !== dataTypes[ 0 ] ) { dataTypes.unshift( finalDataType ); } return responses[ finalDataType ]; } } /* Chain conversions given the request and the original response * Also sets the responseXXX fields on the jqXHR instance */ function ajaxConvert( s, response, jqXHR, isSuccess ) { var conv2, current, conv, tmp, prev, converters = {}, // Work with a copy of dataTypes in case we need to modify it for conversion dataTypes = s.dataTypes.slice(); // Create converters map with lowercased keys if ( dataTypes[ 1 ] ) { for ( conv in s.converters ) { converters[ conv.toLowerCase() ] = s.converters[ conv ]; } } current = dataTypes.shift(); // Convert to each sequential dataType while ( current ) { if ( s.responseFields[ current ] ) { jqXHR[ s.responseFields[ current ] ] = response; } // Apply the dataFilter if provided if ( !prev && isSuccess && s.dataFilter ) { response = s.dataFilter( response, s.dataType ); } prev = current; current = dataTypes.shift(); if ( current ) { // There's only work to do if current dataType is non-auto if ( current === "*" ) { current = prev; // Convert response if prev dataType is non-auto and differs from current } else if ( prev !== "*" && prev !== current ) { // Seek a direct converter conv = converters[ prev + " " + current ] || converters[ "* " + current ]; // If none found, seek a pair if ( !conv ) { for ( conv2 in converters ) { // If conv2 outputs current tmp = conv2.split( " " ); if ( tmp[ 1 ] === current ) { // If prev can be converted to accepted input conv = converters[ prev + " " + tmp[ 0 ] ] || converters[ "* " + tmp[ 0 ] ]; if ( conv ) { // Condense equivalence converters if ( conv === true ) { conv = converters[ conv2 ]; // Otherwise, insert the intermediate dataType } else if ( converters[ conv2 ] !== true ) { current = tmp[ 0 ]; dataTypes.unshift( tmp[ 1 ] ); } break; } } } } // Apply converter (if not an equivalence) if ( conv !== true ) { // Unless errors are allowed to bubble, catch and return them if ( conv && s.throws ) { response = conv( response ); } else { try { response = conv( response ); } catch ( e ) { return { state: "parsererror", error: conv ? e : "No conversion from " + prev + " to " + current }; } } } } } } return { state: "success", data: response }; } jQuery.extend( { // Counter for holding the number of active queries active: 0, // Last-Modified header cache for next request lastModified: {}, etag: {}, ajaxSettings: { url: location.href, type: "GET", isLocal: rlocalProtocol.test( location.protocol ), global: true, processData: true, async: true, contentType: "application/x-www-form-urlencoded; charset=UTF-8", /* timeout: 0, data: null, dataType: null, username: null, password: null, cache: null, throws: false, traditional: false, headers: {}, */ accepts: { "*": allTypes, text: "text/plain", html: "text/html", xml: "application/xml, text/xml", json: "application/json, text/javascript" }, contents: { xml: /\bxml\b/, html: /\bhtml/, json: /\bjson\b/ }, responseFields: { xml: "responseXML", text: "responseText", json: "responseJSON" }, // Data converters // Keys separate source (or catchall "*") and destination types with a single space converters: { // Convert anything to text "* text": String, // Text to html (true = no transformation) "text html": true, // Evaluate text as a json expression "text json": JSON.parse, // Parse text as xml "text xml": jQuery.parseXML }, // For options that shouldn't be deep extended: // you can add your own custom options here if // and when you create one that shouldn't be // deep extended (see ajaxExtend) flatOptions: { url: true, context: true } }, // Creates a full fledged settings object into target // with both ajaxSettings and settings fields. // If target is omitted, writes into ajaxSettings. ajaxSetup: function( target, settings ) { return settings ? // Building a settings object ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) : // Extending ajaxSettings ajaxExtend( jQuery.ajaxSettings, target ); }, ajaxPrefilter: addToPrefiltersOrTransports( prefilters ), ajaxTransport: addToPrefiltersOrTransports( transports ), // Main method ajax: function( url, options ) { // If url is an object, simulate pre-1.5 signature if ( typeof url === "object" ) { options = url; url = undefined; } // Force options to be an object options = options || {}; var transport, // URL without anti-cache param cacheURL, // Response headers responseHeadersString, responseHeaders, // timeout handle timeoutTimer, // Url cleanup var urlAnchor, // Request state (becomes false upon send and true upon completion) completed, // To know if global events are to be dispatched fireGlobals, // Loop variable i, // uncached part of the url uncached, // Create the final options object s = jQuery.ajaxSetup( {}, options ), // Callbacks context callbackContext = s.context || s, // Context for global events is callbackContext if it is a DOM node or jQuery collection globalEventContext = s.context && ( callbackContext.nodeType || callbackContext.jquery ) ? jQuery( callbackContext ) : jQuery.event, // Deferreds deferred = jQuery.Deferred(), completeDeferred = jQuery.Callbacks( "once memory" ), // Status-dependent callbacks statusCode = s.statusCode || {}, // Headers (they are sent all at once) requestHeaders = {}, requestHeadersNames = {}, // Default abort message strAbort = "canceled", // Fake xhr jqXHR = { readyState: 0, // Builds headers hashtable if needed getResponseHeader: function( key ) { var match; if ( completed ) { if ( !responseHeaders ) { responseHeaders = {}; while ( ( match = rheaders.exec( responseHeadersString ) ) ) { responseHeaders[ match[ 1 ].toLowerCase() + " " ] = ( responseHeaders[ match[ 1 ].toLowerCase() + " " ] || [] ) .concat( match[ 2 ] ); } } match = responseHeaders[ key.toLowerCase() + " " ]; } return match == null ? null : match.join( ", " ); }, // Raw string getAllResponseHeaders: function() { return completed ? responseHeadersString : null; }, // Caches the header setRequestHeader: function( name, value ) { if ( completed == null ) { name = requestHeadersNames[ name.toLowerCase() ] = requestHeadersNames[ name.toLowerCase() ] || name; requestHeaders[ name ] = value; } return this; }, // Overrides response content-type header overrideMimeType: function( type ) { if ( completed == null ) { s.mimeType = type; } return this; }, // Status-dependent callbacks statusCode: function( map ) { var code; if ( map ) { if ( completed ) { // Execute the appropriate callbacks jqXHR.always( map[ jqXHR.status ] ); } else { // Lazy-add the new callbacks in a way that preserves old ones for ( code in map ) { statusCode[ code ] = [ statusCode[ code ], map[ code ] ]; } } } return this; }, // Cancel the request abort: function( statusText ) { var finalText = statusText || strAbort; if ( transport ) { transport.abort( finalText ); } done( 0, finalText ); return this; } }; // Attach deferreds deferred.promise( jqXHR ); // Add protocol if not provided (prefilters might expect it) // Handle falsy url in the settings object (#10093: consistency with old signature) // We also use the url parameter if available s.url = ( ( url || s.url || location.href ) + "" ) .replace( rprotocol, location.protocol + "//" ); // Alias method option to type as per ticket #12004 s.type = options.method || options.type || s.method || s.type; // Extract dataTypes list s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ]; // A cross-domain request is in order when the origin doesn't match the current origin. if ( s.crossDomain == null ) { urlAnchor = document.createElement( "a" ); // Support: IE <=8 - 11, Edge 12 - 15 // IE throws exception on accessing the href property if url is malformed, // e.g. http://example.com:80x/ try { urlAnchor.href = s.url; // Support: IE <=8 - 11 only // Anchor's host property isn't correctly set when s.url is relative urlAnchor.href = urlAnchor.href; s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !== urlAnchor.protocol + "//" + urlAnchor.host; } catch ( e ) { // If there is an error parsing the URL, assume it is crossDomain, // it can be rejected by the transport if it is invalid s.crossDomain = true; } } // Convert data if not already a string if ( s.data && s.processData && typeof s.data !== "string" ) { s.data = jQuery.param( s.data, s.traditional ); } // Apply prefilters inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); // If request was aborted inside a prefilter, stop there if ( completed ) { return jqXHR; } // We can fire global events as of now if asked to // Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118) fireGlobals = jQuery.event && s.global; // Watch for a new set of requests if ( fireGlobals && jQuery.active++ === 0 ) { jQuery.event.trigger( "ajaxStart" ); } // Uppercase the type s.type = s.type.toUpperCase(); // Determine if request has content s.hasContent = !rnoContent.test( s.type ); // Save the URL in case we're toying with the If-Modified-Since // and/or If-None-Match header later on // Remove hash to simplify url manipulation cacheURL = s.url.replace( rhash, "" ); // More options handling for requests with no content if ( !s.hasContent ) { // Remember the hash so we can put it back uncached = s.url.slice( cacheURL.length ); // If data is available and should be processed, append data to url if ( s.data && ( s.processData || typeof s.data === "string" ) ) { cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data; // #9682: remove data so that it's not used in an eventual retry delete s.data; } // Add or update anti-cache param if needed if ( s.cache === false ) { cacheURL = cacheURL.replace( rantiCache, "$1" ); uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce.guid++ ) + uncached; } // Put hash and anti-cache on the URL that will be requested (gh-1732) s.url = cacheURL + uncached; // Change '%20' to '+' if this is encoded form body content (gh-2658) } else if ( s.data && s.processData && ( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) { s.data = s.data.replace( r20, "+" ); } // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. if ( s.ifModified ) { if ( jQuery.lastModified[ cacheURL ] ) { jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] ); } if ( jQuery.etag[ cacheURL ] ) { jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] ); } } // Set the correct header, if data is being sent if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { jqXHR.setRequestHeader( "Content-Type", s.contentType ); } // Set the Accepts header for the server, depending on the dataType jqXHR.setRequestHeader( "Accept", s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ? s.accepts[ s.dataTypes[ 0 ] ] + ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : s.accepts[ "*" ] ); // Check for headers option for ( i in s.headers ) { jqXHR.setRequestHeader( i, s.headers[ i ] ); } // Allow custom headers/mimetypes and early abort if ( s.beforeSend && ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) { // Abort if not done already and return return jqXHR.abort(); } // Aborting is no longer a cancellation strAbort = "abort"; // Install callbacks on deferreds completeDeferred.add( s.complete ); jqXHR.done( s.success ); jqXHR.fail( s.error ); // Get transport transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); // If no transport, we auto-abort if ( !transport ) { done( -1, "No Transport" ); } else { jqXHR.readyState = 1; // Send global event if ( fireGlobals ) { globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); } // If request was aborted inside ajaxSend, stop there if ( completed ) { return jqXHR; } // Timeout if ( s.async && s.timeout > 0 ) { timeoutTimer = window.setTimeout( function() { jqXHR.abort( "timeout" ); }, s.timeout ); } try { completed = false; transport.send( requestHeaders, done ); } catch ( e ) { // Rethrow post-completion exceptions if ( completed ) { throw e; } // Propagate others as results done( -1, e ); } } // Callback for when everything is done function done( status, nativeStatusText, responses, headers ) { var isSuccess, success, error, response, modified, statusText = nativeStatusText; // Ignore repeat invocations if ( completed ) { return; } completed = true; // Clear timeout if it exists if ( timeoutTimer ) { window.clearTimeout( timeoutTimer ); } // Dereference transport for early garbage collection // (no matter how long the jqXHR object will be used) transport = undefined; // Cache response headers responseHeadersString = headers || ""; // Set readyState jqXHR.readyState = status > 0 ? 4 : 0; // Determine if successful isSuccess = status >= 200 && status < 300 || status === 304; // Get response data if ( responses ) { response = ajaxHandleResponses( s, jqXHR, responses ); } // Use a noop converter for missing script if ( !isSuccess && jQuery.inArray( "script", s.dataTypes ) > -1 ) { s.converters[ "text script" ] = function() {}; } // Convert no matter what (that way responseXXX fields are always set) response = ajaxConvert( s, response, jqXHR, isSuccess ); // If successful, handle type chaining if ( isSuccess ) { // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. if ( s.ifModified ) { modified = jqXHR.getResponseHeader( "Last-Modified" ); if ( modified ) { jQuery.lastModified[ cacheURL ] = modified; } modified = jqXHR.getResponseHeader( "etag" ); if ( modified ) { jQuery.etag[ cacheURL ] = modified; } } // if no content if ( status === 204 || s.type === "HEAD" ) { statusText = "nocontent"; // if not modified } else if ( status === 304 ) { statusText = "notmodified"; // If we have data, let's convert it } else { statusText = response.state; success = response.data; error = response.error; isSuccess = !error; } } else { // Extract error from statusText and normalize for non-aborts error = statusText; if ( status || !statusText ) { statusText = "error"; if ( status < 0 ) { status = 0; } } } // Set data for the fake xhr object jqXHR.status = status; jqXHR.statusText = ( nativeStatusText || statusText ) + ""; // Success/Error if ( isSuccess ) { deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); } else { deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); } // Status-dependent callbacks jqXHR.statusCode( statusCode ); statusCode = undefined; if ( fireGlobals ) { globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError", [ jqXHR, s, isSuccess ? success : error ] ); } // Complete completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] ); if ( fireGlobals ) { globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); // Handle the global AJAX counter if ( !( --jQuery.active ) ) { jQuery.event.trigger( "ajaxStop" ); } } } return jqXHR; }, getJSON: function( url, data, callback ) { return jQuery.get( url, data, callback, "json" ); }, getScript: function( url, callback ) { return jQuery.get( url, undefined, callback, "script" ); } } ); jQuery.each( [ "get", "post" ], function( _i, method ) { jQuery[ method ] = function( url, data, callback, type ) { // Shift arguments if data argument was omitted if ( isFunction( data ) ) { type = type || callback; callback = data; data = undefined; } // The url can be an options object (which then must have .url) return jQuery.ajax( jQuery.extend( { url: url, type: method, dataType: type, data: data, success: callback }, jQuery.isPlainObject( url ) && url ) ); }; } ); jQuery.ajaxPrefilter( function( s ) { var i; for ( i in s.headers ) { if ( i.toLowerCase() === "content-type" ) { s.contentType = s.headers[ i ] || ""; } } } ); jQuery._evalUrl = function( url, options, doc ) { return jQuery.ajax( { url: url, // Make this explicit, since user can override this through ajaxSetup (#11264) type: "GET", dataType: "script", cache: true, async: false, global: false, // Only evaluate the response if it is successful (gh-4126) // dataFilter is not invoked for failure responses, so using it instead // of the default converter is kludgy but it works. converters: { "text script": function() {} }, dataFilter: function( response ) { jQuery.globalEval( response, options, doc ); } } ); }; jQuery.fn.extend( { wrapAll: function( html ) { var wrap; if ( this[ 0 ] ) { if ( isFunction( html ) ) { html = html.call( this[ 0 ] ); } // The elements to wrap the target around wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true ); if ( this[ 0 ].parentNode ) { wrap.insertBefore( this[ 0 ] ); } wrap.map( function() { var elem = this; while ( elem.firstElementChild ) { elem = elem.firstElementChild; } return elem; } ).append( this ); } return this; }, wrapInner: function( html ) { if ( isFunction( html ) ) { return this.each( function( i ) { jQuery( this ).wrapInner( html.call( this, i ) ); } ); } return this.each( function() { var self = jQuery( this ), contents = self.contents(); if ( contents.length ) { contents.wrapAll( html ); } else { self.append( html ); } } ); }, wrap: function( html ) { var htmlIsFunction = isFunction( html ); return this.each( function( i ) { jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html ); } ); }, unwrap: function( selector ) { this.parent( selector ).not( "body" ).each( function() { jQuery( this ).replaceWith( this.childNodes ); } ); return this; } } ); jQuery.expr.pseudos.hidden = function( elem ) { return !jQuery.expr.pseudos.visible( elem ); }; jQuery.expr.pseudos.visible = function( elem ) { return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length ); }; jQuery.ajaxSettings.xhr = function() { try { return new window.XMLHttpRequest(); } catch ( e ) {} }; var xhrSuccessStatus = { // File protocol always yields status code 0, assume 200 0: 200, // Support: IE <=9 only // #1450: sometimes IE returns 1223 when it should be 204 1223: 204 }, xhrSupported = jQuery.ajaxSettings.xhr(); support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported ); support.ajax = xhrSupported = !!xhrSupported; jQuery.ajaxTransport( function( options ) { var callback, errorCallback; // Cross domain only allowed if supported through XMLHttpRequest if ( support.cors || xhrSupported && !options.crossDomain ) { return { send: function( headers, complete ) { var i, xhr = options.xhr(); xhr.open( options.type, options.url, options.async, options.username, options.password ); // Apply custom fields if provided if ( options.xhrFields ) { for ( i in options.xhrFields ) { xhr[ i ] = options.xhrFields[ i ]; } } // Override mime type if needed if ( options.mimeType && xhr.overrideMimeType ) { xhr.overrideMimeType( options.mimeType ); } // X-Requested-With header // For cross-domain requests, seeing as conditions for a preflight are // akin to a jigsaw puzzle, we simply never set it to be sure. // (it can always be set on a per-request basis or even using ajaxSetup) // For same-domain requests, won't change header if already provided. if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) { headers[ "X-Requested-With" ] = "XMLHttpRequest"; } // Set headers for ( i in headers ) { xhr.setRequestHeader( i, headers[ i ] ); } // Callback callback = function( type ) { return function() { if ( callback ) { callback = errorCallback = xhr.onload = xhr.onerror = xhr.onabort = xhr.ontimeout = xhr.onreadystatechange = null; if ( type === "abort" ) { xhr.abort(); } else if ( type === "error" ) { // Support: IE <=9 only // On a manual native abort, IE9 throws // errors on any property access that is not readyState if ( typeof xhr.status !== "number" ) { complete( 0, "error" ); } else { complete( // File: protocol always yields status 0; see #8605, #14207 xhr.status, xhr.statusText ); } } else { complete( xhrSuccessStatus[ xhr.status ] || xhr.status, xhr.statusText, // Support: IE <=9 only // IE9 has no XHR2 but throws on binary (trac-11426) // For XHR2 non-text, let the caller handle it (gh-2498) ( xhr.responseType || "text" ) !== "text" || typeof xhr.responseText !== "string" ? { binary: xhr.response } : { text: xhr.responseText }, xhr.getAllResponseHeaders() ); } } }; }; // Listen to events xhr.onload = callback(); errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" ); // Support: IE 9 only // Use onreadystatechange to replace onabort // to handle uncaught aborts if ( xhr.onabort !== undefined ) { xhr.onabort = errorCallback; } else { xhr.onreadystatechange = function() { // Check readyState before timeout as it changes if ( xhr.readyState === 4 ) { // Allow onerror to be called first, // but that will not handle a native abort // Also, save errorCallback to a variable // as xhr.onerror cannot be accessed window.setTimeout( function() { if ( callback ) { errorCallback(); } } ); } }; } // Create the abort callback callback = callback( "abort" ); try { // Do send the request (this may raise an exception) xhr.send( options.hasContent && options.data || null ); } catch ( e ) { // #14683: Only rethrow if this hasn't been notified as an error yet if ( callback ) { throw e; } } }, abort: function() { if ( callback ) { callback(); } } }; } } ); // Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432) jQuery.ajaxPrefilter( function( s ) { if ( s.crossDomain ) { s.contents.script = false; } } ); // Install script dataType jQuery.ajaxSetup( { accepts: { script: "text/javascript, application/javascript, " + "application/ecmascript, application/x-ecmascript" }, contents: { script: /\b(?:java|ecma)script\b/ }, converters: { "text script": function( text ) { jQuery.globalEval( text ); return text; } } } ); // Handle cache's special case and crossDomain jQuery.ajaxPrefilter( "script", function( s ) { if ( s.cache === undefined ) { s.cache = false; } if ( s.crossDomain ) { s.type = "GET"; } } ); // Bind script tag hack transport jQuery.ajaxTransport( "script", function( s ) { // This transport only deals with cross domain or forced-by-attrs requests if ( s.crossDomain || s.scriptAttrs ) { var script, callback; return { send: function( _, complete ) { script = jQuery( " {%- endblock %} {# doctype override #} {%- block doctype %} {%- endblock %} {%- block extrahead %} {%- endblock %} ././@PaxHeader0000000000000000000000000000003400000000000010212 xustar0028 mtime=1639903107.5539382 Sphinx-4.3.2/sphinx/themes/bizstyle/static/0000755000076600000240000000000000000000000020265 5ustar00tkomiyastaff././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/sphinx/themes/bizstyle/static/background_b01.png0000644000076600000240000000011600000000000023552 0ustar00tkomiyastaffPNG  IHDRsCcIDATxc?Ù?2@_BIENDB`././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/themes/bizstyle/static/bizstyle.css_t0000644000076600000240000002405700000000000023177 0ustar00tkomiyastaff/* * bizstyle.css_t * ~~~~~~~~~~~~~~ * * Sphinx stylesheet -- business style theme. * * :copyright: Copyright 2011-2014 by Sphinx team, see AUTHORS. * :license: BSD, see LICENSE for details. * */ @import url("basic.css"); /* -- page layout ----------------------------------------------------------- */ body { font-family: 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva', 'Verdana', sans-serif; font-size: 14px; letter-spacing: -0.01em; line-height: 150%; text-align: center; background-color: white; background-image: url(background_b01.png); color: black; padding: 0; border-right: 1px solid {{ theme_maincolor }}; border-left: 1px solid {{ theme_maincolor }}; margin: 0px 40px 0px 40px; } div.document { background-color: white; text-align: left; background-repeat: repeat-x; -moz-box-shadow: 2px 2px 5px #000; -webkit-box-shadow: 2px 2px 5px #000; } div.documentwrapper { float: left; width: 100%; } div.bodywrapper { margin: 0 0 0 240px; border-left: 1px solid #ccc; } div.body { margin: 0; padding: 0.5em 20px 20px 20px; } {%- if theme_rightsidebar|tobool %} div.bodywrapper { margin: 0 calc({{ theme_sidebarwidth|todim }} + 30px) 0 0; border-right: 1px solid #ccc; } {%- else %} div.bodywrapper { margin: 0 0 0 calc({{ theme_sidebarwidth|todim }} + 30px); } {%- endif %} div.related { font-size: 1em; -moz-box-shadow: 2px 2px 5px #000; -webkit-box-shadow: 2px 2px 5px #000; } div.related ul { background-color: {{ theme_maincolor }}; height: 100%; overflow: hidden; border-top: 1px solid #ddd; border-bottom: 1px solid #ddd; } div.related ul li { color: white; margin: 0; padding: 0; height: 2em; float: left; } div.related ul li.right { float: right; margin-right: 5px; } div.related ul li a { margin: 0; padding: 0 5px 0 5px; line-height: 1.75em; color: #fff; } div.related ul li a:hover { color: #fff; text-decoration: underline; } div.sphinxsidebarwrapper { padding: 0; } div.sphinxsidebar { padding: 0.5em 12px 12px 12px; width: {{ theme_sidebarwidth|todim }}; {%- if theme_rightsidebar|tobool %} float: right; {%- endif %} font-size: 1em; text-align: left; } div.sphinxsidebar h3, div.sphinxsidebar h4 { margin: 1em 0 0.5em 0; font-size: 1em; padding: 0.1em 0 0.1em 0.5em; color: white; border: 1px solid {{ theme_maincolor }}; background-color: {{ theme_maincolor }}; } div.sphinxsidebar h3 a { color: white; } div.sphinxsidebar ul { padding-left: 1.5em; margin-top: 7px; padding: 0; line-height: 130%; } div.sphinxsidebar ul ul { margin-left: 20px; } div.sphinxsidebar input { border: 1px solid {{ theme_maincolor }}; } div.footer { background-color: white; color: {{ theme_maincolor }}; padding: 3px 8px 3px 0; clear: both; font-size: 0.8em; text-align: right; border-bottom: 1px solid {{ theme_maincolor }}; -moz-box-shadow: 2px 2px 5px #000; -webkit-box-shadow: 2px 2px 5px #000; } div.footer a { color: {{ theme_maincolor }}; text-decoration: underline; } /* -- body styles ----------------------------------------------------------- */ p { margin: 0.8em 0 0.5em 0; } a { color: {{ theme_maincolor }}; text-decoration: none; } a:hover { color: {{ theme_maincolor }}; text-decoration: underline; } div.body a { text-decoration: underline; } h1, h2, h3 { color: {{ theme_maincolor }}; } h1 { margin: 0; padding: 0.7em 0 0.3em 0; font-size: 1.5em; } h2 { margin: 1.3em 0 0.2em 0; font-size: 1.35em; padding-bottom: .5em; border-bottom: 1px solid {{ theme_maincolor }}; } h3 { margin: 1em 0 -0.3em 0; font-size: 1.2em; padding-bottom: .3em; border-bottom: 1px solid #CCCCCC; } div.body h1 a, div.body h2 a, div.body h3 a, div.body h4 a, div.body h5 a, div.body h6 a { color: black!important; } h1 a.anchor, h2 a.anchor, h3 a.anchor, h4 a.anchor, h5 a.anchor, h6 a.anchor { display: none; margin: 0 0 0 0.3em; padding: 0 0.2em 0 0.2em; color: #aaa!important; } h1:hover a.anchor, h2:hover a.anchor, h3:hover a.anchor, h4:hover a.anchor, h5:hover a.anchor, h6:hover a.anchor { display: inline; } h1 a.anchor:hover, h2 a.anchor:hover, h3 a.anchor:hover, h4 a.anchor:hover, h5 a.anchor:hover, h6 a.anchor:hover { color: #777; background-color: #eee; } a.headerlink { color: #c60f0f!important; font-size: 1em; margin-left: 6px; padding: 0 4px 0 4px; text-decoration: none!important; } a.headerlink:hover { background-color: #ccc; color: white!important; } cite, code, tt { font-family: 'Consolas', 'Deja Vu Sans Mono', 'Bitstream Vera Sans Mono', monospace; font-size: 0.95em; letter-spacing: 0.01em; } code { background-color: #F2F2F2; border-bottom: 1px solid #ddd; color: #333; } code.descname, code.descclassname, code.xref { border: 0; } hr { border: 1px solid #abc; margin: 2em; } a code { border: 0; color: #CA7900; } a code:hover { color: #2491CF; } pre { background-color: transparent !important; font-family: 'Consolas', 'Deja Vu Sans Mono', 'Bitstream Vera Sans Mono', monospace; font-size: 0.95em; letter-spacing: 0.015em; line-height: 120%; padding: 0.5em; border-right: 5px solid #ccc; border-left: 5px solid #ccc; } pre a { color: inherit; text-decoration: underline; } td.linenos pre { padding: 0.5em 0; } div.quotebar { background-color: #f8f8f8; max-width: 250px; float: right; padding: 2px 7px; border: 1px solid #ccc; } div.topic { background-color: #f8f8f8; } table { border-collapse: collapse; margin: 0 -0.5em 0 -0.5em; } table td, table th { padding: 0.2em 0.5em 0.2em 0.5em; } div.admonition { font-size: 0.9em; margin: 1em 0 1em 0; border: 3px solid #cccccc; background-color: #f7f7f7; padding: 0; } div.admonition p { margin: 0.5em 1em 0.5em 1em; padding: 0; } div.admonition li p { margin-left: 0; } div.admonition pre, div.warning pre { margin: 0; } div.highlight { margin: 0.4em 1em; } div.admonition p.admonition-title { margin: 0; padding: 0.1em 0 0.1em 0.5em; color: white; border-bottom: 3px solid #cccccc; font-weight: bold; background-color: #165e83; } div.danger { border: 3px solid #f0908d; background-color: #f0cfa0; } div.error { border: 3px solid #f0908d; background-color: #ede4cd; } div.warning { border: 3px solid #f8b862; background-color: #f0cfa0; } div.caution { border: 3px solid #f8b862; background-color: #ede4cd; } div.attention { border: 3px solid #f8b862; background-color: #f3f3f3; } div.important { border: 3px solid #f0cfa0; background-color: #ede4cd; } div.note { border: 3px solid #f0cfa0; background-color: #f3f3f3; } div.hint { border: 3px solid #bed2c3; background-color: #f3f3f3; } div.tip { border: 3px solid #bed2c3; background-color: #f3f3f3; } div.danger p.admonition-title, div.error p.admonition-title { background-color: #b7282e; border-bottom: 3px solid #f0908d; } div.caution p.admonition-title, div.warning p.admonition-title, div.attention p.admonition-title { background-color: #f19072; border-bottom: 3px solid #f8b862; } div.note p.admonition-title, div.important p.admonition-title { background-color: #f8b862; border-bottom: 3px solid #f0cfa0; } div.hint p.admonition-title, div.tip p.admonition-title { background-color: #7ebea5; border-bottom: 3px solid #bed2c3; } div.admonition ul, div.admonition ol, div.warning ul, div.warning ol { margin: 0.1em 0.5em 0.5em 3em; padding: 0; } div.versioninfo { margin: 1em 0 0 0; border: 1px solid #ccc; background-color: #DDEAF0; padding: 8px; line-height: 1.3em; font-size: 0.9em; } .viewcode-back { font-family: 'Lucida Grande', 'Lucida Sans Unicode', 'Geneva', 'Verdana', sans-serif; } div.viewcode-block:target { background-color: #f4debf; border-top: 1px solid #ac9; border-bottom: 1px solid #ac9; } p.versionchanged span.versionmodified { font-size: 0.9em; margin-right: 0.2em; padding: 0.1em; background-color: #DCE6A0; } dl.field-list > dt { color: white; background-color: #82A0BE; } dl.field-list > dd { background-color: #f7f7f7; } /* -- table styles ---------------------------------------------------------- */ table.docutils { margin: 1em 0; padding: 0; border: 1px solid white; background-color: #f7f7f7; } table.docutils td, table.docutils th { padding: 1px 8px 1px 5px; border-top: 0; border-left: 0; border-right: 1px solid white; border-bottom: 1px solid white; } table.docutils td p { margin-top: 0; margin-bottom: 0.3em; } table.field-list td, table.field-list th { border: 0 !important; word-break: break-word; } table.footnote td, table.footnote th { border: 0 !important; } th { color: white; text-align: left; padding-right: 5px; background-color: #82A0BE; } div.literal-block-wrapper div.code-block-caption { background-color: #EEE; border-style: solid; border-color: #CCC; border-width: 1px 5px; } /* WIDE DESKTOP STYLE */ @media only screen and (min-width: 1176px) { body { margin: 0 40px 0 40px; } } /* TABLET STYLE */ @media only screen and (min-width: 768px) and (max-width: 991px) { body { margin: 0 40px 0 40px; } } /* MOBILE LAYOUT (PORTRAIT/320px) */ @media only screen and (max-width: 767px) { body { margin: 0; } div.bodywrapper { margin: 0; width: 100%; border: none; } div.sphinxsidebar { display: none; } } /* MOBILE LAYOUT (LANDSCAPE/480px) */ @media only screen and (min-width: 480px) and (max-width: 767px) { body { margin: 0 20px 0 20px; } } /* RETINA OVERRIDES */ @media only screen and (-webkit-min-device-pixel-ratio: 2), only screen and (min-device-pixel-ratio: 2) { } /* -- end ------------------------------------------------------------------- */ ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/sphinx/themes/bizstyle/static/bizstyle.js_t0000644000076600000240000000222100000000000023010 0ustar00tkomiyastaff// // bizstyle.js // ~~~~~~~~~~~ // // Sphinx javascript -- for bizstyle theme. // // This theme was created by referring to 'sphinxdoc' // // :copyright: Copyright 2012-2014 by Sphinx team, see AUTHORS. // :license: BSD, see LICENSE for details. // $(document).ready(function(){ if (navigator.userAgent.indexOf('iPhone') > 0 || navigator.userAgent.indexOf('Android') > 0) { $("li.nav-item-0 a").text("Top"); } $("div.related:first ul li:not(.right) a").slice(1).each(function(i, item){ if (item.text.length > 20) { var tmpstr = item.text $(item).attr("title", tmpstr); $(item).text(tmpstr.substr(0, 17) + "..."); } }); $("div.related:last ul li:not(.right) a").slice(1).each(function(i, item){ if (item.text.length > 20) { var tmpstr = item.text $(item).attr("title", tmpstr); $(item).text(tmpstr.substr(0, 17) + "..."); } }); }); $(window).resize(function(){ if ($(window).width() <= 776) { $("li.nav-item-0 a").text("Top"); } else { $("li.nav-item-0 a").text("{{ shorttitle|e }}"); } }); ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1609484009.0 Sphinx-4.3.2/sphinx/themes/bizstyle/static/css3-mediaqueries.js0000644000076600000240000003513400000000000024157 0ustar00tkomiyastaffif(typeof Object.create!=="function"){Object.create=function(e){function t(){}t.prototype=e;return new t}}var ua={toString:function(){return navigator.userAgent},test:function(e){return this.toString().toLowerCase().indexOf(e.toLowerCase())>-1}};ua.version=(ua.toString().toLowerCase().match(/[\s\S]+(?:rv|it|ra|ie)[\/: ]([\d.]+)/)||[])[1];ua.webkit=ua.test("webkit");ua.gecko=ua.test("gecko")&&!ua.webkit;ua.opera=ua.test("opera");ua.ie=ua.test("msie")&&!ua.opera;ua.ie6=ua.ie&&document.compatMode&&typeof document.documentElement.style.maxHeight==="undefined";ua.ie7=ua.ie&&document.documentElement&&typeof document.documentElement.style.maxHeight!=="undefined"&&typeof XDomainRequest==="undefined";ua.ie8=ua.ie&&typeof XDomainRequest!=="undefined";var domReady=function(){var e=[];var t=function(){if(!arguments.callee.done){arguments.callee.done=true;for(var t=0;t=200&&r.status<300||r.status===304||navigator.userAgent.indexOf("Safari")>-1&&typeof r.status==="undefined"){t(r.responseText)}else{n()}document.documentElement.style.cursor="";r=null}};r.send("")};var l=function(t){t=t.replace(e.REDUNDANT_COMPONENTS,"");t=t.replace(e.REDUNDANT_WHITESPACE,"$1");t=t.replace(e.WHITESPACE_IN_PARENTHESES,"($1)");t=t.replace(e.MORE_WHITESPACE," ");t=t.replace(e.FINAL_SEMICOLONS,"}");return t};var c={stylesheet:function(t){var n={};var r=[],i=[],s=[],o=[];var u=t.cssHelperText;var a=t.getAttribute("media");if(a){var f=a.toLowerCase().split(",")}else{var f=["all"]}for(var l=0;l-1&&a.href&&a.href.length!==0&&!a.disabled){r[r.length]=a}}if(r.length>0){var c=0;var d=function(){c++;if(c===r.length){i()}};var v=function(t){var n=t.href;f(n,function(r){r=l(r).replace(e.RELATIVE_URLS,"url("+n.substring(0,n.lastIndexOf("/"))+"/$1)");t.cssHelperText=r;d()},d)};for(u=0;u0){r.setAttribute("media",t.join(","))}document.getElementsByTagName("head")[0].appendChild(r);if(r.styleSheet){r.styleSheet.cssText=e}else{r.appendChild(document.createTextNode(e))}r.addedWithCssHelper=true;if(typeof n==="undefined"||n===true){cssHelper.parsed(function(t){var n=p(r,e);for(var i in n){if(n.hasOwnProperty(i)){g(i,n[i])}}a("newStyleParsed",r)})}else{r.parsingDisallowed=true}return r},removeStyle:function(e){return e.parentNode.removeChild(e)},parsed:function(e){if(n){s(e)}else{if(typeof t!=="undefined"){if(typeof e==="function"){e(t)}}else{s(e);d()}}},stylesheets:function(e){cssHelper.parsed(function(t){e(m.stylesheets||y("stylesheets"))})},mediaQueryLists:function(e){cssHelper.parsed(function(t){e(m.mediaQueryLists||y("mediaQueryLists"))})},rules:function(e){cssHelper.parsed(function(t){e(m.rules||y("rules"))})},selectors:function(e){cssHelper.parsed(function(t){e(m.selectors||y("selectors"))})},declarations:function(e){cssHelper.parsed(function(t){e(m.declarations||y("declarations"))})},properties:function(e){cssHelper.parsed(function(t){e(m.properties||y("properties"))})},broadcast:a,addListener:function(e,t){if(typeof t==="function"){if(!u[e]){u[e]={listeners:[]}}u[e].listeners[u[e].listeners.length]=t}},removeListener:function(e,t){if(typeof t==="function"&&u[e]){var n=u[e].listeners;for(var r=0;r=a||s&&l0}}else if("device-height"===e.substring(r-13,r)){c=screen.height;if(t!==null){if(u==="length"){return i&&c>=a||s&&c0}}else if("width"===e.substring(r-5,r)){l=document.documentElement.clientWidth||document.body.clientWidth;if(t!==null){if(u==="length"){return i&&l>=a||s&&l0}}else if("height"===e.substring(r-6,r)){c=document.documentElement.clientHeight||document.body.clientHeight;if(t!==null){if(u==="length"){return i&&c>=a||s&&c0}}else if("device-aspect-ratio"===e.substring(r-19,r)){return u==="aspect-ratio"&&screen.width*a[1]===screen.height*a[0]}else if("color-index"===e.substring(r-11,r)){var h=Math.pow(2,screen.colorDepth);if(t!==null){if(u==="absolute"){return i&&h>=a||s&&h0}}else if("color"===e.substring(r-5,r)){var p=screen.colorDepth;if(t!==null){if(u==="absolute"){return i&&p>=a||s&&p0}}else if("resolution"===e.substring(r-10,r)){var d;if(f==="dpcm"){d=o("1cm")}else{d=o("1in")}if(t!==null){if(u==="resolution"){return i&&d>=a||s&&d0}}else{return false}};var a=function(e){var t=e.getValid();var n=e.getExpressions();var r=n.length;if(r>0){for(var i=0;i0){u=false;for(var f=0;f0){l[c++]=","}l[c++]=h}}if(l.length>0){r[r.length]=cssHelper.addStyle("@media "+l.join("")+"{"+e.getCssText()+"}",t,false)}};var l=function(e,t){for(var n=0;n0}}var o=[],u=[];for(var f in i){if(i.hasOwnProperty(f)){o[o.length]=f;if(i[f]){u[u.length]=f}if(f==="all"){n=true}}}if(u.length>0){r[r.length]=cssHelper.addStyle(e.getCssText(),u,false)}var c=e.getMediaQueryLists();if(n){l(c)}else{l(c,o)}};var h=function(e){for(var t=0;td||Math.abs(s-t)>d){e=n;t=s;clearTimeout(r);r=setTimeout(function(){if(!i()){p()}else{cssHelper.broadcast("cssMediaQueriesTested")}},500)}};window.onresize=function(){var e=window.onresize||function(){};return function(){e();s()}}()};var m=document.documentElement;m.style.marginLeft="-32767px";setTimeout(function(){m.style.marginLeft=""},5e3);return function(){if(!i()){cssHelper.addListener("newStyleParsed",function(e){c(e.cssHelperParsed.stylesheet)});cssHelper.addListener("cssMediaQueriesTested",function(){if(ua.ie){m.style.width="1px"}setTimeout(function(){m.style.width="";m.style.marginLeft=""},0);cssHelper.removeListener("cssMediaQueriesTested",arguments.callee)});s();p()}else{m.style.marginLeft=""}v()}}());try{document.execCommand("BackgroundImageCache",false,true)}catch(e){} ././@PaxHeader0000000000000000000000000000002600000000000010213 xustar0022 mtime=1637164042.0 Sphinx-4.3.2/sphinx/themes/bizstyle/static/css3-mediaqueries_src.js0000644000076600000240000006773200000000000025037 0ustar00tkomiyastaff/* css3-mediaqueries.js - CSS Helper and CSS3 Media Queries Enabler author: Wouter van der Graaf version: 1.0 (20110330) license: MIT website: http://code.google.com/p/css3-mediaqueries-js/ W3C spec: http://www.w3.org/TR/css3-mediaqueries/ Note: use of embedded